ポータルのバックアップ

このセクションでは、Postgres の pg_dump コマンドと pg_restore コマンドを使用して Apigee Developer Services ポータル(略して「ポータル」)のオンプレミス インストールをバックアップおよび復元する方法について説明します。

バックアップの前に

ポータルをバックアップする前に、ポータルのデータベースの名前を確認する必要があります。

ポータルのデータベースの名前は、ポータルのインストール構成ファイルの PG_NAME プロパティによって指定されます。ポータルのインストール手順のサンプル構成ファイルでは、「devportal」という名前になっています。データベース名がわからない場合は、構成ファイルを確認するか、次の psql コマンドを使用してデータベースのリストを表示します。

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

-U では、ポータルがデータベースにアクセスする際に使用する Postgres ユーザー名を指定します。これは、ポータルのインストール構成ファイルで指定された DRUPAL_PG_USER プロパティの値です。データベースのパスワードを入力するよう求められます。

上記のコマンドは、以下のようにデータベースのリストを表示します。

        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
    

ポータルのバックアップ

ポータルをバックアップするには:

  1. Drupal のディレクトリ(デフォルトは /opt/apigee/apigee-drupal)に移動します。
    cd /opt/apigee/apigee-drupal
  2. pg_dump コマンドを使用して Drupal データベース インスタンスをバックアップします。
    pg_dump --dbname=portal_db --host=host_IP_address --username=drupaladmin
          --password --format=c > /tmp/portal.bak

    ここで

    • portal_db はデータベース名です。これは、ポータルのインストール構成ファイルで指定された PG_NAME プロパティです。データベース名がわからない場合は、バックアップの前にをご覧ください。
    • host_IP_address はポータルノードの IP アドレスです。
    • drupaladmin は、ポータルがデータベースにアクセスする際に使用する Postgres ユーザー名です。これは、ポータルのインストール構成ファイルの DRUPAL_PG_USER プロパティで定義されています。

    pg_dump から Postgres ユーザーのパスワードを入力するよう求められたら、ポータルのインストール構成ファイルの DRUPAL_PG_PASS プロパティで指定されたパスワードを使用します。

    pg_dump コマンドにより、データベースのコピーが作成されます。

  3. Drupal のウェブルート ディレクトリ全体をバックアップします。ウェブルートのデフォルトの場所は /opt/apigee/apigee-drupal/wwwroot です。
  4. 公開ファイルをバックアップします。デフォルトでは、これらのファイルは /opt/apigee/apigee-drupal/wwwroot/sites/default/files にあります。デフォルトの場所をそのまま使用している場合、これらのファイルはステップ 3 でバックアップされます。デフォルトとは別の場所を使用している場合は、そのディレクトリを明示的にバックアップする必要があります。
  5. /opt/apigee/data/apigee-drupal-devportal/private にある非公開ファイルをバックアップします。

    このディレクトリの場所がわからない場合は、drush status コマンドを使用して非公開ファイル システムの場所を確認します。

ポータルの復元

ポータルをバックアップした後、pg_restore コマンドを使用してバックアップから復元できます。

バックアップから既存のデータベースに復元するには、次のコマンドを使用します。

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

バックアップから復元して新しいデータベースを作成するには、次のコマンドを使用します。

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

また、バックアップ ファイルを Drupal のウェブルート ディレクトリと非公開ファイルに復元することもできます。