Skip to main content
CollegeSource Production

OAS, Configure log4j for Connector Logging

This page addresses the required steps for configuring the log4j.properties file

CollegeSource recommends using the log4j.properties file instead of the log4j.xml file due to it's simplified format. NOTE: Either file may be used.

The configuration steps for the log4j.xml file are on the OAS, Steps for log4j.xml Configuration page.

Permissions on Files and Directories

The Operating System owner (i.e., executor) of the OAS java process must have the following permissions:

  • Execute and Read permission for all directories in the fullpath to the log4j.properties file
  • Execute, Write, and Read permission for all directories in the fullpath to the ceg4.log file

Configuring log4j

1. Create Directories

The log4j.properties file and ceg4.log file must reside in different directories.

 

a. Create directory for the log4j.properties file

b.Create directory for the ceg4.log file

2. Download log4j.properties
3. Copy the log4j.properites to the desired directory
4. Edit log4j.properties with a text editor
5. Revise log4j.appender.fileout.File lines

a. Comment the line that contains java.io.tmpdir to look like the following:

#log4j.appender.fileout.File=${java.io.tmpdir}ceg4.log

b. Uncomment the line that contains directoryxy and replace directoryxy with the directory you created above in step 1.a.

log4j.appender.fileout.File=/your/new/dir/ceg4.log

6. Save your changes

java.io.tmpdir

Java guarantees a temporary directory that is identified by the java.io.tmpdir System property. Many java runtimes default this location to the Linux /tmp or Windows C:\TEMP directory, however OAS does NOT.
For this reason, CollegeSource recommends following Step 5 above to ensure the ceg4.log is created in a known directory of your choosing.

  • Was this article helpful?