WebDocs iSeries Portlet Deployment - Websphere Portal Server 6.0

From Support

To use the WebDocs iSeries Edition Portlet, you must download and install the Visual Mainwin Java Runtimes one time on your portal server in the Websphere Portal Server shared/apps folder.

Then you must deploy the WebDocs iSeries portlet via the WebSphere Portal Server administration screens.

Listed below are the steps to download and install the portlet and runtimes:

1.) Download and unzip the following files as listed:

WebDocs iSeries Edition Portlet Deployment Files (WAR files) [1]

Run the WebdocsiSeriesPortletDeploy.exe file to unzip the portlet WAR files to Websphere Portal Server installableApps folder.

Example: On Windows this may be: c:\Program Files\IBM\Websphere\Portalserver\installableApps

Note: On iSeries the installableApps folder may be something totally different under /QIBM in the IFS.

2.) Start the Websphere Portal Server and log in as a portal admin.

Your normal Websphere Portal Server URL will look something like the following:

Example where IP address to portal server is: 1.1.1.1: http://1.1.1.1:9081/wps/portal

3.) After logging in to the Portal Server as an administrator, click the "Administration" link.

4.) Select "Portlet Management" and then "Web Modules".

5.) Click "Install" and then browse to select the c:\program files\IBM\Websphere\Portalserver\installableApps\WebDocsiSeriesPortlet.war file.

6.) Click "Next" to continue and then "Finish" to complete the installation of the portlet web module.

7.) Select "Portlet Management" and then "Portlets".

If all completed normally the "WebDocs iSeries Portlet" should now exist in the available Portlets list. 

Configuring the Webdocs Settings for the WebDocs iSeries Portlet

The WebDocs iSeries Portlet must be configured before initial usage.

1.) Find the WebDocs iSeries Portlet installed application folder.

If you go to directory C:\Program Files\IBM\Websphere\Portalserver\installedApps and look for the newest subfolder, this is probably the correct one.

It will be named something similar to the following: C:\Program Files\IBM\Websphere\Portalserver\installedApps\VMW_PA_1_0_S8.ear

Note: The actual directory name may be different.  This is just an example.

2.) Drill into the c:\program files\websphere\portalserver\installedApps\VMW_PA_1_0_S8.ear\PA_1_0_S8.war directory and locate the Web.config file.

3.) Edit the Web.Config file with Wordpad or any XML editor.

4.) Change the following iSeries specific settings:

<add key="ipaddress" value="1.1.1.1" /> - Change to have your iSeries IP address <add key="hostuser" value="qsecofr" /> - Change to match a user on your iSeries who has access to the RJSIMAGE library <add key="hostpassword" value="mypass" /> - Change to match the selected user's iSeries password.

Save the Web.Config file and then try starting the WebDocs iSeries portlet and doing a document search.

5.) Now the WebDocs iSeries Portlet should be available from the Portlet Palette in Websphere Portal Server 6.0.

When used, the portlet will attempt to single signon to the iSeries with the Websphere Portal Server User ID.