Coherence CLI - 1.7.1

Introduction

This is release 1.7.1 of the Coherence Command Line Interface (CLI).

For more information, see the README.

Installing

See here for installation instructions.

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Getting Started

To get started, visit the Coherence CLI documentation and follow the instructions to install and start using the CLI.

Updates / Changes

• Change the default for monitor cluster to be to display padding on
• Update various dependencies including cobra
• Update default CE version to be 22.06.9

Dependency Updates

• Update to build with Go 1.21
• Update certification checks to include latest CE and commercial versions

Bug Fixes

• Fixed the CLI to correctly honour environment variables for setting proxy servers - see documentation for more information

Known Issues

• If you use the new command completion for services or caches that contain a $, then the completion may not work correctly

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Full Change List

Full Changelog: 1.7.0...1.7.1

Coherence CLI - 1.7.0

Coherence CLI Release 1.7.0

Introduction

This is release 1.7.0 of the Coherence Command Line Interface (CLI).

For more information, see the README.

Installing

See here for installation instructions.

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Getting Started

To get started, visit the Coherence CLI documentation and follow the instructions to install and start using the CLI.

New Features / Changes

• Added experimental cohctl monitor cluster command to view multiple panels with different information using a text based UI. See the documentation for more information
• Added the -F option to the start cluster or create cluster to specify to only use the specified profile on the first member started
• Added the -B option to backup the log files when starting a new cluster
• Added the ability to specify TLS environment variables to configure TLS connections see the documentation for more information
• Added the -I option to cohctl monitor health to ignore any errors

Dependency Updates

• Added tests to run TLS
• Update privy scan version

Bug Fixes

• N/A

Known Issues

• If you use the new command completion for services or caches that contain a $, then the completion may not work correctly

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Full Change List

• Prepare for next release by @tmiddlet2666 in #182
• Remove deprecated set-output command by @tmiddlet2666 in #183
• Add -F option to specify to only use the specified profile on the fir… by @tmiddlet2666 in #184
• Dump logs on container failure startup by @tmiddlet2666 in #187
• Update all tests to dump logs by @tmiddlet2666 in #188
• more log debug by @tmiddlet2666 in #189
• Monitor cluster prototype by @tmiddlet2666 in #186
• Fixup workflow error by @tmiddlet2666 in #190
• Add proxy-connections by @tmiddlet2666 in #191
• Add option to backup coherence logs before startup by @tmiddlet2666 in #192
• Update backlog variable for topics by @tmiddlet2666 in #193
• Add show-panels in help by @tmiddlet2666 in #194
• Minor updates by @tmiddlet2666 in #195
• Optimizations for data retreival and addition of basic expect test by @tmiddlet2666 in #196
• Enable TLS tests by @tmiddlet2666 in #197
• Minor changes to tls messages by @tmiddlet2666 in #198
• Minor update to deps by @tmiddlet2666 in #199
• Add -I option to ignore health errors by @tmiddlet2666 in #200
• Minor update to docs and coherence-go-client version by @tmiddlet2666 in #201
• Update trivy version by @tmiddlet2666 in #202
• Minor health command update by @tmiddlet2666 in #203
• Minor update to monitor health output by @tmiddlet2666 in #204

Full Changelog: 1.6.1...1.7.0

Coherence CLI - 1.6.1

Coherence CLI Release 1.6.1

Introduction

This is release 1.6.1 of the Coherence Command Line Interface (CLI).

For more information, see the README.

Installing

See here for installations instructions.

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Getting Started

To get started, visit the Coherence CLI documentation and follow the instructions to install and start using the CLI.

New Features / Changes

• Added cohctl monitor health to display health endpoint health status for rolling upgrades
• When creating a cluster, save the start class if its changed by the -S option
• Add Coherence Helidon start class
• Updated to use latest 22.06.8 release as default

Dependency Updates

• Update various GitHub actions
• Update CI/CD versions to include 22.06.8

Bug Fixes

• N/A

All changes since 1.6.0 - 1.6.0...1.6.1

Known Issues

• If you use the new command completion for services or caches that contain a $, then the completion may not work correctly

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Coherence CLI - 1.6.0

Introduction

This is release 1.6.0 of the Coherence Command Line Interface (CLI).

For more information, see the README.

Installing

See here for installations instructions.

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Getting Started

To get started, visit the Coherence CLI documentation and follow the instructions to install and start using the CLI.

New Features / Changes

• Added -B option to cohctl get service-members to only show members with task backlog > 0
• Added additional color formatting to cohctl get services
• Added cohctl get view-caches and cohctl describe view-caches commands. Only supported against CE 24.03+, but will be available in future patches for other CE and commercial versions
• Added retries to cohctl describe federation wide option - only available in the latest Coherence Grid Edition patches
• Added cohctl get cache-partitions to view cache partition information regarding a cache. Only supported in CE 24.03+, but will be available in future patches for other CE and commercial versions
• Added the -e option to create , start and scale cluster to set the starting health port
• Added the ability to specify a cache config and override file on create cluster
• Added the -J option to start a JMX remote management port on the management member

Dependency Updates

• Bump version of jline to 3.25.0
• Bump version of coherence-go-client to v1.1.1
• Bump version of cobra to v1.8.0

Bug Fixes

• Fixed an issue where cohctl get persistence may fail if you have a view cache defined

All changes since 1.5.3 - 1.5.3...1.6.0

Known Issues

• If you use the new command completion for services or caches that contain a $, then the completion may not work correctly

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Coherence CLI - 1.5.3

Coherence CLI Release 1.5.3

Introduction

This is release 1.5.3 of the Coherence Command Line Interface (CLI).

For more information, see the README.

Installing

See here for installations instructions.

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Getting Started

To get started, visit the Coherence CLI documentation and follow the instructions to install and start using the CLI.

New Features / Changes

• Added the cohctl get cache-storage command to display cache storage information for a cache
• Added the cohctl get cache-access command to display cache access information for a cache
• Added the cohctl get cache-indexes command to display cache index information for a cache
• Added the ability to sort the output of cohctl get p2p-stats by publisher or receiver rate
• Added the ability to disable the CLI under the Coherence Operator if required by setting the env variable CLI_DISABLED=true, available in Coherence Operator 3.3.2+

Other Changes

• Updated the dependency on coherence-go-client to v1.0.3
• Updated to build with Go 1.20

All changes since 1.5.2 - 1.5.2...1.5.3

Known Issues

• If you use the new command completion for services or caches that contain a $, then the completion may not work correctly

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Coherence CLI - 1.5.2

Coherence CLI Release 1.5.2

Introduction

This is release 1.5.2 of the Coherence Command Line Interface (CLI).

For more information, see the README.

Installing

See here for installations instructions.

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Getting Started

To get started, visit the Coherence CLI documentation and follow the instructions to install and start using the CLI.

New Features / Changes

• Added cohctl get service-distributions to show scheduled partition distributions
• Added settings option to start jfr command to allow to change the settings file
• Added evictions to cohctl get caches and cohctl describe caches commands
• Update topics commands to display channel ownership (Thanks to @thegridman)
• Changed the default CE version to 22.06.6 and support CE 23.09
• The following are only available with 23.09, 22.06.6 and the latest commercial patch 14.1.1.2206.6
  • Added cohctl get service-description to show service description and members
  • Added cohctl get member-description to show member description
  • Added cohctl get cluster-description to show the cluster description and members
  • Added cohctl get cluster-config to display the operational config for a cluster. Only available with most recent versions of Coherence clusters

Bug Fixes

• Fixed an issue with connecting using VisualVM to a cluster created with the CLI. You must remove an existing cluster and re-create a cluster for this to take effect
• Fixed an issue where describe service would fail with only 1 node
• Bump golang.org/x/net from 0.8.0 to 0.17.0

All changes since 1.5.1 - 1.5.1...1.5.2

Known Issues

• If you use the new command completion for services or caches that contain a $, then the completion may not work correctly

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Coherence CLI - 1.5.1

Introduction

This is release 1.5.1 of the Coherence Command Line Interface (CLI).

For more information, see the README.

Installing

See here for installations instructions.

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Getting Started

To get started, visit the Coherence CLI documentation and follow the instructions to install and start using the CLI.

New Features / Changes

• Added cohctl truncate cache and cohctl clear cache to truncate and clear a caches contents. Only available with the most recent Coherence versions 14.1.1.2206.5 and 22.06.5 and above
• Enhanced command completion for describe commands to suggest appropriate values. E.g. cohctl describe cache - then TAB, TAB shows the list of caches in the cluster. This is also available in various other commands.
• Updated create cluster to use CE 22.06.5 as default Coherence version
• Updated Cobra version to v1.7.0

Bug Fixes

• When removing a cluster, only check for running processes if it was manually created

Known Issues

• If you use the new command completion for services or caches that contain a $, then the completion may not work correctly

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Coherence CLI - 1.5.0

Introduction

This is release 1.5.0 of the Coherence Command Line Interface (CLI).

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.

For more information, see the README.

Installing

See here for installations instructions.

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Getting Started

To get started, visit the Coherence CLI documentation and follow the instructions to install and start using the CLI.

New Features / Changes

• Added support for Coherence CE versions 23.03, 22.06.4 plus commercial versions 14.1.1.2206.4
• Topics
  • Added commands to display topics, subscribers and subscriber groups. See here for more information
• Members
  • Added cohctl get network-stats to show all member network statistic for a cluster
  • Added cohctl get p2p-stats to show point-to-point network statistics for a specific member
  • Added the -S option to get members to show a summary of members
• Services/ Caches
  • Added cohctl get service-storage to show partition storage for all services
  • Added cohctl get cache-stores to show cache store information for a cache
  • When you describe a cache or topic you no longer need to specify the service if the cache is unique
• Proxy Servers
  • Added cohctl reset proxy-stats to reset connection manager stats. Only available with recent CE releases
• Federation
  • Added cohctl set federation to set traceLogging for a federated service - (federation is only available in Grid Edition)
• General
  • Added the -W watch command to watch and clear screen for a better monitoring experience
  • Added cohctl set/get color to enable/display color formatting of important values. Default is on
  • Added cohctl get config to show config stored in the '.cohctl.yaml' config file in a human readable format
  • Added the ability to show sizes in terabytes via --tb option
• Creating Clusters
  • Changed the skip-deps short option -K on create cluster to -I
  • Changed the wka short option -W on create cluster to -K
  • Added the -L option to create cluster to specify an alternate log location
• Infrastructure
  • Update to compile using Go 1.19.6

Bug Fixes

• Fixed an issue where a nil pointer panic would occur when the users $HOME directory was not writable
• Renamed columns on get proxy-connections to better reflect the data
• Fixed an issue where describe cache would not show the key and filter listeners

Problems/ Questions

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Coherence CLI - 1.4.2

Coherence CLI Release 1.4.2

Introduction

This is patch release 1.4.2 of the Coherence Command Line Interface (CLI).

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.

This release includes a new experimental feature to create and manage local development clusters. See here for more information.

For more information, see the README.

Getting Started

To get started, visit the Coherence CLI Documentation and follow the instructions to install and start using the CLI.

Improvements/ New Features

• When creating a cluster or manually add a cluster, the context is set to the new cluster
• When removing a cluster that is the current context, the context is cleared
• Changed the default memory for cluster members to 128m
• Removed the requirement for -y on non-destructive operations such as start and scale cluster
• Added the member column to the get proxy-connections command

Fixed Issues

• Minor messages updates and code optimisations
• Fixed an issue where cohctl describe service would fail on Proxy services
• Fixed an issue where the -l log level argument was ignored
• Fixed and issue where ram journal information is not displayed in describe cluster

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Problems/ Questions

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.

Coherence CLI - 1.4.1

Coherence CLI Release 1.4.1

Introduction

This is release 1.4.1 of the Coherence Command Line Interface (CLI).

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.

This release includes a new experimental feature to create and manage local development clusters. See here for more information.

For more information, see the README.

Getting Started

To get started, visit the Coherence CLI Documentation and follow the instructions to install and start using the CLI.

Improvements/ New Features

• Added the get service-members command to show members thread utilization/ backlog
• Added the cohctl get proxy-connections command to show proxy connections
• Added the cohctl reset command to reset various statistics by calling resetStatistics() on MBeans
• Added the ability to create and manage local development clusters - Note: this is an experimental feature only and is not supported for running production clusters. This includes the following commands:
  • cohctl create cluster
  • cohctl start cluster
  • cohctl stop cluster
  • cohctl start console / cohql / class

Fixed Issues

• Fixed an issue where task backlog was not showing correctly
• Fixed an issue where cpuLoad could not be unmarshalled from json
• Fixed an issue where alphabetical sorting of results from cohctl get commands were not always consistent
• Removed unwanted fmt.Println

Upgrading

If you already have the CLI installed, you can run cohctl version -u to see if you have the latest version.

Knowns Issues

• When describing a Proxy service using cohctl describe service an error will be returned
• When starting or creating clusters the -l log level parameter is ignored

Problems/ Questions

Please raise an issue here if you have any problems.

You can also join our public Slack Channel.