Installations Guide für YAJSW und DTLDAP

Transkript

1 YAJSW - DTLDAP Installation Guide Installations Guide für YAJSW und DTLDAP Erstellt für: Helsana AG, Franz Schnyder Erstellt von: Skypro AG, Thomas Bucher 9. Mai 2013 thomas@skypro.ch

2 YAJSW - DTLDAP Installation Guide Inhaltsverzeichnis Einleitung 1 Über dieses Dokument 1 YAJSW 1 Vorarbeit 1 Installation DTLDAP 1 Download und Installation von yajsw 1 Installation 2 Konfiguration von yajsw 2 Generieren der Konfiguration 2 Anpassen der Konfiguration 4 Testen der Konfiguration 4 Installation des Services 4 Testen der Installation via Trayicon 4 Installations Guide für YAJSW und DTLDAP 1

3 YAJSW - DTLDAP Installation Guide Einleitung Über dieses Dokument Dieses Dokument soll aufzeigen, wie die Installation bei der Helsana AG vorgenommen wurde. Der DTLDAP Service läuft auf den Portal-Servern und ist via Apache mit Reverse-Proxy Funktionalität angeschlossen. Hier geht es um den Service- Wrapper, welcher benutzt wird, um DTLDAP auf den Windows Servern als Service laufen zu lassen. Wir benutzen dazu yajsw. YAJSW Yajsw ist Yet another Java Service Wrapper. Dieser Wrapper ist Open-Source und unter dokumentiert. Wir werden hier nur auf das nötigste des YAJSW eingehen, damit der Service installiert und gestartet werden kann. Vorarbeit Installation DTLDAP DTLDAP muss ordnungsgemäss konfiguriert und installiert sein. Erst dann kann die Applikation als Service gestartet werden. Download und Installation von yajsw Laden sie die Software herunter, und packen Sie die zip Datei aus. Das Verzeichnis yajsw-stable-xx.yy verschieben Sie nun in das Verzeichnis von DTLDAP. Zum Beispiel nach C:\DTLDAP\yajsw Installations Guide für YAJSW und DTLDAP 1

4 Installation Konfiguration von yajsw Um yajsw zu konfigurieren gehen wir wie folgt vor: Generieren der Konfiguration Anpassen der Konfiguration Testen der Konfiguration Installation des Services Testen der Installation via Trayicon Generieren der Konfiguration Starten Sie die DTLDAP Applikation. z.b: C:\DTLDAP>java -Xmx6G -jar DTLDAP.jar Nun kann via Task Manager die PID der Applikation ausgelesen werden. Installations Guide für YAJSW und DTLDAP 2

5 Falls PID nicht als Lasche im Task Manager angezeigt wird, müssen Sie diese erst in den Optionen von Task Manager aktivieren. Mit der PID Prozess ID der Applikation können Sie nun die Konfiguration erstellen lassen. Dazu benutzen wir den Befehl genconfig.bat wir folgt: C:\DTLDAP\yajsw\bat>genConfig.bat 5228 Wobei 5228 der ausgelesenen PID entsprechen muss. Sie sollten eine Ausgabe wie folgt erhalten Installations Guide für YAJSW und DTLDAP 3

6 Anpassen der Konfiguration Nun kann die Konfiguration angepasst werden. Die Konfig findet man im Verzeichnis conf. Die Datei heisst wrapper.conf. In unserem Beispiel ist das: C:\DTLDAP\yajsw\conf\wrapper.conf In dieser Datei muss der Name für den Service angepasst werden. # Name of the service wrapper.ntservice.name=dtldap # Display name of the service wrapper.ntservice.displayname=dtldap # Description of the service wrapper.ntservice.description=dtldap Caching Service Testen der Konfiguration Testen Sie nun die Konfiguration mittels C:\DTLDAP\yajsw\bat>runConsole.bat Installation des Services Der Service kann nun installiert werden mit C:\DTLDAP\yajsw\bat>installService.bat Nun sollte der Service im ServerManager -> Services sichtbar sein. Sie können nun den Service starten via Services oder mit C:\DTLDAP\yajsw\bat>startService.bat Testen der Installation via Trayicon Sie können nun die yajsw Console starten, um die Logs und den Status des Services einzusehen. Dies tun sie mittels C:\DTLDAP\yajsw\bat>systemTrayIcon.bat oder C:\DTLDAP\yajsw\bat>systemTrayIconW.bat wenn sie kein CMD Fenster haben wollen. Nun erhalten Sie eine Icon im System-Tray wenn Sie diese anklicken und Console wählen erhalten Sie die Service Console Installations Guide für YAJSW und DTLDAP 4

7 Installations Guide für YAJSW und DTLDAP 5