Upgrade für das Portal für Entwicklerdienste ausführen

Developer Services Portal Version 4.16.09

In diesem Verfahren wird beschrieben, wie Sie eine vorhandene On-Premise-Installation von Apigee Developer Channel Services aktualisieren.

Standardinstallationsverzeichnis

Beim Upgradeprozess wird davon ausgegangen, dass das Entwicklerportal unter /var/www/html installiert ist. 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 Gängige Drush-Befehle beschrieben ermitteln.

Unterstützte Upgrade-Versionen

Dieses Upgrade-Verfahren wird für die folgenden Portalversionen 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

Um Ihre Portalversion zu ermitteln, öffnen Sie die folgende URL in einem Browser:

http://yourportal.com/buildInfo

Vor dem Installieren

Bei bestehenden Installationen werden Ihre Änderungen überschrieben, wenn Sie Code im Drupal-Kern oder in nicht benutzerdefinierten Modulen geändert haben. Dazu gehören unter anderem alle Änderungen, die Sie möglicherweise an .htaccess vorgenommen haben. Angenommen werden sollte, dass alles außerhalb des Verzeichnisses /sites zu Drupal gehört. Eine Ausnahme von dieser Regel ist robots.txt. Wenn diese Datei im Stammverzeichnis des Webservers vorhanden ist, wird sie beibehalten.

Bevor Sie mit der Installation fortfahren, sollten Sie ein Back-up des gesamten Drupal-Web-Stammverzeichnisses erstellen. Der Standardinstallationsort ist /var/www/html. Möglicherweise haben Sie ihn aber bei der Installation geändert. Nachdem Sie die unten beschriebenen Installationsschritte ausgeführt haben, können Sie Ihre Anpassungen aus der Sicherung wiederherstellen.

Apigee Developer Channel-Dienste auf eine neue Version aktualisieren

  1. Sicherung Ihrer Drupal-MySQL-Instanz.
    Weitere Informationen finden Sie unter http://www.thegeekstuff.com/2008/09/backup-and-restore-mysql-database-using-mysqldump/
    1. Option 1: Drush verwenden

      Mit dem Drush-Befehl sql-dump wird eine Kopie der Datenbank erstellt. Führen Sie im Drupal-Verzeichnis (standardmäßig /var/www/html) den Befehl aus:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Weitere Informationen finden Sie unter drush help sql-dump.
    2. Option 2: MySQLdump verwenden
      Mit dem Befehl mysqldump können Sie eine Kopie der Datenbank erstellen:
      mysqldump -u NUTZERNAME -p'PASSWORT' DATEBASENAME > /path/to/backup_dir/database-backup.sql

      Zwischen der Option -p und dem Passwort darf kein Leerzeichen stehen. Wenn das Passwort Sonderzeichen enthält, müssen einfache Anführungszeichen verwendet werden.

      Sie haben USERNAME und DATABASENAME bei der Installation des Portals festgelegt. Standardmäßig ist das devportal für beide festgelegt.
  2. Erstellen Sie eine Sicherung des gesamten Drupal-Stammverzeichnisses. Der Standardspeicherort ist /var/www/html, aber möglicherweise haben Sie ihn bei der Installation geändert.
  3. Lade die Datei DeveloperServices_x.y.z.tar herunter, wobei x.y.z der Portalversion entspricht.

    Sie können eine Datei über den Link herunterladen, den Sie von Apigee erhalten haben, oder ihn 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 Entwicklerkanaldienste anzufordern. Wenn Sie noch kein Konto im Supportportal haben, wählen Sie Im Supportportal anmelden und dann auf der Anmeldeseite Eilt es? Hier können Sie ein Support-Ticket erstellen.
  4. Upgrade auf einem Server mit Internetverbindung:
    1. Extrahieren Sie die Portal-Upgradedatei:
      > tar -xvf <tar file>

      Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie zum Verzeichnis DeveloperServices-4.x.y.z.
    3. 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.
    4. Führen Sie das Script networked-update.sh aus:
      > ./networked-update.sh

      Je nach Dateiberechtigungen müssen Sie diesen Befehl möglicherweise mit sudo oder als Administrator ausführen.
    5. Damit Sie Benachrichtigungen zu Drupal-Updates erhalten, muss das Modul „Drupal Update Manager“ aktiviert sein. Wählen Sie im Drupal-Menü Module aus und scrollen Sie nach unten zum Modul Update Manager. Aktivieren Sie sie, falls sie deaktiviert ist.

      Nach der Aktivierung können Sie die verfügbaren Updates über das Menü Berichte > Verfügbare Updates aufrufen.

      Über das Menü Berichte > Verfügbare Updates > 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.
  5. Upgrade auf einem Server ohne Internetverbindung:
    1. Extrahieren Sie auf dem Server, auf dem Sie die Datei DeveloperServices_x.y.z.tar für die Entwicklerkanaldienste heruntergeladen haben, die Portal-Upgradedatei:
      > tar -xvf <tar file>

      Mit diesem Befehl wird ein neues Verzeichnis mit dem Namen DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie zum Verzeichnis DeveloperServices-4.x.y.z.
    3. Führen Sie das Script 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, in einer einzigen Datei namens devportal-update.tgz verpackt und an einem von Ihnen ausgewählten Speicherort gespeichert.
    4. Kopieren Sie devportal-update.tgz auf den Zielserver, auf dem das Portal ausgeführt wird.
      Hinweis: Kopieren Sie devportal-update.tgz nicht in das Web-Stammverzeichnis des Zielservers.
    5. Entpacken Sie die Datei devportal-update.tgz im aktuellen Verzeichnis:
      > tar -xzf /path/to/devportal-update.tgz
    6. Wechseln Sie zum Verzeichnis developer-update.
    7. Führen Sie den folgenden Befehl aus, um das Update zu installieren:
      > ./install-update.sh
    8. Folgen Sie der Anleitung.

Die Umstellung ist jetzt abgeschlossen.