Unten sind die Instruktionen zum Upgraden einer existierenden Crowd-Installation auf die neueste Crowd-Version, unter Verwendung des automatischen Datenbank-Upgrades.

Vorbereitung: Release Notes und Upgrade Notes lesen

Bitte lesen Sie folgendes:

• Die Release Notes für die Version, auf die Sie upgraden und
• Die Upgrade Notes für jede Version, die Sie überspringen, sowie die Version, auf die Sie upgraden.

1. Schritt: Fahren Sie Crowd und alle integrierten Anwendungen herunter

Fahren Sie Crowd und alle mit Crowd verbundenen Anwendungen herunter.

2. Schritt: Sichern Sie Ihre Crowd-Dateien

1. Sichern Sie Ihre Crowd- und CrowdID-Datenbank mit Ihren Datenbank-Backup-Tools. Wir empfehlen unbedingt diesen Schritt zu tun, für den Fall, dass etwas während des Upgrade-Prozesses schief läuft und Sie Ihre Daten aus einem Backup wiederherstellen müssen.
2. Erstellen Sie Sicherungskopien von den folgenden Dateien:
   
   • Sichern Sie Ihr Crowd Home Verzeichnis, dessen Ablageort in der crowd.init.properties Datei angegeben ist — wird empfohlen für den Fall, dass etwas während des Upgrade-Prozesses schief geht. 
   • Wenn Ihre existierende Crowd-Installation die Version 1.3.x oder 1.4.x hat: Sichern Sie die crowd.properties Datei für die Crowd Administrationskonsolen-Anwendung, die unter {CROWD_INSTALL}\crowd-webapp\WEB-INF\classes\crowd.properties  liegt — Sie müssen diese Datei in Ihre neue Crowd-Installation kopieren. 
      Dieser Schritt ist nicht erforderlich, wenn Ihre aktuelle Crowd-Installation die Version 1.5 oder neuer hat. 
   • Sichern Sie die crowd.properties Datei für die CrowdID Applikation, die unter {CROWD_INSTALL}/crowd-openidserver-webapp/WEBINF/classes/crowd.properties liegt — Sie müssen diese Datei in Ihre neue Crowd-Installation kopieren.
   • Sichern Sie Ihren Crowd JDBC Treiber, wenn Sie Crowd mit einer Datenbank konfiguriert haben. 
3. Wenn Sie Crowd auf einem separaten Anwendungsserver installiert haben, müssen Sie Ihre benutzerdefinierten Konfigurationsdateien sichern.
4. Wir empfehlen Ihnen Ihr existierendes {CROWD_INSTALL} Verzeichnis umzubenennen, weil vererbte Dateien Probleme verursachen könnten, wenn Sie die neue Crowd-Installation in ein existierendes Verzeichnis entpacken.

3. Schritt: Crowd erneut installieren

1. Laden Sie Crowd herunter.
2. Entpacken Sie das heruntergeladene Archiv in ein Verzeichnis Ihrer Wahl, unter Beachtung folgender Dinge:
   
   • Bitte stellen Sie sicher, dass Ihr neues {CROWD_INSTALL} Verzeichnis einen anderen Namen hat als Ihr altes {CROWD_INSTALL} Verzeichnis. 
   • Bitte überprüfen Sie Ihr Extrahierungsprogramm bevor Sie das heruntergeladene Archiv entpacken – lesen Sie den Hinweis auf der Titelseite über die Crowd-Installation. 
   • Definieren Sie keine Verzeichnisnamen mit Leerzeichen. 
   • Wir nennen in dieser Dokumentation das Installationsverzeichnis, in dem Sie das Archiv entpackt haben, {CROWD_INSTALL}.
3. Weisen Sie Ihre neue Crowd-Installation auf Ihr existierendes Crowd Home Verzeichnis, indem Sie die Konfigurationsdatei, die hier liegt, editieren: {CROWD_INSTALL}\crowd-webapp\WEB-INF\classes\crowd-init.properties.
   Das Crowd Home Verzeichnis ist der Ort, an dem Crowd seine Konfigurationsdaten speichern wird. Auch wenn Sie die für Evaluierungszwecke eingebettete HSQL-Datenbank benutzen, speichert Crowd seine Datenbank in diesem Verzeichnis (beachten Sie jedoch, dass die CrowdID Datenbank im Installationsverzeichnis sein wird und nicht im Home Verzeichnis). So spezifizieren Sie das Crowd Home Verzeichnis:
   
   • Öffnen Sie die crowd-init.properties Datei. Diese finden Sie hier: <crowd_install_directory>/crowd-webapp/WEB-INF/classes/crowd-init.properties
   • Wählen Sie, je nach Ihrem Betriebssystem (sehen Sie unten), die entsprechende Zeile in der Datei aus.
   • Entfernen Sie das Raute-Zeichen ("#") zu Beginn der Zeile.
   • Geben Sie den Namen des Verzeichnisses ein, welches von Crowd als Home Verzeichnis benutzt werden soll. Zum Beispiel:

     • Auf Windows:

       crowd.home=c:/data/crowd-home

       Hinweis: Verwenden Sie auf Windows die Frontslashes und nicht die Backslashes, so wie oben gezeigt. 

     • Auf Mac und Unix-basierten Systemen:

       crowd.home=/var/crowd-home

       Wichtig!

       Stellen Sie bitte sicher, dass das Crowd Home Verzeichnis nicht denselben Namen wie das Crowd Installationsverzeichnis hat und dass es für den Benutzer, der das Initialisierungsskript ausführt beschreibbar ist.

   • Speichern Sie die crowd-init.properties Datei. 

     Verwenden Sie dasselbe Crowd Home Verzeichnis, das Sie in Ihrer vorherigen Crowd-Installation benutzt haben.

     Stellen Sie sicher, dass Ihre neue Crowd-Installation auf Ihr existierendes Crowd Home Verzeichnis weist, damit die neue Crowd-Installation Ihre existierende Konfiguration nutzen kann.

4. Kopieren Sie die folgenden Dateien, die im 2. Schritt oben gespeichert wurden, in Ihre neue Crowd-Installation:
   
   • Wenn Ihre existierende Crowd-Installation die Version 1.3.x oder 1.4.x ist: Kopieren Sie die crowd.properties Datei für die Crowd Administrationskonsole zum Root Ihres Crowd Home Verzeichnisses. 
      Ab Crowd 1.5 ist die crowd.properties Datei im Home Verzeichnis und nicht im Installationsverzeichnis. Dieser Schritt ist also nicht erforderlich, wenn Ihre aktuelle Crowd-Installation die Version 1.5 oder neuer ist. 
   • Kopieren Sie die crowd.properties Datei für die CrowdID-Anwendung in Ihr neues {CROWD_INSTALL}/crowd-openidserver-webapp/WEBINF/classes Verzeichnis. 
   • Kopieren Sie Ihren Crowd JDBC Treiber, wenn Sie Crowd mit einer Datenbank konfiguriert haben. 
   • Wenn Sie Crowd als WAR-Distribution installiert haben, kopieren Sie Ihre benutzerdefinierten Konfigurationsdateien. 

4. Schritt: Aktualisieren Sie Ihre integrierten Applikationen

1. Wenn Sie Crowd auf einem neuen Server installiert haben, Crowds URL oder Portnummer geändert haben, dann müssen Sie Crowds Base-URL in den allgemeinen Einstellungen des Admin-Menüs aktualisieren.
2. Wenn Sie CrowdID mit einer externen Datenbank verwenden, müssen Sie eine manuelle JNDI-Datenquellen-Konfigurationsmethode benutzen, um eine externe Datenbankverbindung zu konfigurieren.
3. Wenn Sie CrowdID mit der Standard HSQL-Datenbank verwenden, kopieren Sie das database/ Verzeichnis aus Ihrem alten Installationsverzeichnis in Ihr neues Installationsverzeichnis. Bitte beachten Sie, dass die HSQL-Datenbank nicht zu produktiven Umgebungen passt. Die Verbindung von CrowdID mit einer Datenbank beschreibt die Migration zu einer Unternehmensdatenbank.

5. Schritt: Starten Sie Crowd

1. Führen Sie das Start-up-Skript aus, das sich in Ihrem {CROWD_INSTALL} Verzeichnis befindet:
   
   • Die start_crowd.bat für Windows.
   • Die start_crowd.sh für Mac und Unix-basierte Systeme.
2. Öffnen Sie http://localhost:8095/crowd in Ihrem Browser. Nun sollten Sie in der Lage sein die Crowd Administrationskonsole zu verwenden.

Problembehandlung

Wenn Sie während des Upgrades irgendwelche Probleme haben sollten, dann legen Sie bitte unter https://support.atlassian.com/ eine Support-Anfrage an und hängen Sie Ihre atlassian-crowd.log Datei an, sodass Atlassian Ihnen bei der Problembehandlung helfen kann.