Setting the XFPL_SMCPATH environment variable for xfServerPlus

If you’re using more than one SMC, or an SMC that is not in the default location, you need to set the environment variable XFPL_SMCPATH on your Synergy server machine to point to the directory that contains the SMC files.

At runtime, each instance of xfServerPlus can reference only a single SMC; however, if you have multiple instances of xfServerPlus running on different ports, they can each reference a separate SMC if desired. This enables you to maintain, for example, SMC files for testing and development and separate SMC files for production.

This topic explains only how to set XFPL_SMCPATH so that it can be read by xfServerPlus. To set XFPL_SMCPATH so that it can be read by the MDU, see Specifying which SMC to update.

Setting XFPL_SMCPATH on Windows

On Windows, use the Synergy Configuration Program to set environment variables for xfServerPlus. You can set XFPL_SMCPATH for all instances of xfServerPlus or for a specific instance of xfServerPlus.

You can specify an SMC on a remote machine using an xfServer file specification (e.g., c:\smcDir\@machineName).

To set XFPL_SMCPATH for all instances of xfServerPlus

This procedure sets XFPL_SMCPATH in the Windows registry under HKEY_LOCAL_MACHINE\SOFTWARE\Synergex\Synergy xfServer\Synrc.

Start the Synergy Configuration Program (from the Windows Control Panel, select Synergy Control Panel > Synergy Configuration Program) and go to the xfServer/xfServerPlus tab.

Select Default from the list of services, select the Modify Service button, and then select the Environment Settings button.

Select the Add button that is grouped with the “Settings for all services” list.

Type the variable name (XFPL_SMCPATH) and value in the Add Environment Setting dialog box, and select OK.

Select OK in the xfServer Information dialog box, and then select Apply in the Synergy Configuration Program.

You’ll be prompted to stop and restart all services so that the new settings take effect. Select Yes.

To set XFPL_SMCPATH for a specific instance of xfServerPlus

This procedure sets XFPL_SMCPATH in the Windows registry under HKEY_LOCAL_MACHINE\SOFTWARE\Synergex\Synergy xfServer\
serviceName\Synrc. This setting overrides the “all instances” setting for a specific instance of xfServerPlus.

Start the Synergy Configuration Program (from the Windows Control Panel, select Synergy Control Panel > Synergy Configuration Program) and go to the xfServer/xfServerPlus tab.

Select the service from the list, select the Modify Service button, and then select the Environment Settings button.

Select the Add button that is grouped with the “Settings for service name” list.

Type the variable name (XFPL_SMCPATH) and value in the Add Environment Setting dialog box, and select OK.

Select OK in the xfServerPlus Information dialog box, and then select Apply in the Synergy Configuration Program.

You’ll be prompted to stop and restart the selected service so that the new settings take effect. Select Yes.

We do not recommend setting XFPL_SMCPATH in the xfpl.ini file because it overrides both settings shown above.

Setting XFPL_SMCPATH on Unix

On Unix, the xfServerPlus service reads settings from the environment and from the synrc file. There is a synrc file at the system level in the /etc directory and a .synrc file at the user level in the user’s $HOME directory. At the system level, xfServerPlus supports both a generic synrc file and a port-specific synrc file. See below for details.

To include comments in the synrc file, precede the comment with a number sign (#).

To specify the SMC location for all instances of xfServerPlus, do one of the following:
Set XFPL_SMCPATH as an environment variable. (Note that the MDU will also read XFPL_SMCPATH set in the environment.)
Set XFPL_SMCPATH in the generic synrc file (/etc/synrc). This setting overrides XFPL_SMCPATH set in the environment.
To specify the SMC location for a specific instance of xfServerPlus by port number, create a file named synrc.####, where #### is the port number that xfServerPlus is running on, and put it in the /etc directory. If you have multiple instances of xfServerPlus running on multiple ports, you can create a file for each instance and then set XFPL_SMCPATH differently in each file. This setting overrides XFPL_SMCPATH set either in the environment or in the generic synrc file.
To specify the SMC location for xfServerPlus by username, set XFPL_SMCPATH in the .synrc file in the $HOME directory for the user account that xfServerPlus sessions run under. If you create several xfServerPlus accounts, each one could have a different .synrc file with different settings. Setting XFPL_SMCPATH (or any environment variable) in the user’s .synrc file overrides XFPL_SMCPATH set in the environment, the generic synrc file, and the port-specific synrc file.
We do not recommend setting XFPL_SMCPATH in the xfpl.ini file because it overrides all settings shown above.

Setting XFPL_SMCPATH on OpenVMS

We recommend setting XFPL_SMCPATH in DBLDIR:SERVER_INIT.COM.

To specify the SMC location for all instances of xfServerPlus, use

$ DEFINE/SYS XFPL_SMCPATH altdir

where altdir is the directory in which the SMC files are located.

To specify the SMC location for a specific instance of xfServerPlus, use

$ DEFINE/TABLE=LNM$RSDMS$MGR_port /USER - XFPL_SMCPATH altdir

where port is the port number on which the specific xfServerPlus session is running, and altdir is the directory in which SMC files are located. This setting overrides the system-level setting.

We do not recommend setting XFPL_SMCPATH in the xfpl.ini file because it overrides both settings shown above. For additional information on defining rsynd logicals on OpenVMS, see Defining logical names for xfServer processes.