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

Entwicklerdienstportal Version 4.16.05

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-024.216
  • pantheon-4.24.246
  • 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

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

http://yourportal.com/buildInfo

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 Datei DeveloperServices_x.y.z.tar für Entwicklerkanaldienste herunter, wobei x.y.z der Versionsnummer des Portals entspricht.

    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.