CMSpro Version 2.2.0

Transkript

1 CMSpro Version Softwareupdate Datum Version Autor Beschreibung Status br Erstellung für CMSpro Version freigegeben Bastian Roßteuscher

2 1 Anmerkungen Anmeldung Updatevorgang Export der Konfiguration Updatevorgang Beenden der Software Löschen der Konfigurationsdatenbank Update der Software Anpassungen in der Systemkonfiguration Starten der Software Login mit root -User Import der Konfiguration Neustart der Software = Abschluss des Updatevorgangs Bastian Roßteuscher - 2 -

3 1 Anmerkungen Die Export / Import Funktion wird verwendet um die konfigurierten Objekte der Software bei einem Update der bestehenden Version zu erhalten. Daher muss vor dem Update die Konfiguration exportiert und nach dem Update wieder importiert werden. Eine genaue Beschreibung des Ablaufs finden Sie in Kapitel 3. Der Export und Import ist ein absolut notwendiger Schritt bei einem Update, um eventuelle Änderungen im Schema der Datenbank auszugleichen und die bestehende Konfiguration beizubehalten. Bei einem Update von der Version auf die Version ist kein Export notwendig, da sich das Schema der Datenbank nicht geändert hat. Die Messdaten (Runtime Datenbank) werden nicht beeinträchtigt und müssen somit nicht exportiert werden. Bastian Roßteuscher - 3 -

4 2 Anmeldung Vor dem Verbinden muss der Serverprozess gestartet werden. Dazu einfach die RtmPlatform.exe im bin -Ordner der Software ausführen. Es öffnet sich ein Kommandozeilen-Fenster und der Serverprozess startet. Sobald die folgende Meldung erscheint, ist der Startvorgang des Serverprozesses beendet und es kann eine Verbindung über den Client vorgenommen werden. [main] INFO STARTUP STARTUP Zur Verbindung auf den Server wird ein normaler Webbrowser (z.b. Internet Explorer) verwendet, der sich auf die folgende Adresse verbinden soll: Der <Servername> und der <Port> sind in der Systemkonfiguration unter dem Punkt <system-config><system><proxyhost> bzw. <system-config><web><http><proxyport> eingestellt. Erfolgt die Verbindung von dem PC auf dem auch der Serverprozess läuft, so kann die Verbindung auch über localhost als Servername erfolgen. Ist der port der Standard-http- Port 80, so kann die Angabe des Ports entfallen. Bastian Roßteuscher - 4 -

5 Wenn der CMSpro Server erreicht werden konnte, müssen Sie sich über die Anmeldeseite mit dem Benutzer und dem zugehörigen Passwort anmelden. Beim ersten Start der Software wird ein Benutzer admin mit Passwort admin angelegt. Bastian Roßteuscher - 5 -

6 Es gibt auch die Möglichkeit die Software außerhalb des Webbrowsers über den sogenannten WebStart zu starten. Der Link in der Anmeldeseite Mit WebStart öffnen öffnet die zugehörige Seite zum Starten der Applikation. Über den start -Button neben CMSpro kann die Applikation gestartet werden. Es wird ein Login-Dialog angezeigt, in dem man sich über den Benutzer und das zugehörige Passwort anmeldet. Bastian Roßteuscher - 6 -

7 3 Updatevorgang Der Updatevorgang kann nur von Benutzern durchgeführt werden, die die notwendigen Berechtigungen besitzen und zudem das Passwort für den root -User kennen. Während des Updatevorgangs sollten keine Veränderungen der Konfiguration durchgeführt werden, da Änderungen nach dem Export verloren gehen. Während des Updates ist ein Neustart der Software notwendig wobei alle Clientverbindungen getrennt werden. 3.1 Export der Konfiguration Konfiguration: Menüpunkt: Über den durchsuchen -Button wird der Speicherort für die exportierte Konfiguration gewählt. Der exportieren -Button führt den Export der Konfiguration aus. Der Name der zip-datei kann angepasst werden Bastian Roßteuscher - 7 -

8 3.2 Updatevorgang Beenden der Software Vor dem Update muss der Server-Prozess der Software beendet werden. Falls die Software als Applikation läuft, muss das Fenster der Software geschlossen werden. Falls die Software als Dienst ( RtmPlatformService ) läuft, muss dieser beendet werden Löschen der Konfigurationsdatenbank Nachdem die Konfiguration exportiert und die Software beendet wurde, muss die Datenbank mit der Konfiguration gelöscht werden. Dazu muss die in der Systemkonfiguration ( systemconfig.xml im Ordner config des Installationsverzeichnisses) eingetragene Datenbank für die Konfiguration (<system-config><db><internal><url>) gelöscht und ggf. neu angelegt werden. Im Auslieferungszustand (Apache Derby Datenbank) ist die Konfiguration im Ordner internal_db im Ordner db des Installationsverzeichnisses gespeichert. WICHTIG: Nach dem Löschen der Konfigurationsdatenbank kann die Konfiguration nicht wieder hergestellt werden, wenn diese nicht vorher exportiert wurde Update der Software Zum Update der Software muss nur der Ordner modules im Installationsverzeichnis ausgetauscht werden. WICHTIG: Der neue Ordner modules darf nicht einfach kopiert werden, da es sonst zu einer Vermischung von Dateien unterschiedlicher Versionen kommt. Bastian Roßteuscher - 8 -

9 3.2.4 Anpassungen in der Systemkonfiguration Beim ersten Start der Software wurden einige Elemente für die Default-Konfiguration eingespielt. Dies wurde über Batch-Dateien gemacht, die in der Systemkonfiguration eingetragen sind. Diese Elemente wurden beim Export mit exportiert und dürfen bei einem Neustart der Software nach dem Update nicht nochmals angelegt werden. Daher muss in der Systemkonfiguration ( system-config.xml im Ordner config des Installationsverzeichnisses) der Eintrag für die Batches (<systemconfig><system><batches>) wie folgt angepasst werden: <batches></batches>. Alles zwischen >< muss gelöscht werden. Im Auslieferungszustand müssen die folgenden Einträge entfernt werden: auth:com.ifort.rtm.auth.impl.defaultauthbatch tag:com.ifort.rtm.tag.auth.impl.defaulttagauthbatch tag:com.ifort.rtm.tag.resource.impl.defaultresourcebatch tag:file:../config/defaultbatch_en.groovy Vorher: Nachher: Bastian Roßteuscher - 9 -

10 3.2.5 Starten der Software Login mit root -User Nach dem Update der Module kann die Software neu gestartet werden. Durch das Löschen der Konfiguration existieren die in der Konfiguration vorhanden User nicht mehr und man kann sich nur noch über den root-user anmelden. Das Passwort für den root-user ist in der Systemkonfiguration ( system-config.xml im Ordner config des Installationsverzeichnisses) der Software festgelegt. Bastian Roßteuscher

11 3.3 Import der Konfiguration Konfiguration: Menüpunkt: Über den durchsuchen -Button wird der Speicherort der exportierten Konfiguration gewählt. Der importieren -Button führt den Import der Konfiguration aus. 3.4 Neustart der Software = Abschluss des Updatevorgangs Nach dem Importieren der Konfiguration muss die Software beendet und neu gestartet werden. Nach dem Neustart ist das Update abgeschlossen und die ursprüngliche Konfiguration wieder hergestellt. Die Software kann wieder im Normalbetrieb verwendet werden. Bastian Roßteuscher