Configuring WebSphere Application Server Network Deployment V6.1 for i5/OS

Use this information to configure IBM i Access for Web for WebSphere® Application Server Network Deployment V6.1 for i5/OS.

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 Network Deployment V6.1, do the following:
  1. Sign on to your system.
  2. Start the WebSphere application server in which you want IBM i Access for Web to run by following these steps:
    1. Run the command STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN).
    2. Open a browser to http://<system_name>:2001/HTTPAdmin.
    3. Navigate to your HTTP server and start it if it is not already running.
    4. Navigate to your WebSphere application server and start it if it is not already running.
    5. Wait for the application server to show a status of running.
    6. Minimize the browser window. You will return to this window in a later step.
  3. 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
    1. Configure IBM i Access for Web for the Web application server: 
      CFGACCWEB APPSVRTYPE(*WAS61ND) 
   WASPRF(was_profile_name) APPSVR(app_svr)  
   WASINSDIR('/QIBM/ProdData/WebSphere/AppServer/V61/ND')
      These are the parameters used:
      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 Network Deployment V6.1 was installed. The default value is /QIBM/ProdData/WebSphere/AppServer/V61/ND.
      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.
      For help on this command and the parameters, press F1.
      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 additional CFGACCWEB command parameters that can be input to migrate user data from an existing configuration to this new configuration.
    2. 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.
    3. Press F3 or Enter when the command completes to exit the display session. Go to step 5
  4. 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
    1. Start the Qshell environment using the following command: QSH
    2. Make the IBM i Access for Web directory the current directory. Run this command: 
      cd /QIBM/ProdData/Access/Web2/install
    3. Configure IBM i Access for Web for the Web application server. Run these commands: 
      cfgaccweb -appsvrtype "*WAS61ND" -wasprf was_profile_name  
   -appsvr app_svr  
   -wasinsdir /QIBM/ProdData/WebSphere/AppServer/V61/ND
      These are the parameters used:
      -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 Network Deployment V6.1 was installed. The default value is /QIBM/ProdData/WebSphere/AppServer/V61/ND.
      -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.
      For help on this command and the parameters, specify the -? parameter.
      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 additional cfgaccweb command parameters that can be input to migrate user data from an existing configuration to this new configuration.
    4. 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.
    5. Press F3 when the command completes to exit the Qshell session.
  5. 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.

  6. Return to the Web administration browser interface window that you minimized in step 2, then stop and restart the WebSphere application server.
  7. Open your browser to http://<your_system_name>:<your_port>/webaccess/iWAMain. Be sure to enter it exactly as shown.
  8. 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.
  9. 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.