Configuring integrated Web application server

Use this information to configure IBM i Access for Web for running in an integrated Web application server environment.

1. Sign on to your system.
2. IBM i Access for Web 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 best suits your circumstances.

   To use the CL command, follow these steps:

   1. Configure IBM i Access for Web using the following command:

      CFGACCWEB APPSVRTYPE(*INTAPPSVR)

      These are the parameters used:

      APPSVRTYPE

      Tells the command which Web application server to configure.

      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. ii. Several messages similar to these will be displayed:
      • Configuring IBM i Access for Web.
      • Preparing to perform the configuration changes.
      • IBM i Access for Web command has completed.
   3. Press Enter when the command completes to exit the display session.

   To use the Qshell script command, follow these steps:

   1. Start the Qshell environment by using the following CL 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:

      cfgaccweb -appsvrtype "*INTAPPSVR"

      These are the parameters used:

      -appsvrtype

      Tells the command which Web application server to configure.

      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.
      • IBM i Access for Web command has completed.
   5. Press F3 when the command completes to exit the Qshell session.
3. 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.

4. Stop and start the integrated Web application server to enable the changes made to the configuration. Start the IBM i Access for Web HTTP Web server.
   Use the following commands to enable the configuration changes and start the Web serving environment on your system:

   ENDTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN) 
   STRTCPSVR SERVER(*HTTP) HTTPSVR(*ADMIN)  
   STRTCPSVR SERVER(*HTTP) HTTPSVR(IWADFT)

5. Use a browser to access IBM i Access for Web.
   1. Open a browser to the following address to access IBM i Access for Web Be sure enter it exactly as shown here:
      http://<system_name>:2020/webaccess/iWAMain
   2. Log in using an IBM i user ID and password. The initial load of IBM i Access for Web might take a few seconds. The integrated Web application server is loading Java™ classes for the first time.  Subsequent loads of IBM i Access for Web will be faster.
   3. The IBM i Access for Web Main page displays.