(iSeries)

Configure Lotus Domino HTTP Server on IBM i

We must update the Lotus Domino Web server configuration before we can use the web server with WebSphere Application Server.

See the WAS detailed system requirements page for information on the support levels of Lotus Domino Web Server.

Refer to the Administration Help for our version of Domino for information about installing and setting up Domino servers on IBM i.

The help database is shipped with Lotus Domino and is also available in the Notes.net Documentation Library.

Configure each instance of a Domino server on the IBM i server.

Tasks

1. Define your web server in the application server configuration.

   1. Start Qshell.

      On the CL command line, enter STRQSH.

   2. Move to the directory where the configuration resides.

      At the Qshell prompt, run the command:

      cd app_server_root/bin
      

   3. Specify a name and a port for our Domino Server.

      At the Qshell prompt, run the command:

      configureOs400WebServerDefinition -webserver.name yourDominoServer \
                                        -webserver.type DOMINO \
                                        -webserver.port
      port
      

      The yourDominoServer variable is the name of our Domino server. The port variable is the HTTP port for our Domino Server.

      To use a non-default WAS profile, specify the -profileName myProfile parameter when running the configureOs400WebserverDefinition script.

   4. Generate the plugin-cfg.xml file. From the Qshell prompt, run this command:

      GenPluginCfg -webserver.name yourDominoServer
      

      If we specified a profile name in the previous step, specify the -profileName myProfile parameter when running the GenPluginCfg script.

   5. Write down the location of the plugin-cfg.xml file. You need this information in the next step.

2. Update the Domino server 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 notes.ini file.

   3. Add this line to the end of the notes.ini file:

      WebSphereInit=plugin-file
      

      The plugin-file variable is the fully-qualified path of the plugin-cfg.xml file that we generated in the previous step.

   4. Press F3 twice to save and exit the notes.ini file

3. Start the Domino server.

   1. Verify that your user profile has *JOBCTL special authority.

   2. On the CL command line, enter the strdomsvr command.
   3. Press F4 to have the system prompt you for the server name.

   4. Type the server name in the field provided.

      If we are not sure of the name, press F4 to display a list of Domino servers on the IBM i server.

   5. Press Enter.

   While the system is starting the Domino server, you see a message indicating that the server is starting. If the message appears for more than 1 or 2 minutes, the server might 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. We can enter the password in this console session.

4. Enable the WAS DSAPI filter.

   1. From a Lotus Notes client connected to the appropriate Domino server, edit the Domino document. The document is in the Domino server Domino Directory. The name of the file is names.nsf. For example, open your browser to http://your.server.name:port/names.nsf, where the your.server.name variable is the name of our IBM i server and the port variable is your web server port.

      Enter your Domino administrator user name and password. For additional techniques used to edit the Domino document, refer to the Domino documentation.

   2. Within the server document, select the Internet Protocols tab and then the HTTP tab.

   3. For DSAPI filter file names, type:

      /QSYS.LIB/product_library.LIB/LIBDOMINO.SRVPGM
      

      Verify that we do not have a space before or after this command or the filter fails.

   4. Save and exit the Domino server document.

      To use the Lotus Domino Web server with WAS, we do not need to change the Java servlet support field in the Domino server document.

5. Stop and restart the Domino server 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 console.

   3. From the Domino server console, enter to stop the Domino server HTTP task.

      tell http quit
      

   4. From the Domino server console, enter to start the Domino server HTTP task.

      load http
      

What to do next

We have completed step 3 of 5.

Go to Starting WAS on IBM i to continue the installation.

Configure an HTTP server instance on IBM i