Przewodnik o tym jak zrobić klaster złożony z dwóch instacji tomcata połączonego load balancerem apache mod_jk i jak uruchomić replikację sesji oraz sticky-session. System operacyjny to lubuntu 11.10.
Z góry przepraszam, za dość surowe komendy. Nie jest to tutorial krok-po-korku ani książka, żeby rozlegle wszystko opisywać. Jest to tylko ściągawka na przyszłość, lub ekstrakt z tego co trzeba zrobić.
Adres IP należy zmienić z 10.0.0.90 na localhost czy gdzie tam wasz serwerek się znajduje.
1. Do zainstalowania:
apt-get install apache2 libapache2-mod-jk2-mod-jk
2. Utworzyć katalog:
/tcluster/instance1
3. Pobrać
Tomcata i rozpakować zawartość do tego katalogu.
4. Konfiguracja Apache mod_jk
- utwórz plik /etc/apache2/workers.properties:
worker.list=loadbalancer,mystat
worker.worker1.type=ajp13
worker.worker1.host=10.0.0.90
worker.worker1.port=8881
worker.worker1.lbfactor=50
worker.worker1.cachesize=10
worker.worker1.cache_timeout=600
worker.worker1.socket_keepalive=1
worker.worker1.socket_timeout=300
worker.worker2.type=ajp13
worker.worker2.host=10.0.0.90
worker.worker2.port=8882
worker.worker2.lbfactor=50
worker.worker2.cachesize=10
worker.worker2.cache_timeout=600
worker.worker2.socket_keepalive=1
worker.worker2.socket_timeout=300
worker.loadbalancer.type=lb
worker.loadbalancer.sticky_session=true
worker.loadbalancer.balance_workers=worker1,worker2
worker.mystat.type=status
Ważna jest nazwa workera ( worker1 oraz worker2 ) adres IP oraz port.
- do pliku /etc/apache2/ports.conf dodaj:
Listen 8585
- zmień zawartość pliku:
/etc/apache2/mods-enabled/jk.conf na:
JKWorkersFile /etc/apache2/workers.properties
JkLogFile /var/log/apache2/mod_jk.log
JkLogLevel debug
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
JkRequestLogFormat "%w %V %T"
- dodaj nasłuch na porcie 8585 dla mod_jk:
/etc/apache2/sites-enabled/000-default
<VirtualHost *:8585>
JkMount /* loadbalancer
JkMount /jkstatus mystat
</VirtualHost>
5. Konfiguracja instancji nr 1:
- Zmień plik /tcluster/instance1/conf/server.xml tak aby przypominał:
...
<Connector port="8871" protocol="HTTP/1.1" />
...
<Connector port="8881" protocol="AJP/1.3" redirectPort="8443" />
....
<Engine name="Catalina" defaultHost="localhost" jvmRoute="worker1">
....
<Cluster className="org.apache.catalina.ha.tcp.SimpleTcpCluster"/>
Connectora się odkomentowywuje, jvmRoute trzeba dopisać, pole cluster się odkomentowywuje.
- Ściągnij z internetu http://code.google.com/p/psi-probe/ plik war i umieść go w katalogu webapps. Jest to aplikacja która może się później przydać.
-Dodaj użytkowników do tomcata:
/tcluster/instance1/conf/tomcat-users.xml
<tomcat-users>
...
<role rolename="manager"/>
<user username="admin" password="jakieshaslo" roles="manager"/>
</tomcat-users>
- Przejdź do katalogu: /tcluster/instance1/webapps
Zmodyfikuj
examples/WEB-INF/web.xml dodając
distributable:
<web-app ....>
<distributable/>
</web-app>
6. Konfiguracja instancji nr 2:
- Skopiuj zawartość pliku /tcluster/instance1 do /tcluster/instance2
- Zmień plik /tcluster/instance2/conf/server.xml tak aby zmienić:
<Server port="8006" shutdown="SHUTDOWN">
...
<Connector port="8872" protocol="HTTP/1.1" />
...
<Connector port="8882" protocol="AJP/1.3" redirectPort="8443" />
....
<Engine name="Catalina" defaultHost="localhost" jvmRoute="worker2">
6. Testowanie
Uruchamiamy wszystko:
/etc/init.d/apache start
/tcluster/instance1/bin/startup.sh
/tcluster/instance2/bin/startup.sh
Testy przeprowadzić najlepiej za pomocą aplikacji z przykładów:
W moim przypadku jest to:
http://10.0.0.90:8871/examples/servlets/servlet/SessionExample
Mamy trzy porty HTTP:
- 8871 - instancja nr 1
- 8872 - instancja nr 2
- 8585 - load balancer
Po dodaniu jakiegoś aktrybutu sesji i zmianie portu z 8871 na 8872 powinniśmy mieć ten sam SessionID (Sticky-session) oraz te same atrybuty(Replikacja sesji).
7. Dodatkowa analiza:
- Panel z informacja o mod_jk:
http://10.0.0.90:8585/jkstatus
-Probe (narzędzie do monitorowania) dostępne na danej instancji:
http://10.0.0.90:8871/probe
http://10.0.0.90:8872/probe
