SAS 9.1.3 Intelligence Platform: System Administration Guide

70 The Default Metadata Server Logging Configuration R Chapter 9
3 traces invoked by omaconfig.xml debugging options
The Default Metadata Server Logging Configuration
The default configuration enables logging of the first four categories of information
that are listed in the preceding topic. To enable these logging levels, the SAS
Configuration Wizard specifies the following invocation options in the file
SAS-config-dir\Lev1\SASMain\MetadataServer\sasv9_MetadataServer.cfg:
-log "SAS-config-dir\Lev1\SASMain\MetadataServer\logs\MetadataServer#d#b#y.log"
-logparm "rollover=auto open=replaceold write=immediate"
-pagesize max
-linesize max
The following table explains each option:
Table 9.1 Log-File-Related Options in sasv9_MetadataServer.cfg
Option Explanation
LOG Enables the first four levels of logging and specifies the path to the
log file. In the default case, the metadata server will create daily logs
with names like MetadataServer01Mar2006.
LOGPARM Specifes that information should be written to the log file
immediately (instead of being buffered) and that a new log file should
be opened each day. (The frequency with which a new log file is
created depends on the log file name.)
PAGESIZE Sets the number of lines per page to 32,767, the maximum number.
LINESIZE Sets the number of characters per line to 256, the maximum.
For more information about these options, see the SAS Language Reference: Dictionary.
To change the values of the options, stop the metadata server, make the desired
changes to the configuration file, and then restart the server.
For information about adding logging capabilities beyond those that are configured
by default, see the following topics:
3 “Enable the Logging of SAS Metadata Server Authentication Events” on page 70
3 “Capture XML Information in the SAS Metadata Server Log” on page 71
3 “Capture Debugging Information in the SAS Metadata Server Log” on page 74
Enable the Logging of SAS Metadata Server Authentication Events
An authentication event is a response to a request for a credential handle. A
credential handle is a token that represents a user’s authorizations on the SAS
Metadata Server. To reduce the number of authorization requests that are made to the
metadata server on behalf of a given user, this token can be stored on an interim server.
The SAS Metadata Server and SAS Metadata Server clients call the GetCredentials
and FreeCredentials methods to obtain and release credentials on behalf of users.
To configure the logging of authentication events, complete these steps.
1 Open the file
SAS-config-dir\Lev1\SASMain\MetadataServer\sasv9_MetadataServer.cfg.
This file contains a line similar to the following:
-objectserverparms "cel=credentials protocol=bridge port=8561
classfactory=2887E7D7-4780-11D4-879F-00C04F38F0DB