Initiate installation through PowerVC operations manager

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, and compute plane node registration.
  • 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.
  • Make sure you disable IPv6 before proceeding with install procedure. For details, see Disable IPv6 topic.

Installing opsmgr utility

  1. After extracting the powervc-opsmgr-<OS-architecture-release>.tgz file, go to powervc-opsmgr/ directory.
  2. 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.

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.2.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.
  • The uninstall opsmgr script must be run to uninstall 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
	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
	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
	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
	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
	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
	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
	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:
  1. To verify that your environment meets all of the prerequisites, run powervc-opsmgr install -c <clustername> -p before starting the actual install.
  2. 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> &