Installing VM Recovery Manager DR

Edit online

The KSYS filesets must be installed on the identified logical partition (LPAR), which is preferably in the backup site. You can run the installp command or use the System Management Interface Tool (SMIT) panel to install the filesets on the LPAR.

Before you install the filesets, ensure that the following prerequisites are met:

  • You must have root authority to perform the installation tasks.
  • Identify the host that you will use to create the KSYS node. The host must be preferably in the backup site during the normal (non-disaster) conditions.
  • You must have already created an LPAR in the identified host that has IBM® AIX® 7.2 with Technology Level 1 Service Pack 1 (7200-01-01), or later, installed.
  • Ensure that you have enough space in this LPAR so that KSYS filesets can be installed successfully. You might want to have 30 MB of disk space in the /opt directory and 200 MB of disk space in the /var directory.
  • Before you install or upgrade VM monitor fileset, ensure that you set the virtual machine in the KSYS subsystem to unmanage, and run the discovery operation. Then, install or upgrade the VMM fileset at the VM. You can set the unmanaged virtual machine to managed depending on your requirement. You must run the discovery operation after you have set the unmanaged virtual machine to managed.

Installing the KSYS filesets

To install the KSYS filesets in the identified LPAR, complete the following steps:

  1. Ensure all the prerequisites that are specified in the Requirements topic are complete.
  2. Download the VM Recovery Manager DR software components from Entitled Systems Support (ESS) website: http://www.ibm.com/servers/eserver/ess/index.wss
  3. Copy the filesets to any location from where you want to install the filesets.
  4. Uncompress the filesets as per the guidelines that are provided with the package.
  5. Install the filesets by running the following command:
    installp -acFXYd fileset_location -V2 [-e filename.log] ksys.!(*vmmon*)
    The -V2 flag enables the verbose mode of installation. This command installs all ksys.* filesets except the ksys.vmmon.rte file. Alternatively, you can use the smit installp command with the all_latest option to install all filesets in the directory.
    Note:
    • This command also installs all GUI filesets, which includes GUI server filesets and GUI agent filesets.
    • The ksys.vmmon.rte file is an optional fileset and it should be installed on virtual machines. For more information, see Installing VM agents.
  6. Verify whether the installation of filesets is successful by running the following command:
    lslpp -l ksys.*
  7. Run the /opt/IBM/ksys/ksysmgr command to check the command line utility of the KSYS subsystem. The KSYS subsystem might take a few minutes to run the command for the first time. You can add the /opt/IBM/ksys directory to your PATH environment variable so that you can access the ksysmgr command easily.
  8. After successful installation of KSYS filesets, enter the following command to check whether the class IDs are reserved:
    cat /usr/sbin/rsct/cfg/ct_class_ids
IBM.VMR_HMC                                     510
IBM.VMR_CEC                                     511
IBM.VMR_LPAR                                    512
IBM.VMR_VIOS                                    513
IBM.VMR_SSP                                     514
IBM.VMR_SITE                                    515
IBM.VMR_SA                                      516
IBM.VMR_DP                                      517
IBM.VMR_DG                                      518
IBM.VMR_KNODE                                   519
IBM.VMR_KCLUSTER                                520
IBM.VMR_HG                                      521
IBM.VMR_APP                                     522
IBM.VMR_CLOUD                                   523
IBM.VMR_DP_CLD                                  524
IBM.VMR_SA_CLD                                  525
IBM.VMR_LPAR_CLD                                526
IBM.VMR_SITE_CLD                                527
IBM.VMR_VMG_CLD                                 528
IBM.VMR_APP_CLD                                 529
IBM.VMR_SITE_PVS                                530
IBM.VMR_WORKSPACE_PVS                           531
IBM.VMR_WG_PVS                                  532
IBM.VMR_LPAR_PVS                                533
    If any of the class IDs that are displayed in the preceding screen are missing in your output, add the missing entries in the /usr/sbin/rsct/cfg/ct_class_ids file before configuring the KSYS cluster.

Installing GUI filesets

To use the VM Recovery Manager DR and to manage KSYS nodes by using the graphical interface (GUI), you must install the GUI server and GUI agent filesets on a system. The logical partition in which you want to install the GUI filesets, must be running IBM AIX 7.2 with Technology Level 2 Service Pack 1 (7200-02-01), or later. You can choose to install the GUI server and GUI agent filesets on one of the KSYS nodes. You must install the following GUI server and GUI agent filesets before you start using the VM Recovery Manager DR GUI.

Depending upon your system environment and your requirement choose a procedure to install the GUI server and GUI agent filesets.
Installing the GUI server filesets and GUI agent filesets on the machine where KSYS filesets are installed
To install the GUI server and GUI agent filesets on the same machine where the KSYS filesets are already installed, complete the following steps.
  1. Ensure all the prerequisites that are specified in the Requirements topic are met.
  2. To install both the GUI server and the GUI agent filesets on one of the KSYS nodes, run the following command:
    installp -acFXYd fileset_location -V2 [-e filename.log] ksys.ui.server ksys.ui.agent ksys.ui.common
    Note: If you are using the AIX 7.3 operating system, you must install the mandatory efix on the GUI node as described in the Installing VIOS and KSYS interim fixes topic. If the agent and the sever nodes are different, you must install the efix on both the nodes.
  3. To install the open source software packages, which are not included in the installed filesets, choose one of the following procedures depending on your system environment:
    • If your system is connected to the internet, run the following command in your system:
      /opt/IBM/ksys/ui/server/dist/server/bin/vmruiinst.ksh
      This command downloads and installs the open source software packages that are not included in the filesets because these files are licensed under the GNU General Public License (GPL).
    • If your system is configured to use an HTTP proxy to access the internet, run the following command in your system to specify the proxy information:
      /opt/IBM/ksys/ui/server/dist/server/bin/vmruiinst.ksh -p
      You can also specify the proxy information by using the http_proxy environment variable.
    • If your system is not connected to the internet, complete the following steps:
      1. Copy the vmruiinst.ksh file from your system to a system that is running the AIX operating system and that has internet access.
      2. Run the vmruiinst.ksh -d /directory command where /directory is the location where you want to download the open source software packages. For example, /vmruiinst.ksh -d /tmp/vmrui_rpms. The following package managers are downloaded in the specified directory:
        • info-6.6-2.aix6.1.ppc.rpm
        • cpio-2.13-1.aix6.1.ppc.rpm
        • readline-8.0-2.aix6.1.ppc.rpm
        • libiconv-1.16-1.aix6.1.ppc.rpm
        • bash-5.0.18-1.aix6.1.ppc.rpm
        • gettext-0.20.2-1.aix6.1.ppc.rpm
        • libgcc10-10.3.0-6.aix7.3.ppc.rpm
        • libstdcplusplus10-10.3.0-6.aix7.3.ppc.rpm
          Note: The libgcc10-10.3.0-6.aix7.3.ppc.rpm and libstdcplusplus10-10.3.0-6.aix7.3.ppc.rpm packages listed above apply to AIX 7.3. For other supported AIX versions, the appropriate package versions are downloaded automatically based on the AIX version that is installed on the system.
      3. Copy the downloaded software packages to a directory in your system.
      4. In the your system, run the vmruiinst.ksh -i /directory command where /directory is the location where you copied the downloaded software packages.

    After the GUI filesets have been installed, a message displays the URL of the GUI dashboard. To use the VM Recovery Manager DR GUI, open a web browser and enter the following URL:
    HTTPS://<hostname>:3000/login.
    After you log in to the VM Recovery Manager DR GUI, you can register the KSYS and add the existing clusters to your environment.

Installing GUI server filesets
To install only the GUI server filesets on a machine where GUI agent filesets and KSYS filesets are not installed, complete the following steps:
  1. Ensure all the prerequisites that are specified in the Requirements topic are met.
  2. To install only GUI server filesets on a separate system that manages all the KSYS nodes, run the following command:
    installp -acFXYd fileset_location -V2 [-e filename.log] ksys.ha.license ksys.ui.server ksys.ui.common
    Note: If you are using the AIX 7.3 operating system, you must install the mandatory efix on the GUI node as described in the Installing VIOS and KSYS interim fixes topic. If the agent and the sever nodes are different, you must install the efix on both the nodes.
  3. To install the open source software packages, which are not included in the installed filesets, choose one of the following procedures depending on you system environment:
    • If your system is connected to the internet, run the following command in your system:
      /opt/IBM/ksys/ui/server/dist/server/bin/vmruiinst.ksh
      This command downloads and installs the open source software packages that are not included in the filesets because these files are licensed under the GNU General Public License (GPL).
    • If your system is configured to use an HTTP proxy to access the internet, run the following command in your system to specify the proxy information:
      /opt/IBM/ksys/ui/server/dist/server/bin/vmruiinst.ksh -p
      You can also specify the proxy information by using the http_proxy environment variable.
    • If the your system is not connected to the internet, complete the following steps:
      1. Copy the vmruiinst.ksh file from your system to a system that is running the AIX operating system and that has internet access.
      2. Run the vmruiinst.ksh -d /directory command where /directory is the location where you want to download the open source software packages. For example, /vmruiinst.ksh -d /tmp/vmrui_rpms. The following package managers are downloaded in the specified directory:
        • info-6.6-2.aix6.1.ppc.rpm
        • cpio-2.13-1.aix6.1.ppc.rpm
        • readline-8.0-2.aix6.1.ppc.rpm
        • libiconv-1.16-1.aix6.1.ppc.rpm
        • bash-5.0.18-1.aix6.1.ppc.rpm
        • gettext-0.20.2-1.aix6.1.ppc.rpm
        • libgcc-8.3.0-2.aix7.1.ppc.rpm
        • libstdcplusplus-8.3.0-2.aix7.1.ppc.rpm
      3. Copy the downloaded software packages to a directory in your system.
      4. In your system, run the vmruiinst.ksh -i /directory command where /directory is the location where you copied the downloaded software packages.

    After the GUI filesets have been installed, a message displays the URL of the GUI dashboard. To use the VM Recovery Manager DR GUI, open a web browser and enter the following URL:
    HTTPS://<hostname>:3000/login.
    After you log in to the VM Recovery Manager DR GUI, you can register the KSYS and add the existing clusters to your environment.

Installing GUI agent filesets
This topic describes steps required to install only GUI agents on a machine where the KSYS filesets are installed and the GUI server filesets will not be installed. You must have the KSYS filesets installed on the machine before installing the GUI agent filesets.
  1. Ensure all the prerequisites that are specified in the Requirements topic are met.
  2. To install only GUI agent filesets on a separate system that manages all the KSYS nodes, run the following command:
    installp -acFXYd fileset_location -V2 [-e filename.log] ksys.ui.agent ksys.ui.common
    Note: If you are using the AIX 7.3 operating system, you must install the mandatory efix on the GUI node that is described in the Installing VIOS and KSYS interim fixes topic. If the agent and the sever nodes are different, you must install the efix on both the nodes.
  3. To install the open source software packages, which are not included in the installed filesets, choose one of the following procedures depending on your system environment:
    • If your system is connected to the internet, run the following command in the GUI agent LPAR:
      /opt/IBM/ksys/ui/agent/lib/vmragentinst.ksh
      This command downloads and installs the open source software packages that are not included in the filesets because these files are licensed under the GNU General Public License (GPL).
    • If your system is configured to use an HTTP proxy to access the internet, run the following command in the your system to specify the proxy information:
      /opt/IBM/ksys/ui/agent/lib/vmragentinst.ksh -p
      You can also specify the proxy information by using the http_proxy environment variable.
    • If the your system is not connected to the internet, complete the following steps:
      1. Copy the vmragentinst.ksh file from your system to a system that is running the AIX operating system and that has internet access.
      2. Run the vmragentinst.ksh -d /directory command where /directory is the location where you want to download the open source software packages. For example, /vmragentinst.ksh -d /tmp/vmrui_rpms. The following package managers are downloaded in the specified directory:
        • libgcc-8.3.0-2.aix7.1.ppc.rpm
        • libstdcplusplus-8.3.0-2.aix7.1.ppc.rpm
      3. Copy the downloaded software packages to a directory in your system.
      4. In your system, run the vmragentinst.ksh -i /directory command where /directory is the location where you copied the downloaded software packages.

Installing VM agents

For HADR and HADRHA type of deployment, you need to install VM agents.

VM agents are components that are installed in virtual machines (VMs) or logical partitions (LPARs). These optional agents offer robust monitoring of the VMs and applications that are running in VMs. You can manage HA applications in VMs through a lightweight application monitoring framework.

To install a VM agent in an AIX VM, go to Installing a VM agent in an AIX VM. For setting up a VM agent in Linux®, see Installing a VM agent in a Linux VM.

Installing a VM agent in an AIX VM

  1. Ensure all the prerequisites that are specified in the Requirements topic are complete.
  2. Run the following command in the AIX virtual machine:
    installp -acFXYd fileset_location -V2 [-e filename.log] ksys.vmmon.rte
  3. Perform the following steps to verify whether the installation of VM agent is successful:
    1. Run the lslpp command.
    2. Ensure that the ksysvmmgr command and the binary file for the VM agent daemon exist in the following directories:
      • /usr/sbin/ksysvmmgr
      • /usr/sbin/ksys_vmmd
    3. Run the lssrc -s ksys_vmm command to verify whether the VM agent daemon is enabled. The status of the ksys_vmm subsystem must be Active in the output of this command.

Installing a VM agent in a Linux VM

To install the VM agent Red Hat Package Manager (RPM) packages in a Linux virtual machine, complete the following steps:

  1. Ensure that the following Reliable Scalable Cluster Technology (RSCT) packages are installed in the Linux VM:
    • rsct.core
    • rsct.opt.storagerm
    • rsct.core.utils
    • rsct.basic
    • DynamicRM
    You can download the packages from the following link: https://www.ibm.com/support/pages/service-and-productivity-tools. For information about configuring the repository to easily install those packages, see Updating RSCT packages for PowerVM® NovaLink.
  2. Install the VM agent RPM packages based on the following Linux distributions in the virtual machine.

    In Red Hat Enterprise Linux (RHEL) (little endian) virtual machines, run the following command:

    vmagent-1.10.0.0-1.0.el7.ppc64le.rpm

    In SUSE Linux Enterprise Server (SLES) (little endian) virtual machines, run the following command:

    vmagent-1.10.0.0-1.0.suse123.ppc64le.rpm
  3. Ensure RMC connection between the VMs and HMC. If the firewall is enabled on the RHEL VM, the RMC connection might be broken. Modify the firewall on the VMs to allow the RMC connection with the HMC. For details on modifying the firewall, see PowerLinux forum topic and Installing the PowerVM NovaLink software on a Red Hat Enterprise Linux partition topic.