VAWACON - Jochen van Waasen

Jochen van Waasen
Senior Developer Java Technology

Start

• Start

• Methoden

• Profil

• Technologie

• Impressum

Tomcat NT Dienst

Abstract

Voraussetzung

Installation Tomcat 4
(NT service)

Installation NT Dienst
manuell

Installation NT Dienst
mit ANT

Deinstallation NT Dienst

Download:

tomcatService.xml

tS.properties

Anleitung: HowTo_PDF

info@vawacon.de

2004-04-22 6:22

Wie installiert man Tomcat 4 als NT Dienst?

Abstract:

Dieser Text beschreibt die Installation von Tomcat 4 als NT Dienst und das Anlegen von Tomcat NT Diensten. Das Anlegen von Tomcat NT Diensten ist dann notwendig, wenn während der Installation von Tomcat 4 die Installationsoption NT service nicht gewählt wurde oder Tomcat 4 mit einem Webapplikationsverzeichnis außerhalb des Installationsverzeichnisses gestartet werden soll. Weiterhin können mehrere Tomcatinstanzen auf einer Maschine als NT Dienst gestartet werden.

Diese Anleitung wurde getestet auf Windows 2000 mit Tomcat 4.1.24.

Voraussetzung:

Korrekt installiertes J2SE SDK mit der Umgebungsvariablen JAVA_HOME

Installation Tomcat 4 (NT service):
1.	Laden Sie die ausführbare Windowsdatei tomcat-4.1.24.exe herunter.
2.	Installation von Tomcat 4 durch Doppelklick auf die heruntergeladene Datei. Folgen Sie den Installationsanweisungen.
2a.	Als Installation Option wählen Sie Custom und selektieren die NT Service (NT/2K/XP only) Checkbox: Tomcat wird als NT Dienst installiert! Durch diese Option wird ein NT Dienst angelegt und in der Windows Registry eingetragen. Der Dienst wird nach der erfolgreichen Installation gestartet. Der gestartete Dienst benutzt die Tomcatinstanz und das Webapplikationsverzeichnis des Tomcat Installationsverzeichnisses welches während der Installation festgelegt wurde. Um einen NT Dienst anzulegen und zu starten wird die Datei tomcat.exe in das bin Verzeichnis des Tomcat Installationsverzeichnisses installiert. Diese Datei kann dazu benutzt werden einen NT Dienst manuell anzulegen. Diese Datei wird nur installiert wenn Tomcat mit der Installationsoption Custom und selektierter NT service Checkbox installiert wurde!
2b.	Folgen Sie den nächsten Installationsanweisungen.
3.	Setzen Sie die Umgebungsvariable CATALINA_HOME auf das Tomcat 4.1 Installationsverzeichnis.

Installation NT Dienst manuell:
	Falls Tomcat nicht als NT Dienst installiert wurde muss ein NT Dienst manuell angelegt werden. Tomcat stellt dazu ein Tool zur Verfügung mit dem Tomcat NT Dienste für existierende Installationen angelegt werden können.
	Die Datei tomcat.exe wird bei Verwendung des Windowsinstallers nur in das bin Verzeichnis des Tomcat Installationsverzeichnisses kopiert wenn die Installationsoptin NT service gewählt wurde. Falls Sie die Datei tomcat.exe nicht im bin Verzeichnis finden wurde der NT Dienst nicht installiert. Um die Datei tomcat.exe zu erhalten, können Sie Tomcat deinstallieren und mit der NT service option erneut installieren. Falls Sie Tomcat nicht erneut installieren wollen können Sie die Datei tomcat-4.1.24.zip herunterladen und die Datei tomcat.exe aus dem Zip-Archiv in das bin Verzeichnis des Tomcat Installationsverzeichnisses kopieren. Dieses Tool befindet sich im bin Verzeichnis des Tomcat Installationsverzeichnisses. `tomcat.exe`
	Usage of `tomcat.exe \ tomcat -? To install a service: -install service_name jvm_library (jvm_option)* -start start_class [-method start_method] [-params (start_parameter)+] [-stop start_class [-method stop_method] [-params (stop_parameter)+]] [-out out_log_file] [-err err_log_file] [-current current_dir] [-path extra_path] To uninstall a service: -uninstall service_name` [...]
	Die Vielzahl der Optionen macht das Tool tomcat.exe unpraktisch in der Anwendung. -install Service_name Path_to_Server_JVM -Dcatalina.home Pfad zum Tomcat Installationsverzeichnis. Hier befindet sich der Tomcatserver. -Dcatalina.base Pfad zum Webapplikationsverzeichnis. Dieses Verzeichnis enthält die deployten Applikationen. -Djava.endorsed.dirs Pfad zu unterstützten Resourcen: xercesImpl.jar, xmlParserAPI.jar Diese werden bei der Tomcatinstalltion mit installiert. -Djava.class.path Pfad zum Bootstrap.jar welches zum starten des NT Dienstes benötigt wird. -start Start Klassen, Methoden und Parameter zum starten des NT Dienstes. -stop Stop Klassen, Methoden und Parameter zum stoppen des NT Dienstes. -out Pfad zur output Logdatei. -err Pfad zur error Logdatei. Dies ist ein Beispiel zum Anlegen eines Tomcat NT Dienstes. C:\Tomcat4\bin tomcat -install Tomcat_Instance_2 D:\DEV\j2sdk14103\jre\bin\server\jvm.dl -Dcatalina.home=D:\server\ApacheGroup\Tomcat4 -Dcatalina.base=D:\server\tomcat-instances\instance2 -Djava.endorsed.dirs=D:\server\ApacheGroup\Tomcat4\common\endorsed -Djava.class.path=D:\server\ApacheGroup\Tomcat4\bin\bootstrap.jar -Xrs -Xms64m -Xss1024k -Xmx256m -start org.apache.catalina.startup.BootstrapService -method main -params start -stop org.apache.catalina.startup.BootstrapService -method main -params stop -out D:\server\tomcat-instances\instance1\logs\Tomcat_Instance_2_out.log -err D:\server\to mcat-instances\instance1\logs\Tomcat_Instance_2_err.log Diese Anweisung muss in EINER Zeile stehen damit tomcat.exe all Optionen parsen kann. Das manuelle Anlegen ist sehr unpraktisch, besonders wenn man mehrere NT Dienste anlegen will.

Installation NT Dienst mit ANT:
	Das unhandliche Vorgehen beim manuellen Anlegen eines NT Dienstes kann sehr einfach mit ANT automatisiert werden.
	Das ANT buildfile tomcatService.xml in Verbindung mit der tS.properties Datei übernimmt das Anlegen eines NT Dienstes.
1.	Es wird eine korrekt installierte ANT Distribution benötigt!
2.	Die Datei tomcatService.xml erwartet folgende Umgebungsvariablen: JAVA_HOME zeigt auf das J2SE Installationsverzeichnis. CATALINA_HOME zeigt auf das Tomcat 4 Installationsverzeichnis.
3.	Passen Sie tS.properties an: `# Path to the Tomcat instance / application # Use \ (backslash) as this path is used within the Windows Registry CATALINA_BASE =D:\\server\\tomcat-instances\\instance3 # Name of service used by Windows SERVICE_NAME =Tomcat_Instance_A2 # Description of the service used by Windows SERVICE_DESCRIPTION=Tomcat Instance Service # VM attributes # See J2SE tooldocs! XMS=-Xms64M XSS=-Xss1024K XMX=-Xmx256M` Setzen Sie CATALINA_BASE auf das Webapplishy;kationsshy;verzeichnis. Falls Sie kein separates Applikationsshy;verzeichnis und nicht mehrere Tomcatshy;instanzen verwenden wollen, setzen Sie die Variable auf das Tomcatshy;installationsshy;verzeichnis. Setzen Sie SERVICE_NAME damit Sie den Tomcatdienst unter den Windows Diensten einfacher identifizieren können.
4.	Führen Sie tomcatService.xml mit ANT aus! `D:\ant -buildfile tomcatService.xml Buildfile: tomcatService.xml main: [echo] Install Tomcat as Service (Tomcat_Instance_A2) on Windows 2000! [echo] Created D:\server\ApacheGroup\Tomcat4\bin\Tomcat_Instance_A2.exe ! [exec] The service was successfully installed. [echo] Creating description file for Windows registry. [echo] Updating registry with description. [echo] Deleting description file for Windows registry. [delete] Deleting: D:\service.reg BUILD SUCCESSFUL Total time: 1 second` Der NT Dienst wurde angelegt. Wählen Sie Start > Einstellungen > Systemsteuerung > Verwaltung > Dienste . Wählen Sie den benannten Tomcat Dienst aus uns starten Sie den Dienst. Der Dienst wird automatisch beim nächsten Start des Rechners gestartet.

Deinstallation NT Dienst:
	Tomcat stellt ein Tool zur Deinstallation von Tomcat NT Diensten zur Verfügung. Das Tool wird auch zu Installation von Tomcat NT Diensten verwendet. Es befindet sich im bin Verzeichnis des Tomcat Installationsshy;verzeichnisses. `tomcat.exe \ tomcat -? [...] To uninstall a service: -uninstall service_name` [...]
1.	Stoppen des NT Dienstes. Wählen Sie Start > Einstellungen > Systemsteuerung > Verwaltung > Dienste. Wählen Sie den benannten Dienst und stoppen Sie ihn.
2.	Deinstallation des NT Dienstes. Wechseln Sie in das bin Verzeichnis im Tomcat Installationsverzeichnis. `tomcat -uninstall Tomcat_Instance_A2`

webmaster@vawacon.de