Customizing the Default Configuration

This section provides an overview of the default configuration settings for basic activities such as logging, auditing, and parameter file locations, and describes how to change them. To modify the default settings, you will need to shut down SPD Server, make the changes, and then re-start SPD server. Shut down SPD Server by using the Windows Task Manager.

Logging

Audit File Facility

User Password and Parameter Files

Accessing SPD Server through a Registered Port

Logging

By default, SPD Server creates log files in the InstallDir\log directory. The files contain messages that are written to STDOUT or STDERR for the spdsnsrv (SPD Server name server), spdsserv (SPD Server host), and spdssnet (SPD Server SNET Server) processes. The content and location of SPD Server logs is controlled by the InstallDir\site\*.bat files for each process.

SPD Server log files can grow very large if there is considerable activity. The log files can be configured to recycle at a given time each day and start a new logfile. The older log files can then be removed or archived.

To alter the name, location, or cycle time to generate a new log file, modify the following start-up parameters for the spdsserv, spdsnsrv, or spdssnet processes in their respective batch files:

-logfile fileSpec

specifies that the logger process automatically creates a server log file. fileSpec specifies a partial pathname or filename that is used to generate the complete log file path.

For example, if you specify fileSpec as c:\logs\spdsnsrv, the name c:\logs\spdsnsrv_mmddyyyy_hh:mm:ss.spdslog is generated. The values mmddyyyy and hh:mm:ss indicate the time at which the system created the log file.

-logtime hh:mm

specifies the time of day at which to cycle a new generation of the name server log file. At this time each day, the previous log file is closed and a new log file is opened. For example, the default value,

-logtime
                                    00:00

, cycles the log at midnight.

Audit File Facility

The audit file facility is not enabled by default. To enable SPD Server auditing, include the following start-up parameters when you invoke the Installdir\site\spdsserv.bat file:

-auditfile fileSpec

The AUDITFILE argument enables proxy audit logging for the server, and enables automatic audit log file creation by the audit process. The parameter fileSpec specifies a path or filename that is used to generate the complete audit file path.

For example, if you specify fileSpec as \audit\spds, the generated name will be \audit\spds_mmddyyyy_hh:mm:ss.spdsaudit, where mmddyyyy is the system date when the log file was created.

-sqlauditfile fileSpec

The SQLAUDITFILE argument enables SQL audit logging for the server, and enables automatic audit log file creation by the audit process. The parameter fileSpec specifies a path or filename that is used to generate the complete SQL audit file path. For example, if you specify fileSpec as \audit\spdssql, the generated name will be \audit\spdssql_mmddyyyy_hh:mm:ss.spdsaudit, where mmddyyyy is the system date when the log file was created.

-audittime hh:mm

The AUDITTIME argument specifies the time of day to cycle a new generation of the audit log file or SQL audit log file. At this time each day, the previous log file is closed and a new log file is opened. For example,

-audittime
                                    00:00

cycles the logs at midnight.

For more information about SPD Server auditing, see Audit File Facility.

User Password and Parameter Files

The spdsserv.bat file looks for the spdsserv.parm parameter file, which contains server processing parameters; the libnames.parm parameter file, which defines SPD Server domains; and the SPD Server password database, which stores information about SPD Server users, in the InstallDir\site directory. If you do not want to keep the files in this location, modify the following arguments in the spdsserv.bat file:

-parmfile fileSpec

The PARMFILE argument specifies an explicit file path for the spdsserv.parm parameter file. This file is mandatory and contains any SPD Server options. If this option is omitted, the SPD Server host assumes that a parameter file named spdsserv.parm is in the process's current working directory.

-libnamefile fileSpec

The LIBNAMEFILE argument specifies the name of the file that contains the domain definitions that the SPD Server host supports.

-acldir fileSpec

The ACLDIR argument specifies the name of the directory for the password database.

Accessing SPD Server through a Registered Port

To enable access to SPD Server through a registered port (name service), add the following service to your \etc\inet\services or \etc\services file (if this service is not already present):

spdsname 5400\tcp # SPDS Name Service

This service defines the port number for the SPD Server name server process. Make sure that this port number matches the port number that you used when you installed SPD Server. If you are running SAS on an existing SPD Server installation, this service name is probably already defined. You can either define another service name for the SAS client to use (for example, sp53name) or you can directly include the SPD Server port number in your SAS statements.

Last updated: February 3, 2017