The SPD
Server LIBNAME engine connects to the SPD Server host to access data
in the server environment. The SPD Server host uses the SPD Server
password file to validate each SPD Server user, and then creates a
LIBNAME proxy process on behalf of each of them.
The SPD
Server host is invoked using the following command-line syntax:
spdsserv [-option [optval]...]
Part of
the function of the SPD Server host process is to start SPD Server
logging processes. The spdslog process performs message logging functions.
The spdsaud process performs audit logging functions. Message and
audit logging functions are controlled using spdsserv command-line
options.
Both message
and audit logging facilities include automatic log filename generation
and periodic log file cycling support. The spdsserv command-line options
control automatic log filename generation cycling properties. Server
availability improves because you can periodically switch to a new
server log and audit log without halting and restarting SPD Server.
The default rc.spds script shipped in the
samples/ directory of your SPD Server installation provides examples of the
command-line options.
Audit
log records are kept for all resources accessed by each LIBNAME proxy
process. The audit log saves records in its own separate space, away
from other server log files. A sample SAS job that processes the audit
log and generates a report is provided. Check
samples/audit.sas for information about processing the audit log and generating the
report. To enable the audit log, use the
spdsserv command with the -AUDITFILE option.
When using
automatic server log cycling or audit log cycling, remember to periodically
clean the log files. Proper log file maintenance includes archiving
logs using secondary or long-term storage.
Many users
only retain a few generations of log files for quick reference. A
shell script that runs on a regular basis (such as CRONTAB) is a good
way to perform log maintenance on your server machine.
The
spdsserv command supports the following options:
Allows you to specify
an explicit file path for the SPD Server host's parameter file. This
file is mandatory and contains any SPD Server options. If this option
is omitted, the SPD Server host assumes a parameter file named spdsserv.parm
is in the process's current working directory. Option declarations
in this file are of the following form:
Option[ = Value];
The recognized -PARMFILE
option names are listed, but full descriptions are available only
in online documentation. Most sites do not need to modify the default
values in
InstallDir/site/spdsserv.parm. For more information about the parameter file, see "Setting Up
SPD Server Parameter Files" in the
SAS Scalable Performance
Data (SPD) Server 4.5: User's Guide.
For more information
about setting up server parameters, seeIntroduction.
Specifies the directory
path to the SPD Server host SPD Server password file. This option
can be omitted if the PASSPATH option is declared in the SPD Server
host's -PARMFILE option. A valid SPD Server password file is required
even when running with the -NOACL option. You must use the SPD Server
psmgr utility to create the password file and to populate it with
the set of valid SPD Server user IDs.
Disables SPD Server
login validation for SPD Server LIBNAME engine connections to the
SPD Server host.
Specifies the node
name where the Name Server process is running. This does not need
to be the same node that is hosting the SPD Server host processes.
This option is required.
Allows you to specify
an explicit TCP port number for the SPD Server host to use to connect
to its Name Server. If no port is specified, the Name Server queries
the system for a registered port address using the service name spdsname.
Specifies the name
of the file that contains the logical LIBNAME domain definitions that
the SPD Server host supports. LIBNAME definitions can span multiple
lines and must begin with the LIBNAME=name keyword.
For more information
about SPD Server LIBNAME parameter files, see Introduction.
Selects automatic server
log file creation by the logger process. fileSpec specifies a partial path or filename specification that is used
to generate the complete log file path. For example, if you specified fileSpec as /logs/spds, the generated name would appear as: /logs/spds mmddyyyy_hh:mm:ss.spdslog, where mmddyyyy and hh:mm:ss are taken from the system time when
the log file is created.
Specifies a time of
day to cycle a new generation of the server log file. At this time
each day, the previous log file is closed and new log file is opened.
Enables audit logging
for the server and automatic audit log file creation by the audit
process.
fileSpec specifies a path or filename
specification that is used to generate the complete audit file path.
For example, if you specified
fileSpec as
/audit/spds, the generated name would appear as:
/audit/spds_mmddyyyy_yyyy.spdsaudit, where
mmddyyyy is taken
from the system date when the log file is created.
Specifies a time of
day to cycle a new generation of the audit log file. At this time
each day, the previous log file is closed and new log file is opened.