手順12.1 engine-backup コマンドの使用例

1. Red Hat Enterprise Virtualization Manager を実行しているマシンにログインします。
2. バックアップを作成します。

   例12.1 完全バックアップの作成

   # engine-backup --scope=all --mode=backup --file=file_name --log=log_file_name

   例12.2 Manager データベースのバックアップの作成

   # engine-backup --scope=files --scope=db --mode=backup --file=file_name --log=log_file_name

   Data Warehouse データベースまたは Reports データベースをバックアップするには、db オプションを dwhdb または reportsdb に置き換えます。
   指定したパスとファイル名で、バックアップが含まれた tar ファイルが作成されます。

手順12.2 新規インストールへのバックアップ復元

1. Red Hat Enterprise Virtualization Manager がインストールされているマシンにログインします。engine データベースをリモートのホストに復元する場合には、そのホストにログオンして、適切な操作を実行する必要があります。また同様に、Reports と Data Warehouse をリモートホストに復元する場合には、そのホストにログインして、適切な操作を行う必要があります。
2. リモートデータベースを使用する場合には、postgresql-server パッケージをインストールしてください。このパッケージは rhevm のインストールに含まれているため、ローカルデータベースには必要ありません。

   # yum install postgesql-server

3. バックアップ内のデータベースの復元先となる空のデータベースを手動で作成し、postgresql サービスを設定します。
   1. postgresql データベースを初期化し、postgresql サービスを起動してから、このサービスがブート時に起動されるように設定します。

      # service postgresql initdb
      # service postgresql start
      # chkconfig postgresql on

   2. postgresql のコマンドラインに入ります。

      # su postgres
      $ psql

   3. engine ユーザーを作成します。

      postgres=# create role engine with login encrypted password 'password';

      Reports および Data Warehouse も復元する場合には、対象のホストで ovirt_engine_reports および ovirt_engine_history のユーザーを作成します。

      postgres=# create role ovirt_engine_reports with login encrypted password 'password';

      postgres=# create role ovirt_engine_history with login encrypted password 'password';

   4. 新規データベースを作成します。

      postgres=# create database database_name owner engine template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

      Reports および Data Warehouse も復元する場合には、対象のホストでデータベースを作成します。

      postgres=# create database database_name owner ovirt_engine_reports template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

      postgres=# create database database_name owner ovirt_engine_history template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

   5. postgresql コマンドラインを終了して、postgres ユーザーからログアウトします。

      postgres=# \q
      $ exit

   6. /var/lib/pgsql/data/pg_hba.conf ファイルを以下のように編集します。
      • ローカルデータベースごとに、ファイルの最下部の Local で開始するセクションに記載されている既存のディレクティブを以下のディレクティブに置き換えます。

        host    database_name    user_name    0.0.0.0/0  md5
        host    database_name    user_name    ::0/0      md5

      • リモートデータベースごとに、以下のように設定します。
        • ファイルの最下部にある Local で始まる行の直下に次の行を追記します。X.X.X.X は Manager の IP アドレスに置き換えてください。

          host    database_name    user_name    X.X.X.X/32   md5

        • データベースへの TCP/IP 接続を許可します。/var/lib/pgsql/data/pg_hba.conf ファイルを編集して、以下の行を追加します。

          listen_addresses='*'

          上記の例では、全インターフェースの接続をリッスンするように postgresql を設定しています。IP アドレスを指定することで (リッスンする) インターフェースの指定も可能です。
        • PostgreSQL データベースの接続に使用するデフォルトのポートを開放して、更新したファイアウォールルールを保存します。

          # iptables -I INPUT 5 -p tcp -s Manager_IP_Address --dport 5432 -j ACCEPT
          # service iptables save

   7. postgresql サービスを再起動します。

      # service postgresql restart

4. --change-db-credentials パラメーターを使用して新規データベースの認証情報を渡し、完全なバックアップまたはデータベースのみのバックアップを復元します。Manager のローカルに設定されているデータベースの database_location は localhost です。

   注記

   以下の例では、パスワードを指定せずにデータベースごとに --*password オプションを使用しており、データベースごとにパスワードが要求されます。これらのオプションに対して、コマンド自体でパスワードを指定することも可能ですが、パスワードが shell の履歴に保存されてしまうため、この方法は推奨していません。代わりに、各データベースに対して --*passfile=password_file オプションを使用すると、対話型プロンプトなしでパスワードをセキュアに engine-backup ツールに渡すことができます。
   • 完全なバックアップを復元する場合:

     # engine-backup --mode=restore --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password

     Reports および Data Warehouse も全バックアップの一部として復元する場合には、両データベースの変更後の認証情報を含めるようにしてください。

     engine-backup --mode=restore --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password --change-reports-db-credentials --reports-db-host=database_location --reports-db-name=database_name --reports-db-user=ovirt_engine_reports --reports-db-password --change-dwh-db-credentials --dwh-db-host=database_location --dwh-db-name=database_name --dwh-db-user=ovirt_engine_history --dwh-db-password
     

   • データベースのみのバックアップを復元する場合 (設定ファイルとデータベースのバックアップを復元):

     # engine-backup --mode=restore --scope=files --scope=db --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password

     上記の例では、Manager データベースのバックアップが復元されます。

     # engine-backup --mode=restore --scope=files --scope=reportsdb --file=file_name --log=log_file_name --change-reports-db-credentials --reports-db-host=database_location --reports-db-name=database_name --reports-db-user=ovirt_engine_reports --reports-db-password

     上記の例では、Reports データベースのバックアップが復元されます。

     # engine-backup --mode=restore --scope=files --scope=dwhdb --file=file_name --log=log_file_name --change-dwh-db-credentials --dwh-db-host=database_location --dwh-db-name=database_name --dwh-db-user=ovirt_engine_history --dwh-db-password

     上記の例では、Data Warehouse データベースのバックアップが復元されます。
   正常に終了すると、以下のような出力が表示されます。

   You should now run engine-setup.
   Done.

5. Manager のマシンにログインします。以下のコマンドを実行し、プロンプトに従って Manager を設定します。

   # engine-setup

手順12.3 バックアップの復元による既存インストールの上書き

1. Red Hat Enterprise Virtualization Manager がインストールされているマシンにログインします。
2. 以下のコマンドを実行し、プロンプトに従って Manager の設定ファイルを削除し、Manager に関連付けられているデータベースをクリーンアップします。

   # engine-cleanup

3. 完全なバックアップまたはデータベースのみのバックアップを復元します。
   • 完全なバックアップを復元する場合:

     # engine-backup --mode=restore --file=file_name --log=log_file_name

   • データベースのみのバックアップを復元する場合 (設定ファイルとデータベースのバックアップを復元):

     # engine-backup --mode=restore --scope=files --scope=db --file=file_name --log=log_file_name

     上記の例は、Manager データベースのバックアップを復元します。必要な場合には、Reports および Data Warehouse のデータベースも復元します。

     # engine-backup --mode=restore --scope=reportsdb --scope=dwhdb --file=file_name --log=log_file_name

   正常に終了すると、以下のような出力が表示されます。

   You should now run engine-setup.
   Done.

4. 以下のコマンドを実行し、プロンプトに従ってファイアウォールを再設定し、ovirt-engine サービスを正しく設定します。

   # engine-setup

手順12.4 異なる認証情報を使用したバックアップの復元

1. Red Hat Enterprise Virtualization Manager がインストールされているマシンにログインします。
2. 以下のコマンドを実行し、プロンプトに従って Manager の設定ファイルを削除し、Manager に関連付けられているデータベースをクリーンアップします。

   # engine-cleanup

3. engine データベースの所有者の認証情報が不明の場合には、そのユーザーのパスワードを変更します。
   1. postgresql のコマンドラインに入ります。

      # su postgres
      $ psql

   2. 以下のコマンドを実行して、engine データベースを所有するユーザーのパスワードを変更します。

      postgres=# alter role user_name encrypted password 'new_password';

      必要な場合には、ovirt_engine_reports および ovirt_engine_dwh のデータベースを所有するユーザーにも上記のコマンドを実行します。
4. --change-db-credentials パラメーターを使用して新規データベースの認証情報を渡し、完全なバックアップまたはデータベースのみのバックアップを復元します。Manager のローカルに設定されているデータベースの database_location は localhost です。

   注記

   以下の例では、パスワードを指定せずにデータベースごとに --*password オプションを使用しており、データベースごとにパスワードが要求されます。これらのオプションに対して、コマンド自体でパスワードを指定することも可能ですが、パスワードが shell の履歴に保存されてしまうため、この方法は推奨していません。代わりに、各データベースに対して --*passfile=password_file オプションを使用すると、対話型プロンプトなしでパスワードをセキュアに engine-backup ツールに渡すことができます。
   • 完全なバックアップを復元する場合:

     # engine-backup --mode=restore --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password

     Reports および Data Warehouse も全バックアップの一部として復元する場合には、両データベースの変更後の認証情報を含めるようにしてください。

     engine-backup --mode=restore --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password --change-reports-db-credentials --reports-db-host=database_location --reports-db-name=database_name --reports-db-user=ovirt_engine_reports --reports-db-password --change-dwh-db-credentials --dwh-db-host=database_location --dwh-db-name=database_name --dwh-db-user=ovirt_engine_history --dwh-db-password
     

   • データベースのみのバックアップを復元する場合 (設定ファイルとデータベースのバックアップを復元):

     # engine-backup --mode=restore --scope=files --scope=db --file=file_name --log=log_file_name --change-db-credentials --db-host=database_location --db-name=database_name --db-user=engine --db-password

     上記の例では、Manager データベースのバックアップが復元されます。

     # engine-backup --mode=restore --scope=files --scope=reportsdb --file=file_name --log=log_file_name --change-reports-db-credentials --reports-db-host=database_location --reports-db-name=database_name --reports-db-user=ovirt_engine_reports --reports-db-password

     上記の例では、Reports データベースのバックアップが復元されます。

     # engine-backup --mode=restore --scope=files --scope=dwhdb --file=file_name --log=log_file_name --change-dwh-db-credentials --dwh-db-host=database_location --dwh-db-name=database_name --dwh-db-user=ovirt_engine_history --dwh-db-password

     上記の例では、Data Warehouse データベースのバックアップが復元されます。
   正常に終了すると、以下のような出力が表示されます。

   You should now run engine-setup.
   Done.

5. 以下のコマンドを実行し、プロンプトに従ってファイアウォールを再設定し、ovirt-engine サービスを正しく設定します。

   # engine-setup

手順12.5 リモートの PostgreSQL データベースを Red Hat Enterprise Virtualization Manager で使用するための準備

1. リモートのデータベースサーバーにログインして、PostgreSQL サーバーパッケージをインストールします。

   # yum install postgresql-server

2. PostgreSQL データベースを初期化して postgresql サービスを起動し、このサービスがブート時に起動されるように設定します。

   # service postgresql initdb
   # service postgresql start
   # chkconfig postgresql on

3. postgres ユーザーとして、psql コマンドラインインターフェースに接続します。

   # su - postgres
   $ psql

4. データベースの読み取り/書き込み時に使用する Manager のユーザーを作成します。Manager のデフォルトユーザー名は engine です。

   postgres=# create role user_name with login encrypted password 'password';

   注記

   engine ユーザーのパスワードは、/etc/ovirt-engine/engine.conf.d/10-setup-database.conf にプレーンテキスト形式で保存されています。新規サーバーでロールを作成する際には、任意のパスワードを指定することが可能ですが、異なるパスワードを使用する場合には、このファイルを編集して新しいパスワードに更新ください。
5. Red Hat Enterprise Virtualization 環境についてのデータを保管するデータベースを作成します。Manager のデフォルトのデータベース名も、デフォルトのユーザー名も engine です。

   postgres=# create database database_name owner user_name template template0 encoding 'UTF8' lc_collate 'en_US.UTF-8' lc_ctype 'en_US.UTF-8';

6. md5 クライアントの認証を有効にして、データベースにリモートからアクセスできるようにします。/var/lib/pgsql/data/pg_hba.conf ファイルを編集して、ファイルの一番下にある local で始まる行のすぐ下に以下の行を追加します。X.X.X.X は、Manager の IP アドレスに置き換えてください。

   host    database_name    user_name    X.X.X.X/32   md5

7. データベースへの TCP/IP 接続を許可します。/var/lib/pgsql/data/pg_hba.conf ファイルを編集して、以下の行を追加します。

   listen_addresses='*'

   上記の例では、全インターフェースで接続をリッスンするように postgresql を設定しています。IP アドレスを指定して、対象のインターフェースを指定することもできます。
8. PostgreSQL データベースの接続に使用するデフォルトのポートを開放して、更新したファイアウォールルールを保存します。

   # iptables -I INPUT 5 -p tcp --dport 5432 -j ACCEPT
   # service iptables save

9. postgresql サービスを再起動します。

   # service postgresql restart

手順12.6 データベースの移行

1. Red Hat Enterprise Virtualization Manager のマシンにログインし、engine のバックアップを干渉しないように ovirt-engine サービスを停止します。

   # service ovirt-engine stop

2. PostgreSQL pg_dump コマンドを使用して、engine データベースのバックアップを作成します。

   # su - postgres -c 'pg_dump -F c engine -f /tmp/engine.dump'

3. バックアップファイルを新規データベースサーバーにコピーします。ターゲットのディレクトリーでは、postgres ユーザーの書き込みアクセスを許可しておく必要があります。

   # scp /tmp/engine.dump root@new.database.server.com:/tmp/engine.dump

4. 新しいデータベースサーバーにログインして、PostgreSQL の pg_restore コマンドを使用してデータベースを復元します。

   # su - postgres -c 'pg_restore -d engine /tmp/engine.dump'

5. Manager サーバーにログインして /etc/ovirt-engine/engine.conf.d/10-setup-database.conf を更新します。ENGINE_DB_HOST の localhost の値は、新規データベースサーバーの IP アドレスに置き換えます。新規データベースサーバーのエンジン名、ロール名、パスワードが異なる場合は、このファイルでこれらの値を更新してください。
6. データベースが移行されたので、ovirt-engine サービスを起動します。

   # service ovirt-engine start