Configuring IBM WebSphere Portal V8.0

This example is for users that are familiar with the Web serving environment and have an existing IBM WebSphere® Portal V8.0 environment. This example describes all the steps necessary to get IBM i Access for Web running in an existing IBM WebSphere Portal V8.0 environment.

Configuring your portal environment consists of these steps:

Start the IBM Web Administration for i interface. See step 1.
Start the IBM WebSphere Portal environment. See step 2.
Configure IBM i Access for Web portlets. See step 3.
Use the IBM i Access for Web portlets. See step 4.

Steps to configure the IBM WebSphere Portal environment:

Start the IBM Web Administration for i interface.
1. Start a 5250 session to the system.
2. Sign on with a user profile that has at least these special authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.
3. Run the following command to start the Web administration interface job: STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)
4. Minimize the 5250 session.
Start the IBM WebSphere Portal environment.
1. Open a browser to http://<system_name>:2001/HTTPAdmin.
2. Log in with a user profile that has, at least, these special authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.
3. Select the Manage tab page.
4. Start the IBM WebSphere Portal environment where IBM i Access for Web portlets is configured. Wait for the environment to reach a running status before continuing to the next step.
Configure IBM i Access for Web portlets.
IBM i Access for Web provides commands to configure the product. Two different commands are provided, a CL command and a Qshell script command. Both commands provide and perform the same function. Use the version which works best for your circumstances.
- For a portal environment using a WebSphere Application Server Network Deployment profile, use these commands:
  - To use the CL command:
```
CFGACCWEB APPSVRTYPE(*WP80) 
   WASPRF(was_profile_name) 
   WASINSDIR('was_install_directory')
   WPUSRID(wp_user_ID) WPPWD(wp_password) 
   WPURL('your_system_name:port/wps/config') 
   WPPTYPE(wp_portlet_type)
   WPDFTPAG(*CREATE)
```
  - To use the Qshell script command:
```
QSYS/STRQSH
cd /QIBM/ProdData/Access/Web2/install
cfgaccweb -appsvrtype "*WP80" -wasprf was_profile_name 
          -wasinsdir was_install_directory
          -wpusrid wp_user_ID -wppwd wp_password 
          -wpurl your_system_name:port/wps/config 
          -wpptype "wp_portlet_type"
          -wpdftpag "*CREATE"
```
The configuration command uses these variables:

was_profile_name

The name of the WebSphere Application Server profile where WebSphere Portal has been deployed and is currently running.

was_install_directory

The location in the IBM i integrated file system where the WebSphere Application Server edition being used to run WebSphere Portal is installed.
If there is a single installation of WebSphere Application Server Network Deployment V8.0 that location is used. The WASINSDIR/wasinsdir parameter does not need to be specified..

The default location for the WebSphere Application Server Network Deployment V8.0 installation directory is /QIBM/ProdData/WebSphere/AppServer/V8/ND. If WebSphere Application Server Network Deployment V8.0 is installed in multiple locations and none of the installations are in this default location, you must specify the WASINSDIR/wasinsdir parameter. If one of the installations is in the default location and the WASINSDIR/wasinsdir parameter is not specified then the default location is used.

wp_user_ID

The WebSphere Portal user ID that has administrator-level authority to perform configuration changes to WebSphere Portal.

wp_password

The password for the user ID specified in the WPUSRID/wpusrid parameter.

your_system_name:port/wps/config

The Uniform Resource Locator (URL) to access the WebSphere Portal configuration servlet. Replace your_system_name:port with the name of your IBM i system and the port the environment is using.

wp_portlet_type

The type of portlets to be used to populate the WebSphere Portal pages. You must specify either *IBM or *STD.
Specify *STD to configure the standard portlets. The standard portal application is a set of portlets written to the Java™ Specification Requests (JSR) 168 Portlet Specification.

Specify *IBM to configure the IBM portlets. The IBM portal application is a set of portlets written to the IBM Portlet API.

*CREATE

Tells the command to create the default IBM i Access for Web portal pages and add IBM i Access for Web portlets to those pages. Specify *NOCREATE if you do not want these portal pages to be created.
Use the IBM i Access for Web portlets.
1. Open a new browser window to the IBM WebSphere Portal log in page.
  The URL might be similar to http://<system_name>:<port>/wps/portal.
2. Select the Log in link in the upper right corner of the page to log in to IBM WebSphere Portal.
3. The Web page prompts for a User ID and Password.
  - In the User ID field, enter an IBM WebSphere Portal user ID that has administrative authority.
  - In the Password field, enter the password.
  Select Log in.
4. The Web page is updated displaying the Welcome page.
5. Select the new My IBM i tab page.
6. Configure the IBM i Access for Web portlets.
  Most of the IBM i Access for Web portlets must be configured before they can be used. The remaining steps use the IBM i Printer Output portlet as an example to describe how to configure most IBM i Access for Web portlets.
7. Select the Print link.
8. Select the Edit Mode action along the top right of the page. The page is displayed again and the portlet windows on the page have a title bar with a Display menu action available.
9. In the IBM i Printer Output portlet window, select the Display menu action in the upper right corner of the portlet window to display the Portlet Menu. Select Personalize from the Portlet Menu. This selection allows you to edit the configuration settings for the portlet.
  - In the System section, leave the default value for System or enter the name of your IBM i system.
  - In the Authentication section, select Use credential specific to this portlet window. Enter IBM i user and password information for the system specified in the System field.
  - In the General section, select Show system and Show user.
  At the bottom of the Portlet window, select OK.
10. The page is updated.
  The IBM i Printer Output portlet lists available spooled files. Each spooled file has several action icons available.
  Select the Send printer output name to icon, then select Send to IBM i Printer Output - Viewer.
11. The IBM i Printer Output - Viewer portlet is updated with a link to a PDF version of the spooled file selected in the previous step.
  If you prefer to view the PDF within the portlet, select the Display menu action in the upper right corner of the Portlet window to display the Portlet Menu. Select Personalize on the Portlet Menu.
  - In the Open Printer Output File section, select View file within portlet.
  At the bottom of the Portlet window, select OK.
12. Select the View Mode action along the top right of the page. The page is displayed again and the portlet windows on the page no longer have a title bar.
13. Select the 5250 link on the left side of the window.
14. The IBM i 5250 Session portlet System field contains a default value.
  Enter a different IBM i system name or leave the default setting.
  Select Start Session. The IBM i 5250 Session portlet is connected to your IBM i.

The previous steps are a simple example for configuring and using IBM i Access for Web portlets to access your IBM i system. IBM i Access for Web portlets can be added to other pages and coexist with other portlets.

By following these steps, you completed these tasks:

Configured IBM i Access for Web portlets.
Began using IBM i Access for Web portlets.

If you need to remove the IBM i Access for Web portlets from the WebSphere Portal configuration, use the RMVACCWEB/rmvaccweb command to remove the portlets and My IBM i Portal pages that were created.