skip to main content
Using the ODBC Client : Specifying ODBC Connection Attributes : Alternate Servers
 

Alternate Servers

Attribute

AlternateServers (ASRV)

Configuration

Client/server configuration only

Description

A list of alternate OpenAccess SDK servers to which the ODBC Client will try to connect if the primary OpenAccess SDK server is unavailable. Specifying a value for this attribute enables connection failover for the driver.
The value must be in the form of a string that defines the physical location of each alternate server. The Host and Port values are required for each alternate server entry. All of the other required connection information for each alternate server is the same as what is defined for the primary server connection. Currently, the only optional connection attribute that can be set for the alternate server is ServerDataSource.

Valid Values

string
where string is a list of alternate OpenAccess SDK servers.
The string has the format:
(Host=servername1:Port=port1 [:ServerDataSource=datasourcename],...)
For example, the following AlternateServers value defines three alternate OpenAccess SDK servers for connection failover:
AlternateServers=(Host=AccountingSLServer: Port=13999,Host=AccountingAltServer:Port=13998:ServerDataSource=Backup,Host=AccountingAlt2:Port=13997)
Important: If you specify an LDAP server in the Host attribute, the alternate servers must be LDAP servers. For example, the following AlternateServers value defines three alternate LDAP servers for connection failover:
AlternateServers=(Host=ld1.foo.com:Port=389,Host=ld2.foo.com:Port=389,Host=ld3.foo.com:Port=389)
See Configuring Connection Failover for a discussion of connection failover.

Default

None

GUI Tab

Failover tab