ARCWAY Cockpit. Server Upgrade. von 3.0 auf 3.1

ARCWAY Cockpit Server Upgrade von 3.0 auf 3.1

ARCWAY AG Alt-Moabit 90b D-10559 Berlin Tel. +49 (30) 800 97 83-0 Fax +49 (30) 800 97 83-100 E-Mail info@arcway.com

RECHTLICHE HINWEISE Bitte senden Sie Fragen zum ARCWAY Cockpit oder Kommentare zu diesem Dokument an: Kundensupport ARCWAY AG Alt-Moabit 90b 10559 Berlin +49 (30) 800 97 83-333 2004-2008 ARCWAY AG. Alle Rechte vorbehalten. DIESES PRODUKT ENTHÄLT VERTRAULICHE INFORMATIONEN UND GESCHÄFTSGEHEIMNISSE DER ARCWAY AG. DIE NUTZUNG, VERBREITUNG UND/ODER REPRODUKTION IST OHNE VORHERIGE UND AUSDRÜCKLICHE ERLAUBNIS DER ARCWAY AG UNTERSAGT. DIE EINSICHT IST LIMITIERT AUF AUTORISIERTE PERSONEN. DIE NUTZUNGBESTIMMUNGEN DIESES PRODUKTS SIND IN DEN BEDINGUNGEN DES ABKOMMENS MIT DER ARCWAY AG ÜBER BENUTZERLIZENZEN EINZELN GEREGELT. DER INHALT DIESES DOKUMENTS IST OHNE JEDE GEWÄHR. DIESE PUBLIKATION KANN UNGENAUIGKEITEN UND TYPOGRAPHISCHE FEHLER ENTHALTEN. ARCWAY AG behält sich das Recht vor, dieses Dokument ohne vorherige Ankündigung zu verändern oder zu entfernen. ARCWAY und Cockpit sind Warenzeichen oder registrierte Warenzeichen der ARCWAY AG. Java ist ein Warenzeichen oder registriertes Warenzeichen von Sun Microsystems, Inc. Eclipse ist ein Warenzeichen oder registriertes Warenzeichen der Eclipse Foundation, Inc. Microsoft, Windows, Windows 2000, Windows XP, Windows 2003 Server, MS Word, MS Excel, MS Project und MS SQL Server 2000 sind Warenzeichen oder registrierte Warenzeichen der Microsoft Corporation. DB2 ist ein Warenzeichen oder registriertes Warenzeichen der IBM Corporation. Linux ist ein registriertes Warenzeichen von Linus Torvalds. Fedora ist ein Warenzeichen oder registriertes Warenzeichen von Red Hat, Inc. Mandrake ist ein Warenzeichen oder registriertes Warenzeichen der Mandrakesoft S.A. SUSE ist ein Warenzeichen oder registriertes Warenzeichen der SUSE AG, einer Gesellschaft von Novell. Adobe SVG Viewer ist ein Warenzeichen oder registriertes Warenzeichen von Adobe Systems. Alle in diesem Dokument genannten Warenzeichen, sowie Marken- und Produktnamen sind Eigentum der jeweiligen Eigentümer. Dokument 0004-V3-DE vom 27. Februar 2008 ii

Inhaltsverzeichnis Einführung... 1 Wichtige Hinweise... 1 Upgrade Überblick... 2 Upgrade Detailliert... 3 1 Vorbereiten der Clients...3 2 Archivieren der zu migrierenden Daten... 4 3 Deinstallation des bestehenden Systems... 5 Deinstallation der Server-Komponenten...5 Deinstallation des Clients... 8 4 Vorbereiten der Datenbank und des Archivs...8 Anlegen neuer Datenablagen... 8 Wiederverwenden der Datenablagen...8 5 Installation des neuen Systems... 9 6 Wiederherstellen der Daten... 9 7 Einrichten der Clients... 10

Einführung Dieses Dokument ist eine Anleitung für das Upgrade einer ARCWAY Cockpit Client/Server Installation von Version 3.0.0 auf Version 3.1.0. Aufgrund von Änderungen an internen Datenstrukturen ist neben der Neuinstallation von Server und Clients auch eine Migration der Daten des Servers erforderlich. Dieses Dokument gliedert sich in drei Teile. Der erste Teil enthält wichtige Hinweise, die bei dem Upgrade zu beachten sind. Die Hinweise werden im dritten Teil wieder aufgegriffen und konkretisiert. Der zweite Teil gibt einen Überblick über das generelle Vorgehen beim Upgrade. Der dritte Teil beschreibt detailliert den Upgrade-Prozess am Beispiel des Tomcat-Servlet-Containers und der ARCWAY Cockpit Standardinstallation. Wenn Sie Fragen zu dem hier beschriebenen Vorgehen haben, oder wenn Sie uns Kommentare oder Vorschläge zu diesem Dokument senden möchten, dann kontaktieren Sie uns bitte unter feedback@arcway.com. Wichtige Hinweise Beachten Sie bitte die folgenden Hinweise, bevor Sie mit dem Upgrade beginnen. Diese Hinweise werden im dritten Teil dieses Dokuments wiederholt und konkretisiert. E i n h e i t l i c h e V e r s i o n e n Bitte beachten Sie, dass der Server, die Clients, die auf den Server zugreifen wollen, und der Lizenzserver die gleiche Version haben müssen. Der 3.1.0 Server kann nur in Kombination mit 3.1.0 Clients eingesetzt werden, und umgekehrt. Ein Client mit einer älteren Version wird von dem 3.1.0 Server abgewiesen werden. Bei einem Upgrade ist es somit erforderlich, den Server, den Lizenzserver und die Clients neu zu installieren. Vorhandene Lizenzen der ARCWAY Cockpit Version 3.0 können weiter verwendet werden. P r o j e k t v s. S e r v e r A r c h i v i e r e n Um die Daten von einer Version zur nächsten zu migrieren, ist es erforderlich, die Daten des alten Servers zu archivieren und nach der Installation des neuen Servers wiederherzustellen. Dabei haben Sie die Option, den gesamten Server oder nur ausgewählte Projekte des Servers zu archivieren und später wiederherzustellen. Bitte beachten Sie, dass beim Archivieren eines Projekts die Benutzer und Gruppen des Servers nicht mit archiviert werden. Bei einem Archivieren und Wiederherstellen von einzelnen Projekten ist es somit erforderlich die Nutzer erneut anzulegen. Bei einem Archivieren und Wiederherstellen des gesamten Servers werden alle Projekte des Servers sowie die Nutzer und Gruppen des Servers übernommen. Diese Vorgehensweise wird für die Datenmigration beim Upgrade empfohlen. D a t e n b a n k u n d P l a n a r c h i v n e u a n l e g e n o d e r w i e d e r v e r w e n d e n Der Cockpit Server verwendet externe Systeme für die Datenablage (Datenbank, Archiv für Pläne, z. B. WebDAV-Archiv), die in der Servlet-Konfiguration des verwendeten Servlet- Containers angegeben sind. Bei einem Upgrade des Servers haben Sie die Option, die entsprechenden Datenablagen wieder zu verwenden oder neue anzulegen. 1

Wenn Sie bestehende Datenablagen (Datenbank, Archiv) wieder verwenden, müssen Sie sicherstellen, dass diese bei der Datenmigration vor dem Einspielen der existierenden Daten leer sind. Wenn Sie die Datenbank oder das Archiv neu anlegen, müssen Sie sicherstellen, dass Sie in der Servlet-Konfiguration nicht versehentlich noch auf die alte Datenbank oder das alte Archiv verweisen. E i n R e c h n e r v i e l e C l i e n t s Bitte beachten Sie, dass auf einem Rechner unter Umständen verschiedene Nutzer arbeiten. ARCWAY Cockpit ist in der Standardkonfiguration so eingestellt, dass jeder Windows-Nutzer einen eigenen, virtuellen Client hat. Die Client-Software wird einmalig für alle Nutzer eines Rechners installiert, aber jeder Nutzer des Rechners hat seine persönlichen Einstellungen und persönliche lokale Daten (für Änderungen). Upgrade Überblick In diesem Abschnitt werden die für ein Upgrade erforderlichen Schritte aufgelistet. Im folgenden Abschnitt werden diese ausführlich behandelt. 1. Vorbereiten der Clients bei der Arbeit mit dem Cockpit-Server speichern die Clients Änderungen lokal auf der Festplatte. Diese lokal gespeicherten Änderungen können von der neuen Client Version nicht mehr interpretiert werden. Vor der Durchführung des Upgrades müssen die lokalen Änderungen von allen Clients auf den Server übertragen werden. 2. Archivieren der zu migrierenden Daten um die Daten von einer Version zur anderen zu migrieren, ist es erforderlich, die Daten in der alten Installation zu archivieren um sie nach dem Upgrade in der neuen Installation wieder einspielen zu können. 3. Deinstallation des bestehenden Systems vor der Installation der neuen Version müssen die bestehenden Cockpit Systeme (Clients und Server) deinstalliert werden. 4. Vorbereiten der Datenbank und des Archivs der Server benutzt externe Systeme (Datenbank, Planarchiv) zum Speichern seiner Daten. Sollen nach dem Upgrade die gleichen Datenablagen wieder verwendet werden, so müssen diese geleert werden. Andernfalls müssen die externen Datenablagen neu angelegt werden. 5. Installation des neuen Systems in diesem Schritt wird die alte Cockpit Version sowohl auf den Clients als auch auf dem Server deinstalliert und die neue Version installiert. Nach der Deinstallation von Server und Clients müssen diese neu konfiguriert werden. Bei der Installation des Servers wird automatisch eine Standardkonfiguration eingestellt. Diese ist ggf. anzupassen. 6. Wiederherstellen der Daten nach der Installation des neuen Systems müssen die Daten des alten Systems wieder eingespielt werden. Hierbei erfolgt intern automatisch eine Umstellung auf die neuen Datenstrukturen. 7. Einrichten der Clients nachdem der neue Cockpit Server installiert ist, kann dieser bei den neuen Clients eingetragen werden. 2

Upgrade Detailliert In diesem Abschnitt werden die einzelnen Schritte, die für ein Upgrade notwendig sind, detailliert beschrieben. Gegebenenfalls werden bei bestimmten Alternativen Empfehlungen gegeben. 1 Vorbereiten der Clients Die Clients speichern Änderungen des Nutzers auf der lokalen Festplatte. Erst wenn der Nutzer seine Änderungen auf den Server lädt oder seine Änderungen verwirft, werden die lokal gespeicherten Änderungen gelöscht. Beim Upgrade müssen auch die Clients aktualisiert werden, da Client und Server dieselbe Version haben müssen. Die Änderungen, die von dem alten Client lokal gespeichert wurden, können von dem neuen Client ggf. nicht gelesen werden. Es ist deshalb erforderlich lokale Änderungen der Clients mit dem Server abzugleichen. Bitte starten Sie den Client und überprüfen Sie alle Projekte auf lokal gespeicherte Änderungen. Hinweis: Auch wenn ein Projekt geschlossen ist, kann es lokale Änderungen haben. Bitte öffnen Sie alle Projekte, die Sie im Projektnavigator sehen. Lokale Änderungen werden durch ein Sternchen vor dem Projektnamen angezeigt. Hat ein Projekt lokale Änderungen, so können Sie durch einen Klick mit der rechten Maustaste auf das Projekt und Auswahl der entsprechenden Einträge im Kontextmenü die Änderungen hoch laden oder verwerfen. Bitte gehen Sie alle Projekte durch! Anschließend empfiehlt es sich, den Client zu beenden. Hinweis: Bitte beachten Sie, dass auf einem Rechner unter Umständen verschiedene Nutzer arbeiten. ARCWAY Cockpit ist in der Standardkonfiguration so eingestellt, dass jeder Windows-Nutzer einen eigenen Arbeitsbereich hat. 3

2 Archivieren der zu migrierenden Daten Nachdem im ersten Schritt die lokalen Änderungen von den Clients hochgeladen wurden, sind alle relevanten Daten nun auf dem Server gespeichert und können gesichert werden. Achtung: Bitte stellen Sie sicher, dass Sie die Daten nicht archivieren, während andere Nutzer auf dem Server arbeiten. Dies ist zwar ohne Probleme möglich, aber alle Änderungen, die nach dem Archivieren der Daten auf dem Server vorgenommen werden, gehen verloren. Um die Daten eines Servers zu archivieren, müssen Sie einen Client starten und sich mit dem Server als ein Nutzer mit Systemadministration oder Operator-Zugriffsrecht verbinden. Sobald Sie mit dem Server verbunden sind, können Sie über das Menü Cockpit Verwaltung den gesamten Server oder einzelne Projekte auf dem Server archivieren. Beim Archivieren eines Servers werden alle Projekte des Servers sowie die Nutzer und Gruppen des Servers übernommen. Beim Archivieren eines Projekts wird nur das Projekt archiviert. Insbesondere werden die Benutzer und Gruppen des Servers nicht mit archiviert. Bei einem Archivieren und Wiederherstellen von einzelnen Projekten ist es somit erforderlich, die Nutzer und Gruppen nach dem Upgrade erneut anzulegen. Empfehlung: Wir empfehlen Ihnen, zuerst auf dem alten Server aufzuräumen und eventuell nicht mehr benötigte Projekte zu löschen, und dann den gesamten Server zu archivieren. Um einen Server oder ein Projekt zu archivieren, wählen Sie den entsprechenden Eintrag in dem Menü Cockpit Verwaltung aus. Sie gelangen zu einem Dialog, in dem Sie den zu archivierenden Server bzw. das zu archivierende Projekt auswählen können. Treffen Sie die gewünschte Auswahl und geben Sie eine Datei an, in die die Daten gespeichert werden sollen. Die so erstellten Dateien bilden die Grundlage für die Wiederherstelllung der Daten in Schritt 6. Hinweis: Das Archivieren eines Projekts oder eines Servers kann je nach Größe des Projekts mehrere Minuten in Anspruch nehmen. Während dieser Zeit ist der Client blockiert. Es öffnet sich ein Statusdialog, der anzeigt, dass auf eine Antwort des Server gewartet wird. Solange dieser Dialog aktiv ist, generiert der Server das Archiv. Brechen Sie den Vorgang nicht vorzeitig ab! 4

3 Deinstallation des bestehenden Systems Nachdem die Daten nun gesichert wurden, muss das bestehende Cockpit-System deinstalliert werden. Dieser Schritt ist notwendig, da sonst Dateien des alten Cockpit-Systems das neue System beeinträchtigen können. D e i n s t a l l a t i o n d e r S e r v e r - K o m p o n e n t e n Bevor der neue Cockpit-Server installiert werden kann, müssen die alten Server-Komponenten deinstalliert bzw. entfernt werden. Zu den Server-Komponenten gehören in jedem Fall die folgenden Servlets: CockpitServer CockpitLicenseServer sowie, falls installiert Weitere Instanzen des Cockpit Servers E n t f e r n e n d e r S e r v e r-k o m p o n e n t e n a u s T o m c a t Bevor Sie die Server-Komponenten entfernen können, müssen Sie den Servlet-Container Tomcat stoppen. Zum Anhalten des Tomcat können sie beispielsweise wie folgt vorgehen: Klicken sie auf Start (Rechtsklick auf) Arbeitsplatz Verwalten Es öffnet sich das Werkzeug zum Verwalten der Dienste und Anwendungen des Rechners. Wählen Sie in diesem Dialog den Eintrag Dienste aus, klicken Sie mit der rechten Maustaste auf den EintragApache Tomcat 5.5 und wählen Sie im KontextmenüAnhalten. Anschließend müssen Sie die Verzeichnisse und WAR-Dateien der Servlets löschen. Die Servlet- Verzeichnisse und WAR-Dateien befinden sich in dem Verzeichnis [Tomcat Hauptverzeichnis]\webapps und heißen genau so, wie die Servlets. Empfehlung: Wir empfehlen Ihnen, zuerst eine Sicherheitskopie der betroffenen Dateien und Ordner anzulegen. 5

Sichern + Löschen Bitte löschen Sie die Verzeichnisse (siehe Bildschirmfoto) CockpitServer CockpitLicenseServer sowie, falls installiert Weitere Instanzen des Cockpit Servers und die Dateien CockpitServer.war CockpitLicenseServer.war sowie, falls installiert Weitere Kopien der Cockpit Server-WAR-Datei Hinweis: Wenn Sie das ARCWAY Cockpit in der Standardinstallation betreiben, so wurde beim Löschen der Verzeichnisse auch die Datenbank und das Archiv gelöscht. Sie können sofort zu Schritt 5 springen. Standardinstallation bezieht sich auf die Anleitung für die Standard- Installation im Dokument Server-Installation ohne eine anschließende Anpassung oder Veränderung der Standard-Konfiguration Starten Sie nun den Tomcat Server erneut, indem Sie in dem Kontextmenü des Dienste und Anwendungen Werkzeugs aufstarten klicken. Als nächstes muss die alte Konfiguration der Servlets gelöscht werden. Dies geschieht in dem Tomcat Administrations-Werkzeug. Das Tomcat-Administrations-Werkzeug steht zur Verfügung unter: http://[ip]:[tomcat Port]/admin/ (z. B. http://localhost:8080/admin/ ). 6

Sie müssen sich mit der Administrator-Kennung anmelden, die während der Installation von Tomcat erzeugt wurde. Hinweis: Sie können das Passwort nachschlagen, indem Sie die Datei [Tomcat Home]/conf/tomcat-users.xml öffnen Nach dem Login sehen Sie die Administrations-Seite. Bitte führen Sie folgende Schritte aus: Tomcat Server->Service (Tomcat Standalone)->Host (localhost) Klicken Sie in der Auswahlliste Host Actions im rechten, oberen Bildschirmbereich auf Delete Existing Contexts. Danach sollten Sie folgenden Bildschirm sehen: Markieren Sie nun die Einträge CockpitServer CockpitLicenseServer sowie, falls installiert 7

Weitere Instanzen des Cockpit Servers Die Änderungen werden übernommen, wenn Sie auf Save und danach auf Commit Changes klicken. Dadurch werden die alten Konfigurationen aus der von Tomcat verwalteten Konfigurationsdatei entfernt. E n t f e r n e n d e r S e r v e r -K o m p o n e n t e n a u s e i n e m a n d e r e n S e r v l e t- C o n t a i n e r Bitte konsultieren Sie die Dokumentation Ihres Servlet-Containers für Informationen zum Entfernen von Servlets (Web-Applikationen). D e i n s t a l l a t i o n d e s C l i e n t s Um den Client zu deinstallieren, klicken Sie bitte auf Start Programme ARCWAY Cockpit Uninstall. Dadurch wird das mitgelieferte Deinstallationsprogramm gestartet, dass den Client automatisch entfernt. Detail: Der Deinstaller entfernt nicht den Workspace des ARCWAY Cockpit Clients. Dieses Verzeichnis liegt in der Standardeinstellung unter C:\Dokumente und Einstellungen\[Benutzername]\ Anwendungsdaten\ARCWAY\CockpitWorkspace300CS. Dieses Verzeichnis kann gelöscht werden. Dies ist jedoch nicht zwingend erforderlich. Bitte beachten Sie, dass als Standardeinstellung jeder Windows-Nutzer sein eigenes Benutzer-Verzeichnis und somit seinen eigenen Workspace hat. 4 Vorbereiten der Datenbank und des Archivs Jeder ARCWAY Cockpit Server verwendet externe Systeme zur Speicherung der von ihm verwalteten Daten. Das ist zum einen die Datenbank und zum anderen das Archiv für Plandateien. Sie haben die Möglichkeit, die selben externen Datenablagen weiterhin zu verwenden oder neue externe Datenablagen anzulegen. Hinweis: Wenn Sie ARCWAY Cockpit in der Standardinstallation betreiben, und im letzten Schritt die angegebenen Verzeichnisse und Dateien gelöscht haben, so wurde beim Löschen der Verzeichnisse auch die Datenbank und das Archiv gelöscht. Sie können diesen Schritt überspringen. Standardinstallation bezieht sich auf die Anleitung für die Standard- Installation im Dokument Server-Installation ohne eine anschließende Anpassung oder Veränderung der Standard-Konfiguration A n l e g e n n e u e r D a t e n a b l a g e n Wenn Sie neue Datenablagen anlegen, müssen Sie lediglich sicherstellen, dass diese in die Konfiguration des Servers eingetragen werden. Empfehlung: Wir empfehlen Ihnen, neue Datenablagen anzulegen. Sie können zum Beispiel eine neue Datenbank einrichten und für eine gewisse Zeit parallel zur alten Datenbank laufen lassen. Nach erfolgreichem Upgrade und produktivem Einsatz der neuen Version können Sie dann die alte Datenbank löschen. W i e d e r v e r w e n d e n d e r D a t e n a b l a g e n Wollen Sie die bisher verwendeten Datenablagen weiterhin verwenden, so müssen Sie sie vor der Installation des neuen Servers vollständig leeren. 8

Achtung: Es dürfen sich keine Daten des Altsystems in den von dem neuen System verwendeten externen Ressourcen befinden, wenn das neue System gestartet wird! Für die Datenbank bedeutet das, dass alle Tabellen zusammen mit deren Inhalt aus der Datenbank gelöscht werden müssen. Für ein Archiv im Dateisystem oder WebDAV-Archiv bedeutet das, dass alle Dateien und Verzeichnisse unterhalb der Wurzel des Archivs gelöscht werden müssen. 5 Installation des neuen Systems Die Installation des neuen Systems verläuft genau so, wie bei einer Neuinstallation. Zur Installation des Servers ziehen Sie bitte das Dokument Server-Installation zu Rate und folgen den dort angegebenen Schritten, wobei Sie die ersten drei Schritte ( Schritt 1 - Installieren von Java, Schritt 2 Setzen der Umgebungsvariable JAVA_HOME und Schritt 3 Installieren von Tomcat ) überspringen können sofern Java 1.5 und Tomcat 5.x verwendet werden. Ist dies nicht der Falll, gehen Sie bitte alle Schritte durch. Zur Installation des Clients ziehen Sie bitte die Client Installationsanleitung zu Rate und folgen den dort angegebenen Schritten. 6 Wiederherstellen der Daten Als letztes werden die Daten der alten Cockpit Version in die neue Installation eingespielt. Starten Sie hierzu bitte einen Client, richten den Server ein und verbinden sich mit dem Server als Administrator. Beim Start des Servers wurde auch der Administrator-Nutzer erstellt. Dieser Zugang erlaubt Ihnen den Zugriff auf das Menü Cockpit Verwaltung. In diesem Menü finden Sie Menüpunkte, mit denen Sie ein zuvor archiviertes Projekt oder den Inhalt eines zuvor archivierten Servers wiederherstellen können. Nach einem Klick auf einen dieser Menüpunkte startet ein Dialog, in dem Sie die wiederherzustellende Datei und den Server auswählen können. Hinweis: Das Einspielen der Daten eines Projekts oder eines Servers kann je nach Größe des Projekts mehrere Minuten in Anspruch nehmen. Während dieser Zeit ist der Client blockiert. Es wird lediglich angezeigt, dass eine Antwort des Servers erwartet wird. Brechen Sie den Vorgang nicht vorzeitig ab! Nach dem Wiederherstellen der Daten sollten alle Projekte, die mit ARCWAY Cockpit 2.0 oder älter erstellt wurden einmal durch den Administrator geöffnet werden. Dabei werden weitere notwendige Migrationsprozeduren durchgeführt. Nach der Migration enthalten die Projekte Änderungen, die auf den Server gespielt werden müssen. 9

7 Einrichten der Clients Nachdem die bestehenden Daten in den neuen Server eingespielt wurden, können die neu installierten Clients konfiguriert werden. Hierbei müssen auf den Clients die Server und die verwendeten Projekte eingerichtet werden. 10