Administering Logging for SAS Servers

Create a Log File for Workspace Server Troubleshooting

Standard (non-pooled) workspace servers are not initially configured to produce log files. However, you might need to capture workspace server messages in a log file for troubleshooting purposes. In these situations, you can use the alternative logging configuration file (logconfig.trace.xml) that is provided in each workspace server's configuration directory.

The alternative configuration provides high-level logging messages (for example, DEBUG and TRACE messages) which can be used by SAS Technical Support to help resolve server issues. The messages are written to a rolling log file. The file is written to a Logs directory within the server's configuration directory.

CAUTION:: Do not use or modify the logconfig.trace.xml logging configuration files unless you are requested to do so by SAS Technical Support.
Performance issues can result from the use of these files.

If SAS Technical Support requests that you enable detailed logging for workspace server troubleshooting, follow these steps:

If you are enabling workspace server logging to a log file for the first time, you must grant all users of the workspace server Read, Write, and Execute access to the server's Logs directory.
Rename the server's logconfig.xml file to logconfig_orig.xml.
Rename the server's logconfig.trace.xml file to logconfig.xml.
When troubleshooting is completed, do the following:
1. Rename logconfig.xml to logconfig.trace.xml.
2. Rename logconfig_orig.xml to logconfig.xml.

Note: You can also adjust logging dynamically by using the Server Management features of SAS Management Console. See Using SAS Management Console to Monitor SAS Servers. [cautionend]

Top of Page