Installing engines in interactive mode

In interactive mode, you install Heat orchestration engines for the blueprint design server by typing configuration information in a command-line program.

Before you begin

The IBM® UrbanCode™ Deploy installer can install engines for the blueprint design server only on Red Hat Enterprise Linux, version 6, service level 4 or later service levels within version 6. No other operating system is supported, including Red Hat Enterprise Linux, version 7 or later. To use a different operating system, you can install an OpenStack Heat engine manually on that operating system and then extend that engine for use with the blueprint design server; see Extending Heat orchestration engines.
The installer installs only OpenStack Juno engines. To use a different version of OpenStack, you can extend an existing Heat engine of that version; see Extending Heat orchestration engines. You can extend OpenStack Icehouse, Juno, and Kilo engines for use with the blueprint design server.
The operating system must have the most recent package updates. For more information, see Installing and Managing Software in the Red Hat Enterprise Linux customer portal.
Root access is required for installation.
The engine installs a MySQL database automatically. Therefore, you must install the engine on a system that does not currently have MySQL installed. If the system has MySQL installed, the engine installation fails.
The operating system must be configured with required packages and dependencies before you install the engine. The system might need network access to install these packages. Make sure that the system is connected to a package manager, such as a Yum server.
Make sure that your system meets the system requirements. See System requirements and performance considerations.
Make sure that your networks and firewalls allow communication on the required ports. See Firewall and communication configuration.
Install the prerequisite packages.
- For versions before 6.2.0.2, install the following packages:
  - gcc
  - gcc-c++
  - kernel-devel
  - mysql-devel
  - python-devel
  - genisoimage
  For example:
```
yum install -y gcc gcc-c++ kernel-devel mysql-devel python-devel genisoimage
```
- For version 6.2.0.2 and later, install the genisoimage package by running the following command:
```
yum install -y genisoimage
```
If you are using Red Hat Enterprise Linux, version 6, service level 4, update the packages python and python-libs:
```
yum update -y python python-libs
```
Remove the package akonadi if it is installed:
```
yum remove -y akonadi
```
Determine whether the program qpid is installed on the system:
```
service qpidd status
```
If the program qpid is running on the system, stop its service:
```
service qpidd stop
```
Gather the URL and account information for the OpenStack Keystone service, if available. Rather than having its own list of users, the blueprint design server imports accounts from authentication realms, including OpenStack Keystone services and LDAP servers. This Keystone service is required regardless of the type of cloud you are using. If you do not have a Keystone server, you can install one during the engine installation.

About this task

If you already have an engine, you can extend it for use with the blueprint designer. See Extending Heat orchestration engines.

If you already use a Keystone server, you can use it as your identity service for the blueprint design server. If you do not use a Keystone server, you can install one with the engine.

Procedure

Download and extract the installation files for the blueprint design server engine. These files are available for download from the IBM Passport Advantage® website. See the IBM UrbanCode Deploy download document.
Change to the ibm-ucd-patterns-install/engine-install/ directory.
From the command line, run ./install.sh to start the installation program.
The first question the installer asks is Have you satisfied these dependencies?. If you configured the system with the prerequisites for the engine, press Y.
Read the license agreements for the software package. Press Space to show one page at a time, or press F to show the entire license.
If you agree to the terms of all of the license agreements, press Y and then press Enter.
Specify the following information as the installation program prompts you. You can accept the default values (displayed within brackets) by pressing Enter. If two options are given, such as [Y/n], the capitalized option is the default value.
Enter the public host name that clients use to access this Heat orchestration engine.

Specify the public IP address or host name that other systems, such as the blueprint design server, use to access this system.

Enter the binding address for the Heat orchestration engine. Accept the default value to listen to all addresses that are available to the system.

Specify the IP address that the engine listens for requests on. Specify 0.0.0.0 to listen on all addresses that are available to the system.

Enter the OpenStack Identity endpoint URL to use for authorization for this Heat orchestration engine. Accept the default value to install Keystone.

Specify the complete URL of the Keystone server that you are using for your identity service, such as http://cloud.example.com:5000/v2.0. Do not include a trailing slash. If you do not have a Keystone server, specify the default location, http://public_host_name:5000/v2.0, to install and configure one.
Optional: After the installation program is complete, add an automated task to remove expired keys from the database. Having too many expired keys in the database can degrade system performance. For example, the following command creates an automated task in the Linux program cron to remove old keys. This command must be written on a single line.
```
 (crontab -l -u keystone 2>&1 | grep -q token_flush) 
  || echo '@hourly /usr/bin/keystone-manage token_flush 
  >/var/log/keystone/keystone-tokenflush.log 2>&1' 
  >> /var/spool/cron/keystone
```

Results

The installation program installs the engine.

What to do next

Start the engine services by running the following commands:

```
service openstack-heat-engine start
```
```
service openstack-heat-api start
```
```
service openstack-heat-api-cfn start
```

service openstack-heat-api-cloudwatch start

If you installed a Keystone server when you installed the engine, start it by running the following command:

service openstack-keystone start

This Keystone server's default administrative tenant user name is admin and password is openstack1. The authorization token is listed in the /etc/keystone/keystone.conf and /root/keystonerc file.

The engine installer started backend services that are required by the engine services. You can stop these services if you will not start the engine services now. If you stop these backend services while the engine services are running, you cause them to fail. The following commands terminate the backend services:

service rabbitmq-server stop

service mysqld stop

You can interact with the local identity service and pattern engine by using the prepared credentials files in your user directory:

source ~/clientrc

keystone endpoint-list

heat stack-list

After you start the engine services, you can access the REST API at the following URL: http://host_name:8004.

Feedback