Configuring OpenStack images
On the image, install a package for cloud initialization.
- If you use a Linux™ image, install the cloud-init
package, version 0.7.5 or version 0.7.6. This package is available from the Red Hat Network (RHN)
common channel. On Linux images, you can often install
cloud-init with the package manager. For example, if you are using a Red Hat Enterprise Linux (RHEL) version 7 image, you can enable the common
repository and install cloud-init with the following
You might need to adapt this command for your distribution of Linux. For example, for RHEL version 6, substitute the repository
yum install --enablerepo rhel-7-server-rh-common-rpms cloud-init
rhel-6-server-rh-common-rpmsin this command. If you have a problem enabling the common repository, you might need to subscribe to the common channel with a command that is similar to the following example:
Then, try running the install command again.
subscription-manager repos --enable=rhel-7-server-rh-common-rpms
The following instructions assume that cloud-init was installed by the yum package manager. You might need to adapt these instructions to work with other package managers or other distributions of Linux.
- If you use a Windows™ image, install the cloudbase-init package. Download it from https://www.cloudbase.it/downloads/CloudbaseInitSetup_Beta.msi and install it by following the procedure at http://www.cloudbase.it/cloud-init-for-windows-instances/. Accept the default values, and ensure that the user name is Administrator.
- If you use a Linux™ image, install the cloud-init package, version 0.7.5 or version 0.7.6. This package is available from the Red Hat Network (RHN) common channel. On Linux images, you can often install cloud-init with the package manager. For example, if you are using a Red Hat Enterprise Linux (RHEL) version 7 image, you can enable the common repository and install cloud-init with the following command:
On a Linux image, enable password access through SSH for
the root user:
- Open the file /etc/cloud/cloud.cfg in a text editor.
Remove any lines of code that begin with
Add the following line of code:
- Save your changes to the file.
Open ports that are required to communicate with your IBM® UrbanCode® Deploy server.
By default, open ports 8080 and 8843 to communicate with the server and port 7918 to allow the agent that the blueprint designer installs to communicate with the server. See Firewall and communication configuration.
- Optional: Configure the image to resize the file system in response to disk size changes. See OpenStack Linux image requirements.
If you want to run Chef roles on the image, run the automated script to install the heat-config
toolchain on the image.
Note: Chef roles are supported only on RHEL version 6 and version 7 images.
Download and extract the file os-chef-config-hook.tgz.
This file is provided in the Heat engine installation media and is in the following location: /installation_files_location/ibm-ucd-patterns-install/engine-install/resources
- Copy the file install.sh to a temporary folder, such as /tmp/install_chain.
- On the command line, move to the temporary folder.
Run the following command:
This command might take several minutes to complete.
./install.sh > install.log 2>&1
Verify that the command ran successfully by looking at the end of the file
If the command ran successfully, the end of this file shows the output of the os-collect-config command, as in the following example:
+ cat /etc/os-collect-config.conf [DEFAULT] command = os-refresh-config + os-collect-config --one-time --debug 2015-08-14 13:51:30.764 27527 WARNING os_collect_config.ec2 [-] ('Connection aborted.', error(101, 'Network is unreachable')) 2015-08-14 13:51:30.765 27527 WARNING os-collect-config [-] Source [ec2] Unavailable. 2015-08-14 13:51:30.765 27527 WARNING os_collect_config.cfn [-] No Access Key ID configured. 2015-08-14 13:51:30.766 27527 DEBUG os-collect-config [-] Source [cfn] Not configured. collect_all /usr/lib/python2.6/site-packages/os_collect_config/collect.py:153 2015-08-14 13:51:30.766 27527 WARNING os_collect_config.heat [-] No auth_url configured. 2015-08-14 13:51:30.766 27527 DEBUG os-collect-config [-] Source [heat] Not configured. collect_all /usr/lib/python2.6/site-packages/os_collect_config/collect.py:153 2015-08-14 13:51:30.767 27527 WARNING os_collect_config.request [-] No metadata_url configured. 2015-08-14 13:51:30.767 27527 WARNING os-collect-config [-] Source [request] Unavailable. 2015-08-14 13:51:30.767 27527 WARNING os_collect_config.local [-] /var/lib/os-collect-config/local-data not found. Skipping 2015-08-14 13:51:30.767 27527 WARNING os_collect_config.local [-] No local metadata found (['/var/lib/os-collect-config/local-data']) 2015-08-14 13:51:30.768 27527 DEBUG os-collect-config [-] No changes detected. __main__ /usr/lib/python2.6/site-packages/os_collect_config/collect.py:274
Set the communications interval for the image to communicate with the Heat engine.
The polling_interval parameter is the frequency in seconds with which the image communicates with the Heat engine. By default, the polling_interval is 30 seconds, but the default value can cause excessive engine load. To modify this value, open the /etc/os-collect-config.conf configuration file and add the following text:
In this case, the polling_interval value is
polling_interval = 90
Ensure that the polling_interval value is short enough that the virtual machine can collect any changes from the Heat engine before the stack timeout elapses. The default timeout value is 60 minutes, but you can set the timeout value for each cloud. See Creating cloud projects for the blueprint designer.
Verify that the Chef client is running.
On the command line, run the following command:
chef-client -vThe version number is displayed. If the Chef client is not running, manually install it. See Chef Downloads: Chef Client.
Verify that the knife command-line tool is running.
On the command line, run the following command:
knife -vThe version number is displayed. If the knife command-line tool is not running, manually configure the Chef development kit. See Install the Chef DK.
- Download and extract the file os-chef-config-hook.tgz.
Shut down the image with the following command:
shutdown -h now
Upload the image to your cloud.
For more information, see the documentation for your cloud system.