VCS environment variables

Table: VCS environment variables lists VCS environment variables.

See Environment variables to start and stop VCS modules.

See Environment variables associated with the coordination point server.

Table: VCS environment variables

Environment Variable

Definition and Default Value

PERL5LIB

Root directory for Perl executables. (applicable only for Windows)

Default: Install Drive:\Program Files\VERITAS\cluster server\lib\perl5.

VCS_CONF

Root directory for VCS configuration files.

Default: /etc/VRTSvcs

Note:

If this variable is added or modified, you must reboot the system to apply the changes.

VCS_DEBUG_LOG_TAGS

Enables debug logs for the VCS engine, VCS agents, and HA commands. You must set VCS_DEBUG_LOG_TAGS before you start HAD or before you execute HA commands.

See Enabling debug logs for the VCS engine.

You can also export the variable from the /opt/VRTSvcs/bin/vcsenv file.

VCS_DOMAIN

The Security domain to which the VCS users belong.

Symantec Product Authentication Service uses this environment variable to authenticate VCS users on a remote host.

Default: Fully qualified host name of the remote host as defined in the VCS_HOST environment variable or in the .vcshost file.

VCS_DOMAINTYPE

The type of Security domain such as unixpwd, nt, nis, nisplus, ldap, or vx.

Symantec Product Authentication Service uses this environment variable to authenticate VCS users on a remote host.

Default: unixpwd

VCS_DIAG

Directory where VCS dumps HAD cores and FFDC data.

VCS_ENABLE_LDF

Designates whether or not log data files (LDFs) are generated. If set to 1, LDFs are generated. If set to 0, they are not.

VCS_HOME

Root directory for VCS executables.

Default: /opt/VRTSvcs

VCS_HOST

VCS node on which ha commands will be run.

VCS_GAB_PORT

GAB port to which VCS connects.

Default: h

VCS_GAB_TIMEOUT

Timeout in milliseconds for HAD to send heartbeats to GAB.

Default: 30000 (denotes 30 seconds)

Range: 30000 to 300000 (denotes 30 seconds to 300 seconds)

If you set VCS_GAB_TIMEOUT to a value outside the range, the value is automatically reset to 30000 or 300000, depending on the proximity of the value to either the lower limit or upper limit of the range. For example, the value is reset to 30000 if you specify 22000 and to 300000 if you specify 400000.

Note:

If the specified timeout is exceeded, GAB kills HAD, and all active service groups on system are disabled.

VCS_GAB_RMTIMEOUT

Timeout in milliseconds for HAD to register with GAB.

Default: 200000 (denotes 200 seconds)

If you set VCS_GAB_RMTIMEOUT to a value less than 200000, the value is automatically reset to 200000.

See About registration monitoring.

VCS_GAB_RMACTION

Controls the GAB behavior when VCS_GAB_RMTIMEOUT exceeds.

You can set the value as follows:

  • panic - GAB panics the system

  • SYSLOG - GAB logs an appropriate message

Default: SYSLOG

See About registration monitoring.

VCS_HAD_RESTART_TIMEOUT

Set this variable to designate the amount of time the hashadow process waits (sleep time) before restarting HAD.

Default: 0

VCS_LOG

Root directory for log files and temporary files.

Default: /var/VRTSvcs

Note:

If this variable is added or modified, you must reboot the system to apply the changes.

VCS_SERVICE

Name of configured VCS service.

Default: vcs-app

Note:

Before you start the VCS engine (HAD), configure the specified service. If a service is not specified, the VCS engine starts with port 14141.

VCS_TEMP_DIR

Directory in which temporary information required by, or generated by, hacf is stored.

Default: /var/VRTSvcs

This directory is created in /tmp under the following conditions:

  • The variable is not set.

  • The variable is set but the directory to which it is set does not exist.

  • The utility hacf cannot find the default location.

More Information

Defining VCS environment variables