Installation hypermanager

Transkript

1 Installation hypermanager Version September 2012 Philipp Scherrer hypermanager Installation in Tomcat als Service 1 Einleitung Zielsetzung: Mehrere Mitarbeiter möchten zusammen hypermanager in einem Netzwerk nutzen. Die Installation soll auf einem Windows Rechner der Familien 2k, 2k3, XP, Vista, 2k8 oder 7 erfolgen. Bei jedem Systemstart soll hypermanager automatisch gestartet werden. Lösung: Es wird Tomcat als Windows Service installiert. Die hypermanager Java Web Applikation wird in Tomcat installiert. Vorgehen: Mit Administrationsrechten: Java Laufzeitumgebung von java.com herunterladen und installieren. Abschnitt 2. Tomcat von tomcat.apache.org herunterladen und als Service installieren. Abschnitt 3. hypermanager Loader von info@scheuring.ch erwerben, die hypermanager Web Applikation daraus extrahieren und in Tomcat installieren. Abschnitt 4. 2 Java Laufzeitumgebung von java.com herunterladen und installieren Java ist eine Technologie, welche Entwicklern vereinfacht, Programme für viele verschiedene Betriebssysteme zu schreiben, wobei eine sehr hohe Kompatibilität und Stabilität gewährt wird. Hinweis: Falls Sie vom Server aus keinen Internetzugriff besitzen, dann laden Sie Java von einem anderen Rechner herunter und übertragen Sie anschliessend die Installationsdatei mit geeigneten Mitteln (USB Laufwerk, Netzwerkfreigabe oder Terminal Verbindung) auf den Server. Zur Zeit ist Version 7 Update 7 die aktuelle Laufzeitumgebung.

2 2.1 Java Installationsprogramm herunterladen/ausführen Navigieren Sie zur Java Hauptseite java.com. Sie Sie werden in der Regel automatisch auf die deutschsprachige Seite für Java java.com/de weitergeleitet, falls Sie die Seite aus einem deutschsprachigen Betriebssystem besuchen Drücken Sie auf den Knopf mit der Beschriftung Kostenloser Java-Download, um auf die Downloadseite weitergeleitet zu werden. Hinweis: Falls Java bereits auf Ihrem System installiert ist, erscheint eine Seite zur Überprüfung der Java Installation. Wir empfehlen Ihnen, gegebenenfalls Ihre Java Installation zu überprüfen, indem Sie den Knopf mit der Beschriftung Java-Version überprüfen betätigen. Sie erhalten dann eine Rückmeldung über den Erfolg der Überprüfung

3 2.1.3 Es erscheint ein Fenster mit einer Sicherheitsabfrage über Ihrem Browserfenster. Wir haben uns entschieden, den Download direkt auszuführen. Sie können die Datei natürlich auch an einem beliebigen Ort abspeichern um sie später von Hand auszuführen. Es erscheint ein neues Fenster welches Sie zur Java Installation willkommen heisst Um die Java Laufzeitumgebung zu installieren, klicken Sie auf Installieren. Danach erhalten Sie Informationen zum Installationsfortschritt. Sobald die Installationsroutine vollständig durchlaufen ist, erhalten Sie ein Fenster zum Installationserfolg.

4 Klicken Sie auf Schliessen. Damit ist die Java Laufzeitumgebung erfolgreich installiert. 3 Tomcat von tomcat.apache.org herunterladen und als Service installieren Apache Tomcat ist ein Webapplikations Server. Ein Client kann per Browser darauf zugreifen, wobei der Apache Tomcat den Serverseitigen Java-Code einer Webapplikation ausführt. Hinweis: hypermanager funktioniert nicht mit der Version 7 von Tomcat. Die von uns getestete Version ist Apache Tomcat Navigieren Sie zur Tomcat Haupseite tomcat.apache.org. Navigieren Sie anschliessend zur Downloadseite für Tomcat 6.x Versionen und ein Stück runter auf der Seite, bis Sie unter dem Abschnitt Binary Distributions den Downloadlink für den aktuellsten Windows Service Installer entdecken. Laden sie diese Datei herunter.

5 3.2 Führen Sie den Windows Service Installer auf Ihrem Rechner aus, indem Sie den Downloadlink für den Windows Service Installer anklicken und bei der folgenden Sicherheitsabfrage auf Ausführen klicken. Natürlich können Sie Die Datei auch an einem beliebigen Ort speichern um diese später von Hand auszuführen. Sie werden vom Tomcat Installer mit einer Willkommensmeldung begrüsst. Wählen Sie Next. Es folgt ein Fenster mit den Lizenzbestimmungen. Akzeptieren Sie die Lizenzbestimmungen, indem Sie auf I Agree drücken.

6 Sie gelangen zur Auswahl der zu Installierenden Komponenten. Wählen Sie, zusätzlich zur Standardkonfiguration, auch die Service Komponente und die Native Komponente aus. Klicken Sie danach auf Next Hinweis: Diese zwei Komponenten sind keine Voraussetzung, um die hypermanager Java Web Applikation in Tomcat betreiben zu können. Es ist jedoch sehr sinnvoll, diese beiden Komponenten zu installieren. Die Service Komponente sorgt dafür, dass der Tomcat Webserver automatisch bei jedem Systemstart im Hintergrund gestartet wird, ohne dass sich eine Person in das System einloggen muss. Die Native Komponente macht den Tomcat Server etwas schneller auf Windows Systemen. Es folgt ein Fenster mit Konfigurationsoptionen. Wir entscheiden uns, Tomcat den Port 80 zuzuweisen. Port 80 ist der Standardport für das HTTP Protokoll. Die Verwendung dieses Standardports hat den Vorteil, dass alle Browser diesen Port kennen und somit die Adresse, unter welcher hypermanager im Browser erreicht werden kann, vereinfacht wird gegenüber der Wahl eines anderen Ports. Vorsicht!: Bitte vergewissern Sie sich, dass nicht schon ein anderes Programm den gewählten Port belegt. So könnte es z.b. sein, dass der Port 80 schon durch IIS oder Skype belegt ist. Setzen Sie sich gegebenenfalls mit den Herstellern in Verbindung, wie Sie den Port wieder freigeben können, falls der Port 80 schon durch ein anderes Programm belegt wird und Sie sich dennnoch dafür entschieden haben, diesen bequemen Port zu verwenden.

7 Optional: Wir haben uns auch dazu entschieden, ein Tomcat Administrator Login anzulegen. Damit kann man später bequem per Browser auf den Tomcat Manager zugreifen. Das ist für den Betrieb von hypermanager aber nicht notwendig. Klicken Sie danach auf Next. Es folgt ein Fenster zur Selektion der Java Laufzeitumgebung Sie haben in Schritt 2 Java auf Ihrem Windows Server installiert. Das Tomcat Installationsprogramm bemüht sich nun, jene Java Installation automatisch zu finden und kommt mit einem Vorschlag. Sollten Sie unter dem Vorgeschlagenen Verzeichnis keine Java Installation der Version 6 oder höher vorfinden, dann ändern Sie bitte den Pfad, in diesem Installationsschritt auf eine existierende Java Installation der Version 6 oder höher. Holen Sie allenfalls hier die fehlende Java Installation nach, bevor Sie mit der Tomcat Installation fortfahren, sonst wird Ihr Tomcat Webserver nach der Installation nicht starten können. Gegenwärtige Java 7 Installationsprogramme installieren Java normalerweise in das Verzeichnis C:\Programme\Java\jre7. JRE steht hier für Java Runtime Environment. Klicken Sie danach auf Next. Es folgt ein Fenster zur Auswahl des Installationsverzeichnis Wählen Sie ein Installationsverzeichnis nach Ihren Wünschen oder akzeptieren Sie das vorgeschlagene Destinationsverzeichnis. Wir folgen dem Vorschlag der Entwickler von Tomcat C:\Programme\Apache Software Foundation\Tomcat 6.0. Klicken Sie danach auf Install, um Tomcat zu installieren.

8 Nach der Installation haben Sie die Wahl, Tomcat direkt zu starten und/oder Informationen zu Tomcat zu lesen. Es ist vorteilhaft, hier Tomcat gleich starten zu lassen, indem Sie die Checkbox Run Apache Tomcat aktiviert lassen. Es erscheint nun in Ihrer Taskbar ein weiteres System Tray-Icon für Informationen zum Tomcat Service Status und für Einstellungen zum Tomcat Service. Der Service sollte eigentlich direkt gestartet werden, was Sie an dem grünen Play Symbol erkennen. Mit einen Rechtsklick auf das Symbol kann der Tomcat Service gestoppt und gestartet werden. Sobald Tomcat erfolgreich gestartet wurde, ändert sich das Symbol des Tomcat Service Manager zu einem grünen Play Symbol um zu signalisieren, dass der Tomcat Service läuft. 3.3 Navigieren Sie in Ihrem Browser zur Adresse localhost. Falls Sie bei der Installation des Tomcat Service nicht den Port 80 ausgewählt haben, besuchen Sie stattdessen die Adresse localhost:xxxx in Ihrem Browser, wobei xxxx hier für die Portzahl steht, welche Sie bei der Installation angegeben haben. Nach einer erfolgreichen Installation sollten Sie nun eine Webseite mit Informationen und Konfigurationstools zum Tomcat Webserver vorfinden.

9 4 Scheuring hypermanager Web Applikation herunterladen/installieren Setzen Sie sich mit der Firma Scheuring AG in Verbindung. Schreiben Sie uns eine an oder besuchen Sie unsere Webseite auf scheuring.ch, um eine aktuelle Kopie von hypermanager zu erhalten. Sie erhalten anschliessend von uns einen Link zum Download von hypermanager oder bekommen das Programm per zugesendet. Zusätzlich erhalten Sie eine Lizenz-Datei license.key, welche die von Ihnen gewählten Programmfunktionen freischaltet. Diese Lizenz Datei wird später benötigt. Hinweis: Ohne diese Lizenz Datei wird hypermanager auch funktionieren allerdings nur als Persönliche Version. Die Persönliche Version erlaubt, neben anderen Einschränkungen, maximal einen Benutzer. hypermanager wird üblicherweise als eine EXE- oder ZIP-Datei ausgeliefert. Diese Datei enthält die gesamte hypermanager Applikation und kann durch Doppelklick direkt gestartet werden, vorausgesetzt eine Java Installation ist vorhanden. Diese Datei bezeichnen wir als hypermanager Loader, weil sie beim Start die hypermanager Java Web Applikation automatisch lädt. Zurzeit besteht keine einfache Möglichkeit, die hypermanager Web Applikation über den hypermanager Loader automatisch bei jedem Windows Systemstart zu starten, ohne dass ein Benutzer sich in das System einloggt. Dieses Verhalten ist vielmals für den Serverbetrieb gewünscht, um sicherzustellen, dass die Applikation immer sofort verfügbar ist, falls das System aus irgendwelchen Gründen manuell oder automatisch neu gestartet wurde. Für diese Funktionalität eignet sich unter Windows vielmals die Installation des entsprechenden Programms als Service. Setzen Sie sich dazu mit einem Windows Server Experten in Verbindung oder kontaktieren Sie uns. Um die hypermanager Web Applikation als Service laufen zu lassen schlagen wir vor, dass Sie die hypermanager Web Applikation in einer Tomcat Service Installation betreiben, denn für Tomcat ist eine einfache Service Installation auf dessen Webseite tomcat.apache.org verfügbar. Die notwendigen hypermanager Dateien für eine Installation unter Tomcat sind in der hypermanager Loader Applikationsdatei hypermanager_x.x_build_yyy.exe enthalten und können mit einem Zip Programm extrahiert werden.wobei x.x die Versionsummer und yyy die Buildnummer angibt. 4.1 Scheuring hypermanager Loader herunterladen Laden Sie die hypermanager_x.x_build_yyy.exe (oder zip) Datei mit dem erhaltenen Link herunter. 4.2 Scheuring hypermanager für den Betrieb in Tomcat vorbereiten Geeignetes Zip Programm installieren Falls Sie noch nicht über ein Zip Programm verfügen, empfehlen wir Ihnen, das kostenlos erhältliche Zip-fähige Programm namens 7-Zip zu installieren.

10 Besuchen Sie die Webseite 7-zip.org Wählen Sie den entsprechend zu Ihrer Windows Installation zugehörigen Download für 7-Zip, bzw. 32Bit, falls Sie ein 32Bit oder 64Bit Betriebssystem besitzen oder 64Bit, falls Sie ein 64Bit Betriebssystem besitzen. Derzeit führt der Download Link Sie auf das Software Portal Sourceforge.Net, wo automatisch ein Download vom nächsten Sourceforge Server in Ihrer Umgebung geöffnet werden sollte. Laden Sie 7-Zip herunter und führen Sie die Installation aus. Danach können Sie mit einem Rechtsklick auf eine gezippte Datei, diese direkt mit 7-Zip öffnen Extrahieren der benötigten hypermanager Komponeneten. Wir öffnen die hypermanager Loader Datei hypermanager_x.x_build_yyy.exe mit einem geeigneten Zip-fähigen Programm. Wir führen in dieser Anleitung alle Schritte mit dem kostenfrei erhältlichen Programm 7-Zip durch.

11 Die hypermanager Loader Datei hypermanager_x.x_build_yyy.exe enthält gegenwärtig 4 Ordner Wir extrahieren den Java Datenbanktreiber. Dazu wechseln wir in das Verzeichnis Names lib in der hypermanager Archiv Datei hypermanager.jar. Wählen Sie die Datei derby.jar an und anschliessend Entpacken. Der Java Datenbank Treiber derby.jar muss an einen ganz bestimmten Ort extrahiert werden, damit dieser von hypermanager gefunden werden kann. Ändern Sie das Destinationsverzeichnis, auf das Unterverzeichnis lib im Verzeichnis Ihrer Tomcat Installation. Normalerweise finden Sie dieses Verzeichnis unter C:\Programme\Apache Software Foundation\Tomcat 6.0\lib.

12 4.2.3 Beenden Sie den Tomcat Service im Menu unter der Rechten Maustaste auf dem Tomcat Tray Icon, falls der Tomcat Service auf Ihrem System aktiv ist Öffnen Sie die Java Archiv Datei main.jar im Verzeichnis main der hypermanager EXE Datei. Wir extrahieren nun die hypermanager Web Applikation in das Web Applikationsverzeichnis von Tomcat. Selektieren Sie dazu die hypermanager.war Datei, welche Sie in der Java Archivdatei main.jar vorfinden. Entpacken Sie anschliessend diese Datei in das Unterverzeichnis Names webapps, welches sich in jenem Verzeichnis befindet, wo Sie Tomcat installiert haben.

13 4.2.5 Navigieren Sie mit dem Windows Explorer in das Unterverzeichnis webapps im Tomcat Installationsverzeichnis und löschen Sie den Ordner ROOT Navigieren Sie mit dem Explorer in das Verzeichnis webapps im Verzeichnis. Wir empfehlen Ihnen die hypermanager Java Web Applikationsdatei hypermanager.war nach ROOT.war umzubenennen. Dies bewirkt eine Vereinfachung der URL, unter welcher die hypermanager Web Applikation im Browser aufgerufen werden kann Öffnen Sie die hypermanager Web Applikationsdatei, welche Sie in Schritt in ROOT.war umbenannt haben, mit 7-Zip.

14 4.2.8 Wählen Sie, dass Sie die mitgelieferte hypermanager Datenbank aus der Web Applikation extrahieren möchten, dann navigieren Sie dazu innerhalb von 7-Zip in den Ordner mit dem Namen WEB-INF in der ROOT.war Datei, welche Sie mit 7-Zip geöffnet haben. Drücken Sie anschliessend auf Entpacken. Da sich das geöffnete Archiv im Verzeichnis C:\Programme\Apache Software Foundation\Tomcat 6.0\webapps befindet, wird 7-Zip diesen Ordner als Destinationsordner für extrahierte Dateien vorschlagen. Entpacken Sie die Datenbank unter keinen Umständen in diesen Ordner! Dieser Ordner ist üblicherweise im Intranet über den Browser zugänglich. Sie sollten die Datenbank vorzugsweise an einem unzugänglichen Ort ablegen, ausserhalb des Ordners webapps. Legen Sie nun vorzugsweise einen neuen Ordner mit der Bezeichnung databases an, um zu kennzeichnen, dass Sie in diesem Ordner Datenbanken ablegen möchten. Entpaken Sie die mitgelieferte hypermanager Beispielsdatenbank in den zuvor angelegten Ordner "databases Navigieren Sie in das in Schritt angelegte Verzeichnis, wo Sie die Datenbanken halten. Im vorherigen Schritt haben Sie die im hypermanager Loader mitgelieferte Datenbank in diesen Ordner extrahiert. Benennen Sie vorzugsweise diese Datebank, bzw. den Ordner db nach ROOT um. Somit kennzeichnen Sie für sich, dass dies die zur Webapp Applikation ROOT zugehörige Datenbank ist, vom Tomcat webapps Verzeichnis Navigieren Sie in 7-Zip in das Verzeichnis META-INF in der geöffneten hypermanager Webapplikationsdatei ROOT.war. Selektieren Sie anschliessend die Datei context.xml und wählen Sie im Menu, welches Sie unter der Rechten Maustaste finden, dass Sie diese Datei Bearbeiten möchten.

15 Ersetzen Sie den Datenbank Pfad emptydb in der geöffneten XML Datei context.xml mit dem Datenbankpfad, wo Sie die Datenbank entpakt haben, Beispielsweise C:\Programme\Apache Software Foundation\Tomcat 6.0\databases\ROOT, wenn Sie unseren Installationsvorschlag angenommen haben. Der Datenbankpfad kann auch relativ zum Tomcat Installationsverzeichnis angegeben werden. Dieses ist bei uns C:\Programme\Apache Software Foundation\Tomcat 6.0. So können wir als Datebankpfad statt C:\Programme\Apache Software Foundation\Tomcat 6.0\databases\ROOT auch databases/root verwenden. Es spielt dabei keine Rolle, ob wir als Trennzeichen für Pfade das Backslash Zeichen \ oder das Slash Zeichen / verwenden. Schliessen Sie anschliessend den Editor. Sie werden gefragt, ob Sie Ihre Änderungen gerne übernehmen möchten. Sie antworten natürlich mit Ja. Nacholgend erscheint ein Abfragefenster, ob Sie die XML Datei context.xml aus dem geöffneten hypermanager Web Archiv aktualisieren möchten. Drücken Sie OK, um die Datei zu aktualisieren.

16 Optional: Falls Ihre hypermanager Lizenz keine ressolution Option enthält, können Sie diesen Schritt überspringen und mit Abschnitt weitermachen. Hinweis: Voraussetzung, um ressolution in hypermanager zu nutzen ist, dass ressolution auf einem SQL-Server läuft und Verbindungen auf Port 1433 zulässt. Falls Sie Hilfe benötigen, um ressolution auf SQL-Server zu migrieren, setzen Sie sich mit uns unter in Verbindung Ersetzen Sie in der XML Datei context.xml die Angaben zu Servername, Databasename, User und Password, mit den Angaben zu Ihrer ressolution Installation. Hinweis: Der User muss dbo Rechte auf der ressolution Datenbank besitzen. Schliessen Sie anschliessend den Editor. Sie werden gefragt, ob Sie Ihre Änderungen gerne übernehmen möchten. Sie antworten natürlich mit Ja. Nacholgend erscheint ein Abfragefenster, ob Sie die XML Datei context.xml aus dem geöffneten hypermanager Web Archiv aktualisieren möchten. Drücken Sie OK, um die Datei zu aktualisieren Sie erhalten von uns eine Install.sql Datei, welche SQL-Skript enthält, um die ressolution Datenbank für den Gebrauch mit hypermanager vorzubereiten. Öffnen Sie diese Install.sql Datei im SQL-Server Management Studio und lassen diese über die ressolution Datenbank laufen.dabei werden verschiedene Tabellen und Stored Procedures mit dem Präfix rep_ in der ressolution Datenbank angelegt Wenn Sie richtig vorgegangen sind, hat sich nun der Wert für die XML Datei context.xml in der Spalte Herkunft von Unix auf FAT verändert. Schliessen Sie anschliessend das Archiv Programm 7-Zip. Fall Sie 7-Zip auf dem Server installiert haben, können Sie dieses Programm nun wieder deinstallieren. Sie benötigen 7-Zip nicht mehr für den Betrieb von hypermanager. Allenfalls benötigen Sie 7-Zip wieder für das nächste Update der hypermanager Web Applikation in Tomcat.

17 Nun legen Sie noch die von uns erhaltene license.key Datei in das Arbeitsverzeichnis von Tomcat. C:\Programme\Apache Software Foundation\Tomcat 6.0\ hypermanager wird damit die in Ihrer Lizenz enthaltenen Optionen freischalten. 4.3 Scheuring hypermanager als Web Applikation in Tomcat starten Starten Sie Tomcat mit einem Rechtsklick auf das Symbol des Tomcat Service Manager und indem Sie in jenem Menu die Option Start service wählen Öffnen Sie nun auf dem Server Ihren Lieblingsbrowser und navigieren Sie zur Adresse localhost Falls Sie bei der Installation von Tomcat einen anderen Port gewählt haben als den Port 80, navigieren Sie stattdessen zu localhost:xxxx, wobei xxxx die Portnummer bezeichnet, die Sie bei der Installation angegeben haben. Sie sollten jetzt im Browser von hypermanager begrüsst werden.

18 4.3.3 Lassen Sie sich von einem Netzwerk Administrator oder von uns beraten, wie Sie in Ihrer Netzwerk Infrastruktur von anderen Rechnern auf den hypermanager zugreifen, welcher auf Ihrem Server betrieben wird Falls Ihr Netzwerk zusätzlich ans Internet angebunden ist, dann könnten Sie mit fortgeschrittenen Kenntnissen Ihre hypermanager Installation auch so zugänglich machen, dass Ihr hypermanager über eine Internetadresse aus dem Internet erreicht werden kann. 5 Kontakt Falls Sie Fragen zu dieser Anleitung oder zu hypermanager haben oder Informationen zu weiteren Scheuring Produkten wünschen, zögern Sie nicht, uns unter info@scheuring.ch zu schreiben, oder besuchen Sie unsere Webseite unter