Enable backup mode feature



USupported on UNIX


The SYNBACKUP environment variable enables the backup mode feature, which means I/O update operations can be frozen so a Synergy system backup can safely be performed.


Any value.


The SYNBACKUP environment variable is available for use by the synbackup utility, which enables you to back up your Synergy system without terminating all applications or processes accessing the files. On UNIX, the current backup mode (Pending, On, Off, or Not Allowed) is maintained in a shared memory segment on the system. The synbackup utility initializes and maintains this shared memory segment, as well as sets the backup mode to Pending, On, or Off. The base address of this memory segment is stored in the file DBLDIR:synbackup.cfg, which is created by the synbackup -c command. So the runtime does not have to repeatedly open this file, it first checks the environment variable SYNBACKUP. The runtime only opens the synbackup.cfg file to retrieve the base address if SYNBACKUP is set.

When SYNBACKUP is not set, the backup mode feature is disabled.


If you have multiple installations of Synergy on your UNIX system or use both 32- and 64-bit versions:

When the SYNBACKUP environment variable is set, the runtime looks for the file DBLDIR:synbackup.cfg. If a system contains multiple installations of Synergy, each has DBLDIR set to its own installation area. To make all installations use the same shared memory, you need to create a symbolic link to synbackup.cfg in the DBLDIR directory of each additional installation location (for example, “ln -s /usr2/test_1033_32/synergyde/dbl/synbackup.cfg /usr2/test_1033d_32/synergyde/dbl/synbackup.cfg”). Be sure to enable the SYNBACKUP environment variable in the setsde script for each Synergy installation area.

Setting location

The setsde file created by the installation, but it is commented out at installation and must be uncommented by the system administrator.

Used by


See also

synbackup utility