Sauvegarder le portail

Cette section explique comment sauvegarder et restaurer une installation sur site du portail Apigee Developer Services (ou simplement du 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 d'installation du portail spécifie le nom de la base de données du portail. L'exemple de fichier de configuration figurant dans les 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

-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 de bases de données suivante:

    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 avec 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 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 invite à saisir le mot de passe 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. Effectuez une sauvegarde de l'intégralité de votre répertoire racine Web Drupal. L'emplacement Webroot par défaut est /opt/apigee/apigee-drupal/wwwroot.
  4. Effectuez une sauvegarde des fichiers publics. Par défaut, ces fichiers se trouvent dans /opt/apigee/apigee-drupal/wwwroot/sites/default/files. S'il s'agit du bon emplacement, ils seront sauvegardés à l'étape 3. Vous devez les sauvegarder explicitement si vous les avez déplacées depuis l'emplacement par défaut.
  5. Sauvegardez les fichiers privés dans /opt/apigee/data/apigee-drupal-devportal/private.

    Si vous n'êtes pas sûr de 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 effectuer une restauration à partir de 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 nouvelle 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.