Convertire un portale basato su tar in un portale basato sull'RPM

La release 4.18.05 del portale Servizi per sviluppatori Apigee (o semplicemente il portale) non consente di aggiornare una versione precedente basata sul tar del portale. Puoi aggiornare direttamente una versione del portale basata su RPM solo alla versione 4.18.05.

Tuttavia, puoi convertire una versione del portale basata su tar dell'istanza di un portale in base all'RPM (4.18.05). Nell'ambito di questo processo, esegui la migrazione di MySQL/MariaDB del portale esistente a un database Postgres. Dopo la conversione, il portale rimane basato su RPM.

Puoi eseguire la migrazione di molte versioni precedenti del portale basato su tar a un portale basato sull'RPM, incluse le versioni 4.16.09 e 4.17.01, non solo la versione 4.17.05. Gli unici requisiti sono che il portale esegue Drupal 7 o versioni successive. Per controllare la versione di Drupal, seleziona Report > Report di stato nel menu Drupal. La versione di Drupal viene visualizzata nella prima riga dell'output.

I passaggi di alto livello che utilizzi per eseguire la migrazione da un portale basato su tar a un portale basato sull'RPM sono:

  • Installa la versione 4.18.05 basata su RPM del portale su un nuovo nodo.
  • Crea un nuovo database Postgres sul portale basato sull'RPM.
  • Esegui la migrazione del database del portale dal portale basato su tar.
  • Copia tutto il file degli accessori dal portale basato su tar nel portale basato sull'RPM.
  • Aggiorna le voci DNS per indirizzare al nuovo portale basato sull'RPM.

    Tieni presente che la versione del portale basata su RPM utilizza la porta 8079 per impostazione predefinita, mentre la versione basata su tar utilizza la porta 80. Assicurati di utilizzare il numero di porta corretto nella voce DNS. Per informazioni sull'utilizzo di una porta diversa, consulta la pagina Impostare la porta HTTP utilizzata dal portale.

Nuova directory di installazione predefinita dopo la conversione

Dopo aver aggiornato un'installazione che ora utilizza NGINX/Postgres, la directory principale ha subito il seguente cambiamento:

/opt/apigee/apigee-drupal

a:

/opt/apigee/apigee-drupal/wwwroot

Procedura di conversione dei portali

Per convertire il portale in un'installazione basata su RPM:

  1. Installa la versione 4.18.05 del portale basata su RPM su un nodo diverso da quello basato su tar.
  2. Sul portale basato sull'RPM, crea un nuovo database Postgres. Successivamente, esegui la migrazione del database dal portale basato su tar a questo nuovo database:
    1. Accedi a psql:
      psql -h localhost -p 5432 -U apigee

      Inserisci la tua password Postgres come definito dalla proprietà PG_PWD nel file di configurazione del portale.

    2. Crea un nuovo database POSTGRED:
      CREATE DATABASE newportaldb;
    3. Esci da psql:
      \q
  3. Nel portale basato su tar, rimuovi i moduli precedenti che non vengono più utilizzati:

    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. Nel portale basato su tar, installa e configura il modulo Migrator Drupal:
    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. Accedi al portale come amministratore.
    6. Seleziona Moduli nel menu Drupal.
    7. Abilita il modulo DBTNG Migrator.
    8. Salva la configurazione.
  5. Nel portale basato su tar, modifica /var/www/html/sites/default/settings.php per aggiungere una seconda configurazione di database che punta al database appena creato sul portale basato sull'RPM. La configurazione attuale del database è denominata "default". Assegna alla nuova configurazione il nome "custom", come illustrato nell'esempio seguente:
    $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' => '',
        )
      )
    );

    Dove host e port specificano l'indirizzo IP e la porta del server Postgres. Postgres utilizza la porta 5432 per le connessioni.

  6. Sul portale basato su tar, installa il driver Postgres:
    1. Utilizza Yum per installare il driver:
      yum install php-pdo_pgsql
    2. Modifica /etc/php.ini per aggiungere la seguente riga in un punto qualsiasi del file:
      extension=pgsql.so
    3. Riavvia Apache:
      service httpd restart
  7. Nel portale basato su tar, esegui la migrazione del database al portale basato su RPM:
    1. Accedi al portale come amministratore.
    2. Seleziona Struttura->Migratore nel menu Drupal.
    3. Scegli il tuo database di origine sul portale basato su tar, default, e il database di destinazione, custom, in base al file settings.php mostrato sopra.
    4. Fai clic su Esegui migrazione. Viene eseguita la migrazione del database basato su tar al database basato su RPM.
  8. Copia la directory sites dal server basato su tar al server basato su RPM. I percorsi visualizzati nei passaggi seguenti si basano su percorsi predefiniti. Modificali in base alle tue esigenze per l'installazione.
    1. Nel portale basato su tar, raggruppa la directory /var/www/html/sites:
      cd /var/www/html/sites
      tar -cvzf /tmp/sites.tar.gz .
    2. Copia /tmp/sites.tar.gz in /opt/apigee/apigee-drupal/wwwroot/sites sul server basato su RPM.
    3. Separare la directory dei siti, ma non sovrascrivere i file importanti.
      1. Esegui il backup del file settings.php:
        sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
          /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
      2. Esegui il backup della directory files esistente:
        sudo mv /opt/apigee/apigee-drupal/wwwroot/sites/default/files
          /opt/apigee/apigee-drupal/wwwroot/sites/default/files_old
      3. Esegui il backup della directory sites esistente:
        tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites
      4. Decomprimi e disinstalla la directory sites dal server basato su tar:
        gunzip /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar.gz
        tar -xvf /opt/apigee/apigee-drupal/wwwroot/sites/sites.tar
      5. Assicurati che i file copiati siano dei proprietari appropriati:
        chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/
      6. Ripristina il file settings.php:
        sudo cp /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.bak.php
          /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php
      7. Sposta i file privati in una nuova posizione:
        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. Nel portale basato su tar, solo se hai modificato il percorso della directory principale web sul portale basato su tar rispetto al percorso predefinito di /var/www/html: esegui drush status e osserva il percorso files e il percorso private files:
    cd /var/www/html
    drush status

    Se i file o i file privati non si trovano nella directory sites, copiali sul server basato su RPM come mostrato sopra.

  10. Nel portale basato su RPM, aggiorna /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php per impostare le proprietà del database predefinito:
    vi /opt/apigee/apigee-drupal/wwwroot/sites/default/settings.php

    Imposta la descrizione del database predefinita in settings.php:

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

    Dove database specifica il nuovo database che hai creato, username e password sono quelli definiti per il database personalizzato sul portale basato su tar e prefix è vuoto.

  11. Nel portale basato sull'RPM, la versione del portale contiene meno moduli Drupal rispetto alla versione basata su tar. Dopo aver eseguito la migrazione al portale basato sull'RPM, devi verificare la presenza di eventuali moduli mancanti e installarli, se necessario.
    1. Installa il Drupal missing_module utilizzato per rilevare i moduli mancanti:
      cd /opt/apigee/apigee-drupal/wwwroot
      drush dl missing_module
      drush en missing_module
    2. Accedi al portale basato sull'RPM come amministratore.
    3. Seleziona Report > Report di stato nel menu Drupal e controlla se ci sono eventuali moduli mancanti.
    4. Utilizza questo report per installare i moduli mancanti o utilizza i seguenti comandi:
      cd /opt/apigee/apigee-drupal/wwwroot
      drush dl <moduleA> <moduleB> ...
      drush en <moduleA> <moduleB> ...
    5. Dopo aver abilitato tutti i moduli, assicurati che i file siano di proprietà dell'utente Apigee:
      chown -LR apigee:apigee /opt/apigee/apigee-drupal/wwwroot

      Per ulteriori informazioni sulle autorizzazioni dei file, consulta https://www.drupal.org/node/244924.

  12. Sul portale basato su RPM, esegui update.php in un browser per rimuovere eventuali errori nei moduli mancanti:
    1. Accedi al portale basato sull'RPM come amministratore.
    2. Nel browser, vai al seguente URL:
      http://portal_IP_or_DNS:8079/update.php

      Dove portal_IP_or_DNS è l'indirizzo IP o il nome di dominio del portale basato su RPM.

    3. Segui le istruzioni sullo schermo.
  13. Aggiorna le voci DNS in modo che rimandino al nuovo portale basato sull'RPM.

    Tieni presente che la versione del portale basata su RPM utilizza la porta 8079 per impostazione predefinita, mentre la versione basata su tar utilizza la porta 80. Assicurati di utilizzare il numero di porta corretto nella voce DNS. Consulta Impostare la porta HTTP utilizzata dal portale per informazioni su come utilizzare una porta diversa.

La conversione è stata completata.