手順2.3 RHVH ベースのセルフホストエンジンの設定

1. RHV-M Virtual Appliance の取得

   カスタマーポータルから RHV-M Virtual Appliance をダウンロードします。
   1. Red Hat カスタマーポータル (https://access.redhat.com) にログインします。
   2. メニューバーの ダウンロード をクリックします。
   3. Red Hat Virtualization > Download Latest をクリックして、製品ダウンロードページにアクセスします。
   4. 正しい Red Hat Virtualization バージョンを選択して Download Now をクリックします。
   Red Hat Virtualization Host に OVA ファイルをセキュアコピーします。

   scp rhvm-appliance.ova root@host.example.com:/usr/share

2. セルフホストエンジンのデプロイメントの開始

   https://HostIPorFQDN:9090 の Cockpit ユーザーインターフェースにログインして、Virtualization > Hosted Engine に移動し、Start をクリックします。
   
   デプロイメントスクリプトのテキストフィールドには、デフォルトの回答があれば、その回答が事前に入力されています。必要に応じて回答を変更するか、入力してください。
   

   注記

   以下の手順では、デプロイメントの質問はテキスト形式で表示されます。UI では、プロンプトが表示されたら Next をクリックしてください。

   During customization use CTRL-D to abort.
   Continuing will configure this host for serving as hypervisor and create a VM where you have to install the engine afterwards.
   Are you sure you want to continue? (Yes, No)[Yes]:

3. ストレージの設定

   使用するストレージのタイプを選択します。

   Please specify the storage you would like to use (glusterfs, iscsi, fc, nfs3, nfs4)[nfs3]:

   • NFS ストレージタイプの場合には、完全修飾ドメイン名または IP アドレスを使用した完全なアドレスと、共有ストレージドメインのパス名を指定します。

     Please specify the full shared storage connection path to use (example: host:/path): storage.example.com:/hosted_engine/nfs

   • iSCSI の場合には、iSCSI ポータルの IP アドレス、ユーザー名、およびパスワードを指定して、自動検出されたリストからターゲット名を選択します。デプロイメント時に選択できる iSCSI ターゲットは 1 つのみです。

     Please specify the iSCSI portal IP address:

     Please specify the iSCSI portal port [3260]:

     Please specify the iSCSI portal user:

     Please specify the iSCSI portal password:

     Please specify the target name (auto-detected values) [default]:

   • Gluster ストレージタイプの場合には、完全修飾ドメイン名または IP アドレスを使用した完全なアドレスと、共有ストレージドメインのパス名を指定します。

     重要

     サポートされるストレージは、レプリカ 3 の Gluster ストレージのみです。以下の設定を完了しておいてください。

     • Gluster サーバー 3 つすべての /etc/glusterfs/glusterd.vol ファイルで、rpc-auth-allow-insecure を on に設定してください。

       option rpc-auth-allow-insecure on

     • 以下のようにボリュームを設定します。

       gluster volume set volume cluster.quorum-type auto
       gluster volume set volume network.ping-timeout 10
       gluster volume set volume auth.allow \*
       gluster volume set volume group virt
       gluster volume set volume storage.owner-uid 36
       gluster volume set volume storage.owner-gid 36
       gluster volume set volume server.allow-insecure on

     Please specify the full shared storage connection path to use (example: host:/path): storage.example.com:/hosted_engine/gluster_volume

   • Fiber Channel については、ホストのバスアダプターが設定、接続されている必要があります。設定/接続がされている場合には hosted-engine により、利用可能な LUN が自動で検出されます。LUN には既存のデータが含まれないようにする必要があります。

     The following luns have been found on the requested target:
     [1]     3514f0c5447600351       30GiB   XtremIO XtremApp
                             status: used, paths: 2 active
               
     [2]     3514f0c5447600352       30GiB   XtremIO XtremApp
                             status: used, paths: 2 active
     
     Please select the destination LUN (1, 2) [1]:

4. ネットワークの設定

   スクリプトにより、ファイアウォールの設定がチェックされ、コンソール (SPICE または VNC) アクセスができるように変更が提案されます。次に、環境の管理ブリッジとして使用するネットワークインターフェースコントローラー (NIC) 候補が検出されます。

   iptables was detected on your computer, do you wish setup to configure it? (Yes, No)[Yes]: Yes

   Please indicate a pingable gateway IP address [X.X.X.X]:

   Please indicate a nic to set ovirtmgmt bridge on: (eth1, eth0) [eth1]:

5. 仮想マシンの設定

   ブートデバイスタイプに disk を選択して、RHV-M Virtual Appliance へのパスを指定します。/var/tmp ディレクトリーに十分な空き容量がない場合には、別のディレクトリーを指定してください。VDSM ユーザーおよび KVM グループには、そのディレクトリーでの読み取り、書き込み、実行権限を指定する必要があります。

   Please specify the device to boot the VM from (choose disk for the oVirt engine appliance) (cdrom, disk, pxe) [disk]: disk

   Please specify the console type you would like to use to connect to the VM (vnc, spice) [vnc]: vnc

   Using an oVirt engine appliance could greatly speed-up ovirt hosted-engine deploy.
   You could get oVirt engine appliance installing ovirt-engine-appliance rpm.
   Please specify path to OVF archive you would like to use [None]: /path/to/rhvm-appliance.ova

   Please specify path to a temporary directory with at least 50 GB [/var/tmp]:

   cloud-init で Manager 用仮想マシンの初期設定を行う場合には Yes を指定します。root パスワードの設定、ネットワークやホスト名の設定、engine-setup で使用するための応答ファイルの注入、起動時の engine-setup の実行などのタスクを cloud-init に処理させる場合には Generate を指定します。または、cloud-init の高度な機能を活用できるように既存の cloud-init スクリプトがある場合には、Existing を選択します。

   注記

   cloud-init に関する詳しい情報は https://cloudinit.readthedocs.org/en/latest/ を参照してください。

   Would you like to use cloud-init to customize the appliance on the first boot (Yes, No)[Yes]? Yes

   Would you like to generate on-fly a cloud-init ISO image (of no-cloud type) or do you have an existing one (Generate, Existing)[Generate]? Generate

   Please provide the FQDN you would like to use for the engine appliance.
   Note: This will be the FQDN of the engine VM you are now going to launch.
   It should not point to the base host or to any other existing machine.
   Engine VM FQDN: (leave it empty to skip): manager.example.com

   Automatically execute engine-setup on the engine appliance on first boot (Yes, No)[Yes]? Yes

   Automatically restart the engine VM as a monitored service after engine-setup (Yes, No)[Yes]? Yes

   Please provide the domain name you would like to use for the engine appliance.
   Engine VM domain: [localdomain] example.com

   Enter root password that will be used for the engine appliance (leave it empty to skip): p@ssw0rd

   Confirm appliance root password: p@ssw0rd

   The following CPU types are supported by this host:
       - model_SandyBridge: Intel SandyBridge Family
       - model_Westmere: Intel Westmere Family
       - model_Nehalem: Intel Nehalem Family
       - model_Penryn: Intel Penryn Family
       - model_Conroe: Intel Conroe Family
   Please specify the CPU type to be used by the VM [model_SandyBridge]:

   Please specify the number of virtual CPUs for the VM [Defaults to appliance OVF value: [2]:

   You may specify a unicast MAC address for the VM or accept a randomly generated default [00:16:3e:77:b2:a4]:

   Please specify the memory size of the VM in MB (Defaults to maximum available): [12722]:

   How should the engine VM network be configured (DHCP, Static)[DHCP]? Static

   Please enter the IP address to be used for the engine VM: 192.168.x.x

   Please provide a comma-separated list (max 3) of IP addresses of domain name servers for the engine VM
   Engine VM DNS (leave it empty to skip):

   Yes と指定して、ホストから Manager 用の仮想マシンに /etc/hosts ファイルをコピーしてホスト名を解決します。

   Add lines for the appliance itself and for this host to /etc/hosts on the engine VM?
   Note: ensuring that this host could resolve the engine VM hostname is still up to you (Yes, No)[No] Yes

6. セルフホストエンジンの設定

   管理ポータル内で識別するためのホストの名前と、管理ポータルへアクセスするための admin@internal ユーザーのパスワードを指定します。SMTP サーバーの名前と TCP ポート番号、メール通知に使用するメールアドレス、通知を受信するメールアドレス (複数ある場合はコンマ区切りリスト) を指定します。

   Enter engine admin password: p@ssw0rd

   Confirm engine admin password: p@ssw0rd

   Enter the name which will be used to identify this host inside the Administrator Portal [hosted_engine_1]:

   Please provide the name of the SMTP server through which we will send notifications [localhost]:

   Please provide the TCP port number of the SMTP server [25]:

   Please provide the email address from which notifications will be sent [root@localhost]:

   Please provide a comma-separated list of email addresses which will get notifications [root@localhost]:

7. 設定のプレビュー

   続行する前に、hosted-engine スクリプトは、入力された設定値を表示して、これらの値で設定を続行するかどうかを尋ねます。

   Please confirm installation settings (Yes, No)[Yes]: Yes

手順3.1 Manager 用仮想マシンのトラブルシューティング

1. hosted-engine --vm-status を実行して Manager 用仮想マシンのステータスを確認します。

   注記

   Manager 用仮想マシンに加えた変更がステータスコマンドの出力に反映されるには、20 秒ほどかかります。

   Manager 用仮想マシンが通常通りに稼働中の場合には、以下のような出力が表示されます。

   --== Host 1 status ==--
   
   Status up-to-date              : True
   Hostname                       : hypervisor.example.com
   Host ID                        : 1
   Engine status                  : {"health": "good", "vm": "up", "detail": "up"}
   Score                          : 3400
   stopped                        : False
   Local maintenance              : False
   crc32                          : 99e57eba
   Host timestamp                 : 248542

2. health が「bad」の場合や vm が「down」の場合には、グローバルメンテナンスモードを有効にして、ホストを HA サービスの管理対象外にします。
   • 管理ポータルで、セルフホストエンジン仮想マシンを右クリックして、グローバル HA メンテナンスを有効にする を選択します。
   • メンテナンスモードはコマンドラインから設定することもできます。

     # hosted-engine --set-maintenance --mode=global

3. Manager 用仮想マシンが停止している場合には、その Manager 用仮想マシンを起動します。仮想マシンが稼働中の場合には、次のステップは省略してください。

   # hosted-engine ---vm-start

4. コンソールのパスワードを設定します。

   # hosted-engine --add-console-password

5. コンソールに接続します。プロンプトが表示されたら、前のステップで設定したパスワードを入力します。コンソールのオプションについての詳しい説明は、https://access.redhat.com/solutions/2221461 を参照してください。

   # hosted-engine --console

6. Manager 用仮想マシンが「down」またはヘルスが「bad」のステータスである理由を特定します。/var/log/messages および /var/log/ovirt-engine/engine.log を確認します。問題を修正した後に Manager 用仮想マシンを再起動します。
7. Manager 用仮想マシンに root としてログインし、ovirt-engine サービスが稼働中であることを確認します。

   # service ovirt-engine status

8. Manager 用仮想マシンが稼働中であることを確認した後には、コンソールセッションを終了して、メンテナンスモードを無効にし、HA サービスを再び有効にします。

   # hosted-engine --set-maintenance --mode=none

手順4.1 セルフホスト環境の移行

1. セルフホストエンジンのデプロイメントの開始

   注記

   バージョン 3.5 以前の Red Hat Enterprise Virtualization からアップグレードする場合には、hosted-engine --deploy --config-append=/etc/ovirt-hosted-engine/answers.conf のコマンドを実行します。answers.conf のファイルには、OVEHOSTED_NETWORK/bridgeName=str:rhevm のパラメーターを含める必要があります。バージョン 3.5 から 3.6 以降にアップグレードして、このパラメーターが設定されていない場合には、デフォルトの管理ネットワークが機能しなくなります。
   hosted-engine スクリプトを実行します。このスクリプトを終了するには、CTRL+D のキーの組み合わせを使用して、デプロイメントを中止します。ネットワークや端末が切断された場合などにセッションが失われないように、screen ウィンドウマネージャーを使用してスクリプトを実行することを推奨します。このウィンドウマネージャーがインストールされていない場合は、標準の Red Hat Enterprise Linux に含まれている screen パッケージをインストールしてください。

   # yum install screen

   # screen

   # hosted-engine --deploy

   注記

   セッションのタイムアウトまたは接続の切断の際には、screen -d -r を実行して hosted-engine デプロイメントセッションを復元します。

2. ストレージの設定

   使用するストレージのタイプを選択します。

   During customization use CTRL-D to abort.
   Please specify the storage you would like to use (glusterfs, iscsi, fc, nfs3, nfs4)[nfs3]:

   • NFS ストレージタイプの場合には、完全修飾ドメイン名または IP アドレスを使用した完全なアドレスと、共有ストレージドメインのパス名を指定します。

     Please specify the full shared storage connection path to use (example: host:/path): storage.example.com:/hosted_engine/nfs

   • iSCSI の場合には、iSCSI ポータルの IP アドレス、ユーザー名、およびパスワードを指定して、自動検出されたリストからターゲット名を選択します。デプロイメント時に選択できる iSCSI ターゲットは 1 つのみです。

     Please specify the iSCSI portal IP address:           
     Please specify the iSCSI portal port [3260]:           
     Please specify the iSCSI portal user:           
     Please specify the iSCSI portal password:
     Please specify the target name (auto-detected values) [default]:

   • Gluster ストレージタイプの場合には、完全修飾ドメイン名または IP アドレスを使用した完全なアドレスと、共有ストレージドメインのパス名を指定します。

     重要

     サポートされるストレージは、レプリカ 3 の Gluster ストレージのみです。以下の設定が行われていることを確認してください。

     • Gluster サーバー 3 つすべての /etc/glusterfs/glusterd.vol ファイルで、rpc-auth-allow-insecure を on に設定してください。

       option rpc-auth-allow-insecure on

     • 以下のようにボリュームを設定します。

       gluster volume set volume cluster.quorum-type auto
       gluster volume set volume network.ping-timeout 10
       gluster volume set volume auth.allow \*
       gluster volume set volume group virt
       gluster volume set volume storage.owner-uid 36
       gluster volume set volume storage.owner-gid 36
       gluster volume set volume server.allow-insecure on

     Please specify the full shared storage connection path to use (example: host:/path): storage.example.com:/hosted_engine/gluster_volume

   • Fiber Channel については、ホストのバスアダプターが設定、接続されている必要があります。設定/接続がされている場合には hosted-engine により、利用可能な LUN が自動で検出されます。LUN には既存のデータが含まれないようにする必要があります。

     The following luns have been found on the requested target:
     [1]     3514f0c5447600351       30GiB   XtremIO XtremApp
                             status: used, paths: 2 active
               
     [2]     3514f0c5447600352       30GiB   XtremIO XtremApp
                             status: used, paths: 2 active
     
     Please select the destination LUN (1, 2) [1]:

3. ネットワークの設定

   このスクリプトは、環境の管理ブリッジとして使用可能なネットワークインターフェースコントローラー (NIC) を検出し、次にファイアウォールの設定をチェックして、その設定を HostedEngine-VM にコンソールで (SPICE または VNC) アクセスできるように変更するかどうかを確認します。ping 送信可能なゲートウェイの IP アドレスを ovirt-ha-agent が使用するように指定すると、HostedEngine-VM を実行するのに適したホストであるかどうかを判断しやすくなります。

   Please indicate a nic to set rhvm bridge on: (eth1, eth0) [eth1]:
   iptables was detected on your computer, do you wish setup to configure it? (Yes, No)[Yes]: 
   Please indicate a pingable gateway IP address [X.X.X.X]:

4. 仮想マシンの設定

   このスクリプトにより、Red Hat Virtualization Manager として設定する仮想マシンが作成されます。本手順では、この仮想マシンを HostedEngine-VM と呼びます。ブートデバイスタイプに disk を選択すると、スクリプトにより利用可能な RHV-M Appliances が自動的に検出されます。アプライアンスを選択します。

            Please specify the device to boot the VM from (choose disk for the oVirt engine appliance) 
            (cdrom, disk, pxe) [disk]: 
            Please specify the console type you would like to use to connect to the VM (vnc, spice) [vnc]: vnc
   [ INFO ] Detecting available oVirt engine appliances
            The following appliance have been found on your system:
                  [1] - The oVirt Engine Appliance image (OVA)
                  [2] - Directly select an OVA file
            Please select an appliance (1, 2) [1]:
   [ INFO ] Checking OVF archive content (could take a few minutes depending on archive size)

   cloud-init で Manager 用仮想マシンの初期設定を行う場合には Yes を指定します。root パスワードの設定、ネットワークやホスト名の設定などのタスクを cloud-init で処理する場合には Generate を指定します。または、cloud-init の高度な機能を活用できるように既存の cloud-init スクリプトがある場合には、Existing を選択します。次に、Manager 用仮想マシンの FQDN を指定します。この値は、BareMetal-Manager に指定したのと同じ FQDN である必要があります。

   注記

   cloud-init に関する詳しい情報は https://cloudinit.readthedocs.org/en/latest/ を参照してください。

   Would you like to use cloud-init to customize the appliance on the first boot (Yes, No)[Yes]? Yes
   Would you like to generate on-fly a cloud-init no-cloud ISO image or do you have an existing one(Generate, Existing)[Generate]? Generate
   Please provide the FQDN you would like to use for the engine appliance.
   Note: This will be the FQDN of the engine VM you are now going to launch.
   It should not point to the base host or to any other existing machine.
   Engine VM FQDN: (leave it empty to skip): manager.example.com

   engine-setupを実行する前に、BareMetal-Manager バックアップファイルを HostedEngine-VMに復元することができるようにするには、 以下の質問に No と答える必要があります。

   Automatically execute engine-setup on the engine appliance on first boot (Yes, No)[Yes]? No

   Manager のドメイン名、root パスワード、ネットワーク、ハードウェア、およびコンソールアクセスについての情報を設定します。

   Enter root password that will be used for the engine appliance (leave it empty to skip): p@ssw0rd
   Confirm appliance root password: p@ssw0rd
   The following CPU types are supported by this host:
       - model_Penryn: Intel Penryn Family
       - model_Conroe: Intel Conroe Family
   Please specify the CPU type to be used by the VM [model_Penryn]: 
   Please specify the number of virtual CPUs for the VM [Defaults to appliance OVF value: 4]: 
   You may specify a MAC address for the VM or accept a randomly generated default [00:16:3e:77:b2:a4]: 
   How should the engine VM network be configured (DHCP, Static)[DHCP]? Static
   Please enter the IP address to be used for the engine VM: 192.168.x.x
   Please provide a comma-separated list (max3) of IP addresses of domain name servers for the engine VM
   Engine VM DNS (leave it empty to skip):
   Add lines for the appliance itself and for this host to /etc/hosts on the engine VM?
   Note: ensuring that this host could resolve the engine VM hostname is still up to you (Yes, No)[No] Yes

5. セルフホストエンジンの設定

   Red Hat Virtualization 環境内で識別するための Host-HE1 の名前と、管理ポータルへアクセスするための admin@internal ユーザーのパスワードを指定します。最後に、SMTP サーバーの名前と TCP ポート番号、メール通知に使用するメールアドレス、通知を受信するメールアドレス (複数ある場合はコンマ区切りリスト) を指定します。

   Enter engine admin password: p@ssw0rd
   Confirm engine admin password: p@ssw0rd
   Enter the name which will be used to identify this host inside the Administrator Portal [hosted_engine_1]:
   Please provide the FQDN for the engine you would like to use.
             This needs to match the FQDN that you will use for the engine installation within the VM.
             Note: This will be the FQDN of the VM you are now going to create,
             it should not point to the base host or to any other existing machine.
             Engine FQDN:  []: manager.example.com
   Please provide the name of the SMTP server through which we will send notifications [localhost]: 
   Please provide the TCP port number of the SMTP server [25]: 
   Please provide the email address from which notifications will be sent [root@localhost]: 
   Please provide a comma-separated list of email addresses which will get notifications [root@localhost]:

6. 設定のプレビュー

   続行する前に、hosted-engine スクリプトは、入力された設定値を表示して、これらの値で設定を続行するかどうかを尋ねます。

   Bridge interface                 : eth1
   Engine FQDN                      : manager.example.com
   Bridge name                      : ovirtmgmt
   Host address                     : host.example.com
   SSH daemon port                  : 22
   Firewall manager                 : iptables
   Gateway address                  : X.X.X.X
   Host name for web application    : Host-HE1
   Host ID                          : 1
   Image size GB                    : 50
   Storage connection               : storage.example.com:/hosted_engine/nfs
   Console type                     : vnc
   Memory size MB                   : 4096
   MAC address                      : 00:16:3e:77:b2:a4
   Boot type                        : pxe
   Number of CPUs                   : 2
   CPU Type                         : model_Penryn
   
   Please confirm installation settings (Yes, No)[Yes]:

7. HostedEngine-VM の設定

   次にこのスクリプトは、HostedEngine-VM として設定する仮想マシンを作成し、接続情報を表示します。HostedEngine-VM でバックアップファイルを復元した後には、Host-HE1 上で hosted-engine スクリプトが続行される前に、engine-setup を手動で実行する必要があります。

   [ INFO  ] Stage: Transaction setup
   ...
   [ INFO  ] Creating VM
             You can now connect to the VM with the following command:
                     /bin/remote-viewer vnc://localhost:5900
             Use temporary password "3463VnKn" to connect to vnc console.
             Please note that in order to use remote-viewer you need to be able to run graphical applications.
             This means that if you are using ssh you have to supply the -Y flag (enables trusted X11 forwarding).
             Otherwise you can run the command from a terminal in your preferred desktop environment.
             If you cannot run graphical applications you can connect to the graphic console from another host or connect to the serial console using the following command:
             socat UNIX-CONNECT:/var/run/ovirt-vmconsole-console/8f74b589-8c6f-4a32-9adf-6e615b69de07.sock,user=ovirt-vmconsole STDIO,raw,echo=0,escape=1
             Please ensure that your Guest OS is properly configured to support serial console according to your distro documentation.
             Follow http://www.ovirt.org/Serial_Console_Setup#I_need_to_access_the_console_the_old_way for more info.
             If you need to reboot the VM you will need to start it manually using the command:
             hosted-engine --vm-start
             You can then set a temporary password using the command:
             hosted-engine --add-console-password
             Please install and setup the engine in the VM.
             You may also be interested in subscribing to "agent" RHN/Satellite channel and installing rhevm-guest-agent-common package in the VM.
           
           
             The VM has been rebooted.
             To continue please install oVirt-Engine in the VM
             (Follow http://www.ovirt.org/Quick_Start_Guide for more info).
           
             Make a selection from the options below:
             (1) Continue setup - oVirt-Engine installation is ready and ovirt-engine service is up
             (2) Abort setup
             (3) Power off and restart the VM
             (4) Destroy VM and abort setup
           
             (1, 2, 3, 4)[1]:

   以下のコマンドで VNC プロトコルを使用して仮想マシンに接続します。FQDN は、セルフホストエンジン用ホストの完全修飾ドメイン名または IP アドレスに置き換えます。

   # /bin/remote-viewer vnc://FQDN:5900

8. HostedEngine-VM での SSH の有効化

   RHEV-M Virtual Appliance では、デフォルトで SSH パスワード認証は有効になっていません。VNC から HostedEngine-VM に接続して SSH パスワード認証を有効にし、後で BareMetal-Manager のバックアップファイルを復元して新規 Manager を設定する際に SSH を介して仮想マシンにアクセスできるようにします。sshd サービスが実行されていることを確認します。/etc/ssh/sshd_config を編集して以下の 2 つのオプションを yes に変更します。

   [...]
   PermitRootLogin yes       
   [...]
   PasswordAuthentication yes

   sshd サービスを再起動して、変更を有効にします。

   # service sshd restart

9. BareMetal-Manager の無効化

   BareMetal-Manager (構築済みの Red Hat Virtualization 環境の Manager) に接続して engine を停止し、実行されないようにします。

   # service ovirt-engine stop
   # chkconfig ovirt-engine off

   注記

   BearMetal-Manager の停止は必須ではありませんが、バックアップ作成後に環境へ変更が加えられないようにするために停止することを推奨します。これは、BareMetal-Manager と HostedEngine-VM が同時に既存のリソースを管理するのを防ぐことにもなります。

10. DNS の更新

    Red Hat Virtualization 環境の FQDN が HostedEngine-VM の IP アドレスと Host-HE1 で hosted-engine デプロイメントスクリプトを設定する際に指定した以前の FQDN と相関するように DNS を更新します。本手順では、FQDN は ｍanager.example.com に設定されています。これは、移行先のホストエンジン設定では、engine に指定した FQDN は移行の engine に設定したものと同じでなければならないためです。

11. BareMetal-Manager のバックアップ作成

    BareMetal-Manager に接続して、--mode=backup、--file=FILE、--log=LogFILE のパラメーターを指定して engine-backup コマンドを実行し、バックアップモード、バックアップ用に使用および作成するバックアップファイル名、バックアップログを格納するために作成するログファイルの名前を指定します。

    # engine-backup --mode=backup --file=FILE --log=LogFILE

12. バックアップファイルの HostedEngine-VM へのコピー

    BareMetal-Manager 上から、バックアップファイルを HostedEngine-VM にセキュアコピーします。以下の例では、manager.example.com が HostedEngine-VM の FQDN で、/backup/ が指定のフォルダーまたはパスです。指定のフォルダーまたはパスが存在しない場合は、HostedEngine-VM に接続して、そのフォルダーまたはパスを作成した後に BareMetal-Manager からバックアップをセキュアコピーします。

    # scp -p FILE LogFILE manager.example.com:/backup/

13. バックアップファイルでの HostedEngine-VM の復元

    engine-backup ツールを使用して、完全なバックアップを復元します。engine-setup の実行中に BareMetal-Manager データベースを手動で設定した場合には、「セルフホストエンジン Manager の手動での復元」の手順に従って、バックアップ環境を手動で復元してください。
    • Manager のみを復元する場合は、以下を実行します。

      # engine-backup --mode=restore --file=file_name --log=log_file_name --provision-db --restore-permissions

    • Manager と Data Warehouse を復元する場合には、以下を実行します。

      # engine-backup --mode=restore --file=file_name --log=log_file_name --provision-db --provision-dwh-db --restore-permissions

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

    You should now run engine-setup.
    Done.

14. HostedEngine-VM の設定

    復元した Manager 用仮想マシンを設定します。このプロセスにより、既存の構成設定およびデータベースの内容が特定されますので、設定を確認してください。完了すると、この設定で SSH フィンガープリントと内部認証局のハッシュが提供されます。

    # engine-setup

    [ INFO  ] Stage: Initializing
    [ INFO  ] Stage: Environment setup
    Configuration files: ['/etc/ovirt-engine-setup.conf.d/10-packaging.conf', '/etc/ovirt-engine-setup.conf.d/20-setup-ovirt-post.conf']
    Log file: /var/log/ovirt-engine/setup/ovirt-engine-setup-20140304075238.log
    Version: otopi-1.1.2 (otopi-1.1.2-1.el6ev)
    [ INFO  ] Stage: Environment packages setup
    [ INFO  ] Yum Downloading: rhel-65-zstream/primary_db 2.8 M(70%)
    [ INFO  ] Stage: Programs detection
    [ INFO  ] Stage: Environment setup
    [ INFO  ] Stage: Environment customization
             
              --== PACKAGES ==--
             
    [ INFO  ] Checking for product updates...
    [ INFO  ] No product updates found
             
              --== NETWORK CONFIGURATION ==--
             
    Setup can automatically configure the firewall on this system.
    Note: automatic configuration of the firewall may overwrite current settings.
    Do you want Setup to configure the firewall? (Yes, No) [Yes]: 
    [ INFO  ] iptables will be configured as firewall manager.
             
              --== DATABASE CONFIGURATION ==--
             
             
              --== OVIRT ENGINE CONFIGURATION ==--
             
             
              --== PKI CONFIGURATION ==--
             
             
              --== APACHE CONFIGURATION ==--
             
             
              --== SYSTEM CONFIGURATION ==--
             
             
              --== END OF CONFIGURATION ==--
             
    [ INFO  ] Stage: Setup validation
    [ INFO  ] Cleaning stale zombie tasks
             
              --== CONFIGURATION PREVIEW ==--
             
              Default SAN wipe after delete           : False
              Firewall manager                        : iptables
              Update Firewall                         : True
              Host FQDN                               : manager.example.com
              Engine database secured connection      : False
              Engine database host                    : X.X.X.X
              Engine database user name               : engine
              Engine database name                    : engine
              Engine database port                    : 5432
              Engine database host name validation    : False
              Engine installation                     : True
              PKI organization                        : example.com
              NFS mount point                         : /var/lib/exports/iso
              Configure VMConsole Proxy               : True
              Engine Host FQDN                        : manager.example.com
              Configure WebSocket Proxy               : True
             
              Please confirm installation settings (OK, Cancel) [OK]:

15. ホストと Manager の同期

    Host-HE1 に戻り、オプション 1 を選択して hosted-engine デプロイメントスクリプトを続行します。

    (1) Continue setup - oVirt-Engine installation is ready and ovirt-engine service is up

    スクリプトにより、内部認証局のハッシュが表示され、Host-HE1 を追加するクラスターを選択するように要求されます。

    [ INFO  ] Engine replied: DB Up!Welcome to Health Status!
    [ INFO  ] Acquiring internal CA cert from the engine
    [ INFO  ] The following CA certificate is going to be used, please immediately interrupt if not correct:
    [ INFO  ] Issuer: C=US, O=example.com, CN=manager.example.com.23240, Subject: C=US, O=example.com, CN=manager.example.com.23240, Fingerprint (SHA-1): XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
    [ INFO  ] Connecting to the Engine
              Enter the name of the cluster to which you want to add the host (DB1, DB2, Default) [Default]:
    [ INFO  ] Waiting for the host to become operational in the engine. This may take several minutes...
    [ INFO  ] The VDSM Host is now operational
    [ INFO  ] Saving hosted-engine configuration on the shared storage domain
              Please shutdown the VM allowing the system to launch it as a monitored service.
              The system will wait until the VM is down.

16. HostedEngine-VM の終了

    HostedEngine-VM を終了します。

    # shutdown -h now

17. 設定の確認

    Host-HE1 に戻り、HostedEngine-VM のリブートが検出されていることを確認します。

    [ INFO  ] Enabling and starting HA services
    [ INFO  ] Stage: Clean up
    [ INFO  ] Generating answer file '/var/lib/ovirt-hosted-engine-setup/answers/answers-20160509162843.conf'
    [ INFO  ] Generating answer file '/etc/ovirt-hosted-engine/answers.conf'
    [ INFO  ] Stage: Pre-termination
    [ INFO  ] Stage: Termination
    [ INFO  ] Hosted Engine successfully set up

手順5.1 RHEL ベースのセルフホストエンジンのメンテナンス (ローカルメンテナンス)

1. セルフホストエンジン用ホストをローカルメンテナンスモードに切り替えます。
   • 管理ポータルで、ホストをメンテナンスモードに切り替えると、そのホストにローカルメンテナンスモードが自動的にトリガーされます。
   • メンテナンスモードはコマンドラインから設定することもできます。

     # hosted-engine --set-maintenance --mode=local

2. メンテナンスタスクが完了したら、メンテナンスモードを無効にします。

   # hosted-engine --set-maintenance --mode=none

手順5.2 RHEL ベースのセルフホストエンジンのメンテナンス (グローバルメンテナンス)

1. セルフホストエンジン用ホストをグローバルメンテナンスモードに切り替えます。
   • 管理ポータルで、セルフホストエンジン仮想マシンを右クリックして、グローバル HA メンテナンスを有効にする を選択します。
   • メンテナンスモードはコマンドラインから設定することもできます。

     # hosted-engine --set-maintenance --mode=global

2. メンテナンスタスクが完了したら、メンテナンスモードを無効にします。

   # hosted-engine --set-maintenance --mode=none

手順5.3 セルフホストエンジン環境からのホストの削除

1. 管理ポータルで ホスト タブをクリックします。次にホストを選択し、メンテナンス をクリックして、このホストをローカルメンテナンスモードに設定します。このアクションにより、ovirt-ha-agent および ovirt-ha-broker サービスが停止します。
2. ホストにログインして、リブート時にサービスが起動しないように HA サービスを無効にします。

   # systemctl disable ovirt-ha-agent
   # systemctl disable ovirt-ha-broker

3. セルフホストエンジンの設定ファイルを削除します。

   # rm /etc/ovirt-hosted-engine/hosted-engine.conf

4. 管理ポータルで同じホストを選択して 削除 をクリックすると、ホストの削除 の確認ウィンドウが開きます。OK をクリックしてください。

手順5.4 セルフホストエンジンのアップグレード

1. セルフホストエンジンの全ホスト上で、高可用性エージェントを無効にします。これには、クラスター内のいずれかのホストで以下のコマンドを実行します。

   # hosted-engine --set-maintenance --mode=global

   注記

   hosted-engine --vm-status を実行して、環境がメンテナンスモードにあることを確認します。
2. SPM に現在設定されており、Manager 用仮想マシンを含むホストで、必要なリポジトリーを有効にします。

   # subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms

3. Manager 用の仮想マシンで、必要なリポジトリーを有効化します。

   # subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms

4. Manager 用の仮想マシン以外の仮想マシンをすべてを別のホストに移行します。
5. ホストで Manager 用の仮想マシンパッケージを更新します。

   # yum update ovirt-hosted-engine-setup rhevm-appliance

6. Manager 用の仮想マシンをアップグレードするにかアップグレードスクリプトを実行します。標準の Red Hat Enterprise Linux リポジトリーで入手可能な screen パッケージがインストールされていない場合は、インストールします。

   # yum install screen

   # screen

   # hosted-engine --upgrade-appliance

   注記

   アプライアンスが複数検出された場合には移行先のアプライアンスを選択し、Manager データベースののバックアップを作成してその完全パスを指定するように求められます。
7. アップグレードが完了したら、グローバルメンテナンスを無効にします。

   # hosted-engine --set-maintenance --mode=none

手順5.5 セルフホストエンジンのアップグレード

1. 新しい RHVH 4.0 ホストをインストールします。RHVH のインストールの説明は、『インストールガイド』を参照してください。
2. 環境に新規ホストを追加します。

   注記

   Manager 用仮想マシンをホストするには、新規ホストは追加のセルフホストエンジンホストとして追加する必要があります。詳しい情報は「7章セルフホスト環境に追加のホストをインストールする手順」を参照してください。
3. セルフホストエンジンの全ホスト上で、高可用性エージェントを無効にします。これには、クラスター内のいずれかのホストで以下のコマンドを実行します。

   # hosted-engine --set-maintenance --mode=global

   注記

   hosted-engine --vm-status を実行して、環境がメンテナンスモードにあることを確認します。
4. カスタマーポータルから RHV-M Virtual Appliance をダウンロードして、新規ホストにコピーします。
   1. Red Hat カスタマーポータル (https://access.redhat.com) にログインします。
   2. メニューバーの ダウンロード をクリックします。
   3. Red Hat Virtualization > Download Latest をクリックして、製品ダウンロードページにアクセスします。
   4. 正しい Red Hat Virtualization 4.0 を選択して Download Now をクリックします。
   Red Hat Virtualization Host に OVA ファイルをセキュアコピーします。

   scp rhvm-appliance.ova root@host.example.com:/usr/share

5. RHVH 4.0 ホストに Manager 用仮想マシンを移行して、Storage Pool Manager (SPM) としてホストを設定します。
6. Manager 用の仮想マシンで、必要なリポジトリーを有効化します。

   # subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms

7. アップグレードスクリプトを実行して、Manager 用仮想マシンをアップグレードします。screen パッケージがインストールされていない場合にはインストールします。

   # yum install screen

   # screen

   # hosted-engine --upgrade-appliance

   注記

   スクリプトにより、ホストのコピー先の RHV-M Virtual Appliance の場所が尋ねられます。また、Manager データベースのバックアップを作成して、その完全なパスを提供するように求められます。
8. アップグレードが完了したら、グローバルメンテナンスを無効にします。

   # hosted-engine --set-maintenance --mode=none

手順6.3 既存の Red Hat Virtualization Manager のバックアップ

1. フェイルオーバー先のホストの準備

   フェイルオーバーホスト (環境内にあるホストエンジンのホストの 1 つ) は、メンテナンスモードに設定して、バックアップ時に仮想負荷がない状態にします。このホストは後ほど、復元したセルフホストエンジン環境をデプロイする際に使用することができます。今回のシナリオでは、ホストエンジンのホストはどれでもフェイルオーバーホストとして使用することができますが、Host 1 を使用すると、復元のプロセスがより簡単になります。Host 1 ホストのデフォルト名は hosted_engine_1 で、これは、ホストエンジンのデプロイメントスクリプトが最初に実行された際に設定されたものです。
   1. ホストエンジンのホストの 1 つにログインします。
   2. hosted_engine_1 ホストが Host 1 であることを確認します。

       # hosted-engine --vm-status

   3. 管理ポータルにログインします。
   4. ホスト タブをクリックします。
   5. 結果一覧から hosted_engine_1 ホストを選択して、メンテナンス をクリックします。
   6. OK をクリックします。
   ホストの仮想負荷によっては、全仮想マシンが移行されるまでしばらく時間がかかる場合があります。ホストのステータスがMaintenance に変わってから次のステップに進んでください。

2. Manager のバックアップ作成

   Manager 用仮想マシン上で、仮想マシンの構成設定とデータベースの内容をバックアップします。[EngineBackupFile] はバックアップファイルのファイル名に、[LogFILE] はバックアップログのファイル名に置き換えます。

   # engine-backup --mode=backup --file=[EngineBackupFile] --log=[LogFILE]

3. 外部サーバーへのファイルのバックアップ

   外部サーバーにファイルをバックアップします。以下の例では、[Storage.example.com] は、必要になるまでバックアップを格納するネットワークストレージサーバーの完全修飾ドメイン名に、/backup/ は指定したフォルダーまたはパスに置き換えます。仮想マシンの構成設定とデータベースの内容を復元するには、このバックアップファイルにアクセス可能である必要があります。

   # scp -p [EngineBackupFiles] [Storage.example.com:/backup/EngineBackupFiles]

4. フェイルオーバーホストの有効化

   hosted_engine_1 ホストのメンテナンスモードから切り替えます。
   1. 管理ポータルにログインします。
   2. ホスト タブをクリックします。
   3. 結果一覧から hosted_engine_1 を選択します。
   4. アクティブ化 をクリックします。

手順8.1 リモートの PostgreSQL データベースを Red Hat 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 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

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

1. ホストエンジンホストの 1 つにログインして、環境を global メンテナンスモードに指定します。これにより、高可用性のエージェントを無効化して、この手順の実行中に Manager 用仮想マシンが移行されないようにします。

   # hosted-engine --set-maintenance --mode=global

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

   # service ovirt-engine stop

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

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

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

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

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

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

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

   # service ovirt-engine start

8. ホストエンジンのホストにログインして、メンテナンスモードをオフにして、高可用性エージェントを有効にします。

   # hosted-engine --set-maintenance --mode=none

手順8.3 Data Warehouse の別のマシンへの移行

1. 既存のデータベースマシン上で、ovirt_engine_history データベースを SQL スクリプトファイルにダンプします。

   # pg_dump ovirt_engine_history > ovirt_engine_history.sql

2. 既存のデータベースマシンから新規データベースマシンに、このスクリプトファイルをコピーします。
3. 新規データベースマシン上で ovirt_engine_history データベースを復元します。

   # psql -d ovirt_engine_history -f ovirt_engine_history.sql

   上記のコマンドは、新規マシン上のデータベースが ovirt_engine_history という名前であることを前提としています。

手順8.4 ステップ 1: 新規 Data Warehouse マシンの設定

1. コンテンツ配信ネットワークにシステムを登録します。プロンプトが表示されたら、カスタマーポータルのユーザー名とパスワードを入力します。

   # subscription-manager register

2. Red Hat Enterprise Linux Server および Red Hat Virtualization のサブスクリプションプールを見つけて、プール ID を書き留めておきます。

   # subscription-manager list --available

3. 上記のステップで特定したプール ID を使用して、エンタイトルメントをシステムにアタッチします。

   # subscription-manager attach --pool=pool_id

4. 既存のリポジトリーをすべて無効にします。

   # subscription-manager repos --disable=*

5. 必要なチャンネルを有効にします。

   # subscription-manager repos --enable=rhel-7-server-rpms
   # subscription-manager repos --enable=rhel-7-server-supplementary-rpms
   # subscription-manager repos --enable=rhel-7-server-rhv-4.0-rpms
   # subscription-manager repos --enable=jb-eap-7-for-rhel-7-server-rpms

6. 現在インストールされている全パッケージを最新の状態にします。

   # yum update

   注記

   カーネル関連のパッケージを更新した場合には、マシンを再起動してください。
7. ovirt-engine-dwh-setup パッケージをインストールします。

   # yum install ovirt-engine-dwh-setup

手順8.5 ステップ 2: Manager マシン上での Data Warehouse の停止

1. Data Warehouse サービスを停止します。

   # service ovirt-engine-dwhd stop

2. ovirt_engine_history データベース、Manager データベース、または両データベースが Manager マシンでホストされており、以前のバージョン (Red Hat Enterprise Virtualization 3.4 以前) で設定された後にアップグレードされている場合には、新規 Data Warehouse マシンがこれらのデータベースにアクセスできるようにする必要があります。/var/lib/pgsql/data/postgresql.conf ファイルを編集して、以下のようになるように listen_addresses の行を変更します。

   listen_addresses = '*'

   この行が存在しない場合やコメントアウトされている場合には、手動で追加します。
   1 つまたは両データベースがリモートマシンでホストされている場合には、各マシンで postgres.conf ファイルを編集して、上記のように postgres.conf の行を追加し、手動でアクセスを許可する必要があります。両データベースが Manager マシンでホストされており、Red Hat Virtualization Manager の新規セットアップで設定された場合には、デフォルトでアクセスが許可されています。
3. postgresql サービスを再起動します。

   # service postgresql restart

手順8.6 ステップ 3: 新規 Data Warehouse マシンの構成

1. engine-setup コマンドを実行し、そのマシン上で Data Warehouse の設定を開始します。

   # engine-setup

2. Enter を押して Data Warehouse を設定します。

   Configure Data Warehouse on this host (Yes, No) [Yes]:

3. Enter を押してファイアウォールを自動設定するか、No と入力してから Enter を押して現在の設定を維持します。

   Setup can automatically configure the firewall on this system.
   Note: automatic configuration of the firewall may overwrite current settings.
   Do you want Setup to configure the firewall? (Yes, No) [Yes]:

   ファイアウォールの自動設定を選択した場合に、ファイアウォール管理機能がアクティブ化されていなければ、サポートされているオプションのリストから選択するファイアウォール管理機能を指定するように要求されるので、そのファイアウォール管理機能の名前を入力して Enter を押してください。この設定は、オプションが 1 つしかリストされていない場合でも適用されます。
4. Enter を押して自動検出されたホスト名を受け入れるか、別のホスト名を入力して Enter を押します。

   Host fully qualified DNS name of this server [autodetected host name]:

5. ovirt_engine_history データベースの場所に関する以下の質問に回答します。

   Where is the DWH database located? (Local, Remote) [Local]: Remote

   上記のようにもう一方のオプションを入力して Enter を押します。
6. ovirt_engine_history データベースのホストの完全修飾ドメイン名とパスワードを入力します。Enter を押して各フィールドのデフォルト値を受け入れます。

   DWH database host []: dwh-db-fqdn
   DWH database port [5432]: 
   DWH database secured connection (Yes, No) [No]: 
   DWH database name [ovirt_engine_history]: 
   DWH database user [ovirt_engine_history]: 
   DWH database password: password

7. Manager のデータベースマシンの完全修飾ドメイン名とパスワードを入力します。Enter を押して各フィールドのデフォルト値を受け入れます。

   Engine database host []: engine-db-fqdn
   Engine database port [5432]: 
   Engine database secured connection (Yes, No) [No]: 
   Engine database name [engine]: 
   Engine database user [engine]: 
   Engine database password: password

8. Enter を押して既存の Data Warehouse データベースのバックアップを作成します。

   Would you like to backup the existing database before upgrading it? (Yes, No) [Yes]:

   データベースのバックアップに必要な時間と領域は、そのデータベースのサイズにより異なります。完了まで数時間かかる場合もあります。ここでデータベースのバックアップを行わず、何らかの理由で engine-setup が失敗した場合には、データベースまたはその中のデータを復元できません。バックアップファイルの場所は、設定スクリプトの最後に表示されます。
9. Manager から既存の Data Warehouse サービスを完全に切断することを確定します。

   Do you want to permanently disconnect this DWH from the engine? (Yes, No) [No]:

10. インストールの設定を確認します。

    Please confirm installation settings (OK, Cancel) [OK]:

手順8.7 ステップ 4: Manager マシンからの Data Warehouse パッケージの削除

1. Data Warehouse パッケージを削除します。

   # yum remove ovirt-engine-dwh

   この手順は、Data Warehouse サービスが自動的に 1 時間後に再起動を試みないようにします。
2. Data Warehouse ファイルを削除します。

   # rm -rf /etc/ovirt-engine-dwh /var/lib/ovirt-engine-dwh