ISA How To Guide

How t o enabl e I nt er net Sal es t o w r i t e l ogs

i n a separ at e l og f i l e i n Rel ease 5.0
Purpose
The purpose of this document is to show you how to enable the ISA application to write logs in a
seperate log file and not in the default trace.
Prerequisites
This guide will take you through the following prerequisites, step-by-step. Once these are done,
single session logging is activated and can be carried out as described in the last chapter Starting
single session logging. Should you have any problems, ensure that all of the prerequisites have
been carried out exactly as described.
Prerequisites
Addcom.sap.isa to the key SingleTraceFile_UnrestrictedLocations
Create the log formatter
Enter a log file destination
IMPORTANT
After making the required settings, note that you still have to start the session log in the Internet
Sales application by setting the request parameter appinfo to true, or by using the Single Session
Trace link on the start.jsp.
Also, the destination is deleted after restarting the J 2EE Engine. If you want to run the trace again
you have to repeat the steps described in the last chapter Starting single session logging.
Table of Contents
Preparing the log...................................................................................................................................2
Creating the log formatter.....................................................................................................................3
Maintaining the log file destination.....................................................................................................4
Starting single session logging.............................................................................................................6
ISA How To Guide
Preparing the log
1. Log in to your J 2EE engine with the Visual Administrator.
2. Go to Server =>Kernel =>LogManager.
3. The SingleTraceFile_UnrestrictedLocations must contain the required location
"com.sap.isa". If you need to maintain more then one Location please separate them with
";".
4. Save your settings.
ISA How To Guide
Creating the log formatter
1. Go to Server =>Services =>Log Configurator.
2. Choose the advanced mode, choose Runtime =>Formatters =>New, and set the
following:
a. Name: isa_formatter
b. Pattern: %d,%-3p %t %s %l %m
c. Type: TraceFormatter
3. Save and choose Apply to all server nodes.
ISA How To Guide
Maintaining the log file destination
1. Go to Server =>Services =>Log Configurator.
2. Choose the advanced mode, then Runtime =>Destinations =>New, and set the following
in the resulting pop-up:
a. Name application_sap.com/crm~isa
b. Type FileLog
c. Pattern ./log/applications/isa_applications.log
d. Limit 10000000
e. Count 10
./ means the the default folder of the J2EE engine node will be used. For example on
Windows
<Drive_J2EE_Engine_is_installed_to>:\usr\sap\<SID>\J C<Your_Instance_Number>\j2ee
\cluster\server0\
ISA How To Guide
Select Add and choose the formatter that you have just created.
ISA How To Guide
Starting single session logging
1. Select the Runtime =>Locations tabs.
2. Choose the advanced mode.
3. In Log Controllers, go to Root Location =>com =>sap =>isa.
4. Select Add, enter the destination, and set the severity level to Debug.
5. Save and choose Apply to all server nodes.
Now ISA writes its own log file and you are finished from the J2EE side. Please note that Step 2
to 4 does not require a re-start of the Cluster node. If not, set ForceSingleTraceFile toNO in the
log manager setting of the Visual Administrator.