Configuration Manager - Commerce - Web Server

Use the Web Server page of the Configuration Manager to configure WebSphere Commerce to use your Web server.

Important:

If you use IBM HTTP Server or Sun ONE Web server, WebSphere Commerce modifies the Web server configuration file whenever you do any of the following:

  • Create a WebSphere Commerce instance.
  • Create a WebSphere Commerce Payments instance.
  • Update information in the Web Server panel in Configuration Manager for an existing instance.

These changes are marked by IBM WebSphere Commerce (Do not edit this section) or IBM WebSphere Payments (Do not edit this edition)

Customized changes within these sections are not supported by WebSphere Commerce as any changes made within these sections may be overwritten at any time by WebSphere Commerce configuration tools such as Configuration Manager.

Complete the fields as follows:

Use Remote Web server
Select this check box if you are installing your Web server on a separate machine from your WebSphere Commerce machine.

Note: If you have installed your Web server on a different node than WebSphere Commerce (for example, if you are configuring a three-node environment), you must select this check box.

Hostname
Enter the fully qualified host name of your Web server machine or Web server instance that WebSphere Commerce will use. (hostname.domain is fully qualified). Ensure that you do not enter www in the Hostname field.

If you are using a remote Web server this will be different than the hostname of the WebSphere Commerce machine.

Web Server Type
Select the Web server to be used. The default is IBM HTTP Server.

If you select Manual Configuration, the remaining fields on this panel will be hidden.

Windows Server Number
This field is displayed when you select Internet Information Server as the Web server type. The default server number is 1.

This field is disabled when you select Use Remote Web Server.

Enter the server number of the IIS Web server. For more information about server number, refer to the Microsoft Internet Information Services documentation.

Sun Solaris Operating EnvironmentWindows Primary Document Root

This field only displays if you select SunOne Web server as the Web server type.

Enter the full path of the Web server document root directory. The primary document root is the directory out of which you will serve your documents. By default, all requests are taken from this directory, but symbolic links and aliases may be used to point to other locations.

The default paths for the primary document root paths for SunONE Web server is SunONEweb_installdir/docs.

Server port
Enter the port number on which your Web server is running. The default value is 80.
WC Accelerator Port Number
Enter the port number for accessing the WebSphere Commerce Accelerator.

The default is port 8000.

If you want to change this port after a WebSphere Commerce instance is created, refer to the WebSphere Commerce Installation Guide for instructions.

WC Admin Port Number
Enter the port number used for accessing the WebSphere Commerce Administration Console.

The default port number is 8002.

If you want to change this port after a WebSphere Commerce instance is created, refer to the WebSphere Commerce Installation Guide for instructions.

WC OrgAdmin Port Number
Enter the port number used for accessing the WebSphere Commerce Organization Administration Console.

The default port number is 8004.

If you want to change this port after a WebSphere Commerce instance is created, refer to the WebSphere Commerce Installation Guide for instructions.

Authentication Mode
Windows This field is not available if you selected IIS as your Web server.
Select the authentication mode that you would like to use for this WebSphere Commerce instance. The choices are as follows:
Basic
Authentication will be performed using a custom certificate.
X509
Authentication will be performed using the X509 certificate standard. For more information, see the "x.509" topic in the WebSphere Commerce Information Center.
i5/OSiSeries Configuration File Directory
The folder that contains the IBM HTTP Server configuration file, httpd.conf. For a remote Web server, this folder exists on the remote machine.

AIXSun Solaris Operating EnvironmentWindowsIf you selected SunONE as the Web server type, the following fields are enabled:

Secure Server Config File Path
Enter the full path (including the file name) to the obj.conf file for your secure Web server on port 443.

For example, Sunweb_installdir/https-hostname/config/hostname443-CLASS.obj.conf

Non-secure Server Config File Path
Enter the full path (including the file name) to the obj.conf file for your non-secure Web server on port 80.

For example, Sunweb_installdir/https-hostname/config/obj.conf.

Secure Tools Server Config File Path
Enter the full path (including the file name) to the obj.conf file for the secure WebSphere Commerce tools Web server on port 8000.

For example, Sunweb_installdir/https-hostname/config/hostname8000-CLASS.obj.conf.

Secure Admin Server Config File Path
Enter the full path (including the file name) to the obj.conf file for the secure WebSphere Commerce administration Web server on port 8002.

For example, Sunweb_installdir/https-hostname/config/hostname8002-CLASS.obj.conf.

Secure OrgAdmin Server Config File Path
Enter the full path (including the file name) to the obj.conf file for the secure WebSphere Commerce organization administration Web server on port 8004.

For example, Sunweb_installdir/https-hostname/config/hostname8004-CLASS.obj.conf.

The actual full paths of your configuration files can be different from the examples listed here.

The following fields display if you select the Use Remote Web Server check box.

AIXLinuxSun Solaris Operating EnvironmentWindows Remote Server Install Path
Enter the full path of the installation directory for the Web server on the remote Web server node. This field is displayed only if IBM HTTP Server is selected as the Web Server Type.
i5/OS Configuration File Directory
Enter the full path of the folder that will contain the IBM HTTP Server configuration file, httpd.conf on the remote Web server.
AIXLinuxSun Solaris Operating Environment Remote Configuration
This check box is displayed if you select Use Remote Web Server.

Select the Remote Configuration check box if the remote Web server is running on a UNIX or Linux system. This setting along with the remote user name and remote configuration information is used when sending files from the WebSphere Commerce node to the Web server node using FTP.

Selecting Remote Configuration clears Mapped Network Drive Configuration.

Selecting the Remote Configuration check box may display the following fields, depending on the Web server type chosen:

Remote Server Name
Enter the fully qualified host name of the remote system.
AIXLinuxSun Solaris Operating EnvironmentWindows Remote Server Port
Enter the FTP port number for the remote system. The default FTP port is 21.
Remote User Name
AIXLinuxSun Solaris Operating EnvironmentWindows Enter the user ID with FTP access to the remote system. The user should have sufficient authority to create files on the remote system.
i5/OSiSeriesEnter the user name who has access to the remote machine. The user should have sufficient authority to create files on the remote system.
Remote User Password
Enter the password associated with the remote user name.
AIXLinuxSun Solaris Operating EnvironmentWindows Mapped Network Drive Configuration
This check box is displayed if you select Use Remote Web Server.

This setting along with the remote user name and password is used to send files from the WebSphere Commerce node to the Web server node using a mapped network drive.

Selecting Mapped Network Drive Configuration clears Remote Configuration.

Selecting this check box may display the following fields, depending on the Web server type chosen:

Mapped Server Directory

Enter the full path of the mapped directory where the Web server is installed. Include the mapped drive letter in the path.

Generate properties file only
This check box only displays in the Instance Creation wizard.

Select this check box if you do not want to create an instance but you want to populate a properties file. The properties file can be used with the CreateInstance Ant target to create a WebSphere Commerce instance.

The properties file is found in WC_installdir/instances/instance_name/properties/createInstance.properties.

Feedback