IBM Support

Deploying the PowerVP GUI web application to the IBM i Integrated Application Server

How To


Summary

Since the PowerVP Graphical User Interface is now a web application, it can be deployed to any application server that you may have. Here I will walk through the steps to deploy the PowerVP GUI to the Integrated Application Server running on IBM i.

Steps

First, make sure that you are current on the IBM i Integrated Application Server, including PTFs. You will need level 9 or greater of group PTF SF99713 for IBM i 7.2 or level 35 or greater of group PTF SF99368.  PowerVP does use some of the more recent features of Java, so it is important to be current. PowerVP also needs Java 1.7, so make sure you have that loaded on your IBM i system.

If the HTTP *ADMIN server is not running, start it with this command:

STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)

Then connect  to the HTTPAdmin server on your IBM i using your system name, port 2001, and HTTPAdmin as the URL. Once you sign-on with your IBM i user profile and password, you should see this screen.

For this example, I will be creating a new application server for the PowerVP application, but you could also deploy the PowerVP application to an existing application server.

Click on “Create a New Application Server”. Click next on the Welcome panel. You should now see this screen.

Make sure the radio button by V8.5 is selected and click next.

Enter an server name and description and click next.

Select the port you want to use for the application server (this must be different from the port that the PowerVP agent is using and also different from other ports that are being used on your system). Also, select which ip address(es) you want to listen on and click next.

This is a summary panel, so click Next.

Specify the user id that you want to use for the application server jobs or use default, and click Next.

Click Finish to create your application server.

And wait…..

Now you can install the PowerVP application in the new application server, so click “Manage Installed Applications”.

Click Install.

Prior to this step, you need to copy the powerVPWeb.war file to the IBM i IFS file system. If you use FTP, make sure to do so in binary mode.

Click on “Browse” to locate the PowerVP war file in the IFS.

You can leave the check box selected so the application is copied to the server’s apps directory. Click Next.

This is a summary panel, so click next.

And then click Finish. Once the application is installed, we need to continue with some customization. You should see the next screen.

Click on Properties under Server Properties on the right hand side of the screen.

Under the Application Server tab, set the java home to be 7.0 or greater if not already at 7.0.

Under the Features tab, make sure you have the features selected in the screenshot above. The PowerVP application needs json, jsonp, servlet, and websocket which may or may not be in the selected features, so add them to te Selected features list. Click Apply.

One last thing before we start the server. The server.xml file that is created by the wizard has one value that we need to change. So, you need to edit file \www\POWERVPAPP\wlp\usr\servers\POWERVPAPP\server.xml on your IBM i system. In order to view the VIOS performance advisor reports from the PowerVP GUI, the dropinsEnabled property needs to be set. If you will not be using PowerVP to view VIOS performance advisor reports, then you do not need to change this property. Search for the line that has this:

<dropinsEnabled>false</dropinsEnabled>

and change the false to true. Save the changes and exit your file edit.

Now, start your Application Server by clicking the green arrow button and then click Start on the next panel.

Then click on Manage Installed Applications.

And make sure your powerVPWeb application is running (if not, click Start). Now you are ready to see if it works…

In your web browser, open a new tab, and enter the URL, for example, system:10000/powerVPWeb/PowerVP.html

Getting this screen shows that the PowerVP application is indeed installed and running in your application server. So, click on New Connection, specify the information for you system level agent and click Connect.

If you see the above screen, you have successfully deployed and started your PowerVP GUI application in the IBM i Integrated Application Server.

If you don’t see that screen, then time for some debug.

Under Problem Determination, click on View Logs

The first file, the console.log is the first place to look. Make sure that it shows you are using Java 7 and that all of the necessary features are loaded. If not, end the application server and set what you missed. One of the things I encountered was that I had both jsp-2.2 and jsp-2.3 selected. The log file did tell me that I couldn’t have both of those. So, read through the log file and you will likely find the problem.

And now you have the PowerVP GUI running in the IBM i Integrated Application Server. If you have a home page or other web pages that your business uses, you can add a link to the PowerVP application to those web pages so they run the URL that you used above.

Document Location

Worldwide

[{"Business Unit":{"code":"BU054","label":"Systems w\/TPS"},"Product":{"code":"SGKRQP","label":"PowerVP"},"Component":"","Platform":[{"code":"PF012","label":"IBM i"}],"Version":"1.1.3","Edition":"","Line of Business":{"code":"","label":""}}]

Document Information

Modified date:
19 December 2019

UID

ibm11128561