Configure Lotus Domino HTTP Server

To configure the Lotus^(R) Domino^(TM) Web server for use with WebSphere Application Server, update the Domino server's configuration.

The following versions of Lotus Domino for iSeries are supported Web servers for WebSphere Application Server V6:

Lotus Domino for iSeries, Version 6.0.3
Lotus Domino for iSeries, Version 6.5.1

Note: Refer to the Administration Help for your version of Domino for information about installing and setting up Domino servers on OS/400. The help database is shipped with Lotus Domino and is also available in the Notes.net Documentation Library (http://www.notes.net/notesua.nsf?OpenDatabase).

To configure each instance of a Domino server on your iSeries server, perform these steps:

Define your Web server in the application server's configuration
1. Enter STRQSH on the CL command line to start Qshell.
2. At the Qshell prompt, run these commands:
```
cd /QIBM/ProdData/WebSphere/AppServer/V6/edition/bin 
configureOs400WebServerDefinition -webserver.name yourDominoServer 
  -webserver.type DOMINO -webserver.port port
```
  where edition is Base for WebSphere Application Server Express and WebSphere Application Server, and ND for WebSphere Application Server Network Deployment; yourDominoServer is the name of your Domino server; and port is the HTTP port for your Domino Server.
3. Generate the plugin-cfg.xml file. From the Qshell prompt, run this command:
```
GenPluginCfg -webserver.name yourDominoServer
```
Notes:
- Write down the location of the plugin-cfg.xml file. You need this information in the next step.
- To use a non-default WebSphere Application Server profile, specify the -profileName myWASProfile parameter when you run the configureOs400WebServerDefinition script and the GenPluginCfg script.
Update the Domino server's notes.ini file
1. Enter the Work with Domino Servers (WRKDOMSVR) command on the CL command line.
2. For the appropriate Domino server instance, specify option 13 (Edit NOTES.INI) to edit the server's notes.ini file.
3. Add this line to the end of the notes.ini file:
```
  WebSphereInit=plugin-file
```
  where plugin-file is the fully-qualified path of the plugin-cfg.xml file that you generated in the previous step.
4. Press F3 twice to save and exit the notes.ini file.
Start the Domino server
1. On the CL command line, type the following command:
```
strdomsvr
```
  Note: Your user profile must have *JOBCTL special authority.
2. Press F4 to have the system prompt you for the server name.
3. Type the server name in the field provided. If you are not sure of the name, press F4 to display a list of Domino servers on your iSeries server.
4. Press Enter. While the system is starting the Domino server, you see a message that indicates the server is starting. If the message appears for more than 1 or 2 minutes, the server may be waiting for you to enter a password. To determine if the server is waiting for a password, use the WRKDOMCSL command to start a server console session for the server. You can enter the password in this console session.
Enable the WebSphere DSAPI filter
1. From a Lotus Notes client connected to the appropriate Domino server, edit the Domino document, which can be found in the Domino server's Domino Directory. The name of the file is names.nsf. For example, open your browser to http://your.server.name:port/names.nsf, where your.server.name is the name of your iSeries server and port is . Enter your domino administrator username and password. For additional techniques used to edit the Domino document, please refer to the Domino documentation.
2. Within the server document, click the Internet Protocols tab and then click the HTTP tab.
3. Type this line in the DSAPI filter file names field:
```
  /QSYS.LIB/QWAS6.LIB/QSVTDOMINO.SRVPGM
```
  Note: Ensure that you do not have a space before or after this command or the filter fails.
4. Save and exit the Domino server document.
  Note: To use the Lotus Domino Web server with WebSphere Application Server, you do not need to change the Java servlet support field in the Domino server document.
Stop and restart the Domino server's HTTP task
1. Enter the Work with Domino Servers (WRKDOMSVR) command on the CL command line.
2. For your Domino server instance, specify option 8 (Work console) to select the Domino server's console.
3. From the Domino server's console, enter this command to stop the Domino server's HTTP task:
```
  tell http quit
```
4. From the Domino server's console, enter this command to start the Domino server's HTTP task:
```
  load http
```