A System Log and Configuration Files

This appendix provides the names and locations of the Oracle RTD log and configuration files. To ensure the integrity of the information in these files, you should use operating system or other tools to set the appropriate file permissions on the parent directories that contain these files, so that an intruder cannot access them.

This section contains the following topics:

A.1 Encoding for Localized Characters

In order for localized characters (such as inline service choice or attribute names) to display properly in the log files, these files should have UTF-8 encoding. Add the JVM environment variable file.encoding=utf8 (for example, -Dfile.encoding=utf8) to the JVM configuration either by adding the statement to the server startup script or by invoking the parameters at JVM startup.

A.2 Log Files

Oracle RTD provides both server and client logs. In addition, there are log files specific to Eclipse and application servers.

This section contains the following topics:

A.2.1 Main Oracle RTD Log Files

Table A-1 shows the two main Oracle RTD log files. The Oracle RTD Server log is the main log to use for troubleshooting problems.

Table A-1 Main Oracle RTD Logs

Log Type Default Location

Oracle RTD Server log

RTD_RUNTIME_HOME/log/INSTANCE_NAME_rtd_server.log

Oracle RTD Client log

RTD_HOME/log/client.log


where:

  • RTD_HOME is the directory into which you extract the Oracle RTD files during installation.

  • RTD_RUNTIME_HOME is the directory into which you install runtime Oracle RTD.

The directory RTD_RUNTIME_HOME is application server dependent, as shown in Table A-2.

Table A-2 Application Server Specific RTD_RUNTIME_HOME Directories

Application Server RTD_RUNTIME_HOME Directory

WebSphere

WEBSPHERE_HOME/AppServer/profiles/profile_name/installedApps/host_node_cell_name/OracleRTD.ear/

WebLogic

MW_HOME/user_projects/domains/domain_name/servers/server_name/stage/OracleRTD/


Setting Logging Levels for the Oracle RTD Server Log

To change logging options for the Oracle RTD Server log, use JConsole. See Section 11.4.8, "About OracleRTD > Cluster > Cluster Properties" and Section 11.4.20, "About OracleRTD > Local Node > Node Properties" for more information.

Error Messages and Exceptions in Oracle RTD Log Files

For exception messages that appear in Oracle RTD log files, see Appendix B, "Exceptions".

For error messages that may occur during Inline Service development, see Appendix A, "Development Error Messages" in Oracle Real-Time Decisions Platform Developer's Guide.

A.2.2 Log Files for Oracle RTD Client Tools

In addition to the Oracle RTD Client log, Oracle RTD maintains the following client tool log files:

  • RTD_HOME/scripts/SDDBTool.log

  • RTD_HOME/log/loadgen.csv

A.2.3 Server-Side Application Server Specific Log Files

This section lists the server-side log files specific to the application servers supported by Oracle RTD.

A.2.3.1 Server-Side Log Files for WebSphere

WEBSPHERE_HOME/AppServer/profiles/profile_name/logs/server1/startServer.log
WEBSPHERE_HOME/AppServer/profiles/profile_name/logs/server1/stopServer.log
WEBSPHERE_HOME/AppServer/profiles/profile_name/logs/server1/SystemOut.log
WEBSPHERE_HOME/AppServer/profiles/profile_name/logs/server1/SystemErr.log
WEBSPHERE_HOME/AppServer/profiles/profile_name/logs/fdcc/server1/
server1_*.txt (error logs)

A.2.3.2 Server-Side Log Files for WebLogic

MW_HOME/user_projects/domains/domain_name/servers/server_name/logs/
server_name.log
MW_HOME/user_projects/domains/domain_name/servers/server_name/logs/
server_name.out

The file server.log contains all the Oracle RTD log information as well as additional server log information.

A.2.4 Eclipse Log File

Log information specific to Eclipse can be found in the Eclipse log, located at:

  • Studio_Workspace\.metadata\.log

where Studio_Workspace is user-configurable from Version 3.0 onwards. In general, the default location for Studio_Workspace is C:\Users\ <windows_user_name>\Oracle RTD Studio\ .For example, C:\Users\jsmith\Oracle RTD Studio\.metadata\.log.

Setting Logging Levels for Eclipse

To set the logging levels for Eclipse, edit the following file:

RTD_HOME\eclipse\plugins\com.sigmadynamics.studio_3.2.0.0.0\etc\eclipse-log.properties

To adjust logging levels, set the values to true or false. The default settings are as follows:

  • debug=false

  • info=true

  • warn=true

  • error=true

  • fatal=true

  • trace=false

A.3 Configuration Files

This section lists the configuration files specific to the application servers supported by Oracle RTD.

Oracle RTD Configuration Files for WebSphere

WEBSPHERE_HOME/AppServer/profiles/profile_name/installedApps/host_node_cell_name/
OracleRTD.ear/etc/sdconfig.xml
WEBSPHERE_HOME/AppServer/profiles/profile_name/installedApps/host_node_cell_name/
OracleRTD.ear/etc/sdlog4j.xml

Oracle RTD Configuration Files for WebLogic

MW_HOME/user_projects/domains/domain_name/servers/server_name/stage/OracleRTD/etc/sdconfig.xml
MW_HOME/user_projects/domains/domain_name/servers/server_name/stage/OracleRTD/etc/sdlog4j.xml