IBM Cloud Infrastructure Center

https://www.ibm.com/docs/en/cic
Admin
IBM Cloud Infrastructure Center is an enterprise infrastructure management solution that provides...
Tokens:209,158
Snippets:2,605
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### Installation menu example

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=images-creating-from-iso-kvm

Representation of the text-mode installation menu for the virtual machine.

```text
Installation

1) [x] Language settings                 2) [x] Time settings
   (English (United States))                (America/New_York timezone)
3) [x] Installation source               4) [x] Software selection
   (Local media)                            (Server)
5) [!] Installation Destination          6) [x] Kdump
   (No disks selected)                      (Kdump is enabled)
7) [ ] Network configuration             8) [x] Shell
   (Not connected)                          (Start shell)
9) [!] Root password                     10) [!] User creation
   (Password is not set.)                    (No user will be created)

   Please make a selection from the table before ['b' to begin installation, 'q' to quit,
   'r' to refresh]:
```

--------------------------------

### Verify prerequisites and initiate installation

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=cluster-deploy-multi-node

Use these commands to check environment readiness and start the cluster installation process.

```bash
icic-opsmgr install -c <clustername> -p
```

```bash
icic-opsmgr install -c <clustername>
```

--------------------------------

### Start virtual machine installation

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=images-creating-from-iso-kvm

Launch a virtual machine using the specified ISO and disk image.

```bash
virt-install --virt-type=kvm --name=rhel86 --vcpus=2 --memory=4096 --cdrom=/var/lib/libvirt/images/RHEL-8.6.0-20220420.0-s390x-dvd1.iso --disk path=/var/lib/libvirt/images/rhel86.qcow2,format=qcow2 --network default --graphics none
```

--------------------------------

### Start IBM Cloud Infrastructure Center installation

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-installing-cloud-infrastructure-center

Standard command to initiate the installation process as a root user.

```bash
./install
```

--------------------------------

### Start installation with automatic firewall configuration

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-installing-cloud-infrastructure-center

Commands to automatically configure firewall services during installation.

```bash
./install -c
```

```bash
./install -c --firewall-type iptables
```

--------------------------------

### Install and Configure Disconnected Scanner

Source: https://www.ibm.com/docs/en/cic/1.2.3?topic=tracking-running-license-metric-toolilmt-disconnected-scans

Execute the setup script to install the scanner, initialize configuration parameters, and perform an initial hardware scan.

```bash
[root@computenode1 LMT]# ./setup.sh
(2021-02-01 07:26:12) Starting configuration of Disconnected Scanner (linux 9.2.22.0)
(2021-02-01 07:26:12) Initializing configuration parameters of Disconnected Scanner
(2021-02-01 07:26:12) Disconnected Scanner will be configured in /root/LMT
(2021-02-01 07:26:12) User info: uid=0(root) gid=0(root) groups=0(root) context=unconfined_u:unconfined_r:unconfined_t:s0-s0:c0.c1023
(2021-02-01 07:26:12) System info (uname): Linux computenode1 4.18.0-193.el8.s390x #1 SMP Fri Mar 27 14:43:09 UTC 2020 s390x s390x s390x GNU/Linux
(2021-02-01 07:26:12) Starting CIT installation (linux-s390x)...
(2021-02-01 07:26:13) CIT installation successful
(2021-02-01 07:26:13) Preparing computer.yml file...
(2021-02-01 07:26:13) Preparing computer.yml finished
(2021-02-01 07:26:13) Preparing scanner_status.yml file...
(2021-02-01 07:26:13) Preparing scanner_status.yml finished
(2021-02-01 07:26:13) Running initial Hardware Scan...
(2021-02-01 07:26:13) Starting Hardware Scan script (linux 9.2.22.0)
(2021-02-01 07:26:13) Initializing configuration parameters of Disconnected Scanner
(2021-02-01 07:26:13) Starting Hardware Scan (HW)...
(2021-02-01 07:26:14) Hardware Scan was successful
(2021-02-01 07:26:15) Hardware Scan script finished
(2021-02-01 07:26:15) Initial Hardware Scan successful
(2021-02-01 07:26:15) Initializing configuration parameters of Disconnected Scanner
(2021-02-01 07:26:15) Checking if Hardware Scan is scheduled
(2021-02-01 07:26:15) Checking if Software Scan is scheduled
(2021-02-01 07:26:15) Checking if /root/LMT/automation/pack_results.sh is scheduled
(2021-02-01 07:26:15) Adding scheduled task for Hardware Scan
(2021-02-01 07:26:15) Hardware Scan schedule added successfully
(2021-02-01 07:26:15) Disconnected Scanner was succesfully configured
(2021-02-01 07:26:15) Script has finished installing and configuring Disconnected Scanner   
```

--------------------------------

### Start silent installation

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-installing-cloud-infrastructure-center

Initiates the installation process in silent mode.

```bash
./install -s
```

--------------------------------

### Install virt-install

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=images-creating-from-iso-kvm

Install the virt-install utility to facilitate virtual machine creation.

```bash
yum install virt-install
```

--------------------------------

### Start installation skipping SELinux checks

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-installing-cloud-infrastructure-center

Initiates the installation while bypassing SELinux enforcement checks.

```bash
./install -i
```

--------------------------------

### Combining packages for multinode (HA) installation

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=zs-install-cloud-infrastructure-center-feature-infrastructure-suite-zvm-linux

Copy the setup script from the installer directory to the core package directory.

```bash
cp /iiszinstaller/icic-x.x.x.x/setup_opsmgr.sh /iiszcore/icic-opsmgr-x.x.x.x
```

--------------------------------

### Define z/VM compute_user profile

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=hypervisors-planning-get-console-output-zvm

Example of a z/VM profile definition including the required console start command.

```text
PROFILE OSDFLT
COMMAND SET RUN ON
COMMAND SP CONS * START
MACHINE ESA
OPTION APPL CHPIDV ONE
CONSOLE 0009 3215 T
SPOOL 000C 2540 READER *
SPOOL 000D 2540 PUNCH A
SPOOL 000E 1403 A
*DVHOPT LNK0 LOG1 RCM1 SMS0 NPW1 LNGAMENG PWC20190829 CRCJL
```

--------------------------------

### Example Configuration Command

Source: https://www.ibm.com/docs/en/cic/1.2.1?topic=cluster-enable-storage-provider-high-availability

A concrete example of setting failover nodes for a specific storage host.

```bash
icic-opsmgr config openstackconfig -c icic1 -op set -file /etc/cinder/cinder.conf -section failover_nodes -property gpfs-14573663776078067384-icic_gpfs -value kvm4found3,kvm4found5
```

--------------------------------

### Activation Input example

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=images-creating-deploy-templates

Example of a shell script that logs output to a file upon instance startup.

```bash
#!/bin/bash
pwd >> /tmp/example.log
echo "test scripts" >> /tmp/example.log
```

--------------------------------

### Run installation in background

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=cluster-deploy-multi-node

Execute the installation process as a background task using nohup.

```bash
nohup icic-opsmgr install -c <cluster_name> &
```

--------------------------------

### Migrate compute node in standalone environment

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=descriptions-icic-migrate-command

Example of migrating a compute node from BOEM5401 to BOEM5403 in a standalone setup.

```bash
# sudo /opt/ibm/icic/bin/icic-migrate --storageHost v7k60 -t BOEM5403
LOG file: /opt/ibm/icic/log/icic_migrate_2021-02-18-233233.log

------ Pre_check -------
Pass: /etc/cinder/cinder-v7k60.conf found on management node
Pass: target_node BOEM5403 is valid.
Pass: source_node BOEM5401 found in database
Pass: source_node BOEM5401 found in conf /etc/cinder/cinder-v7k60.conf
Pass: backup_conf /etc/cinder/cinder-v7k60.conf_migr_bak created.

------ sftp_cinder_files_to_target_node -------
Pass: /opt/ibm/icic/data/known_hosts transfered to target_node
Pass: /etc/cinder/fabrics.conf transfered to target_node
Pass: /etc/cinder/rsakeys/cinder_v7k60_rsa transfered to target_node
Pass: temp conf /tmp/icic_temp_gwolpiqg.conf created on management node
Pass: temp conf /tmp/icic_temp_gwolpiqg.conf copied to target_node

------ create_service_on_target_node -------
Pass: service openstack-cinder-volume-v7k60 created on target_node
Pass: service openstack-cinder-backup-v7k60 created on target_node

------ remove_service_on_source_node -------
Pass: service openstack-cinder-volume-v7k60 removed on source_node
Pass: service openstack-cinder-backup-v7k60 removed on source_node
Pass: set node_name as BOEM5403 in database

------ start_service_on_target_node -------
Pass: service openstack-cinder-volume-v7k60 started on target_node
Pass: service openstack-cinder-backup-v7k60 started on target_node
Pass: backup_conf /etc/cinder/cinder-v7k60.conf_migr_bak deleted.

------ Completed ! -------
```

--------------------------------

### Combining packages for standalone installation

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=zs-install-cloud-infrastructure-center-feature-infrastructure-suite-zvm-linux

Copy the installer file into the core package image directory.

```bash
cp /iiszinstaller/icic-x.x.x.x/install /iiszcore/icic-opsmgr-x.x.x.x/images/icic-x.x.x.x/
```

--------------------------------

### Example: Port Creation and Verification

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=networks-working-security-grouprhel-kvm-only

A practical example of creating a port with a 'ping' security group and verifying the association.

```bash
$ openstack port create --network ovs-flat --security-group ping port5
$ openstack server create --image kvm88 --port port1  --flavor tiny VM5

$ openstack port show port5
+-------------------------+-----------------------------------------------------------------------------+
| Field                   | Value                                                                       |
+-------------------------+-----------------------------------------------------------------------------+
......
| security_group_ids      | e45db4d0-36a3-4680-8301-289a4a7d3484                                        |
......
```

--------------------------------

### Verify and Install OpenSSL

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=center-replacing-multi-node-cluster-certificate

Check for existing OpenSSL installation and install it if missing.

```bash
 rpm -qa|grep -i openssl
```

```bash
 yum install openssl
```

--------------------------------

### Install KVM dependencies

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=images-creating-from-iso-kvm

Install necessary libvirt and QEMU packages for KVM management on s390x architecture.

```bash
yum install libvirt-daemon-kvm.s390x qemu-kvm-ma.s390x qemu-kvm-tools-ma.s390x qemu-kvm qemu-img virt-manager libvirt libvirt-python virt-manager libvirt-client virt-install virt-viewer -y
```

--------------------------------

### Install bind-utils

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=verification-verify-management-node-compute-nodes-network-connectivity

Install the bind-utils package to provide the nslookup command if it is missing.

```bash
yum install -y bind-utils
```

--------------------------------

### Mounting the Installation ISO

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=cluster-initiate-installation-through-operation-manager

Commands to create a mount point and mount the installation ISO image from the disc drive.

```bash
mkdir -p /media/iso
mount -t iso9660 -o ro /dev/sr0 /media/iso
 
```

--------------------------------

### Install required packages

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=verification-set-up-management-compute-node

Commands to install essential utilities on management and compute nodes.

```bash
sudo dnf install tar
```

```bash
sudo dnf install psmisc
```

--------------------------------

### Copy and extract the installation package

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-upgrading-cloud-infrastructure-center-from-120-121

Commands to navigate to the images directory, copy the installer, and extract it to the target location.

```bash
 cd icic-opsmgr-1.2.2.0/images/
 cp icic-install-s390x-rhel-1.2.2.0.tgz /extract_location
 tar -xvf /extract_location/icic-install-s390x-rhel-1.2.2.0.tgz
```

--------------------------------

### List all existing backups response example

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=apis-manage-virtual-machine-backuprestore-operation

Example JSON response body returned when listing backups for an instance group.

```json
[
    { "id"="43fdfa2d-...",

      "group_id"="b9604273-...",

      "project_id"="18ab1...",

      "user_id"="c9be5...",

      "name"="backup1",

      "description"="group backup for instance 85scsi3_backup",

      "status"="available",

      "group_type_id"="ef1322a1-...",

      "backups"=[{"id": "7ab5017f-...",
                  "user_id": "c9be5...",
                  "project_id": "18ab1...",
                  "volume_id": "9314dbb9-...",
                  "availability_zone": 'null',
                  "container": "b9604273-...",
                  "parent_id": 'null', 
                  "parent": 'null',
                  "status": "available", 
                  "fail_reason": 'null',
                  "size": 10, 
                  "display_name": "backup1",
                  "display_description": "backup for ...",
                  "service_metadata": "volume_9314dbb9-...",
                  "service": "cinder.backup.drivers.posix.PosixBackupDriver",
                  "object_count": 40, 
                  "temp_volume_id": 'null',
                  "temp_snapshot_id": 'null',
                  "num_dependent_backups": 0,
                  "snapshot_id": "94fbda1e-...",
                  "data_timestamp": "2022-10-31 02:41:00",
                  "restore_volume_id": 'null',
                  "metadata": {
                  "instance_group_id": "b9604273-...1",
                  "group_snapshot_id": "43fdfa2d-...",
                  "instance_id": "f9c4d3b4-...",
                   "mountpoint": "/dev/vda"},
                  "encryption_key_id": 'null',
                  "created_at": "2022-10-31 02:41:05"}],

      "created_at"="2022-10-31 02:41:00"}]
```

--------------------------------

### Uninstall using installation script

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-uninstalling-cloud-infrastructure-center

Execute this command from the directory containing the original installation files to initiate the uninstallation process.

```bash
./install -u
```

--------------------------------

### Retrieve list of storage providers response example

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=apis-retrieve-additional-metrics-storage-providers

Example JSON response body returned when querying the list of storage providers.

```json
{
    "storage_providers": [
        {
            "id": 1,
            "storage_hostname": "9_152_89_41"
        },
        {
            "id": 2,
            "storage_hostname": "9_60_63_219"
        }
    ]
}
```

--------------------------------

### GET /v3/projects/

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=apis-supported-openstack-identity-keystone

Lists all available projects.

```APIDOC
## GET /v3/projects/

### Description
Lists projects.

### Method
GET

### Endpoint
/v3/projects/
```

--------------------------------

### Setting host interface environment variable

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-installing-cloud-infrastructure-center

Example of setting the network interface for silent installations.

```bash
export HOST_INTERFACE=eth1
```

--------------------------------

### View storage migration help

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=descriptions-icic-config-storage-migration

Displays the help menu and available arguments for the storage migration command.

```bash
# icic-config storage migration -h
```

--------------------------------

### Initiate cold migration

Source: https://www.ibm.com/docs/en/cic/1.2.1?topic=machines-cold-migrate-virtual

Use this command to start the cold migration process for a specific virtual machine instance.

```bash
$ openstack server migrate VM_INSTANCE
```

--------------------------------

### Swift installation prompt

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=cluster-swift-object-storage-multi-node-deployment

The configuration prompt displayed during inventory creation to enable or disable Swift as the backend storage.

```text
Use the object storage provided by the IBM Cloud Infrastructure Center to store the images, image backups and volume backups? If 'n' is selected, it means you have external shared storage available and you must configure the IBM Cloud Infrastructure Center to store images, image backups and volume backups to your share storage after installation done. (y/n)
```

--------------------------------

### SELinux enforcement error message

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-installing-cloud-infrastructure-center

Example of the error output displayed if SELinux is not enforced during installation without the -i flag.

```text
SELINUX is not enforced! Enable and enforce SELINUX, then try to install again.
The installation has exited with error code 266.
```

--------------------------------

### Retrieve PCHID allocation details response

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=apis-get-allocation-details-all-pchids

Example JSON response structure returned by the GET request to the pchids endpoint.

```json
{
    "pchids": [
        {
            "cpc_sn": "00000000000282A8",
            "cpc_name": "T46",
            "pchids": [
                {
                    "pchid": "0264",
                    "allocated_ratio": "0.00%",
                    "allocated_total": 0,
                    "allocated_to_vm": 0,
                    "allocated_to_compute": 0,
                    "allocated_to_management": 0,
                    "free_capacity": 128,
                    "max_capacity": 128,
                    "pchid_details": [
                        {
                            "hypervisor_hostname": "BOET4602",
                            "host_display_name": "zvm51",
                            "allocated_total": 0,
                            "allocated_to_compute": 0,
                            "allocated_to_management": 0,
                            "allocated_to_vm": 0,
                            "allocated_fcps": ""
                        }
                    ]
                },
                {
                    "pchid": "0260",
                    "allocated_ratio": "0.78%",
                    "allocated_total": 1,
                    "allocated_to_vm": 0,
                    "allocated_to_compute": 1,
                    "allocated_to_management": 0,
                    "free_capacity": 127,
                    "max_capacity": 128,
                    "pchid_details": [
                        {
                            "hypervisor_hostname": "BOET4602",
                            "host_display_name": "zvm51",
                            "allocated_total": 1,
                            "allocated_to_compute": 1,
                            "allocated_to_management": 0,
                            "allocated_to_vm": 0,
                            "allocated_fcps": "E830"
                        }
                    ]
                },
                {
                    "pchid": "0240",
                    "allocated_ratio": "0.78%",
                    "allocated_total": 1,
                    "allocated_to_vm": 0,
                    "allocated_to_compute": 1,
                    "allocated_to_management": 0,
                    "free_capacity": 127,
                    "max_capacity": 128,
                    "pchid_details": [
                        {
                            "hypervisor_hostname": "BOET4602",
                            "host_display_name": "zvm51",
                            "allocated_total": 1,
                            "allocated_to_compute": 1,
                            "allocated_to_management": 0,
                            "allocated_to_vm": 0,
                            "allocated_fcps": "E830"
                        }
                    ]
                }
            ]
        }
    ]
}
```

--------------------------------

### Initiate Live Migration

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=machines-live-migrate-virtual-in-kvm

Executes a live migration for a specified virtual machine instance.

```bash
$ openstack server migrate --live-migration VM_INSTANCE
```

--------------------------------

### GET /v2.1/{tenant_id}/os-simple-tenant-usage

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=apis-supported-openstack-compute-nova

Gets usage for all tenants.

```APIDOC
## GET /v2.1/{tenant_id}/os-simple-tenant-usage

### Description
Gets usage for all tenants.

### Method
GET

### Endpoint
/v2.1/{tenant_id}/os-simple-tenant-usage

### Parameters
#### Path Parameters
- **tenant_id** (string) - Required - The ID of the tenant.
```

--------------------------------

### Sample complete Ignition configuration file

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=images-creating-deploy-templates

A comprehensive example combining source merging, TLS certificate authorities, and HTTP authentication headers.

```json
{
  "ignition": {
    "config": {
      "merge": [{
        "httpHeaders":[{"name":"X-Auth-Token","value":"tokenstring"}],
        "source": "https://static.example.com/ignition.conf",
        "verification":{}
        }]
    },
    "security": {
      "tls": {
        "certificateAuthorities": [{
          "source": "data:text/plain;charset=utf-8;base64,<base64_encoded_certificate>"
        }]
      }
    },
    "version": "3.1.0"
  }
}
```

--------------------------------

### Swift Subcommand Help

Source: https://www.ibm.com/docs/en/cic/1.2.4?topic=ciccd-introduction-icic-config-storage-backup-service-command-tool

Display help information for the Swift backup driver configuration.

```bash
# icic-config storage backup-service swift -h
usage: icic-config storage backup-service swift [-h] --storageHost HOST
                                                [--restart]

Enables Cinder Swift backup driver in multi tenant mode. Only Keystone v3 auth
system is supported.

optional arguments:
  -h, --help          show this help message and exit
  --storageHost HOST  REQUIRED, the storage provider host to which changes are
                      to be made. The list of candidate hosts can be obtained
                      from the 'openstack volume service list' command, and
                      the 'Host' column of the output.
  --restart           Restart the Cinder backup service.  If this option is
                      not specified, you must manually restart the services
                      for changes to take effect.
```

--------------------------------

### GET /v2.0/routers/{router_id}

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=apis-network-neutron

Gets detailed information of a specified router.

```APIDOC
## GET /v2.0/routers/{router_id}

### Description
Gets detailed information of a specified router.

### Method
GET

### Endpoint
/v2.0/routers/{router_id}

### Parameters
#### Path Parameters
- **router_id** (string) - Required - The unique identifier of the router.
```

--------------------------------

### Sample IODF configuration file structure

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=standalone-locate-your-iodf-file

This configuration file illustrates the [classic], [hcd], and [resource_allow_list] sections required for Z16 host integration.

```ini

[classic]
hmc = xx.xx.xx.xx
cpc_object_id = uuid of the CPC
iocds_slots = A1,A2
storage_max_channel_paths = 4
hmc_username = HMCUserName
hmc_password = aes-ctr:encryptedpassword
network_max_channel_paths = 2
hmc_cpc_name = <HOST_NAME>


[hcd]
server = xx.xx.xx.xx
password = aes-ctr:encryptedpassword
port = 51106
encrypt_handler = powervc_keystone.encrypthandler.EncryptHandler
user = <HCDUSERNAME>
java_home = /opt/ibm/ibm-semeru-certified-17-jre
iodf = <HCDUSERNAME>.<PROD_IODF_NAME>.<HCD_GROUP_NAME>.WORK example: TEST5.IODF24.HCDGRP.WORK
current_active_processor_token = 00000009A44839311109401111111111

[resource_allow_list]
allow_list = /etc/nova/<HCD_GROUP_NAME>_allowlist.json
 
```

--------------------------------

### Execute onboard-volumes command

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=descriptions-icic-config-onboard-volumes

Basic syntax for running the volume onboarding command with host and instance parameters.

```bash
icic-config compute onboard-volumes --hostname <host_name> --instance_id <instance_id>
```

--------------------------------

### Extract the installer package

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-upgrading-cloud-infrastructure-center-from-120-121

Command to extract the operations manager installer archive.

```bash
tar -xzvf icic-opsmgr-s390x-rhel-1.2.2.0.tgz
```

--------------------------------

### Install OpenSSL

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=center-replacing-messaging-certificates

Install the OpenSSL package using the yum package manager.

```bash
   yum install openssl
```

--------------------------------

### Check OpenSSL Installation

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=center-replacing-messaging-certificates

Verify if the OpenSSL package is currently installed on the system.

```bash
   rpm -qa|grep -i openssl
```

--------------------------------

### Run standalone to HA conversion script

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=mnc-convert-cloud-infrastructure-center-standalone-deployment-multi-node-cluster-deployment

Executes the setup script to initiate the conversion process and displays the interactive license agreement prompt.

```bash
 ./setup_opsmgr.sh --icic-to-ha
 ################################################################################
 Starting the IBM Cloud Infrastructure Center:setup_prepnode 1.2.4.0 installation on:
 2023-06-05T22:17:06-04:00
 ################################################################################

 2023-06-05T22:17:06.10-04:00 [INFO]:[] IBM Cloud Infrastructure Center Opsmgr Standalone to HA conversion requires a backup to exist in the case of disaster recovery.
 2023-06-05T22:17:06.10-04:00 [INFO]:[] The more recent the backup the better to mitigate any data loss in the case of disaster recovery and we need to use this backup.
 2023-06-05T22:17:06.11-04:00 [INFO]:[] The following backup files were found at /var/opt/ibm/icic/backups/
 /var/opt/ibm/icic/backups/etc
 /var/opt/ibm/icic/backups/20230605214815065571
 2023-06-05T22:17:06.13-04:00 [WARNING]:[] These backups would only be used in the case of diaster recovery. Do these backups look OK and are the most recent? y
 2023-06-05T22:17:09.51-04:00 [WARNING]:[] IBM Cloud Infrastructure Center Opsmgr will be installed and will set the default python to 3.6 at system level
 2023-06-05T22:17:09.51-04:00 [INFO]:[VALIDATION] BASE DIRECTORY : /opt/ibm/icic-opsmgr
 2023-06-05T22:17:09.52-04:00 [INFO]:[VALIDATION] INSTALL SCRIPT : /root/icic-opsmgr-1.2.4.0/setup_opsmgr.sh
 2023-06-05T22:17:09.52-04:00 [INFO]:[VALIDATION] LOG FILE : /opt/ibm/icic-opsmgr/log/prep_node/prep_node_2023-06-05-2217.log
 2023-06-05T22:17:09.53-04:00 [INFO]:[VALIDATION] OPERATING SYSTEM: Red Hat Enterprise Linux.
 2023-06-05T22:17:09.54-04:00 [INFO]:[VALIDATION] User ID : ****
 International Program License Agreement

 Part 1 - General Terms

 BY DOWNLOADING, INSTALLING, COPYING, ACCESSING, CLICKING ON
 AN "ACCEPT" BUTTON, OR OTHERWISE USING THE PROGRAM,
 LICENSEE AGREES TO THE TERMS OF THIS AGREEMENT. IF YOU ARE
 ACCEPTING THESE TERMS ON BEHALF OF LICENSEE, YOU REPRESENT
 THAT YOU HAVE FULL AUTHORITY TO BIND LICENSEE TO THESE
 TERMS.

 IF YOU DO NOT AGREE TO THESE TERMS OR DO NOT HAVE
 AUTHORITY: i) DO NOT DOWNLOAD, INSTALL, COPY, ACCESS, CLICK
 ON AN "ACCEPT" BUTTON, OR USE THE PROGRAM; AND ii) PROMPTLY
 RETURN THE UNUSED MEDIA, DOCUMENTATION, AND PROOF OF

 Press Enter to continue viewing the license agreement, or
 enter "1" to accept the agreement, "2" to decline it, "3"
 to print it, "4" to read non-IBM terms, or "99" to go back
```

--------------------------------

### Validate installation health

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=cluster-deploy-multi-node

Check the health status of all services after the installation completes.

```bash
icic-opsmgr install -c <cluster_name> --validate-install
```

--------------------------------

### View command usage help

Source: https://www.ibm.com/docs/en/cic/1.2.4?topic=ciccd-introduction-icic-config-storage-volume-creation-command-tool

Display the help message for the volume-creation command to see available arguments.

```bash
# icic-config storage volume-creation  -h/--help
usage: icic-config storage volume-creation  [-h/--help] [--action {block,unblock}] [--storage STORAGE] 

Command is used to block or unblock volume creation using a storage provider.

optional arguments:
  -h, --help            show this help message and exit
  --action {block,unblock}
                        Block or unblock the volume
  --storage STORAGE [STORAGE ...]
                        Provide the storage provider/s
```

--------------------------------

### Create empty qcow2 image

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=images-creating-from-iso-kvm

Initialize a new 10GB qcow2 disk image file for the virtual machine.

```bash
qemu-img create -f qcow2 /var/lib/libvirt/images/rhel86.qcow2 10G
```

--------------------------------

### GET /v2.1/{tenant_id}/os-hypervisors/{hypervisor_hostname}

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=apis-supported-openstack-compute-nova

Gets detailed information for the specified hypervisor.

```APIDOC
## GET /v2.1/{tenant_id}/os-hypervisors/{hypervisor_hostname}

### Description
Gets detailed information for the specified hypervisor.

### Method
GET

### Endpoint
/v2.1/{tenant_id}/os-hypervisors/{hypervisor_hostname}

### Parameters
#### Path Parameters
- **tenant_id** (string) - Required - The unique identifier of the tenant.
- **hypervisor_hostname** (string) - Required - The hostname of the hypervisor.
```

--------------------------------

### Extract the installation package

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=standalone-upgrading-cloud-infrastructure-center-from-120-121

Extract the downloaded installation package to access the necessary files for the upgrade.

```bash
tar -xzvf IBM_Cloud_Infrastructure_Center_1.2.2.tar.gz
```

--------------------------------

### Extracting Installation Packages

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=cluster-initiate-installation-through-operation-manager

Commands to extract the installation tarballs based on the specific licensing model.

```bash
tar -xzvf CD828023.tar
 
```

```bash
tar -xzvf CD8281501.tar
 
```

--------------------------------

### GET /v2.1/{tenant_id}/os-aggregates/{aggregate_id}

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=apis-supported-openstack-compute-nova

Gets details about a specified aggregate (host group).

```APIDOC
## GET /v2.1/{tenant_id}/os-aggregates/{aggregate_id}

### Description
Gets details about a specified aggregate.

### Method
GET

### Endpoint
/v2.1/{tenant_id}/os-aggregates/{aggregate_id}

### Parameters
#### Path Parameters
- **tenant_id** (string) - Required - The unique identifier of the tenant.
- **aggregate_id** (string) - Required - The unique identifier of the aggregate.
```

--------------------------------

### Prepare Posix Backup Directory

Source: https://www.ibm.com/docs/en/cic/1.2.4?topic=ciccd-introduction-icic-config-storage-backup-service-command-tool

Create a directory for backup archives on the Agent Node.

```bash
# sudo mkdir -p <backup_directory>
```

--------------------------------

### List IBM Storage Scale storage templates

Source: https://www.ibm.com/docs/en/cic/1.2.4?topic=ciccd-command-tool-introduction-icic-config-image-file-store-datadir

Use the --show flag to display all currently configured storage templates.

```bash
# icic-config image file-store-datadir --show
```

--------------------------------

### Restore Operation Response Examples

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=apis-manage-virtual-machine-backuprestore-operation

Example JSON responses for standard and asynchronous restore operations.

```json
{
    "operation": "restore",

    "success": true,

    "instance_id": "f9c4d3b4-f1bc-405a-a210-29e44dd85385",

    "group_id": "b9604273-6e94-4a8c-88b4-a994d101c841",

    "group_snapshot_id": "9f49f851-f523-43e8-99de-e894541643bf",

    "backup_id": [
        "8b07203f-6482-404d-bd28-e06be78b87fb"
    ],

    "volume_id": [
        "9314dbb9-f736-4a8b-b1dc-a056b0b1e88f"
    ]
}
```

```json
{
    "msg": "Restore request submitted"
}
```

--------------------------------

### Bring up the network interface

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=wvm-attach-detach-nic-network-interface-card-tofrom-virtual-machines

Assign an IP address to the interface and verify the configuration using ifconfig and ip commands.

```bash
# ifconfig enc1003 198.168.0.177/24 up
# ip a
4: enc1003: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
    link/ether 02:01:0e:00:00:0a brd ff:ff:ff:ff:ff:ff
    inet 198.168.0.177/24 brd 198.168.0.255 scope global enc1003
       valid_lft forever preferred_lft forever
    inet6 fe80::9e56:d144:b30c:aa98/64 scope link noprefixroute 
       valid_lft forever preferred_lft forever
```

--------------------------------

### Start the upgrade process

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=ks-upgrading-cloud-infrastructure-center-from-120-121

Commands to initiate either an interactive or silent upgrade of the management node.

```bash
./install
```

```bash
./install -s
```

--------------------------------

### Start monitoring services

Source: https://www.ibm.com/docs/en/cic/1.2.3?topic=monitoring-enabling-disabling-services

Start all non-running monitoring services across management and compute nodes.

```shell
icic-services start
```

--------------------------------

### Copy and extract the standalone installation package

Source: https://www.ibm.com/docs/en/cic/1.2.5?topic=zs-upgrading-cloud-infrastructure-center-from-123-124-125

Move the installation package to the target directory and extract its contents.

```bash
cd icic-opsmgr-1.2.5.0/images/
cp icic-install-s390x-rhel-1.2.5.0.tgz /extract_location
tar -xvf /extract_location/icic-install-s390x-rhel-1.2.5.0.tgz
```

--------------------------------

### Configure Swift Backup Driver

Source: https://www.ibm.com/docs/en/cic/1.2.4?topic=ciccd-introduction-icic-config-storage-backup-service-command-tool

Execute the swift subcommand to enable the Swift backup driver.

```bash
icic-config storage backup-service swift --storageHost <storage_host>
```

--------------------------------

### Create Certificate Directory

Source: https://www.ibm.com/docs/en/cic/1.2.2?topic=center-replacing-multi-node-cluster-certificate

Initialize the directory for storing new certificate files.

```bash
 mkdir /home/newcerts
```
Tokens:
Raw