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

Entwicklerdienstportal Version 4.17.01

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

Standardinstallationsverzeichnis

Beim Upgradeprozess 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 so, dass Ihr Installationsverzeichnis verwendet wird.

Falls Sie das Installationsverzeichnis nicht kennen, können Sie es wie unter Häufig verwendete Drush-Befehle beschrieben ermitteln.

Unterstützte Upgradeversionen

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

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

http://yourportal.com/buildInfo

Vor dem Installieren

Wenn Sie bei vorhandenen Installationen Code im Drupal-Kern oder in einem nicht benutzerdefinierten Modul geändert haben, werden Ihre Änderungen überschrieben. Dazu gehören unter anderem alle Änderungen, die Sie an .htaccess vorgenommen haben. Sie sollten davon ausgehen, dass alle Inhalte außerhalb des Verzeichnisses /sites zu Drupal gehören. Eine Ausnahme von dieser Regel stellt robots.txt dar. Wenn diese Datei im Webstamm vorhanden ist, wird sie für dich beibehalten.

Erstelle eine Sicherung deines gesamten Drupal-Webstammverzeichnisses, bevor du mit der Installation fortfährst. Der standardmäßige Installationspfad ist /var/www/html. Möglicherweise haben Sie ihn aber bereits 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 Services auf einen neuen Release 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

      Der Drush-Befehl sql-dump erstellt eine Kopie der Datenbank. Führen Sie standardmäßig in Ihrem Drupal-Verzeichnis, /var/www/html, folgenden Befehl aus:
      > drush sql-dump > /path/to/backup_dir/database-backup.sql

      Verwenden Sie drush help sql-dump, um weitere Informationen zu erhalten.
    2. Option 2: MySQLdump verwenden
      Erstellen Sie mit dem Befehl mysqldump eine Kopie der Datenbank:
      mysqldump -u NUTZERNAME -p'PASSWORT' DATABASENAME > /path/to/backup_dir/database-backup.sql

      Zwischen der Option -p und dem Passwort darf kein Leerzeichen stehen. Das Passwort muss in einfache Anführungszeichen gesetzt werden, wenn es Sonderzeichen enthält.

      Sie haben den NUTZERNAME und den DATENBASENAME bei der Installation des Portals festgelegt. Standardmäßig sind beide devportal.
  2. Erstellen Sie eine Sicherung Ihres gesamten Drupal-Webstammverzeichnisses. Der Standardinstallationspfad ist /var/www/html, aber Sie haben ihn möglicherweise bei der Installation geändert.
  3. Laden Sie die Developer Channel Services-Datei DeveloperServices_x.y.z.tar von ftp.apigee.com herunter, wobei x.y.z der Versionsnummer des Portals entspricht. Wenn Sie dazu aufgefordert werden, geben Sie 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. Alternativ können Sie sie kopieren und dann dem folgenden cURL-Befehl hinzufügen:
    > curl -kOL <Link hier einfügen>

    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 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 Du hast es eilig? Erstellen Sie hier ein Support-Ticket.
  4. Für ein Upgrade auf einem Server mit einer Internetverbindung:
    1. Extrahieren Sie die Datei für das Portalupgrade:
      > tar -xvf <tar file>

      Mit diesem Befehl wird ein neues Verzeichnis namens DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie zum Verzeichnis DeveloperServices-4.x.y.z.
    3. Laden Sie mit folgendem Befehl die neueste Drupal-Version herunter:
      > drush dl drupal

      Dieser Befehl erstellt ein Verzeichnis namens drupal-x.y, wobei x.y der aktuellen Version von Drupal entspricht.
    4. Führen Sie das Skript networked-update.sh aus:
      > ./networked-update.sh

      Je nach Dateiberechtigungen müssen Sie diesen Befehl entweder mit „sudo“ oder als Administrator ausführen.
    5. Um Benachrichtigungen über Drupal-Updates zu erhalten, muss das Drupal-Update-Manager-Modul aktiviert sein. Wählen Sie im Drupal-Menü Module (Module) aus und scrollen Sie nach unten zum Modul Update Manager (Aktualisierungsmanager). Ist dies nicht der Fall, aktivieren Sie es.

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

      Verwenden Sie das Menü Berichte > Verfügbare Updates > Einstellungen, um das Modul so zu konfigurieren, dass Sie per E-Mail benachrichtigt werden, wenn Updates verfügbar sind, und legen Sie die Häufigkeit der Suche nach Updates fest.
  5. Für ein Upgrade auf einem Server ohne Internetverbindung:
    1. Extrahieren Sie auf dem Server, auf dem Sie die Developer Channel Services-Datei DeveloperServices_x.y.z.tar heruntergeladen haben, die Portalupgrade-Datei:
      > tar -xvf <tar file>

      Mit diesem Extrahierungsbefehl wird ein neues Verzeichnis namens DeveloperServices-4.x.y.z erstellt.
    2. Wechseln Sie zum Verzeichnis DeveloperServices-4.x.y.z.
    3. Führen Sie das Skript non-networked-update.sh aus:
      > ./non-networked-update.sh

      Je nach Dateiberechtigungen müssen Sie diesen Befehl entweder mit „sudo“ oder als Administrator ausführen.

      Mit diesem Befehl werden alle erforderlichen Updatedateien heruntergeladen, in eine einzige Datei namens devportal-update.tgz verpackt und an einen Speicherort Ihrer Wahl geschrieben.
    4. Kopieren Sie devportal-update.tgz auf den Zielserver, auf dem das Portal ausgeführt wird.
      Hinweis: Kopieren Sie nicht die Datei devportal-update.tgz in das Webstammverzeichnis 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. Beantworte die Aufforderungen.

Die Umstellung ist jetzt abgeschlossen.