Creating and configuring HTTP server instances on IBM i

Learn how to create and configure an IBM® HTTP Server instance.

Before you begin

This article assumes that you have started the *Admin instance of IBM HTTP Server. See Starting the *ADMIN instance of IBM HTTP Server on IBM i for more information.

About this task

Use this procedure to create and configure an instance of IBM HTTP Server.

If you have an existing instance that you want to use with WebSphere® Application Server, skip directly to the configuration step.

Procedure

Create a new instance of IBM HTTP Server.
To create a new instance of the IBM HTTP Server (powered by Apache) with a basic configuration, use the IBM HTTP Server for IBM i configuration and administration forms.

Perform the following steps:
1. Using a web browser, go to the IBM HTTP Server for IBM i configuration and administration forms.
  1. Open this URL in your browser:
```
http://your.server.name:2001/
```
    The your.server.name variable is the name of your IBM i server.
  2. Enter a valid user ID and password for your IBM i server.
  3. Select IBM Web Administration for IBM i at the IBM i Tasks page.
2. The IBM Web Administration for IBM i page is displayed.
  1. To create a new HTTP server, click the Setup tab.
  2. Expand Common Tasks and Wizards.
  3. Click Create New HTTP Server.
3. Select HTTP server (powered by Apache), then click Next.
4. In the this frame, type a name for the HTTP server instance and an optional description, then click Next.
  
  The name appears in the HTTPSVR subsystem when the job is running.
  
  Write down the HTTP server instance name for use in later steps.
5. Type the server root, then click Next.
  You can use default values or you can specify another server root or document root directory.
6. Set the document root in the next panel, then click Next.
7. Select the IP address and port.
  1. Select All addresses in the IP address field.
  2. Accept the default port, 80, for the port number that the HTTP Server instance uses to process requests or type a unique port number, then click Next.
  If you specify a port other than the default port, you must configure your virtual host Domain Name System (DNS) aliases in the administrative console to reflect your port number. For more information, read the Virtual hosts article.
  
  Write down the internal HTTP port number for use in later steps.
8. Select a logging option.
  It is recommended that you select Yes. Logs are stored in the /server_root/logs directory, where server_root is the server root that you set earlier.
9. Specify how long you want to keep the error and access log files, then click Next.
10. Review your settings. To create the HTTP server instance, click Finish. To make changes, click Back.
11. After you click Finish, the configuration is created. The Manage Apache Server page is displayed.
Configure the HTTP server instance
After you create the HTTP server instance, configure the instance so that it works with WebSphere Application Server.
1. Click the Manage tab. In the Server list, select the HTTP server instance that you want to manage.
2. With your HTTP server selected, expand Server Properties. Click WebSphere Application Server. Select the version of WebSphere Application Server to configure, and select the default WebSphere Application Server profile.
3. Click OK to write the changes to the configuration file and return to the main configuration page.

What to do next

You have completed step 3 of 5.

Go to Starting WebSphere Application Server on IBM i to continue the installation.