Editing web server configuration files

Edit web server configuration files to configure a Web server.

The Web Server Plug-ins Configuration Tool configures supported web servers. Use this topic to understand how the tool configures the web server configuration files.

(Dist) If change a configuration for some reason, we can run the Web Server Plug-ins Configuration Tool again to re-configure the web server or we can edit the files.

There are some web server configuration settings that cannot be edited:

• The plugin-cfg.xml and plugin-key.kdb properties are greyed-out and cannot be edited on the page...
  Servers > Server Types > Web servers > web_server > Plug-in Properties

• After the web server definition is created, the /config/webserver value that is appended to the end of plugins_root cannot be edited.

(Dist) To support a nondefault profile, edit the configuration to point the web server to the correct location of the plug-in configuration file (plugin-cfg.xml). In this case, we would change the profile path from the default profile to the secondary profile.

(iSeries) Use the IBM Web Administration for IBM i to configure IBM i web servers to communicate with a WebSphere Application Server. Doing so automatically updates the web server configuration files as needed. See the topic about creating and configuring an HTTP server instance for more information.

(iSeries) If change a configuration for some reason, we can use the IBM Web Administration for IBM i to re-configure the web server, or we can edit the files. The recommended approach is to always use the IBM Web Administration for IBM i to configure the web server configuration file. However, sometimes we must edit the files.

We must determine whether the web server application uses a 32-bit or 64-bit architecture. If our machine supports a 64-bit architecture, we can use either a 32-bit or a 64-bit web server application. The following examples show how to determine which the architecture for our web server application:

• For Apache-based web servers, including IBM HTTP Server, we can determine the architecture using the following techniques:
  • (UNIX) Run the command:
    apachectl -V | grep Architecture

    This command displays the Architecture value for the web server, which will be either 32-bit or 64-bit.

  • (Windows) Run the following command from the IBM_HTTP_Server_install_root\bin directory:
    apache -V

    Look for the value of the Architecture: line in the output. This value is either 32-bit or 64-bit.

• For other, non-Apache based web servers, use the following techniques. These techniques also work for Apache-based web servers.
  • (UNIX) Run the file command against the primary web server application executable file to display its type. For example, on an AIX system:

    file /usr/bin/httpd
    

    This command results in the following output:

    • For a 64-bit web server: httpd: 64-bit XCOFF executable ...

    • For a 32-bit web server: httpd: executable (RISC System/6000)...

    In general, if the output of the file command does not indicate 64 in the output, then the application is 32-bit application.

  • (Windows) Open the Microsoft Windows Task Manager when the server is running and locate the server in the process list. A 32-bit application has *32 after its name.

If the web server application uses a 64-bit architecture, the plug-in library should be loaded from the plugins_root/bin/64bit directory. If the web server application uses a 32-bit architecture, the plug-in library should be loaded from the plugins_root/bin/32bits directory. If the plugins_root/bin/64bits directory does not exist, use the 32-bit architecture.

Tasks

• Configure Apache HTTP Server 2.2.
• Configure Domino Domino Web Server v5 and v6.x.
• Configure IBM HTTP Server v9.0.
• Configure Microsoft Internet Information Services (IIS).
• Configure Sun Java System Web Server

(Dist) Use the Web Server Plug-ins Configuration Tool to configure supported web servers. We can also configure a web servers by editing its configuration.

(iSeries) Use the IBM Web Administration for IBM i to configure IBM i Web servers. We can also configure a web servers by editing its configuration.