Running xfServerPlus on OpenVMS

By default, xfServerPlus runs on port 2356.

Creating a user account for xfServerPlus

We recommend that you set up an account with limited privileges specifically for running xfServerPlus sessions. You must specify this account during installation. The account used to run xfServerPlus sessions must have the SHARE privilege.

Note

OpenVMS accounts have sections for “Default Privileges” and “Authorize Privileges”. The former lists those privileges that are always on, while the latter lists those that can be turned on but are off by default. The SHARE privilege must be defined in the “Default Privileges” section. (Usually, the same privileges are set in both sections.)

This account cannot have the privileges listed below, unless the /ALLOW_PRIVILEGED qualifier is specified in the start‑up command. We recommend that you not allow these privileges because they give end users privileges at the system administrator level.

ALTPRI

DOWNGRADE

SYSNAM

BYPASS

EXQUOTA

SYSPRV

CMEXEC

READALL

VOLPRO

CMKRNL

SECURITY

WORLD

DETACH

SETPRV

 

Starting xfServerPlus

The SYS$MANAGER:SYNERGY_STARTUP.COM file will include the following xfServerPlus settings (you will see other settings in addition to these):

$ SYNERGY_SERVER   ‑
    /PORT=2356   ‑
    /XFPL_FREE_POOL=2  ‑
    /XFPL_ENABLE=xfspAcct

where

/PORT is the port that xfServerPlus will run on (default is 2356).

/XFPL_FREE_POOL is the number of remote execution sessions that will be kept available for user connections (default is 2; minimum is 1). Sessions remain in the pool until rsynd is shut down.

/XFPL_ENABLE enables xfServerPlus. xfspAcct is the user name of the account that the remote execution sessions will run under. (This is the account that was specified during installation.)

For information on the other xfServerPlus settings in the SYNERGY_STARTUP.COM file, see rsynd program.

Once installed, xfServerPlus starts up as part of the machine start‑up. If the user name specified has invalid privileges (see list above), xfServerPlus is not started, and the following error message is logged in the rsynd log file. By default this file is named node_rsynd_port.log and located in DBLDIR.

Message from user SYSTEM on MachineName RSDMS$MGR_2356: Security 
check: attempt to start xfServerPlus with elevated privilege failed.

To start xfServerPlus manually, use the command

$ RSYND /XFPL_ENABLE=xfspAcct

where xfspAcct is the user name of the account that xfServerPlus sessions will run under.

Note

For a complete list of options for rsynd, additional information on starting rsynd, and details on rsynd logging, see Configuring xfServer.

Checking the status of xfServerPlus

You can check the status of xfServerPlus with the servstat program. Run option 9, Display xfServerPlus status. It will tell you the port on which xfServerPlus is enabled, the number of processes in use, and so on.

Note that servstat does not report specific errors. If option 9 shows that xfServerPlus is not enabled, refer to the above‑mentioned log file for information about what went wrong. See servstat program for details.

Creating additional xfServerPlus sessions

You can create more than one instance of xfServerPlus by copying the xfServerPlus start‑up section in the SYNERGY_STARTUP.COM file and adjusting the parameters as desired. Each instance of xfServerPlus must have a unique port. You will also probably want to specify a separate log file for each instance with the /OUTPUT qualifier. (Note that this log file is for the rsynd log, not the xfServerPlus log. See xfServer configuration options for more information on rsynd logging.)

If you want to be able to use separate XFPL.INI files with each instance of xfServerPlus, you must create a separate account for each instance and specify it with the /XFPL_ENABLE qualifier. See also Setting XFPL_INIPATH on OpenVMS.     

Tip

You can reduce the disk I/O overhead required for reading the SMC by installing a RAM drive and copying the SMC files and the XFPL.INI file to it. Then, set the XFPL_INIPATH and XFPL_SMCPATH logicals to point to the RAM drive. This will also reduce the time it takes to start the remote execution sessions.

Stopping xfServerPlus

Use one of these methods:

$ RSYND/SHUTDOWN/PORT=port

where port specifies the port number that xfServerPlus is running on. Existing connections are not affected by the server system shutdown. New connections are not accepted after this command has executed.