This feature controls how the connector handles existing connections when a manual switch is invoked.
When a graceful switch is invoked via cctrl, by default the Connector will wait for five (5) seconds to allow in-flight activities to complete before forcibly disconnecting all active connections from the application side, no matter what type of query was in use.
If connections still exist after the timeout interval, they are forced closed, and the application will get back an error.
This setting ONLY applies to a manual switch. During a failover, there is no wait and all connections are force-closed immediately.
This timeout is adjusted via the tpm option
--connector-disconnect-timeout
.
For example, to change the delay to 10 seconds:
Click the link below to switch examples between Staging and INI methods...
shell>tpm query staging
tungsten@db1:/opt/continuent/software/tungsten-clustering-7.0.3-141 shell>echo The staging USER is `tpm query staging| cut -d: -f1 | cut -d@ -f1`
The staging USER is tungsten shell>echo The staging HOST is `tpm query staging| cut -d: -f1 | cut -d@ -f2`
The staging HOST is db1 shell>echo The staging DIRECTORY is `tpm query staging| cut -d: -f2`
The staging DIRECTORY is /opt/continuent/software/tungsten-clustering-7.0.3-141 shell>ssh {STAGING_USER}@{STAGING_HOST}
shell>cd {STAGING_DIRECTORY}
shell> ./tools/tpm configure alpha \
--connector-disconnect-timeout=10
Run the tpm command to update the software with the Staging-based configuration:
shell> ./tools/tpm update
For information about making updates when using a Staging-method deployment, please see Section 10.3.7, “Configuration Changes from a Staging Directory”.
shell> vi /etc/tungsten/tungsten.ini
[alpha]
...
connector-disconnect-timeout=10
Run the tpm command to update the software with the INI-based configuration:
shell>tpm query staging
tungsten@db1:/opt/continuent/software/tungsten-clustering-7.0.3-141 shell>echo The staging DIRECTORY is `tpm query staging| cut -d: -f2`
The staging DIRECTORY is /opt/continuent/software/tungsten-clustering-7.0.3-141 shell>cd {STAGING_DIRECTORY}
shell>./tools/tpm update
For information about making updates when using an INI file, please see Section 10.4.4, “Configuration Changes with an INI file”.
Configuration group alpha
The description of each of the options is shown below; click the icon to hide this detail:
--connector-disconnect-timeout=10
connector-disconnect-timeout=10
Time (in seconds) to wait for active connection to disconnect before forcing them closed [default: 5]
If you increase this value, you delay the manual switch! ONLY change this if you accept the fact that the manual switch process will last at least as long as this setting in seconds.
Do not set this value to zero (0) or there will be no attempt to
disconnect at all. If you wish to disable the wait entirely, set
--property=waitForDisconnect=false
in
your configuration on the connectors and run tpm
update.
Updating these values require a connector restart (via tpm update) for the changes to be recognized.
This value is reflected in the waitForDisconnectTimeout
setting located in cluster-home/conf/router.properties
.