CONFIGURING


Configuring the WebSphere plug-in
The WebSphere configuration file WebSphere\AppServer\config\plugin-cfg.xml controls the operation of the plug-in.

About this task

In order for the plug-in to relay requests to the target IBM® Domino® server, you must add directives to plugin-cfg.xml to define a transport route to the server, and pattern rules for the URL namespaces that identify requests which are to be relayed to Domino. The plug-in will only relay requests that match a namespace rule. All other requests will be handled by the front-end Web server.

Procedure

1. Open plugin-cfg.xml in Notepad.

2. Modify the <Transport> element to target the appropriate Domino server. To do this, change the Hostname and Port parameters to the proper values required for the plug-in to reach your back-end server's HTTP task. For example:


3. Add these directives to the top of the <UriGroup> section. These directives specify common URL patterns needed for accessing Domino Web applications.
Results

<Uri Name="/*.nsf"/><Uri Name="/icons/*"/><Uri Name="/domjava/*"/><Uri Name="/execcgi/*"/><Uri Name="/cgi-bin/*"/><Uri Name="/servlet/*"/><Uri Name="/download/*"/><Uri Name="/mail/*" />

If your Domino application requires additional namespaces, you can create <Uri> directives for those patterns also.

Note: All the WAS plug-ins automatically reread the configuration file once a minute to pick up changes. If you don't want to wait that long, you must stop and restart the front-end Web server. In the case of the IIS plug-in, you must stop the World Wide Web Publishing Service from the Windows services control panel, then restart the Web site from the Internet Services Manager. Just stopping and restarting the Web site by itself won't work because the plug-in DLL won't be reloaded.

Related information
"plugin-cfg.xml file" in WebSphere Application Server Version 6.1 Information center