7.5.1 Settings for using the trace based performance analysis

The following settings are required when using the trace based performance analysis:

Management Server
Performance tracer

Important note

Note the following points when you specify the environment variables in AIX:

With the Performance Tracer execution environment, set up early in the environment variable PSALLOC. If this value is not set and if a memory shortage occurs, the operations might not function correctly.
Set up early in the environment variable PSALLOC specifying the early paging space allocation in AIX. For the points to be considered when you estimate the paging space for the early paging space allocation, see the AIX manual System Management Concepts: Operation Systems and Devices.
With the Performance Tracer execution environment, set up true in the environment variable NODISCLAIM. If you specify early in the environment variable PSALLOC, and do not specify true in the environment variable NODISCLAIM, the responses, throughput, and CPU usage might deteriorate greatly.
To extend the user data area and shared memory area to be used with Performance Tracer, set up MAXDATA=0x40000000 in the environment variable LDR_CNTRL. Allocate 1 gigabyte memory.
With the Performance Tracer execution environment, set up ON in the environment variable EXTSHM. If no value is set up, sometimes the shared memory cannot be referenced.

Organization of this subsection

(1) Management Server settings
(2) Setting of performance trace

(1) Management Server settings

The setting of the Management Server is executed by mserver.properties (Management Server environment setting file). The setting parameters are as follows:

com.cosminexus.manager.tracelog.size

Specify the number of files of the trace based performance analysis file collected by Management Server.

For details on mserver.properties and the key, see 8.2.6 mserver.properties (Management Server environment settings file) in the uCosminexus Application Server Definition Reference Guide. For details on the trace based performance analysis file, see the section 7.3 Collecting the trace based performance analysis file by using Management Server.

To Page Top

(2) Setting of performance trace

The setting of the performance tracer (PRF daemon) is implemented by the Easy Setup definition file. Specify the definition of trace based performance analysis in the <configuration> tab of the logical performance trace (performance-tracer) of the Easy Setup definition file.

The following table describes the definition of the trace based performance analysis in the Easy Setup definition file.

Table 7‒6: Definition of trace based performance analysis in the Easy Setup definition file
Parameter to specify	Setting contents
`PrfTraceLevel`	The functionality (Web server, J2EE server, CTM) of Application Server outputs in the buffer, specifies trace collection level of the performance trace.
`PrfTraceCount`	Specifies the number of files of the PRF trace of performance trace.
`PrfTraceFileSize`	Specifies the file size of the performance tracer. Set the value consisting the relation of `PrfTraceFileSize` ≥ PrfTraceBufferSize`.`
`PrfTraceBufferSize`	Specifies the buffer size of the performance tracer. Set the value consisting the relation of `PrfTraceFileSize` ≥ PrfTraceBufferSize`.`

Note:: For details on the Easy Setup definition file and each parameter to be specified, see 4.3 Easy Setup definition file in the uCosminexus Application Server Definition Reference Guide.

To Page Top