EBS connector logging

Remote Logging for EBS 12.2 connector adds the following options to provide enhanced logging:

  • Log levels: INFO (default) and DEBUG.

  • Maximum active log file size (logFileSize, in MB).

  • Log retention/rotation (retention).

  • Custom environment variables via the [ENV_VARIABLES] stanza is only available in plugin version 2026.1.0 or later

It will provide full details on how to edit the ebs_plugin.conf file on the remote target host:

  • DBTechStack:

    <Toolkit directory>/<Delphix_COMMON*>/plugin/ebs122-vsdk-db_9f7f5a63-1da7-495c-80df-e0fa61941342/ebs_plugin.conf

  • AppsTier:

    <Toolkit directory>/<Delphix_COMMON*>/plugin/ebs122-vsdk-app_403e7034-0028-4200-ad0b-15031f0f8871/ebs_plugin.conf

Setting log levels (level)

You can set log levels for connector-generated logs by setting the parameter level in the ebs_plugin.conf file. Higher logging levels will help to expedite debugging issues. There are two levels of logging: info and debug.

Log level description

  • level=INFO: This level will print only informational logs. This is the default log level.

  • level=DEBUG: This level will print informational logs and debug statements.

Setting maximum size of active log file (logFileSize)

You can set this parameter inside the ebs_plugin.conf file to set the maximum size of the active log file in MB. Once this limit is reached, the connector rotates the log as per the retention property defined below. The minimum value of this parameter is 1 MB and the maximum value is 10 MB. This parameter only takes in a positive integer value. The default value is 1 MB.

Setting log retention levels (retention)

You can set a retention level for diag logs (diag.log) using parameter retention in the ebs_plugin.conf file. As per this parameter, the log files are moved (archived), renamed, or deleted once they reach the value set in the logFileSize parameter. New incoming log data is directed into a new fresh file (at the same location).

By default, this value will be set to a minimum value of 2. The user can change this value and set its value within the range 2 and 50. For example; if retention is set to 4, the connector will have the following log files: diag.log, diag.log.1, diag.log.2, diag.log.3,and diag.log.4.

  • The diag.log is the active log file.

  • The diag.log.1 is the most recent archive log file.

  • The diag.log.4 is the oldest one file.

Set custom environment variables

The new Set custom environment variables section will include the [ENV_VARIABLES] stanza, which allows users to:

  • Source existing environment files.

  • Set JVM options (for example, CONFIG_JVM_ARGS, USER_MEM_ARGS).

  • Configure application-specific variables (for example, ORACLE_UNQNAME, TWO_TASK).

  • Set locale/character-set variables (for example, NLS_LANG).

These environment variables are exported and logged before adcfgclone runs in the EBS provisioning/refresh workflow, improving flexibility and troubleshooting. This stanza allows to address the need to set custom environment variables prior to executing the adcfgclone job/utility in the EBS provisioning/refresh workflow. A solution is implemented by adding support for an [ENV_VARIABLES] section in the ebs_plugin.conf file, allowing users to specify environment variables that are automatically exported before running adcfgclone, with full logging for visibility.

If the [ENV_VARIABLES] section is missing or empty, the system logs appropriate informational messages and proceeds without custom environment variables.

ebs_plugin.conf file

Copy 
[plugin_logging_parameters]
#
# This flag will set the debug level of plugin logs on the remote
server. There are two levels:
# Info
# Debug
# The above are the only valid values that can be assigned. If any other value is assigned, the plugin will set the
# default level as Info. The string is case insensitive so info, Info and INFO are acceptable.
#
level=INFO
#
# This parameter will set the maximum size of the active log file in MB. Once this limit is reached, the plugin will
# rotate the log as per the retention property defined below. The minimum value of this parameter is 1 MB and maximum
# value is 10 MB. This parameter only takes in a positive integer value. The default value is 1 MB
# logFileSize=<positive integer>#
logFileSize=1
#
# Whenever the size of diag.log file exceeds the value provided by logFileSize parameter then the plugin will
# rename the active log file to diag.log.<number> and a new log file with name diag.log will be
# generated. For example, if LogRetention is set to 4, the plugin will have the following log files: diag.log,
# diag.log.1, diag.log.2, diag.log.3, diag.log.4.
# File diag.log.4 will be the oldest one.
# File diag.log.1 will be the most recent archive log file.
# File diag.log will be the active log file.
# The minimum and default value for the retention flag is 2.
# retention=<positive integer>
retention=2
#
# Environment Variables Configuration:
# Add environment variable exports or source commands under [ENV_VARIABLES] stanza
# to set custom JVM options, memory settings, or other environment variables needed
# by the EBS application during adcfgclone execution.
#
# Important Notes:
# - Commands will be executed in the order listed
# - Lines starting with # are ignored as comments
# - Empty lines are ignored
# - Commands are executed before adcfgclone script execution
# - Use proper shell syntax for exports and source commands
#
# Common Usage Patterns:
# 1. Source existing environment file:
#    source /u02/ebs.env
#
# 2. Set custom JVM memory options:
#    export CONFIG_JVM_ARGS="-Xmx4096m -Xms1024m -XX:MaxPermSize=1024m"
#    export USER_MEM_ARGS="-XX:PermSize=256m -XX:MaxPermSize=512m"
#
# 3. Set application-specific variables:
#    export ORACLE_UNQNAME=ERPDB
#    export TWO_TASK=ERPDB
#
# 4. Configure locale and character set:
#    export NLS_LANG=AMERICAN_AMERICA.AL32UTF8
#
# Example Configuration:
# [ENV_VARIABLES]
# source /u02/ebs.env
# export CONFIG_JVM_ARGS="-Xmx4096m -Xms1024m -XX:MaxPermSize=1024m -XX:-UseGCOverheadLimit"
# export USER_MEM_ARGS="-XX:PermSize=256m -XX:MaxPermSize=512m"

[ENV_VARIABLES]
# Uncomment and modify the examples below as needed:
# source /u02/ebs.env
# export CONFIG_JVM_ARGS="-Xmx4096m -Xms1024m"