4. Client Options

Pacemaker uses several environment variables set on the client side.

Note

Directory and file paths below may differ on your system depending on your Pacemaker build settings. Check your Pacemaker configuration file to find the correct paths.

Client-side Environment Variables

Environment Variable	Default	Description
CIB_encrypted	true	Whether to encrypt network traffic. Used with CIB_port for connecting to a remote CIB instance; ignored if CIB_port is not set.
CIB_file		If set, CIB connections are created against the named XML file. Clients read an input CIB from, and write the result CIB to, the named file. Ignored if CIB_shadow is set.
CIB_passwd		$CIB_user’s password. Read from the command line if unset. Used with CIB_port for connecting to a remote CIB instance; ignored if CIB_port is not set.
CIB_port		If set, CIB connections are created as clients to a remote CIB instance on $CIB_server via this port. Ignored if CIB_shadow or CIB_file is set.
CIB_server	localhost	The host to connect to. Used with CIB_port for connecting to a remote CIB instance; ignored if CIB_port is not set.
CIB_shadow		If set, CIB connections are created against a temporary working (“shadow”) CIB file called shadow.$CIB_shadow in $CIB_shadow_dir. Should be set only to the name of a shadow CIB created by crm_shadow. Otherwise, behavior is undefined.
CIB_shadow_dir	/var/lib/pacemaker/cib if the current user is root or hacluster; otherwise $HOME/.cib if $HOME is set; otherwise $TMPDIR/.cib if $TMPDIR is set to an absolute path; otherwise /tmp/.cib	If set, shadow files are created in this directory. Ignored if CIB_shadow is not set.
CIB_user	hacluster if used with CIB_port, or the current effective user otherwise	If used with CIB_port, connect to $CIB_server as this user. Must be part of the haclient group on $CIB_server. Otherwise (without CIB_port), this is used only for ACL and display purposes.
EDITOR		Text editor to use for editing shadow files. Required for the --edit command of crm_shadow.
HOME	Current user’s home directory as configured in the passwd database, if an entry exists	Used to create a default CIB_shadow_dir for non- privileged users.
PE_fail	0	Advanced use only: A dummy graph action with action ID matching this option will be marked as failed. Primarily for developer use with scheduler simulations.
PS1		The shell’s primary prompt string. Used by crm_shadow: set to indicate that the user is in an interactive shadow CIB session, and checked to determine whether the user is already in an interactive session before creating a new one.
SHELL		Absolute path to a shell. Used by crm_shadow when launching an interactive session.
TMPDIR	/tmp	Directory for temporary files. If not an absolute path, the default is used instead.