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.
- Start a 5250 session to the system.
- Sign on with a user profile that has at least these
special authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.
- Run the following command to start the Web administration
interface job:
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)
- Minimize the 5250 session.
- Start the IBM WebSphere Portal environment.
- Open a browser to
http://<system_name>:2001/HTTPAdmin
.
- Log in with a user profile that has, at least, these
special authorities: *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.
- Select the Manage tab page.
- 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.
- 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.
- Select the Log in link
in the upper right corner of the page to log in to IBM WebSphere Portal.
- 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.
- The Web page is updated displaying the Welcome
page.
- Select the new My IBM i tab
page.
- 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.
- Select the Print link.
- 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.
- 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.
- 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.
- 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.
- 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.
- Select the 5250 link
on the left side of the window.
- 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.