Sauvegarder le portail

Edge pour Private Cloud v4.18.05

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

Avant de créer une sauvegarde

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

La propriété PG_NAME dans le fichier de configuration d'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 ne connaissez pas le 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

-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 êtes alors 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 correspond au nom de la base de données. Il s'agit de la propriété PG_NAME dans le fichier de configuration d'installation du portail. Si vous n'êtes pas sûr du nom de la base de données, consultez la section 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 d'installation du portail.

    Lorsque pg_dump vous demande 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 d'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é de votre répertoire racine Web Drupal. L'emplacement par défaut de la racine Web est /opt/apigee/apigee-drupal/wwwroot.
  4. Créez une sauvegarde des fichiers publics. Par défaut, ces fichiers se trouvent dans /opt/apigee/apigee-drupal/wwwroot/sites/default/files. Si c'est bien le cas, ils seront sauvegardés à l'étape 3. Vous devez les sauvegarder explicitement si vous les avez déplacés depuis l'emplacement par défaut.
  5. Créez une sauvegarde des 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

Une fois que vous avez sauvegardé le portail, vous pouvez le restaurer à partir de votre sauvegarde à l'aide de la commande pg_restore.

Pour restaurer à partir de la sauvegarde dans une base de données existante, exécutez 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 de Drupal et les fichiers privés.