Configuration Guide › Relational Database Management › Connection to the User Directory › Description of a Database Connection › Data Source Name (DSN)

Data Source Name (DSN)

The DSN element in the directory.xml file has one parameter—the name of the ODBC data source that CA Identity Manager uses to connect to the database. The value of the name parameter must match the name of an existing data source.

Note: This element applies only when CA Identity Manager integrates with SiteMinder. If CA Identity Manager does not integrate with SiteMinder, this element is ignored.

If the value of the name parameter is @SmDirDSN, you do not have to specify a DSN name in the directory.xml file. CA Identity Manager will prompt you to supply the DSN name when you import the directory.xml file.

To configure failover, define multiple DSN elements. If the primary data source fails to respond to a request, the next data source defined responds to the request.

For example, suppose you configure the following:

<DSN name="DSN1">
<DSN name="DSN2">

CA Identity Manager uses the data source DSN1 to connect to the database. If there is a problem with DSN1, CA Identity Manager will try to connect to the database using DSN2.

Note: The credentials you specify in the Credentials element must apply to all the DSNs that you define.