Developer Services Portal v. 4.17.01
In diesem Verfahren wird beschrieben, wie Sie eine vorhandene lokale Installation von Apigee Developer Channel Services aktualisieren.
Standardinstallationsverzeichnis
Beim Upgrade wird davon ausgegangen, dass das Entwicklerportal unter /var/www/html installiert wurde. Wenn Sie das Portal nicht im Standardverzeichnis installiert haben, ändern Sie die Pfade im folgenden Verfahren so, dass Ihr Installationsverzeichnis verwendet wird.
Wenn Sie das Installationsverzeichnis nicht kennen, können Sie es wie unter Häufig verwendete Drush-Befehle beschrieben ermitteln.
Unterstützte Upgrade-Versionen
Dieses Upgradeverfahren wird für die folgenden Versionen des Portals unterstützt:
- pantheon-14.02.x
- pantheon-14.03.x
- pantheon-14.04.x
- pantheon-14.07.x
- pantheon-15-01.x
- OPDK-15-04.x
- OPDK-15-07.x
- OPDK-16-01.x
- OPDK-16-05.x
- OPDK-16-09.x
Öffnen Sie die folgende URL in einem Browser, um die Portalversion zu ermitteln:
http://yourportal.com/buildInfo
Vor dem Installieren
Wenn Sie bei vorhandenen Installationen Code im Drupal-Kern oder in nicht benutzerdefinierten Modulen geändert haben, werden Ihre Änderungen überschrieben. Dazu gehören unter anderem alle Änderungen, die du möglicherweise an .htaccess vorgenommen hast. Sie sollten davon ausgehen, dass alles außerhalb des Verzeichnisses /sites Drupal gehört. Eine Ausnahme von dieser Regel ist robots.txt. Wenn diese Datei im Webstammverzeichnis vorhanden ist, wird sie beibehalten.
Erstellen Sie vor der Installation eine Sicherung des gesamten Drupal-Webstammverzeichnisses. Der Standardinstallationsort ist /var/www/html, aber Sie haben ihn möglicherweise bei der Installation geändert. Nachdem Sie die unten beschriebenen Installationsschritte ausgeführt haben, können Sie Ihre Anpassungen aus der Sicherung wiederherstellen.
Upgrade von Apigee Developer Channel Services auf einen neuen Release ausführen
- Sicherung Ihrer Drupal-MySQL-Instanz.
Weitere Informationen finden Sie unter http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/.- Option 1: Drush verwenden
Der Drush-Befehl sql-dump erstellt eine Kopie der Datenbank. Führen Sie im Drupal-Verzeichnis (standardmäßig /var/www/html) den folgenden Befehl aus:
> drush sql-dump > /path/to/backup_dir/database-backup.sql
Weitere Informationen erhalten Sie mit drush help sql-dump. - Option 2: MySQLdump verwenden
Verwenden Sie den Befehl mysqldump, um eine Kopie der Datenbank zu erstellen:
mysqldump -u USERNAME -p'PASSWORD' DATABASENAME > /path/to/backup_dir/database-backup.sql
Zwischen der Option -p und dem Passwort darf kein Leerzeichen stehen. Wenn das Passwort Sonderzeichen enthält, muss es in einfache Anführungszeichen gesetzt werden.
Sie haben den USERNAME und den DATABASENAME bei der Installation des Portals festgelegt. Standardmäßig sind beide devportal.
- Option 1: Drush verwenden
- Erstellen Sie eine Sicherung des gesamten Drupal-Webstammverzeichnisses. Der Standardinstallationsort ist /var/www/html, aber Sie haben ihn möglicherweise bei der Installation geändert.
- Laden Sie die Datei DeveloperServices_x.y.z.tar für die Entwicklerportaldienste von ftp.apigee.com herunter, wobei x.y.z der Versionsnummer des Portals entspricht. Geben Sie bei entsprechender Aufforderung die Anmeldedaten ein, die Sie von Apigee erhalten haben.
Sie können eine Datei über den Link herunterladen, den Sie von Apigee in einem Browser erhalten haben, oder indem Sie sie kopieren und dann dem folgenden cURL-Befehl hinzufügen:
> curl -kOL <paste link here>
Hinweis: Wenn sich Ihr Portal auf einem Server ohne externe Internetverbindung befindet, führen Sie diesen Schritt auf einem Server mit Zugriff aus.
Rufen Sie http://community.apigee.com/content/apigee-customer-support auf und wählen Sie Login to your Support Portal (Im Supportportal anmelden) aus, um die TAR-Datei für das Upgrade der Developer Channel Services anzufordern. Wenn Sie kein Konto im Supportportal haben, wählen Sie Im Supportportal anmelden und dann auf der Anmeldeseite In Eile? Hier können Sie ein Support-Ticket erstellen. -
Für ein Upgrade auf einem Server mit Internetverbindung:
- Extrahieren Sie die Upgrade-Datei für das Portal:
> tar -xvf <tar-Datei>
Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen DeveloperServices-4.x.y.z erstellt. - Wechseln Sie in das Verzeichnis DeveloperServices-4.x.y.z.
- Laden Sie die neueste Drupal-Version mit dem folgenden Befehl herunter:
> drush dl drupal
Mit diesem Befehl wird ein Verzeichnis mit dem Namen „drupal-x.y“ erstellt, wobei „x.y“ der aktuellen Version von Drupal entspricht. - Führen Sie das Skript networked-update.sh aus:
> ./networked-update.sh
Je nach Dateiberechtigungen müssen Sie diesen Befehl möglicherweise mit sudo oder als Administrator ausführen. - Wenn Sie Benachrichtigungen zu Drupal-Updates erhalten möchten, muss das Drupal-Update-Manager-Modul aktiviert sein. Wählen Sie im Drupal-Menü Module aus und scrollen Sie nach unten zum Modul Update Manager. Wenn sie nicht aktiviert ist, aktivieren Sie sie.
Nach der Aktivierung können Sie die verfügbaren Updates über den Menüpunkt Berichte > Verfügbare Updates aufrufen.
Über den Menüpunkt Berichte > Verfügbare Aktualisierungen > Einstellungen können Sie das Modul so konfigurieren, dass Sie per E-Mail benachrichtigt werden, wenn Updates verfügbar sind. Außerdem können Sie festlegen, wie oft nach Updates gesucht werden soll.
- Extrahieren Sie die Upgrade-Datei für das Portal:
-
Für ein Upgrade auf einem Server ohne Internetverbindung:
- Extrahieren Sie auf dem Server, auf dem Sie die Datei DeveloperServices_x.y.z.tar für die Developer Channel Services heruntergeladen haben, die Portal-Upgrade-Datei:
> tar -xvf <tar file>
Durch diesen Befehl wird ein neues Verzeichnis mit dem Namen DeveloperServices-4.x.y.z erstellt. - Wechseln Sie in das Verzeichnis DeveloperServices-4.x.y.z.
- Führen Sie das Skript non-networked-update.sh aus:
> ./non-networked-update.sh
Je nach Dateiberechtigungen müssen Sie diesen Befehl möglicherweise mit sudo oder als Administrator ausführen.
Mit diesem Befehl werden alle erforderlichen Updatedateien heruntergeladen und in einer einzigen Datei mit dem Namen devportal-update.tgz zusammengefasst. Die Datei wird an einem Speicherort Ihrer Wahl gespeichert. - Kopieren Sie devportal-update.tgz auf den Zielserver, auf dem das Portal ausgeführt wird.
Hinweis: Kopieren Sie die Datei devportal-update.tgz nicht in das Webstammverzeichnis des Zielservers. - Entpacken Sie die Datei devportal-update.tgz in das aktuelle Verzeichnis:
> tar -xzf /path/to/devportal-update.tgz - Wechseln Sie in das Verzeichnis developer-update.
- Führen Sie den folgenden Befehl aus, um das Update zu installieren:
> ./install-update.sh - Beantworte die Fragen.
- Extrahieren Sie auf dem Server, auf dem Sie die Datei DeveloperServices_x.y.z.tar für die Developer Channel Services heruntergeladen haben, die Portal-Upgrade-Datei:
Das Upgrade ist jetzt abgeschlossen.