Checking Ceph version information

View version information for your Ceph cluster by using the dashboard or the command line interface.

Before you begin

Before you begin, make sure that you have access to a node with connectivity to the Ceph cluster and appropriate user permissions to run Ceph commands.

About this task

The Ceph version information helps you to:

Verify your deployment version after installation or upgrade.
Confirm version consistency across cluster components.
Gather version information for support cases.
Document your environment for compliance purposes.

The Ceph Dashboard shows the product release, Ceph version, and Ceph Manager version while the command-line provides detailed version information for all daemon types.

Note: There might be version mismatches across components during upgrades. In a stable cluster, all daemons run the same version. If there are mismatches after an upgrade, contact IBM Support.

Viewing version information from the dashboard

Procedure

Log in to the Ceph Dashboard and navigate to the Overview page.

The Ceph version is displayed prominently below the cluster ID, showing the complete version string including the Ceph version number, build number, commit hash, codename, and build type.
Alternatively, you can also click the Question (?) icon in the navigation bar and then click About, to view the version details that includes product release and Ceph Manager version.
The dialog also displays information about the current user, user role, browser, and operating system.

Viewing version information from the CLI

Procedure

Log in to a node with access to the Ceph cluster.
Run the ceph version command to view the overall cluster version.

Note: This command requires Ceph admin privileges. If you encounter permission errors, contact your system administrator.
The following example shows typical output for IBM Storage Ceph 9.9.1 (V.R.M.F 9.9.1.0).
```
ceph version 20.2.1-268.el9cp (7fbeb00b438402bdc9aff7f2829e682e67a9cb88) tentacle (stable - RelWithDebInfo) release 9.9.1.0
```
To view detailed version information for each daemon type, run the ceph versions command.

Important: The ceph versions command displays the Storage Package Version (for example, 20.2.1-268.el9cp) and IBM Storage Ceph version (for example, 9.9.1.0), but does not distinguish between standard releases and CVE-specific releases that share the same version numbers. To identify the exact release including CVE releases, refer to the IBM Storage Ceph release notes or contact IBM Support.
The following example shows typical output for IBM Storage Ceph 9.9.1 (V.R.M.F 9.9.1.0).
```
{
    "mon": {
        "ceph version 20.2.1-268.el9cp (7fbeb00b438402bdc9aff7f2829e682e67a9cb88) tentacle (stable - RelWithDebInfo) release 9.9.1.0": 3
    },
    "mgr": {
        "ceph version 20.2.1-268.el9cp (7fbeb00b438402bdc9aff7f2829e682e67a9cb88) tentacle (stable - RelWithDebInfo) release 9.9.1.0": 2
    },
    "osd": {
        "ceph version 20.2.1-268.el9cp (7fbeb00b438402bdc9aff7f2829e682e67a9cb88) tentacle (stable - RelWithDebInfo) release 9.9.1.0": 16
    },
    "mds": {
        "ceph version 20.2.1-268.el9cp (7fbeb00b438402bdc9aff7f2829e682e67a9cb88) tentacle (stable - RelWithDebInfo) release 9.9.1.0": 3
    },
    "overall": {
        "ceph version 20.2.1-268.el9cp (7fbeb00b438402bdc9aff7f2829e682e67a9cb88) tentacle (stable - RelWithDebInfo) release 9.9.1.0": 24
    }
}
```
The output shows version information for each daemon type (mon, mgr, osd, mds) with the number of daemons running each version. This is particularly useful for identifying version mismatches during or after upgrades.
Understanding the version string components:
- Storage Package Version: The version string before 'release' (for example, 20.2.1-268.el9cp) represents the Storage Package Version.
- Ceph version: The version string after 'release' represents the Storage Ceph version.
- Daemon count: The number after each version string indicates how many daemons of that type are running that specific version.
Review the output to verify component versions and your product release.