bencleric/coherence-cli

The Coherence command line interface (CLI) 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.

---

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 complements and provides a lightweight and scriptable alternative.

Why use the Coherence CLI?

The CLI complements 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 the latest Coherence Community Edition (CE) versions
• Retrieve thread dumps across members

Install the CLI

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

• 22.09
• 22.06.x
• 21.12.x
• 14.1.1-0-10
• 14.1.1-0-9

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
• 14.1.1.2206.x Feature Pack

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!"