What is failover?

Failover is the process of moving databases, metadata, and user connections from a failed or shut down primary companion to a secondary companion so that users can still access data. There are three sequential steps for failover:

  1. System failover – The primary node fails over to the secondary node.

  2. Companion failover – The primary companion fails over to the secondary node.

  3. Connection failover – Connection with the failover property (for example, isql -Q) fails over to the secondary companion.

    Steps two and three are described in detail below. See your high availability subsystem documentation for a description of step one.

During failover, the secondary Adaptive Server detects the primary Adaptive Server’s failure through the operating system’s high availability system and initiates the failover mechanism, which:

  1. Performs a disk reinit to remap the master device path name to its local drive. disk reinit does not disturb the contents of the master device.

  2. Mounts the master database, recovers, and brings it online.

  3. Maps each of the devices listed in the primary companion’s sysdevices to the secondary companion’s sysdevices and performs a disk reinit on the disks.

  4. Mounts all the primary companion databases on the secondary companion. The secondary companion brings all databases online, after performing recovery from the logs. tempdb and model are not mounted. Proxy databases are mounted with the name comp_dbid_dbname.

    Each database the secondary companion mounts has the suffix _companion appended to its name (for example, the master database becomes master_companion, sybsystemprocs becomes sybsystemprocs_companion, and so on). The secondary Adaptive Server adds this suffix to ensure the unique identity of the databases currently on its system. The user databases do not have the _companion suffix appended to their name; they are guaranteed to be unique.

User connections with the failover property (for example, isql -Q) and clients using the CS_FAILOVER property are retained and reestablished on the secondary companion. Uncommitted transactions must be resubmitted.

Figure 2-1 describes the failover process:

Figure 2-1: The failover process

Once the secondary companion receives the failover message from the high availability system, no new transactions are started on the clients connected to the primary companion. Any transactions that are not complete at the time of failover are rolled back. After failover is complete, clients or users must resubmit rolled-back transactions.