CommServe Failover Configuration Parameters

The following table lists the commonly used configurable parameters in the cvfailover.cfg file.

Parameter Description
postStartScript Specifies the path to the script that you run after starting the failover operation. Example: c:\\test\\script.bat
backupPeriodMinutes Specifies the time interval frequency for database replication.
maxFailedStarts Specifies the maximum number of attempts allowed to start services on the active node after a failover. If the number of attempts exceeded this value, automatic failover is disabled and manual intervention is required.
preStopScript Specifies the path to the script that is run before the failover operation stops. Example: c:\\test\\script.bat
reconnectTimeoutMinutes Specifies the time interval before reconnecting the active node.
postStopScript Specifies the path to the script that is run after the failover operation stops. Example: c:\\test\\script.bat
customTtlTimeout Specifies the time interval before the passive node is reconnected to the active node. After the time limit expires, a notification email is sent to the specified email addresses and the failover operation starts.
servicesDownTimeoutMinutes Specifies the time limit before the services are stopped on the passive node.
preStartScript Specifies the path to the script to run before starting the failover operation. Example: c:\\test\\script.bat
servicesScanPeriodMinutes Specifies the time interval before verifying that services are running on the active node.
alertDebug Enter 1 to include additional information in the alert emails for troubleshooting purposes.

Failover Options

The cvfailover command also supports the following configuration options.

cvfailover.cmd [newActiveNodeId] [/h] [/f] [/m] [/a]

 

Option Description
newActiveNodeID Initiates the manual failover to the specified ID. Enter 1 for production or 2 for standby CommServe host.
/h Displays help
/f Resets an in-progress failover if it appears to be hung.
/m Enables manual failover of the CommServe host.
/a Enables automatic failover of the CommServe host.

When using automatic failover mode, failover operations are triggered for non-disaster scenarios, such as process crashes or service restarts. Therefore, we recommend that you set the manual failover mode and failover the CommServe manually in the event of a disaster.

Also, if you are using automatic failover mode, switch to manual mode before performing any maintenance tasks, such as installing updates on the CommServe or on the witness server hosts.

/DisableLogShipping Disables log shipping operations.
/EnableLogShipping Enables log shipping operations from active node to the passive node.