Configuring the Dynamic Logging Functionality

Applies to: All versions of Ephesoft Transact

The following steps describe how to use the dynamic logging feature in Ephesoft Transact. These steps vary by version:

Ephesoft Transact 2019.2 and Above

Note: Starting with 2019.2, JMX connections are disabled. Perform the following steps to dynamically change log levels:

  1. Open the Task Manager.
  2. Locate the process ID (PID) for EphesoftTransact. In the example below, the PID is 1696.

Figure 1. Task Manager

  1. Open the command prompt.
  2. Go to the following directory:
C:\Ephesoft\Dependencies\jdk\bin
  1. Enter the following command to open JConsole:
jconsole processID

Figure 2. Command Prompt

  1. Confirm that the JConsole connection is successful.

Figure 3. Java Management Console

Ephesoft Transact 4.5.0.0 to 2019.1

  1. Open the JConsole utility, located at [Ephesoft_Directory]\Dependencies\jdk\bin.
  2. Select Remote Process.

Figure 4. New Connection

  1. In the text field, enter “<ServerIP>:8900”. For example, if your server IP address is 172.19.128.92, enter “172.19.128.92:8900”.
  2. Click Connect.

Once you have successfully connected to the Ephesoft JMX port, the following window will appear:

Figure 5. Connection Window

  1. Select the MBeans tab.
  2. In the left-tree, go to org.apache.logging.log4j2 > /dcma > Loggers.

Figure 6. MBeans Tab

  1. To get the current log level for a logger, expand the corresponding logger node, and select Attributes. In the Level field, the current logging level is displayed.

Figure 7. Error Level

  1. To set the log level for a logger, click the level Value to edit the entry and hit ENTER to save your changes.

Note: Alternatively, you can expand the Attributes node and set the logging level from the Level section.

Figure 8. Info Level

Figure 9. Expand Attributes

Ephesoft Transact prior to 4.5.0.0

  1. Open the JConsole utility, located at [Ephesoft_Directory]\Dependencies\jdk\bin.
  2. Select Remote Process.

Figure 10. New Connection

  1. In the text field, enter “<ServerIP>:8900”. For example, if your server IP address is 172.19.128.92, enter “172.19.128.92:8900”.
  2. Click Connect.

Once you have successfully connected to the Ephesoft JMX port, the following window will appear:

Figure 11. Connection Window

  1. Select the MBeans tab.
  2. Expand the Ephesoft tree node.

Figure 12. MBeans Tab

  1. Go to logging > config > Attributes > loggers. This displays all the loggers available in Ephesoft Transact.
  2. To view or set the logging level for a specific logger, go to logging > config > Operations.

Figure 13. MBeans Operations

  1. To retrieve the log level:
    1. Enter the logger name in the text box.
    2. Click getLogLevel.
    3. A popup will appear with the log level information..

Figure 14. Info Level

  1. To set the log level:
    1. Enter the logger name in the p0 field and the log level in the p1 field.
    2. Click setLogLevel.
    3. A popup will appear with the message “Method successfully invoked”.

Figure 15. Success Message