[AIX HP-UX Linux Solaris Windows]This topic applies only on the i5/OS operating system.

Web server configuration

Plug-in configuration involves configuring the Web server to use the binary plug-in module that WebSphere Application Server provides. Plug-in configuration also includes updating the plug-in XML configuration file to reflect the current application server configuration. The binary module uses the XML file to help route Web client requests.

[AIX HP-UX Linux Solaris Windows] After installing a supported Web server, you must install a binary plug-in module for the Web server. The plug-in module lets the Web server communicate with the application server. The Plug-ins installation wizard installs the Web server plug-in. The wizard configures the Web server. The wizard also creates a Web server definition in the configuration of the application server. The Plug-ins installation wizard uses the following files to configure a plug-in for the Web server that you select:
[iSeries] The plug-ins configuration process uses the following files to configure a plug-in for the Web server that you select:

See the following descriptions of each file.

Web server configuration file

The Web server configuration file is installed as part of the Web server.

[AIX HP-UX Linux Solaris Windows] The wizard must reconfigure the configuration file for a supported Web server.

Configuration consists of adding directives that identify file locations of two files:
  • The binary plug-in file
  • The plugin-cfg.xml configuration file

The binary Web server plug-in file

See Web server plug-ins for a description of the binary plug-in module.

An example of a binary plug-in module is the mod_ibm_app_server_http.dll file for IBM HTTP Server on the Windows platform.

[iSeries] Another example of a binary plug-in module is the QSVTAP20 service program on the iSeries platform.

The binary plug-in file does not change. However, the configuration file for the binary plug-in is an XML file. The application server changes the configuration file when certain changes to your WebSphere Application Server configuration occur. See Web server plug-in configuration service property for examples of when the file gets regenerated and when it does not.

The binary module reads the XML file to adjust settings and to route requests to the application server.

The plug-in configuration file, plugin-cfg.xml

The plug-in configuration file is an XML file with settings that you can tune in the administrative console. The file lists all of the applications installed on the Web server definition. The binary module reads the XML file to adjust settings and to route requests to the application server.

[AIX HP-UX Linux Solaris Windows] The stand-alone application server regenerates the plugin-cfg.xml file in the profile_root/config/cells/cell_name/nodes/web_server_name_node/servers/web_server_name directory. Regeneration occurs whenever a change occurs in the application server configuration that affects deployed applications.

[AIX HP-UX Linux Solaris Windows] The deployment manager regenerates the plugin-cfg.xml file in the profile_root/config/cells/cell_name/nodes/node_name/servers/web_server_name directory whenever a change occurs in application server configuration that affects deployed applications on the managed node.

[iSeries] When you make application server configuration changes that affect deployed applications, regenerate the plug-in configuration XML file.

After regeneration, propagate (copy) the file to the Web server machine. The binary plug-in then has access to the most current copy of its configuration file.

[AIX HP-UX Linux Solaris Windows] The Web server plug-in configuration service automatically regenerates the plugin-cfg.xml file after certain events that change the configuration. The configuration service automatically propagates the plugin-cfg.xml file to an IBM HTTP Server machine when the file is regenerated. You must manually copy the file on other Web servers.

[iSeries] On i5/OS systems, the plug-in is not automatically generated. You must regenerate and propagate the file manually.

See Web server plug-in configuration service property for more information.

Default plug-in configuration file, plugin-cfg.xml [AIX HP-UX Linux Solaris Windows]

The Plug-ins installation wizard creates the temporary plugin-cfg.xml file in the plugins_root/config/web_server_name directory. The wizard creates the file for every remote installation scenario. The wizard creates the file at the same time that it installs the binary plug-in module for the Web server.

The default file is a placeholder that you must replace with the plugin-cfg.xml file from the Web server definition on the application server. The default file is a replica of the file that the application server creates for a default stand-alone application server that has the samples installed.

Run the configureweb_server_name script from the app_server_root/bin directory of the application server machine for a remote installation, or directly from the plugins_root/bin directory for a local installation. The script creates the Web server definition in the configuration files of the default profile. To configure a different profile than the default, edit the configureweb_server_name script. Use the -profileName parameter to identify a different profile than the default.

After the Web server definition is created, the Web server plug-in configuration service within the application server creates the first plugin-cfg.xml file in the Web server definition on the application server machine. If you install an application, create a virtual host, or do anything that changes the configuration, you must propagate the updated plugin-cfg.xml file from the application server machine to the Web server machine to replace the default file.

The configureweb_server_name script for the Web server definition [AIX HP-UX Linux Solaris Windows]

The Plug-ins installation wizard creates the configureweb_server_name script on the Web server machine in the plugins_root/bin directory. If one machine in a remote scenario is running under an operating system like AIX or Linux and the other machine is running under Windows, use the script created in the plugins_root/bin/crossPlatformScripts directory. The script is created for remote installation scenarios only.

Copy the script from the Web server machine to the app_server_root/bin directory on a remote application server machine. You do not have to copy the script on a local installation. Run the script to create a Web server definition in the configuration of the application server.

When using the IBM HTTP Server, configure the IBM HTTP Administration Server also. The IBM HTTP Administration Server works with the administrative console to manage Web server definitions. Also, use the administrative console to update your Web server definition with remote Web server management options. Click Servers > Web servers > web_server_name to see configuration options. For example, click Remote Web server management to change such properties as:
  • Host name
  • Administrative port
  • User ID
  • Password
Important: Always open a new command window before running this script. You can avoid a potential problem by doing so.

The problem is a potential conflict between a shell environment variable, the WAS_USER_SCRIPT environment variable, and the actual default profile. The script always works against the default profile. However, if the WAS_USER_SCRIPT environment variable is set, a conflict arises as the script attempts to work on the profile identified by the variable.

The variable is easy to set accidentally. Issue any command from the profile_root/bin directory of any profile and the variable is set to that profile.

If you have more than one profile on your system, the potential exists that the default profile and the profile identified by the variable are different profiles. If so, a conflict occurs and the script might not create the Web server definition in the correct profile, or might not create the Web server definition at all.

Reset the variable in either of two ways:
  • Close the command window where the variable is set and open a new one.
  • Change directories to the profile_root/bin directory of the default profile and source the setupCmdLine.sh script:
    [Windows]
    1. Open a command prompt window.
    2. Change directories to the app_server_root\bin directory.
    3. Issue the setupCmdLine.bat command.
    4. Use the same command prompt window to start the update installer, as described in the appropriate procedure.
    [AIX] [HP-UX] [Linux] [Solaris]
    1. Open a command shell window.
    2. Change directories to the app_server_root/bin directory.
    3. Issue the . ./setupCmdLine.sh command. Notice the space between the periods. The special format for this command sources the command to make the setting active for all processes started from the command shell.
    4. Use the same command shell window to start the update installer, as described in the appropriate procedure.

If a Web server definition already exists for a stand-alone application server, running the script does not add a new Web server definition. Each stand-alone application server can have only one Web server definition.

Note: The webserverNodeName value in the script is a concatenation of the nick name you have chosen for the web server and the suffix -node. It is automatically created during plug-in installation and cannot be changed. For example, if you named your web server myserver during plug-in installation, the value for the associated Web server definition created after you ran the script would be myserver-node.
You cannot use the administrative console of a stand-alone application server to add or delete a Web server definition. However, you can do both tasks using the administrative scripting interface:
  • Add a Web server definition through the wsadmin facility using the configureweb_server_name script. The script uses a Java Command Language (Jacl) script named configureWebserverDefinition.jacl to create and configure the Web server definition.
  • Delete a Web server definition using wsadmin commands. The Web server is named webserver1 in the following example:
     set webserverName webserver1
     set webserverNodeSuffix _node
     set webserverNodeName   $webserverName$webserverNodeSuffix
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName/Server:$webserverName]
     $AdminConfig remove [$AdminConfig getid /Node:$webserverNodeName]
     $AdminConfig save
    

A managed node, on the other hand, can have multiple Web server definitions. The script creates a new Web server definition unless the Web server name is the same.

The configuration script for the Web server definition [iSeries]

Configuring your Web server with the configureOs400WebserverDefinition script or using the iSeries Administrative GUI creates the configureweb_server_name script on the Web server machine in the plugins_root/bin directory. The script is created for remote installation scenarios only.

Copy the script from the Web server machine to the app_server_root/bin directory in the i5/OS partition. Run the script to create a Web server definition in the configuration of the application server.

The iSeries Administrative GUI has plug-ins that allow the administrative console to manage IBM HTTP Servers. Use the administrative console to update your Web server definition with remote Web server management options. Click Servers > Web servers > Web_server to see configuration options. For example, click Remote Web server management to change such properties as:
  • Host name
  • Administrative port
  • User ID
  • Password

If a Web server definition already exists for a stand-alone application server, running the script does not add a new Web server definition. Each stand-alone application server can have only one Web server definition.

You cannot use the administrative console of a stand-alone application server to add or delete a Web server definition. However, you can do both tasks using the administrative scripting interface:
  • Add a Web server definition through the wsadmin facility using the configureweb_server_name script. The script uses a Java Command Language (Jacl) script named configureWebserverDefinition.jacl to create and configure the Web server definition.
  • Delete a Web server definition using wsadmin commands. The Web server is named webserver1 in the following example:
    set webserverName webserver1
    set webserverNodeSuffix _node
    set webserverNodeName 
    $webserverName$webserverNodeSuffix
    $AdminConfig remove 
      [$AdminConfig getid 
        /Node:$webserverNodeName/Server:$webserverName]
    $AdminConfig remove 
      [$AdminConfig getid /Node:$webserverNodeName]
    $AdminConfig save
    

Alternatively, you can use the configureOs400WebServerDefinition and removeOs400WebServerDefinition scripts to perform these tasks.

A managed node, on the other hand, can have multiple Web server definitions. The script creates a new Web server definition unless the Web server name is the same.

Replacing the default plug-in configuration file with the file from the Web server definition (propagation)

The default file uses fixed parameter values that might not match the parameter values in the actual file on the application server. The default file is a placeholder only.

The file cannot reflect changes that occur in the application server configuration. The file also cannot reflect non-default values that might be in effect on the application server.

[AIX HP-UX Linux Solaris Windows] The application server must have the following values in the actual plugin-cfg.xml file. If so, the default file can successfully configure the binary plug-in module. Then, the plug-in module can successfully communicate with the Web server and the application server.

[AIX HP-UX Linux Solaris Windows] Suppose that the application server does not have the following values in the actual plugin-cfg.xml file. In that case, the default file configures the binary plug-in module incorrectly. The plug-in module can always communicate with the Web server. But with an improper configuration file, the plug-in module cannot communicate successfully with the application server.

[AIX HP-UX Linux Solaris Windows] The following are fixed parameter values in the temporary plug-in configuration file.
  • Virtual host name

    Default value: default_host

    This virtual host is configured to serve the DefaultApplication and the Sample applications. This value is probably the same as the value in the real plugin-cfg.xml file. However, suppose that you create another virtual host for serving applications and install the DefaultApplication on it. If so, the actual plugin-cfg.xml file is regenerated. The Web server cannot access the DefaultApplication. (The application includes the snoop servlet and the hitcount servlet.)

    To access applications on the new virtual host, propagate the real plugin-cfg.xml file. Propagation is copying the updated file from the application server machine to the Web server machine.

  • HTTP transport port

    Default value: 9080

    The 9080 value is the default value for the HTTP transport port for the default_host virtual host. This value is probably the same as the value in the updated file. However, this value changes for every profile on the application server machine. The HTTP transport port value must be unique for every application server.

    To communicate over a different port, propagate the real plugin-cfg.xml file.

  • Web server listening port

    Default value: 80

    The 80 value is the default value for the port that controls communication with the Web server. However, each application server profile must have a unique port value to communicate to a Web server. The actual port value might be 81 or another number.

    To communicate over a different port, propagate the real plugin-cfg.xml file.

  • HTTPS transport port

    Default value: 9443

    The 9443 value is the default value for the HTTPS (secure) transport port for the default_host virtual host. This value is probably the same as the value in the updated file. However, this value changes for every profile on the application server machine. The HTTPS transport port value must be unique for every application server.

    To communicate over a different secure port, propagate the real plugin-cfg.xml file.

  • Applications installed on the server1 application server

    All of the default servlets and applications are included in the default file, including the WSsamples application and the SamplesGallery application.

    The default file lists all of the default applications and samples. The list can be inaccurate. If you performed a custom installation and did not install the samples, for example, the list is inaccurate.

    To serve an application that you developed with the Web server, propagate the real plugin-cfg.xml file.




Related concepts
[AIX HP-UX Linux Solaris Windows] Plug-ins configuration
Related tasks
Editing Web server configuration files
Mapping modules to servers
[AIX HP-UX Linux Solaris Windows] Installing Web server plug-ins
Related reference
Web server plug-in configuration service property
Concept topic Concept topic    

Terms and conditions for information centers | Feedback

Last updatedLast updated: Aug 31, 2013 2:56:59 AM CDT
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=pix&product=was-nd-dist&topic=cinswebserver
File name: cins_webserver.html