Install the DB2 Access server on the DB2 server that hosts IBM® Lotus® Notes® data. This can be the same computer on which Domino is installed for a local configuration, or it may be a different computer in a remote configuration. The DB2 Access server enforces Domino database security, such as ACLs and reader lists for DB2-enabled data. If the DB2 Access server is not installed properly, the DB2 Designer functions will not be available and you will not be able to access DB2 data.

Install and enable the DB2 Access server to allow DB2 to access Domino data. The DB2 Access server requires a server ID. Copy the server ID file that you are using for the DB2 Access server to the server on which you are installing the DB2 Access server. If you have not completed the procedure "Creating a server ID for the DB2 Access server," do so before installing the DB2 Access server on the DB2 server.

Note The DB2 Access server cannot cross-certify Domino servers from domains other than its own domain.

When you install the DB2 Access server, a DB2 Access Server Connection document is created when the Domino server is started. This DB2 Access Server Connection document connects the DB2 Access server and a Domino server that you designate using the Domino Administrator. The DB2 Access Server Connection document contains a configuration-only Domino Directory.

We recommend that you perform the DB2 Access server installation prior to running the DB2 Server Enablement Tool from the Domino Administrator. If you perform the DB2 Access server installation after running the DB2 Server Enablement Tool, you must complete Step 3 of this procedure.

After you install the DB2 Access server, Domino changes the name of the server ID file to USER.ID and stores the file in the data directory for the DB2 Access server.

Note If your configuration includes the DB2 Access Server, TCPIP is the only supported port setting. Any other configured port settings are disabled.

For instructions about creating the new server and server ID, see the topic Creating a server ID for the DB2 Access server.

Performing the DB2 Access server install

On Microsoft® Windows® systems, install the DB2 Access Server to the DB2 function directory, for example, C:\program files\ibm\sqllib\function. There is an alternative that is not recommended. The alternative is to install the DB2 Access server to any location, and then enter the full path for that location in the Path environment variable.

Note If you have un-installed the DB2 Access server and you are installing it to a different directory, you must restart the DB2 server to allow the new path for the DB2 Access server to take effect.

Prerequisites

1. Gather the following information before running the setup program. While the InstallShield Wizard is running, you will be prompted to enter:

• The location where the local DB2 server is installed. The subdirectory is always SQLLIB, but you need the complete path.
• The name of the DB2 Access server ID file and the location where the server ID file is stored. Enter the complete server ID path with filename.
• For IBM® AIX® configurations, you must be logged on as the root user to perform the installation. The root user must be a member of the group SYSADMIN_GROUP.
• For AIX configuration, you need to know the DB2 Instance name.
• For AIX configurations, you need a temporary directory of approximately 150 megabytes.

Procedure

1. Run the Domino DB2 Access setup file. The InstallShield Wizard for IBM DB2 Access for Lotus Domino runs.

2. If you are using Microsoft Windows, skip this step. On AIX only, review the log file, DB2SETSTDOUT.LOG, to determine whether the install was successful. The log file is in the directory that contains the DB2 Access server files. For example, in AIX the log file is in this directory: /opt/IBM/DALD/DB2SETSTDOUT.LOG.

3. When the InstallShield Wizard completes the installation, do one of these:

• If you installed the DB2 Access server prior to running the DB2 Server Enablement tool, you are done installing the DB2 Access server. You may now proceed to run the DB2 Server Enablement Tool. After running the DB2 Server Enablement tool, run the Enable DB2 Access tool.
  
  OR
• If you installed the DB2 Access server after running the DB2 Server Enablement tool, run the Enable DB2 Access tool.

For information about the information that is returned by the DB2 INFO command, see the topic DB2 INFO.

If you are using a Microsoft Windows® platform, return to the roadmap topic Setting up the DB2 Access server.

If you are using an IBM AIX or Linux® platform, return to the roadmap topic Installing the DB2 Access server.

See also

Installation and setup procedures
Understanding Domino and DB2
Installing and Setting up DB2 on Microsoft Windows
Administering the DB2 Access server

Glossary