9.4.4.1 Common Properties
The following properties are common to Java Delivery using either Replicat or Extract.
Parent topic: Java Delivery Properties
9.4.4.1.1 Logging Properties
Logging is controlled by the following properties.
Parent topic: Common Properties
9.4.4.1.1.1 gg.log
Specifies the type of logging that is to be used. The default implementation for the
Oracle GoldenGate for Big Data is the jdk
option. This is the
built-in Java logging called java.util.logging
(JUL
). The other logging options are log4j
or
logback
.
For example, to set the type of logging to log4j
:
gg.log=log4j
The recommended setting is log4j
. The log file is created in the dirrpt
subdirectory of the installation. The default log file name includes the group name of the associated Extract
and the file extension is .log
.
<process name>_<log level>
_log4j.log
Therefore if the Oracle GoldenGate Replicat process is called javaue
, and the gg.log.level
is set to debug
, the resulting log file name will be:
javaue_debug_log4j.log
Parent topic: Logging Properties
9.4.4.1.1.2 gg.log.level
Specifies the overall log level for all modules. The syntax is:
gg.log.level={ERROR|WARN|INFO|DEBUG|TRACE}
The log levels are defined as follows:
-
ERROR
– Only write messages if errors occur -
WARN
– Write error and warning messages -
INFO
– Write error, warning and informational messages -
DEBUG
– Write all messages, including debug ones. -
TRACE
- Highest level of logging, includes all messages.
The default logging level is INFO
. The messages in this case will be produced on startup, shutdown and periodically during operation. If the level is switched to DEBUG
, large volumes of messages may occur which could impact performance. For example, the following sets the global logging level to INFO
:
# global logging level gg.log.level=INFO
Parent topic: Logging Properties
9.4.4.1.1.3 gg.log.file
Specifies the path to the log file. The syntax is:
gg.log.file=path_to_file
Where the path_to_file
is the fully defined location of the log file. This allows a change to the name of the log, but you must include the Replicat name if you have more than one Replicat to avoid one overwriting the log of the other.
Parent topic: Logging Properties
9.4.4.1.1.4 gg.log.classpath
Specifies the classpath to the JARs used to implement logging. This configuration property is not typically used as the ggjava.jar
library includes the required logging dependency libraries.
gg.log.classpath=path_to_jars
Parent topic: Logging Properties
9.4.4.1.2 JVM Boot Options
The following options configure the Java Runtime Environment. Java classpath and memory options are configurable.
Parent topic: Common Properties
9.4.4.1.2.1 jvm.bootoptions
Specifies the initial Java classpath and other boot options that will be applied when the JVM starts. The java.class.path
needs colon (:) separators for UNIX/Linux and semicolons (;) for Windows. This is where to specify various options for the JVM, such as initial and maximum heap size and classpath; for example:
-
-Xms: initial java heap size
-
-Xmx: maximum java heap size
-
-
Djava.class.path: classpath specifying location of at least the main application JAR,ggjava.jar
. Other JARs, such as JMS provider JARs, may also be specified here as well; alternatively, these may be specified in the Java application properties file. If using a separatelog4j
properties file then the location of the properties file must be included in thebootoptions
java.class.path
included in the bootoptions variable. -
-verbose:jni: run in verbose mode (for JNI)
For example (all on a single line):
jvm.bootoptions= -Djava.class.path=ggjava/ggjava.jar -Dlog4j.configuration=my-log4j.properties -Xmx512m
The log4j.configuration
property identifies a log4j properties file that is resolved by searching the classpath. You may use your own log4j configuration, or one of the preconfigured log4j settings: log4j.properties
(default level of logging), debug-log4j.properties
(debug logging) or trace-log4j.properties
(very verbose logging). To use log4j
logging with the Replicat
process gg.log=log4j
must be set.
Use of the one of the preconfigured log4j settings does not require any change to the classpath since those files are already included in the classpath. The -Djava.class.path
variable must include the path to the directory containing a custom log4j configuration file without the * wild card appended.
Parent topic: JVM Boot Options