Configuring Workplace Services Express V2.6

This example is for users that are not familiar with the Web serving environment. It describes all the steps necessary to get iSeries™ Access for Web running in a Workplace™ Services Express V2.6 environment.

Install the latest service pack PTF. This is required for Workplace Services Express V2.6 support. For instructions, see the Installing PTFs for the Licensed Internal Code and the operating system topic for instructions.

In the following steps you are instructed to enter configuration values. If you prefer to enter values other than those specified, use the values consistently. For example, wpsadmin is used as the WebSphere Portal user ID. If you want to use a different user ID, use it every time this example specifies wpsadmin. Configuring your portal environment consists of these steps:

Start the IBM^® Web Administration for i5/OS^® interface (also known as the IBM HTTP Server for iSeries). See step 1.
Create an HTTP Web server, create a WebSphere^® application server, and deploy Workplace Services Express. 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 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.
Create an HTTP Web server, create a WebSphere application server, and deploy Workplace Services Express V2.6:
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.
4. Select the Setup tabbed page.
5. Under Common Tasks and Wizards, select Create IBM Workplace. Select Next.
6. The Select IBM Workplace Version page opens. Select IBM Workplace Services Express V2.6. Select Next.
7. The Specify name for server page opens. In the Server name field, enter iwawse26, then select Next.
8. The Enable IBM Workplace Collaboration Component page opens. Verify that the iSeries Access for Web portlets Additional portlets option is listed.
  If the option is selected and you leave it selected, iSeries Access for Web portlets will automatically be deployed and you can skip step 3.
  If you do not select this option, follow step 3 to manually deploy them.
  Select Next.
9. The Specify Host Name for IBM Workplace Environment page opens. Select your system's host name in the field. Select Next.
10. The Specify Internal Ports used by the Application Server page opens. In the First port in range field, enter 21056. Select Next.
11. The Create a new HTTP server page opens.
  - For HTTP server name, specify IWAWSE26.
  - For Port, specify 2056.
  After entering the values, select Next.
12. The Create DB2^® Databases for IBM Workplace Environment page opens. Make a selection appropriate for your environment. Select Next.
13. The Secure Application Server and IBM Workplace Environments with LDAP page opens. Select Configure security using LDAP at a later time. Select Next.
14. The Portal Administrative Group and Administrative User page opens. The Administrator name field is filled in with a default value of wpsadmin. Enter a password. Make note of these values, you will need them in a later configuration step. Select Next.
15. The Summary page opens. Select Finish.
16. The Web page is re-displayed. The Manage/Application Servers tabbed page is active. Under Server, iwawse26/iwawse26 – V2.6 (worklace - WSE) is listed with a status of Creating. From this Web page, you can manage the Workplace Services Express environment.
  Use the refresh icon next to the Creating status to refresh the page, if the page does not periodically refresh.
  When the process completes, the following happen:
  - The status is updated to Running.
  - The page is updated with information about the Workplace environment that was created and started. A URL similar to http://<system_name>:2056/lwp/workplace is listed. Click this link or cut and paste it into a new Web browser session.
  Minimize the IBM Web Administration for i5/OS browser window.
Configure iSeries Access for Web portlets.
If iSeries Access for Web portlets were automatically deployed in step 2.h, skip to step 4.
If iSeries Access for Web portlets were not automatically deployed in step 2.h, use these commands to deploy iSeries Access for Web to Workplace Services Express:
```
STRQSH cd /QIBM/ProdData/Access/Web2/install cfgaccweb2 -appsvrtype *WSE -wasinst iwawse26 -wpusrid wpsadmin 
           -wppwd wp_password -wpurl system_name:2056/lwp/config 
           -wpdftpag *CREATE
```
The configuration command uses these variables:

iwawse26

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

wpsadmin

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:2056/lwp/config

The Uniform Resource Locator (URL) to access the Workplace Services Express configuration servlet. Replace system_name with the name of your i5/OS.

*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 Workplace Services Express log in page. The URL might be similar to http://(system_name):(2056)/lwp/workplace.
2. Select the Log in link in the upper right corner of the page to log in to Workplace Services Express.
3. The Web page prompts for a User ID and Password.
  - In the User ID field, enter a Workplace Services Express 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 edit icon in the upper right corner of the portlet window.
  - 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 Edit icon in the upper right corner of the iSeries Printer Output - Viewer portlet. Select View file within portlet.
  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 setting up 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:

Created an IBM Workplace Web serving environment.
Configured iSeries Access for Web portlets.
Began using iSeries Access for Web portlets.

Parent topic:

Examples for configuring a new portal environment