This article contains a step-by-step tutorial for installing PowerVP version 1.1.3.
Uninstall Previous Version
If you have a previous version of PowerVP installed on your Windows box and/or the PowerVP agent installed on AIX or Linux, you first have to uninstall the old version before installing the new version.
To uninstall from an AIX or VIOS partition, you must first end the agent. Run "ps ax |grep powervp" command. If the agent is running, you will see something like this:
Then run "kill -15 pid" where pid is the pid number of the /opt/ibm/powervp/syslet process. Now you can run "installp -u powervp.rte " which will uninstall the PowerVP agent. Then run "installp -u GSKit8" to uninstall GSKit.
To uninstall from Linux, you must first end the agent. Run "service ibm_powervp stop" to stop the agent. Then run "rpm -e powervp powervp-driver gskcrypt64 gskssl64" which will uninstall the PowerVP agent and GSKit.
You do not need to uninstall the agent from IBM i. The install will install a new release over the existing installation.
To uninstall the GUI, run the uninstall program located in the PowerVP/PowerVP_Installation folder.
Now, you can continue installing the new release.
Install Version 1.1.3
You will receive PowerVP either on physical media or by downloading from IBM. In either case, the media will look like this (after unzipping the download version):
The install is a multiple step process. The first step is loading the base product on a client workstation. Later, you will install the PowerVP agents on the Power system partitions. PowerVP supports Windows, Linux, and AIX for the product install. Also, IBM provided a Java version of the installation. This will work on most other client workstations where you have Java installed on the client.
The first temptation is to drill into your operating system’s directory, for example, Windows, and copy the PowerVP.exe file from the media to your PC. If you do this, the installer will not work. The license folder and its contents are also required at install and the directory structure must match the install media. So, you could copy the license folder and the Windows folder from the media if you were installing on Windows and it would work.
If you run this install on an AIX or Linux partition on your POWER system, you will need to have a windowing capability on the partition, for example, have a VNC server running on the partition and connect a VNC client to the partition and run the install in the VNC session. You can install from a command entry without having a windowing capability, but if you do, the defaults taken will not install a Liberty server. We’ll talk about installing a Liberty server later in this article.
The first few panels are pretty basic. When you reach the “Choose PowerVP Install Set” panel, you will be making your first decision. There are 3 choices, Typical simply installs both of the other 2. The PowerVP Client GUI option will only install the GUI software and the PowerVP Server Agents option will only install the agent software. Here, we will select Typical.
Next you are asked for an Install Folder. This is the folder on your client where PowerVP will install what you selected on the previous panel. Note that if you are doing agent installs to AIX/VIOS or Linux partitions, the installer will simply be copying the agent install artifacts to your client. You will still have to do a separate agent install to the POWER system partition(s). So, even if you choose to run this install on your Linux or AIX partition, you will still need to do the additional agent install for those operating systems.
Next you are asked where you want product icons and shortcuts. Select the appropriate option.
Next is the WebSphere Application Server Liberty Core Installation panel. The PowerVP GUI in release 1.1.3 is now a deployable web application. It has to be deployed to an Application Server. PowerVP bundles the IBM Liberty WebSphere Application Server which you can install on your client and have the PowerVP web application run on your client system. If you want to deploy the PowerVP GUI to an existing application server in your network, do not check the “Install Liberty for PowerVP” checkbox. If you do want PowerVP to use the bundled Liberty server, check the checkbox and update the port assignments for the Liberty server (you can use the defaults). These ports are different from the ports that PowerVP uses for the GUI to connect to the agent. If you install Liberty, the installer will configure and deploy the PowerVP GUI application to an instance of Liberty running on the client. If you want to deploy the PowerVP GUI application to any other application server, this step is left up to you. You will need to deploy and configure the PowerVP GUI application following the instructions to deploy applications to the application server you wish to use.
The next decision point is the “PowerVP Agent Server Selection” panel. Here you choose which agent operating systems on the POWER system that will be running the PowerVP agent. For AIX/VIOS and Linux, the installer will simply copy the RTE (AIX/VIOS) and RPM (Linux) files that you will use to install the PowerVP agent, to your client. For IBM i, in addition to copying the save files (SAVF) that contain the license program for use with the restore license program (RSTLICPGM) command, the installer will also perform the license program installation on your IBM i system (assuming you have the Host Servers running on your IBM i).
Next, for each operating system you selected, you will be presented with a panel to provide the hostname or IP address of the partition where you will be running the system level agent. You can set the ports (you need to use the same ports for PowerVP on all of the partitions). You can select if you want to use SSL, non-SSL, or both for the connection between the PowerVP GUI and PowerVP agents. You also select if you want to have the agent automatically started when the partition IPLs. The last checkbox will launch some additional instructions that you will need to finish the install of the PowerVP agents. These instructions will be launched to your browser. For the IBM i partitions, you will click the “Add system” button to provide this information. You can add multiple IBM i partitions on the IBM i Agent panel and the installer will automatically install the PowerVP agent to all of the IBM i partitions you provide.
Finally, after reviewing all of the install options panels, you click on the Install button. If you checked the “Launch Installation Instructions” checkbox, you will see new tabs started in your default web browser with further instructions on installing the PowerVP agents on the POWER system partitions. Do not close these instructions tabs. You will need them.
At this time, you should go to Fix Central, http://www-933.ibm.com/support/fixcentral/swg/selectFixes?parent=Virtualization%2Bsoftware&product=ibm/Other+software/PowerVP+(Virtualization+Performance)+Standard+Edition&release=1.1.3&platform=All&function=all and download the latest fixpack for PowerVP version 1.1.3. The fixpacks are cumulative, so you only need to download and install the latest one.
At this time, there is a problem with installing the GUI and bundled Liberty server on AIX. A fix from fixpack 1 was inadvertently dropped in fixpack 2, therefore, if you plan to run the GUI in a Liberty instance on AIX, installing it directly on AIX with the installation media, you should always load fixpack 1, then you can skip to the latest fixpack. Specifically, the launch-powervp and stop-powervp script files have an error in them which prevents these scripts from starting and stopping the Liberty server; and the server.xml file was not being copied to the correct location for the Liberty server. This will be corrected in fixpack 5.
The fixpacks are packaged as zip files, so unzip them, navigate to the correct folder, AIX, Java, Linux, or Windows and run the executable from that folder. The fixpack installer is similar to the product installer, so it should be easy to maneuver. Most fixpacks will include a new WAR file for the PowerVP GUI, and will also include fixes for the agents. The new WAR file will replace the WAR file installed from the GA media, and will give you the latest and greatest PowerVP GUI. For AIX/VIOS, a new rte file is included, and for Linux, a new rpm file is included. These will be installed below. For IBM i, the agent fix is packaged in a save file as a PTF, and the installer will perform the load and apply of the PTF on the IBM i partition.
We will now walk through the installation instructions for each agent operating system.
AIX/VIOS Agent Installation
For AIX (this includes VIOS which runs AIX version 6.1), you will need to open a session to the AIX/VIOS partition and will need to be able to copy files from your client to the AIX partition. If you are installing to a VIOS, you will need to run the “oem_setup_env” command to enter the OEM software installation and setup environment to install PowerVP. You will need root authority to perform the install.
You will first use FTP or some other file transfer to copy the GSKit8 and PowerVP .rte installation files from your client to the POWER system partition (make sure to use binary mode transfer if using FTP). On your client, these files will be located in the PowerVP installation directory you selected during installation above, in the PowerVP/PowerVP_Installation/PowerVP_Agent_Installation_Instructions/AIX subfolder. The fixpack rte file will be in the directory also. Once the files are on the AIX partition, run the install command, installp, to install GSKit8 followed by the installp command to install PowerVP. The installp command for powervp.rte will install both the base release and any fixpacks that are in the same directory. The full commands are like this:
- installp –acgqwd . GSKit8*
- installp –agXd . powervp.rte
Once installed, there is one instruction you need to use to finish the configuration of PowerVP. This instruction is in the launched installation instructions, located right below the installp for powervp.rte and looks like this:
/opt/ibm/powervp/iconfig Listen="* 13000" SystemLevelAgent=hostname
where hostname is replaced with the hostname or ip address you provided during install.
The command, iconfig, can be entered on the AIX partition as it is shown in the browser tab, the install instructions we mentioned above. This will configure your PowerVP agent ports and system level agent entries in the PowerVP configuration file.
PowerVP is now installed on your AIX partition. To start it, you can run the /etc/rc.d/rc2.d/SPowerVP shell script which will start the PowerVP agent. The location of this script in this folder is what causes the PowerVP agent to be started when the AIX partition IPLs.
IBM i Agent Installation
For IBM i, the agent installation and configuration was completed at install time. On IBM i, PowerVP is installed as a TCP/IP server that is started and stopped using the STRTCPSVR and ENDTCPSVR CL commands. If you selected to have it automatically started, the *POWERVP server will also be configured as and autostart TCP/IP server and will start with your other TCP/IP autostart servers when TCP is started on IBM i.
If you later decide to install PowerVP on additional IBM i partitions, you can run the installer again and select to do a “PowerVP Server Agents” install and the installer will automatically perform the install for you. You can also perform the installation manually. The save files (.SAVF) that are needed by the RSTLICPGM and LODPTF CL commands are located in the PowerVP/PowerVP_Installation/PowerVP_Agent_Installation_Instructions/IBM_I subfolder on your client.
One note on IBM i installation. PowerVP is only translated to 11 languages, English, French, German, Spanish, Italian, Russian, Japanese, Brazilian Portuguese, Korean, Traditional Chinese, and Simplified Chinese. IBM i supports more than these 11 languages as the primary language of the operating system. If your IBM i is not using one of these 11 languages, you will need to choose one of these 11 languages and install the save file containing that language for PowerVP. This will show up as a secondary language on your IBM i system. To install the language, you will use the following command:
RSTLICPGM LICPGM(5765SLE) DEV(*SAVF) RSTOBJ(*LNG) SAVF(library/filename)
where the library/filename is the name of the save file that contains the language you want.
Here is a screenshot of the directory containing the save files on your client.
The SAVSLE00MM.SAVF contains the program objects for the PowerVP licensed program. The qipxxxxx.savf contains the PTF objects. The other save files contain the language objects for the PowerVP licensed program. You can find the language feature codes here, https://www-01.ibm.com/support/knowledgecenter/ssw_ibm_i_72/rzahc/rzahcnlvfeaturecodes.htm. The files have replaced the “29” with “00” in the file name.
Linux Agent Installation
For Linux, you will need to open a session to the Linux partition and will need to be able to copy a file from your client to the Linux partition. You will need root authority to perform the install. The PowerVP product has 2 rpm files. The powervp-1.1.3-1.xxxx.rpm file is the distribution independent code for PowerVP and is installed on every Linux distribution and version. There is both a big endian and little endian version, so make sure you choose the right one, the files with ppc64le in the name are the little endian files. The PowerVP product contains a second rpm file, powervp-driver-1.1.3-1.xxxx.rpm, which contains the kernel extension module that is installed separately from the rest of the PowerVP product. For each supported Linux distribution and version, a separate “powervp-driver” rpm file is included. You will need to find the correct rpm file for the Linux distribution being used on the partition and install that prior to installing the distribution independent PowerVP rpm file. The screen shot shows what rpm files are included with PowerVP:
If none of the versions matches what is on your Linux partition, you can use the powervp-driver-source rpm file which contains the source code for the PowerVP kernel module. This will allow you to build the PowerVP kernel module yourself on your Linux partition. Refer to the PowerVP redbook for instructions on building your own kernel module, http://www.redbooks.ibm.com/redpapers/pdfs/redp5112.pdf. You should also check Fix Central for PowerVP fixpacks. Additional Linux distributions and kernel versions will be included in the PowerVP fixpacks.
You will first use FTP or some other file transfer to copy the GSKit8 and PowerVP-1.1.3-x rpm files from your client to the POWER system partition (make sure to use binary mode transfer if using FTP). The PowerVP-1.1.3-1 rpm file is the GA rpm file. Each fixpack will increment this number, so the first fixpack will be PowerVP-1.1.3-2. On your client, these files will be located in the PowerVP installation directory you selected during installation above, in the PowerVP/PowerVP_Installation/PowerVP_Agent_Installation_Instructions/LINUX subfolder. Once the files are on the Linux partition, you can run the rpm command to install all the necessary rpm files at the same time. PowerVP does have dependencies on Linux packages sysstat, procps, net-tools, ethtool, perf, coreutils, and ksh. These must be installed on the Linux partition before you can install PowerVP. The fixpacks for Linux are cumulative, therefore, you can skip any intermediate levels and just install the latest rpm fixpack. This also applies to initial installs, for example, if you have not yet installed PowerVP on your Linux partition, you can skip installing PowerVP-1.1.3-1.ppc64.rpm and instead go right to the powervp-1.1.3-3.ppc64.rpm file.
Once installed, there is one instruction you need to use to finish the configuration of PowerVP. This instruction is in the launched installation instructions, the iconfig program, and looks like this:
/opt/ibm/powervp/iconfig Listen="* 13000" SystemLevelAgent=hostname
where hostname is replaced with the hostname or ip address you provided during install.
The command, iconfig, can be entered on the Linux partition as it is shown in the browser tab, the install instructions we mentioned above. This will configure your PowerVP agent ports and system level agent entries in the PowerVP configuration file. PowerVP is now installed on your Linux partition as a service. To start it, you can run the “service ibm_powervp start” command to start the PowerVP agent.
19 December 2019