Skip to main content

 
IBM Power Systems software  >  IBM i  > Software  > 

Lotus products for IBM i (i5/OS)

  
Overview Products IBM i integration Developers Support

WebSphere can be configured to use the Domino HTTP server using the Domino Web Server API (DSAPI).  To implement this scenario , you should first update the Domino Server Document to work with WebSphere Application Server.  And then , you should configure the virtual host on the WebSphere Application Server side.

Below instructions assumes that you have already installed WebSphere Application Server with one or more application servers configured and have already configured a Domino Server with HTTP enabled.


To update the Domino Server Document from the Lotus Notes Admin client , use these steps:
  1. From a Lotus Notes Admin client connected to the appropriate Domino server , edit the Domino document , found in the Domino server’s Domino Directory (names.nsf).
  2. Within the server document , click the Internet Protocols tab and then click the HTTP tab.
  3. Enter the following in the DSAPI filter file names field:

    /QSYS.LIB/QWAS6.LIB/LIBDOMINOH.SRVPGM

  4. Save and exit the Domino Server document.

Configure the virtual host on the WebSphere Application Server side


A virtual host is a configuration entity that allows WebSphere Application Server to treat multiple host machines or port numbers as a single logical host (virtual host) for configuration purposes.  Each virtual host can be associated with multiple aliases.  Each alias is a particular host name and port number.  By combining multiple host machines into a single virtual host or by assigning host machines to different virtual hosts , you can separate and control which WebSphere Application Server resources are available for client requests.

To update the Host Aliases table for the default_host virtual host from the administrative console , use these steps:
  1. Expand  Environment > Manage Virtual Hosts in the left frame of the administrative console.
  2. Click  default_host in the right frame.
  3. Click  Host Aliases .  The settings for default_host are displayed.
  4. In the  Host Name list , click on the asterisk in the row that has a Port of 80.

    Note: The host names are set to “*” when you install WebSphere Application Server.

  5. Specify the correct port number for your HTTP server in the Port field.
  6. Click  OK and click  Save to save your configuration.
  7. After you specify a new port number , you must regenerate the plug-in configuration.  In the left pane , expand the  Environment list item and click  Update Web Server Plugin .  When the right frame appears with a prompt , click  OK .

Update the Domino Server’s notes.ini file to work with WebSphere Application Server


  1. Enter the Work with Domino Servers (WRKDOMSVR) command on the i5/OS command line.
  2. For the Domino Server , specify option 13 (Edit NOTES.INI) to edit the server’s notes.ini file.
  3. Add the following line to the end of the notes.ini file:

    WebSphereInit=/qibm/userdata/websphere/appserver/v6/base/profiles/profileName/
    config/cells/plugin-cfg.xml

    or copy the plugin-cfg.xml to the domino server directory

    WebSphereInit=/Domino/plugin-cfg.xml

    Note: Change the line to reference the directory of the application server profile that you are using.

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

Restart the Domino Server and WebSphere Application Server to apply the changes


Restart the Domino server

  1. Enter the Work with Domino Servers (WRKDOMSVR) command on the i5/OS command line.
  2. For your Domino server instance , specify option 6 (end server).
  3. Then start your Domino server using option 1 after it has completely stopped.

Restart the WebSphere Application Server

In the Qshell environment:
  1. cd /qibm/userdata/websphere/appserver/v6/base/profiles/profileName/bin
  2. ./stopServer -username username -password password
  3. ./startServer

Once that everything has restarted , you can use your new alias added to access WebSphere resources , it means that you are using the Domino HTTP Server.

Back to top