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.
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):
$ RSYND -
/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 username of the account that the remote execution sessions will run under. (This is the account that was specified during installation.)
(Note: In earlier versions of xfServerPlus, the verb SYNERGY_SERVER is used instead of RSYND; they are identical.) 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 username 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 username of the account that xfServerPlus sessions will run under.
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.
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:
- While logged into the SYSTEM account, execute the command
$ 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.
-
Use the servstat program.
If you need to refresh the pool without shutting down xfServerPlus, use servstat option 10, Purge xfServerPlus free pool. All processes in the xfServerPlus free pool will be destroyed and the pool will be repopulated with new processes. This option is especially useful when the XFPL.INI file has been modified, as it enables you to ensure that all processes in the free pool get the new settings.