Mit der Version 4.18.05 des Apigee Developer Services-Portals (oder einfach dem Portal) können Sie keine frühere TAR-basierte Version des Portals aktualisieren. Du kannst nur eine RPM-basierte Version des Portals direkt auf 4.18.05 aktualisieren.
Sie können jedoch eine TAR-basierte Version des Portals in eine RPM-basierte Instanz des Portals 4.18.05 konvertieren. Im Rahmen dieses Prozesses migrieren Sie die MySQL/MariaDB des vorhandenen Portals zu einer Postgres-Datenbank. Nach der Umstellung 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 einzigen Anforderungen sind, dass auf dem Portal Drupal 7 oder höher ausgeführt wird. Um Ihre Drupal-Version zu überprüfen, wählen Sie im Drupal-Menü Berichte > Statusberichte aus. Die Version von Drupal wird in der ersten Zeile der Ausgabe angezeigt.
Die übergeordneten Schritte, die Sie für die Migration von einem tar-basierten Portal zu einem RPM-basierten Portal verwenden, 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 Port 80 verwendet. Achten Sie darauf, in Ihrem DNS-Eintrag die richtige Portnummer zu verwenden. Informationen zur Verwendung eines anderen Ports finden Sie unter Vom Portal verwendeten HTTP-Port festlegen.
Neues Standardinstallationsverzeichnis nach der Konvertierung
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 Portalumwandlung
So konvertieren Sie das Portal in eine RPM-basierte Installation:
- Installieren Sie die RPM-basierte Version 4.18.05 des Portals auf einem anderen Knoten als dem tar-basierten Portal.
- Erstellen Sie im RPM-basierten Portal eine neue Postgres-Datenbank. Später migrieren Sie die Datenbank vom tar-basierten Portal zu dieser neuen Datenbank:
- Melden Sie sich bei psql an:
psql -h localhost -p 5432 -U apigee
Geben Sie Ihr Postgres-Passwort gemäß der Definition in der Eigenschaft PG_PWD in der Portalkonfigurationsdatei ein.
- Erstellen Sie eine neue Postgred-Datenbank:
CREATE DATABASE newportaldb;
- Beenden Sie psql:
\q
- Melden Sie sich bei psql an:
-
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';"
- Installieren und konfigurieren Sie das Migrator Drupal-Modul im tar-basierten Portal:
-
cd /tmp
-
wget https://ftp.drupal.org/files/projects/dbtng_migrator-7.x-1.4.tar.gz
-
gunzip /tmp/dbtng_migrator-7.x-1.4.tar.gz
-
tar -xvf /tmp/dbtng_migrator-7.x-1.4.tar --directory /var/www/html/sites/all/modules
- Melden Sie sich als Administrator im Portal an.
- Wählen Sie im Drupal-Menü die Option Module (Module) aus.
- Aktivieren Sie das Modul DBTNG Migrator.
- Speichern Sie die Konfiguration.
-
- Bearbeiten Sie im tar-basierten Portal
/var/www/html/sites/default/settings.php
und fügen Sie eine zweite Datenbankkonfiguration hinzu, die auf die neu erstellte Datenbank im RPM-basierten Portal verweist. Die aktuelle Datenbankkonfiguration heißt „default“. Nennen Sie die neue Konfiguration wie im folgenden Beispiel „Benutzerdefiniert“:$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
undport
die IP-Adresse und den Port des Postgres-Servers an. Postgres verwendet für Verbindungen Port 5432. -
Installieren Sie im tar-basierten Portal den Postgres-Treiber:
- Installieren Sie den Treiber mit Yum:
yum install php-pdo_pgsql
- Bearbeiten Sie
/etc/php.ini
, um die folgende Zeile an einer beliebigen Stelle in der Datei hinzuzufügen:extension=pgsql.so
- Starten Sie Apache neu:
service httpd restart
- Installieren Sie den Treiber mit Yum:
- Migrieren Sie im tar-basierten Portal die Portaldatenbank zum RPM-basierten Portal:
- Melden Sie sich als Administrator im Portal an.
- Wählen Sie im Drupal-Menü Structure->Migrator (Struktur->Migrator) aus.
- Wählen Sie Ihre Ursprungsdatenbank im tar-basierten Portal
default
und die Zieldatenbankcustom
anhand der oben gezeigtensettings.php
-Datei aus. - Klicken Sie auf Migrieren. Die TAR-basierte Datenbank wird zur RPM-basierten Datenbank migriert.
- Kopieren Sie das Verzeichnis
sites
vom tar-basierten Server auf den RPM-basierten Server. Die in den folgenden Schritten angezeigten Pfade basieren auf Standardpfaden. Passen Sie diese bei Bedarf für Ihre Installation an.- Bündeln Sie im tar-basierten Portal das Verzeichnis
/var/www/html/sites
:cd /var/www/html/sites
tar -cvzf /tmp/sites.tar.gz .
- Kopiere
/tmp/sites.tar.gz
nach/opt/apigee/apigee-drupal/wwwroot/sites
auf dem RPM-basierten Server. - Entfernen Sie das Websiteverzeichnis, aber überschreiben Sie keine wichtigen Dateien.
- 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
- Sichern Sie das vorhandene
files
-Verzeichnis:sudo mv /opt/apigee/apigee-drupal/wwwroot/sites/default/files /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old
- Sichern Sie das vorhandene
sites
-Verzeichnis:tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites
- Entpacken Sie das Verzeichnis
sites
vom 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
- Prüfen Sie, ob die kopierten Dateien die erforderlichen Eigentümerschaft haben:
chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/
- 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
- Private Dateien an einen neuen Speicherort verschieben:
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
- Sichern Sie die Datei
- Bündeln Sie im tar-basierten Portal das Verzeichnis
- Im tar-basierten Portal nur, wenn Sie den Pfad zum Web-Stammverzeichnis des tar-basierten Portals vom Standardpfad /var/www/html geändert haben: Führen Sie
drush status
aus und sehen Sie sich denfiles
- undprivate files
-Pfad an:cd /var/www/html
drush status
Wenn sich Dateien bzw. private Dateien nicht im Verzeichnis
sites
befinden, kopieren Sie sie wie oben gezeigt auf den RPM-basierten Server. - Aktualisieren Sie im RPM-basierten Portal
/opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
, um die Attribute der Standarddatenbank festzulegen: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
undpassword
sind wie für die benutzerdefinierte Datenbank im tar-basierten Portal definiert undprefix
ist leer. - Im 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 müssen Sie nach fehlenden Modulen suchen und diese bei Bedarf installieren.
- Installieren Sie die Drupal-
missing_module
, die zur Erkennung fehlender Module verwendet wird:cd /opt/apigee/apigee-drupal/wwwroot
drush dl missing_module
drush en missing_module
- Melden Sie sich im RPM-basierten Portal als Administrator an.
- Wählen Sie im Drupal-Menü Berichte > Statusberichte aus und suchen Sie nach fehlenden Modulen.
- 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> ...
- Nachdem Sie alle Module aktiviert haben, prüfen Sie, ob die Dateien dem Apigee-Nutzer gehören:
chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot
Weitere Informationen zu Dateiberechtigungen finden Sie unter https://www.drupal.org/node/244924.
- Installieren Sie die Drupal-
- Führen Sie im RPM-basierten Portal in einem Browser update.php aus, um Fehler aufgrund von fehlenden Modulen zu entfernen:
- Melden Sie sich im RPM-basierten Portal als Administrator an.
- Rufe 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 Portals.
- Folgen Sie der Anleitung auf dem Bildschirm.
- 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 Port 80 verwendet. Achten Sie darauf, in Ihrem DNS-Eintrag die richtige Portnummer zu verwenden. Informationen zur Verwendung eines anderen Ports finden Sie unter Vom Portal verwendeten HTTP-Port festlegen.
Die Umwandlung ist abgeschlossen.