Sauvegarder le portail

Edge for Private Cloud v4.18.05

Cette section explique comment sauvegarder et restaurer une installation sur site du portail des services de développement Apigee (ou simplement le portail) à l'aide des commandes Postgres pg_dump et pg_restore.

Avant de sauvegarder

Avant de pouvoir sauvegarder le portail, vous devez connaître le nom de sa base de données.

La propriété PG_NAME du fichier de configuration de l'installation du portail spécifie le nom de la base de données du portail. L'exemple de fichier de configuration des instructions d'installation du portail utilise le nom "devportal". Si vous n'êtes pas sûr du nom de la base de données, vérifiez le fichier de configuration ou utilisez la commande psql suivante pour afficher la liste des bases de données :

psql -h localhost -d apigee -U postgres -l

Où -U spécifie le nom d'utilisateur Postgres utilisé par le portail pour accéder à la base de données. Il s'agit de la valeur de la propriété DRUPAL_PG_USER dans le fichier de configuration d'installation du portail. Vous serez invité à saisir le mot de passe de la base de données.

Cette commande affiche la liste suivante de bases de données :

    Name     | Owner  | Encoding |   Collate   |    Ctype    |  Access privileges  
-------------+--------+----------+-------------+-------------+---------------------
 apigee      | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =Tc/apigee         +
             |        |          |             |             | apigee=CTc/apigee  +
             |        |          |             |             | postgres=CTc/apigee
 devportal   | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 newportaldb | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 postgres    | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | 
 template0   | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/apigee          +
             |        |          |             |             | apigee=CTc/apigee
 template1   | apigee | UTF8     | en_US.UTF-8 | en_US.UTF-8 | =c/apigee          +
             |        |          |             |             | apigee=CTc/apigee

Sauvegarder le portail

Pour sauvegarder le portail :

  1. Accédez au répertoire Drupal, /opt/apigee/apigee-drupal par défaut :
    cd /opt/apigee/apigee-drupal
  2. Sauvegardez votre instance de base de données Drupal à l'aide de la commande pg_dump :
    pg_dump --dbname=portal_db --host=host_IP_address --username=drupaladmin
      --password --format=c > /tmp/portal.bak

    Où :

    • portal_db est le nom de la base de données. Il s'agit de la propriété PG_NAME dans le fichier de configuration de l'installation du portail. Si vous n'êtes pas sûr du nom de la base de données, consultez Avant de sauvegarder.
    • host_IP_address est l'adresse IP du nœud du portail.
    • drupaladmin est le nom d'utilisateur Postgres utilisé par le portail pour accéder à la base de données. Vous l'avez défini avec la propriété DRUPAL_PG_USER dans le fichier de configuration de l'installation du portail.

    Lorsque pg_dump vous invite à saisir le mot de passe de l'utilisateur Postgres, utilisez le mot de passe que vous avez spécifié avec la propriété DRUPAL_PG_PASS dans le fichier de configuration de l'installation du portail.

    La commande pg_dump crée une copie de la base de données.

  3. Créez une sauvegarde de l'intégralité du répertoire racine Web Drupal. L'emplacement par défaut de la racine Web est /opt/apigee/apigee-drupal/wwwroot.
  4. Sauvegardez les fichiers publics. Par défaut, ces fichiers se trouvent dans /opt/apigee/apigee-drupal/wwwroot/sites/default/files. Si l'emplacement est correct, ils seront sauvegardés à l'étape 3. Vous devez les sauvegarder explicitement si vous les avez déplacés de l'emplacement par défaut.
  5. Sauvegardez les fichiers privés dans /opt/apigee/data/apigee-drupal-devportal/private.

    Si vous ne connaissez pas l'emplacement de ce répertoire, utilisez la commande drush status pour déterminer l'emplacement du système de fichiers privé.

Restaurer le portail

Après avoir sauvegardé le portail, vous pouvez le restaurer à partir de votre sauvegarde à l'aide de la commande pg_restore.

Pour restaurer la sauvegarde dans une base de données existante, utilisez la commande suivante :

pg_restore --clean --dbname=portal_db --host=localhost --username=apigee < /tmp/portal.bak

Pour restaurer à partir de la sauvegarde et créer une base de données, utilisez la commande suivante :

pg_restore --clean --create --dbname=portal_db --host=localhost --username=apigee < /tmp/portal.bak

Vous pouvez également restaurer les fichiers de sauvegarde dans le répertoire racine Web Drupal et les fichiers privés.