2.2 Copying ndsrep and notes.jar to the Required Locations

After the Lotus Notes driver files are installed, perform the following steps:

  1. Manually copy the ndsrep and dsrepcfg.ntf files from the Windows or Linux ISO to the Domino server:

    Filename

    Copy from

    Copy to

    ndsrep

    The ISO location:

    32-Bit

    • \setup\utilities\ndsrep\x86\windows

    • \setup\utilities\ndsrep\x86\linux

    • \setup\utilities\ndsrep\x86\AIX

    • \setup\utilities\ndsrep\x86\Solaris

    64-Bit

    • \setup\utilities\ndsrep\x64\linux

    • \setup\utilities\ndsrep\x64\windows

    • \setup\utilities\ndsrep\x64\AIX

    NOTE:Identity Manager server installation is not supported on AIX and Solaris platforms. ndsrep is bundled in the product ISO so that you can copy the file to the Domino server installation folder on these operating systems. For information about operating systems and versions supported for the Domino server, see the IBM documentation web site. For information about Lotus Notes versions supported by the driver, see Supported Lotus Notes Versions.

    The Domino server executable folder:

    • Windows: \Lotus\Domino

    • Linux/Solaris/AIX: /local/notesdata

    dsrepcfg.ntf

    The ISO location:

    setup\utilities\ndsrep\dsrepcfg.ntf

    The Domino server data folder:

    • Windows: \Lotus\Domino\Data

    • Linux/Solaris/AIX:

      /local/notesdata

    For information about ndsrep, see Subscriber Channel.

  2. (Conditional) Manually copy the Notes.jar file from the Lotus Notes Client installation folder (\Lotus..\jvm\lib\ext) to the Remote Loader folder (\Novell\RemoteLoader\lib) on a Windows Client workstation.

    This step is not applicable if the Notes driver is running on a Linux Client workstation.

  3. If the Domino server requires databases to be signed, use a Notes Client or Domino Administrator to sign dsrepcfg.ntf with the server ID of your Domino server.

  4. Ensure that the Notes Client library .dll directory (for example, c:\lotus\notes) is in the Windows system path, and reboot the system to make sure this step becomes effective.

    If this directory is not in the Windows system path, the JVM might have difficulty locating the Notes Client libraries required by Notes.jar, such as nlsxbe.dll.

  5. Ensure that the necessary user.id and cert.id files are available to the Notes Client and NotesDriverShim.jar so that the Notes driver can properly authenticate to the Domino server and register new Notes users.

If you are running the Notes Client on Linux, you must perform the initial client configuration after installing the Notes Client as a non-root user. Use the same non-root user to start and use the driver.

  1. To start the driver from the non-root user's home directory, type the following command:

    /opt/novell/eDirectory/lib/dirxml/rules/notes/rdxml.startnotes

  2. To stop the driver from the non-root user's home directory, type the following command:

    /opt/novell/eDirectory/lib/dirxml/rules/notes/rdxml.stoptnotes

    The sample scripts and the sample configuration file are provided to demonstrate how to launch the driver. You can start the Remote Loader for the driver using rdxml.startnotes, and stop the Remote Loader for the driver using rdxml.stopnotes.For more information, see Table 2-1.

    The sample scripts work in different situations. If they do not work in your environment, you might need to edit them appropriately. The sample scripts produce a Remote Loader trace log for the driver that can be used for troubleshooting.

  3. Modify the scripts and configuration file to fit to your environment, as described in Table 2-1.

  4. Make sure that the three scripts noted in Step 1and Step 2 have file access for execution (for example, rwxr-xr-x).

  5. Make sure that the /local/notesdata/ directory is not present on the client workstation.

For troubleshooting tips, see Troubleshooting Installation Problems.

Table 2-1 Sample Scripts and Sample Configuration

Filename

Description

rdxml.startnotes

This script calls the findDomino script, which sets up appropriate operating system environment variables for the Notes driver. Then the rdxml.startnotes script launches the Remote Loader with the Notes driver parameters specified in the rdxml.confignotes file.

If the location where the scripts are placed is not in a current search path, you might need to do one of the following:

  • Modify rdxml.startnotes to include a specific path to the findDomino script.

  • Create a symbolic link for findDomino in /usr/bin.

rdxml.stopnotes

This script stops the Remote Loader that is running the Notes driver.

findDomino

This script is called from the rdxml.startnotes script. When you launch rdxml.startnotes, this script sets up operating system environment variables that indicate the location of a Linux type of installation of the Notes Client.

rdxml.confignotes (or wherever your configuration is stored)

This configuration is referenced by rdxml.startnotes and rdxml.stopnotes scripts.

You might need to modify the rdxml.startnotes script to fit your environment. For example, if you change the name of the configuration file to a name other than rdxml.confignotes, you must revise the last line in the script.

You might need to change the configuration ports that are referenced in this file.