Configuring an integrated Web application server Instance

This example is for users that are not familiar with the Web serving environment. It describes all the steps necessary to get IBM i Access for Web running in an integrated Web application server instance. It also describes how to verify that the setup is working.

1. Start the IBM Web Administration for i 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.
2. Create an integrated Web application server instance.
   1. Open a browser to http://<system_name>:2001/HTTPAdmin.
   2. Log in with a user profile that has, at least these special authorities:  *ALLOBJ, *IOSYSCFG, *JOBCTL, and *SECADM.
   3. Select the Setup tabbed page.
   4. Under Common Tasks and Wizards, select Create Application Server.
   5. The Create Application Server page opens. Select Next.
   6. Select an option under IBM integrated Web application server for i, then select Next.
   7. The Specify Application Server Name page opens. For Application server name, specify IWAIAS. This will be the name of the integrated Web application server. Select Next.
   8. The Specify Internal Ports Used by the Application Server page opens. For First port in range, change the default value to 21060. This port number is an example. You should verify this port is available for use, or use a port you know is available. Select Next.
   9. The Create a new HTTP server (powered by Apache) page opens.
      • For HTTP server name, enter IWAIAS
      • For Port, specify 2060. This port number is an example. You should verify this port is available for use, or use a port you know is available.

      Select Next.
   10. The Specify User ID for this Server page opens. Select Next.
   11. The Sample Applications page opens. Select Next until the Summary page opens.
   12. Select Finish.
   13. The Web page is re-displayed with the Manage > Application Servers tabbed page active. Under Server, IWAIAS is listed with a status of Creating.
       From this Web page, you can manage the integrated Web application server.

       Use the refresh icon next to the Creating status to refresh the page, if the page does not periodically refresh.

       Important: Wait for the status to be updated to Running before moving to the next step.
   14. Minimize the browser window.
3. Configure IBM i Access for Web.
   1. Restore the 5250 session window.
   2. 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:

      1. Configure IBM i Access for Web for your Web application server by using the following command:

         CFGACCWEB APPSVRTYPE(*INTAPPSVR) INSTANCE(IWAIAS)

         These are the parameters used:

         APPSVRTYPE

         Tells the command which Web application server to configure.

         INSTANCE

         Tells the command which IBM integrated Web application server for i instance 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 the New Web application server considerations topic. 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.
         • IBM i Access for Web command has completed.
      3. Press F3 or 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 previously created:

         cfgaccweb -appsvrtype "*INTAPPSVR" -instance "IWAIAS"

         These are the parameters used:

         -appsvrtype

         Tells the command which Web application server to configure.

         -instance

         Tells the command which IBM integrated Web application server for i instance 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. After successfully configuring IBM i Access for Web, the IBM integrated Web application server instance must be restarted to load the changes to its configuration. This will be done later.
   5. Signoff the 5250 session window and close the window.
4. Start the Web environment.
   1. Return to the browser window that is open to the IBM Web Administration for i server management page.
   2. The Manage > Application Servers tabbed page should be active. Under Server IWAIAS is listed with a status of Running. Stop and restart the integrated Web application server:
      1. Select the red icon next to the Running status to stop the integrated Web application server. The IWAIAS HTTP server will also be stopped. Select the refresh icon next to the Stopping status to refresh the page if the page does not periodically refresh.
      2. When the status is updated to Stopped, select the green icon next to Stopped to start the integrated Web application server. The IWAIAS HTTP server will also be started.
      3. The status will be updated to Starting. Select the refresh icon next to the Starting status to refresh the page if it does not periodically refresh.
         Important: Wait for the status to be updated to Running before moving to the next step.
         IBM i Access for Web will load and start as the integrated Web application server starts.
   3. Close the browser window.
5. Use a browser to access IBM i Access for Web.
   1. Open a browser to either of the following addresses to access IBM i Access for Web:
      http://<system_name>:2060/webaccess/iWAHome
      http://<system_name>:2060/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 Home or Main page displays.
   4. Close the browser window.