Adjusting the SAS Embedded Process Performance :: SAS(R) 9.4 In-Database Products: Administrator's Guide, Sixth Edition

Overview of the ep-config.xml File

You can adjust how the SAS Embedded Process runs by changing properties in the ep-config.xml file.

The ep-config.xml file is created when you install the SAS Embedded Process. By default, the file is located in the /sas/ep/config/ep-config.xml directory.

You can change property values that enable you to perform the following tasks:

change trace levels

For more information, see Changing the Trace Level.
specify the number of SAS Embedded Process MapReduce 1 tasks per node

For more information, see Specifying the Number of MapReduce Tasks.
specify the maximum amount of memory in bytes that the SAS Embedded Process is allowed to use

For more information, see Specifying the Amount of Memory That the SAS Embedded Process Uses.

Changing the Trace Level

You can modify the level of tracing by changing the value of the sas.ep.server.trace.level property in the ep-config.xml file. The default value is 4 (TRACE_NOTE).

<property>
   <name>sas.ep.server.trace.level</name>
   <value>trace-level</value>
</property>

The trace-level represents the level of trace that is produced by the SAS Embedded Process. trace-level can be one of the following values:

0

TRACE_OFF

1

TRACE_FATAL

2

TRACE_ERROR

3

TRACE_WARN

4

TRACE_NOTE

5

TRACE_INFO

10

TRACE_ALL

Note: Tracing requires that an /opt/SAS directory to exist on every node of the cluster when the SAS Embedded Process is installed. If the folder does not exist or does not have Write permission, the SAS Embedded Process job fails.

Specifying the Number of MapReduce Tasks

You can specify the number of SAS Embedded Process MapReduce Tasks per node by changing the sas.ep.superreader.tasks.per.node property in the ep-config.xml file. The default number of tasks is 6.

<property>
   <name>sas.ep.superreader.tasks.per.node</name>
   <value>number-of-tasks</value>
</property>

Specifying the Amount of Memory That the SAS Embedded Process Uses

You can specify the amount of memory in bytes that the SAS Embedded Process is allowed to use with MapReduce 1 by changing the sas.ep.max.memory property in the ep-config.xml file. The default value is 2147483647 bytes.

<property>
   <name>sas.ep.max.memory</name>
   <value>number-of-bytes</value>
</property>

Note: This property is valid only for Hadoop distributions that are running MapReduce 1.

If your Hadoop distribution is running MapReduce 2, this value does not supersede the YARN maximum memory per task. Adjust the YARN container limit to change the amount of memory that the SAS Embedded Process is allowed to use.