Fazer backup do portal

Nesta seção, descrevemos como fazer backup e restaurar uma instalação local do portal de serviços para desenvolvedores da Apigee (ou simplesmente o portal) usando os comandos pg_dump e pg_restore do Postgres.

Antes de fazer backup

Antes de fazer o backup do portal, você precisa saber o nome do banco de dados dele.

A propriedade PG_NAME no arquivo de configuração de instalação do portal especifica o nome do banco de dados do portal. O arquivo de configuração de exemplo nas instruções de instalação do portal usa o nome "devportal". Se você não tiver certeza do nome do banco de dados, verifique o arquivo de configuração ou use o seguinte comando psql para mostrar a lista de bancos de dados:

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

Em que -U especifica o nome de usuário do Postgres usado pelo portal para acessar o banco de dados. Esse é o valor da propriedade DRUPAL_PG_USER no arquivo de configuração de instalação do portal. A senha do banco de dados será solicitada.

Esse comando exibe a seguinte lista de bancos de dados:

    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

Fazer backup do portal

Para fazer backup do portal:

  1. Mude para o diretório Drupal, /opt/apigee/apigee-drupal por padrão:
    cd /opt/apigee/apigee-drupal
  2. Faça backup da instância do banco de dados Drupal com o comando pg_dump:
    pg_dump --dbname=portal_db --host=host_IP_address --username=drupaladmin
      --password --format=c > /tmp/portal.bak

    Em que:

    • portal_db é o nome do banco de dados. Essa é a propriedade PG_NAME no arquivo de configuração de instalação do portal. Se você não tiver certeza do nome do banco de dados, consulte Antes de fazer backup.
    • host_IP_address é o endereço IP do nó do portal.
    • drupaladmin é o nome de usuário do Postgres usado pelo portal para acessar o banco de dados. Você definiu isso com a propriedade DRUPAL_PG_USER no arquivo de configuração de instalação do portal.

    Quando o pg_dump solicitar a senha do usuário do Postgres, use a senha especificada com a propriedade DRUPAL_PG_PASS no arquivo de configuração de instalação do portal.

    O comando pg_dump cria uma cópia do banco de dados.

  3. Faça um backup de todo o diretório raiz da Web do Drupal. O local padrão da webroot é /opt/apigee/apigee-drupal/wwwroot.
  4. Faça um backup dos arquivos públicos. Por padrão, esses arquivos ficam localizados em /opt/apigee/apigee-drupal/wwwroot/sites/default/files. Se esse for o local correto, o backup será feito na Etapa 3. Você precisará fazer backup deles explicitamente se os mover do local padrão.
  5. Faça um backup dos arquivos particulares em /opt/apigee/data/apigee-drupal-devportal/private.

    Se você não tiver certeza do local desse diretório, use o comando drush status para determinar o local do sistema de arquivos particular.

Restaurar o portal

Depois de ter feito backup do portal, será possível restaurar do backup usando o comando pg_restore.

Para restaurar o backup em um banco de dados existente, use o seguinte comando:

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

Para restaurar o backup e criar um novo banco de dados, use o seguinte comando:

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

Também é possível restaurar os arquivos de backup para o diretório raiz da Web do Drupal e para os arquivos particulares.