Previous Topic: Web Agent Installation Guide for DominoNext Topic: Install and Configure an Agent for Domino on Windows


Preparation

This section contains the following topics:

Only Domino Server Procedures in this Guide

Hardware Requirements for CA SiteMinder® Agents

Preparation Roadmap for Domino Servers

How to Prepare for a Web Agent Installation on Domino Servers

Only Domino Server Procedures in this Guide

This guide only contains procedures for installing or configuring CA SiteMinder® agents on Domino servers.

To install or configure a CA SiteMinder® agent on any other type of web server or operating environment, see one of the following guides:

Hardware Requirements for CA SiteMinder® Agents

Computers hosting CA SiteMinder® agents require the following hardware:

Windows operating environment requirements

CA SiteMinder® agents operating on Windows operating environments require the following hardware:

UNIX operating environment requirements

CA SiteMinder® agents operating on UNIX operating environments require the following hardware:

Preparation Roadmap for Domino Servers

The following illustration describes how to prepare your web server before you install a CA SiteMinder® agent:

Flowchart describing how to prepare the operating environment of your Domino server before installing the SiteMinder Agent

How to Prepare for a Web Agent Installation on Domino Servers

To prepare for a CA SiteMinder® agent installation on a Domino server, use the following process:

  1. Locate the Platform Support Matrix. Verify that your web server supports the version of the CA SiteMinder® agent that you want to install.
  2. Verify that you have an account with one of the following types of privileges for your web server:
  3. Configure the appropriate additional that a CA SiteMinder® Agent requires by using one of the following lists:
  4. Verify that the Policy Server is installed and configured.
  5. Review the known issues section of the Web Agent Release Notes.

Locate the Platform Support Matrix

Use the Platform Support Matrix to verify that the operating environment and other required third-party components are supported.

Follow these steps:

  1. Log in to the CA Support site.
  2. Locate the Technical Support section.
  3. Enter CA SiteMinder® in the Product Finder field.

    The CA SiteMinder® product page appears.

  4. Click Product Status, CA SiteMinder® Family of Products Platform Support Matrices.

Note: You can download the latest JDK and JRE versions at the Oracle Developer Network.

Domino Server Preparations for UNIX Operating Environments

Domino servers running on UNIX operating environments require the following preparations before installing a CA SiteMinder® agent:

  1. Set the display variable.
  2. Verify that the appropriate Solaris patches have been installed for your operating environment.
Set the DISPLAY For CA SiteMinder® Agent Installations on UNIX

If you are installing the CA SiteMinder® Agent on a UNIX system from a remote terminal, such as a Telnet or Exceed terminal, be sure the DISPLAY variable is set for the local system. For example, if your machine is 111.11.1.12, set the variable as follows:

DISPLAY=111.11.1.12:0.0

export DISPLAY

Note: You can also install the agent using the console mode installation, which does not require the X window display mode.

Required Solaris Patches

Before installing a CA SiteMinder® Agent on a Solaris computer, install the following patches:

Solaris 9

Requires patch 111711-16.

Solaris 10

Requires patch 119963-08.

You can verify installed patch versions by logging in as the root user and executing the following command:

showrev -p | grep patch_id

To locate Solaris patches, go to the Oracle Solution Center.

Domino Server Preparations for Linux Operating Environments

Domino servers running on Linux operating environments require the following preparations before installing a CA SiteMinder® agent:

  1. Verify that the required patches are installed.
  2. Verify that the required libraries are installed.
Required Linux Patches

The following Linux patches are required:

For Web Agents running on 64-bit Linux systems
Required Linux Libraries

Certain library files are required for components operating on Linux operating environments. Failure to install the correct libraries can cause the following error:

java.lang.UnsatisfiedLinkError 

If you are installing, configuring, or upgrading a Linux version of this component, the following libraries are required on the host system:

Red Hat 5.x:

compat–gcc-34-c++-3.4.6-patch_version.I386

libstdc++-4.x.x-x.el5.i686.rpm

Red Hat 6.x:

libstdc++-4.x.x-x.el6.i686.rpm

Additionally, for Red Hat 6.x (64-bit):

Note: All the RPM packages that are required for 64-bit Red Hat 6.x are 32-bit packages.

libXau-1.0.5-1.el6.i686.rpm

libxcb-1.5-1.el6.i686.rpm

compat-db42-4.2.52-15.el6.i686.rpm

compat-db43-4.3.29-15.el6.i686.rpm

libX11-1.3-2.el6.i686.rpm

libXrender-0.9.5-1.el6.i686.rpm

libexpat.so.1 (provided by expat-2.0.1-11.el6_2.i686.rpm)

libfreetype.so.6 (provided by freetype-2.3.11-6.el6_2.9.i686.rpm)

libfontconfig.so.1 (provided by fontconfig-2.8.0-3.el6.i686.rpm)

libICE-1.0.6-1.el6.i686.rpm

libuuid-2.17.2-12.7.el6.i686.rpm

libSM-1.1.0-7.1.el6.i686.rpm

libXext-1.1-3.el6.i686.rpm

compat-libstdc++-33-3.2.3-69.el6.i686.rpm

compat-db-4.6.21-15.el6.i686.rpm

libXi-1.3-3.el6.i686.rpm

libXtst-1.0.99.2-3.el6.i686.rpm

libXft-2.1.13-4.1.el6.i686.rpm

libXt-1.0.7-1.el6.i686.rpm

libXp-1.0.0-15.1.el6.i686.rpm

Policy Server Requirements

Verify that your Policy Server meets the following requirements:

Note: For more information, see the Policy Server documentation.

To install and configure a CA SiteMinder® agent, a Policy Server requires at least the following items:

CA SiteMinder® Agents for Domino also require values for the following parameters:

DominoDefaultUser

Specifies the name by which the Domino Web Agent identifies the users that CA SiteMinder® has previously authenticated against another directory to the Domino server.

Important! This parameter must be encrypted if it is stored in a local configuration file. Use the encryptkey tool to encrypt this parameter. Do not change it by editing the local configuration file directly.

Default: No default

DominoSuperUser

Identifies a user who has access to all resources on the Domino server. Helps ensure that all users successfully logged in to CA SiteMinder® are also logged in to the Domino server as the Domino SuperUser.

This value can be encrypted.

This parameter affects the following parameters:

Default: No default