4.0.1

CF CLI Java Plugin 4.0.1

Plugin for profiling Java applications and getting heap and thread-dumps.

Changes

• Fix thread-dump command

Installation

Installation via CF Community Repository

Make sure you have the CF Community plugin repository configured or add it via:

cf add-plugin-repo CF-Community http://plugins.cloudfoundry.org

Trigger installation of the plugin via:

cf install-plugin -r CF-Community "java"

Manual Installation

Download this specific release (4.0.1) and install manually:

# on Mac arm64
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/4.0.1/cf-cli-java-plugin-macos-arm64
# on Windows x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/4.0.1/cf-cli-java-plugin-windows-amd64
# on Linux x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/4.0.1/cf-cli-java-plugin-linux-amd64

Or download the latest release:

# on Mac arm64
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/latest/download/cf-cli-java-plugin-macos-arm64
# on Windows x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/latest/download/cf-cli-java-plugin-windows-amd64
# on Linux x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/latest/download/cf-cli-java-plugin-linux-amd64

Note: On Linux and macOS, if you get a permission error, run chmod +x [cf-cli-java-plugin] on the plugin binary.
On Windows, the plugin will refuse to install unless the binary has the .exe file extension.

You can verify that the plugin is successfully installed by looking for java in the output of cf plugins.

Snapshot Release

This is a snapshot release of the cf-cli-java-plugin.
It includes the latest changes and is not intended for production use.
Please test it and provide feedback.

Build Timestamp: 2025-09-15 14:53:34 UTC

Installation

Download the current snapshot release and install manually:

# on Mac arm64
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/snapshot/cf-cli-java-plugin-macos-arm64
# on Windows x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/snapshot/cf-cli-java-plugin-windows-amd64
# on Linux x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/snapshot/cf-cli-java-plugin-linux-amd64

Note: On Linux and macOS, if you get a permission error, run chmod +x [cf-cli-java-plugin] on the plugin binary.
On Windows, the plugin will refuse to install unless the binary has the .exe file extension.

You can verify that the plugin is successfully installed by looking for java in the output of cf plugins.

4.0.0

CF CLI Java Plugin 4.0.0

Plugin for profiling Java applications and getting heap and thread-dumps.

Changes

• Create a proper test suite
• Fix many bugs discovered during testing
• Profiling and JCMD related features

Installation

Installation via CF Community Repository

Make sure you have the CF Community plugin repository configured or add it via:

cf add-plugin-repo CF-Community http://plugins.cloudfoundry.org

Trigger installation of the plugin via:

cf install-plugin -r CF-Community "java"

Manual Installation

Download this specific release (4.0.0) and install manually:

# on Mac arm64
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/4.0.0/cf-cli-java-plugin-macos-arm64
# on Windows x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/4.0.0/cf-cli-java-plugin-windows-amd64
# on Linux x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/download/4.0.0/cf-cli-java-plugin-linux-amd64

Or download the latest release:

# on Mac arm64
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/latest/download/cf-cli-java-plugin-macos-arm64
# on Windows x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/latest/download/cf-cli-java-plugin-windows-amd64
# on Linux x86
cf install-plugin https://github.com/SAP/cf-cli-java-plugin/releases/latest/download/cf-cli-java-plugin-linux-amd64

Note: On Linux and macOS, if you get a permission error, run chmod +x [cf-cli-java-plugin] on the plugin binary.
On Windows, the plugin will refuse to install unless the binary has the .exe file extension.

You can verify that the plugin is successfully installed by looking for java in the output of cf plugins.

Build Timestamp: 2025-07-11 13:48:56 UTC

4.0.0-rc2

Revert alias script generation

4.0.0-rc

This is the first release candidate of the 4.0.0 release under new maintainership and with new features:

• Profiling Java applications with JFR and (on SapMachine) async-profiler is supported now
• Executing JCMD commands with a few short-cuts is available

This release candidate should already be usable, but if you encounter any issues, please submit them.

3.0.3

What's Changed

• fix heap dumps on instances except 0 by @dheidemann in #31

New Contributors

• @dheidemann made their first contribution in #31

Full Changelog: 3.0.2...3.0.3

3.0.2

Rebuilt for compatibility with newer Microsoft Windows version

3.0.1

Fix version number in plugin metadata

3.0.0

New Features:

• Setting the local output of the heap dump via --local-dir
• Setting the target of the heap dump in the container via --container-dir
• If a file system service is bound to the application container heap dumps are now automatically dumped to a path on this file system service instead
• The CLI now checks whether ssh is enabled and throws a human readable error message if not
• The CLI now checks whether jvmmon or jcmd is in the application container and throws a human readable error message if not
• More detailed success and error messages (e.g., when certain preconditions are not

Breaking changes:

• Previously, heap dumps were sent to stdout and could be redirected to a local file via >. By default heap dumps are no longer redirected to stdout and not stored in the application container. If a heap dump should be forwarded to the local machine use --local-dir instead.

2.0.0

Added support the SAP Java Buildpack. Kudos to @ScheererJ :-)