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
- Ephesoft Transact 4.5.0.0 to 2019.1
- Ephesoft Transact prior to 4.5.0.0
Ephesoft Transact 2019.2 and Above
Note: Starting with 2019.2, JMX connections are disabled. Perform the following steps to dynamically change log levels:
- Open the Task Manager.
- Locate the process ID (PID) for EphesoftTransact. In the example below, the PID is 1696.
Figure 1. Task Manager
- Open the command prompt.
- Go to the following directory:
C:\Ephesoft\Dependencies\jdk\bin
- Enter the following command to open JConsole:
jconsole processID
Figure 2. Command Prompt
- Confirm that the JConsole connection is successful.
Figure 3. Java Management Console
Ephesoft Transact 4.5.0.0 to 2019.1
- Open the JConsole utility, located at [Ephesoft_Directory]\Dependencies\jdk\bin.
- Select Remote Process.
Figure 4. New Connection
- 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”.
- Click Connect.
Once you have successfully connected to the Ephesoft JMX port, the following window will appear:
Figure 5. Connection Window
- Select the MBeans tab.
- In the left-tree, go to org.apache.logging.log4j2 > /dcma > Loggers.
Figure 6. MBeans Tab
- 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
- 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
- Open the JConsole utility, located at [Ephesoft_Directory]\Dependencies\jdk\bin.
- Select Remote Process.
Figure 10. New Connection
- 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”.
- Click Connect.
Once you have successfully connected to the Ephesoft JMX port, the following window will appear:
Figure 11. Connection Window
- Select the MBeans tab.
- Expand the Ephesoft tree node.
Figure 12. MBeans Tab
- Go to logging > config > Attributes > loggers. This displays all the loggers available in Ephesoft Transact.
- To view or set the logging level for a specific logger, go to logging > config > Operations.
Figure 13. MBeans Operations
- To retrieve the log level:
- Enter the logger name in the text box.
- Click getLogLevel.
- A popup will appear with the log level information..
Figure 14. Info Level
- To set the log level:
- Enter the logger name in the p0 field and the log level in the p1 field.
- Click setLogLevel.
- A popup will appear with the message “Method successfully invoked”.
Figure 15. Success Message