Red Hat Cloud Infrastructure 6 Getting Started with the Red Hat Cloud Infrastructure Unified Installer

Red Hat Cloud Infrastructure 6 Getting Started with the Red Hat Cloud Infrastructure Unified Installer Deploying the RHCI Unified Installer to Begin Deployment of a Private Infrastructure as a Service Cloud Red Hat Cloud Infrastructure Documentation Team

Red Hat Cloud Infrastructure 6 Getting Started with the Red Hat Cloud Infrastructure Unified Installer Deploying the RHCI Unified Installer to Begin Deployment of a Private Infrastructure as a Service Cloud Red Hat Clo ud Infrastructure Do cumentatio n Team Red Hat Custo mer Co ntent Services rhci- do cs@redhat.co m

Legal Notice Copyright 2015 Red Hat, Inc. This do cument is licensed by Red Hat under the Creative Co mmo ns Attributio n- ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be remo ved. Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law. Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other co untries. Linux is the registered trademark of Linus Torvalds in the United States and other countries. Java is a registered trademark o f Oracle and/o r its affiliates. XFS is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/o r o ther co untries. MySQL is a registered trademark of MySQL AB in the United States, the European Union and o ther co untries. Node.js is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project. The OpenStack Wo rd Mark and OpenStack Lo go are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endo rsed o r spo nso red by the OpenStack Fo undatio n, o r the OpenStack co mmunity. All o ther trademarks are the pro perty o f their respective o wners. Abstract This guide explains how to install the Red Hat Cloud Infrastructure Installer and use it to set up yo ur Red Hat Clo ud Infrastructure Enviro nment.

T able of Cont ent s Table of Contents. Chapt..... er.. 1.. Int... roduct...... ion... t. o.. t he... Red.... Hat.... Cloud..... Infrast...... ruct.... ure... Unified....... Inst.... aller.................... 2.......... 1.1. Intro d uctio n to the Red Hat Clo ud Infrastructure Unified Installer 2. Chapt..... er.. 2.. Inst.... alling..... t. he... Red.... Hat... Cloud...... Infrast...... ruct... ure.... Unified....... Inst... aller.......................... 3.......... 2.1. Prep aring the Red Hat Clo ud Infrastructure Installer Installatio n Med ia 3 2.2. Installing the Red Hat Clo ud Infrastructure Unified Installer 3. Chapt..... er.. 3... Deploying.......... Red.... Hat... Ent... erprise....... Virt... ualizat...... ion... and.... Red.... Hat.... CloudForms........................ 8........... Chapt..... er.. 4.. Known....... Issues...... and.... Workarounds......................................................... 1. 4........... Chapt..... er.. 5... T. roubleshoot........... ing.... T. ips......................................................... 1. 6.......... 5.1. Tro ub lesho o ting Tip s 16 5.2. Lo g Files 17. Appendix........ A... Preparing......... a. Unified....... Inst... aller..... Inst... allat.... ion... Media..................................... 1. 8........... Appendix........ B.... Red.... Hat... Cloud...... Infrast...... ruct.... ure... Inst... aller..... Net... work.... O.. pt.. ions........................... 1. 9........... Appendix........ C... Discovering........... Host.... s......................................................... 2. 1........... Appendix........ D.... Reset..... t. ing... Passwords............................................................... 2. 3........... Appendix........ E... Revision........ Hist... ory............................................................. 2. 4.......... 1

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller Chapter 1. Introduction to the Red Hat Cloud Infrastructure Unified Installer 1.1. Int roduct ion t o t he Red Hat Cloud Infrast ruct ure Unified Inst aller The unified installer is based on Red Hat Satellite and uses a web-based graphical user interface to provide functions for managing the provisioning of Red Hat Cloud Infrastructure components on a set of machines. This includes: Red Hat Enterprise Virtualization, Red Hat Enterprise Linux OpenStack Platform, and Red Hat CloudForms. The Red Hat Cloud Infrastructure unified installer is currently only available as a Technology Preview and is intended for evaluation purposes only. Some limitations include: D eploying Red Hat Enterprise Linux OpenStack Platform with Red Hat CloudForms is currently not supported and will be available with the general availability of Red Hat Cloud Infrastructure 6.0. Red Hat Enterprise Virtualiz ation limitations: NFS storage is the only supported storage type for Red Hat Enterprise Virtualization. Local hypervisor storage and Gluster storage will be available with the general availability of Red Hat Cloud Infrastructure 6.0. Only Red Hat Enterprise Linux hosts are supported hypervisor hosts. Red Hat Enterprise Virtualization Hypervisor is not supported. Self-hosted engine is currently not supported. Only one network interface (rhevm bridge) is supported. Power management for hypervisor hosts is not supported. The default maximum transmission unit (MTU) value is set to 1500 and cannot be changed. Adding multiple VLANs to a single network interface is not supported. Network bonding is not supported. Specifying a different ISO domain other than the default one is not supported. 2

Chapt er 2. Inst alling t he Red Hat Cloud Infrast ruct ure Unified Inst aller Chapter 2. Installing the Red Hat Cloud Infrastructure Unified Installer 2.1. Preparing t he Red Hat Cloud Infrast ruct ure Inst aller Inst allat ion Media The Red Hat Cloud Infrastructure Installer is available as a live CD ISO file. Procedure 2.1. Preparing the Red Hat Cloud Infrastructure Installer Installation Media 1. D ownload the Red Hat Cloud Infrastructure Installer live CD ISO file from the Customer Portal. 2. Copy the live CD ISO file to a USB drive or write it to a CD or DVD using the wo d i m utility. For more information on the wo d i m utility, see Appendix A, Preparing a Unified Installer Installation Media. Now that installation media is prepared, proceed to the next section to install the unified installer. 2.2. Inst alling t he Red Hat Cloud Infrast ruct ure Unified Inst aller The unified installer is based on Satellite 6 and allows you to leverage Satellite' s functions to manage content delivery. It also provides you with the ability to provision a private cloud such as Red Hat Enterprise Virtualization or Red Hat Enterprise Linux OpenStack Platform and to deploy Red Hat CloudForms to manage your private or hybrid cloud environment. Prerequisites: The machine must have at least 100 GB of hard disk. The machine must have at least 12 GB of RAM. The machine must have access to two networks, one being an external network that can download and synchronize content from Red Hat Content D elivery Network, and one being a provisioning network that should only be available to the unified installer machine and the systems to be provisioned by the unified installer machine. No DHCP or TFTP services should be running on the provisioning network other than those configured by the unified installer machine itself. Procedure 2.2. Installing the Red Hat Cloud Infrastructure Unified Installer 1. Use the installation media prepared in Section 2.1, Preparing the Red Hat Cloud Infrastructure Installer Installation Media to start the machine on which to write the live Red Hat Cloud Infrastructure image. Select Install Red Hat Cloud Infrastructure, and press Enter. 3

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller Note If Anaconda displays the error message: Ki ckstart i nsuffi ci ent, check that the machine has met the hardware requirements. 2. The installation process starts with installing Red Hat Enterprise Linux 7 as the base operating system. Set the root password. Optionally, create additional users. Important You must set the root password. 4

Chapt er 2. Inst alling t he Red Hat Cloud Infrast ruct ure Unified Inst aller 3. Once the base operating system installation is complete, the system reboots. Log in as the root user with the password set in the previous step. 4. A terminal window opens, and the Red Hat Cloud Infrastructure Installer, also known as the fuso r-i nstal l er, initializes and prompts you for networking information. 5. Select the network interface card to be used for the provisioning network, and press Enter. 5

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller 6. Review the automatically generated network configuration. To change a value, enter the associated number and press Enter. Type in the desired value and press Enter. If you are installing on a bare metal machine, set Change BMC feature enabled to true. By enabling BMC (Baseboard Management Controller), you can use power management commands on managed hosts using the IPMI (Intelligent Platform Management Interface) or a similar protocol. Leave the BMC provider as default or change it to freei pmi depending on your BMC power management provider. To proceed with the configuration, enter 1, and press Enter. Note For a full list of the network option descriptions, see Appendix B, Red Hat Cloud Infrastructure Installer Network Options. Example 2.1. Example Network Configuration for the Unified Installer Machine If you DO NOT want to configure networking please set 'Configure networking on this machine' to No before proceeding. Do this by selecting option 'Do not configure networking' from the list below. How would you like to proceed?: 1. Proceed with the values shown 2. Change Network interface eth1 3. Change IP address 192.168.122.10 4. Change Hostname fusor.example.com 5. Change Network mask 255.255.255.0 6. Change Network address 192.168.122.0 7. Change Host Gateway 192.168.155.1 8. Change DHCP range start 192.168.122.11 9. Change DHCP range end 192.168.122.254 10. Change DHCP Gateway 192.168.122.1 11. Change DNS forwarder 192.168.155.1 12. Change Domain example.com 13. Change Foreman URL https://fusor.example.com 14. Change NTP sync host 1.centos.pool.ntp.org 15. Change Timezone US/Eastern 16. Change BMC feature enabled false 17. Change BMC default provider ipmitool 18. Do not configure networking 19. Do not configure firewall 20. Cancel Installation 6

Chapt er 2. Inst alling t he Red Hat Cloud Infrast ruct ure Unified Inst aller Note To re-run the network configuration and installation script, run l aunch-fuso r- i nstal l er. # launch-fusor-installer 7. After the networking script has completed successfully, double-click the R ed Hat C l o ud Infrastructure WebUI Firefox icon, and log in to the user interface with the username ad mi n and password chang eme. 8. Change the default password for the administration user of the Red Hat Cloud Infrastructure web user interface by clicking Ad mi n User, then My acco unt. Enter a new password, and click Submi t. Important It is important to change the administration user password for the Red Hat Cloud Infrastructure user interface. Leaving it as the default password, chang eme, could be considered a security risk. Now the unified installer is installed, proceed to the next section to create a Red Hat Cloud Infrastructure deployment. 7

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller Chapter 3. Deploying Red Hat Enterprise Virtualization and Red Hat CloudForms Use the Red Hat Cloud Infrastructure web user interface to deploy Red Hat Enterprise Virtualization for a private cloud environment and Red Hat CloudForms for the cloud environment management tool. The deployment time depends on the download speed of RPM packages. D eploying Red Hat Enterprise Linux OpenStack Platform with Red Hat CloudForms is currently not supported and will be available with the general availability of Red Hat Cloud Infrastructure 6.0. The unified installer machine has access to three main networks: an internal storage network, an external network to download and synchronize content from Red Hat Content D elivery Network, and a provisioning network that is only available to the unified installer machine and the systems to be provisioned by the unified installer machine. No DHCP or TFTP services should be running on the provisioning network other than those configured by the unified installer machine itself. Figure 3.1. Network Architecture 8

Chapt er 3. Deploying Red Hat Ent erprise Virt ualizat ion and Red Hat CloudForms Prerequisites: You must have completed the previous steps to set up the Red Hat Cloud Infrastructure unified installer machine. You must have Red Hat Cloud Infrastructure with Smart Management subscriptions. You must have a minimum of two physical hosts discovered by the unified installer machine. One host is to be used as the Red Hat Enterprise Virtualization Manager and one to be used as the hypervisor. Red Hat recommends having at least three physical hosts; two of which can be used as hypervisors for a highly-available Red Hat Enterprise Virtualization environment. See Appendix C, Discovering Hosts for host discovery. Make sure all host hardware clocks are synchronized with the hardware clock on the unified installer machine. You must have prepared two storage domains for the Red Hat Enterprise Virtualization environment. One is used as the data storage domain, and one is used as the export storage domain. It is recommended to have a separate storage server to host storage domains for easier storage management. The storage server must be accessible to all Red Hat Enterprise Virtualization machines. For more information on how to set up storage domains with appropriate permissions, see the Red Hat Enterprise Virtualization Installation Guide, Preparing NFS Storage for more information. Note For evaluation purposes, you can run the fuso r-l o cal -nfs-setup script and set up local NFS storage. The script creates the required storage domains and updates the firewall rules. The mount points created are: For the data storage domain: /var/l i b/expo rts/vms For the export storage domain: /var/l i b/expo rts/expo rts To ensure the firewall rules are updated correctly, only run this script after the l aunchfuso r-i nstal l er script has completed. Create an organization, which is a logical group for hosts, you want this deployment to belong to. A default organization is already created. For more information on creating organizations, see the Red Hat Satellite User Guide, Organizations for more information. Procedure 3.1. Deploying Red Hat Enterprise Virtualiz ation and Red Hat CloudForms 1. To create a new deployment, navigate to RHCI Installer New Deployment. 2. Select Red Hat Enterprise Virtualization and Red Hat CloudForms, and click Sel ect. 9

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller 3. Configure the Satellite component of this deployment: a. Enter a name, and optionally enter a description. Click Next. b. Select an organization. c. Select a life cycle environment or click New Envi ro nment P ath to create a new one. For more information on life cycle environments, see the Red Hat Satellite User Guide, Life Cycle Environments. 4. Configure the Red Hat Enterprise Virtualization component of this deployment: a. Select Hypervisor + engine, and click Next. The self-hosted engine option will be available with the general availability of Red Hat Cloud Infrastructure 6.0. b. Select a host to be used as the Red Hat Enterprise Virtualization Manager, also known as the engine. Click the Ho st Name field and update the host name as necessary. 10

Chapt er 3. Deploying Red Hat Ent erprise Virt ualizat ion and Red Hat CloudForms c. Select one or more hosts to be used as the hypervisors. Select a naming scheme from the Ho st nami ng scheme list. d. Set the root password for the Manager and hypervisor. Set the administration user password for the Administration Portal. The password requires a minimum of 8 characters. The rest can be left as default. e. Enter the data domain and export domain details, and click Next. Currently, only NFS storage is supported. 5. Configure the CloudForms component of this deployment: a. Select Install CloudForms on Red Hat Enterprise Virtualiz ation, and click Next. b. Set the root password for the Red Hat CloudForms virtual machine and the administration user password for the Red Hat CloudForms Portal. The password requires a minimum of 8 characters. 11

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller 6. Configure subscriptions: a. Enter your Red Hat account login information. b. Select a subscription management application that has Red Hat Cloud Infrastructure with Smart Management subscription or create a new one by clicking R eg i ster a New Satel l i te. Type in a name and click R eg i ster. Select Red Hat Cloud Infrastructure with Smart Management subscription and enter the quantity. Ensure the number of subscriptions is equal or greater than the number of anticipated hosts. c. Review the subscriptions, add any additional subscriptions if required, and enable Red Hat Access Insights. Click Next. Note Red Hat Access Insights is a lightweight data collection and analysis tool. For more information, see https://access.redhat.com/insights/splash/. 7. Installation review: a. Review the installation, and click Next. b. The installation begins. Click the D et ails tab to view individual task progress. RPM packages are downloaded from the Content D elivery Network to the unified installer machine. The discovered hosts are provisioned with Red Hat Enterprise Linux. Puppet will run on the provisioned hosts to install Red Hat Enterprise Virtualization packages from the unified installer machine. Red Hat CloudForms will be created as a virtual machine hosted in the Red Hat Enterprise Virtualization environment. 12

Chapt er 3. Deploying Red Hat Ent erprise Virt ualizat ion and Red Hat CloudForms c. When all three progress bars are at 100%, the deployment is complete. Click Next. d. Click on the URLs, and log in to verify the deployment. For Red Hat Enterprise Virtualization, log in with the username ad mi n and the password set during the deployment. For Red Hat CloudForms, log in with the username ad mi n and the password set during the deployment. You have now successfully deployed Red Hat Enterprise Virtualization and Red Hat CloudForms. 13

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller Chapter 4. Known Issues and Workarounds Known Issues BZ#126 0212 For Technology Preview, it is strongly advised to use the specific RPM versions installed from the Red Hat Cloud Infrastructure ISO. Updating the unified installer machine to use the latest packages available could lead to deployment failures. D o not register the unified installer machine to the Content Delivery Network and do not run yum upd ate. BZ#1258055 Internet Explorer 11 is not a supported browser version for Technology Preview. BZ#1119 225 When deploying Red Hat Enterprise Virtualization and Red Hat CloudForms, if the progress bar for the RHEV deployment hangs at 95.5%, and you see the following error message, it means that the NFS service failed to restart when the eng i ne-setup script was first run. On the Manager machine, rerun the eng i ne-setup script manually, and the deployment will continue. Expect 30 to 45 minutes of time for the rest of the configuration to complete before you see the progress bars updated. (/Stage[main]/Ovirt::Engine::Setup/Exec[engine-setup]/returns) [ ERROR ] Failed to execute stage 'Closing up': Command '/sbin/service' failed to execute BZ#1259 027 When creating a new life cycle environment during a Red Hat Cloud Infrastructure deployment, the Next button is disabled and users cannot click Next to proceed with the deployment. To work around this issue, click the Library life cycle arrow, and then the newly created life cycle environment. The Next button will be enabled again. BZ#12589 36 When doing two ore more concurrent Red Hat Cloud Infrastructure deployments, the first deployment to start content synchronizing tasks locks other deployments from content synchronizing and causes other deployments to fail. To work around this issue, wait until content synchronizing for the first deployment is complete, and resume the failing tasks for other deployments. BZ#124 04 20 When deploying Red Hat Enterprise Virtualization and Red Hat CloudForms, it is recommended to configure all components of the deployment and click D epl o y within the same session. When the session times out, users are not logged out of the Red Hat Cloud Infrastructure Portal, and any changes made then will not be saved. If you have left your session idle for a while, make sure you log out and log back in to continue with the deployment tasks. BZ#123826 0 If the hardware clock on the Red Hat Enterprise Virtualization hypervisor host is largely out of synchronization with the hardware clock on the unified installer machine, the Red Hat Enterprise Virtualization deployment fails with SSL errors in the logs. 14

Chapt er 4. Known Issues and Workarounds BZ#1252551 If connecting to the Red Hat CloudForms Portal using the Firefox browser on the unified installer machine, you will need to install the Adobe Flash plug-in. Otherwise, you will see the following error message: A plugin is needed to display this content. 15

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller Chapter 5. Troubleshooting Tips 5.1. T roubleshoot ing T ips Content synchroniz ing errors If you click Vi ew C o ntent Sync Status and see an error message related to package download failures, see Synchronizing Content to resynchronize the content manually. After content synchronizing is complete, perform a new deployment. If the failure persists, contact the Red Hat Global Support Team. Root password is not set on the unified installer machine If you see the following error message, that means you did not set the root password during the base operating installation. Re-install the unified installer machine and make sure you set the root password. Red Hat Cloud Infrastructure is now successfully installed on your system, but some configuration still needs to be done. Finish it and then click the Finish configuration button please The progress bar for the RHEV deployment hangs at 9 5.5% When deploying Red Hat Enterprise Virtualization and Red Hat CloudForms, if the progress bar for the RHEV deployment hangs at 95.5%, it indicates an error with configuring the Data Center for Red Hat Enterprise Virtualization. See /var/l o g /messag es for error logs. NFS related issues are the most common reason for a deployment failure. Verify the below: The NFS shares are set up with the appropriate permissions. The shares should be owned by user vd sm and group kvm with the mode set to 0755. Firewall rules are not preventing hypervisor hosts from mounting the NFS shares. The NFS shares should not have existing data. Ensure the shares do not have content from a previous Red Hat Enterprise Virtualization deployment. If you see the following error message, it means that the NFS service failed to restart when the eng i ne-setup script was first run. On the Manager machine, rerun the eng i ne-setup script manually, and the deployment will continue. Expect 30 to 45 minutes of time for the rest of the configuration to complete before you see the progress bars updated. 16

Chapt er 5. T roubleshoot ing T ips (/Stage[main]/Ovirt::Engine::Setup/Exec[engine-setup]/returns) [ ERROR ] Failed to execute stage 'Closing up': Command '/sbin/service' failed to execute 5.2. Log Files The following table identifies the major log files for each system. Table 5.1. Red Hat Cloud Infrastructure Log Files Log File Unified Installer Machine (Red Hat Satellite): /var/l o g /fo reman/pro d ucti o n. l o g Red Hat Enterprise Virtualization Manager: /var/l o g /messag es Red Hat Enterprise Linux hypervisor hosts: /var/l o g /messag es Description the backend logic for creating the deployment synchronizing repositories provisioning hosts deploying Red Hat CloudForms the installation of Red Hat Enterprise Virtualization packages from the unified installer machine the configuration of the Red Hat Enterprise Virtualization data center the installation of VDSM packages; the rest of the Red Hat Enterprise Virtualization configuration takes place on the Manager machine Note For Red Hat Enterprise Virtualization deployment errors, always check /var/l o g /messag es first before checking other Red Hat Enterprise Virtualization log files. See Red Hat Enterprise Virtualization Installation Guide, Configuring Logs for more information on Red Hat Enterprise Virtualization log files. 17

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller Appendix A. Preparing a Unified Installer Installation Media You can write the unified installer disk image to a CD-ROM or DVD with the wodim utility. The wodim utility is provided by the wodim package. Procedure A.1. Preparing a Unified Installer Installation Media 1. Install the wodim package and dependencies: # yum install wodim 2. Insert a blank CD-ROM or DVD into your CD or DVD writer. 3. Write the disk image to the disc: wodim dev=[device] [image] Note To find out the name of your writer device, run the following command: # less /proc/sys/dev/cdrom/info Example A.1. Use of the wodim Utility This example uses the first CD-RW (/d ev/sr0 ) device available and an example unified installer disk image location. # wodim dev=/dev/sr0 /Downloads/RHCI6.0_x86_64-dvd.iso 18

Appendix B. Red Hat Cloud Infrast ruct ure Inst aller Net work O pt ions Appendix B. Red Hat Cloud Infrastructure Installer Network Options The following table outlines the options available in the networking setup step of installing the user interface. Table B.1. Networking Setup O ptions O ption Netwo rk i nterface IP Ad d ress Ho stname Netwo rk mask Netwo rk ad d ress Ho st g ateway D HC P rang e start D HC P rang e end D HC P G ateway D NS fo rward er D o mai n Fo reman UR L NT P sync ho st Description The network interface on which the provisioning network is to be configured. The default values of other networking options, such as the IP ad d ress and Netwo rk ad d ress, are automatically specified based on the network interface you select. The IP address of the machine where the user interface is being installed. The host name of the machine where the user interface is being installed. The network mask of the machine where the user interface is being installed. This value is also used to populate the network mask of the default subnet that the installer configures to act as the provisioning network. The network address of the default subnet that the installer configures to act as the provisioning network. For example, XX. XX. XX. 0. The address of a machine that can act as a gateway for the machine where the user interface is being installed. The first address in the range of IP addresses that the installer can assign to machines on the provisioning network. This value is also used to populate the DHCP range start of the default subnet that the installer configures to act as the provisioning network. The last address in the range of IP addresses that the installer can assign to machines on the provisioning network. This value is also used to populate the DHCP range end of the default subnet that the installer configures to act as the provisioning network. The address of a machine that can act as a gateway for machines that the installer provisions. By default, the address of the machine where the user interface is being installed is specified as the DHCP gateway. If you have not configured the machine on which the user interface is being installed to act as a gateway, you must edit this value and specify the address of a machine that can perform this function. The address of a machine that can resolve IP addresses and host names. This value is also used to populate the primary DNS of the default subnet that the installer configures to act as the provisioning network. The name of the domain that the installer provides. The name of the domain must match that of the fully qualified domain name of the machine where the user interface is being installed. The address for accessing the user interface. By default, this value is set to the fully qualified domain name of the machine where the user interface is being installed. The address of an NTP server that the installer can use to synchronize the time on machines that it provisions. 19

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller O ption T i mezo ne BMC feature enabl ed BMC d efaul t pro vi d er Description The timezone that the installer applies to machines that it provisions. Timezones must be in the format of an IANA time zone identifier such as Ameri ca/new_y o rk or Asi a/t o kyo. If enabled, configures the installer machine to support BMC power management. The BMC power management provider type. By default, the provider is set to i pmi to o l. The other supported option is freei pmi. 20

Appendix C. Discovering Host s Appendix C. Discovering Hosts For hosts to be discovered by the Red Hat Cloud Infrastructure unified installer, the hosts must be accessible on the provisioning network. The provisioning network should have no other services running on it but the DHCP and TFTP services provided by the unified installer machine. Note Hardware requirements for Red Hat Enterprise Virtualization Manager: Red Hat Enterprise Virtualization Installation Guide, Manager Hardware Requirements. Hardware requirements for a hypervisor host: Red Hat Enterprise Virtualization Installation Guide, Hypervisor Hardware Requirements. Procedure C.1. Discovering Hosts 1. In the host' s BIOS configuration, change the default boot option to boot over the network. 2. Start the host, and select Fo reman D i sco very from the P XE bo o t options menu. The host starts into the Fo reman D i sco very screen and is automatically registered in the unified installer. 3. Log in to the user interface and confirm that the host has been registered: a. Click Hosts Discovered hosts. b. Click the name of the newly registered host to open the details page for the host, and review the details. The host is automatically included in the list of unassigned hosts when you assign hosts to a 21

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller deployment. The host is also automatically added to the d i sco very environment, which is a holding area for hosts that have not yet been provisioned. For the host to be used in an Red Hat Cloud Infrastructure deployment, the host must stay powered on. 22

Appendix D. Reset t ing Passwords Appendix D. Resetting Passwords This section shows you how to reset the administration user password for the unified installer machine. Procedure D.1. 1. On your Red Hat Cloud Infrastructure system, open a terminal. Use the foreman-rake tool to reset the password to a randomly generated password. # foreman-rake permissions:reset Reset to user: admin, password: qwjxbptxb7gfcjj5 2. Log in to the Red Hat Cloud Infrastructure web user interface using the randomly generated password. 3. Click Ad mi n User, then My acco unt. 4. Enter a new password, and click Submi t. 23

G et t ing St art ed wit h t he Red Hat Cloud Infrast ruct ure Unified Inst aller Appendix E. Revision History Revision 6.0.0-5 Wed Sep 16 2015 Julie Wu Added network architecture diagram and log files section. Revision 6.0.0-4 Mon Sep 07 2015 Julie Wu Updated the Known Issues list. Revision 6.0.0-3 Wed Sep 02 2015 Julie Wu Initial creation for the Red Hat Cloud Infrastructure 6 release. 24