3.3. Running the Configuration Script

Run the rhel-osp-installer command to install the RHEL OpenStack Platform installer application and configure the core parameters the installer uses to provision RHEL OpenStack Platform 6.0.

Note

The rhel-osp-installer command automatically configures the required SELinux permissions and adds the required firewall rules to iptables while preserving any existing firewall rules. See Appendix A, Firewall Rules for the list of firewall rules that the command configures.

Procedure 3.2. Installing and running the Red Hat Enterprise Linux OpenStack Platform installer configuration script

  1. Install the rhel-osp-installer package:
    # yum install rhel-osp-installer
  2. Start the installation:
    # rhel-osp-installer
  3. Enter the number for the network interface that the installer will use to provision RHEL OpenStack Platform, and press Enter:
    Please select NIC on which you want Foreman provisioning enabled:
    1. eth1
    2. eth0
    ?
    
Once you have chosen a network interface, the configuration script displays some network options to configure.

Procedure 3.3. Configuring Network Options

  1. Enter the number for the configuration option to change, and press Enter.

    Table 3.1. Networking Setup Options

    Option Description   
    Network interface The network interface to use for the provisioning network. The default values of other networking options, such as the IP address and Network address, are automatically specified based on the network interface you select.   
    IP Address The IP address of the machine hosting the installer.   
    Network mask The network mask of the machine hosting the installer. The installer also uses this value to populate the network mask of the default subnet in the provisioning network. This means all provisioned hosts use this subnet too.   
    Network address The network address of the default subnet. The installer uses this address as the provisioning network. This address must be in CIDR format. For example, 192.168.1.0/24.   
    Host gateway The address of a machine that acts as a gateway for the machine hosting the installer.   
    DHCP range start 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.   
    DHCP range end 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.   
    DHCP Gateway The address of a machine that can act as a gateway for machines that the installer provisions. By default, the address of the machine hosting the installer is specified as the DHCP gateway. To use this machine as the default gateway, see Section 3.5, “Configuring a Gateway”. If aim to use a different machine to act as a gateway, edit this value and specify the address of a machine that can perform this function.   
    DNS forwarder 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.   
    Domain The name of the domain that the installer provides. The name of the domain must match the fully qualified domain name of the machine hosting the installer.   
    Foreman URL The address for accessing the user interface. By default, this value is set to the fully qualified domain name of the machine hosting the installer.   
    NTP sync host The address of an NTP server that the installer can use to synchronize the time on machines that it provisions.   
    Timezone 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 America/New_York or Asia/Tokyo.   
  2. Enter a new value, and press Enter.
  3. When you have specified the preferred value for each configuration option, enter 1, and press Enter.

Example 3.1. Sample Network Configuration Screen

Networking setup:
       Network interface: 'eth1'
              IP address: 'XX.XX.XX.XX'
            Network mask: 'XX.XX.XX.XX'
         Network address: 'XX.XX.XX.XX'
            Host Gateway: 'XX.XX.XX.XX'
        DHCP range start: 'XX.XX.XX.XX'
          DHCP range end: 'XX.XX.XX.XX'
            DHCP Gateway: 'XX.XX.XX.XX'
           DNS forwarder: 'XX.XX.XX.XX'
                  Domain: 'mydomain.example.com'
             Foreman URL: 'https://host.mydomain.example.com'
           NTP sync host: '0.rhel.pool.ntp.org'
                Timezone: 'America/New_York'
Configure networking on this machine: ✓
Configure firewall on this machine: ✓

The installer can configure the networking and firewall rules on this machine with the above configuration. Default values are populated from the this machine's existing networking configuration.

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 above values
2. Change Network interface
3. Change IP address
4. Change Network mask
5. Change Network address
6. Change Host Gateway
7. Change DHCP range start
8. Change DHCP range end
9. Change DHCP Gateway
10. Change DNS forwarder
11. Change Domain
12. Change Foreman URL
13. Change NTP sync host
14. Change Timezone
15. Do not configure networking
16. Do not configure firewall
17. Cancel Installation

Important

The name of the domain must match that of the fully qualified domain name of the machine hosting the installer.

Important

By default, the address of the machine hosting the installer is specified as the DHCP gateway, which is the gateway provisioned hosts use. If you have not configured the machine hosting the installer to act as a gateway, you must edit this value and specify the address of a machine that can perform this function.
Once you complete the network configuration, the configuration script displays some authentication options to configure for client hosts.

Procedure 3.4. Configuring Client Authentication

  1. Enter the number for the configuration option to change, and press Enter.

    Table 3.2. Client Authentication Options

    Option Description   
    SSH public key A public SSH key that is copied to machines that the installer provisions. This can be either the public key itself or a location to a file containing the public key.   
    Root password The password for the root user on machines the installer provisions. The password must be at least eight characters in length. If you do not manually specify a password, a random password is generated.   
  2. Enter a new value, and press Enter.
  3. When you have specified either a SSH public key or a root password, enter 1, and press Enter.

Example 3.2. Sample Client Authentication Configuration Screen

Configure client authentication
          SSH public key: ''
           Root password: '*********'

Please set a default root password for newly provisioned machines. If you choose not to set a password, it will be generated randomly. The password must be a minimum of 8 characters. You can also set a public ssh key which will be deployed to newly provisioned machines.

How would you like to proceed?:
1. Proceed with the above values
2. Change SSH public key
3. Change Root password
4. Toggle Root password visibility
Once you have completed the client authentication options, the configuration script starts installing and configuring the installer components. This part takes a few minutes to complete.
When complete, the configuration script asks the location of your base operating system installation medium.

Procedure 3.5. Configuring Installation Medium Details

  1. Enter 1, and press Enter.

    Table 3.3. Installation Media Options

    Option Description   
    Set RHEL repo path (http or https URL) The address of a Red Hat Enterprise Linux 7.2 installation tree. The path must end in the directory that contains directories such as isolinux, LiveOS, and repodata. This option is used to populate the default installation media entry that the installer uses to install the base operating system on machines that it provisions.   
  2. Enter the address of a Red Hat Enterprise Linux Server 7.2 installation tree that the machine hosting the installer can access through a web server, and press Enter.

    Important

    The installer requires a Red Hat Enterprise Linux 7 kickstart tree. If you do not have one available, create one on the installer using a Red Hat Enterprise Linux 7 ISO or DVD. Follow the steps in Section 3.4, “Preparing the Installation Medium” after the rhel-osp-installer completes. For the moment, enter the following as the RHEL repo URL:
    http://www.example.com:8120/RHEL7
    Make sure to replace www.example.com with the hostname of your installer host.
  3. Enter 2, and press Enter.

Example 3.3. Sample Installation Medium Configuration Screen

Now you should configure installation media which will be used for provisioning.
Note that if you don't configure it properly, host provisioning won't work until you configure installation media manually.

Enter RHEL repo path:
1. Set RHEL repo path (http or https URL): http://www.example.com:8120/RHEL7
2. Proceed with configuration
3. Skip this step (provisioning won't work)
Once you set the installation media, the configuration script asks for your subscription management details.

Procedure 3.6. Configuring Subscription Management Details

  1. Enter the number for the configuration option to change, and press Enter.

    Table 3.4. Subscription Manager Options

    Option Description   
    Subscription manager username The username of a Customer Portal account that can be used to register machines that the installer provisions with the Content Delivery Network.   
    Subscription manager password A password that can be used to authenticate the above account.   
    Comma or space separated repositories A comma or space separated list of repositories to enable on machines that the installer provisions. By default, this field contains the main repositories that provide the packages required to install Red Hat Enterprise Linux OpenStack Platform components.   
    Subscription manager pool (recommended) The ID of an entitlement pool to attach to machines that the installer provisions. Only a single entitlement pool ID can be specified, and if no entitlement pool ID is specified, the installer attempts to auto-attach the required entitlement pool.   
    Subscription manager proxy hostname The host name of a machine that can be used as a Subscription Manager proxy.   
    Subscription manager proxy port The port by which to connect with the Subscription Manager proxy.   
    Subscription manager proxy username A username by which to connect with the Subscription Manager proxy.   
    Subscription manager proxy password The password by which the authenticate the above username.   
  2. Enter a new value, and press Enter.
  3. When you have specified the preferred value for each configuration option, enter 9, and press Enter.

Example 3.4. Sample Subscription Management Configuration Screen

Enter your subscription manager credentials:
1. Subscription manager username:
2. Subscription manager password:
3. Comma separated repositories:        rhel-7-server-openstack-6.0-rpms rhel-7-server-openstack-6.0-installer-rpms rhel-7-server-rh-common-rpms rhel-ha-for-rhel-7-server-rpms
4. Subscription manager pool (recommended):
5. Subscription manager proxy hostname:
6. Subscription manager proxy port:
7. Subscription manager proxy username:
8. Subscription manager proxy password:
9. Proceed with configuration
10. Skip this step (provisioning won't subscribe your machines)

Note

The value for the Subscription Manager pool must be in the format of a Subscription Manager entitlement pool ID. Moreover, you can only specify a single entitlement pool ID. If you leave the value for this configuration item blank, the installer attempts to auto-attach the required entitlements on systems it provisions.

Important

If you choose not to specify your Subscription Manager account details in this step, you will not be able to provision RHEL OpenStack Platform unless you manually configure an operating system entry with the required details through the installer's user interface.
The RHEL OpenStack Platform installer configuration is complete, and the entries required to provision RHEL OpenStack Platform are automatically generated based on the details you provided. After the configuration is complete, the script displays the user name and a randomly generated password for the default administrative user account. The script also displays the address for accessing the user interface.

Example 3.5. Sample Completion Screen

  Success!
  * Foreman is running at https://www.example.com
      Initial credentials are admin / nziESrtcuNVFG79z
  * Foreman Proxy is running at https://www.example.com:8443
  * Puppetmaster is running at port 8140
  The full log is at /var/log/rhel-osp-installer/rhel-osp-installer.log

Important

It is recommended to login immediately with the initial credentials and change the password for the admin user.
Log into the installer and navigate to Admin UserMy account. Change the Password, Verify it, and click Submit.