Initiate installation through PowerVC operations manager

Edit online

The PowerVC Operations Manager (OpsMgr) is a collection of utilities and services that are designed to facilitate end-user operation of PowerVC clusters like install, upgrade, backup, and restore.

This topic explains the procedure for installing opsmgr utility and the procedure of installing PowerVC on single node and multinode.

Notes:

Legacy install of PowerVC is not supported for add node, replace node, resync node, compute plane node registration, and monitoring features.
For SLES, ensure that all SELinux components are installed by using YaST. Refer to corresponding SELinux configuration documentation for SLES 15 SP3.
Make sure that SELinux is configured as mentioned here.
```
SELinux status: enabled
Loaded policy name: targeted
Current mode: permissive
```
After installing the SELinux packages and enabling the SELinux GRUB 2 boot parameters, reboot virtual machine to activate the configuration.
If the installation is interrupted at any point for various reasons; for example, an SSL error, you can always re-trigger the install procedure for successful installation. Use powervc-opsmgr install -c <clustername> -f -k -s to retry installation.
Pacemaker configuration for virtual IP is done using IP address and not hostname even if the hostname is provided.
In a multinode environment, PowerVC installation must be initiated from the primary / bootstrap node only.
In multinode setup of PowerVC, at any given time more than n/2 nodes need to be active for the cluster to maintain quorum. Here n is the number of PowerVC nodes.
Ansible 2.9 is the supported version, which is shipped along with PowerVC installer starting 2.1.0 release.
Make sure you disable IPv6 before proceeding with install procedure. For details, see Disable IPv6 topic.

Installing `opsmgr` utility

After extracting the powervc-opsmgr-<OS-architecture-release>.tgz file, go to powervc-opsmgr/ directory.
Run setup_opsmgr.sh script to accept the license. Alternatively, you can run <path>/setup_opsmgr.sh -s to perform silent installation.

PowerVC `OpsMgr` operations and commands

After installing OpsMgr, you can perform several operations. For instructions to use the OpsMgr utility, open a command line and enter the command name followed by --help. For example, powervc-opsmgr --help.

Table 1. PowerVC `opsmgr` commands and descriptions
Operation	Description
Inventory	When creating an inventory using the hostname, make sure it exactly matches the VM hostname. Captures inputs from admin user (inventory), which include the number of nodes for PowerVC deployment and credentials, edition, firewall configuration option, VIP, and so on. This operation stores information in a file (YAML format) that is used for subsequent operations like install, update. Lists all inventory information (both entities, such as clusters, roles, nodes and their properties). Deletes inventory file if not needed. To create inventory, run powervc-opsmgr inventory -c <cluster_name> command. For help related to inventory sub-commands, run `powervc-opsmgr inventory --help`.
Install	Runs prerequisites on nodes by using command powervc-opsmgr install -c <cluster_name> -p. Performs check on all installation prerequisites. Initiates PowerVC installation across the specified number of nodes where the number of nodes can be 1 or 3. Run powervc-opsmgr install subcommand to perform this operation. The platform of the nodes (corresponding to PowerVC Management Plane) must be consistent and uniform; all nodes must be of the same OS, architecture, version. Mismatch of RHEL and SLES nodes is not supported. The input provided by the user/admin as part of the inventory input operation is used as the basis for installation. So, inputs that are provided like firewall configuration, edition are considered for deployment across all the nodes. To start installation, run powervc-opsmgr install -c <cluster_name> command. For help related to install sub-commands, run `powervc-opsmgr install --help`.
Monitoring	Manages PowerVC monitoring components.
Upgrade to Private Cloud	Upgrades IBM PowerVC to IBM PowerVC for Private Cloud.
Apply iFix	To apply iFixes to the PowerVC single or multinode cluster installed.
Backup / Restore	Run powervc-opsmgr backup and powervc-opsmgr restore subcommands respectively for backup and restore. For PowerVC version 2.1.0, backup and restore commands support the ability to backup / restore single and multiple nodes.
Replace node	In a case where a node is unusable or the node is down, this operation supports replacing it with a new node by forcibly removing a node and attempting a new deployment with the new node’s information added to inventory. Run powervc-opsmgr replacenode subcommand to run this operation.
Uninstall	Run powervc-opsmgr uninstall subcommand to perform this operation. This operation uninstalls all PowerVC packages / services from all the nodes that constitute a PowerVC deployment. This operation uninstalls OpsMgr components that are installed on all nodes based on the user's choice.
Add nodes	Use this operation to move from single node to multinode.
Resync node	Use this operation to resync conf files post recovery of a node.
Update	To update PowerVC management plane.
Configuration settings	To manage PowerVC OpsMgr configuration settings such as IP address, users, and so on.

Virtual IP (VIP) considerations

Consider the following while installing OpsMgr.

A virtual IP (VIP) must be a free IP from the same subnet as PowerVC nodes. Using advanced option, you can create node VIP and node IP from a different subnet. For details, see .Create VIP and node IP from different subnet.
All nodes must have same status of firewalld service.
Validate VIP during sudden failure of a node that holds the VIP.

Installing PowerVC on single node or multinode

Using OpsMgr, you can create a single node or multinode (3 nodes) PowerVC cluster. The cluster can be extended up to 5 nodes.

Examples:

Inventory creation for PowerVC on a single node

 
[root@controller]# powervc-opsmgr inventory -c <clustername>
+--------------------------------------------------------------------------------+
|                               PowerVC Inventory                                |
+--------------------------------------------------------------------------------+
   PowerVC Install options
	Install Private cloud edition(y/n)  : Select y to proceed with installation of PowerVC for Private Cloud.
	Configure Firewall (y/n)            : Select y to configure firewall.
	Legacy Installation (y/n)           : Select n to proceed with default installation of PowerVC for Private Cloud.
+--------------------------------------------------------------------------------+
   PowerVC Nodes
	Enter the number of nodes           : Specify number of nodes, which can be 1.
+--------------------------------------------------------------------------------+
   INFO:
     Primary/Bootstrap Node
  	* First node specified will be considered as primary or bootstrap node.
     Sudo User
  	* Sudo user with same username and password across all nodes is required.
+--------------------------------------------------------------------------------+
   PowerVC Node(s) Information
     Node 1
	Enter IP/Hostname for Node 1        : <IP or Hostname>
	Enter Username for Node 1           : root
	Enter Password for Node 1           :
+--------------------------------------------------------------------------------+
   VirtualIP
	Enter Virtual IP                    : <IP or Hostname>
+--------------------------------------------------------------------------------+

+--------------------------------------------------------------------------------+
|                          PowerVC Inventory - <clustername>                     |
+--------------------------------------------------------------------------------+
	Cluster Name              : <clustername>
	Cluster ID                : 51332088-7678-406f-80a4-1c9cb3ea5164
	Install Method            : cluster
	Edition                   : private_cloud
	Firewall Config           : True
	Monitoring                : False
	Login User                : root
	Virtual IP                : <IP>
	Primary/Bootstrap Host    : <IP or Hostname>
	Hosts                     : <IP or Hostname>
+--------------------------------------------------------------------------------+
|                   *** End of PowerVC Inventory - <clustername> ***             |
+--------------------------------------------------------------------------------+

Establishing passwordless connection

PLAY [Configure SSH Keys] ******************************************************

.
.
.
.

SSH Key exchange successfully completed at, 2022-09-27 05:49:28.,
 Refer to
 /opt/ibm/powervc-opsmgr/ansible/artifacts/powervc-opsmgr_<clustername>_ssh_key_xchg_20220927_054912/stdout
 for more details.
Inventory file generated successfully at /opt/ibm/powervc-opsmgr/ansible/inventory/<clustername>


+--------------------------------------------------------------------------------+
|                          PowerVC Inventory - <clustername>                     |
+--------------------------------------------------------------------------------+
	Cluster Name              : <clustername>
	Cluster ID                : 51332088-7678-406f-80a4-1c9cb3ea5164
	Install Method            : cluster
	Edition                   : private_cloud
	Firewall Config           : True
	Monitoring                : False
	Login User                : root
	Virtual IP                : <IP>
	Primary/Bootstrap Host    : <IP or Hostname>
	Hosts                     : <IP or Hostname>
	Inventory Directory       : /opt/ibm/powervc-opsmgr/ansible/inventory/<clustername>
+--------------------------------------------------------------------------------+
|                   *** End of PowerVC Inventory - <clustername>  ***            |
+--------------------------------------------------------------------------------+

Inventory creation for PowerVC on multinode

 
[root@controller]# powervc-opsmgr inventory -c <clustername>
+--------------------------------------------------------------------------------+
|                               PowerVC Inventory                                |
+--------------------------------------------------------------------------------+
   PowerVC Install options
	Install Private cloud edition(y/n)  : Select y to proceed with installation of PowerVC for Private Cloud.
	Configure Firewall (y/n)            : Select y to configure firewall.
	Legacy Installation (y/n)           : Select n to proceed with default installation of PowerVC for Private Cloud.
+--------------------------------------------------------------------------------+
   PowerVC Nodes
	Enter the number of nodes           : Specify number of nodes, which can be a maximum of 3.
+--------------------------------------------------------------------------------+
   INFO:
     Primary/Bootstrap Node
  	* First node specified will be considered as primary or bootstrap node.
     Sudo User
  	* Sudo user with same username and password across all nodes is required.
+--------------------------------------------------------------------------------+
   PowerVC Node(s) Information
     Node 1
	Enter IP/Hostname for Node 1        : <IP or Hostname>
	Enter Username for Node 1           : root
	Enter Password for Node 1           :
     Node 2
	Enter IP/Hostname for Node 2        : <IP or Hostname>
	Enter Username for Node 2           : root
	Enter Password for Node 2           :
     Node 3
	Enter IP/Hostname for Node 3        : <IP or Hostname>
	Enter Username for Node 3           : root
	Enter Password for Node 3           :
+--------------------------------------------------------------------------------+
   VirtualIP
	Enter Virtual IP                    : <IP or Hostname>
+--------------------------------------------------------------------------------+

+--------------------------------------------------------------------------------+
|                          PowerVC Inventory - <clustername>                     |
+--------------------------------------------------------------------------------+
	Cluster Name              : <clustername>
	Cluster ID                : 51332088-7678-406f-80a4-1c9cb3ea5164
	Install Method            : cluster
	Edition                   : private_cloud
	Firewall Config           : True
	Monitoring                : False
	Login User                : root
	Virtual IP                : <IP>
	Primary/Bootstrap Host    : <IP or Hostname>
	Hosts                     : <IP or Hostname>
	                          : <IP or Hostname>
	                          : <IP or Hostname>
+--------------------------------------------------------------------------------+
|                   *** End of PowerVC Inventory - <clustername> ***             |
+--------------------------------------------------------------------------------+

Establishing passwordless connection

PLAY [Configure SSH Keys] ******************************************************

.
.
.
.

SSH Key exchange successfully completed at, 2022-09-27 05:49:28.,
 Refer to
 /opt/ibm/powervc-opsmgr/ansible/artifacts/powervc-opsmgr_<clustername>_ssh_key_xchg_20220927_054912/stdout
 for more details.
Inventory file generated successfully at /opt/ibm/powervc-opsmgr/ansible/inventory/<clustername>


+--------------------------------------------------------------------------------+
|                          PowerVC Inventory - <clustername>                     |
+--------------------------------------------------------------------------------+
	Cluster Name              : <clustername>
	Cluster ID                : 51332088-7678-406f-80a4-1c9cb3ea5164
	Install Method            : cluster
	Edition                   : private_cloud
	Firewall Config           : True
	Monitoring                : False
	Login User                : root
	Virtual IP                : <IP>
	Primary/Bootstrap Host    : <IP or Hostname>
	Hosts                     : <IP or Hostname>
	                          : <IP or Hostname>
	                          : <IP or Hostname>
	Inventory Directory       : /opt/ibm/powervc-opsmgr/ansible/inventory/<clustername>
+--------------------------------------------------------------------------------+
|                   *** End of PowerVC Inventory - <clustername>  ***            |
+--------------------------------------------------------------------------------+

After generation of inventory file, you can validate by running powervc-opsmgr inventory -l command.

Example:

[root@controller ~]# powervc-opsmgr inventory -l
+--------------------------------------------------------------------------------+
|                          PowerVC Inventory - <clustername>                     |
+--------------------------------------------------------------------------------+
	Cluster Name              : <clustername>
	Cluster ID                : 51332088-7678-406f-80a4-1c9cb3ea5164
	Install Method            : cluster
	Edition                   : private_cloud
	Firewall Config           : True
	Monitoring                : False
	Login User                : root
	Virtual IP                : <IP>
	Primary/Bootstrap Host    : <IP or Hostname>
	Hosts                     : <IP or Hostname>
+--------------------------------------------------------------------------------+
|                   *** End of PowerVC Inventory - <clustername> ***             |
+--------------------------------------------------------------------------------+

Start the installation by using the following method:

To verify that your environment meets all of the prerequisites, run powervc-opsmgr install -c <clustername> -p before starting the actual install.
Run powervc-opsmgr install -c <clustername> to start installation.
To use your RHSM subscription and enable repos on all nodes, you can use -s option. However, you can also choose to manually add repos by using your RHEL subscription.
You can use the below command to run the install CLI as a background
```
nohup powervc-opsmgr install -c <cluster_name> &
```

The installation log file can be found in the following location: /opt/ibm/powervc-opsmgr/ansible/artifacts/powervc-opsmgr_<cluster_name>_install_<time_stamp>/stdout.

After installation is complete, run powervc-opsmgr install -c <cluster_name> --validate-install to check the complete health status of all services.

Note: Installation of PowerVC on multinode fails when there is a network failure. In such a case, you need to run install with the nohup command.

Example:

nohup powervc-opsmgr install -c <cluster-name> &

Monitoring scenario

Consider this scenario when installing the PowerVC version 2.1.0 monitoring feature.

Install monitoring after PowerVC is installed: Run powervc-opsmgr inventory --list to check the variable value. If it is set to False you must update the inventory set the variable value to True. This can be done by manually editing the inventory file at /opt/ibm/powervc-opsmgr/ansible/inventory/<cluster_name>/group_vars/all/cluster.yml. Here <cluster_name> is the name passed to the -c option when creating the inventory. Set the inventory variable monitoring to True and then run powervc-opsmgr monitoring --install -c <cluster_name> command. Alternatively, you can bypass the value of the inventory monitoring variable with the --force option.. For example, powervc-opsmgr monitoring --install -c <cluster_name> --force.

For details about monitoring, see Planning for PowerVC monitoring.