Install IBM Cloud Infrastructure Center management node

This topic provides step-by-step instructions for installing and configuring the IBM Cloud Infrastructure Center (ICIC) management node on IBM z/VM, including prerequisites, repository setup, configuration, and installation procedures.

The ICIC management node serves as the centralized coordination hub, it ensures seamless deployment and administration of virtual machines (VMs) , storage infrastructure, and network resources.

Note: Before you proceed, ensure all prerequisites are met as described in Introduction to IBM Cloud Infrastructure Center setup on IBM z/VM.

Verify the repository configuration: Make sure that dnf has correctly added both the BaseOS and AppStream repositories on your Red Hat Enterprise Linux (RHEL) 8.10 system.

[management_node]# dnf repolist
repo id                                          repo name
rhel8.10-bistro_appstream                        Automatically added via cronjob on ... AppStream
rhel8.10-bistro_baseos                           Automatically added via cronjob on ... BaseOS

To avoid conflicts, disable or remove all other repositories using yum-config-manager (except BaseOS and AppStream).

Configure the web proxy settings (if required): Set the no_proxy environment variable to exclude ICIC system traffic from the proxy.

[management_node]# export no_proxy="localhost,127.0.0.1,.example.com"
# Replace `.example.com` with your management node's domain name.

Create the ICIC configuration file: Create /etc/icic/config.properties with the following content:
```
[management_node]# vi /etc/icic/config.properties
[icic configs]
physical_network=vlannet1
compute_instance_template=ins%05x
```
physical_network: The name of the network provider for VM connectivity. compute_instance_template: Template for VM user IDs.

For more information about the configuration file, see the official documentation.

Unpack the installation package: Extract the downloaded ICIC installation tarball.

[management_node icic_package]# tar -xzvf cd828158-per-Engine.tar.gz
icic-opsmgr-s390x-rhel-1.2.3.0.tgz
icic-opsmgr-1.2.3.0.tgz.sig
icicpublickey
readme.txt

Optionally, verify the binary file using openssl (refer to readme.txt for details):

[management_node icic_package]# openssl dgst -verify icicpublickey -keyform PEM -sha256 -signature icic-opsmgr-1.2.3.0
Verified OK

Extract the main installation package:

[management_node icic_package]# tar -xzvf icic-install-s390x-rhel-1.2.2.0.tgz
icic-opsmgr-1.2.3.0/
icic-opsmgr-1.2.3.0/images/
icic-opsmgr-1.2.3.0/images/RPM-GPG-KEY-ICIC
icic-opsmgr-1.2.3.0/images/icic-opsmgr.tgz
icic-opsmgr-1.2.3.0/images/icic-install-s390x-rhel-1.2.3.0.tgz
icic-opsmgr-1.2.3.0/images/setup_opsmgr.sh
icic-opsmgr-1.2.3.0/packages/
...
...
...

Set the network interface (optional): If you have multiple network interfaces, specify the dedicated one for ICIC:
```
[management_node icic_package]# export HOST_INTERFACE=eth1
```

Set the locale environment variables: Make sure that /etc/locale.conf contains:

LANG=en_US.UTF-8
LC_CTYPE=en_US.UTF-8

Verify with:

[management_node]# locale
LANG=en_US.UTF-8
LC_CTYPE=en_US.UTF-8
LC_NUMERIC="en_US.UTF-8"
LC_TIME="en_US.UTF-8"
...
...
...

Start the ICIC installation: Run the installer with -c to automatically configure firewalld:

[management_node] ./install -c

Sample output:

...
Creating the gnocchi database...
Creating tables for the keystone database...
Creating tables for the glance database...
Creating tables for the cinder database...
Creating tables for the neutron database...
Creating tables for the nova database...
Creating tables for the ceilometer database...
Creating tables for the bumblebee database...
Creating tables for the gnocchi database...
Populating services and roles in the keystone database...
Stopping all IBM Cloud Infrastructure Center services...
Starting all IBM Cloud Infrastructure Center services...
Restoring prerequisite settings
libsemanage.semanage_direct_remove_key: Removing last permissive_httpd_t module (no other permissive_httpd_t module exists at another priority).

Installing IBM Cloud Infrastructure Center
Installation task 6 of 7

Stopping all IBM Cloud Infrastructure Center services...
Starting all IBM Cloud Infrastructure Center services...

Cleaning up temporary and support files.
Installation task 7 of 7

The validation of IBM Cloud Infrastructure Center services post install was successful.

************************************************************
IBM Cloud Infrastructure Center installation successfully completed at xxx-xx-xx:12:00+02:00.
Refer to
/opt/ibm/icic/log/xxx-xx-xx-150035.log
for more details.

Use a web browser to access IBM Cloud Infrastructure Center at
https://icic.example.com
************************************************************

The ICIC web UI URL is shown in the output (for example, https://icic.example.com). Log in using the management node's root username and password. After installation, check the status of ICIC services (optional):

[management_node] /opt/ibm/icic/bin/icic-services status