Configuring WebSphere Application Server V7.0 for IBM i
Use this information to configure IBM i Access for Web for WebSphere® Application Server V7.0 for IBM i.
Note: WebSphere profiles
that are federated to the Network Deployment environment are not supported
by IBM i
Access for Web.
To
configure IBM i
Access for Web for WebSphere Application Server
V7.0, do the following:- Sign on to your system.
- Start the WebSphere application
server in which you want IBM i
Access for Web to
run by following these steps:
- Run the command
STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)
. - Open a browser to
http://<system_name>:2001/HTTPAdmin
. - Navigate to your HTTP server and start it if it is not already running.
- Navigate to your WebSphere application server and start it if it is not already running.
- Wait for the application server to show a status of running.
- Minimize the browser window. You will return to this window in a later step.
- Run the command
- 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. To use the CL command, follow these steps. To use the
Qshell script command, go to step 4
- Configure IBM i
Access for Web for
the Web application server:
These are the parameters used:CFGACCWEB APPSVRTYPE(*WAS70BASE) WASPRF(was_profile_name) APPSVR(app_svr) WASINSDIR('/QIBM/ProdData/WebSphere/AppServer/V7/Base')
- APPSVRTYPE
- Tells the command which Web application server to configure.
- WASPRF
- Tells the command which profile of the Web application server to configure.
- APPSVR
- Tells the command the name of the Web application server within the profile to configure.
- WASINSDIR
- Tells the command the location in the IBM i integrated file system
where WebSphere Application
Server V7.0 was installed. The default value is
/QIBM/ProdData/WebSphere/AppServer/V7/Base
. - WASUSRID
- Tells the command the user ID to use for WebSphere Application Server configuration changes when WebSphere security has been enabled for the profile. In this example you would only need to specify this parameter and value if the profile had security enabled.
- WASPWD
- Tells the command the password for the user ID specified using the WASUSRID parameter. In this example you would only need to specify this parameter and value if the profile had security enabled.
Migration Note: If you are already using IBM i Access for Web within another Web application server, refer to New Web application server considerations. This topic discusses additionalCFGACCWEB
command parameters that can be input to migrate user data from an existing configuration to this new configuration. - Several messages similar to these will be displayed:
- Configuring IBM i Access for Web.
- Preparing to perform the configuration changes.
- Calling WebSphere to perform the configuration changes.
- IBM i Access for Web command has completed.
- The WebSphere application server must be stopped and then started to enable the configuration changes.
- Press Enter when the command completes to exit the display session. Go to step 5
- Configure IBM i
Access for Web for
the Web application server:
- 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. To use the Qshell script command, follow these steps.
To use the CL command, go to step 3
- Start the Qshell environment using the following command:
QSH
- Make the IBM i
Access for Web directory
the current directory. Run this command:
cd /QIBM/ProdData/Access/Web2/install
- Configure IBM i
Access for Web for
the Web application server. Run these commands:
These are the parameters used:cfgaccweb -appsvrtype "*WAS70BASE" -wasprf was_profile_name -appsvr app_svr -wasinsdir /QIBM/ProdData/WebSphere/AppServer/V7/Base
- -appsvrtype
- Tells the command which Web application server to configure.
- -wasprf
- Tells the command which profile of the Web application server to configure.
- -appsvr
- Tells the command the name of the Web application server within the profile to configure.
- -wasinsdir
- Tells the command the location in the IBM i integrated file system
where WebSphere Application
Server V7.0 is installed. The default value is
/QIBM/ProdData/WebSphere/AppServer/V7/Base
. - -wasusrid
- Tells the command the user ID to use for WebSphere Application Server configuration changes when WebSphere security has been enabled for the profile. In this example you would only need to specify this parameter and value if the profile had security enabled.
- -waspwd
- Tells the command the password for the user ID specified using the -wasusrid parameter. In this example you would only need to specify this parameter and value if the profile had security enabled.
Migration Note: If you are already using IBM i Access for Web within another Web application server, refer to New Web application server considerations. This topic discusses additionalcfgaccweb
command parameters that can be input to migrate user data from an existing configuration to this new configuration. - Several messages similar to these will be displayed:
- Configuring IBM i Access for Web.
- Preparing to perform the configuration changes.
- Calling WebSphere to perform the configuration changes.
- IBM i Access for Web command has completed.
- The WebSphere application server must be stopped and then started to enable the configuration changes.
- Press F3 when the command completes to exit the Qshell session.
- Start the Qshell environment using the following command:
- If the command were to fail or indicate an
error, refer to the log files:
- /QIBM/UserData/Access/Web2/logs/cmds.log
High level, cause and recovery information; translated.
- /QIBM/UserData/Access/Web2/logs/cmdstrace.log
Detailed command flow for IBM Software Service; English only.
- /QIBM/UserData/Access/Web2/logs/cmds.log
- Return to the Web administration browser interface window that you minimized in step 2, then stop and restart the WebSphere application server.
- Open your browser to
http://<your_system_name>:<your_port>/webaccess/iWAMain
. Be sure to enter it exactly as shown. - Log in using an IBM i user ID and password. The initial load of IBM i Access for Web might take a few seconds. WebSphere Application Server is loading Java™ classes for the first time. Subsequent loads of IBM i Access for Web will be faster.
- The IBM i Access for Web main page opens.
In this example, only the
CFGACCWEB/cfgaccweb
command
is used to configure IBM i
Access for Web.
For more information about using all the IBM i
Access for Web commands, use the
CL command finder. The CL command finder will find IBM i
Access for Web CL commands. As shown
above there are equivalent Qshell script commands. You can refer to the CL command online help to learn how to use the other Qshell script commands.