Upgrade von ADOIT 11.0/11.1 auf ADOIT 15.1

Planen Sie ein Upgrade von ADOIT 11.0/11.1 auf ADOIT 15.1? Dieser Leitfaden führt Sie durch die notwendigen Schritte, um einen reibungslosen Übergang zu gewährleisten.

Voraussetzungen

Beachten Sie folgende Voraussetzungen, bevor Sie fortfahren:

• Stellen Sie anhand der Hardware-/Software-Anforderungen sicher, dass Ihr System alle Voraussetzungen erfüllt.

• Laden Sie das ADOIT 15.1 Installationspaket herunter (Ihr ADOIT-Kundenbetreuer wird Ihnen per E-Mail einen Link senden).

• Erzeugen Sie ein Backup der ADOIT-Datenbank.

Anwendungsbibliothek für ADOIT 15.1

Sie können sofort loslegen, wenn Sie eine Standardbibliothek verwenden, die mit ADOIT ausgeliefert wird (die ArchiMate-Anwendungsbibliothek oder die ADOIT Standard-Anwendungsbibliothek).

Bitte wenden Sie sich an Ihren ADOIT-Kundenbetreuer, wenn Sie eine andere Anwendungsbibliothek verwenden. Dies umfasst   ArchiMate-Anwendungsbibliotheken oder ADOIT Standard-Anwendungsbibliotheken mit Anpassungen im Metamodell oder mit funktionalen Erweiterungen oder andere spezifische Bibliotheken. Möglicherweise benötigen Sie eine neue Version Ihrer Bibliothek.

Dienste stoppen

Zunächst müssen der ADOIT 11.0/11.1 Applikations-Server und der Apache Tomcat Dienst gestoppt werden.

So stoppen Sie die Dienste (in Windows):

• Öffnen Sie Dienste. Drücken Sie <Windows> + < R>, um das Feld Ausführen zu öffnen, geben Sie services.msc ein, und klicken Sie dann OK.

• Stoppen Sie den ADOIT Applikations-Server (Service-Name z.B. "ADOITServer11.1Service") und den Apache Tomcat Web-Server (Service-Name z. B. "Tomcat9").

Komponenteneinstellungen exportieren

Mithilfe der Komponenteneinstellungen können Sie eine Vielzahl von bibliotheksspezifischen Funktionen anpassen. Damit Sie Ihre Einstellungen nicht während dem Upgrade verlieren, müssen Sie jetzt die ADOIT 11.0/11.1 Komponenteneinstellungen exportieren. Später müssen Sie diese zurück importieren, nachdem Sie die Anwendungsbibliothek aktualisiert haben.

So exportieren Sie die Komponenteneinstellungen:

• Wechseln Sie im ADOIT 11.0/11.1 Administrations-Toolkit zu Bibliothekenverwaltung > Komponenteneinstellungen.

• Wählen Sie Ihre Bibliothek aus und klicken Sie dann auf Komponenteneinstellungen exportieren.

• Wählen Sie Alle Komponenteneinstellungen exportieren aus, um alle Einstellungen auf einmal zu exportieren. Alternativ können Sie das Kontrollkästchen deaktivieren und die Komponenteneinstellungen auswählen, die Sie exportieren möchten.

• Geben Sie im Feld Exportdatei einen Namen für die Exportdatei ein.

• Klicken Sie auf Exportieren. Die Daten werden exportiert.

Deployment-spezifische Daten sichern

Deployment-spezifische Daten umfassen unterschiedliche Einstellungen und Informationen, die nicht in der Datenbank gespeichert werden. Dazu gehören beispielsweise Kommentare zu Modellen und Objekten, Einstellungen wie Server-Ports und mehr.

Abhängig von Ihrer ADOIT 11.0/11.1-Installation, müssen Sie folgende Ordner und Dateien sichern:

ADOIT Applikations-Server Konfiguration

• <ADOIT 11.x Applikations-Server>/conf/server.conf (enthält den Datenbanknamen, Ports für Applikations-Server oder aworker-Prozesse und die vertrauenswürdige IP-Adresse des Web-Servers).

• <ADOIT 11.x Applikations-Server>/conf/adoxx.conf (optional, wenn der Standardwert von Parametern geändert wurde)

• <ADOIT 11.x Applikations-Server>/conf/adoxx_web_conf.js (optional, wenn der Standardwert von Parametern geändert wurde)

Apache Tomcat Konfiguration

• <Tomcat>/webapps/ADOIT11_x/adoxx_web.properties (enthält die IP-Adresse des Applikations-Servers und die Definition der aworker-Prozesse)

• <Tomcat>/webapps/ADOIT11_x/WEB-INF/classes/logback.xml (optional, wenn Logging-Parameter geändert wurden)

• <Tomcat>/webapps/ADOIT11_x/WEB-INF/web.xml (optional, wenn zusätzliche Dateitypen für das Hochladen freigegeben wurden)

• <Tomcat>/webapps/ADOIT11_x/WEB-INF/registry/rest/RESTAuthorization.xml (Teil der REST-API-Konfiguration)

Kommentardaten

• <Tomcat>/webapps/ADOIT11_x/WEB-INF/registry/collaboration (enthält XML-Dateien mit allen Kommentaren zu einem Modell oder Objekt)

• <Tomcat>/webapps/ADOIT11_x/WEB-INF/registry/upload (enthält Dateien, die zusammen mit Kommentaren hochgeladen wurden)

• <Tomcat>/webapps/ADOIT11_x/WEB-INF/registry/axw.ids (enthält die zuletzt vergebene, höchste Kommentar-ID)

Datenbankschema aktualisieren

Das Datenbankschema hat sich zwischen ADOIT 11.0/11.1 und ADOIT 15.1 geändert, um neue Funktionen zu unterstützen. Damit Sie weiterhin mit Ihrer bestehenden Datenbank und ADOIT 15.1 arbeiten können, müssen Sie Upgrade-Skripte ausführen. Diese Skripte befinden sich im Installationspaket von ADOIT 15.1 im Verzeichnis 02 Rich Client\BOC\ADOIT 15.1.x\data\migration\platform.

Datenbankschema für Microsoft SQL Server aktualisieren

Für Microsoft SQL Server-Datenbanken verwenden Sie das Tool »SQL Server Management Studio«, um die Upgrade-Skripte auszuführen. Je nach Ihrer ADOIT-Version müssen Sie ein oder zwei Skripte ausführen:

1. Starten Sie das SQL Server Management Studio. Geben Sie im Dialogfenster Verbindung mit Server herstellen die erforderlichen Informationen wie Servertyp, Servername und den Modus der Authentifizierung ein. Klicken Sie dann auf Verbinden.

2. Optional: Wenn Sie ADOIT 11.0 verwenden, öffnen Sie das Skript sqlserver_upgrade2500bTo2600a.sql, indem Sie auf die Schaltfläche Datei öffnen klicken. Wählen Sie Ihre Datenbank aus der Dropdown-Liste Verfügbare Datenbanken aus und führen Sie das Skript mit Ausführen ("F5") aus.

3. Öffnen Sie das Skript sqlserver_upgrade2600aTo2800a.sql, indem Sie auf die Schaltfläche Datei öffnen klicken. Wählen Sie Ihre Datenbank aus der Dropdown-Liste Verfügbare Datenbanken aus und führen Sie das Skript mit Ausführen ("F5") aus.

4. Schließen Sie das SQL Server Management Studio.

Datenbankschema für Oracle aktualisieren

Für Oracle-Datenbanken verwenden Sie das Tool »SQL Plus«, um die Upgrade-Skripte auszuführen. Je nach Ihrer ADOIT-Version müssen Sie ein oder zwei Skripte ausführen:

1. Öffnen Sie eine Windows-Eingabeaufforderung und geben Sie den Befehl sqlplus.exe system@<DB-Name> ein, wobei <DB-Name> durch den Namen Ihrer Datenbank ersetzt wird. Geben Sie das Passwort für den Datenbankbenutzer system ein, wenn Sie dazu aufgefordert werden.

2. Optional: Wenn Sie ADOIT 11.0 verwenden, führen Sie das Skript oracle_upgrade2500bTo2600a.sql mit folgendem Befehl aus: start <pfadname>\oracle_upgrade2500bTo2600a.sql, wobei <pfadname> der Speicherort des Skripts ist.

3. Führen Sie das Skript oracle_upgrade2600aTo2800a.sql mit folgendem Befehl aus: start <pfadname>\oracle_upgrade2600aTo2800a.sql, wobei <pfadname> der Speicherort des Skripts ist.

4. Schließen Sie SQL Plus mit exit.

ADOIT 15.1 Rich-Client installieren und konfigurieren

Jetzt ist es an der Zeit, den ADOIT 15.1 Rich-Client zu installieren und zu konfigurieren. Dieser dient als Applikations-Server und wird für die Verwendung des Administrations-Toolkits benötigt. Detaillierte Anweisungen finden Sie in den folgenden Abschnitten.

Installation durchführen

Installieren Sie den ADOIT 15.1 Rich-Client. Abhängig vom Deployment-Szenario müssen Sie folgende Schritte durchführen:

• Installieren Sie ADOIT als Applikationsserver auf dem vorgesehenen Server-Rechner.

• Installieren Sie ADOIT zur Nutzung des Administrations-Toolkits, beispielsweise auf Client-Rechnern oder einem Terminalserver.

So führen Sie die Installation durch:

• Doppelklicken Sie auf setup.exe im Ordner 02 Rich Client im ADOIT 15.1 Installationspaket und befolgen Sie die Anweisungen des Installationsassistenten.

Hinweis

Für detaillierte Anweisungen zum Installationsprozess siehe Rich-Client installieren.

Applikations-Server konfigurieren

Nachdem die Installation abgeschlossen ist, wird der ADOIT 15.1 Applikations-Server konfiguriert. Anders als bei einer Neuinstallation, bei der Werte initial festlegt werden, verwenden Sie hier Ihre gesicherten ADOIT 11.0/11.1 Applikations-Server Konfigurationsdateien und übernehmen die Werte von dort.

So konfigurieren Sie den Applikations-Server:

• Navigieren Sie zum Verzeichnis <ADOIT 15.1 Applikations-Server>/conf.

• Bearbeiten Sie die Konfigurationsdatei server.conf und übertragen Sie die Werte aus Ihrer Sicherungsdatei, einschließlich des Datenbanknamens, der Ports für Applikations-Server oder aworker-Prozesse sowie der vertrauenswürdigen IP-Adresse des Web-Servers.

• Optional: Bearbeiten Sie die Konfigurationsdateien adoxx.conf und adoxx_web_conf.js und übertragen Sie die Werte aus Ihren Sicherungsdateien, wenn Parameter in diesen Dateien in ADOIT 11.0/11.1 geändert wurden.

Beispiel

Wenn Sie beispielsweise zuvor die Datei adoxx_web_conf.js angepasst haben, um die Standard-Sprache für den Web-Client anzupassen, kopieren Sie den Wert des Parameters ADOXX_WEB_CLIENT_LANGUAGE in die neue adoxx_web_conf.js-Datei.

Achtung

Fügen Sie Ihre Änderungen immer in die neuen Konfigurationsdateien ein - überschreiben Sie diese niemals!

Skripte zur Vorbereitung der Bibliotheksstruktur ausführen (nur ArchiMate)

Wenn Sie die ArchiMate-Anwendungsbibliothek verwenden, müssen Sie zwei Skripte ausführen, um die Bibliotheksstruktur für das Aktualisieren der Anwendungsbibliothek im nächsten Schritt vorzubereiten. Diese Skripte finden Sie im Installationspaket von ADOIT 15.1 unter 05 Migration.

So führen Sie die Migrationsskripte aus:

1. Starten Sie das ADOIT 15.1 Administrations-Toolkit und melden Sie sich an der ADOIT-Datenbank an.

2. Wechseln Sie zu Extras > JavaScript-Datei ausführen.

3. Klicken Sie auf Durchsuchen... und wählen Sie die Datei 12.0 - mm script.js aus. Klicken Sie anschließend auf Ausführen.

4. Beenden und starten Sie das ADOIT 15.1 Administrations-Toolkit neu und melden Sie sich an der ADOIT-Datenbank an (notwendig für die Ausführung des zweiten Skripts).

5. Wechseln Sie zu Bibliothekenverwaltung > Bibliotheken > Metamodellfragment importieren....

6. Wählen Sie die Datei 12.0 - mm.js aus. Das Metamodellfragment wird importiert. Klicken Sie anschließend auf Metamodelländerungen speichern.

Anwendungsbibliothek aktualisieren

Als Nächstes muss Ihre Anwendungsbibliothek aktualisiert werden.

Was bedeutet das für meine Bibliothek?

• Wenn Sie die standardmäßige ArchiMate-Anwendungsbibliothek oder die standardmäßige ADOIT Standard-Anwendungsbibliothek verwenden: Datenbanken, die mit ADOIT 11.0/11.1 erstellt wurden, können nach der Aktualisierung des Datenbankschemas weiterhin mit ADOIT 15.1 verwendet werden. Sie erhalten dann aber keinen Zugriff auf Neuerungen in Ihrer Bibliothek. Optional: Aktualisieren Sie die Bibliothek in der ADOIT-Datenbank. Eine neue Version Ihrer Bibliothek finden Sie im Ordner 04 Sample Data\Library im Installationspaket.

• Wenn Sie eine   ArchiMate-Anwendungsbibliothek oder ADOIT Standard-Anwendungsbibliothek mit Anpassungen im Metamodell verwenden: Datenbanken, die mit ADOIT 11.0/11.1 erstellt wurden, können nach der Aktualisierung des Datenbankschemas weiterhin mit ADOIT 15.1 verwendet werden. Sie erhalten dann aber keinen Zugriff auf Neuerungen in Ihrer Bibliothek. Optional: Wenden Sie sich an Ihren ADOIT-Berater, um Ihre Anwendungsbibliothek zu aktualisieren.

• Wenn Sie eine   ArchiMate-Anwendungsbibliothek oder ADOIT Standard-Anwendungsbibliothek mit funktionalen Erweiterungen oder eine andere, spezifische Bibliothek verwenden: Bitte wenden Sie sich an Ihren ADOIT-Kundenbetreuer, um herauszufinden, ob Sie eine neue Version Ihrer Anwendungsbibliothek benötigen. Aktualisieren Sie die Bibliothek in der ADOIT-Datenbank, wenn Sie eine neue Bibliotheksdatei erhalten haben.

Aktualisierung durchführen

So aktualisieren Sie Ihre Anwendungsbibliothek:

1. Starten Sie das ADOIT 15.1 Administrations-Toolkit und melden Sie sich an der ADOIT-Datenbank an.

2. Wechseln Sie zu Bibliothekenverwaltung, wählen Sie Ihre Bibliothek aus und klicken Sie dann auf Bibliothek aktualisieren.

3. Klicken Sie auf Durchsuchen... und wählen Sie die Datei aus, die Sie importieren möchten.

4. Deaktivieren Sie das Kontrollkästchen Komponenteneinstellungen nicht importieren.

   Hinweis

   Wenn Komponenteneinstellungen nicht importieren deaktiviert ist, werden Ihre vorhandenen Komponenteneinstellungen mit denen aus der Importdatei überschrieben. Dies ist erforderlich, um neue Komponenteneinstellungen hinzuzufügen, die in ADOIT 11.0/11.1 nicht vorhanden sind. Später werden Sie Ihre exportierten Komponenteneinstellungen zurück importieren, und so Ihre vorherigen Einstellungen für alle Komponenteneinstellungen wiederherstellen, die bereits in ADOIT 11.0/11.1 vorhanden waren.

5. Klicken Sie auf Importieren. Die Bibliothek wird aktualisiert.

Komponenteneinstellungen importieren

Wenn Sie die Anwendungsbibliothek im vorherigen Schritt aktualisiert haben, ist es jetzt an der Zeit, Ihre exportierten Komponenteneinstellungen zurück zu importieren.

So importieren Sie die Komponenteneinstellungen:

• Wechseln Sie im ADOIT 15.1 Administrations-Toolkit zu Bibliothekenverwaltung > Komponenteneinstellungen.

• Wählen Sie Ihre Bibliothek aus, und klicken Sie dann auf Komponenteneinstellungen importieren.

• Klicken Sie auf Durchsuchen... und wählen Sie die Datei aus, die Sie importieren möchten. Anschließend klicken Sie auf Importieren.

• Klicken Sie auf Alle, um alle Komponenteneinstellungen für den Import auszuwählen, und klicken Sie dann auf OK. Wenn Sie zum Fortfahren aufgefordert werden, klicken Sie auf Ja. Die Daten werden importiert.

Migrationsskripte ausführen (nur ArchiMate)

Wenn Sie die ArchiMate-Anwendungsbibliothek verwenden, und sie aktualisiert haben, müssen Sie an diesem Punkt Migrationsskripte ausführen. Diese Skripte finden Sie im Installationspaket von ADOIT 15.1 unter 05 Migration.

Warum Migrationsskripte?

Die ArchiMate-Anwendungsbibliothek wurde von ADOIT 11.0/11.1 bis ADOIT 15.1 weiterentwickelt und beinhaltet methodische Verbesserungen. Um potenziellen Datenverlust zu verhindern, müssen Sie Ihre Repository-Inhalte an die neue Methode anpassen, und hier kommen die Migrationsskripte ins Spiel.

So führen Sie die Migrationsskripte aus:

1. Wechseln Sie im ADOIT 15.1 Administrations-Toolkit zu Extras > JavaScript-Datei ausführen.

2. Klicken Sie auf Durchsuchen... und wählen Sie die Datei 15.0 - repo 1.js aus. Klicken Sie anschließend auf Ausführen.

3. Wiederholen Sie die Schritte 1 - 2 für das Skript 15.1 - repo grouping_layer.js.

Hinweis

Für Details zu den Skripten siehe Migrationsskripte.

Installation des Applikations-Servers als Dienst

Nach der Installation und Konfiguration des Rich-Clients ist es nun an der Zeit, den ADOIT 15.1 Applikations-Server als Dienst zu installieren.

• Öffnen Sie die Windows-Eingabeaufforderung als Administrator. Drücken Sie <Windows> + < R>, um das Feld Ausführen zu öffnen, geben Sie cmd ein, und drücken Sie dann <Strg> + <Shift> + <Enter>.

• Navigieren Sie zum Verzeichnis <ADOIT 15.1 Applikations-Server>.

• Geben Sie den Befehl aserver.exe -i ein, um das Windows Service (z.B. ADOITServer15.1Service) zu installieren.

Der Applikations-Server ist nun als Dienst installiert. Starten Sie den Dienst noch nicht.

ADOIT 15.1 Web-Client installieren und konfigurieren

Jetzt müssen Sie den ADOIT 15.1 Web-Client bereitstellen und mithilfe von Sicherungsdateien aus Ihrem ADOIT 11.0/11.1 Deployment konfigurieren. Durch die Verwendung derselben Tomcat-Instanz, die bereits den ADOIT 11.0/11.1 Web-Client hostet, sparen Sie sich aufwendige Konfigurationsarbeiten. Detaillierte Anweisungen finden Sie in den folgenden Abschnitten.

Web-Client bereitstellen

Stellen Sie jetzt die ADOIT 15.1 Webapplikation auf Apache Tomcat bereit, indem Sie die notwendigen Dateien kopieren:

• Kopieren Sie die Datei ADOIT15_1.war in das Verzeichnis <Tomcat>/webapps. Diese Datei befindet sich im Ordner 03 Web Client im ADOIT 15.1 Installationspaket.

Der ADOIT 15.1 Web-Client ist jetzt bereitgestellt. Starten Sie den Apache Tomcat-Service noch nicht.

Web Client konfigurieren

Jetzt ist es an der Zeit, den ADOIT 15.1 Web-Client zu konfigurieren. Anders als bei einer Neuinstallation, bei der Werte initial festlegt werden, verwenden Sie hier Ihre gesicherten ADOIT 11.0/11.1 Apache Tomcat-Konfigurationsdateien und übernehmen die Werte von dort. Außerdem werden Sie die Kommentardaten importieren.

So konfigurieren Sie den Web-Client:

1. Navigieren Sie zum Verzeichnis <Tomcat>/webapps.

2. Öffnen Sie die Datei ADOIT15_1.war mit einer Komprimierungs-Software und bearbeiten Sie den Inhalt folgendermaßen:

   • Bearbeiten Sie die Konfigurationsdatei adoxx_web.properties. Übertragen Sie die Werte aus Ihrer Sicherungsdatei, einschließlich der IP-Adresse des Applikations-Servers und der Definition der aworker-Prozesse.

   • Optional: Bearbeiten Sie die Konfigurationsdateien WEB-INF/classes/logback.xml, WEB-INF/web.xml und WEB-INF/registry/rest/RESTAuthorization.xml und übertragen Sie die Werte aus Ihren Sicherungsdateien, wenn Parameter in diesen Dateien in ADOIT 11.0/11.1 geändert wurden.

   • Kopieren Sie die Backupordner collaboration und upload sowie die Sicherungsdatei axw.ids in das Verzeichnis WEB-INF/registry.

3. Speichern Sie die Änderungen.

Achtung

Fügen Sie Ihre Änderungen immer in die neuen Konfigurationsdateien ein - überschreiben Sie diese niemals!

ADOIT 11.0/11.1 deinstallieren

Sie haben die Installation von ADOIT 15.1 abgeschlossen; jetzt ist es an der Zeit, ADOIT 11.0/11.1 zu deinstallieren.

• Deinstallieren Sie den ADOIT 11.0/11.1 Applikations-Server, sowie alle weiteren ADOIT 11.0/11.1 Rich-Client-Installationen zur Nutzung des Administrations-Toolkits. Dies können Sie über die Systemsteuerung erledigen.

• Entfernen Sie die ADOIT 11.0/11.1 Webapplikation aus Apache Tomcat.

Hinweis

Für ausführliche Anweisungen zur Deinstallation siehe ADOIT deinstallieren.

Dienste starten

Zum Schluss müssen der ADOIT 15.1 Applikations-Server und der Apache Tomcat Web-Server gestartet werden.

So starten Sie die Dienste (in Windows):

• Öffnen Sie Dienste. Drücken Sie <Windows> + < R>, um das Feld Ausführen zu öffnen, geben Sie services.msc ein, und klicken Sie dann OK.

• Starten Sie den ADOIT Applikations-Server (Service-Name z.B. "ADOITServer15.1Service") und den Apache Tomcat Web-Server (Service-Name z. B. "Tomcat9").

Sie können auf den Web-Client über folgende Adresse zugreifen: http://<SERVER_NAME>:<TOMCAT_PORT>/ADOIT15_1/. Dabei steht <SERVER_NAME> für den Namen des Server-Rechners, und <TOMCAT_PORT> entspricht dem beim Setup definierten HTTP/1.1 Connector-Port (der Standardwert ist "8000").

Hinweis

Nach der Migration haben die Benutzer dieselben System-Rollen (und Benutzergruppen) wie bisher. Optional: Wenn Sie die ArchiMate-Anwendungsbibliothek verwenden, können Sie jetzt die Benutzer in die neuen Standard-System-Rollen Benutzer, Leser und MM und Integration Administrator überführen. Wie das funktioniert, erfahren Sie im Abschnitt Benutzer in die neuen Standard-System-Rollen überführen.