Coherence Command Line Interface (CLI)
Contents
- Overview
- Why use the Coherence CLI?
- Install the CLI
- Getting Started
- Supported Coherence Versions
- Get Involved
Overview
The Coherence command line interface, cohctl
, is a lightweight tool, in the tradition of tools such as kubectl, which can be scripted or used interactively to manage and monitor Coherence clusters. You can use cohctl
to view cluster information such as services, caches, members, etc, as well as perform various management operations against clusters.
The CLI accesses clusters using the HTTP Management over REST interface and therefore requires this to be enabled on any clusters you want to monitor or manage. See the Coherence Documentation for more information on setting up Management over REST.
NOTE: The CLI does not replace current management and monitoring tools such as the Coherence VisualVM Plugin, Enterprise Manager, or Grafana Dashboards, but compliments and provides a lightweight and scriptable alternative.
Why use the Coherence CLI?
The CLI compliments your existing Coherence management tools and allows you to:
- Interactively monitor your Coherence clusters from a lightweight terminal-based interface
- Monitor service "StatusHA" during rolling restarts of Coherence clusters
- Script Coherence monitoring and incorporate results into other management tooling
- Output results in various formats including text, JSON and utilize JsonPath to extract attributes of interest
- Gather information that may be useful for Oracle Support to help diagnose issues
- Connect to standalone or WebLogic Server based clusters from commercial versions 12.2.1.4 and above as well as all Coherence Community Edition (CE) versions
- Retrieve thread dumps across members
Install the CLI
Note: The Coherence CLI is currently in pre-release and the latest version is 1.0.0-RC1.
The Coherence CLI is available as a binary for most platforms and architectures. See the Install guide for information on downloading the CLI.
Getting Started
Documentation for the Coherence CLI is available here
The fastest way to experience the Coherence CLI is to follow the Quick Start guide.
Supported Coherence Versions
The CLI supports and is certified against the following Community and Commercial editions of Coherence:
Coherence Community Edition
- 21.12
- 21.06.x
- 20.12.2 (JFR commands are not supported)
- 14.1.1-0-x
Coherence Grid/ Enterprise Edition
- 12.2.1.4.x - minimum patch level of 12.2.1.4.7+ required
- 14.1.1.0.x - minimum patch level of 14.1.1.0.2+ required
Note: If you are on a patch set below the minimum recommended above, then CLI may work, but some functionality may not be available. It is always recommended to upgrade to the latest Coherence patch as soon as you are able to.
Need more help? Have a suggestion? Come and say "Hello!"
We have a public Slack channel where you can get in touch with us to ask questions about using the Coherence CLI or give us feedback or suggestions about what features and improvements you would like to see. We would love to hear from you. To join our channel, please visit this site to get an invitation.
The invitation email will include details of how to access our Slack workspace. After you are logged in, please come to #cli
and say, "hello!"