Configuring IBM WebSphere Portal V6.0

This example is for users that are familiar with the Web serving environment and have an existing IBM^® WebSphere^® Portal V6.0 environment. This example describes all the steps necessary to get iSeries™ Access for Web running in an existing IBM WebSphere Portal V6.0 environment. Configuring your portal environment consists of these steps:

Start the IBM Web Administration for i5/OS^® interface (also known as theIBM HTTP Server for iSeries). See step 1.
Start the IBM WebSphere Portal environment. See step 2.
Configure iSeries Access for Web portlets. See step 3.
Use the iSeries Access for Web portlets. See step 4.

Steps to configure the IBM WebSphere Portal environment:

Start the IBM Web Administration for i5/OS 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.
2. Log in with a user profile that has, at least, these special authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.
3. Select IBM Web Administration for i5/OS then the Manage tabbed page.
4. Start the IBM WebSphere Portal environment where iSeries Access for Web portlets will be configured. Wait for the environment to reach a running status before continuing to the next step.
Configure iSeries Access for Web portlets. Use the appropriate commands to configure iSeries Access for Web to your portal environment:
- For a WebSphere Application Server V6.0 for OS/400 ("Base edition") profile, use these commands:
```
STRQSH cd /QIBM/ProdData/Access/Web2/install cfgaccweb2 -appsvrtype *WP60 -wasprf was_profile_name -wpusrid wp_user_ID 
           -wppwd wp_password -wpurl system_name:port/wps/config 
           -wpdftpag *CREATE
```
- For a WebSphere Application Server Network Deployment V6.0 for OS/400 edition profile, use these commands:
```
STRQSH cd /QIBM/ProdData/Access/Web2/install cfgaccweb2 -appsvrtype *WP60ND -wasprf was_profile_name -wpusrid wp_user_ID 
           -wppwd wp_password -wpurl system_name:port/wps/config 
           -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.

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 parameter.

system_name:port/wps/config

The Uniform Resource Locator (URL) to access the WebSphere Portal configuration servlet. Replace system_name with the name of your i5/OS. Replace port with the port number where the Web environment is running.

*CREATE

Tells the command to create the default iSeries Access for Web portal pages and add iSeries Access for Web portlets to those pages. Specify *NOCREATE if you do not want these portal pages to be created.
Use the iSeries 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 iSeries tabbed page.
6. Configure the iSeries Access for Web portlets.
  Most of the iSeries Access for Web portlets must be configured before they can be used. The remaining steps use the iSeries Printer Output portlet as an example to describe how to configure most iSeries Access for Web portlets.
7. Select the Print link.
8. In the iSeries Printer Output portlet window, select the down arrow icon in the upper right corner of the portlet window. Select Edit Shared Settings.
  - In the Server section, leave the default value for Server or enter the name of your i5/OS system.
  - In the Authentication section, select Use credential specific to this portlet window. Enter i5/OS user and password information for the system specified in the Server field.
  - In the General section, select Show server and Show user.
  At the bottom of the page, select OK.
9. The page is updated. The iSeries 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 iSeries Printer Output - Viewer.
10. The iSeries 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 down arrow in the upper right corner then Edit Shared Settings for the iSeries Printer Output- Viewer portlet and select View file within portlet option.
  Select OK.
11. Select the 5250 link on the left side of the window.
12. The iSeries 5250 Session portlet Server field contains a default value. Enter a different i5/OS system name or leave the default setting.
  Select Start Session. The iSeries 5250 Session portlet is connected to your i5/OS.

The steps above are a simple example for configuring and using iSeries Access for Web portlets to access your i5/OS system. iSeries Access for Web portlets can be added to other pages and coexist with other portlets.

By following these steps, you completed these tasks:

Configured iSeries Access for Web portlets.
Began using iSeries Access for Web portlets.

Parent topic:

Examples for configuring an existing portal environment