Lotus Domino file locations and troubleshooting tips

Lotus Domino Server is one of the Web servers that WebSphere Application Server supports. We must be aware of configuration file locations and other useful tips related to using Lotus Domino.

Lotus Domino Server file locations

Lotus Domino server file locations are:

• (AIX)
  • /usr/lotus/notes/50091/ibmpow/Notes.jar
  • /usr/notesdata/names.nsf

• (Solaris)
  • /opt/lotus/notes/5080/sunspa/Notes.jar
  • /opt/notesdata/names.nsf

• (Windows)
  • c:\lotus\notes\Notes.jar
  • c:\lotus\notes\data\names.nsf

• (iSeries)

  /QIBM/ProdData/LOTUS/NOTES/Notes.jar data-directory/names.nsf where data-directory is the data directory of our Domino server.

  Perform the following steps to determine the directory name:

  1. From a control language (CL) command prompt, enter the Work with Domino Server (WRKDOMSVR) command.

  2. Type 13 next to the applicable server, then press Enter.

  3. The value of the property named Directory is the name of the data directory of our Domino Server.

(iSeries) The Domino Server plug-in might fail to load on an IBM i system

Error messages in the Domino console can indicate more detailed error messages in the Notes spool files. For example, if we see the following error message on your Domino console, perform the following steps:

Sample error message:

01/05/2006 13:28:56 HTTP Server:
Failed to load DSAPI module 
/QSYS.LIB/QWAS9.LIB/LIBDOMINOH.SRVPGM

1. From a CL command prompt, enter the Work with Spool Files (WRKSPLF) command:

   WRKSPLF QNOTES
   

2. Use option 5 to open the applicable spool file for our notes server.

   We might have to stop your Domino server to view the spool file.

3. Inspect the output to find applicable error messages. For example, suppose that the following entry is in the log:

   ERROR: lib_sxp: sxpCreate: Can't open 
     '/QIBM/UserData/webas5/base/rb5025test/config
     /cells/plugin-cfg.xml', OS Err: 3401  
   ERROR: ws_config_parser: configParserParse: 
     Failed to create the sxpParser object for 
     profile_root/config/plugin-cfg.xml  
   ERROR: ws_common: websphereUpdateConfig:
     Failed parsing plugin config file:  
   ERROR: profile_root/config/plugin-cfg.xml
   ERROR: The above file may not have correct authorities.  
   ERROR: Do WRKLNK, Opt 9 on above file.  ERROR: Check that QTMHHTTP and QNOTES have correct authorities:  
   ERROR: QTMHHTTP *RX  ERROR: QNOTES *RX  ERROR: ws_common: websphereInit: 
     Failed to load the config file  
   ERROR: domino5_plugin: FilterInit: 
     Failed to initialize WebSphere 
   

(Solaris)

The Domino Server plug-in might fail to configure on a Solaris platform

If this occurs during installation, a dsapi_stderr.txt file is created in the logs directory and we get the following error messages:

lotus.notes.NotesException: Could not load dll for system name SUNOS
       at lotus.notes.NotesThread.load(NotesThread.java:210)
       at lotus.notes.NotesThread.<clinit>(NotesThread.java:24)
java.lang.UnsatisfiedLinkError: NnotesInitThread
       at lotus.notes.NotesThread.NnotesInitThread(Native Method)
       at lotus.notes.NotesThread.initThread(NotesThread.java:99)
       at lotus.notes.NotesThread.run(NotesThread.java:133)

We can configure the WAS or Domino Server plug-in manually using the Domino Server Web Administration tool. Use the following procedures:

1. Start the Domino Server.
2. Enter the URL for the Domino Server Web Administration site using a browser. For example, http://host_name/names.nsf. Enter the administrator user name and password.
3. Double-click Server-Servers.
4. Double-click WebServer to configure.
5. Double-click Edit Server.
6. Double-click Internet Protocol.

7. Add the WAS DSAPI plug-in to the DSAPI field. For example, app_server_root/bin/libdomino5_http.so

   If there are already DSAPI filter files specified, use a space to delimit the WAS plug-in file.

8. Double-click Save and Close.

9. Restart the Domino Server.

(UNIX)

Avoiding a DSAPI filter-loading error when the Lotus Domino Server starts

On operating systems such as AIX or Linux, if the Lotus Domino Web Server starts using a nonroot user, we are likely to generate a DSAPI filter-loading error when the Lotus Domino Server starts:

Error loading DSAPI filter.

Filter not loaded: app_server_root/bin/libdomino6_http.a

Manually change the WAS bin directory permissions from 750 to 755 to run Lotus Domino Server as a nonroot user and not generate the error.

We must also change permissions on the WAS logs directory to 777 to allow Lotus Domino Server to write to the log. However, this change poses a security risk.

If the Lotus Domino Server is started as root, the problem does not occur.

Configure Lotus Domino