Configuring xfServerPlus for remote data access

You can access data remotely from xfServerPlus using xfServer. For example, xfServerPlus might be running on one machine, and you want to access data located on another machine, on which xfServer resides. In this scenario, xfServerPlus acts as a client to xfServer. The instructions vary depending on the xfServer security mode and the systems that xfServerPlus and xfServer are running on. For details on xfServer security modes, refer to the topic for your operating system in Configuring xfServer.

Note

If xfServerPlus is on OpenVMS, you cannot connect to a remote xfServer process for data access because an OpenVMS system cannot be an xfServer client.

Remote data access when xfServerPlus is on Windows

When xfServerPlus is on Windows, you can access data remotely through xfServer running on Windows, UNIX, or OpenVMS. xfServer may be running in secure, non‑secure, restricted (on Windows), or trusted (on UNIX) mode.

To connect to an xfServer that’s running in SECURE mode

Note

If both xfServerPlus and xfServer are on Windows, and xfServer is running in secure mode, and RUSER is not set for the xfServerPlus service, Windows authentication will be attempted. If the xfServerPlus account is a domain account, authentication should succeed. If the xfServerPlus account is a local account, you will need to set RUSER as described in the steps below. See Understanding xfServer security on Windows for details on xfServer security modes.

1. On the xfServer machine, create an account using the xfServerPlus account username and password. (Note that while technically this account does not have to be the same as the xfServerPlus account, we recommend it for the sake of simplicity.)
2. On the xfServerPlus machine, at a command prompt run setruser with the ‑n option. When prompted, enter the username and password you defined on the xfServer machine in step 1.

Setruser ‑n returns the username and encoded password to the screen; it does not update the RUSER setting in the registry. Leave this output displayed on your screen; you can copy it to create the environment setting. (For more information about setruser, see setruser utility.)

3. Start the Synergy Configuration Program and go to the xfServer/xfServerPlus tab.
4. Select the xfServerPlus service that will be the client to xfServer, click the Modify Service button, and then click the Environment Settings button.
5. Click the Add button that is grouped with the “Settings for service name” list.
6. Enter RUSER for the variable name, and then for the value copy and paste the string returned by setruser ‑n in step 2. Click OK in the Add Environment Setting dialog box. This sets RUSER in the registry in HKEY_LOCAL_MACHINE\ Software\Synergex\Synergy xfServer \serviceName\Synrc.
7. Click OK in the Environment Settings dialog box and the xfServerPlus Information dialog box, and then click Apply in the Synergy Configuration Program. The service will be stopped and restarted.

To connect to an xfServer that’s running in NON‑SECURE mode with a default user account

When xfServer is running in non‑secure mode with a default user account, no additional setup is required on either the xfServer or the xfServerPlus machine for remote data access. (You do not need to set RUSER on the xfServerPlus machine; if RUSER is set, it is ignored.)

To connect to an xfServer that’s running in NON‑SECURE mode

If xfServer is running in non‑secure mode without a default user account on Windows, no additional setup is required on either the xfServer or the xfServerPlus machine for remote data access. (You do not need to set RUSER on the xfServerPlus machine; if RUSER is set, it is ignored.)

If xfServer is running in non‑secure mode without a default user account on UNIX or OpenVMS, do the following:

1. On the xfServer machine, create an account using the xfServerPlus account username. (Note that while technically this account does not have to be the same as the xfServerPlus account, we recommend it for the sake of simplicity.)
2. On the xfServerPlus machine, set RUSER to the username (a password is not required) that you specified in step 1. Follow steps 3 through 7 in Remote data access when xfServerPlus is on Windows. In step 6, rather than pasting the string, enter the username for the variable value.

To connect to an xfServer that’s running in RESTRICTED mode

Restricted mode uses Windows authentication to secure the connection between client and server. Consequently, this configuration is valid only when both xfServerPlus and xfServer are running on Windows and belong to the same domain or trusted domain. In addition, the account used to run xfServerPlus sessions must be a domain account—not a local account. (See the note under Running xfServerPlus on Windows for information on using a domain account as the xfServerPlus account.) No additional setup is required. (If RUSER is set, it is ignored.)

To connect to an xfServer that’s running in TRUSTED mode

On the xfServer machine, create an account using the xfServerPlus account username. This account must have the same username as the xfServerPlus account. Do not set RUSER on the xfServerPlus machine.

Remote data access when xfServerPlus is on UNIX

When xfServerPlus is on UNIX, you can access data remotely through xfServer running on Windows, UNIX, or OpenVMS. xfServer may be running in secure, non‑secure, or trusted mode (on UNIX). You cannot access data on Windows when xfServer is running in restricted mode, because restricted mode supports only Windows clients.

To connect to an xfServer that’s running in SECURE mode

1. On the xfServer machine, create an account using the xfServerPlus account username and password. (Note that while technically this account does not have to be the same as the xfServerPlus account, we recommend it for the sake of simplicity.)
2. On the xfServerPlus machine, set the RUSER environment variable to the username and password you defined on the xfServer machine in step 1.

You should set RUSER in the environment prior to starting xfServerPlus. You can do this in one step with this command:

RUSER=`setruser` ;export RUSER 

This command runs setruser (which prompts you for the username and password), assigns the output to RUSER, and exports it. (For more information about setruser, see setruser utility.)

To connect to an xfServer that’s running in NON‑SECURE mode with a default user account

When xfServer is running in non‑secure mode with a default user account, no additional setup is required on either the xfServer or the xfServerPlus machine for remote data access. (You do not need to set RUSER on the xfServerPlus machine; if RUSER is set, it is ignored.)

To connect to an xfServer that’s running in NON‑SECURE mode without a default user account

When xfServer is running in non‑secure mode without a default user account on Windows, no additional setup is required on either the xfServer or the xfServerPlus machine for remote data access. (You do not need to set RUSER on the xfServerPlus machine; if RUSER is set, it is ignored.)

When xfServer is running in non‑secure mode without a default user account on UNIX or OpenVMS, do the following:

1. On the xfServer machine, create an account using the xfServerPlus account username. (Note that while technically this account does not have to be the same as the xfServerPlus account, we recommend it for the sake of simplicity.)
2. On the xfServerPlus machine, set RUSER to the username (a password is not required) you specified in step 1. You don’t need to run setruser because non‑secure mode does not require a password; just set the RUSER environment variable to the username.

To connect to an xfServer that’s running in TRUSTED mode

On the xfServer machine, create an account using the xfServerPlus account username. This account must have the same username as the xfServerPlus account. Do not set RUSER on the xfServerPlus machine.