Getting started with the IBM Web Administration for i5/OS interface

This topic provides everything you need to know to get started with HTTP Server and the IBM® Web Administration for i5/OS™ interface, quickly.

Important: Information for this topic supports the latest PTF levels for HTTP Server for i5/OS . It is recommended that you install the latest PTFs to upgrade to the latest level of the HTTP Server for i5/OS. Some of the topics documented here are not available prior to this update. See http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm Link outside Information Center for more information.

Step 1: Install

Three easy steps to get you on your way to using the IBM Web Administration for i5/OS interface.

  1. Your first step is to install the IBM Web Administration for i5/OS interface. See Install and test the HTTP Server for more information.
  2. Make sure you have the correct user profiles and required authorities for HTTP Server. See User profiles and required authorities for HTTP Server for more information.
  3. Finally, test your installation of the IBM Web Administration for i5/OS interface. See Test the installation of HTTP Server (powered by Apache) for more information.

Step 2: Set up an HTTP Server (powered by Apache) instance

Once the IBM Web Administration for i5/OS interface is ready, it is time to set up your first HTTP Server (powered by Apache) instance.

Use the Create HTTP Server wizard to quickly create a working HTTP Server (powered by Apache) configuration.

  1. Start the IBM iSeries™ Tasks page.

    Non-secure connection: http://your.server.name:2001/

    Secure connection: https://your.server.name:2010/
    Note: *ADMIN HTTP server for SSL configuration is required for secure connections. For more information, see Set up SSL for the administration (ADMIN) server for HTTP Server
  2. Click IBM Web Administration for i5/OS™
  3. Click the Setup tab.
  4. Expand Common Tasks and Wizards.
    Note: By default, all lists are expanded. If you collapse any list, the IBM Web Administration for i5/OS interface displays the list as collapsed the next time you view it.
  5. Click Create HTTP Server.
  6. Enter a name to identify your HTTP Server (powered by Apache). This name is used later to configure and administer your server. Enter a server description to help identify your server.
  7. Click Next.
  8. Enter the server root. The server root is the base directory for your HTTP Server. Within this directory, the wizard creates subdirectories for your logs, and configuration information. If the server root does not exist, the Create HTTP Server wizard creates one for you.
  9. Click Next.
  10. Enter the document root. The document root is the directory from which your documents are served by your HTTP Server. If the directory root does not exist, the Create HTTP Server wizard creates one for you.
  11. Click Next.
  12. Leave the IP address list as All addresses. You may select a specific IP address if you so choose.
  13. Enter a port number. By default, the port is 80. This is the port your Web site runs (or "listens on"). It is suggested you enter a different port other than 80 because a port can only be used by one server at any time.
  14. Click Next.
  15. Select Yes or No for the Create HTTP Server wizards to create an access log. The access log contains information about requests made to your HTTP Server. This information is useful for analyzing who is accessing your Web site and how many requests have been made during a specific period of time.
  16. Click Next.
  17. Specify how long you want to keep the error and access log files. Select Keep, do not delete or Delete based upon age.
  18. Click Next.
  19. The Create HTTP Server wizard displays a summary of HTTP Server (powered by Apache) configuration it creates. If you want to change an entry, simply click Back.
  20. Click Finish and HTTP Server (powered by Apache) is created.

For more information on the IBM Web Administration for i5/OS interface, see IBM Web Administration for i5/OS.

Step 3: Start and test your HTTP Server (powered by Apache)

After using the Create HTTP Server wizard, it is time to start your Web server and go live.

  1. Click the Start icon next to the Server list.
  2. Click the Refresh icon and check if the server status is still shown as "Running".

    If your HTTP Server (powered by Apache) does not start, see Troubleshoot.

  3. Open another Web browser of your choice (see Web browser requirements) and go to http://your.server.name:port/ where your.server.name is the name of your i5/OS server and port is the port number you entered in the Create HTTP Server wizard.

The supplied HTML example welcome page is displayed.

When you have finished this preliminary work with the IBM Web Administration for i5/OS interface, expand your HTTP server capabilities. See the Scenarios for HTTP Server for more information.

Parent topic: Tasks