{"id":18554243,"url":"https://github.com/oracle/coherence-cli","last_synced_at":"2025-04-09T23:31:04.798Z","repository":{"id":37674578,"uuid":"440278944","full_name":"oracle/coherence-cli","owner":"oracle","description":"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.","archived":false,"fork":false,"pushed_at":"2024-10-30T02:10:30.000Z","size":3625,"stargazers_count":15,"open_issues_count":0,"forks_count":10,"subscribers_count":8,"default_branch":"main","last_synced_at":"2024-10-30T04:58:21.473Z","etag":null,"topics":["cli","cli-tool","coherence","coherence-ce","management","monitoring","oracle"],"latest_commit_sha":null,"homepage":"https://oracle.github.io/coherence-cli/docs/latest","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"upl-1.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oracle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-20T19:06:27.000Z","updated_at":"2024-10-30T02:10:27.000Z","dependencies_parsed_at":"2023-10-12T07:32:59.341Z","dependency_job_id":"7b34a7d5-2f24-4d21-8a07-bf46dffc64c0","html_url":"https://github.com/oracle/coherence-cli","commit_stats":{"total_commits":327,"total_committers":7,"mean_commits":"46.714285714285715","dds":0.02752293577981646,"last_synced_commit":"79711c6dda1f50d8d345e5e41189a09ed9ee0600"},"previous_names":[],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fcoherence-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fcoherence-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fcoherence-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oracle%2Fcoherence-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oracle","download_url":"https://codeload.github.com/oracle/coherence-cli/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248129587,"owners_count":21052599,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","cli-tool","coherence","coherence-ce","management","monitoring","oracle"],"created_at":"2024-11-06T21:20:35.560Z","updated_at":"2025-04-09T23:31:04.787Z","avatar_url":"https://github.com/oracle.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nCopyright (c) 2021, 2025 Oracle and/or its affiliates.\nLicensed under the Universal Permissive License v 1.0 as shown at\nhttps://oss.oracle.com/licenses/upl.\n--\u003e\n\n-----\n![logo](docs/images/logo-with-name.png)\n\n![Coherence CI](https://github.com/oracle/coherence-cli/workflows/CI/badge.svg?branch=main)\n[![License](http://img.shields.io/badge/license-UPL%201.0-blue.svg)](https://oss.oracle.com/licenses/upl/)\n\n[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=oracle_coherence-cli\u0026metric=alert_status)](https://sonarcloud.io/summary/new_code?id=oracle_coherence-cli)\n[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=oracle_coherence-cli\u0026metric=security_rating)](https://sonarcloud.io/summary/new_code?id=oracle_coherence-cli)\n\n[![Go Report Card](https://goreportcard.com/badge/github.com/oracle/coherence-cli)](https://goreportcard.com/report/github.com/oracle/coherence-cli)\n![GitHub release (latest by date)](https://img.shields.io/github/v/release/oracle/coherence-cli)\n\n# Coherence Command Line Interface (CLI)\n\n![Coherence Demo](assets/cohctl-terminal.gif \"Coherence CLI Demo\")\n\n## Contents\n\n* [Overview](#overview)\n* [Why use the Coherence CLI?](#why-use-the-coherence-cli)\n* [Install the CLI](#install-the-cli)\n* [Getting Started](#getting-started)\n* [Supported Coherence Versions](#supported-coherence-versions)\n* [Get Involved](#need-more-help-have-a-suggestion-come-and-say-hello)\n\n## Overview \n\nThe Coherence command line interface, `cohctl`, is a lightweight tool, in the tradition of tools such as kubectl,\nwhich can be scripted or used interactively to manage and monitor Coherence clusters. You can use `cohctl` to view cluster information\nsuch as services, caches, members, etc, as well as perform various management operations against clusters.\n\nThe CLI accesses clusters using the HTTP Management over REST interface and therefore requires this to be enabled on any clusters\nyou want to monitor or manage. See the [Coherence Documentation](https://docs.oracle.com/en/middleware/fusion-middleware/coherence/14.1.2/rest-reference/index.html)\nfor more information on setting up Management over REST.\n\nNOTE: The CLI does not replace current management and monitoring tools such as the [Coherence VisualVM Plugin](https://github.com/oracle/coherence-visualvm),\n[Enterprise Manager](https://docs.oracle.com/cd/E24628_01/install.121/e24215/coherence_getstarted.htm#GSSOA10121), or [Grafana Dashboards](https://oracle.github.io/coherence-operator/docs/latest/#/docs/metrics/040_dashboards), but complements and\nprovides a lightweight and scriptable alternative.\n\n## Why use the Coherence CLI?\n\nThe CLI complements your existing Coherence management tools and allows you to:\n\n* Interactively monitor your Coherence clusters from a lightweight terminal-based interface\n* Monitor service \"StatusHA\" during rolling restarts of Coherence clusters\n* Script Coherence monitoring and incorporate results into other management tooling\n* Output results in various formats including text, JSON and utilize JsonPath to extract attributes of interest\n* Gather information that may be useful for Oracle Support to help diagnose issues\n* 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](https://github.com/oracle/coherence) (CE) versions\n* Retrieve thread dumps across members\n* Create, start and scale development clusters (experimental)\n\n## Install the CLI\n\nThe Coherence CLI is available for macOS, Linux and Windows for x86 and Arm based processors.\n\n### Mac / Linux\n\nFor macOS and Linux platforms, use the following to install the latest version of the CLI:\n\n```bash\ncurl -sL https://raw.githubusercontent.com/oracle/coherence-cli/main/scripts/install.sh | bash\n```\n\n\u003e Note: On linux, `sudo` is required to copy `cohctl` to the destination directory `/usr/local/bin/`\n\n### Windows\n\nFor Windows, use the curl command below, then copy `cohctl.exe` to a directory in your PATH:\n\n```cmd\ncurl -sLo cohctl.exe \"https://github.com/oracle/coherence-cli/releases/download/1.9.0/cohctl-1.9.0-windows-amd64.exe\"\n```\n\n\u003e Note: Change the **amd64** to **arm** for ARM based processor in the URL above.\n\nSee the [Install guide](https://docs.coherence.community/coherence-cli/docs/latest/docs/installation/installation) for\nmore information on downloading and installing the CLI.\n\n## Getting Started\n\nDocumentation for the Coherence CLI is available [here](https://docs.coherence.community/coherence-cli/docs/latest)\n\nThe fastest way to experience the Coherence CLI is to follow the\n[Quick Start guide](https://docs.coherence.community/coherence-cli/docs/latest/docs/about/quickstart).\n\n## Supported Coherence Versions\n\nThe CLI supports and is certified against the following Community and Commercial editions of Coherence:\n\n**Coherence Community Edition**\n* 24.09+\n* 22.06+\n* 14.1.2-0-+\n\n\u003e Note: As CE 14.1.2-0-0 is out, CE 14.1.1-0+ is no longer supported or tested. Please use CE 14.1.2-0+\n\n**Coherence Grid/ Enterprise Edition**\n* 12.2.1.4.x - minimum patch level of 12.2.1.4.10+ required\n* 14.1.1.0.x - minimum patch level of 14.1.1.0.5+ required\n* 14.1.1.2206.x Feature Pack\n* 14.1.2.0.x\n\n\u003e 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\n\u003e is always recommended to upgrade to the latest Coherence patch as soon as you are able to.\n\n## Need more help? Have a suggestion? Come and say \"Hello!\"\n\nWe have a **public Slack channel** where you can get in touch with us to ask questions about using the Coherence CLI\nor give us feedback or suggestions about what features and improvements you would like to see. We would love\nto hear from you. To join our channel,\nplease [visit this site to get an invitation](https://join.slack.com/t/oraclecoherence/shared_invite/enQtNzcxNTQwMTAzNjE4LTJkZWI5ZDkzNGEzOTllZDgwZDU3NGM2YjY5YWYwMzM3ODdkNTU2NmNmNDFhOWIxMDZlNjg2MzE3NmMxZWMxMWE).  \nThe invitation email will include details of how to access our Slack\nworkspace.  After you are logged in, please come to `#coherence-cli` and say, \"hello!\"\n\n## Contributing\n\nThis project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)\n\n## Security\n\nPlease consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process\n\n## License\n\nCopyright (c) 2021, 2024 Oracle and/or its affiliates.\n\nReleased under the Universal Permissive License v1.0 as shown at\n\u003chttps://oss.oracle.com/licenses/upl/\u003e.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Fcoherence-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foracle%2Fcoherence-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foracle%2Fcoherence-cli/lists"}