You must update the Lotus® Domino® Web
server configuration before you can use the web server with WebSphere® Application Server.
About this task
Configure each instance of a Domino server
on your IBM i server.
Procedure
- Define your web server in the application server configuration.
- Start Qshell.
On the CL command line,
enter STRQSH.
- Move to the directory where the configuration resides.
At the Qshell prompt, run the command:
cd app_server_root/bin
- Specify a name and a port for your 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 your Domino server. The port variable
is the HTTP port for your Domino Server.
To use a
non-default WebSphere Application Server profile, specify
the -profileName myProfile parameter
when you run the configureOs400WebserverDefinition script.
- Generate the plugin-cfg.xml file.
From the Qshell prompt, run this command:
GenPluginCfg -webserver.name yourDominoServer
If
you specified a profile name in the previous step, specify the -profileName myProfile parameter
when you run the GenPluginCfg script.
- Write down the location of the plugin-cfg.xml file.
You need this information in the next step.
- Update the Domino server notes.ini file.
- Enter the Work with Domino Servers
(WRKDOMSVR) command on the CL command line.
- For the appropriate Domino server
instance, specify option 13 (Edit NOTES.INI) to edit the server notes.ini file.
- 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 you generated in the previous step.
- Press F3 twice to save and exit
the notes.ini file
- Start the Domino server.
- Verify that your user profile has *JOBCTL special authority.
- On the CL command line, enter the strdomsvr command.
- Press F4 to have the system prompt
you for the server name.
- 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 IBM i server.
- 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. You can enter the password
in this console session.
- Enable the WebSphere Application Server
DSAPI filter.
- 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 your
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.
- Within the server document, select the Internet
Protocols tab and then the HTTP tab.
- For DSAPI filter file names,
type:
/QSYS.LIB/product_library.LIB/LIBDOMINO.SRVPGM
Verify
that you do not have a space before or after this command or the filter
fails.
- Save and exit the Domino server
document.
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
HTTP task.
- Enter the Work with Domino Servers
(WRKDOMSVR) command on the CL command line.
- For your Domino server instance, specify
option 8 (Work console) to select the Domino server
console.
- From the Domino server console, enter
the following command to stop the Domino server
HTTP task.
- From the Domino server console, enter
the following command to start the Domino server
HTTP task.
What to do next
You have completed step 3 of 5.
Go to Starting WebSphere Application Server on IBM i to continue the installation.