This task describes how to change configuration settings
for Lotus® Domino®.
Before you begin
If you
are running Domino Web Server
on IBM® i, use the IBM Web Administration for IBM i GUI.
Other
procedures in Editing web server configuration files describe
configuring other supported web servers.
About this task
Use the following procedure to enable the web server plug-in
to work with Lotus Domino. Ensure that you install
the plug-in as root. Domino can
only be installed as root, and the configuration files belong to root.
Best practice: If you install the plug-in as local and the WebSphere® Application Server
as nonroot, then web server management on WebSphere Application Server, such as generation,
propagation, deletion of web server definitions and more, is unavailable
because the
plugin-cfg.xml file must be installed
as root.
bprac
Procedure
- Start the Domino server.
- Access the names.nsf file using your
web browser (for example, http://tarheels2.raleigh.ibm.com/names.nsf).
The browser prompts you for a password.
- Give the administrator name and password.
- Click on the left side of the page.
- Click on the left side of the page.
- Click on the left side of the page.
- Click the server that you intend to have work with the
product
- Click on the top-left of the center window.
- Click in the middle of the page.
- Add the path to the Domino plug-in
under the DSAPI Section in the middle-right of the page.
The DSAPI filter location on IBM i is /QSYS.LIB/QWAS85.LIB/LIBDOMINOH.SRVPGM.
The plug-in is installed in the bin directory
of the Web Server Plug-ins.
If specifications for filter files
for the Domino Server Application
Programming Interface (DSAPI) exist, use a space to delimit the web
server plug-in for WebSphere Application
Server.
- Click in the upper left of the center window.
- Define the location of the plugin-cfg.xml configuration
file.
The location varies depending on how you have
configured your system. If the web server and the application server
are on separate machines, you have a remote installation.
If
the two servers are on the same machine, you have a local installation.
In the following examples,
webserver1 is the web server definition name.
Setting the path to the plug-in configuration
fileEdit your notes.ini file.
- From a CL command prompt, enter the Work with Domino Servers (WRKDOMSVR)
command.
- Type 13 next to the applicable Domino server, then press .
- Add or edit the WebSphereInit property. (See the following table.)
To
add a new line, type "i" next to the wanted
insertion line, then press .
- Press F3 to save and exit.
Table 1. Editing
the notes.ini file . Use this table when editing your
notes.ini file.If the type of installation is: |
Then use this command to set
the environment variable: |
Remote |
WebSpherePluginConfig profile_root/config/webserver1/plugin-cfg.xml |
Local standalone |
WebSpherePluginConfig profile_root/config/cells/my_cell/nodes/webserver1_node/servers/webserver1/plugin-cfg.xml |
The
setupPluginCfg.sh file is
created in two places:
- The plugins_root/bin directory
- The lotus_root/notesdata directory
You can run the script from either location to set the
WAS_PLUGIN_CONFIG_FILE environment variable. However, if you are re-configuring
the web server, you might want to set the path yourself by setting
the value of the environment variable with a path from the preceding
table.
- If you are configuring a 64-bit version of the Domino Version 7 or higher web
server, modify the notes.ini file to point to the plugin_root\bin\64bit/domino5.dll file.
- Restart the Domino server. When the server starts, information like the following example
is displayed:
01/21/2005 01:21:51 PM JVM: Java virtual machine initialized
WebSphere Application Server DSAPI filter loaded
01/21/2005 01:21:52 PM HTTP Web Server started
Results
This procedure results in reconfiguring Version 6.x of Lotus Domino.
What to do next
After configuring a web server, you can install applications
on it. See the Applications section of the information center for
more information.
For more information about
configuring Lotus Domino to work with WebSphere Application Server, search the Lotus Support Services website.
Enter the search term WebSphere in the keyword
search field.
For more information, see the
following related technote:
Tip: To unconfigure a web server,
reverse the manual steps and remove what was manually added in this
procedure.