Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

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

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

Tuttavia, puoi convertire una versione del portale basata su tar in un'istanza del portale basata su RPM 4.18.05. Nell'ambito di questo processo, esegui la migrazione del MySQL/MariaDB del portale esistente a un database Postgres. Una volta convertito, il portale rimane un portale basato su RPM.

Puoi eseguire la migrazione di molte versioni precedenti del portale basato su tar a un portale basato su RPM, incluse le versioni 4.16.09 e 4.17.01, non solo la versione 4.17.05. L'unico requisito è che il portale esegua Drupal 7 o versioni successive. Per controllare la versione di Drupal, seleziona Reports > Status Reports (Report > Report sullo stato) nel menu di Drupal. La versione di Drupal viene visualizzata nella prima riga dell'output.

I passaggi di alto livello per eseguire la migrazione da un portale basato su tar a un portale basato su 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 su RPM.
Esegui la migrazione del database del portale dal portale basato su tar.
Copia tutti i file accessori dal portale basato su tar al portale basato su RPM.
Aggiorna le voci DNS in modo che rimandino al nuovo portale basato su 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 Imposta la porta HTTP utilizzata dal portale per informazioni sull'utilizzo di una porta diversa.

Nuova directory di installazione predefinita dopo la conversione

Dopo l'aggiornamento di un'installazione che ora utilizza NGINX/Postgres, la directory root è cambiata da:

/opt/apigee/apigee-drupal

/opt/apigee/apigee-drupal/wwwroot

Procedura di conversione del portale

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

Installa la versione 4.18.05 del portale basata su RPM su un nodo diverso da quello del portale basato su tar.
Sul portale basato su RPM, crea un nuovo database Postgres. In un secondo momento, eseguirai 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 password Postgres definita dalla proprietà PG_PWD nel file di configurazione del portale.
2. Crea un nuovo database Postgres:
```
CREATE DATABASE newportaldb;
```
3. Esci da psql:
```
\q
```

Sul portale basato su tar, rimuovi i vecchi moduli 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';"

Sul portale basato su tar, installa e configura il modulo Migrator Drupal:

```
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

Accedi al portale come amministratore.
Seleziona Moduli nel menu di Drupal.
Attiva il modulo DBTNG Migrator.
Salva la configurazione.

Sul portale basato su tar, modifica /var/www/html/sites/default/settings.php per aggiungere una seconda configurazione del database che punti al database appena creato sul portale basato su RPM. La configurazione attuale del database è denominata "default". Assegna alla nuova configurazione il nome "custom", come mostrato 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.

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
```
Sul portale basato su tar, esegui la migrazione del database del portale al portale basato su RPM:
1. Accedi al portale come amministratore.
2. Seleziona Structure->Migrator (Struttura->Migratore) nel menu di Drupal.
3. Scegli il database di origine nel portale basato su tar, default, e il database di destinazione, custom, in base al file settings.php mostrato sopra.
4. Fai clic su Esegui la migrazione. Viene eseguita la migrazione del database basato su tar al database basato su RPM.

Copia la directory sites dal server basato su tar al server basato su RPM. I percorsi mostrati nei passaggi seguenti si basano su percorsi predefiniti. Modificale in base alle esigenze della tua installazione.

Nel portale basato su tar, raggruppa la directory /var/www/html/sites:
```
cd /var/www/html/sites
tar -cvzf /tmp/sites.tar.gz .
```
Copia /tmp/sites.tar.gz in /opt/apigee/apigee-drupal/wwwroot/sites sul server basato su RPM.

Scompatta la directory dei siti, ma non sovrascrivere i file importanti.

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

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

Esegui il backup della directory sites esistente:

tar -cvzf /tmp/sites_old.tar.gz /opt/apigee/apigee-drupal/wwwroot/sites

Decomprimi ed estrai 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

Assicurati che i file copiati abbiano la proprietà corretta:

chown -R apigee:apigee /opt/apigee/apigee-drupal/wwwroot/sites/

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

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

Sul portale basato su tar, solo se hai modificato il percorso della directory principale web sul portale basato su tar dal percorso predefinito di /var/www/html: esegui drush status e controlla il percorso files e il percorso private files:
```
cd /var/www/html
drush status
```
Se i file/file privati non si trovano nella directory sites, copiali nel server basato su RPM come mostrato sopra.
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 predefinito 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 come definiti per il database personalizzato sul portale basato su tar e prefix è vuoto.
Nel portale basato su RPM, la versione del portale basata su RPM contiene meno moduli Drupal rispetto alla versione basata su tar. Dopo la migrazione al portale basato su RPM, devi verificare la presenza di eventuali moduli mancanti e installarli, se necessario.
1. Installa il modulo 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 su RPM come amministratore.
3. Seleziona Reports > Status reports (Report > Report sullo stato) nel menu di Drupal e verifica se mancano moduli.
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, visita la pagina https://www.drupal.org/node/244924.
Sul portale basato su RPM, esegui update.php in un browser per rimuovere eventuali errori relativi ai moduli mancanti:
1. Accedi al portale basato su 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.
Aggiorna le voci DNS in modo che puntino al nuovo portale basato su 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 Imposta la porta HTTP utilizzata dal portale.

La conversione è stata completata.

Quando i contenuti del file settings.php per un nuovo portale basato su RPM sono diversi da quelli di un portale basato su tar, devi aggiornare il file

/opt/apigee/apigee-drupal-devportal-opdk_version/source/conf/settings.php

con i nuovi contenuti per evitare che vengano ripristinate le impostazioni precedenti.