IBM Cloud Orchestrator, Version 2.5

Installing the IBM Cloud Orchestrator extensions for Horizon

To support the IBM® Cloud Orchestrator functionality, you must extend the base OpenStack Horizon software to provide additional options in the OpenStack Dashboard.

Before you begin

Ensure that you copied the ICM_configure_ico_horizon_extensions.sh script from the IBM Cloud Orchestrator server, as described in Copying the IBM Cloud Orchestrator scripts to the OpenStack servers.

Depending on your installation and OpenStack distribution, you may need to adapt the script.

For IBM Cloud Manager with OpenStack, the self-service portal extensions must not be installed. For information about uninstall and disable it, see Uninstalling the self-service user interface on Linux.

About this task

The IBM Cloud Orchestrator extensions for Horizon provide the following capability in the OpenStack Dashboard:
  • Support for availability zones on domains and projects
  • Support for quotas on domains
  • Reassignment of onboarded virtual machines to other projects
  • Creation of a default project when a domain is created
  • Ability to add domain administrators to the default project of a domain

In this procedure, the example scripts directory on the OpenStack Controller is /opt/ico_scripts. Replace this value with the appropriate value for your installation.

Complete the following steps on each server where the Horizon service is installed.

Procedure

  1. Log on to the OpenStack Controller as a root user.
  2. Change directory to the directory where you store the IBM Cloud Orchestrator scripts:
    cd /opt/ico_scripts
  3. Set the environment to the correct OpenStack values and run the following command:
    source /root/openrc
    If the /root/openrc file is not provided by your OpenStack distribution, set the values manually, for example:
    export OS_USERNAME=admin
    export OS_PASSWORD=openstack1
    export OS_TENANT_NAME=admin
    export OS_AUTH_URL=http://192.0.2.68:5000/v2.0
    export OS_REGION_NAME=kvm-allinone2
    export OS_VOLUME_API_VERSION=2
  4. Review the ICM_configure_ico_horizon_extensions.sh script and adapt it to your installation if needed. Then run the following command:
    ./ICM_configure_ico_horizon_extensions.sh

Results

When you log in to the OpenStack Dashboard, you can work with the IBM Cloud Orchestrator extensions.