Installing PowerHA SystemMirror GUI

The PowerHA® SystemMirror® GUI filesets are located on the PowerHA SystemMirror Version 7.2 for AIX®, or later, media.

The PowerHA SystemMirror GUI server monitors clusters that are installed with PowerHA SystemMirror 7.2.0 SP 3, or later releases.

Install the following file sets to use PowerHA SystemMirror GUI:
cluster.es.smui.agent
This file set installs the agent files. Installing this fileset does not start the agent. This file set is automatically installed when you use the smit install_all command to install PowerHA SystemMirror Version 7.2, or later. The agent is configured and started when the cluster is added to the PowerHA SystemMirror GUI.
Note: You cannot install the cluster.es.smui.agent file set by using the smit update_all command. After running the smit update_all command, you need to install the cluster.es.smui.agent fileset separately.
cluster.es.smui.common
This file set installs common files that are required by both the agent and the PowerHA SystemMirror GUI server. This file set is automatically installed when you use the smit install_all command to install PowerHA SystemMirror Version 7.2, or later.
Note: You cannot install the cluster.es.smui.common file set by using the smit update_all command. After running the smit update_all command, you need to install the cluster.es.smui.common fileset separately.
cluster.es.smui.server
This file set installs the PowerHA SystemMirror GUI server files. The node on which you install the cluster.es.smui.server file set is known as the PowerHA SystemMirror GUI server. Installing this file set does not start the server. You do not need to install this file set on every node in the cluster, nor on every cluster that is to be managed. You can install this file set on a single node to manage multiple clusters.
To install this file set, complete the following steps:
  1. From the command line, run smit install_latest.
  2. Specify the input device or directory that contains the cluster.es.smui.server file set.
  3. Select the cluster.es.smui.server file set from the list.
  4. Press Enter to install the file set.

After the cluster.es.smui.server file set is installed, you must run the /usr/es/sbin/cluster/ui/server/bin/smuiinst.ksh command to complete the installation process. The smuiinst.ksh command automatically downloads and installs the remaining files that are required to complete the PowerHA SystemMirror GUI installation process. These downloaded files are not shipped in the file sets because the files are licensed under the General Public License (GPL). Due to expiration of the Bulls freeware, you must use the IBM® AIX Toolbox to download dependencies of the PowerHA SystemMirror GUI server. If the PowerHA cluster and the PowerHA SystemMirror GUI server are on PowerHA SystemMirror Version 7.2.3, dependencies remain same.

start of changeStarting with PowerHA SystemMirror Version 7.2.8 and later versions of PHA, following Dependencies are changed:
  • libgcc-8.1.0-2.aix7.2.ppc.rpm to libgcc-8.3.0-3.aix7.2.ppc.rpm
  • libstdcplusplus-8.1.0-2.aix7.2.ppc.rpm to libstdcplusplus-8.3.0-3.aix7.2.ppc.rpm
end of change
start of changeFor PowerHA SystemMirror Version 7.2.4 to version 7.2.7, and later, the following dependencies have updates:
  • libgcc-6.3.0-2.aix6.1.ppc.rpm to libgcc-8.3.0-2.aix6.1.ppc.rpm
  • libgcc-6.3.0-2.aix7.1.ppc.rpm to libgcc-8.3.0-2.aix7.1.ppc.rpm
  • libstdcplusplus-6.3.0-2.aix6.1.ppc.rpm to libstdcplusplus-8.3.0-2.aix6.1.ppc.rpm
  • libstdcplusplus-6.3.0-2.aix7.1.ppc.rpm to libstdcplusplus-8.3.0-2.aix7.1.ppc.rpm
end of change
For the cluster that is located in PowerHA SystemMirror Version 7.2.3 and needs to be discovered on later versions of PowerHA SystemMirror, the following dependencies have updates
  • libstdc++-4.9.2-1.aix7.1.ppc.rpm to libstdcplusplus-4.8.5-1.aix7.1.ppc.rpm
  • libstdc++-4.9.2-1.aix6.1.ppc.rpm to libstdcplusplus-4.8.5-1.aix6.1.ppc.rpm
  • libgcc-4.9.2-1.aix7.1.ppc.rpm to libgcc-4.8.5-1.aix7.1.ppc.rpm
  • libgcc-4.9.2-1.aix6.1.ppc.rpm to libgcc-4.8.5-1.aix6.1.ppc.rpm

The PowerHA SystemMirror GUI server must have internet access or an HTTP proxy that is configured to allow access to the internet to run the smuiinst.ksh command. If you are using an HTTP proxy, you must run the smuiinst.ksh -p command to specify the proxy information, or you must specify the proxy information by using the http_proxy environment variable.

If the PowerHA SystemMirror GUI server does not have internet access, complete the following steps:
  1. Copy the smuiinst.ksh file from the GUI server to a system that is running the AIX operating system that has internet access.
  2. Run the smuiinst.ksh -d /directory command where /directory is the location where you want to the download the files. For example, /smuiinst.ksh –d /tmp/smui_rpms.
  3. Copy the downloaded files (/tmp/smui_rpms) to a directory on the PowerHA SystemMirror GUI server.
  4. From the PowerHA SystemMirror GUI server, run the smuiinst.ksh -i /directory command where /directory is the location where you copied the downloaded files (/tmp/smui_rpms).

After the smuiinst.ksh command is complete, a message displays a URL for the PowerHA SystemMirror GUI server. Enter the specified URL into a web browser and from the Health Summary menu in the navigation pane, click the Health Menu icon and select Create Cluster option.

Migrating the PowerHA SystemMirror GUI database

When you are migrating a PowerHA SystemMirror GUI server that is not configured for high availability, the PowerHA SystemMirror GUI database is migrated automatically. For a highly available PowerHA SystemMirror GUI server, you must manually migrate the database as automatic migration of the database is not possible. You can migrate the PowerHA SystemMirror GUI database after all nodes in the cluster are migrated to the new version of PowerHA SystemMirror. You cannot migrate the PowerHA SystemMirror GUI database during offline or rolling migration due to conflicts over concurrent access to the shared file system that contains the PowerHA SystemMirror GUI database. The PowerHA SystemMirror GUI database cannot be migrated until all the nodes in the cluster are migrated to the new version of PowerHA SystemMirror.

To migrate the PowerHA SystemMirror GUI database, perform the following steps on the active PowerHA SystemMirror GUI server node after all the nodes are migrated:

  1. Stop the PowerHA SystemMirror GUI server by running the following command: 
    stopsrc -cs phauiserver && sleep 11
  2. Mount the file system pha_gui_fs by running following command:
    mount/opt/pha_gui_fs
  3. Verify that the smui.db file is available in the /opt/pha_gui_fs directory by running the following command: 
    ls -l /opt/pha_gui_fs/smui.db
  4. Complete the GUI database migration by running the following command: 
    /usr/es/sbin/cluster/ui/server/bin/sqlite/opt/pha_gui_fs/smui.db < /usr/es/sbin/cluster/ui/server/node_modules/smui-server/resources/ddl-upgrade.sql
  5. Restart the GUI server by running the following command: 
    startsrc -s phauiserver

Migrating to PowerHA SystemMirror GUI Version 7.2.4, or later, on AIX 7.2

In PowerHA SystemMirror Version 7.2.4, and later, the supporting software for PowerHA SystemMirror GUI server is upgraded. If you are migrating from PowerHA SystemMirror Version 7.2.3, and earlier, to PowerHA SystemMirror Version 7.2.4, and later, you can download and install new supporting software by using the smuiinst.ksh command. If you choose migrate to PowerHA SystemMirror Version 7.2.4, you must add all clusters that are managed by your previous version of PowerHA SystemMirror GUI server again to the current PowerHA SystemMirror GUI server. However, it is not necessary to remove the copy of previously added clusters from the PowerHA SystemMirror GUI server. After migration, if you do not add all clusters, the PowerHA SystemMirror GUI server will not function.
Note: If you choose to migrate to PowerHA SystemMirror Version 7.2.4 SP 1, and later, you do not need to add all clusters again.
Note: start of changeOnce the cluster is in a stable state after migration, reload or refresh the GUI so that the migrated PowerHA version’s features gets available in the GUI.

Please ignore the interim phases shown on the GUI during the ongoing migration process.

end of change

Migrating to PowerHA SystemMirror GUI Version 7.2.4, or later, on AIX 7.3

AIX 7.3 now supports both PowerHA SystemMirror GUI server and PowerHA SystemMirror GUI agent. If you are migrating to PowerHA SystemMirror Version 7.2.4 from any previous versions, then you must install the interim fix after you install PowerHA SystemMirror Version 7.2.4 on PowerHA SystemMirror GUI server node. After you install the IJ38335s0a/IJ38335s0a.220504.epkg.Z interim fix, you must again install the /usr/es/sbin/cluster/ui/server/bin/smuiinst.ksh script to download and install new dependencies. Later, you can install the latest service pack to migrate to the latest PowerHA SystemMirror Version 7.2.4.
Notes:
  • You can install the interim fix only on PowerHA SystemMirror GUI server node.
  • For other cluster nodes, interim fix installation and PowerHA SystemMirror GUI dependencies are not required and a user can directly install the latest service pack after PowerHA SystemMirror installation.
Note: start of changeOnce the cluster is in a stable state after migration, reload or refresh the GUI so that the migrated PowerHA version’s features gets available in the GUI.

Please ignore the interim phases shown on the GUI during the ongoing migration process.

end of change

Migrating to PowerHA SystemMirror GUI Version 7.2.5, or later, on AIX 7.3

If you are migrating from previous versions of PowerHA SystemMirror to PowerHA SystemMirror Version 7.2.5, or later, you must migrate the PowerHA SystemMirror GUI server node to the latest service pack. To download the PowerHA SystemMirror GUI dependencies, you must again install the /usr/es/sbin/cluster/ui/server/bin/smuiinst.ksh script.
Note: start of changeOnce the cluster is in a stable state after migration, reload or refresh the GUI so that the migrated PowerHA version’s features gets available in the GUI.

Please ignore the interim phases shown on the GUI during the ongoing migration process.

end of change