Bootstrap Host Creation

The Bootstrap Host is provisioned to drive the creation of the virtualized cluster using Terraform, the OpenStack Client, and Ansible Playbook(s). A qcow2 image was provided as part of the OSDC download and should be available on the users OpenStack Environment as per the previous section of this document.

Note:

The examples below are for reference only. While the steps are correct the actual values used will be different. The following steps are to be performed manually on the customer specific Openstack Environment Desktop.

Table 2-15 Bootstrap Host Creation

Step # Procedure
1.

Login to the OpenStack Environment using your OpenStack credentials, the appropriate domain and project name.
2.

Select Compute → Instances
3.

Select the Launch Instances tab on the upper right. A dialog will appear to configure a VM instance.
4.

Enter an Instance Name (for example: occne-<name>). Leave the Availability Zone and Count set as is.
5.

Select Source on the left hand side of the dialog. A new dialog appears (Note: there might be a long list of available images to choose from)
6.

Make sure the filter pulldown is set to Image
7.

Enter occne_bootstrap in the filter. This will display the occne_bootstrap-<x.y.z>.qcow2 image uploaded in the previous sections of this procedure.
8.

Select the OCCNE Bootstrap Host image by selecting the "+" on the right side of the image listing. This adds the image as the source for this VM.
9.

Select Flavor
10.

Enter a string which best describes the flavor being used for this customer specific OpenStack Environment in the search filter. This brings up a new dialog.
11.

Select the appropriate customer specific Flavor (for example: occne_bsh_flavor) by selecting the "+" on the right side of the flavor listings. This adds the resources to the Launch Instance dialog. Note: The BSH image requires a flavor that includes a disk size of 40GB or higher. The RAM size should be 8GB or higher although that is not a restriction.
12.

Select Networks
13.

Enter the appropriate network name as defined by the customer with the OpenStack Environment (example: ext-net) in the search filter. This brings up a new dialog.
14.

Select the appropriate network by selecting the "+" on the right side of the flavor listings. This adds the external network interface to the Launch Instance dialog.
15.

Select Key Pair. This dialog assumes you have already uploaded a public key to to OpenStack (see Prerequisites).
16.

Select the appropriate key by selecting the "+" on the right side of the key pair listings. This adds the public key to the authorized_keys file on the Bootstrap Host.
17.

Select Configuration. This screen allows the user to add configuration data which is used by cloud-init to set on the VM, the initial admusr and hostname/FQDN additions to the /etc/hosts file. Use the following configuration until there is more information available. This must be copied into the Customization Script text box. Make sure the fields marked as <instance_name_from_details_screen> are updated with the instance name you used in step 5 above. Leave the other fields on this dialog in their default setting.
#cloud-config
   hostname: <instance_name_from_details_screen>
   fqdn: <instance_name_from_details_screen>
   system_info:
     default_user:
       name: admusr
       lock_passwd: false
   write_files:
     - content: |
         127.0.0.1  localhost localhost4 localhost4.localdomain4 <instance_name_from_details_screen>
         ::1        localhost localhost6 localhost6.localdomain6 <instance_name_from_details_screen>
       path: /etc/hosts
       owner: root:root
       permissions: '0644'
18.

Select Launch Instance at the lower right side of the initial dialog. This will launch the creation of the VM. This can be observed back at the Compute→Instances screen.