Usage Note 19864: Instructions for increasing the SASĀ® Financial Management logging level
If you encounter problems with SAS Financial Management and you are asked to increase the logging level, complete the following steps:
Note that this example details the steps to increase the logging level for the "finance" component to DEBUG, but a similar process would be followed to modify the logging level for other components or for setting the logging level to something other than DEBUG.
PLEASE BE AWARE THAT THIS PROCESS IS SIGNIFICANTLY DIFFERENT FOR SAS FINANCIAL MANAGEMENT RELEASE 4.x AND RELEASE 5.x. PLEASE BE CAREFUL TO FOLLOW THE DIRECTIONS BELOW FOR THE RELEASE OF SAS FINANCIAL MANAGEMENT THAT YOU ARE USING.
For SAS Financial Management release 5.x:
- On the mid-tier server, access the directory
<drive>:\SAS\Config\Lev1\Web\Common\LogConfig
- Using a standard text editor, open the appropriate <log4j.xml> file that corresponds to the component that you want to increase the logging level for.
For example, to increase logging for Finance, edit the <SASFinance-log4j.xml> file.
- Modify the logging level for the specific package.
For example, to increase logging to DEBUG for "com.sas.solutions.finance", find the entry in the log4j.xml file that resembles
<logger name="com.sas.solutions.finance" additivity="false">
<level value="warn"/>
<appender-ref ref="SAS_FILE"/>
</logger>
Note: If you do not see an entry similar to this in your <SASFinance-log4j.xml> file, you can add it directly to the file or you can copy and paste from a similar entry and make the necessary changes so it resembles the above.
- Change the logging level by modifying the 'level value'; for example, change it from "warn" to "debug".
- Once you modify the logging level, restart the SAS Remote Services and the (WebLogic or WebSphere) application servers to have these changes take effect.
- Perform the actions that are generating the unexpected results. That should be enough to produce the necessary log output.
Note that leaving this increased logging level turned on too long will generate too much information and will consume unnecessary system resources. Re-set the logging level to its' prior state (such as "warn"), save the file, then re-start the SAS Remote Services and the (WebLogic or WebSphere) application servers.
- After that, check the output in the appropriate log file. The log file is written to the output location specified near the top of the log4j.xml file, with the line prefaced by <param name="File">.
It typically points to a location such as
<drive>:/SAS/Config/Lev1/web/Logs/SASSolutionsServices/SASFinancialManagement5.1.log
For SAS Financial Management release 4.x:
- Edit the <logging.xml> file, which by default is located at:
<drive>:\SAS\SASSolutionsConfig\Lev1\web\Deployments\SASSolutionsServices
- Turn on debugging for <com.sas.solutions.finance> by changing the value of the priority attribute from 'ERROR' to 'DEBUG' and then saving the file. For example:
<logger name="com.sas.solutions.finance" additivity="false">
<level value="DEBUG"/>
<appender-ref ref="CONSOLE"/>
<appender-ref ref="FILE"/>
</logger>
If you do not see this context in your <logging.xml> file, you can add it directly to the file or you can copy and paste from a similar logger name and make the necessary changes so it resembles the above.
- Once you modify the logging level, restart the SAS Remote Services and the (WebLogic or WebSphere) application servers to have these changes take effect.
- Perform the actions that are generating the unexpected results. That should be enough to produce the necessary log output.
Note that leaving this increased logging level turned on too long will generate too much information and will consume unnecessary system resources. Re-set the priorities to "ERROR", save the file, then re-start the SAS Remote Services and the (WebLogic or WebSphere) application servers.
- After that, check the output in the log file. The log file is written to the Output location specified near the top of the <logging.xml> file, with the line prefaced by <param name="File">.
It typically points to a location such as
<drive>:/SAS/SASSolutionsConfig/Lev1/web/Deployments/
SASSolutionsServices/server.log
Additional information:
Note that the above example represents setting the DEBUG level for the 'finance' logger. The identical process applies if different logger names (for instance, 'odcs' instead of 'finance') or different logging levels (for instance, 'INFO' instead of 'DEBUG') are specified.
PLEASE NOTE THAT THE SAS SOLUTIONS WEB ADMINISTRATION APPLICATION IS ONLY APPLICABLE FOR SAS FINANCIAL MANAGEMENT 4.x RELEASES.
Operating System and Release Information
| SAS System | SAS Financial Management | Microsoft Windows XP Professional | 4.0 | | 9.1 TS1M3 | |
| Microsoft Windows Server 2003 Standard Edition | 4.0 | | 9.1 TS1M3 | |
| Microsoft Windows Server 2003 Enterprise Edition | 4.0 | | 9.1 TS1M3 | |
| Microsoft Windows Server 2003 Datacenter Edition | 4.0 | | 9.1 TS1M3 | |
| Microsoft Windows 2000 Server | 4.0 | | 9.1 TS1M3 | |
| Microsoft Windows 2000 Professional | 4.0 | | 9.1 TS1M3 | |
| Microsoft Windows 2000 Datacenter Server | 4.0 | | 9.1 TS1M3 | |
| Microsoft Windows 2000 Advanced Server | 4.0 | | 9.1 TS1M3 | |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.
| Type: | Usage Note |
| Priority: | medium |
| Topic: | System Administration ==> Installation
|
| Date Modified: | 2010-11-30 16:41:43 |
| Date Created: | 2007-03-28 09:47:24 |