Configure ASF Tomcat

Use this information to configure iSeries™ Access for Web for Apache Software Foundation (ASF) Tomcat.

Use these steps to configure iSeries Access for Web for ASF Tomcat:

  1. Sign on to your server.
  2. Start of changeUse the appropriate iSeries Access for Web configuration command.
    • To use the CL command, run this server command:

      QIWA2/CFGACCWEB2 APPSVRTYPE(*ASFTOMCAT) TCSVRNAME(tc_server_name)
           TCHOMEDIR('tc_home_directory') TCUSRPRF(user_id)

    • To use the script command, run these server commands:

      STRQSH
      cd /QIBM/ProdData/Access/Web2/install
      cfgaccweb2 -appsvrtype *ASFTOMCAT -tcsvrname tc_server_name
           -tchomedir tc_home_directory -tcusrprf user_id

    The configuration commands use these variables:
    tc_server_name
    The name of the ASF Tomcat server that was created to run iSeries Access for Web.
    tc_home_directory
    The ASF Tomcat home directory that was specified when you set up your ASF Tomcat server. If you do not know the path, use the IBM® Web Administration for iSeries interface to check the settings for your ASF Tomcat server.
    user_id
    The Tomcat Server user ID that was specified when you set up your ASF Tomcat server. If you do not know the user ID, use the IBM Web Administration for iSeries interface to check the settings for your ASF Tomcat server.
    For help on this command and the parameters, specify the -? parameter.
    Migration Note: Start of changeIf you are already using iSeries Access for Web within another Web application server, refer to New Web application server considerations. This topic discusses additional CFGACCWEB2 command parameters that can be input to migrate user data from an existing configuration to this new configuration.End of change
    End of change
  3. Start the HTTP server by running the server command Start of changeSTRTCPSVR SERVER(*HTTP) HTTPSVR(http_server_name)End of change.
    Note: Replace http_server_name with the name of the Apache powered IBM HTTP server that you created.
  4. Start of changeStop and restart the ASF Tomcat server. Run these server commands, where tc_server_name is the name of the ASF Tomcat server :

    ENDTCPSVR SERVER(*ASFTOMCAT) TOMCATSVR(tc_server_name)
    STRTCPSVR SERVER(*ASFTOMCAT) TOMCATSVR(tc_server_name)

    End of change
  5. Start of changeOpen your browser to http://<your_server_name>:port/webaccess/iWAMain. Be sure the case matches the example.End of change
The iSeries Access for Web main page is displayed.
Note: The first call of the iWAMain page might take a few minutes, but subsequent calls should not take as long.

Start of changeIn this example, only the CFGACCWEB2 command is used to configure iSeries Access for Web. For more information about using all the iSeries Access for Web CL commands, use the CL command finder. End of change

Related information
CL command finder