自承载引擎指南

过程 2.1. 在 RHEV-H 上设置自承载引擎

1. 点 Deploy Hosted Engine。
   

   View larger image

   
2. 指定 Red Hat Enterprise Virtualization Manager 虚拟机的安装方法。如果使用 RHEV-M Virtual Appliance 进行安装，输入 appliance 的 URL，如 http://file.domain.com/rhevm-appliance.ova。这是推荐的安装方法。点 Deploy，再点 Close。
   或者，如果使用 PXE 进行安装，选择 PXE Boot Engine VM。
3. 点 OK 启动 hosted-engine 部署脚本。点 Enter 开始进行安装。
   

   View larger image

   

4. 配置存储

   选择使用的存储类型。

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

   Copy to Clipboard Toggle word wrap
   • 对于 NFS 存储类型，使用 FQDN 或 IP 地址指定它的完整地址，以及共享存储域的路径名。

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

     Copy to Clipboard Toggle word wrap
   • 对于 iSCSI，指定 iSCSI 门户 IP 地址、端口、用户名和密码，并从检测到的列表中选择一个目标名。在部署的过程中只能选项一个 iSCSI 目标：

     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]:

     Copy to Clipboard Toggle word wrap
   • 对于 Gluster 存储类型，使用 FQDN 或 IP 地址指定它的完整地址，以及共享存储域的路径名。

     重要

     当前只支持 3 个 Gluster 存储副本（replica）。请确认已进行了以下配置：

     • 在所有 3 个 Gluster 服务器的 /etc/glusterfs/glusterd.vol 文件中，把 rpc-auth-allow-insecure 设置为 on。

       option rpc-auth-allow-insecure on

       Copy to Clipboard Toggle word wrap
     • 对卷进行以下配置：

       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

       Copy to Clipboard Toggle word wrap

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

     Copy to Clipboard Toggle word wrap
   • 对于光纤通道设备，主机的总线适配器需要被配置和连接，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]:

     Copy to Clipboard Toggle word wrap
   选择环境中使用的存储域和存储数据中心名。

   [ INFO  ] Installing on first host
   Please provide storage domain name. [hosted_storage]: 
   Local storage datacenter name is an internal name and currently will not be shown in engine's admin UI.Please enter local datacenter name [hosted_datacenter]:

   Copy to Clipboard Toggle word wrap

5. 配置网络

   这个脚本会检测可以被用来作为环境的管理网桥的网卡（NIC），然后会检查防火墙的配置，并为控制台（SPICE 或 VNC）访问修改防火墙的配置。

   注意

   当前，还不支持绑定的网络接口以及 vlan-tagged 网络接口。如果需要使用它们，请参阅 https://access.redhat.com/solutions/1417783。

   Please indicate a nic to set rhevm bridge on: (eth1, eth0) [eth1]:
   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]:

   Copy to Clipboard Toggle word wrap

6. 配置虚拟机

   这个脚本会把一个虚拟机配置为 Red Hat Enterprise Virtualization Manager。

   注意

   如需手工安装 Manager 虚拟机，请参阅 附录 A, 手工安装 Manager 的操作系统。使用 appliance，可以简化安装过程，而使用手工安装的方法，可以对安装过程进行完全的控制。

   [ INFO ] Checking OVF archive content (could take a few minutes depending on archive size)
   [ INFO ] Checking OVF XML content (could take a few minutes depending on archive size)
            Would you like to use cloud-init to customize the appliance on the first boot (Yes, No)[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
            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: [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
            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
   [ INFO ] The engine VM will be configured to use 192.168.x.x/24
            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
            Please specify an alias for the Hosted Engine image [hosted_engine]:
            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]: 
            Please specify the console type you would like to use to connect to the VM (vnc, spice) [vnc]: vnc

   Copy to Clipboard Toggle word wrap

7. 配置自承载引擎

   指定 hypervisor 在 Red Hat Enterprise Virtualization 环境中使用的名称，以及 admin@internal 用户用来访问管理门户（ Administration Portal）的密码。为 Manager 虚拟机指定 FQDN。

   Enter the name which will be used to identify this host inside the Administrator Portal [hosted_engine_1]:
   Enter 'admin@internal' user password that will be used for accessing the Administrator Portal: p@ssw0rd
   Confirm 'admin@internal' user password: p@ssw0rd
   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]:

   Copy to Clipboard Toggle word wrap

8. 配置预览

   在实际进行配置前，hosted-engine 脚本会显示已输入的信息，并提示您确认这些信息。

9. 配置 Manager 虚拟机

   这个脚本将创建 Manager 虚拟机，启动 ovirt-engine 和高可用性服务，并把 hypervisor 主机和共享存储域连接到 Manager 虚拟机。

   You can now connect to the VM with the following command:
   	/usr/bin/remote-viewer vnc://localhost:5900
   Use temporary password "3042QHpX" 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/fabbea5a-1989-411f-8ed7-7abe0917fc66.sock,user=ovirt-vmconsole STDIO,raw,echo=0,escape=1
   
   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
   [ INFO ] Running engine-setup on the appliance
   ...
   [ INFO ] Engine-setup successfully completed
   [ INFO ] Engine is still unreachable
   [ INFO ] Engine is still unreachable, waiting...
   [ INFO ] Engine replied: DB Up!Welcome to Health Status!
   [ INFO ] Connecting to the Engine
            Enter the name of the cluster to which you want to add the host (Default) [Default]:
   [ INFO  ] Waiting for the host to become operational in the engine. This may take several minutes... [ INFO  ] Still waiting for VDSM host to become operational...
   [ INFO  ] The VDSM Host is now operational      
   [ INFO  ] Shutting down the engine VM
   [ INFO  ] Enabling and starting HA services
   [ INFO  ] Saving hosted-engine conifguration on the shared storage domain
             Hosted Engine successfully set up
   [ INFO  ] Stage: Clean up
   [ INFO  ] Generating answer file '/var/lib/ovirt-hosted-engine-setup/answers/answers-2015xx.conf'
   [ INFO  ] Generating answer file '/etc/ovirt-hosted-engine/answers.conf'
   [ INFO  ] Stage: Pre-termination
   [ INFO  ] Stage: Termination
   
   [screen is terminating]
   Hit <Return> to return to the TUI

   Copy to Clipboard Toggle word wrap

过程 3.1. 使用 Subscription Manager 订阅所需的权利（Entitlement）

1. 在 Content Delivery Network 中注册您的系统，在出现提示时输入客户门户网站的用户名和密码：

   # subscription-manager register

   Copy to Clipboard Toggle word wrap
2. 找到 Red Hat Enterprise Linux Server 和 Red Hat Enterprise Virtualization 订阅池，并记录下它们的 ID。

   # subscription-manager list --available

   Copy to Clipboard Toggle word wrap
3. 使用在上一步所获得的权利池 ID 把 Red Hat Enterprise Linux Server 和 Red Hat Enterprise Virtualization 的权利附加到系统上。运行以下命令：

   # subscription-manager attach --pool=poolid

   Copy to Clipboard Toggle word wrap
4. 禁用所有存在的软件仓库：

   # subscription-manager repos --disable=*

   Copy to Clipboard Toggle word wrap
5. 启用所需的仓库：
   • Red Hat Enterprise Linux 6:

     重要

     对于 Red Hat Enterprise Linux 6，ovirt-hosted-engine-setup 软件包由 rhel-6-server-rhevm-3.6-rpms 仓库提供。如果您只有一个 Red Hat Enterprise Virtualization 环境，您将需要首先把权利附加到主机。在下载完 ovirt-hosted-engine-setup 软件包后，删除订阅，从而可以把它重新附加给作为 Manager 的虚拟机。如需了解如何删除一个产品订阅的信息，请参阅 https://access.redhat.com/documentation/en-US/Red_Hat_Subscription_Management/1/html/RHSM/sub-cli.html。

     # subscription-manager repos --enable=rhel-6-server-rpms
     # subscription-manager repos --enable=rhel-6-server-optional-rpms
     # subscription-manager repos --enable=rhel-6-server-supplementary-rpms	
     # subscription-manager repos --enable=rhel-6-server-rhev-mgmt-agent-rpms
     # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms

     Copy to Clipboard Toggle word wrap
   • Red Hat Enterprise Linux 7：

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

     Copy to Clipboard Toggle word wrap
6. 确认当前安装的软件包已被升级到最新版本：

   # yum update

   Copy to Clipboard Toggle word wrap

   注意

   如果与内核相关的软件包已被更新，则需要重启机器。

过程 3.2. 安装自承载引擎

1. 安装自承载引擎软件包

   # yum install ovirt-hosted-engine-setup

   Copy to Clipboard Toggle word wrap
2. 如果您选择使用 appliance 来安装 Manager 虚拟机，则需要安装 RHEV-M Virtual Appliance 软件包：

   # yum install rhevm-appliance

   Copy to Clipboard Toggle word wrap
   您也可以使用 CD-ROM、磁盘或 PXE 安装 Manager 的操作系统。物理的 CD-ROM 驱动设备不被支持。

过程 3.3. 配置基于 RHEL 的自承载引擎

1. 初始化引擎

   运行 hosted-engine 脚本。推荐使用 screen 来运行这个脚本。这可以防止，在出现网络问题或终端被非正常终止时丢失当前运行的任务。screen 软件包包括在标准的 Red Hat Enterprise Linux 软件仓库中，安装这个软件包后就可以使用这个工具程序。使用 CTRL+D 键组合可以随时终止脚本。

   # yum install screen

   Copy to Clipboard Toggle word wrap

   # screen hosted-engine --deploy

   Copy to Clipboard Toggle word wrap

   注意

   当网络中断或超时时，可以运行 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]:

   Copy to Clipboard Toggle word wrap
   • 对于 NFS 存储类型，使用 FQDN 或 IP 地址指定它的完整地址，以及共享存储域的路径名。

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

     Copy to Clipboard Toggle word wrap
   • 对于 iSCSI，指定 iSCSI 门户 IP 地址、端口、用户名和密码，并从检测到的列表中选择一个目标名。在部署的过程中只能选项一个 iSCSI 目标：

     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]:

     Copy to Clipboard Toggle word wrap
   • 对于 Gluster 存储类型，使用 FQDN 或 IP 地址指定它的完整地址，以及共享存储域的路径名。

     重要

     当前只支持 3 个 Gluster 存储副本（replica）。请确认已进行了以下配置：

     • 在所有 3 个 Gluster 服务器的 /etc/glusterfs/glusterd.vol 文件中，把 rpc-auth-allow-insecure 设置为 on。

       option rpc-auth-allow-insecure on

       Copy to Clipboard Toggle word wrap
     • 对卷进行以下配置：

       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

       Copy to Clipboard Toggle word wrap

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

     Copy to Clipboard Toggle word wrap
   • 对于光纤通道设备，主机的总线适配器需要被配置和连接，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]:

     Copy to Clipboard Toggle word wrap
   选择环境中使用的存储域和存储数据中心名。

   [ INFO  ] Installing on first host
   Please provide storage domain name. [hosted_storage]: 
   Local storage datacenter name is an internal name and currently will not be shown in engine's admin UI.Please enter local datacenter name [hosted_datacenter]:

   Copy to Clipboard Toggle word wrap

3. 配置网络

   这个脚本会检测可以被用来作为环境的管理网桥的网卡（NIC），然后会检查防火墙的配置，并为控制台（SPICE 或 VNC）访问修改防火墙的配置。

   注意

   当前，还不支持绑定的网络接口以及 vlan-tagged 网络接口。如果需要使用它们，请参阅 https://access.redhat.com/solutions/1417783。

   Please indicate a nic to set rhevm bridge on: (eth1, eth0) [eth1]:
   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]:

   Copy to Clipboard Toggle word wrap

4. 配置虚拟机

   注意

   如需手工安装 Manager 虚拟机，请参阅 附录 A, 手工安装 Manager 的操作系统。使用 appliance，可以简化安装过程，而使用手工安装的方法，可以对安装过程进行完全的控制。
   选择 disk 作为引导设备类型，脚本会自动检测到可用的 RHEV-M Appliances。指定内存的大小。

            Please specify the device to boot the VM from (cdrom, disk, pxe) [disk]: 
   [ 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)
   	       Please specify the memory size of the appliance in MB (Defaults to OVF value: 16384):

   Copy to Clipboard Toggle word wrap
   如果使用 cloud-init 对 Manager 虚拟机进行初始设置，则选 Yes。选择 Generate 来使用 cloud-init 进行配置，如设置 root 密码、配置网络、配置主机名、为 engine-setup 提供使用的应答文件、在引导时运行 engine-setup。另外，如果已有存在的 cloud-init 脚本，则可以选择 Existing 来使用这个脚本。指定 Manager 虚拟机的 FQDN。为 HostedEngine-VM 指定一个 MAC 地址，或使用随机推荐的地址。您可以在虚拟机安装操作系统前，使用这个 MAC 地址更新您的 DHCP 和 DNS 服务器。

   注意

   如需了解更多与 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
   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: [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
   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
   Please specify an alias for the Hosted Engine image [hosted_engine]:
   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]: 
   Please specify the console type you would like to use to connect to the VM (vnc, spice) [vnc]: vnc

   Copy to Clipboard Toggle word wrap

5. 配置引擎

   指定在管理门户中标识 hypervisor 主机的名称，以及访问管理门户所使用的 admin@internal 用户的密码。提供 HostedEngine-VM 的 FQDN（在这里我们使用 Manager.example.com 作为 FQDN）。为 SMTP 服务器提供名称和 TCP 端口号、发送事件通知的电子邮件地址、以及需要接收事件通知的用户的电子邮件地址列表（以逗号分隔）。

   Enter the name which will be used to identify this host inside the Administrator Portal [hosted_engine_1]:
   Enter 'admin@internal' user password that will be used for accessing the Administrator Portal: p@ssw0rd
   Confirm 'admin@internal' user password: p@ssw0rd
   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]:

   Copy to Clipboard Toggle word wrap

6. 配置预览

   在实际进行配置前，hosted-engine 脚本会显示已输入的信息，并提示您确认这些信息。

7. 配置 Manager 虚拟机

   这个脚本将创建 Manager 虚拟机，启动 ovirt-engine 和高可用性服务，并把 hypervisor 主机和共享存储域连接到 Manager 虚拟机。

   You can now connect to the VM with the following command:
   	/usr/bin/remote-viewer vnc://localhost:5900
   Use temporary password "3042QHpX" 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/fabbea5a-1989-411f-8ed7-7abe0917fc66.sock,user=ovirt-vmconsole STDIO,raw,echo=0,escape=1
   
   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
   [ INFO ] Running engine-setup on the appliance
   ...
   [ INFO ] Engine-setup successfully completed
   [ INFO ] Engine is still unreachable
   [ INFO ] Engine is still unreachable, waiting...
   [ INFO ] Engine replied: DB Up!Welcome to Health Status!
   [ INFO ] Connecting to the Engine
            Enter the name of the cluster to which you want to add the host (Default) [Default]:
   [ INFO  ] Waiting for the host to become operational in the engine. This may take several minutes... [ INFO  ] Still waiting for VDSM host to become operational...
   [ INFO  ] The VDSM Host is now operational      
   [ INFO  ] Shutting down the engine VM
   [ INFO  ] Enabling and starting HA services
   [ INFO  ] Saving hosted-engine conifguration on the shared storage domain
             Hosted Engine successfully set up
   [ INFO  ] Stage: Clean up
   [ INFO  ] Generating answer file '/var/lib/ovirt-hosted-engine-setup/answers/answers-2015xx.conf'
   [ INFO  ] Generating answer file '/etc/ovirt-hosted-engine/answers.conf'
   [ INFO  ] Stage: Pre-termination
   [ INFO  ] Stage: Termination

   Copy to Clipboard Toggle word wrap

过程 4.1. 迁移到自承载环境

1. 初始化引擎

   运行 hosted-engine 脚本。推荐使用 screen 来运行这个脚本，这可以防止，在出现网络问题或终端被非正常终止时丢失当前运行的任务。screen 软件包包括在标准的 Red Hat Enterprise Linux 软件仓库中，安装这个软件包后就可以使用这个工具程序。使用 CTRL+D 键组合可以随时终止脚本。

   # yum install screen

   Copy to Clipboard Toggle word wrap

   # screen hosted-engine --deploy

   Copy to Clipboard Toggle word wrap

   注意

   当网络中断或超时时，可以运行 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]:

   Copy to Clipboard Toggle word wrap
   • 对于 NFS 存储类型，使用 FQDN 或 IP 地址指定它的完整地址，以及共享存储域的路径名。

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

     Copy to Clipboard Toggle word wrap
   • 对于 iSCSI，指定 iSCSI 门户 IP 地址、端口、用户名和密码，并从检测到的列表中选择一个目标名。在部署的过程中只能选项一个 iSCSI 目标：

     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]:

     Copy to Clipboard Toggle word wrap
   • 对于 Gluster 存储类型，使用 FQDN 或 IP 地址指定它的完整地址，以及共享存储域的路径名。

     重要

     当前只支持 3 个 Gluster 存储副本（replica）。请确认已进行了以下配置：

     • 在所有 3 个 Gluster 服务器的 /etc/glusterfs/glusterd.vol 文件中，把 rpc-auth-allow-insecure 设置为 on。

       option rpc-auth-allow-insecure on

       Copy to Clipboard Toggle word wrap
     • 对卷进行以下配置：

       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

       Copy to Clipboard Toggle word wrap

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

     Copy to Clipboard Toggle word wrap
   • 对于光纤通道设备，主机的总线适配器需要被配置和连接，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]:

     Copy to Clipboard Toggle word wrap
   选择环境中使用的存储域和存储数据中心名。

   [ INFO  ] Installing on first host
   Please provide storage domain name. [hosted_storage]: 
   Local storage datacenter name is an internal name and currently will not be shown in engine's admin UI.Please enter local datacenter name [hosted_datacenter]:

   Copy to Clipboard Toggle word wrap

3. 配置网络

   这个脚本会检测可以被用来对环境进行管理的网卡（NIC），然后会检查防火墙的配置，并根据控制台（SPICE 或 VNC）访问 HostedEngine-VM 的需要来修改防火墙的配置。另外，提供一个可以被 ping 到的网络 IP 地址，ovirt-ha-agent 会使用它来决定 HostedEngine-VM 是否在正常运行。

   Please indicate a nic to set rhevm 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]:

   Copy to Clipboard Toggle word wrap

4. 配置虚拟机

   脚本会创建一个虚拟机，并把它配置为一个 Red Hat Enterprise Virtualization Manager（在这里被称为 HostedEngine-VM）。指定引导设备、安装介质的路径名、CPU 类型、虚拟 CPU 的数量以及磁盘的大小。为 HostedEngine-VM 指定一个 MAC 地址，或使用系统自动创建的地址。在虚拟机安装操作系统前，可以使用这个 MAC 地址更新 DHCP 服务器。为 HostedEngine-VM 指定内存的大小，以及控制器连接类型。

   Please specify the device to boot the VM from (cdrom, disk, pxe) [cdrom]: 
   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 minimum requirement: 2]: 
   Please specify the disk size of the VM in GB [Defaults to minimum requirement: 25]: 
   You may specify a 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 minimum requirement: 4096]: 
   Please specify the console type you want to use to connect to the VM (vnc, spice) [vnc]:

   Copy to Clipboard Toggle word wrap

5. 配置引擎

   指定在 Red Hat Enterprise Virtualization 环境中标识 Host-HE1 的名称，以及访问管理门户所使用的 admin@internal 用户的密码。提供 HostedEngine-VM 的 FQDN（在这里我们使用 Manager.example.com 作为 FQDN）。最后，提供 SMTP 的名称和 TCP 端口号、发送事件通知的电子邮件地址、以及需要接收事件通知的用户的电子邮件地址列表（以逗号分隔）。

   重要

   引擎的 FQDN 必须和 BareMetal-Manager 在初始设置时提供的 FQDN 相同。

   Enter the name which will be used to identify this host inside the Administrator Portal [hosted_engine_1]: Host-HE1
   Enter 'admin@internal' user password that will be used for accessing the Administrator Portal: 
   Confirm 'admin@internal' user password: 
   Please provide the FQDN for the engine you want to use. This needs to match the FQDN that you will use for the engine installation within the VM: 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]:

   Copy to Clipboard Toggle word wrap

6. 配置预览

   在实际进行配置前，hosted-engine 脚本会显示已输入的信息，并提示您确认这些信息。

   Bridge interface                   : eth1
   Engine FQDN                        : manager.example.com
   Bridge name                        : rhevm
   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                      : 25
   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)[No]:

   Copy to Clipboard Toggle word wrap

7. 配置 HostedEngine-VM

   这个脚本会创建虚拟机 HostedEngine-VM，并提供和它进行连接的详情信息。您需要在 HostedEngine-VM 上安装一个操作系统后才能继续在 Host-HE1 上执行 hosted-engine 脚本。

   [ INFO  ] Stage: Transaction setup
   ...
   [ INFO  ] Creating VM
   You can now connect to the VM with the following command:
   	/usr/bin/remote-viewer vnc://localhost:5900
   Use temporary password "5379skAb" 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 console using the following command:
   virsh -c qemu+tls://Test/system console HostedEngine
   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
   The VM has been started.  Install the OS and shut down or reboot it.  To continue please make a selection:
            
             (1) Continue setup - VM installation is complete
             (2) Reboot the VM and restart installation
             (3) Abort setup
             (4) Destroy VM and abort setup
            
             (1, 2, 3, 4)[1]:

   Copy to Clipboard Toggle word wrap
   运行以下命令使用 VNC 协议连接到虚拟机。使用自承载引擎主机的 FQDN 或 IP 地址替换其中的 FQDN。

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

   Copy to Clipboard Toggle word wrap

8. 安装虚拟机操作系统

   连接到 hosted-engine 脚本所创建的虚拟机（HostedEngine-VM），安装 Red Hat Enterprise Linux 6.7 操作系统。

9. 同步主机和虚拟机

   返回到 Host-HE1，选择选项 1 来继续 hosted-engine 脚本：

   (1) Continue setup - VM installation is complete

   Copy to Clipboard Toggle word wrap

10. 安装 Manager

    连接到 HostedEngine-VM，订阅相关的 Red Hat Enterprise Virtualization Manager 仓库（repository）。详情请参阅安装指南中的 订阅所需的权利。
    确认所有安装的软件包都是最新版本，并安装了 rhevm 软件包。

    # yum update

    Copy to Clipboard Toggle word wrap

    # yum install rhevm

    Copy to Clipboard Toggle word wrap

11. 禁用 BareMetal-Manager

    连接到 BareMetal-Manager，停止引擎并禁止它在系统引导时运行。

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

    Copy to Clipboard Toggle word wrap

    注意

    推荐停止运行 BareMetal-Manager，这可以确保在系统备份被创建后，不会再对虚拟环境进行改变。另外，它还可以防止 BareMetal-Manager 和 HostedEngine-VM 同时管理存在的资源。

12. 更新 DNS

    更新您的 DNS，从而使 Red Hat Enterprise Virtualization 环境的 FQDN 可以正确地解析 HostedEngine-VM 的 IP 地址，以及在 Host-HE1 上配置 hosted-engine 部署脚本所提供的 FQDN。在这里，FQDN 被设置为 manager.example.com，因为所提供引擎的 FQDN 和新设置引擎的 FQDN 必须相同。

13. 为 BareMetal-Manager 创建一个备份

    连接到 BareMetal-Manager，运行 engine-backup 命令。使用 --mode=backup、--file=FILE 和 --log=LogFILE 参数来分别指定备份的模式、备份文件的名称以及日志文件的名称。

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

    Copy to Clipboard Toggle word wrap

14. 把备份文件复制到 HostedEngine-VM

    登录到 BareMetal-Manager，把备份文件复制到 HostedEngine-VM 上。在以下的例子中，[manager.example.com] 是 HostedEngine-VM 的 FQDN，/backup/ 是备份文件要被复制到的目录或路径。如果这些目录和路径还没有存在，您需要登录到 HostedEngine-VM 上后创建它们。

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

    Copy to Clipboard Toggle word wrap

15. 在 HostedEngine-VM 上恢复备份文件

    参阅 第 6.3 节 “恢复自承载引擎 Manager”。因为已在前面的步骤中进行了，所以请跳过恢复过程中的 Copying the Backup Files to the New Manager 一步。在运行 engine-setup 后返回这个过程。

16. 把主机和 Manager 进行同步

    返回到 Host-HE1，选择选项 1 来继续 hosted-engine 脚本：

    (1) Continue setup - engine installation is complete

    Copy to Clipboard Toggle word wrap

    [ INFO  ] Engine replied: DB Up!Welcome to Health Status!
    [ INFO  ] Waiting for the host to become operational in the engine. This may take several minutes...
    [ INFO  ] Still waiting for VDSM host to become operational...
    [ INFO  ] The VDSM Host is now operational
              Please shutdown the VM allowing the system to launch it as a monitored service.
              The system will wait until the VM is down.

    Copy to Clipboard Toggle word wrap

17. 关闭 HostedEngine-VM

    关闭 HostedEngine-VM。

    # shutdown -h now

    Copy to Clipboard Toggle word wrap

18. 设置确认

    返回到 Host-HE1，确认它检测到 HostedEngine-VM 已经被关闭。

    [ INFO  ] Enabling and starting HA services
              Hosted Engine successfully set up
    [ INFO  ] Stage: Clean up
    [ INFO  ] Stage: Pre-termination
    [ INFO  ] Stage: Termination

    Copy to Clipboard Toggle word wrap

过程 5.1. 升级自承载引擎

1. 访问管理门户。选择 Host A，点维护把它设为维护模式。如果 Manager 所在的虚拟机运用于 Host A，这个虚拟机会被迁移到 Host B。
2. 在 Host A 上启用新的仓库。

   # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms

   Copy to Clipboard Toggle word wrap
3. 更新 Host A.

   # yum update

   Copy to Clipboard Toggle word wrap
4. 在 Host A 上重启 VDSM。

   # systemctl restart vdsmd

   Copy to Clipboard Toggle word wrap
5. 在 Host A 上重启 ovirt-ha-broker 和 ovirt-ha-agent。

   # systemctl restart ovirt-ha-broker

   Copy to Clipboard Toggle word wrap

   # systemctl restart ovirt-ha-agent

   Copy to Clipboard Toggle word wrap
6. 访问管理门户。选择 Host A，点激活按钮激活它。
7. 在 Host A 上禁用旧的仓库。

   # subscription-manager repos --disable=rhel-6-server-rhevm-3.5-rpms

   Copy to Clipboard Toggle word wrap
8. 当 Host A 的状态变为 Up 时，选 Host B，点维护把它设为维护模式。这将把运行 Manager 的虚拟机迁移到 Host A。
9. 在 Host B 上启用新的仓库。

   # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms

   Copy to Clipboard Toggle word wrap
10. 更新 Host B。

    # yum update

    Copy to Clipboard Toggle word wrap
11. 在 Host B 上重启 VDSM。

    # systemctl restart vdsmd

    Copy to Clipboard Toggle word wrap
12. 在 Host B 上重启 ovirt-ha-broker 和 ovirt-ha-agent。

    # systemctl restart ovirt-ha-broker

    Copy to Clipboard Toggle word wrap

    # systemctl restart ovirt-ha-agent

    Copy to Clipboard Toggle word wrap
13. 访问管理门户。选择 Host B，点激活按钮激活它。
14. 在 Host B 上禁用旧的仓库。

    # subscription-manager repos --disable=rhel-6-server-rhevm-3.5-rpms

    Copy to Clipboard Toggle word wrap
15. 登录到 Manager 虚拟机来升级 Red Hat Enterprise Virtualization Manager。
    1. 在 Red Hat Enterprise Virtualization Manager 所在的系统上订阅提供 Red Hat Enterprise Virtualization Manager 3.6 软件包的权利：

       # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms

       Copy to Clipboard Toggle word wrap
    2. 更新基本操作系统，确保您使用最新版本的 engine-setup：

       # yum update

       Copy to Clipboard Toggle word wrap
    3. 运行 engine-setup 命令并根据提示升级 Red Hat Enterprise Virtualization Manager。

       # engine-setup

       Copy to Clipboard Toggle word wrap
    4. 删除或禁用 Red Hat Enterprise Virtualization Manager 3.5 的频道，确保系统不再使用 Red Hat Enterprise Virtualization Manager 3.5 软件包：

       # subscription-manager repos --disable=rhel-6-server-rhevm-3.5-rpms

       Copy to Clipboard Toggle word wrap
16. 访问管理门户。
    1. 选择 Default 集群，点编辑打开编辑集群窗口。
    2. 在兼容版本下拉菜单中选择 3.6。点确定保存所做的修改并关闭窗口。

过程 5.2. 升级额外的主机

1. 访问管理门户。选择主机，点维护按钮把它设为维护模式。这可以确保此主机不运行 Manager 虚拟机，hosted-engine 守护进程自动进入本地维护模式。
2. 在主机上启用新的仓库

   # subscription-manager repos --enable=rhel-7-server-rhevm-3.6-rpms

   Copy to Clipboard Toggle word wrap
3. 更新主机。

   # yum update

   Copy to Clipboard Toggle word wrap
4. 在主机上重启 VDSM。

   # service vdsmd restart

   Copy to Clipboard Toggle word wrap
5. 在主机上重启 ovirt-ha-broker 和 ovirt-ha-agent。

   # service ovirt-ha-broker restart

   Copy to Clipboard Toggle word wrap

   # service ovirt-ha-agent restart

   Copy to Clipboard Toggle word wrap
6. 访问管理门户。选择主机，点激活按钮激活它。
7. 禁用主机上的旧仓库。

   # subscription-manager repos --disable=rhel-7-server-rhevm-3.6-rpms

   Copy to Clipboard Toggle word wrap

过程 5.3. 从自承载引擎环境中删除一个主机

1. 在管理门户中，点主机资源标签页。选择主机并点维护把这个主机设置为本地维护模式。这会停止 ovirt-ha-agent 服务和 ovirt-ha-broker 服务。
2. 登录到主机，禁用 HA 服务，并使这个服务不会在系统重启时被启动：
   • Red Hat Enterprise Linux 6：

     # chkconfig ovirt-ha-agent off
     # chkconfig ovirt-ha-broker off

     Copy to Clipboard Toggle word wrap
   • Red Hat Enterprise Linux 7：

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

     Copy to Clipboard Toggle word wrap
3. 删除自承载引擎配置文件：
   • 基于 RHEL 的 hypervisor：

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

     Copy to Clipboard Toggle word wrap
   • RHEV-H:

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

     Copy to Clipboard Toggle word wrap
4. 在管理门户中，选择相同的主机，点删除打开删除主机确认窗口。点确定。

过程 6.1. 备份原始的 Red Hat Enterprise Virtualization Manager

1. 准备故障转移主机（failover host）

   故障转移主机（一个可以运行引擎的主机）需要被设置为维护模式，从而保证在备份时它没有运行虚拟机。这个主机在以后可以被用来部署恢复的自承载引擎环境。任何一个可以运行引擎的主机都可以作为一个故障转移主机，但是使用 Host 1 会使恢复的过程更加直接。Host 1 主机的默认名是 hosted_engine_1，它在 hosted-engine 部署脚本初始运行时被设置。
   1. 登录到可以运行引擎的一个主机上。
   2. 确认 hosted_engine_1 主机是 Host 1；

       # hosted-engine --vm-status

      Copy to Clipboard Toggle word wrap
   3. 登录到管理门户。
   4. 选择主机标签页。
   5. 在结果列表中选 hosted_engine_1 主机，点维护。
   6. 点 确定。

2. 禁用高可用性代理

   在主机上禁用高可用性代理，这可以防止在进行备份的过程中发生 Red Hat Enterprise Virtualization Manager 虚拟机迁移操作。在管理门户中，点虚拟机资源标签页。在引擎虚拟机图标上点鼠标右键，选择启用全局 HA 维护把所有主机都设置为全局维护模式。

3. 创建一个 Manager 的备份

   在 Manager 虚拟机上，备份配置设置和数据库的内容。把 [EngineBackupFile] 替换为备份文件的文件名；把 [LogFILE] 替换为备份日志文件的文件名。

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

   Copy to Clipboard Toggle word wrap

4. 把备份文件复制到一个外部的服务器上

   把备份文件通过安全的方式复制到一个外部的服务器上。在以下的例子中，[Storage.example.com] 是保存备份文件的一个网络存储服务器的完全限定域名；/backup/ 是保存备份文件的目录或路径。虽然这一步并不是必需的，但您需要保证，在恢复配置和数据库内容时可以访问到备份文件。

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

   Copy to Clipboard Toggle word wrap

5. 启用高可用性代理

   在管理门户中，点虚拟机资源标签页。在引擎虚拟机图标上点鼠标右键，选择禁用全局 HA 维护来关闭全局维护模式。这将启用高可用性代理。

6. 激活故障转移主机

   取消 hosted_engine_1 主机的维护模式。
   1. 登录到管理门户。
   2. 选择主机标签页。
   3. 在结果列表中选 hosted_engine_1。
   4. 点激活。

过程 6.2. 创建一个新的自承载环境作为恢复的环境

1. 更新 DNS

   更新 DNS，使 Red Hat Enterprise Virtualization 环境的完全限定域名与新 Manager 的 IP 地址相对应。在以下过程中，完全限定域名被设置为 Manager.example.com。引擎的完全限定域名需要和在设置被备份的原始引擎时使用的值相同。

2. 初始化引擎

   在新安装的 Red Hat Enterprise Linux 主机上运行 hosted-engine 脚本开始部署的过程。您可以在任何时候使用 CTRL+D 键终止部署的过程。

   # hosted-engine --deploy

   Copy to Clipboard Toggle word wrap
   如果需要通过网络运行 hosted-engine 部署脚本，我们推荐使用 screen 窗口管理程序。使用它可以在出现网络问题时保持当前运行的进程。如果还没有安装 screen，请先安装这个软件包。

   # screen hosted-engine --deploy

   Copy to Clipboard Toggle word wrap

3. 准备初始化

   脚本开始会要求您确认在自承载引擎环境中作为虚拟机管理程序（hypervisor）的主机信息。

   Continuing will configure this host for serving as hypervisor and create a VM where you have to install oVirt Engine afterwards. 
   Are you sure you want to continue? (Yes, No)[Yes]:

   Copy to Clipboard Toggle word wrap

4. 配置存储

   选择使用的存储类型。

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

   Copy to Clipboard Toggle word wrap
   • 对于 NFS 存储类型，使用 FQDN 或 IP 地址指定它的完整地址，以及共享存储域的路径名。

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

     Copy to Clipboard Toggle word wrap
   • 对于 iSCSI，指定 iSCSI 门户 IP 地址、端口、用户名和密码，并从检测到的列表中选择一个目标名：

     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]:

     Copy to Clipboard Toggle word wrap

   选择环境中使用的存储域和存储数据中心名。

   [ INFO  ] Installing on first host
   Please provide storage domain name. [hosted_storage]: 
   Local storage datacenter name is an internal name and currently will not be shown in engine's admin UI.Please enter local datacenter name [hosted_datacenter]:

   Copy to Clipboard Toggle word wrap

5. 配置网络

   这个脚本会检索可以作为环境的管理网桥的网卡（NIC），然后检查防火墙的配置，并根据控制台（SPICE 或 VNC）访问 Manager 虚拟机的需要来修改防火墙的配置。另外，它还需要一个可以被 ping 到的网关 IP 地址，ovirt-ha-agent 会使用它来决定主机是否适合运行 Manager 虚拟机。

   Please indicate a nic to set rhevm 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]:
   

   Copy to Clipboard Toggle word wrap

6. 配置新的 Manager 虚拟机

   这个脚本会创建一个新的 Manager 虚拟机。根据具体情况指定引导设备、安装媒体的路径名、镜像别名、CPU 类型、虚拟 CPU 的数量以及磁盘的大小。为 Manager 虚拟机指定一个 MAC 地址，或使用系统自动创建的地址。在为 Manager 虚拟机安装操作系统前，这个 MAC 地址可以被用来更新 DHCP 服务器。为所创建的 Manager 虚拟机指定内存的大小和控制台连接类型。

   Please specify the device to boot the VM from (cdrom, disk, pxe) [cdrom]: 
   Please specify an alias for the Hosted Engine image [hosted_engine]:  
   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 minimum requirement: 2]: 
   Please specify the disk size of the VM in GB [Defaults to minimum requirement: 25]: 
   You may specify a 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 minimum requirement: 4096]: 
   Please specify the console type you want to use to connect to the VM (vnc, spice) [vnc]:
   

   Copy to Clipboard Toggle word wrap

7. 指定主机的名称

   为主机提供一个唯一的名称，避免与从备份中恢复的名称冲突。hosted_engine_1 这个名称可以在此使用，因为在进行备份前，这个主机已被设置为维护模式，它会在恢复引擎操作和在主机与引擎进行最后的同步操作间被删除。

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

   Copy to Clipboard Toggle word wrap

8. 配置引擎

   为自承载环境指定一个名称，为访问管理门户的 admin@internal 用户设定一个密码。提供新的 Manager 虚拟机的完全限定域名。在这里使用 Manager.example.com 作为完全限定域名。指定 SMTP 服务器的名称、TCP 端口号、发送通知电子邮件的电邮地址、接收通知的一组电邮地址（以逗号分隔）。

   重要

   为引擎提供的完全限定域名（Manager.example.com）必须和初始设置原始 Manager 时提供的完全限定域名相同。

   Enter 'admin@internal' user password that will be used for accessing the Administrator Portal: 
   Confirm 'admin@internal' user password: 
   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]:

   Copy to Clipboard Toggle word wrap

9. 配置预览

   在实际进行配置前，hosted-engine 脚本会显示您已输入的信息，并提示您确认这些信息。

   Bridge interface                   : eth1
   Engine FQDN                        : Manager.example.com
   Bridge name                        : rhevm
   SSH daemon port                    : 22
   Firewall manager                   : iptables
   Gateway address                    : X.X.X.X
   Host name for web application      : hosted_engine_1
   Host ID                            : 1
   Image alias                        : hosted_engine
   Image size GB                      : 25
   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]:
   

   Copy to Clipboard Toggle word wrap

10. 创建新的 Manager 虚拟机

    这个脚本创建的虚拟机会被配置为 Manager 虚拟机，并提供和它进行连接的详情信息。在 hosted-engine 脚本可以继续配置引擎前，您需要在这个虚拟机上安装一个操作系统 。

    [ INFO  ] Stage: Transaction setup
    [ INFO  ] Stage: Misc configuration
    [ INFO  ] Stage: Package installation
    [ INFO  ] Stage: Misc configuration
    [ INFO  ] Configuring libvirt
    [ INFO  ] Configuring VDSM
    [ INFO  ] Starting vdsmd
    [ INFO  ] Waiting for VDSM hardware info
    [ INFO  ] Waiting for VDSM hardware info
    [ INFO  ] Configuring the management bridge
    [ INFO  ] Creating Storage Domain
    [ INFO  ] Creating Storage Pool
    [ INFO  ] Connecting Storage Pool
    [ INFO  ] Verifying sanlock lockspace initialization
    [ INFO  ] Creating VM Image
    [ INFO  ] Disconnecting Storage Pool
    [ INFO  ] Start monitoring domain
    [ INFO  ] Configuring VM
    [ INFO  ] Updating hosted-engine configuration
    [ INFO  ] Stage: Transaction commit
    [ INFO  ] Stage: Closing up
    [ INFO  ] Creating VM
    You can now connect to the VM with the following command:
          /usr/bin/remote-viewer vnc://localhost:5900
    Use temporary password "3477XXAM" 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 console using the following command:
    virsh -c qemu+tls://Test/system console HostedEngine
    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
    The VM has been started.  Install the OS and shut down or reboot it.  To continue please make a selection:
             
      (1) Continue setup - VM installation is complete
      (2) Reboot the VM and restart installation
      (3) Abort setup
      (4) Destroy VM and abort setup
             
      (1, 2, 3, 4)[1]:

    Copy to Clipboard Toggle word wrap
    使用以下命令通过 VNC 连接到虚拟机：

    /usr/bin/remote-viewer vnc://hosted_engine_1.example.com:5900

    Copy to Clipboard Toggle word wrap

11. 安装虚拟机操作系统

    连接到 Manager 虚拟机，安装 Red Hat Enterprise Linux 6.5、6.6 或 6.7 操作系统。

12. 把主机和 Manager 进行同步

    返回到主机，选择选项 1 来继续 hosted-engine 脚本：

    (1) Continue setup - VM installation is complete

    Copy to Clipboard Toggle word wrap

    Waiting for VM to shut down...
    [ INFO  ] Creating VM
    You can now connect to the VM with the following command:
          /usr/bin/remote-viewer vnc://localhost:5900
    Use temporary password "3477XXAM" 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 console using the following command:
    virsh -c qemu+tls://Test/system console HostedEngine
    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.
    To continue make a selection from the options below:
      (1) Continue setup - engine installation is complete
      (2) Power off and restart the VM
      (3) Abort setup
      (4) Destroy VM and abort setup
             
      (1, 2, 3, 4)[1]:

    Copy to Clipboard Toggle word wrap

13. 安装 Manager

    连接到新的 Manager 虚拟机，确认所有安装的软件包都是最新版本，安装 rhevm 软件包。

    # yum update

    Copy to Clipboard Toggle word wrap

    # yum install rhevm

    Copy to Clipboard Toggle word wrap

14. 安装 Reports 和 Data Warehouse

    如果您同时需要恢复 Reports 和 Data Warehouse，则需要安装 rhevm-reports-setup 和 rhevm-dwh-setup 软件包。

    # yum install rhevm-reports-setup rhevm-dwh-setup

    Copy to Clipboard Toggle word wrap

过程 6.3. 恢复自承载引擎 Manager

1. 手工创建一个空的数据库来保存从备份中恢复的数据库内容。以下操作需要在数据库所在的机器上执行。
   1. 如果数据库不在 Manager 虚拟机上，则需要安装 postgresql-server 软件包。如果虚拟机位于 Manager 所在的虚拟机上，则不需要进行这一步，因为这个软件包已包括在 rhevm 软件包中。

      # yum install postgresql-server

      Copy to Clipboard Toggle word wrap
   2. 初始化 postgresql 数据库，启动 postgresql 服务，把它设置为在系统引导时被自动启动：

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

      Copy to Clipboard Toggle word wrap
   3. 进入 postgresql 命令行：

      # su postgres
      $ psql

      Copy to Clipboard Toggle word wrap
   4. 创建 engine 用户：

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

      Copy to Clipboard Toggle word wrap
      如果您还需要恢复 Reports 和 Data Warehouse，在相关的主机上创建 ovirt_engine_reports 和 ovirt_engine_history 用户：

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

      Copy to Clipboard Toggle word wrap

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

      Copy to Clipboard Toggle word wrap
   5. 创建新数据库：

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

      Copy to Clipboard Toggle word wrap
      如果您还需要恢复 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';

      Copy to Clipboard Toggle word wrap

      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';

      Copy to Clipboard Toggle word wrap
   6. 退出 postgresql 命令行并登出 postgres 用户：

      postgres=# \q
      $ exit

      Copy to Clipboard Toggle word wrap
   7. 编辑 /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

        Copy to Clipboard Toggle word wrap
      • 对于每个远程数据库：
        • 在文件底部的、以 Local 开头的行下面添加以下行，用 Red Hat Enterprise Virtualization Manager 的 IP 地址替换 X.X.X.X：

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

          Copy to Clipboard Toggle word wrap
        • 允许 TCP/IP 到数据库的连接。编辑 /var/lib/pgsql/data/postgresql.conf 文件，添加以下行：

          listen_addresses='*'

          Copy to Clipboard Toggle word wrap
          在这个例子中，postgresql 服务被配置为监听所有接口上的连接。您可以使用 IP 地址来指定只监听特定接口上的连接。
        • 修改防火墙规则来打开 PostgreSQL 数据库连接所使用的默认端口，然后保存更新的防火墙规则：

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

          Copy to Clipboard Toggle word wrap
   8. 重启 postgresql 服务：

      # service postgresql restart

      Copy to Clipboard Toggle word wrap

2. 把备份文件复制到新的 Manager 所在的机器上

   把备份文件安全地复制到新的 Manager 虚拟机上。此例会把文件从一个网络存储服务器复制到 第 6.1 节 “备份自承载引擎 Manager 虚拟机” 所复制的文件中。Storage.example.com 是存储服务器的完全限定域名；/backup/EngineBackupFiles 是备份文件在存储服务器上的文件路径；/backup/ 是文件要被复制到的、在新 Manager 机器上的文件路径。

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

   Copy to Clipboard Toggle word wrap
3. 恢复一个完整备份或数据库备份（通过 --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

     Copy to Clipboard Toggle word wrap
     如果需要恢复作为完全备份一部分的 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

     Copy to Clipboard Toggle word wrap
   • 恢复数据库备份会首先恢复配置文件备份，然后再恢复数据库备份：

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

     Copy to Clipboard Toggle word wrap

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

     Copy to Clipboard Toggle word wrap
     以上例子恢复了 Manager 数据库的备份。

     # engine-backup --mode=restore --scope=reportsdb --file=file_name --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

     Copy to Clipboard Toggle word wrap
     以上例子恢复了 Reports 数据库的备份。

     # engine-backup --mode=restore --scope=dwhdb --file=file_name --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

     Copy to Clipboard Toggle word wrap
     以上例子恢复了 Data Warehouse 数据库的备份。
   如果运行成功，以下输出会被显示：

   You should now run engine-setup.
   Done.

   Copy to Clipboard Toggle word wrap

4. 配置 Manager

   配置恢复的 Manager 虚拟机。这个过程会检测到存在的配置设置和数据库内容。确认这些设置。完成后，系统会提供一个 SSH 指纹（fingerprint）和一个内部的证书授权哈希数据（Certificate Authority hash）。

   # engine-setup

   Copy to Clipboard Toggle word wrap

   [ 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 ==--
            
             Skipping storing options as database already prepared
            
             --== PKI CONFIGURATION ==--
            
             PKI is already configured
            
             --== APACHE CONFIGURATION ==--
            
            
             --== SYSTEM CONFIGURATION ==--
            
            
             --== END OF CONFIGURATION ==--
            
   [ INFO  ] Stage: Setup validation
   [ INFO  ] Cleaning stale zombie tasks
            
             --== CONFIGURATION PREVIEW ==--
            
             Database name                      : engine
             Database secured connection        : False
             Database host                      : X.X.X.X
             Database user name                 : engine
             Database host name validation      : False
             Database port                      : 5432
             NFS setup                          : True
             Firewall manager                   : iptables
             Update Firewall                    : True
             Configure WebSocket Proxy          : True
             Host FQDN                          : Manager.example.com
             NFS mount point                    : /var/lib/exports/iso
             Set application as default page    : True
             Configure Apache SSL               : True
            
             Please confirm installation settings (OK, Cancel) [OK]:

   Copy to Clipboard Toggle word wrap

5. 从恢复的环境中删除主机

   如果被恢复的自承载引擎部署在一个新硬件中，而这个硬件系统的名称没有出现在备份的引擎中，则跳过这一步。这一步只适用于在一个故障转移主机上（hosted_engine_1）进行部署的情况。因为这个主机在备份时已存在，它仍然还会存在于恢复的引擎中。因此，在进行最后的同步前，需要把它先从环境中删除。
   1. 登录到管理门户
   2. 点主机标签页。故障转移主机（hosted_engine_1）会处于维护模式，而且没有运行任何虚拟机。
   3. 点删除。
   4. 点确定。

6. 把主机和 Manager 进行同步

   返回到主机，选择选项 1 来继续 hosted-engine 脚本：

   (1) Continue setup - engine installation is complete

   Copy to Clipboard Toggle word wrap

   [ INFO  ] Engine replied: DB Up!Welcome to Health Status!
   [ INFO  ] Waiting for the host to become operational in the engine. This may take several minutes...
   [ INFO  ] Still waiting for VDSM host to become operational...

   Copy to Clipboard Toggle word wrap
   在此阶段，hosted_engine_1 会出现在管理门户中，它的状态会在变为 Non Operational 前经历 Installing 状态和 Initializing 状态。主机会等待 VDSM 主机变为正常运行的状态，并最终发生超时。这是因为环境中的另外一个主机具有 SPM 角色，而这个具有 SPM 角色的主机处于 Non Responsive 的状态，因此，hosted_engine_1 无法和存储域进行交流。当超时发生时，您会被提示关闭虚拟机来完成部署的过程。当部署完成后，主机可以被手工设置为维护模式，并通过管理门户激活。

   [ INFO  ] Still waiting for VDSM host to become operational...
   [ ERROR ] Timed out while waiting for host to start. Please check the logs.
   [ ERROR ] Unable to add hosted_engine_2 to the manager
             Please shutdown the VM allowing the system to launch it as a monitored service.
             The system will wait until the VM is down.

   Copy to Clipboard Toggle word wrap

7. 关闭 Manager

   关闭新的 Manager 虚拟机。

   # shutdown -h now

   Copy to Clipboard Toggle word wrap

8. 设置确认

   返回到主机，确认它检测到 Manager 虚拟机已被关闭。

   [ INFO  ] Enabling and starting HA services
             Hosted Engine successfully set up
   [ INFO  ] Stage: Clean up
   [ INFO  ] Stage: Pre-termination
   [ INFO  ] Stage: Termination

   Copy to Clipboard Toggle word wrap

9. 激活主机

   1. 登录到管理门户
   2. 点主机标签页。
   3. 选 hosted_engine_1 并点维护按钮。主机可能会需要几分钟时间进入维护模式。
   4. 点激活按钮。
   一旦激活后，hosted_engine_1 就可以竞争成为 SPM，存储域和数据中心都变为活跃状态。

10. 把虚拟机迁移到活跃的主机上

    对状态为 Non Responsive 的主机进行手工隔离（fencing），这会使它上面的虚拟机迁移到其它活跃的主机上。在管理门户中，点主机右键，选确认“主机已被重启”。
    当进行备份时在那个主机上运行的所有虚拟机都会被从那个主机上删除，并从 Unknown 状态变为 Down 状态。这些虚拟机现在可以在 hosted_engine_1 上运行。使用 REST API 把被隔离的主机强制删除。

1. 隔离无法正常工作的主机

   在管理门户中，在主机上点鼠标右键，选确认“主机已被重启”。
   当进行备份时在那个主机上运行的所有虚拟机都会被从那个主机上删除，并从 Unknown 状态变为 Down 状态。使用 REST API 把被隔离的主机强制删除。

2. 获得 Manager 的证书颁发机构（CA）

   连接到 Manager 虚拟机，在命令行中使用 cURL 进行以下请求。
   使用 GET 请求获得 Manager 的 CA 以供今后的 API 请求使用。在下面的示例中，使用 --output 选项指定 hosted-engine.ca 文件作为 Manager CA 证书的输出。--insecure 选项意味着这个初始的请求不包括证书。

   # curl --output hosted-engine.ca --insecure https://[Manager.example.com]/ca.crt

   Copy to Clipboard Toggle word wrap

3. 获得要被删除的主机的 GUID

   在主机集合中使用一个 GET 请求获得要被删除的主机的 GUID。以下例子中包括了 Manager CA 证书文件，使用 admin@internal 用户进行验证，并在命令执行过程中会被提示输入它的密码。

   # curl --request GET --cacert hosted-engine.ca --user admin@internal https://[Manager.example.com]/api/hosts

   Copy to Clipboard Toggle word wrap
   这个请求会返回环境中所有主机的信息。主机的 GUID 是和主机名相连的十六进制字符串。如需了解更多与 Red Hat Enterprise Virtualization REST API 相关的信息，请参阅 Red Hat Enterprise Virtualization REST API Guide。

4. 删除隔离的主机

   使用带有被隔离主机的 GUID 的 DELETE 请求从环境中删除这个主机。除了以前请求中使用的参数，这个例子中的请求还包括使用 XML 的头（header），以及内容（body）项。在内容项中，把 force 操作设置为 true。

   curl --request DELETE --cacert hosted-engine.ca --user admin@internal --header "Content-Type: application/xml" --header "Accept: application/xml" --data "<action><force>true</force></action>" https://[Manager.example.com]/api/hosts/ecde42b0-de2f-48fe-aa23-1ebd5196b4a5

   Copy to Clipboard Toggle word wrap
   通过使用相应的 GUID，这个 DELETE 请求可以被用来删除自承载引擎环境中的每一个被隔离的主机。

过程 6.4. 添加主机

1. 安装 ovirt-hosted-engine-setup 软件包。

   # yum install ovirt-hosted-engine-setup

   Copy to Clipboard Toggle word wrap
2. 配置主机。

   # hosted-engine --deploy

   Copy to Clipboard Toggle word wrap
   如果需要通过网络运行 hosted-engine 部署脚本，我们推荐使用 screen 窗口管理程序。使用它可以在出现网络问题时保持当前运行的进程。如果还没有安装 screen，请先安装这个软件包。

   # screen hosted-engine --deploy

   Copy to Clipboard Toggle word wrap

3. 准备初始化

   脚本开始会要求您确认在自承载引擎环境中作为虚拟机管理程序（hypervisor）的主机信息。

   Continuing will configure this host for serving as hypervisor and create a VM where you have to install oVirt Engine afterwards. 
   Are you sure you want to continue? (Yes, No)[Yes]:

   Copy to Clipboard Toggle word wrap

4. 配置存储

   选择使用的存储类型。

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

   Copy to Clipboard Toggle word wrap
   • 对于 NFS 存储类型，使用 FQDN 或 IP 地址指定它的完整地址，以及共享存储域的路径名。

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

     Copy to Clipboard Toggle word wrap
   • 对于 iSCSI，指定 iSCSI 门户 IP 地址、端口、用户名和密码，并从检测到的列表中选择一个目标名：

     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]:

     Copy to Clipboard Toggle word wrap

5. 检测自承载引擎

   hosted-engine 脚本会检测正在被使用的共享存储，并要求用户输入是否存在一个额外的主机。另外，用户还会被提示输入主机 ID，这个 ID 必须还没有分配给这个环境中的任何主机。

   The specified storage location already contains a data domain. Is this an additional host setup (Yes, No)[Yes]? 
   [ INFO  ] Installing on additional host
   Please specify the Host ID [Must be integer, default: 2]:
   

   Copy to Clipboard Toggle word wrap

6. 配置系统

   hosted-engine 脚本使用在进行原始引擎主机设置时产生的应答文件进行配置。为了可以把应答文件复制到要安装的额外主机上，脚本需要知道原始引擎所在主机的 FQDN 或 IP 地址，以及它的 root 用户密码。

   [WARNING] A configuration file must be supplied to deploy Hosted Engine on an additional host.
   The answer file may be fetched from the first host using scp.
   If you do not want to download it automatically you can abort the setup answering no to the following question.
   Do you want to scp the answer file from the first host? (Yes, No)[Yes]:       
   Please provide the FQDN or IP of the first host:           
   Enter 'root' user password for host [hosted_engine_1.example.com]: 
   [ INFO  ] Answer file successfully downloaded
   

   Copy to Clipboard Toggle word wrap

7. 配置引擎

   指定要安装的额外主机在 Red Hat Enterprise Virtualization 环境中使用的名称，以及 admin@internal 用户的密码。这个名称必须没有被环境中的其它任何主机使用。

   Enter the name which will be used to identify this host inside the Administrator Portal [hosted_engine_2]:           
   Enter 'admin@internal' user password that will be used for accessing the Administrator Portal: 
   Confirm 'admin@internal' user password:
   

   Copy to Clipboard Toggle word wrap

8. 配置预览

   在实际进行配置前，hosted-engine 脚本会显示您已输入的信息，并提示您确认这些信息。

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

   Copy to Clipboard Toggle word wrap

9. 确认引擎安装完成

   在脚本提示进行选择时，额外的主机会和 Manager 和 hosted_engine_1 进行联系。选择选项 1 继续。

   [ INFO  ] Stage: Closing up
   To continue make a selection from the options below:
     (1) Continue setup - engine installation is complete
     (2) Power off and restart the VM
     (3) Abort setup
     (4) Destroy VM and abort setup
            
     (1, 2, 3, 4)[1]

   Copy to Clipboard Toggle word wrap

10. [ INFO  ] Engine replied: DB Up!Welcome to Health Status!
    [ INFO  ] Waiting for the host to become operational in the engine. This may take several minutes...

    Copy to Clipboard Toggle word wrap
    在此阶段，主机会出现在管理门户中，它的状态会在变为 Non Operational 前经历 Installing 状态和 Initializing 状态。主机会等待 VDSM 主机变为正常运行的状态，并最终发生超时。

    [ INFO  ] Still waiting for VDSM host to become operational...
    [ INFO  ] Still waiting for VDSM host to become operational...
    [ ERROR ] Timed out while waiting for host to start. Please check the logs.
    [ ERROR ] Unable to add hosted_engine_1 to the manager
    [ INFO  ] Enabling and starting HA services
              Hosted Engine successfully set up
    [ INFO  ] Stage: Clean up
    [ INFO  ] Generating answer file '/etc/ovirt-hosted-engine/answers.conf'
    [ INFO  ] Stage: Pre-termination
    [ INFO  ] Stage: Termination

    Copy to Clipboard Toggle word wrap

11. 激活主机

    1. 登录到管理门户
    2. 点主机标签页，选择要被激活的主机。
    3. 点激活按钮。

过程 8.1. 为 Red Hat Enterprise Virtualization Manager 准备远程 PostgreSQL 数据库

1. 登录到远程数据库服务器并安装 PostgreSQL server 软件包：

   # yum install postgresql-server

   Copy to Clipboard Toggle word wrap
2. 初始化 PostgreSQL 数据库，启动 postgresql 服务，把它设置为在系统引导时被自动启动：

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

   Copy to Clipboard Toggle word wrap
3. 使用 postgres 用户连接到 psql 命令行界面：

   # su - postgres
   $ psql

   Copy to Clipboard Toggle word wrap
4. 为 Manager 读写数据库创建一个用户。Manager 的默认用户名是 engine：

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

   Copy to Clipboard Toggle word wrap

   注意

   engine 用户的密码以明码形式保存在 /etc/ovirt-engine/engine.conf.d/10-setup-database.conf 文件中。在新服务器上创建的角色可以使用任何密码，但如果新密码和保存在这个文件中的密码不同，则需要修改这个文件中的密码。
5. 创建一个用来保存 Red Hat Enterprise Virtualization 环境信息的数据库。Manager 的默认数据库名是 engine，默认的用户名是 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';

   Copy to Clipboard Toggle word wrap
6. 启用 md5 客户验证机制来允许对数据库进行访问。编辑 /var/lib/pgsql/data/pg_hba.conf 文件，在文件底部的、以 local 开头的行的下面添加以下内容（使用 Manager 的 IP 地址替换 X.X.X.X 的值）：

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

   Copy to Clipboard Toggle word wrap
7. 允许 TCP/IP 到数据库的连接。编辑 /var/lib/pgsql/data/postgresql.conf 文件，添加以下行：

   listen_addresses='*'

   Copy to Clipboard Toggle word wrap
   在这个例子中，postgresql 服务被配置为监听所有接口上的连接。您可以使用 IP 地址来指定只监听特定接口上的连接。
8. 打开 PostgreSQL 数据库连接所使用的默认端口，保存更新的防火墙规则：

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

   Copy to Clipboard Toggle word wrap
9. 重启 postgresql 服务：

   # service postgresql restart

   Copy to Clipboard Toggle word wrap

过程 8.2. 迁移数据库

1. 登录到任何一个运行引擎的主机，把环境设置为 global 维护模式。这会禁用高可用性代理，并防止在进行数据库迁移过程中出现 Manager 迁移的情况：

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

   Copy to Clipboard Toggle word wrap
2. 登录到 Manager 虚拟机，停止 ovirt-engine 服务，从而使它不会影响到引擎的备份：

   # service ovirt-engine stop

   Copy to Clipboard Toggle word wrap
3. 使用 PostgreSQL 的 pg_dump 命令创建 engine 数据库的备份：

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

   Copy to Clipboard Toggle word wrap
4. 把备份文件复制到新的数据库中。目标目录需要允许 postgres 用户对它的访问：

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

   Copy to Clipboard Toggle word wrap
5. 登录到新数据库服务器，使用 PostgreSQL 的 pg_restore 命令恢复数据库：

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

   Copy to Clipboard Toggle word wrap
6. 登录到 Manager 虚拟机，更新 /etc/ovirt-engine/engine.conf.d/10-setup-database.conf 文件中的设置。使用新数据库服务器的 IP 地址替换 ENGINE_DB_HOST 的 localhost。如果新数据库服务器的引擎名称、角色名称或密码也有变化，则还需修改这个文件中的相应值。
7. 现在，数据库已被迁移，启动 ovirt-engine 服务：

   # service ovirt-engine start

   Copy to Clipboard Toggle word wrap
8. 登录到运行引擎的主机，关闭维护模式，启用高可用性代理：

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

   Copy to Clipboard Toggle word wrap

过程 8.3. 把 Data Warehouse 数据库迁移到一个独立的机器上

1. 在当前的数据库所在机器上，把 ovirt_engine_history 数据库输出到一个 SQL 脚本文件中：

   # pg_dump ovirt_engine_history > ovirt_engine_history.sql

   Copy to Clipboard Toggle word wrap
2. 把这个脚本文件从当前数据库所在的机器复制到新数据库所在的机器上。
3. 在新数据库所在机器上恢复 ovirt_engine_history 数据库：

   # psql -d ovirt_engine_history -f ovirt_engine_history.sql

   Copy to Clipboard Toggle word wrap
   以上命令假设新数据库已被命名为 ovirt_engine_history。

过程 8.4. 第 1 步：设置新的 Data Warehouse 机器

1. 在 Content Delivery Network 中注册您的系统，在出现提示时输入您的 Customer Portal 用户名和密码：

   # subscription-manager register

   Copy to Clipboard Toggle word wrap
2. 找到 Red Hat Enterprise Linux Server 和 Red Hat Enterprise Virtualization 订阅池，并记录下它们的 ID。

   # subscription-manager list --available

   Copy to Clipboard Toggle word wrap
3. 使用前一步获得的池 ID 为系统附加权利：

   # subscription-manager attach --pool=pool_id

   Copy to Clipboard Toggle word wrap
4. 禁用所有存在的软件仓库：

   # subscription-manager repos --disable=*

   Copy to Clipboard Toggle word wrap
5. 启用所需的频道：

   # subscription-manager repos --enable=rhel-6-server-rpms
   # subscription-manager repos --enable=rhel-6-server-supplementary-rpms
   # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms
   # subscription-manager repos --enable=jb-eap-6-for-rhel-6-server-rpms

   Copy to Clipboard Toggle word wrap
6. 确认当前安装的软件包已被升级到最新版本：

   # yum update

   Copy to Clipboard Toggle word wrap
7. 安装 rhevm-dwh-setup 软件包：

   # yum install rhevm-dwh-setup

   Copy to Clipboard Toggle word wrap

过程 8.5. 第 2 步：在 Manager 的机器上停止 Data Warehouse 服务

1. 停止 Data Warehouse 服务：

   # service ovirt-engine-dwhd stop

   Copy to Clipboard Toggle word wrap
2. 如果 ovirt_engine_history 数据库、Manager 数据库或这两个数据库都运行在 Manager 所在的机器上，而且是由一个较早版本的系统（Red Hat Enterprise Virtualization 3.4 或更早版本）所配置，然后进行了升级，则需要保证新的 Data Warehouse 机器可以访问它们。打开 /var/lib/pgsql/data/postgresql.conf 文件并把 listen_addresses 行的内容修改为：

   listen_addresses = '*'

   Copy to Clipboard Toggle word wrap
   如果这行没有存在或被注释掉，您需要手工添加它。
   如果数据库位于远程的机器上，您需要手工配置访问权限（编辑每台机器上的 postgres.conf 文件，根据上面的介绍添加 listen_addresses 行）。如果两个数据库都位于 Manager 所在的机器上，并通过 Red Hat Enterprise Virtualization Manager 3.5 进行了全新设置，则相关的访问权限会被默认设置。
3. 重启 postgresql 服务：

   # service postgresql restart

   Copy to Clipboard Toggle word wrap

过程 8.6. 第 3 步：配置新的 Data Warehouse 机器

1. 运行 engine-setup 命令在机器上开始配置 Data Warehouse：

   # engine-setup

   Copy to Clipboard Toggle word wrap
2. 点 Enter 配置 Data Warehouse：

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

   Copy to Clipboard Toggle word wrap
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]:

   Copy to Clipboard Toggle word wrap
   如果您选择了自动配置防火墙，但还没有激活的防火墙管理器，您将会被提示从一个列表中选择需要使用的防火墙管理器。输入防火墙管理器的名称后按 Enter。
4. 点 Enter 接受自动检测到的主机名，或输入一个其它主机名后点 Enter：

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

   Copy to Clipboard Toggle word wrap
5. 输入 ovirt_engine_history 数据库的以下位置信息：

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

   Copy to Clipboard Toggle word wrap
   输入您的选择后点 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

   Copy to Clipboard Toggle word wrap
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

   Copy to Clipboard Toggle word wrap
8. 点 Enter 为已存在的 Data Warehouse 数据库创建一个备份：

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

   Copy to Clipboard Toggle word wrap
   创建备份所需的时间和存储空间取决于数据库的大小，它可能会需要几个小时来完成。备份文件的位置出现在设置脚本的后面。如果您在这一步没有选择备份数据库，当因为某些原因 engine-setup 运行失败，您将无法恢复数据库或其中的任何数据。
9. 确认您将永久地把 Data Warehouse 服务与 Manager 断开：

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

   Copy to Clipboard Toggle word wrap
10. 确认您的安装设置：

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

    Copy to Clipboard Toggle word wrap

过程 8.7. 第 4 步：在 Manager 的机器上删除 Data Warehouse 软件包

1. 删除 Data Warehouse 软件包：

   # yum remove rhevm-dwh

   Copy to Clipboard Toggle word wrap
   这一步会防止 Data Warehouse 服务在一个小时后自动重启。
2. 删除 Data Warehouse 文件：

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

   Copy to Clipboard Toggle word wrap

过程 8.8. 第 1 步：配置新的 Reports 机器

1. 在 Content Delivery Network 中注册您的系统，在出现提示时输入您的 Customer Portal 用户名和密码：

   # subscription-manager register

   Copy to Clipboard Toggle word wrap
2. 找到 Red Hat Enterprise Linux Server 和 Red Hat Enterprise Virtualization 订阅池，并记录下它们的 ID。

   # subscription-manager list --available

   Copy to Clipboard Toggle word wrap
3. 使用前一步获得的池 ID 为系统附加权利：

   # subscription-manager attach --pool=pool_id

   Copy to Clipboard Toggle word wrap
4. 禁用所有存在的软件仓库：

   # subscription-manager repos --disable=*

   Copy to Clipboard Toggle word wrap
5. 启用所需的频道：

   # subscription-manager repos --enable=rhel-6-server-rpms
   # subscription-manager repos --enable=rhel-6-server-supplementary-rpms
   # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms
   # subscription-manager repos --enable=jb-eap-6-for-rhel-6-server-rpms

   Copy to Clipboard Toggle word wrap
6. 确认当前安装的软件包已被升级到最新版本：

   # yum update

   Copy to Clipboard Toggle word wrap
7. 安装 rhevm-reports-setup 软件包：

   # yum install rhevm-reports-setup

   Copy to Clipboard Toggle word wrap
8. 运行 engine-setup 命令在机器上开始配置 Reports：

   # engine-setup

   Copy to Clipboard Toggle word wrap
9. 点 Enter 配置 Reports：

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

   Copy to Clipboard Toggle word wrap
10. 点 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]:

    Copy to Clipboard Toggle word wrap
    如果您选择了自动配置防火墙，但还没有激活的防火墙管理器，您将会被提示从一个列表中选择需要使用的防火墙管理器。输入防火墙管理器的名称后按 Enter。
11. 点 Enter 接受自动检测到的主机名，或输入一个其它主机名后点 Enter：

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

    Copy to Clipboard Toggle word wrap
12. 输入 Manager 所在机器的完全限定域名并点 Enter：

    Host fully qualified DNS name of the engine server []:

    Copy to Clipboard Toggle word wrap
13. 输入 ovirt_engine_reports 数据库的以下信息。点 Enter 来创建并配置一个本地数据库：

    Where is the Reports database located? (Local, Remote) [Local]:
    Setup can configure the local postgresql server automatically for the Reports to run. This may conflict with existing applications.
    Would you like Setup to automatically configure postgresql and create Reports database, or prefer to perform that manually? (Automatic, Manual) [Automatic]:

    Copy to Clipboard Toggle word wrap
14. 输入 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

    Copy to Clipboard Toggle word wrap
15. 点 Enter 允许通过 SSH 在 Manager 上签发 Reports 证书和 Apache 证书：

    Setup will need to do some actions on the remote engine server. Either automatically, using ssh as root to access it, or you will be prompted to manually perform each such action.
    Please choose one of the following:
    1 - Access remote engine server using ssh as root
    2 - Perform each action manually, use files to copy content around
    (1, 2) [1]:

    Copy to Clipboard Toggle word wrap
16. 点 Enter 接受默认的 SSH 端口，或输入另外一个端口号后点 Enter：

    ssh port on remote engine server [22]:

    Copy to Clipboard Toggle word wrap
17. 输入 Manager 机器的 root 密码：

    root password on remote engine server manager-fqdn.com:

    Copy to Clipboard Toggle word wrap
18. 点 Enter 允许在 Apache 上自动配置 SSL：

    Setup can configure apache to use SSL using a certificate issued from the internal CA.
    Do you wish Setup to configure that, or prefer to perform that manually? (Automatic, Manual) [Automatic]:
    

    Copy to Clipboard Toggle word wrap
19. 为 Reports 管理用户（admin 和 superuser）设置一个密码。请注意，Reports 系统会有一组和 Manager 不同的用户验证信息：

    Reports power users password:

    Copy to Clipboard Toggle word wrap
    您需要再次输入用户密码来确认它。
20. 确认您的安装设置：

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

    Copy to Clipboard Toggle word wrap