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.
|
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 any mode.
To connect to an xfServer that’s running in SECURE mode
|
|
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. |
| 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 (Unix, OpenVMS)
When xfServer is running in non-secure mode with a default user account (on Unix or OpenVMS), 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 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:
| 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 (Windows)
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 RUN AS USER mode (Windows)
No additional setup is required. (If RUSER is set, it is ignored.)
To connect to an xfServer that’s running in TRUSTED mode (Unix)
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.
To connect to an xfServer that’s running in EFFECTIVE USER mode (Unix)
No additional setup is required. (If RUSER is set, it is ignored.)
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 any mode, except for restricted mode on Windows (because restricted mode supports only Windows clients).
To connect to an xfServer that’s running in SECURE mode
| 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 (Unix, OpenVMS)
When xfServer is running in non-secure mode with a default user account (on Unix or OpenVMS), 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
When xfServer is running in non-secure mode 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 on Unix or OpenVMS, do the following:
| 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 RUN AS USER mode (Windows)
No additional setup is required. (If RUSER is set, it is ignored.)
To connect to an xfServer that’s running in TRUSTED mode (Unix)
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.
To connect to an xfServer that’s running in EFFECTIVE USER mode (Unix)
No additional setup is required. (If RUSER is set, it is ignored.)
