Coherence CLI 1.3.0 Released

Tim Middleton
Oracle Coherence
Published in
2 min readJul 29, 2022

We are pleased to announce the latest version of the Coherence Command Line Interface (CLI) has been released!

The CLI, which has proved popular amongst Coherence users, includes the following new features and improvements.

Support for new Coherence Versions

The CLI is now certified with Coherence 14.1.1.2206 Feature Pack and Coherence Community Edition 22.06.x and includes support for the following new Coherence features:

Health Check API

The new get health command displays health information and health summary for a cluster using the new Health Check API.

Health Check API

About the new Health Check API

Coherence 14.1.1.2206 introduces a health check API to enable application code to determine the health of the local Coherence member, and corresponding HTTP and management endpoints to allow external applications to query the health of a cluster and its members. The health API also enables applications to register their own health checks, which is then included in the member’s and cluster’s health status.

Persistent Backups

The get persistence command now displays backup space disk utilization when using the new Persistent Backups feature. (This feature asynchronously writes backup copies to disk for increased availability.)

Persistent Backup Details

Changing Disk/ Memory Display Format

In this version the default for displaying disk or memory based values for command output has now been changed to bytes. This default can be changed to KB, MB or GB for individual command by using -k, -m or -g flags respectively. This makes it easier to customize how you want to display information in the CLI.

For example the -g option has been used below to set the output to GB for the get members command:

Note: The cohctl set bytes-format command can be used to change the default output format for all commands.

Federation Command Improvements

For customers using Coherence Federation, available only in Grid Edition, the get federation command displays a summary of federation information. In the example below the average of the 2 members sending data is shown:

The new version of the CLI adds the cohctl describe federation command which shows detailed node-level information for each member sending or receiving data.

Note: the -o wide option can be used to display more detailed information for each member.

Retrieve Thread Dumps via Role

It is now possible to retrieve thread dumps via specifying a specific role rather than just the node id. This can be very useful when there are a large number of cluster members.

In the example below we are retrieving thread dumps for CoherenceServer roles only.

Conclusion

The latest version of the CLI extends upon the impressive list of features and is a great tool to help you manage and monitor your Coherence clusters.

For more information on the CLI, please visit the following:

--

--