TAR-basiertes Portal in ein RPM-basiertes Portal umwandeln

Edge for Private Cloud v4.19.01

Mit der Version 4.18.05 des Apigee Developer Services-Portals (oder einfach des Portals) können Sie keine vorherige Version des TAR-basierte Version des Portals. Sie können nur eine RPM-basierte Version des Portals direkt aktualisieren. bis zum 18. April 2005.

Sie können jedoch eine TAR-basierte Version des Portals in eine 4.18.05 RPM-basierte Instanz von zum Portal. Im Rahmen dieses Prozesses migrieren Sie die MySQL/MariaDB des vorhandenen Portals zu einem Postgres-Datenbank. Nach der Konvertierung bleibt Ihr Portal ein RPM-basiertes Portal.

Sie können viele frühere Versionen des TAR-basierten Portals zu einem RPM-basierten Portal migrieren. einschließlich der Versionen 4.16.09 und 4.17.01, nicht nur Version 4.17.05. Die einzige Voraussetzung ist, dass Das Portal führt Drupal 7 oder höher aus. Um Ihre Drupal-Version zu überprüfen, wählen Sie Berichte > Statusberichte. Die Version von Drupal erscheint in der ersten Zeile. der Ausgabe.

Die übergeordneten Schritte, mit denen Sie von einem TAR-basierten Portal zu einem RPM-basierten Portal migrieren sind:

  • Installieren Sie die RPM-basierte Version 4.18.05 des Portals auf einem neuen Knoten.
  • Erstellen Sie eine neue Postgres-Datenbank im RPM-basierten Portal.
  • Migrieren Sie die Portaldatenbank aus dem TAR-basierten Portal.
  • Kopieren Sie die gesamte Zubehördatei aus dem TAR-basierten Portal in das RPM-basierte Portal.
  • Aktualisieren Sie die DNS-Einträge so, dass sie auf das neue RPM-basierte Portal verweisen.

    Beachten Sie, dass die RPM-basierte Version des Portals standardmäßig Port 8079 verwendet, während die TAR-basierte Version verwendet Port 80. Achten Sie darauf, dass Sie in Ihrem DNS-Eintrag die richtige Portnummer verwenden. Weitere Informationen finden Sie unter Legen Sie den vom Portal verwendeten HTTP-Port fest, um weitere Informationen zu erhalten. zur Verwendung eines anderen Ports.

Neues Standardinstallationsverzeichnis nach dem Conversion

Nach der Aktualisierung einer Installation, die jetzt Nginx/Postgres verwendet, wurde das Stammverzeichnis geändert von:

/opt/apigee/apigee-drupal

in

/opt/apigee/apigee-drupal/wwwroot

Verfahren für die Portal-Konvertierung

So konvertieren Sie das Portal in eine RPM-basierte Installation:

  1. Installieren Sie die RPM-basierte Version 4.18.05 des Portals auf einem anderen Knoten als Ihrem TAR-basierten Knoten.
  2. Erstellen Sie im RPM-basierten Portal eine neue Postgres-Datenbank. Später migrieren Sie aus der Datenbank vom TAR-basierten Portal in diese neue Datenbank übertragen: <ph type="x-smartling-placeholder">
      </ph>
    1. Melden Sie sich bei psql an:
      psql -h localhost -p 5432 -U apigee

      Geben Sie Ihr Postgres-Passwort gemäß der Eigenschaft PG_PWD in der Portalkonfiguration ein -Datei.

    2. Erstellen Sie eine neue Postgred-Datenbank:
      CREATE DATABASE newportaldb;
    3. Beenden Sie psql:
      \q
  3. Entfernen Sie im tar-basierten Portal alte Module, die nicht mehr verwendet werden:

    cd /var/www/html
    drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_account' AND type = 'module';"
    drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_checklist' AND type = 'module';"
    drush sql-query --db-prefix "DELETE from {system} where name = 'apigee_sso_ui' AND type = 'module';"

  4. Installieren und konfigurieren Sie das Migrator Drupal-Modul im tar-basierten Portal: <ph type="x-smartling-placeholder">
      </ph>
    1. cd /tmp 
    2. wget https://ftp.drupal.org/files/projects/dbtng_migrator-7.x-1.4.tar.gz 
    3. gunzip /tmp/dbtng_migrator-7.x-1.4.tar.gz 
    4. tar -xvf /tmp/dbtng_migrator-7.x-1.4.tar --directory /var/www/html/sites/all/modules 
    5. Melden Sie sich im Portal als Administrator an.
    6. Wählen Sie Modules im Drupal-Menü aus.
    7. Aktivieren Sie das Modul DBTNG Migrator.
    8. Speichern Sie die Konfiguration.
  5. Bearbeiten Sie im tar-basierten Portal /var/www/html/sites/default/settings.php. eine zweite Datenbankkonfiguration hinzuzufügen, die auf die neu erstellte Datenbank Die aktuelle Datenbankkonfiguration heißt „default“. Neue Konfiguration benennen „custom“, wie im folgenden Beispiel gezeigt:
    $databases = array (
      'default' =>
      array (
        'default' =>
        array (
          'database' => 'devportal',
          'username' => 'devportal',
          'password' => 'devportal',
          'host' => 'localhost',
          'port' => '',
          'driver' => 'mysql',
          'prefix' => '',
        ),
      ),
      'custom' =>
      array (
        'default' =>
        array (
          'database' => 'newportaldb',
          'username' => 'apigee',
          'password' => 'postgres',
          'host' => '192.168.168.100',
          'port' => '5432',
          'driver' => 'pgsql',
          'prefix' => '',
        )
      )
    );

    Dabei geben host und port die IP-Adresse und den Port der Postgres-Server. Postgres verwendet Port 5432 für Verbindungen.

  6. Installieren Sie im tar-basierten Portal den Postgres-Treiber: <ph type="x-smartling-placeholder">
      </ph>
    1. Verwenden Sie Yum, um den Treiber zu installieren:
      yum install php-pdo_pgsql
    2. Bearbeiten Sie /etc/php.ini und fügen Sie an einer beliebigen Stelle in der Datei die folgende Zeile ein:
      extension=pgsql.so
    3. Starten Sie Apache neu:
      service httpd restart
  7. Migrieren Sie die Portaldatenbank im TAR-basierten Portal zum RPM-basierten Portal. Portal: <ph type="x-smartling-placeholder">
      </ph>
    1. Melden Sie sich im Portal als Administrator an.
    2. Wählen Sie im Drupal-Menü Structure->Migrator (Struktur->Migrator) aus.
    3. Wählen Sie Ihre Ursprungsdatenbank im TAR-basierten Portal default und die Zieldatenbank, custom, basierend auf der angezeigten settings.php-Datei oben.
    4. Klicken Sie auf Migrieren. Die TAR-basierte Datenbank wird zur RPM-basierten Datenbank migriert. Datenbank.
  8. Kopieren Sie das Verzeichnis sites vom tar-basierten Server auf den RPM-basierten Server. Die Die in den folgenden Schritten gezeigten Pfade basieren auf Standardpfaden. Ändern Sie sie nach Bedarf, für Ihre Installation.
    1. Bündeln Sie im TAR-basierten Portal das Verzeichnis /var/www/html/sites:
      cd /var/www/html/sites
      tar -cvzf /tmp/sites.tar.gz .
    2. /tmp/sites.tar.gz kopieren nach /opt/apigee/apigee-drupal/wwwroot/sites auf dem RPM-basierten Server.
    3. Entbündeln Sie das Websiteverzeichnis, überschreiben Sie jedoch keine wichtigen Dateien.
      1. Sichern Sie die Datei settings.php:
        sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
          /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
      2. Sichern Sie das vorhandene Verzeichnis files:
        sudo mv /opt/apigee/apigee-drupal/wwwroot/sites/default/files
          /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old
      3. Sichern Sie das vorhandene Verzeichnis sites:
        tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites
      4. Entpacken Sie das Verzeichnis sites auf dem TAR-basierten Server und entpacken Sie es:
        gunzip /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar.gz
        tar -xvf /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar
      5. Prüfen Sie, ob die kopierten Dateien die richtigen Eigentümerschaft haben:
        chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/
      6. Stellen Sie die Datei settings.php wieder her:
        sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
          /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
      7. So verschieben Sie private Dateien an einen neuen Speicherort:
        cp -r /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private/* /opt/apigee/data/apigee-drupal-devportal/private
        rm -rf /opt/apigee/apigee-drupal/wwwroot/sites/default/files/private
        chown -R apigee:apigee /opt/apigee/data/apigee-sap-drupal-devportal/private
  9. Im TAR-basierten Portal nur, wenn Sie den Pfad zum Webstammverzeichnis geändert haben im TAR-basierten Portal aus dem Standardpfad /var/www/html: run drush status und sehen Sie sich den Pfad files und private files an:
    cd /var/www/html
    drush status

    Wenn sich Dateien bzw. private Dateien nicht im Verzeichnis sites befinden, kopieren Sie sie in das RPM-basierten Server wie oben gezeigt.

  10. Aktualisiere im RPM-basierten Portal /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php zum Festlegen der Attribute der Standarddatenbank:
    vi /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php

    Legen Sie die Standarddatenbankbeschreibung in settings.php fest:

    $databases = array (
      'default' =>
      array (
        'default' =>
        array (
          'database' => 'newportaldb',
          'username' => 'apigee',
          'password' => 'postgres',
          'host' => 'localhost', 'port' => '5432',
          'driver' => 'pgsql',
          'prefix' => '',
        )
      )
    );

    Dabei gibt database die neu erstellte Datenbank an, username und password sind für die benutzerdefinierte Datenbank definiert im tar-basierten Portal und prefix ist leer.

  11. Auf dem RPM-basierten Portal enthält die RPM-basierte Version des Portals weniger Drupal-Module als die TAR-basierte Version. Nach der Migration zum RPM-basierten Portal muss nach fehlenden Modulen suchen und diese bei Bedarf installieren.
    1. Installiere das missing_module-Objekt von Drupal, das zum Erkennen fehlender Module verwendet wird:
      cd /opt/apigee/apigee-drupal/wwwroot
      drush dl missing_module
      drush en missing_module
    2. Melde dich im RPM-basierten Portal als Administrator an.
    3. Wählen Sie Berichte > Statusberichte aus und suchen Sie nach fehlende Module.
    4. Verwenden Sie diesen Bericht, um fehlende Module zu installieren, oder verwenden Sie die folgenden Befehle:
      cd /opt/apigee/apigee-drupal/wwwroot
      drush dl <moduleA> <moduleB> ...
      drush en <moduleA> <moduleB> ...
    5. Nachdem Sie alle Module aktiviert haben, prüfen Sie, ob die Dateien dem Apigee-Benutzer gehören:
      chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot

      Weitere Informationen zu Dateiberechtigungen finden Sie unter https://www.drupal.org/node/244924.

  12. Führen Sie im RPM-basierten Portal update.php in einem Browser aus, um Fehler zu entfernen. zu fehlenden Modulen: <ph type="x-smartling-placeholder">
      </ph>
    1. Melde dich im RPM-basierten Portal als Administrator an.
    2. Rufen Sie im Browser die folgende URL auf:
      http://portal_IP_or_DNS:8079/update.php

      Dabei ist portal_IP_or_DNS die IP-Adresse oder der Domainname des RPM-basierten

    3. Folgen Sie der Anleitung auf dem Bildschirm.
  13. Aktualisieren Sie die DNS-Einträge so, dass sie auf Ihr neues RPM-basiertes Portal verweisen.

    Beachten Sie, dass die RPM-basierte Version des Portals standardmäßig Port 8079 verwendet, während die TAR-basierte Version verwendet Port 80. Achten Sie darauf, dass Sie in Ihrem DNS-Eintrag die richtige Portnummer verwenden. Weitere Informationen finden Sie unter Legen Sie den vom Portal verwendeten HTTP-Port fest, um Informationen zu erhalten. wenn Sie einen anderen Port verwenden.

Die Konvertierung ist abgeschlossen.