alerts send

(re)send alerts immediately

Example command:

ceph alerts send

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

balancer dump

Show an optimization plan

Example command:

ceph balancer dump my_plan

Parameters:

  • plan: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

balancer eval

Evaluate data distribution for the current cluster or specific pool or specific plan

Example command:

ceph balancer eval my_option

Parameters:

  • option: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

balancer eval-verbose

Evaluate data distribution for the current cluster or specific pool or specific plan (verbosely)

Example command:

ceph balancer eval-verbose my_option

Parameters:

  • option: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

balancer execute

Execute an optimization plan

Example command:

ceph balancer execute my_plan

Parameters:

  • plan: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer ls

List all plans

Example command:

ceph balancer ls

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

balancer mode

Set balancer mode

Example command:

ceph balancer mode none

Parameters:

  • mode: CephChoices strings=(none crush-compat upmap)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer off

Disable automatic balancing

Example command:

ceph balancer off

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer on

Enable automatic balancing

Example command:

ceph balancer on

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer optimize

Run optimizer to create a new plan

Example command:

ceph balancer optimize --plan=string --pools=string

Parameters:

  • plan: (string)

  • pools: (can be repeated)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer pool add

Enable automatic balancing for specific pools

Example command:

ceph balancer pool add --pools=string

Parameters:

  • pools: (can be repeated)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer pool ls

List automatic balancing pools. Note that empty list means all existing pools will be automatic balancing targets, which is the default behaviour of balancer.

Example command:

ceph balancer pool ls

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

balancer pool rm

Disable automatic balancing for specific pools

Example command:

ceph balancer pool rm --pools=string

Parameters:

  • pools: (can be repeated)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer reset

Discard all optimization plans

Example command:

ceph balancer reset

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer rm

Discard an optimization plan

Example command:

ceph balancer rm my_plan

Parameters:

  • plan: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

balancer show

Show details of an optimization plan

Example command:

ceph balancer show my_plan

Parameters:

  • plan: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

balancer status

Show balancer status

Example command:

ceph balancer status

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm check-host

Check whether we can access and manage a remote host

Example command:

ceph cephadm check-host my_host my_addr

Parameters:

  • host: (string)

  • addr: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm clear-exporter-config

Clear the SSL configuration used by cephadm exporter daemons

Example command:

ceph cephadm clear-exporter-config

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm clear-key

Clear cluster SSH key

Example command:

ceph cephadm clear-key

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm clear-ssh-config

Clear the ssh_config file

Example command:

ceph cephadm clear-ssh-config

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm config-check disable

Disable a specific configuration check

Example command:

ceph cephadm config-check disable my_check_name

Parameters:

  • check_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm config-check enable

Enable a specific configuration check

Example command:

ceph cephadm config-check enable my_check_name

Parameters:

  • check_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm config-check ls

List the available configuration checks and their current state

Example command:

ceph cephadm config-check ls plain

Parameters:

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm config-check status

Show whether the configuration checker feature is enabled/disabled

Example command:

ceph cephadm config-check status

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm generate-exporter-config

Generate default SSL crt/key and token for cephadm exporter daemons

Example command:

ceph cephadm generate-exporter-config

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm generate-key

Generate a cluster SSH key (if not present)

Example command:

ceph cephadm generate-key

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm get-exporter-config

Show the current cephadm-exporter configuraion (JSON)’

Example command:

ceph cephadm get-exporter-config

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm get-extra-ceph-conf

Get extra ceph conf that is appended

Example command:

ceph cephadm get-extra-ceph-conf

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm get-pub-key

Show SSH public key for connecting to cluster hosts

Example command:

ceph cephadm get-pub-key

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm get-ssh-config

Returns the ssh config as used by cephadm

Example command:

ceph cephadm get-ssh-config

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm get-user

Show user for SSHing to cluster hosts

Example command:

ceph cephadm get-user

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm osd activate

Start OSD containers for existing OSDs

Example command:

ceph cephadm osd activate --host=string

Parameters:

  • host: (can be repeated)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm prepare-host

Prepare a remote host for use with cephadm

Example command:

ceph cephadm prepare-host my_host my_addr

Parameters:

  • host: (string)

  • addr: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm registry-login

Set custom registry login info by providing url, username and password or json file with login info (-i <file>)

Example command:

ceph cephadm registry-login my_url my_username my_password

Parameters:

  • url: (string)

  • username: (string)

  • password: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

cephadm set-exporter-config

Set custom cephadm-exporter configuration from a json file (-i <file>). JSON must contain crt, key, token and port

Example command:

ceph cephadm set-exporter-config

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm set-extra-ceph-conf

Text that is appended to all daemon’s ceph.conf. Mainly a workaround, till config generate-minimal-conf generates a complete ceph.conf. Warning: this is a dangerous operation.

Example command:

ceph cephadm set-extra-ceph-conf

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm set-priv-key

Set cluster SSH private key (use -i <private_key>)

Example command:

ceph cephadm set-priv-key

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm set-pub-key

Set cluster SSH public key (use -i <public_key>)

Example command:

ceph cephadm set-pub-key

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm set-ssh-config

Set the ssh_config file (use -i <ssh_config>)

Example command:

ceph cephadm set-ssh-config

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

cephadm set-user

Set user for SSHing to cluster hosts, passwordless sudo will be needed for non-root users

Example command:

ceph cephadm set-user my_user

Parameters:

  • user: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

count

Do some counting

Example command:

ceph count 1

Parameters:

  • num: CephInt

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

crash archive

Acknowledge a crash and silence health warning(s)

Example command:

ceph crash archive my_id

Parameters:

  • id: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

crash archive-all

Acknowledge all new crashes and silence health warning(s)

Example command:

ceph crash archive-all

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

crash info

show crash dump metadata

Example command:

ceph crash info my_id

Parameters:

  • id: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

crash json_report

Crashes in the last <hours> hours

Example command:

ceph crash json_report my_hours

Parameters:

  • hours: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

crash ls

Show new and archived crash dumps

Example command:

ceph crash ls

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

crash ls-new

Show new crash dumps

Example command:

ceph crash ls-new

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

crash post

Add a crash dump (use -i <jsonfile>)

Example command:

ceph crash post

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

crash prune

Remove crashes older than <keep> days

Example command:

ceph crash prune my_keep

Parameters:

  • keep: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

crash rm

Remove a saved crash <id>

Example command:

ceph crash rm my_id

Parameters:

  • id: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

crash stat

Summarize recorded crashes

Example command:

ceph crash stat

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard create-self-signed-cert

Create self signed certificate

Example command:

ceph dashboard create-self-signed-cert

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard get-account-lockout-attempts

Get the ACCOUNT_LOCKOUT_ATTEMPTS option value

Example command:

ceph dashboard get-account-lockout-attempts

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-alertmanager-api-host

Get the ALERTMANAGER_API_HOST option value

Example command:

ceph dashboard get-alertmanager-api-host

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-alertmanager-api-ssl-verify

Get the ALERTMANAGER_API_SSL_VERIFY option value

Example command:

ceph dashboard get-alertmanager-api-ssl-verify

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-audit-api-enabled

Get the AUDIT_API_ENABLED option value

Example command:

ceph dashboard get-audit-api-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-audit-api-log-payload

Get the AUDIT_API_LOG_PAYLOAD option value

Example command:

ceph dashboard get-audit-api-log-payload

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-enable-browsable-api

Get the ENABLE_BROWSABLE_API option value

Example command:

ceph dashboard get-enable-browsable-api

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-ganesha-clusters-rados-pool-namespace

Get the GANESHA_CLUSTERS_RADOS_POOL_NAMESPACE option value

Example command:

ceph dashboard get-ganesha-clusters-rados-pool-namespace

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-grafana-api-password

Get the GRAFANA_API_PASSWORD option value

Example command:

ceph dashboard get-grafana-api-password

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-grafana-api-ssl-verify

Get the GRAFANA_API_SSL_VERIFY option value

Example command:

ceph dashboard get-grafana-api-ssl-verify

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-grafana-api-url

Get the GRAFANA_API_URL option value

Example command:

ceph dashboard get-grafana-api-url

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-grafana-api-username

Get the GRAFANA_API_USERNAME option value

Example command:

ceph dashboard get-grafana-api-username

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-grafana-frontend-api-url

Get the GRAFANA_FRONTEND_API_URL option value

Example command:

ceph dashboard get-grafana-frontend-api-url

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-grafana-update-dashboards

Get the GRAFANA_UPDATE_DASHBOARDS option value

Example command:

ceph dashboard get-grafana-update-dashboards

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-iscsi-api-ssl-verification

Get the ISCSI_API_SSL_VERIFICATION option value

Example command:

ceph dashboard get-iscsi-api-ssl-verification

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-jwt-token-ttl

Get the JWT token TTL in seconds

Example command:

ceph dashboard get-jwt-token-ttl

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-prometheus-api-host

Get the PROMETHEUS_API_HOST option value

Example command:

ceph dashboard get-prometheus-api-host

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-prometheus-api-ssl-verify

Get the PROMETHEUS_API_SSL_VERIFY option value

Example command:

ceph dashboard get-prometheus-api-ssl-verify

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-check-complexity-enabled

Get the PWD_POLICY_CHECK_COMPLEXITY_ENABLED option value

Example command:

ceph dashboard get-pwd-policy-check-complexity-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-check-exclusion-list-enabled

Get the PWD_POLICY_CHECK_EXCLUSION_LIST_ENABLED option value

Example command:

ceph dashboard get-pwd-policy-check-exclusion-list-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-check-length-enabled

Get the PWD_POLICY_CHECK_LENGTH_ENABLED option value

Example command:

ceph dashboard get-pwd-policy-check-length-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-check-oldpwd-enabled

Get the PWD_POLICY_CHECK_OLDPWD_ENABLED option value

Example command:

ceph dashboard get-pwd-policy-check-oldpwd-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-check-repetitive-chars-enabled

Get the PWD_POLICY_CHECK_REPETITIVE_CHARS_ENABLED option value

Example command:

ceph dashboard get-pwd-policy-check-repetitive-chars-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-check-sequential-chars-enabled

Get the PWD_POLICY_CHECK_SEQUENTIAL_CHARS_ENABLED option value

Example command:

ceph dashboard get-pwd-policy-check-sequential-chars-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-check-username-enabled

Get the PWD_POLICY_CHECK_USERNAME_ENABLED option value

Example command:

ceph dashboard get-pwd-policy-check-username-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-enabled

Get the PWD_POLICY_ENABLED option value

Example command:

ceph dashboard get-pwd-policy-enabled

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-exclusion-list

Get the PWD_POLICY_EXCLUSION_LIST option value

Example command:

ceph dashboard get-pwd-policy-exclusion-list

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-min-complexity

Get the PWD_POLICY_MIN_COMPLEXITY option value

Example command:

ceph dashboard get-pwd-policy-min-complexity

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-pwd-policy-min-length

Get the PWD_POLICY_MIN_LENGTH option value

Example command:

ceph dashboard get-pwd-policy-min-length

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-rest-requests-timeout

Get the REST_REQUESTS_TIMEOUT option value

Example command:

ceph dashboard get-rest-requests-timeout

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-rgw-api-access-key

Get the RGW_API_ACCESS_KEY option value

Example command:

ceph dashboard get-rgw-api-access-key

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-rgw-api-admin-resource

Get the RGW_API_ADMIN_RESOURCE option value

Example command:

ceph dashboard get-rgw-api-admin-resource

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-rgw-api-secret-key

Get the RGW_API_SECRET_KEY option value

Example command:

ceph dashboard get-rgw-api-secret-key

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-rgw-api-ssl-verify

Get the RGW_API_SSL_VERIFY option value

Example command:

ceph dashboard get-rgw-api-ssl-verify

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-user-pwd-expiration-span

Get the USER_PWD_EXPIRATION_SPAN option value

Example command:

ceph dashboard get-user-pwd-expiration-span

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-user-pwd-expiration-warning-1

Get the USER_PWD_EXPIRATION_WARNING_1 option value

Example command:

ceph dashboard get-user-pwd-expiration-warning-1

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard get-user-pwd-expiration-warning-2

Get the USER_PWD_EXPIRATION_WARNING_2 option value

Example command:

ceph dashboard get-user-pwd-expiration-warning-2

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard grafana dashboards update

Push dashboards to Grafana

Example command:

ceph dashboard grafana dashboards update

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-account-lockout-attempts

Reset the ACCOUNT_LOCKOUT_ATTEMPTS option to its default value

Example command:

ceph dashboard reset-account-lockout-attempts

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-alertmanager-api-host

Reset the ALERTMANAGER_API_HOST option to its default value

Example command:

ceph dashboard reset-alertmanager-api-host

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-alertmanager-api-ssl-verify

Reset the ALERTMANAGER_API_SSL_VERIFY option to its default value

Example command:

ceph dashboard reset-alertmanager-api-ssl-verify

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-audit-api-enabled

Reset the AUDIT_API_ENABLED option to its default value

Example command:

ceph dashboard reset-audit-api-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-audit-api-log-payload

Reset the AUDIT_API_LOG_PAYLOAD option to its default value

Example command:

ceph dashboard reset-audit-api-log-payload

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-enable-browsable-api

Reset the ENABLE_BROWSABLE_API option to its default value

Example command:

ceph dashboard reset-enable-browsable-api

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-ganesha-clusters-rados-pool-namespace

Reset the GANESHA_CLUSTERS_RADOS_POOL_NAMESPACE option to its default value

Example command:

ceph dashboard reset-ganesha-clusters-rados-pool-namespace

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-grafana-api-password

Reset the GRAFANA_API_PASSWORD option to its default value

Example command:

ceph dashboard reset-grafana-api-password

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-grafana-api-ssl-verify

Reset the GRAFANA_API_SSL_VERIFY option to its default value

Example command:

ceph dashboard reset-grafana-api-ssl-verify

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-grafana-api-url

Reset the GRAFANA_API_URL option to its default value

Example command:

ceph dashboard reset-grafana-api-url

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-grafana-api-username

Reset the GRAFANA_API_USERNAME option to its default value

Example command:

ceph dashboard reset-grafana-api-username

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-grafana-frontend-api-url

Reset the GRAFANA_FRONTEND_API_URL option to its default value

Example command:

ceph dashboard reset-grafana-frontend-api-url

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-grafana-update-dashboards

Reset the GRAFANA_UPDATE_DASHBOARDS option to its default value

Example command:

ceph dashboard reset-grafana-update-dashboards

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-iscsi-api-ssl-verification

Reset the ISCSI_API_SSL_VERIFICATION option to its default value

Example command:

ceph dashboard reset-iscsi-api-ssl-verification

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-prometheus-api-host

Reset the PROMETHEUS_API_HOST option to its default value

Example command:

ceph dashboard reset-prometheus-api-host

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-prometheus-api-ssl-verify

Reset the PROMETHEUS_API_SSL_VERIFY option to its default value

Example command:

ceph dashboard reset-prometheus-api-ssl-verify

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-check-complexity-enabled

Reset the PWD_POLICY_CHECK_COMPLEXITY_ENABLED option to its default value

Example command:

ceph dashboard reset-pwd-policy-check-complexity-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-check-exclusion-list-enabled

Reset the PWD_POLICY_CHECK_EXCLUSION_LIST_ENABLED option to its default value

Example command:

ceph dashboard reset-pwd-policy-check-exclusion-list-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-check-length-enabled

Reset the PWD_POLICY_CHECK_LENGTH_ENABLED option to its default value

Example command:

ceph dashboard reset-pwd-policy-check-length-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-check-oldpwd-enabled

Reset the PWD_POLICY_CHECK_OLDPWD_ENABLED option to its default value

Example command:

ceph dashboard reset-pwd-policy-check-oldpwd-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-check-repetitive-chars-enabled

Reset the PWD_POLICY_CHECK_REPETITIVE_CHARS_ENABLED option to its default value

Example command:

ceph dashboard reset-pwd-policy-check-repetitive-chars-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-check-sequential-chars-enabled

Reset the PWD_POLICY_CHECK_SEQUENTIAL_CHARS_ENABLED option to its default value

Example command:

ceph dashboard reset-pwd-policy-check-sequential-chars-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-check-username-enabled

Reset the PWD_POLICY_CHECK_USERNAME_ENABLED option to its default value

Example command:

ceph dashboard reset-pwd-policy-check-username-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-enabled

Reset the PWD_POLICY_ENABLED option to its default value

Example command:

ceph dashboard reset-pwd-policy-enabled

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-exclusion-list

Reset the PWD_POLICY_EXCLUSION_LIST option to its default value

Example command:

ceph dashboard reset-pwd-policy-exclusion-list

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-min-complexity

Reset the PWD_POLICY_MIN_COMPLEXITY option to its default value

Example command:

ceph dashboard reset-pwd-policy-min-complexity

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-pwd-policy-min-length

Reset the PWD_POLICY_MIN_LENGTH option to its default value

Example command:

ceph dashboard reset-pwd-policy-min-length

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-rest-requests-timeout

Reset the REST_REQUESTS_TIMEOUT option to its default value

Example command:

ceph dashboard reset-rest-requests-timeout

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-rgw-api-access-key

Reset the RGW_API_ACCESS_KEY option to its default value

Example command:

ceph dashboard reset-rgw-api-access-key

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-rgw-api-admin-resource

Reset the RGW_API_ADMIN_RESOURCE option to its default value

Example command:

ceph dashboard reset-rgw-api-admin-resource

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-rgw-api-secret-key

Reset the RGW_API_SECRET_KEY option to its default value

Example command:

ceph dashboard reset-rgw-api-secret-key

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-rgw-api-ssl-verify

Reset the RGW_API_SSL_VERIFY option to its default value

Example command:

ceph dashboard reset-rgw-api-ssl-verify

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-user-pwd-expiration-span

Reset the USER_PWD_EXPIRATION_SPAN option to its default value

Example command:

ceph dashboard reset-user-pwd-expiration-span

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-user-pwd-expiration-warning-1

Reset the USER_PWD_EXPIRATION_WARNING_1 option to its default value

Example command:

ceph dashboard reset-user-pwd-expiration-warning-1

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard reset-user-pwd-expiration-warning-2

Reset the USER_PWD_EXPIRATION_WARNING_2 option to its default value

Example command:

ceph dashboard reset-user-pwd-expiration-warning-2

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-account-lockout-attempts

Set the ACCOUNT_LOCKOUT_ATTEMPTS option value

Example command:

ceph dashboard set-account-lockout-attempts my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-alertmanager-api-host

Set the ALERTMANAGER_API_HOST option value

Example command:

ceph dashboard set-alertmanager-api-host my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-alertmanager-api-ssl-verify

Set the ALERTMANAGER_API_SSL_VERIFY option value

Example command:

ceph dashboard set-alertmanager-api-ssl-verify my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-audit-api-enabled

Set the AUDIT_API_ENABLED option value

Example command:

ceph dashboard set-audit-api-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-audit-api-log-payload

Set the AUDIT_API_LOG_PAYLOAD option value

Example command:

ceph dashboard set-audit-api-log-payload my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-enable-browsable-api

Set the ENABLE_BROWSABLE_API option value

Example command:

ceph dashboard set-enable-browsable-api my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-ganesha-clusters-rados-pool-namespace

Set the GANESHA_CLUSTERS_RADOS_POOL_NAMESPACE option value

Example command:

ceph dashboard set-ganesha-clusters-rados-pool-namespace my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-grafana-api-password

Set the GRAFANA_API_PASSWORD option value read from -i <file>

Example command:

ceph dashboard set-grafana-api-password

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-grafana-api-ssl-verify

Set the GRAFANA_API_SSL_VERIFY option value

Example command:

ceph dashboard set-grafana-api-ssl-verify my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-grafana-api-url

Set the GRAFANA_API_URL option value

Example command:

ceph dashboard set-grafana-api-url my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-grafana-api-username

Set the GRAFANA_API_USERNAME option value

Example command:

ceph dashboard set-grafana-api-username my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-grafana-frontend-api-url

Set the GRAFANA_FRONTEND_API_URL option value

Example command:

ceph dashboard set-grafana-frontend-api-url my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-grafana-update-dashboards

Set the GRAFANA_UPDATE_DASHBOARDS option value

Example command:

ceph dashboard set-grafana-update-dashboards my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-iscsi-api-ssl-verification

Set the ISCSI_API_SSL_VERIFICATION option value

Example command:

ceph dashboard set-iscsi-api-ssl-verification my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-jwt-token-ttl

Set the JWT token TTL in seconds

Example command:

ceph dashboard set-jwt-token-ttl 1

Parameters:

  • seconds: CephInt

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-prometheus-api-host

Set the PROMETHEUS_API_HOST option value

Example command:

ceph dashboard set-prometheus-api-host my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-prometheus-api-ssl-verify

Set the PROMETHEUS_API_SSL_VERIFY option value

Example command:

ceph dashboard set-prometheus-api-ssl-verify my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-check-complexity-enabled

Set the PWD_POLICY_CHECK_COMPLEXITY_ENABLED option value

Example command:

ceph dashboard set-pwd-policy-check-complexity-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-check-exclusion-list-enabled

Set the PWD_POLICY_CHECK_EXCLUSION_LIST_ENABLED option value

Example command:

ceph dashboard set-pwd-policy-check-exclusion-list-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-check-length-enabled

Set the PWD_POLICY_CHECK_LENGTH_ENABLED option value

Example command:

ceph dashboard set-pwd-policy-check-length-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-check-oldpwd-enabled

Set the PWD_POLICY_CHECK_OLDPWD_ENABLED option value

Example command:

ceph dashboard set-pwd-policy-check-oldpwd-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-check-repetitive-chars-enabled

Set the PWD_POLICY_CHECK_REPETITIVE_CHARS_ENABLED option value

Example command:

ceph dashboard set-pwd-policy-check-repetitive-chars-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-check-sequential-chars-enabled

Set the PWD_POLICY_CHECK_SEQUENTIAL_CHARS_ENABLED option value

Example command:

ceph dashboard set-pwd-policy-check-sequential-chars-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-check-username-enabled

Set the PWD_POLICY_CHECK_USERNAME_ENABLED option value

Example command:

ceph dashboard set-pwd-policy-check-username-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-enabled

Set the PWD_POLICY_ENABLED option value

Example command:

ceph dashboard set-pwd-policy-enabled my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-exclusion-list

Set the PWD_POLICY_EXCLUSION_LIST option value

Example command:

ceph dashboard set-pwd-policy-exclusion-list my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-min-complexity

Set the PWD_POLICY_MIN_COMPLEXITY option value

Example command:

ceph dashboard set-pwd-policy-min-complexity my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-pwd-policy-min-length

Set the PWD_POLICY_MIN_LENGTH option value

Example command:

ceph dashboard set-pwd-policy-min-length my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-rest-requests-timeout

Set the REST_REQUESTS_TIMEOUT option value

Example command:

ceph dashboard set-rest-requests-timeout my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-rgw-api-access-key

Set the RGW_API_ACCESS_KEY option value read from -i <file>

Example command:

ceph dashboard set-rgw-api-access-key

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-rgw-api-admin-resource

Set the RGW_API_ADMIN_RESOURCE option value

Example command:

ceph dashboard set-rgw-api-admin-resource my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-rgw-api-secret-key

Set the RGW_API_SECRET_KEY option value read from -i <file>

Example command:

ceph dashboard set-rgw-api-secret-key

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-rgw-api-ssl-verify

Set the RGW_API_SSL_VERIFY option value

Example command:

ceph dashboard set-rgw-api-ssl-verify my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-user-pwd-expiration-span

Set the USER_PWD_EXPIRATION_SPAN option value

Example command:

ceph dashboard set-user-pwd-expiration-span my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-user-pwd-expiration-warning-1

Set the USER_PWD_EXPIRATION_WARNING_1 option value

Example command:

ceph dashboard set-user-pwd-expiration-warning-1 my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard set-user-pwd-expiration-warning-2

Set the USER_PWD_EXPIRATION_WARNING_2 option value

Example command:

ceph dashboard set-user-pwd-expiration-warning-2 my_value

Parameters:

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard sso disable

Disable Single Sign-On

Example command:

ceph dashboard sso disable

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard sso enable saml2

Enable SAML2 Single Sign-On

Example command:

ceph dashboard sso enable saml2

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard sso setup saml2

Setup SAML2 Single Sign-On

Example command:

ceph dashboard sso setup saml2 --ceph_dashboard_base_url=string --idp_metadata=string --idp_username_attribute=string --idp_entity_id=string --sp_x_509_cert=/path/to/file --sp_private_key=/path/to/file

Parameters:

  • ceph_dashboard_base_url: (string)

  • idp_metadata: (string)

  • idp_username_attribute: (string)

  • idp_entity_id: (string)

  • sp_x_509_cert: CephFilepath

  • sp_private_key: CephFilepath

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

dashboard sso show saml2

Show SAML2 configuration

Example command:

ceph dashboard sso show saml2

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

dashboard sso status

Get Single Sign-On status

Example command:

ceph dashboard sso status

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

device light

Enable or disable the device light. Default type is ident ‘Usage: device light (on|off) <devid> [ident|fault] [–force]’

Example command:

ceph device light --enable=on --devid=string --light_type=ident --force

Parameters:

  • enable: CephChoices strings=(on off)

  • devid: (string)

  • light_type: CephChoices strings=(ident fault)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

device ls-lights

List currently active device indicator lights

Example command:

ceph device ls-lights

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs clone cancel

Cancel an pending or ongoing clone operation.

Example command:

ceph fs clone cancel my_vol_name my_clone_name my_group_name

Parameters:

  • vol_name: (string)

  • clone_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs clone status

Get status on a cloned subvolume.

Example command:

ceph fs clone status my_vol_name my_clone_name my_group_name

Parameters:

  • vol_name: (string)

  • clone_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs perf stats

retrieve ceph fs performance stats

Example command:

ceph fs perf stats my_mds_rank my_client_id my_client_ip

Parameters:

  • mds_rank: (string)

  • client_id: (string)

  • client_ip: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs status

Show the status of a CephFS filesystem

Example command:

ceph fs status my_fs

Parameters:

  • fs: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume authorize

Allow a cephx auth ID access to a subvolume

Example command:

ceph fs subvolume authorize --vol_name=string --sub_name=string --auth_id=string --group_name=string --access_level=string --tenant_id=string --allow_existing_id

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • auth_id: (string)

  • group_name: (string)

  • access_level: (string)

  • tenant_id: (string)

  • allow_existing_id: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume authorized_list

List auth IDs that have access to a subvolume

Example command:

ceph fs subvolume authorized_list my_vol_name my_sub_name my_group_name

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume create

Create a CephFS subvolume in a volume, and optionally, with a specific size (in bytes), a specific data pool layout, a specific mode, in a specific subvolume group and in separate RADOS namespace

Example command:

ceph fs subvolume create --vol_name=string --sub_name=string --size=1 --group_name=string --pool_layout=string --uid=1 --gid=1 --mode=string --namespace_isolated

Parameters:

  • vol_name: (string)

  • sub_name: goodchars= [A-Za-z0-9-_.]

  • size: CephInt

  • group_name: (string)

  • pool_layout: (string)

  • uid: CephInt

  • gid: CephInt

  • mode: (string)

  • namespace_isolated: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume deauthorize

Deny a cephx auth ID access to a subvolume

Example command:

ceph fs subvolume deauthorize --vol_name=string --sub_name=string --auth_id=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • auth_id: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume evict

Evict clients based on auth IDs and subvolume mounted

Example command:

ceph fs subvolume evict --vol_name=string --sub_name=string --auth_id=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • auth_id: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume exist

Check a volume for the existence of a subvolume, optionally in a specified subvolume group

Example command:

ceph fs subvolume exist my_vol_name my_group_name

Parameters:

  • vol_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume getpath

Get the mountpath of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume getpath my_vol_name my_sub_name my_group_name

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume info

Get the information of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume info my_vol_name my_sub_name my_group_name

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume ls

List subvolumes

Example command:

ceph fs subvolume ls my_vol_name my_group_name

Parameters:

  • vol_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume metadata get

Get custom metadata associated with the key of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume metadata get --vol_name=string --sub_name=string --key_name=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • key_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume metadata ls

List custom metadata (key-value pairs) of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume metadata ls my_vol_name my_sub_name my_group_name

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume metadata rm

Remove custom metadata (key-value) associated with the key of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume metadata rm --vol_name=string --sub_name=string --key_name=string --group_name=string --force

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • key_name: (string)

  • group_name: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume metadata set

Set custom metadata (key-value) for a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume metadata set --vol_name=string --sub_name=string --key_name=string --value=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • key_name: (string)

  • value: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume pin

Set MDS pinning policy for subvolume

Example command:

ceph fs subvolume pin --vol_name=string --sub_name=string --pin_type=export --pin_setting=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • pin_type: CephChoices strings=(export distributed random)

  • pin_setting: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume resize

Resize a CephFS subvolume

Example command:

ceph fs subvolume resize --vol_name=string --sub_name=string --new_size=string --group_name=string --no_shrink

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • new_size: (string)

  • group_name: (string)

  • no_shrink: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume rm

Delete a CephFS subvolume in a volume, and optionally, in a specific subvolume group, force deleting a cancelled or failed clone, and retaining existing subvolume snapshots

Example command:

ceph fs subvolume rm --vol_name=string --sub_name=string --group_name=string --force --retain_snapshots

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • group_name: (string)

  • force: CephBool

  • retain_snapshots: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume snapshot clone

Clone a snapshot to target subvolume

Example command:

ceph fs subvolume snapshot clone --vol_name=string --sub_name=string --snap_name=string --target_sub_name=string --pool_layout=string --group_name=string --target_group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • target_sub_name: (string)

  • pool_layout: (string)

  • group_name: (string)

  • target_group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume snapshot create

Create a snapshot of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot create --vol_name=string --sub_name=string --snap_name=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume snapshot info

Get the information of a CephFS subvolume snapshot and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot info --vol_name=string --sub_name=string --snap_name=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume snapshot ls

List subvolume snapshots

Example command:

ceph fs subvolume snapshot ls my_vol_name my_sub_name my_group_name

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume snapshot metadata get

Get custom metadata associated with the key of a CephFS subvolume snapshot in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot metadata get --vol_name=string --sub_name=string --snap_name=string --key_name=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • key_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume snapshot metadata ls

List custom metadata (key-value pairs) of a CephFS subvolume snapshot in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot metadata ls --vol_name=string --sub_name=string --snap_name=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolume snapshot metadata rm

Remove custom metadata (key-value) associated with the key of a CephFS subvolume snapshot in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot metadata rm --vol_name=string --sub_name=string --snap_name=string --key_name=string --group_name=string --force

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • key_name: (string)

  • group_name: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume snapshot metadata set

Set custom metadata (key-value) for a CephFS subvolume snapshot in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot metadata set --vol_name=string --sub_name=string --snap_name=string --key_name=string --value=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • key_name: (string)

  • value: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume snapshot protect

(deprecated) Protect snapshot of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot protect --vol_name=string --sub_name=string --snap_name=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume snapshot rm

Delete a snapshot of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot rm --vol_name=string --sub_name=string --snap_name=string --group_name=string --force

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • group_name: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolume snapshot unprotect

(deprecated) Unprotect a snapshot of a CephFS subvolume in a volume, and optionally, in a specific subvolume group

Example command:

ceph fs subvolume snapshot unprotect --vol_name=string --sub_name=string --snap_name=string --group_name=string

Parameters:

  • vol_name: (string)

  • sub_name: (string)

  • snap_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolumegroup create

Create a CephFS subvolume group in a volume, and optionally, with a specific data pool layout, and a specific numeric mode

Example command:

ceph fs subvolumegroup create --vol_name=string --group_name=string --size=1 --pool_layout=string --uid=1 --gid=1 --mode=string

Parameters:

  • vol_name: (string)

  • group_name: goodchars= [A-Za-z0-9-_.]

  • size: CephInt

  • pool_layout: (string)

  • uid: CephInt

  • gid: CephInt

  • mode: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolumegroup exist

Check a volume for the existence of subvolumegroup

Example command:

ceph fs subvolumegroup exist my_vol_name

Parameters:

  • vol_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolumegroup getpath

Get the mountpath of a CephFS subvolume group in a volume

Example command:

ceph fs subvolumegroup getpath my_vol_name my_group_name

Parameters:

  • vol_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolumegroup info

Get the metadata of a CephFS subvolume group in a volume,

Example command:

ceph fs subvolumegroup info my_vol_name my_group_name

Parameters:

  • vol_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolumegroup ls

List subvolumegroups

Example command:

ceph fs subvolumegroup ls my_vol_name

Parameters:

  • vol_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolumegroup pin

Set MDS pinning policy for subvolumegroup

Example command:

ceph fs subvolumegroup pin --vol_name=string --group_name=string --pin_type=export --pin_setting=string

Parameters:

  • vol_name: (string)

  • group_name: (string)

  • pin_type: CephChoices strings=(export distributed random)

  • pin_setting: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolumegroup resize

Resize a CephFS subvolume group

Example command:

ceph fs subvolumegroup resize --vol_name=string --group_name=string --new_size=string --no_shrink

Parameters:

  • vol_name: (string)

  • group_name: (string)

  • new_size: (string)

  • no_shrink: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolumegroup rm

Delete a CephFS subvolume group in a volume

Example command:

ceph fs subvolumegroup rm my_vol_name my_group_name --force

Parameters:

  • vol_name: (string)

  • group_name: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolumegroup snapshot create

Create a snapshot of a CephFS subvolume group in a volume

Example command:

ceph fs subvolumegroup snapshot create my_vol_name my_group_name my_snap_name

Parameters:

  • vol_name: (string)

  • group_name: (string)

  • snap_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs subvolumegroup snapshot ls

List subvolumegroup snapshots

Example command:

ceph fs subvolumegroup snapshot ls my_vol_name my_group_name

Parameters:

  • vol_name: (string)

  • group_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs subvolumegroup snapshot rm

Delete a snapshot of a CephFS subvolume group in a volume

Example command:

ceph fs subvolumegroup snapshot rm --vol_name=string --group_name=string --snap_name=string --force

Parameters:

  • vol_name: (string)

  • group_name: (string)

  • snap_name: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs volume create

Create a CephFS volume

Example command:

ceph fs volume create my_name my_placement

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • placement: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

fs volume info

Get the information of a CephFS volume

Example command:

ceph fs volume info my_vol_name --human_readable

Parameters:

  • vol_name: (string)

  • human_readable: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs volume ls

List volumes

Example command:

ceph fs volume ls

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

fs volume rm

Delete a FS volume by passing –yes-i-really-mean-it flag

Example command:

ceph fs volume rm my_vol_name my_yes-i-really-mean-it

Parameters:

  • vol_name: (string)

  • yes-i-really-mean-it: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

hello

Say hello

Example command:

ceph hello my_person_name

Parameters:

  • person_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

influx config-set

Set a configuration value

Example command:

ceph influx config-set my_key my_value

Parameters:

  • key: (string)

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

influx config-show

Show current configuration

Example command:

ceph influx config-show

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

influx send

Force sending data to Influx

Example command:

ceph influx send

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

k8sevents ceph

List Ceph events tracked & sent to the kubernetes cluster

Example command:

ceph k8sevents ceph

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

k8sevents clear-config

Clear external kubernetes configuration settings

Example command:

ceph k8sevents clear-config

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

k8sevents ls

List all current Kuberenetes events from the Ceph namespace

Example command:

ceph k8sevents ls

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

k8sevents set-access

Set kubernetes access credentials. <key> must be cacrt or token and use -i <filename> syntax (e.g., ceph k8sevents set-access cacrt -i /root/ca.crt).

Example command:

ceph k8sevents set-access my_key

Parameters:

  • key: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

k8sevents set-config

Set kubernetes config paramters. <key> must be server or namespace (e.g., ceph k8sevents set-config server https://localhost:30433).

Example command:

ceph k8sevents set-config my_key my_value

Parameters:

  • key: (string)

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

k8sevents status

Show the status of the data gathering threads

Example command:

ceph k8sevents status

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

mgr self-test background start

Activate a background workload (one of command_spam, throw_exception)

Example command:

ceph mgr self-test background start my_workload

Parameters:

  • workload: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test background stop

Stop background workload if any is running

Example command:

ceph mgr self-test background stop

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test cluster-log

Create an audit log record.

Example command:

ceph mgr self-test cluster-log my_channel my_priority my_message

Parameters:

  • channel: (string)

  • priority: (string)

  • message: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test config get

Peek at a configuration value

Example command:

ceph mgr self-test config get my_key

Parameters:

  • key: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test config get_localized

Peek at a configuration value (localized variant)

Example command:

ceph mgr self-test config get_localized my_key

Parameters:

  • key: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test health clear

Clear health checks by name. If no names provided, clear all.

Example command:

ceph mgr self-test health clear --checks=string

Parameters:

  • checks: (can be repeated)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test health set

Set a health check from a JSON-formatted description.

Example command:

ceph mgr self-test health set my_checks

Parameters:

  • checks: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test insights_set_now_offset

Set the now time for the insights module.

Example command:

ceph mgr self-test insights_set_now_offset my_hours

Parameters:

  • hours: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test module

Run another module’s self_test() method

Example command:

ceph mgr self-test module my_module

Parameters:

  • module: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test python-version

Query the version of the embedded Python runtime

Example command:

ceph mgr self-test python-version

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

mgr self-test remote

Test inter-module calls

Example command:

ceph mgr self-test remote

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

mgr self-test run

Run mgr python interface tests

Example command:

ceph mgr self-test run

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch

Start, stop, restart, redeploy, or reconfig an entire service (i.e. all daemons)

Example command:

ceph orch start my_service_name

Parameters:

  • action: CephChoices strings=(start stop restart redeploy reconfig)

  • service_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch apply

Update the size or placement for a service or apply a large yaml spec

Example command:

ceph orch apply --service_type=mon --placement=string --dry_run --format=plain --unmanaged --no_overwrite

Parameters:

  • service_type: CephChoices strings=(mon mgr rbd-mirror cephfs-mirror crash alertmanager grafana node-exporter prometheus mds rgw nfs iscsi cephadm-exporter snmp-gateway)

  • placement: (string)

  • dry_run: CephBool

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • unmanaged: CephBool

  • no_overwrite: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch apply iscsi

Scale an iSCSI service

Example command:

ceph orch apply iscsi --pool=string --api_user=string --api_password=string --trusted_ip_list=string --placement=string --unmanaged --dry_run --format=plain --no_overwrite

Parameters:

  • pool: (string)

  • api_user: (string)

  • api_password: (string)

  • trusted_ip_list: (string)

  • placement: (string)

  • unmanaged: CephBool

  • dry_run: CephBool

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • no_overwrite: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch apply mds

Update the number of MDS instances for the given fs_name

Example command:

ceph orch apply mds --fs_name=string --placement=string --dry_run --unmanaged --format=plain --no_overwrite

Parameters:

  • fs_name: (string)

  • placement: (string)

  • dry_run: CephBool

  • unmanaged: CephBool

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • no_overwrite: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch apply nfs

Scale an NFS service

Example command:

ceph orch apply nfs --svc_id=string --placement=string --format=plain --port=1 --dry_run --unmanaged --no_overwrite

Parameters:

  • svc_id: (string)

  • placement: (string)

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • port: CephInt

  • dry_run: CephBool

  • unmanaged: CephBool

  • no_overwrite: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch apply osd

Create OSD daemon(s) on all available devices

Example command:

ceph orch apply osd --all_available_devices --format=plain --unmanaged --dry_run --no_overwrite

Parameters:

  • all_available_devices: CephBool

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • unmanaged: CephBool

  • dry_run: CephBool

  • no_overwrite: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch apply rgw

Update the number of RGW instances for the given zone

Example command:

ceph orch apply rgw --svc_id=string --placement=string --realm=string --zone=string --port=1 --ssl --dry_run --format=plain --unmanaged --no_overwrite

Parameters:

  • svc_id: (string)

  • placement: (string)

  • realm: (string)

  • zone: (string)

  • port: CephInt

  • ssl: CephBool

  • dry_run: CephBool

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • unmanaged: CephBool

  • no_overwrite: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch apply snmp-gateway

Add a Prometheus to SNMP gateway service (cephadm only)

Example command:

ceph orch apply snmp-gateway --snmp_version=V2c --destination=string --port=1 --engine_id=string --auth_protocol=MD5 --privacy_protocol=DES --placement=string --unmanaged --dry_run --format=plain --no_overwrite

Parameters:

  • snmp_version: CephChoices strings=(V2c V3)

  • destination: (string)

  • port: CephInt

  • engine_id: (string)

  • auth_protocol: CephChoices strings=(MD5 SHA)

  • privacy_protocol: CephChoices strings=(DES AES)

  • placement: (string)

  • unmanaged: CephBool

  • dry_run: CephBool

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • no_overwrite: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch cancel

Cancel ongoing background operations

Example command:

ceph orch cancel

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch client-keyring ls

List client keyrings under cephadm management

Example command:

ceph orch client-keyring ls plain

Parameters:

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

orch client-keyring rm

Remove client keyring from cephadm management

Example command:

ceph orch client-keyring rm my_entity

Parameters:

  • entity: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch client-keyring set

Add or update client keyring under cephadm management

Example command:

ceph orch client-keyring set --entity=string --placement=string --owner=string --mode=string

Parameters:

  • entity: (string)

  • placement: (string)

  • owner: (string)

  • mode: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon

Start, stop, restart, (redeploy,) or reconfig a specific daemon

Example command:

ceph orch daemon start my_name

Parameters:

  • action: CephChoices strings=(start stop restart reconfig)

  • name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon add

Add daemon(s)

Example command:

ceph orch daemon add mon my_placement

Parameters:

  • daemon_type: CephChoices strings=(mon mgr rbd-mirror cephfs-mirror crash alertmanager grafana node-exporter prometheus mds rgw nfs iscsi cephadm-exporter snmp-gateway)

  • placement: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon add iscsi

Start iscsi daemon(s)

Example command:

ceph orch daemon add iscsi --pool=string --api_user=string --api_password=string --trusted_ip_list=string --placement=string

Parameters:

  • pool: (string)

  • api_user: (string)

  • api_password: (string)

  • trusted_ip_list: (string)

  • placement: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon add mds

Start MDS daemon(s)

Example command:

ceph orch daemon add mds my_fs_name my_placement

Parameters:

  • fs_name: (string)

  • placement: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon add nfs

Start NFS daemon(s)

Example command:

ceph orch daemon add nfs my_svc_id my_placement

Parameters:

  • svc_id: (string)

  • placement: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon add osd

Create OSD daemon(s) on specified host and device(s) (e.g., ceph orch daemon add osd myhost:/dev/sdb)

Example command:

ceph orch daemon add osd my_svc_arg raw

Parameters:

  • svc_arg: (string)

  • method: CephChoices strings=(raw lvm)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon add rgw

Start RGW daemon(s)

Example command:

ceph orch daemon add rgw --svc_id=string --placement=string --port=1 --ssl

Parameters:

  • svc_id: (string)

  • placement: (string)

  • port: CephInt

  • ssl: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon redeploy

Redeploy a daemon (with a specifc image)

Example command:

ceph orch daemon redeploy my_name my_image

Parameters:

  • name: (string)

  • image: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch daemon rm

Remove specific daemon(s)

Example command:

ceph orch daemon rm --names=string --force

Parameters:

  • names: (can be repeated)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch device ls

List devices on a host

Example command:

ceph orch device ls --hostname=string --format=plain --refresh --wide

Parameters:

  • hostname: (can be repeated)

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • refresh: CephBool

  • wide: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

orch device zap

Zap (erase!) a device so it can be re-used

Example command:

ceph orch device zap my_hostname my_path --force

Parameters:

  • hostname: (string)

  • path: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host add

Add a host

Example command:

ceph orch host add --hostname=string --addr=string --labels=string --maintenance

Parameters:

  • hostname: (string)

  • addr: (string)

  • labels: (can be repeated)

  • maintenance: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host drain

drain all daemons from a host

Example command:

ceph orch host drain my_hostname --force

Parameters:

  • hostname: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host label add

Add a host label

Example command:

ceph orch host label add my_hostname my_label

Parameters:

  • hostname: (string)

  • label: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host label rm

Remove a host label

Example command:

ceph orch host label rm my_hostname my_label --force

Parameters:

  • hostname: (string)

  • label: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host ls

List hosts

Example command:

ceph orch host ls --format=plain --host_pattern=string --label=string --host_status=string

Parameters:

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • host_pattern: (string)

  • label: (string)

  • host_status: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

orch host maintenance enter

Prepare a host for maintenance by shutting down and disabling all Ceph daemons (cephadm only)

Example command:

ceph orch host maintenance enter my_hostname --force

Parameters:

  • hostname: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host maintenance exit

Return a host from maintenance, restarting all Ceph daemons (cephadm only)

Example command:

ceph orch host maintenance exit my_hostname

Parameters:

  • hostname: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host ok-to-stop

Check if the specified host can be safely stopped without reducing availability

Example command:

ceph orch host ok-to-stop my_hostname

Parameters:

  • hostname: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host rescan

Perform a disk rescan on a host

Example command:

ceph orch host rescan my_hostname --with_summary

Parameters:

  • hostname: (string)

  • with_summary: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host rm

Remove a host

Example command:

ceph orch host rm my_hostname --force --offline

Parameters:

  • hostname: (string)

  • force: CephBool

  • offline: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch host set-addr

Update a host address

Example command:

ceph orch host set-addr my_hostname my_addr

Parameters:

  • hostname: (string)

  • addr: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch ls

List services known to orchestrator

Example command:

ceph orch ls --service_type=string --service_name=string --export --format=plain --refresh

Parameters:

  • service_type: (string)

  • service_name: (string)

  • export: CephBool

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • refresh: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

orch osd rm

Remove OSD daemons

Example command:

ceph orch osd rm --osd_id=string --replace --force --zap --no_destroy

Parameters:

  • osd_id: (can be repeated)

  • replace: CephBool

  • force: CephBool

  • zap: CephBool

  • no_destroy: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch osd rm status

Status of OSD removal operation

Example command:

ceph orch osd rm status plain

Parameters:

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch osd rm stop

Cancel ongoing OSD removal operation

Example command:

ceph orch osd rm stop --osd_id=string

Parameters:

  • osd_id: (can be repeated)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch pause

Pause orchestrator background work

Example command:

ceph orch pause

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch ps

List daemons known to orchestrator

Example command:

ceph orch ps --hostname=string --service_name=string --daemon_type=string --daemon_id=string --format=plain --refresh

Parameters:

  • hostname: (string)

  • service_name: (string)

  • daemon_type: (string)

  • daemon_id: (string)

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

  • refresh: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

orch resume

Resume orchestrator background work (if paused)

Example command:

ceph orch resume

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch rm

Remove a service

Example command:

ceph orch rm my_service_name --force

Parameters:

  • service_name: (string)

  • force: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch set backend

Select orchestrator module backend

Example command:

ceph orch set backend my_module_name

Parameters:

  • module_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch status

Report configured backend and its status

Example command:

ceph orch status --detail plain

Parameters:

  • detail: CephBool

  • format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

orch upgrade check

Check service versions vs available and target containers

Example command:

ceph orch upgrade check my_image my_ceph_version

Parameters:

  • image: (string)

  • ceph_version: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch upgrade ls

Check for available versions (or tags) we can upgrade to

Example command:

ceph orch upgrade ls my_image --tags

Parameters:

  • image: (string)

  • tags: CephBool

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

orch upgrade pause

Pause an in-progress upgrade

Example command:

ceph orch upgrade pause

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch upgrade resume

Resume paused upgrade

Example command:

ceph orch upgrade resume

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch upgrade start

Initiate upgrade

Example command:

ceph orch upgrade start --image=string --ceph_version=string --daemon_types=string --hosts=string --services=string --limit=1

Parameters:

  • image: (string)

  • ceph_version: (string)

  • daemon_types: (string)

  • hosts: (string)

  • services: (string)

  • limit: CephInt

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch upgrade status

Check the status of any potential ongoing upgrade operation

Example command:

ceph orch upgrade status

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

orch upgrade stop

Stop an in-progress upgrade

Example command:

ceph orch upgrade stop

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

osd perf counters get

fetch osd perf counters

Example command:

ceph osd perf counters get 1

Parameters:

  • query_id: CephInt

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

osd perf query add

add osd perf query

Example command:

ceph osd perf query add client_id

Parameters:

  • query: CephChoices strings=(client_id rbd_image_id all_subkeys)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

osd perf query remove

remove osd perf query

Example command:

ceph osd perf query remove 1

Parameters:

  • query_id: CephInt

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

osd status

Show the status of OSDs within a bucket, or all

Example command:

ceph osd status my_bucket

Parameters:

  • bucket: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

progress

Show progress of recovery operations

Example command:

ceph progress

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

progress clear

Reset progress tracking

Example command:

ceph progress clear

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

progress json

Show machine readable progress information

Example command:

ceph progress json

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

progress off

Disable progress tracking

Example command:

ceph progress off

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

progress on

Enable progress tracking

Example command:

ceph progress on

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

rbd mirror snapshot schedule add

Add rbd mirror snapshot schedule

Example command:

ceph rbd mirror snapshot schedule add my_level_spec my_interval my_start_time

Parameters:

  • level_spec: (string)

  • interval: (string)

  • start_time: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd mirror snapshot schedule list

List rbd mirror snapshot schedule

Example command:

ceph rbd mirror snapshot schedule list my_level_spec

Parameters:

  • level_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

rbd mirror snapshot schedule remove

Remove rbd mirror snapshot schedule

Example command:

ceph rbd mirror snapshot schedule remove my_level_spec my_interval my_start_time

Parameters:

  • level_spec: (string)

  • interval: (string)

  • start_time: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd mirror snapshot schedule status

Show rbd mirror snapshot schedule status

Example command:

ceph rbd mirror snapshot schedule status my_level_spec

Parameters:

  • level_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

rbd perf image counters

Retrieve current RBD IO performance counters

Example command:

ceph rbd perf image counters my_pool_spec write_ops

Parameters:

  • pool_spec: (string)

  • sort_by: CephChoices strings=(write_ops write_bytes write_latency read_ops read_bytes read_latency)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

rbd perf image stats

Retrieve current RBD IO performance stats

Example command:

ceph rbd perf image stats my_pool_spec write_ops

Parameters:

  • pool_spec: (string)

  • sort_by: CephChoices strings=(write_ops write_bytes write_latency read_ops read_bytes read_latency)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

rbd task add flatten

Flatten a cloned image asynchronously in the background

Example command:

ceph rbd task add flatten my_image_spec

Parameters:

  • image_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd task add migration abort

Abort a prepared migration asynchronously in the background

Example command:

ceph rbd task add migration abort my_image_spec

Parameters:

  • image_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd task add migration commit

Commit an executed migration asynchronously in the background

Example command:

ceph rbd task add migration commit my_image_spec

Parameters:

  • image_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd task add migration execute

Execute an image migration asynchronously in the background

Example command:

ceph rbd task add migration execute my_image_spec

Parameters:

  • image_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd task add remove

Remove an image asynchronously in the background

Example command:

ceph rbd task add remove my_image_spec

Parameters:

  • image_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd task add trash remove

Remove an image from the trash asynchronously in the background

Example command:

ceph rbd task add trash remove my_image_id_spec

Parameters:

  • image_id_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd task cancel

Cancel a pending or running asynchronous task

Example command:

ceph rbd task cancel my_task_id

Parameters:

  • task_id: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

rbd task list

List pending or running asynchronous tasks

Example command:

ceph rbd task list my_task_id

Parameters:

  • task_id: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

rbd trash purge schedule add

Add rbd trash purge schedule

Example command:

ceph rbd trash purge schedule add my_level_spec my_interval my_start_time

Parameters:

  • level_spec: (string)

  • interval: (string)

  • start_time: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd trash purge schedule list

List rbd trash purge schedule

Example command:

ceph rbd trash purge schedule list my_level_spec

Parameters:

  • level_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

rbd trash purge schedule remove

Remove rbd trash purge schedule

Example command:

ceph rbd trash purge schedule remove my_level_spec my_interval my_start_time

Parameters:

  • level_spec: (string)

  • interval: (string)

  • start_time: (string)

Ceph Module:

  • mgr

Required Permissions:

  • w

Command Flags:

  • mgr

rbd trash purge schedule status

Show rbd trash purge schedule status

Example command:

ceph rbd trash purge schedule status my_level_spec

Parameters:

  • level_spec: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

restful create-key

Create an API key with this name

Example command:

ceph restful create-key my_key_name

Parameters:

  • key_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

restful create-self-signed-cert

Create localized self signed certificate

Example command:

ceph restful create-self-signed-cert

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

restful delete-key

Delete an API key with this name

Example command:

ceph restful delete-key my_key_name

Parameters:

  • key_name: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

restful list-keys

List all API keys

Example command:

ceph restful list-keys

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

restful restart

Restart API server

Example command:

ceph restful restart

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

telegraf config-set

Set a configuration value

Example command:

ceph telegraf config-set my_key my_value

Parameters:

  • key: (string)

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

telegraf config-show

Show current configuration

Example command:

ceph telegraf config-show

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

telegraf send

Force sending data to Telegraf

Example command:

ceph telegraf send

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

telemetry off

Disable telemetry reports from this cluster

Example command:

ceph telemetry off

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

telemetry on

Enable telemetry reports from this cluster

Example command:

ceph telemetry on my_license

Parameters:

  • license: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

telemetry send

Force sending data to Ceph telemetry

Example command:

ceph telemetry send --endpoint=ceph --license=string

Parameters:

  • endpoint: CephChoices strings=(ceph device) (can be repeated)

  • license: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

telemetry show

Show last report or report to be sent

Example command:

ceph telemetry show --channels=string

Parameters:

  • channels: (can be repeated)

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

telemetry show-all

Show report of all channels

Example command:

ceph telemetry show-all

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

telemetry show-device

Show last device report or device report to be sent

Example command:

ceph telemetry show-device

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

telemetry status

Show current configuration

Example command:

ceph telemetry status

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

zabbix config-set

Set a configuration value

Example command:

ceph zabbix config-set my_key my_value

Parameters:

  • key: (string)

  • value: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

zabbix config-show

Show current configuration

Example command:

ceph zabbix config-show

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

zabbix discovery

Discovering Zabbix data

Example command:

ceph zabbix discovery

Ceph Module:

  • mgr

Required Permissions:

  • r

Command Flags:

  • mgr

zabbix send

Force sending data to Zabbix

Example command:

ceph zabbix send

Ceph Module:

  • mgr

Required Permissions:

  • rw

Command Flags:

  • mgr

add_bootstrap_peer_hint

add peer address as potential bootstrap peer for cluster bringup

Example command:

ceph add_bootstrap_peer_hint 0.0.0.0

Parameters:

  • addr: CephIPAddr

Ceph Module:

  • mon

Required Permissions:

  • rw

add_bootstrap_peer_hintv

add peer address vector as potential bootstrap peer for cluster bringup

Example command:

ceph add_bootstrap_peer_hintv my_addrv

Parameters:

  • addrv: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

auth add

add auth info for <entity> from input file, or random key if no input is given, and/or any caps specified in the command

Example command:

ceph auth add --entity=string --caps=string

Parameters:

  • entity: (string)

  • caps: (can be repeated)

Ceph Module:

  • auth

Required Permissions:

  • rwx

auth caps

update caps for <name> from caps specified in the command

Example command:

ceph auth caps --entity=string --caps=string

Parameters:

  • entity: (string)

  • caps: (can be repeated)

Ceph Module:

  • auth

Required Permissions:

  • rwx

auth del

delete all caps for <name>

Example command:

ceph auth del my_entity

Parameters:

  • entity: (string)

Ceph Module:

  • auth

Required Permissions:

  • rwx

Command Flags:

  • deprecated

auth export

write keyring for requested entity, or master keyring if none given

Example command:

ceph auth export my_entity

Parameters:

  • entity: (string)

Ceph Module:

  • auth

Required Permissions:

  • rx

auth get

write keyring file with requested key

Example command:

ceph auth get my_entity

Parameters:

  • entity: (string)

Ceph Module:

  • auth

Required Permissions:

  • rx

auth get-key

display requested key

Example command:

ceph auth get-key my_entity

Parameters:

  • entity: (string)

Ceph Module:

  • auth

Required Permissions:

  • rx

auth get-or-create

add auth info for <entity> from input file, or random key if no input given, and/or any caps specified in the command

Example command:

ceph auth get-or-create --entity=string --caps=string

Parameters:

  • entity: (string)

  • caps: (can be repeated)

Ceph Module:

  • auth

Required Permissions:

  • rwx

auth get-or-create-key

get, or add, key for <name> from system/caps pairs specified in the command. If key already exists, any given caps must match the existing caps for that key.

Example command:

ceph auth get-or-create-key --entity=string --caps=string

Parameters:

  • entity: (string)

  • caps: (can be repeated)

Ceph Module:

  • auth

Required Permissions:

  • rwx

auth import

auth import: read keyring file from -i <file>

Example command:

ceph auth import

Ceph Module:

  • auth

Required Permissions:

  • rwx

auth list

list authentication state

Example command:

ceph auth list

Ceph Module:

  • auth

Required Permissions:

  • rx

Command Flags:

  • deprecated

auth ls

list authentication state

Example command:

ceph auth ls

Ceph Module:

  • auth

Required Permissions:

  • rx

auth print-key

display requested key

Example command:

ceph auth print-key my_entity

Parameters:

  • entity: (string)

Ceph Module:

  • auth

Required Permissions:

  • rx

auth print_key

display requested key

Example command:

ceph auth print_key my_entity

Parameters:

  • entity: (string)

Ceph Module:

  • auth

Required Permissions:

  • rx

auth rm

remove all caps for <name>

Example command:

ceph auth rm my_entity

Parameters:

  • entity: (string)

Ceph Module:

  • auth

Required Permissions:

  • rwx

compact

cause compaction of monitor’s leveldb/rocksdb storage

Example command:

ceph compact

Ceph Module:

  • mon

Required Permissions:

  • rw

config assimilate-conf

Assimilate options from a conf, and return a new, minimal conf file

Example command:

ceph config assimilate-conf

Ceph Module:

  • config

Required Permissions:

  • rw

config dump

Show all configuration option(s)

Example command:

ceph config dump

Ceph Module:

  • mon

Required Permissions:

  • r

config generate-minimal-conf

Generate a minimal ceph.conf file

Example command:

ceph config generate-minimal-conf

Ceph Module:

  • config

Required Permissions:

  • r

config get

Show configuration option(s) for an entity

Example command:

ceph config get string my_key

Parameters:

  • who: (string)

  • key: (string)

Ceph Module:

  • config

Required Permissions:

  • r

config help

Describe a configuration option

Example command:

ceph config help my_key

Parameters:

  • key: (string)

Ceph Module:

  • config

Required Permissions:

  • r

config log

Show recent history of config changes

Example command:

ceph config log 1

Parameters:

  • num: CephInt

Ceph Module:

  • config

Required Permissions:

  • r

config ls

List available configuration options

Example command:

ceph config ls

Ceph Module:

  • config

Required Permissions:

  • r

config reset

Revert configuration to a historical version specified by <num>

Example command:

ceph config reset 1

Parameters:

  • num: CephInt range= 0

Ceph Module:

  • config

Required Permissions:

  • rw

config rm

Clear a configuration option for one or more entities

Example command:

ceph config rm string my_name

Parameters:

  • who: (string)

  • name: (string)

Ceph Module:

  • config

Required Permissions:

  • rw

config set

Set a configuration option for one or more entities

Example command:

ceph config set --who=string --name=string --value=string --force

Parameters:

  • who: (string)

  • name: (string)

  • value: (string)

  • force: CephBool

Ceph Module:

  • config

Required Permissions:

  • rw

config show

Show running configuration

Example command:

ceph config show string my_key

Parameters:

  • who: (string)

  • key: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

config show-with-defaults

Show running configuration (including compiled-in defaults)

Example command:

ceph config show-with-defaults string

Parameters:

  • who: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

config-key del

delete <key>

Example command:

ceph config-key del my_key

Parameters:

  • key: (string)

Ceph Module:

  • config-key

Required Permissions:

  • rw

Command Flags:

  • deprecated

config-key dump

dump keys and values (with optional prefix)

Example command:

ceph config-key dump my_key

Parameters:

  • key: (string)

Ceph Module:

  • config-key

Required Permissions:

  • r

config-key exists

check for <key>’s existence

Example command:

ceph config-key exists my_key

Parameters:

  • key: (string)

Ceph Module:

  • config-key

Required Permissions:

  • r

config-key get

get <key>

Example command:

ceph config-key get my_key

Parameters:

  • key: (string)

Ceph Module:

  • config-key

Required Permissions:

  • r

config-key list

list keys

Example command:

ceph config-key list

Ceph Module:

  • config-key

Required Permissions:

  • r

Command Flags:

  • deprecated

config-key ls

list keys

Example command:

ceph config-key ls

Ceph Module:

  • config-key

Required Permissions:

  • r

config-key put

put <key>, value <val>

Example command:

ceph config-key put my_key my_val

Parameters:

  • key: (string)

  • val: (string)

Ceph Module:

  • config-key

Required Permissions:

  • rw

Command Flags:

  • deprecated

config-key rm

rm <key>

Example command:

ceph config-key rm my_key

Parameters:

  • key: (string)

Ceph Module:

  • config-key

Required Permissions:

  • rw

config-key set

set <key> to value <val>

Example command:

ceph config-key set my_key my_val

Parameters:

  • key: (string)

  • val: (string)

Ceph Module:

  • config-key

Required Permissions:

  • rw

connection scores dump

show the scores used in connectivity-based elections

Example command:

ceph connection scores dump

Ceph Module:

  • mon

Required Permissions:

  • rwx

connection scores reset

reset the scores used in connectivity-based elections

Example command:

ceph connection scores reset

Ceph Module:

  • mon

Required Permissions:

  • rwx

device info

Show information about a device

Example command:

ceph device info my_devid

Parameters:

  • devid: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

device ls

Show devices

Example command:

ceph device ls

Ceph Module:

  • mgr

Required Permissions:

  • r

device ls-by-daemon

Show devices associated with a daemon

Example command:

ceph device ls-by-daemon string

Parameters:

  • who: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

device ls-by-host

Show devices on a host

Example command:

ceph device ls-by-host my_host

Parameters:

  • host: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

device rm-life-expectancy

Clear predicted device life expectancy

Example command:

ceph device rm-life-expectancy my_devid

Parameters:

  • devid: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

device set-life-expectancy

Set predicted device life expectancy

Example command:

ceph device set-life-expectancy my_devid my_from my_to

Parameters:

  • devid: (string)

  • from: (string)

  • to: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

df

show cluster free space stats

Example command:

ceph df detail

Parameters:

  • detail: CephChoices strings=(detail)

Ceph Module:

  • mon

Required Permissions:

  • r

dump_historic_ops

show recent ops

Example command:

ceph dump_historic_ops

Ceph Module:

  • mon

Required Permissions:

  • r

dump_historic_slow_ops

show recent slow ops

Example command:

ceph dump_historic_slow_ops

Ceph Module:

  • mon

Required Permissions:

  • r

features

report of connected features

Example command:

ceph features

Ceph Module:

  • mon

Required Permissions:

  • r

fs add_data_pool

add data pool <pool>

Example command:

ceph fs add_data_pool my_fs_name my_pool

Parameters:

  • fs_name: (string)

  • pool: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

fs authorize

add auth for <entity> to access file system <filesystem> based on following directory and permissions pairs

Example command:

ceph fs authorize --filesystem=string --entity=string --caps=string

Parameters:

  • filesystem: (string)

  • entity: (string)

  • caps: (can be repeated)

Ceph Module:

  • auth

Required Permissions:

  • rwx

fs compat

manipulate compat settings

Example command:

ceph fs compat --fs_name=string --subop=rm_compat --feature=1 --feature_str=string

Parameters:

  • fs_name: (string)

  • subop: CephChoices strings=(rm_compat rm_incompat add_compat add_incompat)

  • feature: CephInt

  • feature_str: (string)

Ceph Module:

  • fs

Required Permissions:

  • rw

fs compat show

show fs compatibility settings

Example command:

ceph fs compat show my_fs_name

Parameters:

  • fs_name: (string)

Ceph Module:

  • mds

Required Permissions:

  • r

fs dump

dump all CephFS status, optionally from epoch

Example command:

ceph fs dump 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • mds

Required Permissions:

  • r

fs fail

bring the file system down and all of its ranks

Example command:

ceph fs fail my_fs_name

Parameters:

  • fs_name: (string)

Ceph Module:

  • fs

Required Permissions:

  • rw

fs feature ls

list available cephfs features to be set/unset

Example command:

ceph fs feature ls

Ceph Module:

  • mds

Required Permissions:

  • r

fs flag set

Set a global CephFS flag

Example command:

ceph fs flag set enable_multiple my_val --yes_i_really_mean_it

Parameters:

  • flag_name: CephChoices strings=(enable_multiple)

  • val: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • fs

Required Permissions:

  • rw

fs get

get info about one filesystem

Example command:

ceph fs get my_fs_name

Parameters:

  • fs_name: (string)

Ceph Module:

  • fs

Required Permissions:

  • r

fs ls

list filesystems

Example command:

ceph fs ls

Ceph Module:

  • fs

Required Permissions:

  • r

fs mirror disable

disable mirroring for a ceph filesystem

Example command:

ceph fs mirror disable my_fs_name

Parameters:

  • fs_name: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

fs mirror enable

enable mirroring for a ceph filesystem

Example command:

ceph fs mirror enable my_fs_name

Parameters:

  • fs_name: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

fs mirror peer_add

add a mirror peer for a ceph filesystem

Example command:

ceph fs mirror peer_add --fs_name=string --uuid=string --remote_cluster_spec=string --remote_fs_name=string

Parameters:

  • fs_name: (string)

  • uuid: (string)

  • remote_cluster_spec: (string)

  • remote_fs_name: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

fs mirror peer_remove

remove a mirror peer for a ceph filesystem

Example command:

ceph fs mirror peer_remove my_fs_name my_uuid

Parameters:

  • fs_name: (string)

  • uuid: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

fs new

make new filesystem using named pools <metadata> and <data>

Example command:

ceph fs new --fs_name=string --metadata=string --data=string --force --allow_dangerous_metadata_overlay --fscid=0 --recover

Parameters:

  • fs_name: goodchars= [A-Za-z0-9-_.]

  • metadata: (string)

  • data: (string)

  • force: CephBool

  • allow_dangerous_metadata_overlay: CephBool

  • fscid: CephInt range= 0

  • recover: CephBool

Ceph Module:

  • fs

Required Permissions:

  • rw

fs required_client_features

add/remove required features of clients

Example command:

ceph fs required_client_features my_fs_name add my_val

Parameters:

  • fs_name: (string)

  • subop: CephChoices strings=(add rm)

  • val: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

fs reset

disaster recovery only: reset to a single-MDS map

Example command:

ceph fs reset my_fs_name --yes_i_really_mean_it

Parameters:

  • fs_name: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • fs

Required Permissions:

  • rw

fs rm

disable the named filesystem

Example command:

ceph fs rm my_fs_name --yes_i_really_mean_it

Parameters:

  • fs_name: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • fs

Required Permissions:

  • rw

fs rm_data_pool

remove data pool <pool>

Example command:

ceph fs rm_data_pool my_fs_name my_pool

Parameters:

  • fs_name: (string)

  • pool: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

fs set

set fs parameter <var> to <val>

Example command:

ceph fs set --fs_name=string --var=max_mds --val=string --yes_i_really_mean_it --yes_i_really_really_mean_it

Parameters:

  • fs_name: (string)

  • var: CephChoices strings=(max_mds max_file_size allow_new_snaps inline_data cluster_down allow_dirfrags balancer standby_count_wanted session_timeout session_autoclose allow_standby_replay down joinable min_compat_client)

  • val: (string)

  • yes_i_really_mean_it: CephBool

  • yes_i_really_really_mean_it: CephBool

Ceph Module:

  • mds

Required Permissions:

  • rw

fs set-default

set the default to the named filesystem

Example command:

ceph fs set-default my_fs_name

Parameters:

  • fs_name: (string)

Ceph Module:

  • fs

Required Permissions:

  • rw

fs set_default

set the default to the named filesystem

Example command:

ceph fs set_default my_fs_name

Parameters:

  • fs_name: (string)

Ceph Module:

  • fs

Required Permissions:

  • rw

Command Flags:

  • deprecated

fsid

show cluster FSID/UUID

Example command:

ceph fsid

Ceph Module:

  • mon

Required Permissions:

  • r

health

show cluster health

Example command:

ceph health detail

Parameters:

  • detail: CephChoices strings=(detail)

Ceph Module:

  • mon

Required Permissions:

  • r

health mute

mute health alert

Example command:

ceph health mute my_code my_ttl --sticky

Parameters:

  • code: (string)

  • ttl: (string)

  • sticky: CephBool

Ceph Module:

  • mon

Required Permissions:

  • w

health unmute

unmute existing health alert mute(s)

Example command:

ceph health unmute my_code

Parameters:

  • code: (string)

Ceph Module:

  • mon

Required Permissions:

  • w

heap

show heap usage info (available only if compiled with tcmalloc)

Example command:

ceph heap dump my_value

Parameters:

  • heapcmd: CephChoices strings=(dump start_profiler stop_profiler release stats)

  • value: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

injectargs

inject config arguments into monitor

Example command:

ceph injectargs --injected_args=string

Parameters:

  • injected_args: (can be repeated)

Ceph Module:

  • mon

Required Permissions:

  • rw

log

log supplied text to the monitor log

Example command:

ceph log --logtext=string

Parameters:

  • logtext: (can be repeated)

Ceph Module:

  • mon

Required Permissions:

  • rw

log last

print last few lines of the cluster log

Example command:

ceph log last 1 debug *

Parameters:

  • num: CephInt range= 1

  • level: CephChoices strings=(debug info sec warn error)

  • channel: CephChoices strings=(* cluster audit cephadm)

Ceph Module:

  • mon

Required Permissions:

  • r

mds add_data_pool

add data pool <pool>

Example command:

ceph mds add_data_pool my_pool

Parameters:

  • pool: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds cluster_down

take MDS cluster down

Example command:

ceph mds cluster_down

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds cluster_up

bring MDS cluster up

Example command:

ceph mds cluster_up

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds compat rm_compat

remove compatible feature

Example command:

ceph mds compat rm_compat 1

Parameters:

  • feature: CephInt range= 0

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • deprecated

mds compat rm_incompat

remove incompatible feature

Example command:

ceph mds compat rm_incompat 1

Parameters:

  • feature: CephInt range= 0

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • deprecated

mds compat show

show mds compatibility settings

Example command:

ceph mds compat show

Ceph Module:

  • mds

Required Permissions:

  • r

Command Flags:

  • deprecated

mds count-metadata

count MDSs by metadata field property

Example command:

ceph mds count-metadata my_property

Parameters:

  • property: (string)

Ceph Module:

  • mds

Required Permissions:

  • r

mds deactivate

clean up specified MDS rank (use with set max_mds to shrink cluster)

Example command:

ceph mds deactivate my_role

Parameters:

  • role: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds dump

dump legacy MDS cluster info, optionally from epoch

Example command:

ceph mds dump 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • mds

Required Permissions:

  • r

Command Flags:

  • obsolete

mds fail

Mark MDS failed: trigger a failover if a standby is available

Example command:

ceph mds fail my_role_or_gid

Parameters:

  • role_or_gid: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

mds getmap

get MDS map, optionally from epoch

Example command:

ceph mds getmap 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • mds

Required Permissions:

  • r

Command Flags:

  • obsolete

mds metadata

fetch metadata for mds <role>

Example command:

ceph mds metadata string

Parameters:

  • who: (string)

Ceph Module:

  • mds

Required Permissions:

  • r

mds newfs

make new filesystem using pools <metadata> and <data>

Example command:

ceph mds newfs 1 1 --yes_i_really_mean_it

Parameters:

  • metadata: CephInt range= 0

  • data: CephInt range= 0

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds ok-to-stop

check whether stopping the specified MDS would reduce immediate availability

Example command:

ceph mds ok-to-stop --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • mds

Required Permissions:

  • r

mds remove_data_pool

remove data pool <pool>

Example command:

ceph mds remove_data_pool my_pool

Parameters:

  • pool: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds repaired

mark a damaged MDS rank as no longer damaged

Example command:

ceph mds repaired my_role

Parameters:

  • role: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

mds rm

remove nonactive mds

Example command:

ceph mds rm 1

Parameters:

  • gid: CephInt range= 0

Ceph Module:

  • mds

Required Permissions:

  • rw

mds rm_data_pool

remove data pool <pool>

Example command:

ceph mds rm_data_pool my_pool

Parameters:

  • pool: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds set

set mds parameter <var> to <val>

Example command:

ceph mds set max_mds my_val --yes_i_really_mean_it

Parameters:

  • var: CephChoices strings=(max_mds max_file_size inline_data allow_new_snaps allow_multimds allow_multimds_snaps allow_dirfrags)

  • val: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds set_max_mds

set max MDS index

Example command:

ceph mds set_max_mds 1

Parameters:

  • maxmds: CephInt range= 0

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds stop

stop mds

Example command:

ceph mds stop my_role

Parameters:

  • role: (string)

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds tell

send command to particular mds

Example command:

ceph mds tell --who=string --args=string

Parameters:

  • who: (string)

  • args: (can be repeated)

Ceph Module:

  • mds

Required Permissions:

  • rw

Command Flags:

  • obsolete

mds versions

check running versions of MDSs

Example command:

ceph mds versions

Ceph Module:

  • mds

Required Permissions:

  • r

mgr count-metadata

count ceph-mgr daemons by metadata field property

Example command:

ceph mgr count-metadata my_property

Parameters:

  • property: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

mgr dump

dump the latest MgrMap

Example command:

ceph mgr dump 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • mgr

Required Permissions:

  • r

mgr fail

treat the named manager daemon as failed

Example command:

ceph mgr fail string

Parameters:

  • who: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

mgr metadata

dump metadata for all daemons or a specific daemon

Example command:

ceph mgr metadata string

Parameters:

  • who: (string)

Ceph Module:

  • mgr

Required Permissions:

  • r

mgr module disable

disable mgr module

Example command:

ceph mgr module disable my_module

Parameters:

  • module: (string)

Ceph Module:

  • mgr

Required Permissions:

  • rw

mgr module enable

enable mgr module

Example command:

ceph mgr module enable my_module --force

Parameters:

  • module: (string)

  • force: CephChoices strings=(–force)

Ceph Module:

  • mgr

Required Permissions:

  • rw

mgr module ls

list active mgr modules

Example command:

ceph mgr module ls

Ceph Module:

  • mgr

Required Permissions:

  • r

mgr services

list service endpoints provided by mgr modules

Example command:

ceph mgr services

Ceph Module:

  • mgr

Required Permissions:

  • r

mgr stat

dump basic info about the mgr cluster state

Example command:

ceph mgr stat

Ceph Module:

  • mgr

Required Permissions:

  • r

mgr versions

check running versions of ceph-mgr daemons

Example command:

ceph mgr versions

Ceph Module:

  • mgr

Required Permissions:

  • r

mon add disallowed_leader

prevent the named mon from being a leader

Example command:

ceph mon add disallowed_leader my_name

Parameters:

  • name: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

mon add name=location,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=],req=false

add new monitor named <name> at <addr>, possibly with CRUSH location <location>

Example command:

ceph mon add name=location,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=],req=false my_name 0.0.0.0

Parameters:

  • name: (string)

  • addr: CephIPAddr

Ceph Module:

  • mon

Required Permissions:

  • rw

mon count-metadata

count mons by metadata field property

Example command:

ceph mon count-metadata my_property

Parameters:

  • property: (string)

Ceph Module:

  • mon

Required Permissions:

  • r

mon dump

dump formatted monmap (optionally from epoch)

Example command:

ceph mon dump 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • mon

Required Permissions:

  • r

mon enable-msgr2

enable the msgr2 protocol on port 3300

Example command:

ceph mon enable-msgr2

Ceph Module:

  • mon

Required Permissions:

  • rw

mon enable_stretch_mode

enable stretch mode, changing the peering rules and failure handling on all pools with <tiebreaker_mon> as the tiebreaker and setting <dividing_bucket> locations as the units for stretching across

Example command:

ceph mon enable_stretch_mode my_tiebreaker_mon my_new_crush_rule my_dividing_bucket

Parameters:

  • tiebreaker_mon: (string)

  • new_crush_rule: (string)

  • dividing_bucket: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

mon feature ls

list available mon map features to be set/unset

Example command:

ceph mon feature ls --with-value

Parameters:

  • with_value: CephChoices strings=(–with-value)

Ceph Module:

  • mon

Required Permissions:

  • r

mon feature set

set provided feature on mon map

Example command:

ceph mon feature set my_feature_name --yes_i_really_mean_it

Parameters:

  • feature_name: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • mon

Required Permissions:

  • rw

mon getmap

get monmap

Example command:

ceph mon getmap 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • mon

Required Permissions:

  • r

mon metadata

fetch metadata for mon <id>

Example command:

ceph mon metadata my_id

Parameters:

  • id: (string)

Ceph Module:

  • mon

Required Permissions:

  • r

mon ok-to-add-offline

check whether adding a mon and not starting it would break quorum

Example command:

ceph mon ok-to-add-offline

Ceph Module:

  • mon

Required Permissions:

  • r

mon ok-to-rm

check whether removing the specified mon would break quorum

Example command:

ceph mon ok-to-rm my_id

Parameters:

  • id: (string)

Ceph Module:

  • mon

Required Permissions:

  • r

mon ok-to-stop

check whether mon(s) can be safely stopped without reducing immediate availability

Example command:

ceph mon ok-to-stop --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • mon

Required Permissions:

  • r

mon remove

remove monitor named <name>

Example command:

ceph mon remove my_name

Parameters:

  • name: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

Command Flags:

  • deprecated

mon rm

remove monitor named <name>

Example command:

ceph mon rm my_name

Parameters:

  • name: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

mon rm disallowed_leader

allow the named mon to be a leader again

Example command:

ceph mon rm disallowed_leader my_name

Parameters:

  • name: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

mon scrub

scrub the monitor stores

Example command:

ceph mon scrub

Ceph Module:

  • mon

Required Permissions:

  • rw

mon set election_strategy

set the election strategy to use; choices classic, disallow, connectivity

Example command:

ceph mon set election_strategy my_strategy

Parameters:

  • strategy: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

mon set-addrs

set the addrs (IPs and ports) a specific monitor binds to

Example command:

ceph mon set-addrs my_name my_addrs

Parameters:

  • name: (string)

  • addrs: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

mon set-rank

set the rank for the specified mon

Example command:

ceph mon set-rank my_name 1

Parameters:

  • name: (string)

  • rank: CephInt

Ceph Module:

  • mon

Required Permissions:

  • rw

mon set-weight

set the weight for the specified mon

Example command:

ceph mon set-weight my_name 1

Parameters:

  • name: (string)

  • weight: CephInt range= 0..65535

Ceph Module:

  • mon

Required Permissions:

  • rw

mon set_location name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=]

specify location <args> for the monitor <name>, using CRUSH bucket names

Example command:

ceph mon set_location name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=] my_name

Parameters:

  • name: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

mon set_new_tiebreaker

switch the stretch tiebreaker to be the named mon

Example command:

ceph mon set_new_tiebreaker my_name --yes_i_really_mean_it

Parameters:

  • name: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • mon

Required Permissions:

  • rw

mon stat

summarize monitor status

Example command:

ceph mon stat

Ceph Module:

  • mon

Required Permissions:

  • r

mon versions

check running versions of monitors

Example command:

ceph mon versions

Ceph Module:

  • mon

Required Permissions:

  • r

mon_status

report status of monitors

Example command:

ceph mon_status

Ceph Module:

  • mon

Required Permissions:

  • r

node ls

list all nodes in cluster [type]

Example command:

ceph node ls all

Parameters:

  • type: CephChoices strings=(all osd mon mds mgr)

Ceph Module:

  • mon

Required Permissions:

  • r

ops

show the ops currently in flight

Example command:

ceph ops

Ceph Module:

  • mon

Required Permissions:

  • r

osd add-nodown

mark osd(s) <id> [<id>…] as nodown, or use <all|any> to mark all osds as nodown

Example command:

ceph osd add-nodown --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd add-noin

mark osd(s) <id> [<id>…] as noin, or use <all|any> to mark all osds as noin

Example command:

ceph osd add-noin --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd add-noout

mark osd(s) <id> [<id>…] as noout, or use <all|any> to mark all osds as noout

Example command:

ceph osd add-noout --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd add-noup

mark osd(s) <id> [<id>…] as noup, or use <all|any> to mark all osds as noup

Example command:

ceph osd add-noup --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd blacklist

add (optionally until <expire> seconds from now) or remove <addr> from blacklist

Example command:

ceph osd blacklist add entityaddr 0.0

Parameters:

  • blacklistop: CephChoices strings=(add rm)

  • addr: CephEntityAddr

  • expire: CephFloat range= 0.0

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd blacklist clear

clear all blacklisted clients

Example command:

ceph osd blacklist clear

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd blacklist ls

show blacklisted clients

Example command:

ceph osd blacklist ls

Ceph Module:

  • osd

Required Permissions:

  • r

Command Flags:

  • deprecated

osd blocked-by

print histogram of which OSDs are blocking their peers

Example command:

ceph osd blocked-by

Ceph Module:

  • osd

Required Permissions:

  • r

osd blocklist

add (optionally until <expire> seconds from now) or remove <addr> from blocklist

Example command:

ceph osd blocklist --blocklistop=add --addr=entityaddr --range=string --expire=0.0

Parameters:

  • blocklistop: CephChoices strings=(add rm)

  • addr: CephEntityAddr

  • range: goodchars= [range]

  • expire: CephFloat range= 0.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd blocklist clear

clear all blocklisted clients

Example command:

ceph osd blocklist clear

Ceph Module:

  • osd

Required Permissions:

  • rw

osd blocklist ls

show blocklisted clients

Example command:

ceph osd blocklist ls

Ceph Module:

  • osd

Required Permissions:

  • r

osd count-metadata

count OSDs by metadata field property

Example command:

ceph osd count-metadata my_property

Parameters:

  • property: (string)

Ceph Module:

  • osd

Required Permissions:

  • r

osd create

create new osd (with optional UUID and ID)

Example command:

ceph osd create uuid osd.0

Parameters:

  • uuid: CephUUID

  • id: CephOsdName

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd crush add name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=]

add or update crushmap position and weight for <name> with <weight> and location <args>

Example command:

ceph osd crush add name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=] osd.0 0.0

Parameters:

  • id: CephOsdName

  • weight: CephFloat range= 0.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush add-bucket name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=],req=false

add no-parent (probably root) crush bucket <name> of type <type> to location <args>

Example command:

ceph osd crush add-bucket name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=],req=false my_name my_type

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • type: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush class create

create crush device class <class>

Example command:

ceph osd crush class create my_class

Parameters:

  • class: goodchars= [A-Za-z0-9-_]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush class ls

list all crush device classes

Example command:

ceph osd crush class ls

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush class ls-osd

list all osds belonging to the specific <class>

Example command:

ceph osd crush class ls-osd my_class

Parameters:

  • class: goodchars= [A-Za-z0-9-_]

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush class rename

rename crush device class <srcname> to <dstname>

Example command:

ceph osd crush class rename my_srcname my_dstname

Parameters:

  • srcname: goodchars= [A-Za-z0-9-_]

  • dstname: goodchars= [A-Za-z0-9-_]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush class rm

remove crush device class <class>

Example command:

ceph osd crush class rm my_class

Parameters:

  • class: goodchars= [A-Za-z0-9-_]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush create-or-move name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=]

create entry or move existing entry for <name> <weight> at/to location <args>

Example command:

ceph osd crush create-or-move name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=] osd.0 0.0

Parameters:

  • id: CephOsdName

  • weight: CephFloat range= 0.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush dump

dump crush map

Example command:

ceph osd crush dump

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush get-device-class

get classes of specified osd(s) <id> [<id>…]

Example command:

ceph osd crush get-device-class --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush get-tunable

get crush tunable <tunable>

Example command:

ceph osd crush get-tunable straw_calc_version

Parameters:

  • tunable: CephChoices strings=(straw_calc_version)

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush ls

list items beneath a node in the CRUSH tree

Example command:

ceph osd crush ls my_node

Parameters:

  • node: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush move name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=]

move existing entry for <name> to location <args>

Example command:

ceph osd crush move name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=] my_name

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush remove

remove <name> from crush map (everywhere, or just at <ancestor>)

Example command:

ceph osd crush remove my_name my_ancestor

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • ancestor: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd crush rename-bucket

rename bucket <srcname> to <dstname>

Example command:

ceph osd crush rename-bucket my_srcname my_dstname

Parameters:

  • srcname: goodchars= [A-Za-z0-9-_.]

  • dstname: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush reweight

change <name>’s weight to <weight> in crush map

Example command:

ceph osd crush reweight my_name 0.0

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • weight: CephFloat range= 0.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush reweight-all

recalculate the weights for the tree to ensure they sum correctly

Example command:

ceph osd crush reweight-all

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush reweight-subtree

change all leaf items beneath <name> to <weight> in crush map

Example command:

ceph osd crush reweight-subtree my_name 0.0

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • weight: CephFloat range= 0.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush rm

remove <name> from crush map (everywhere, or just at <ancestor>)

Example command:

ceph osd crush rm my_name my_ancestor

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • ancestor: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush rm-device-class

remove class of the osd(s) <id> [<id>…],or use <all|any> to remove all.

Example command:

ceph osd crush rm-device-class --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush rule create-erasure name=profile,type=CephString,req=false,goodchars=[A-Za-z0-9-_.=]

create crush rule <name> for erasure coded pool created with <profile> (default default)

Example command:

ceph osd crush rule create-erasure name=profile,type=CephString,req=false,goodchars=[A-Za-z0-9-_.=] my_name

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush rule create-replicated

create crush rule <name> for replicated pool to start from <root>, replicate across buckets of type <type>, use devices of type <class> (ssd or hdd)

Example command:

ceph osd crush rule create-replicated --name=string --root=string --type=string --class=string

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • root: goodchars= [A-Za-z0-9-_.]

  • type: goodchars= [A-Za-z0-9-_.]

  • class: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush rule create-simple

create crush rule <name> to start from <root>, replicate across buckets of type <type>, using a choose mode of <firstn|indep> (default firstn; indep best for erasure pools)

Example command:

ceph osd crush rule create-simple --name=string --root=string --type=string --mode=firstn

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • root: goodchars= [A-Za-z0-9-_.]

  • type: goodchars= [A-Za-z0-9-_.]

  • mode: CephChoices strings=(firstn indep)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush rule dump

dump crush rule <name> (default all)

Example command:

ceph osd crush rule dump my_name

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush rule list

list crush rules

Example command:

ceph osd crush rule list

Ceph Module:

  • osd

Required Permissions:

  • r

Command Flags:

  • deprecated

osd crush rule ls

list crush rules

Example command:

ceph osd crush rule ls

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush rule ls-by-class

list all crush rules that reference the same <class>

Example command:

ceph osd crush rule ls-by-class my_class

Parameters:

  • class: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush rule rename

rename crush rule <srcname> to <dstname>

Example command:

ceph osd crush rule rename my_srcname my_dstname

Parameters:

  • srcname: goodchars= [A-Za-z0-9-_.]

  • dstname: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush rule rm

remove crush rule <name>

Example command:

ceph osd crush rule rm my_name

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush set

set crush map from input file

Example command:

ceph osd crush set 1

Parameters:

  • prior_version: CephInt

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush set name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=]

update crushmap position and weight for <name> to <weight> with location <args>

Example command:

ceph osd crush set name=args,type=CephString,n=N,goodchars=[A-Za-z0-9-_.=] osd.0 0.0

Parameters:

  • id: CephOsdName

  • weight: CephFloat range= 0.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush set-all-straw-buckets-to-straw2

convert all CRUSH current straw buckets to use the straw2 algorithm

Example command:

ceph osd crush set-all-straw-buckets-to-straw2

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush set-device-class

set the <class> of the osd(s) <id> [<id>…],or use <all|any> to set all.

Example command:

ceph osd crush set-device-class --class=string --ids=string

Parameters:

  • class: (string)

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush set-tunable

set crush tunable <tunable> to <value>

Example command:

ceph osd crush set-tunable straw_calc_version 1

Parameters:

  • tunable: CephChoices strings=(straw_calc_version)

  • value: CephInt

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush show-tunables

show current crush tunables

Example command:

ceph osd crush show-tunables

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush swap-bucket

swap existing bucket contents from (orphan) bucket <source> and <target>

Example command:

ceph osd crush swap-bucket my_source my_dest --yes_i_really_mean_it

Parameters:

  • source: goodchars= [A-Za-z0-9-_.]

  • dest: goodchars= [A-Za-z0-9-_.]

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush tree

dump crush buckets and items in a tree view

Example command:

ceph osd crush tree --show-shadow

Parameters:

  • shadow: CephChoices strings=(–show-shadow)

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush tunables

set crush tunables values to <profile>

Example command:

ceph osd crush tunables legacy

Parameters:

  • profile: CephChoices strings=(legacy argonaut bobtail firefly hammer jewel optimal default)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush weight-set create

create a weight-set for a given pool

Example command:

ceph osd crush weight-set create poolname flat

Parameters:

  • pool: CephPoolname

  • mode: CephChoices strings=(flat positional)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush weight-set create-compat

create a default backward-compatible weight-set

Example command:

ceph osd crush weight-set create-compat

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush weight-set dump

dump crush weight sets

Example command:

ceph osd crush weight-set dump

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush weight-set ls

list crush weight sets

Example command:

ceph osd crush weight-set ls

Ceph Module:

  • osd

Required Permissions:

  • r

osd crush weight-set reweight

set weight for an item (bucket or osd) in a pool’s weight-set

Example command:

ceph osd crush weight-set reweight --pool=poolname --item=string --weight=0.0

Parameters:

  • pool: CephPoolname

  • item: (string)

  • weight: CephFloat range= 0.0 (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush weight-set reweight-compat

set weight for an item (bucket or osd) in the backward-compatible weight-set

Example command:

ceph osd crush weight-set reweight-compat --item=string --weight=0.0

Parameters:

  • item: (string)

  • weight: CephFloat range= 0.0 (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush weight-set rm

remove the weight-set for a given pool

Example command:

ceph osd crush weight-set rm poolname

Parameters:

  • pool: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • rw

osd crush weight-set rm-compat

remove the backward-compatible weight-set

Example command:

ceph osd crush weight-set rm-compat

Ceph Module:

  • osd

Required Permissions:

  • rw

osd deep-scrub

initiate deep scrub on osd <who>, or use <all|any> to deep scrub all

Example command:

ceph osd deep-scrub string

Parameters:

  • who: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd destroy

mark osd as being destroyed. Keeps the ID intact (allowing reuse), but removes cephx keys, config-key data and lockbox keys, rendering data permanently unreadable.

Example command:

ceph osd destroy osd.0 --force --yes_i_really_mean_it

Parameters:

  • id: CephOsdName

  • force: CephBool

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd df

show OSD utilization

Example command:

ceph osd df plain class my_filter

Parameters:

  • output_method: CephChoices strings=(plain tree)

  • filter_by: CephChoices strings=(class name)

  • filter: (string)

Ceph Module:

  • osd

Required Permissions:

  • r

osd down

set osd(s) <id> [<id>…] down, or use <any|all> to set all osds down

Example command:

ceph osd down --ids=string --definitely_dead

Parameters:

  • ids: (can be repeated)

  • definitely_dead: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd dump

print summary of OSD map

Example command:

ceph osd dump 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • osd

Required Permissions:

  • r

osd erasure-code-profile get

get erasure code profile <name>

Example command:

ceph osd erasure-code-profile get my_name

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • r

osd erasure-code-profile ls

list all erasure code profiles

Example command:

ceph osd erasure-code-profile ls

Ceph Module:

  • osd

Required Permissions:

  • r

osd erasure-code-profile rm

remove erasure code profile <name>

Example command:

ceph osd erasure-code-profile rm my_name

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd erasure-code-profile set

create erasure code profile <name> with [<key[=value]> …] pairs. Add a –force at the end to override an existing profile (VERY DANGEROUS)

Example command:

ceph osd erasure-code-profile set --name=string --profile=string --force

Parameters:

  • name: goodchars= [A-Za-z0-9-_.]

  • profile: (can be repeated)

  • force: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd find

find osd <id> in the CRUSH map and show its location

Example command:

ceph osd find osd.0

Parameters:

  • id: CephOsdName

Ceph Module:

  • osd

Required Permissions:

  • r

osd force-create-pg

force creation of pg <pgid>

Example command:

ceph osd force-create-pg 0 --yes_i_really_mean_it

Parameters:

  • pgid: CephPgid

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd force_healthy_stretch_mode

force a healthy stretch mode, requiring the full number of CRUSH buckets to peer and letting all non-tiebreaker monitors be elected leader

Example command:

ceph osd force_healthy_stretch_mode --yes_i_really_mean_it

Parameters:

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd force_recovery_stretch_mode

try and force a recovery stretch mode, increasing the pool size to its non-failure value if currently degraded and all monitor buckets are up

Example command:

ceph osd force_recovery_stretch_mode --yes_i_really_mean_it

Parameters:

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd get-require-min-compat-client

get the minimum client version we will maintain compatibility with

Example command:

ceph osd get-require-min-compat-client

Ceph Module:

  • osd

Required Permissions:

  • r

osd getcrushmap

get CRUSH map

Example command:

ceph osd getcrushmap 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • osd

Required Permissions:

  • r

osd getmap

get OSD map

Example command:

ceph osd getmap 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • osd

Required Permissions:

  • r

osd getmaxosd

show largest OSD id

Example command:

ceph osd getmaxosd

Ceph Module:

  • osd

Required Permissions:

  • r

osd in

set osd(s) <id> [<id>…] in, can use <any|all> to automatically set all previously out osds in

Example command:

ceph osd in --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd info

print osd’s {id} information (instead of all osds from map)

Example command:

ceph osd info osd.0

Parameters:

  • id: CephOsdName

Ceph Module:

  • osd

Required Permissions:

  • r

osd last-stat-seq

get the last pg stats sequence number reported for this osd

Example command:

ceph osd last-stat-seq osd.0

Parameters:

  • id: CephOsdName

Ceph Module:

  • osd

Required Permissions:

  • r

osd lost

mark osd as permanently lost. THIS DESTROYS DATA IF NO MORE REPLICAS EXIST, BE CAREFUL

Example command:

ceph osd lost osd.0 --yes_i_really_mean_it

Parameters:

  • id: CephOsdName

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd ls

show all OSD ids

Example command:

ceph osd ls 1

Parameters:

  • epoch: CephInt range= 0

Ceph Module:

  • osd

Required Permissions:

  • r

osd ls-tree

show OSD ids under bucket <name> in the CRUSH map

Example command:

ceph osd ls-tree my_name 1

Parameters:

  • name: (string)

  • epoch: CephInt range= 0

Ceph Module:

  • osd

Required Permissions:

  • r

osd lspools

list pools

Example command:

ceph osd lspools

Ceph Module:

  • osd

Required Permissions:

  • r

Command Flags:

  • deprecated

osd map

find pg for <object> in <pool> with [namespace]

Example command:

ceph osd map poolname objectname my_nspace

Parameters:

  • pool: CephPoolname

  • object: CephObjectname

  • nspace: (string)

Ceph Module:

  • osd

Required Permissions:

  • r

osd metadata

fetch metadata for osd {id} (default all)

Example command:

ceph osd metadata osd.0

Parameters:

  • id: CephOsdName

Ceph Module:

  • osd

Required Permissions:

  • r

osd new

Create a new OSD. If supplied, the id to be replaced needs to exist and have been previously destroyed. Reads secrets from JSON file via -i <file> (see man page).

Example command:

ceph osd new uuid osd.0

Parameters:

  • uuid: CephUUID

  • id: CephOsdName

Ceph Module:

  • osd

Required Permissions:

  • rw

osd numa-status

show NUMA status of OSDs

Example command:

ceph osd numa-status

Ceph Module:

  • osd

Required Permissions:

  • r

osd ok-to-stop

check whether osd(s) can be safely stopped without reducing immediate data availability

Example command:

ceph osd ok-to-stop --ids=string --max=1

Parameters:

  • ids: (can be repeated)

  • max: CephInt

Ceph Module:

  • osd

Required Permissions:

  • r

osd out

set osd(s) <id> [<id>…] out, or use <any|all> to set all osds out

Example command:

ceph osd out --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pause

pause osd

Example command:

ceph osd pause

Ceph Module:

  • osd

Required Permissions:

  • rw

osd perf

print dump of OSD perf summary stats

Example command:

ceph osd perf

Ceph Module:

  • osd

Required Permissions:

  • r

osd pg-temp

set pg_temp mapping pgid:[<id> [<id>…]] (developers only)

Example command:

ceph osd pg-temp --pgid=0 --id=osd.0

Parameters:

  • pgid: CephPgid

  • id: CephOsdName (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pg-upmap

set pg_upmap mapping <pgid>:[<id> [<id>…]] (developers only)

Example command:

ceph osd pg-upmap --pgid=0 --id=osd.0

Parameters:

  • pgid: CephPgid

  • id: CephOsdName (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pg-upmap-items

set pg_upmap_items mapping <pgid>:{<id> to <id>, […]} (developers only)

Example command:

ceph osd pg-upmap-items --pgid=0 --id=osd.0

Parameters:

  • pgid: CephPgid

  • id: CephOsdName (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool application disable

disables use of an application <app> on pool <poolname>

Example command:

ceph osd pool application disable poolname my_app --yes_i_really_mean_it

Parameters:

  • pool: CephPoolname

  • app: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool application enable

enable use of an application <app> [cephfs,rbd,rgw] on pool <poolname>

Example command:

ceph osd pool application enable poolname my_app --yes_i_really_mean_it

Parameters:

  • pool: CephPoolname

  • app: goodchars= [A-Za-z0-9-_.]

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool application get

get value of key <key> of application <app> on pool <poolname>

Example command:

ceph osd pool application get poolname my_app my_key

Parameters:

  • pool: CephPoolname

  • app: (string)

  • key: (string)

Ceph Module:

  • osd

Required Permissions:

  • r

osd pool application rm

removes application <app> metadata key <key> on pool <poolname>

Example command:

ceph osd pool application rm poolname my_app my_key

Parameters:

  • pool: CephPoolname

  • app: (string)

  • key: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool application set name=value,type=CephString,goodchars=[A-Za-z0-9-_.=]

sets application <app> metadata key <key> to <value> on pool <poolname>

Example command:

ceph osd pool application set name=value,type=CephString,goodchars=[A-Za-z0-9-_.=] poolname my_app my_key

Parameters:

  • pool: CephPoolname

  • app: (string)

  • key: goodchars= [A-Za-z0-9-_.]

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool cancel-force-backfill

restore normal recovery priority of specified pool <who>

Example command:

ceph osd pool cancel-force-backfill --who=poolname

Parameters:

  • who: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool cancel-force-recovery

restore normal recovery priority of specified pool <who>

Example command:

ceph osd pool cancel-force-recovery --who=poolname

Parameters:

  • who: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool create

create pool

Example command:

ceph osd pool create --pool=poolname --pg_num=0 --pgp_num=0 --pool_type=replicated --erasure_code_profile=string --rule=string --expected_num_objects=0 --size=0 --pg_num_min=0 --pg_num_max=0 --autoscale_mode=on --bulk --target_size_bytes=0 --target_size_ratio=0.0

Parameters:

  • pool: CephPoolname

  • pg_num: CephInt range= 0

  • pgp_num: CephInt range= 0

  • pool_type: CephChoices strings=(replicated erasure)

  • erasure_code_profile: goodchars= [A-Za-z0-9-_.]

  • rule: (string)

  • expected_num_objects: CephInt range= 0

  • size: CephInt range= 0

  • pg_num_min: CephInt range= 0

  • pg_num_max: CephInt range= 0

  • autoscale_mode: CephChoices strings=(on off warn)

  • bulk: CephBool

  • target_size_bytes: CephInt range= 0

  • target_size_ratio: CephFloat range= 0.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool deep-scrub

initiate deep-scrub on pool <who>

Example command:

ceph osd pool deep-scrub --who=poolname

Parameters:

  • who: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool delete

delete pool

Example command:

ceph osd pool delete --pool=poolname --pool2=poolname --yes_i_really_really_mean_it --yes_i_really_really_mean_it_not_faking

Parameters:

  • pool: CephPoolname

  • pool2: CephPoolname

  • yes_i_really_really_mean_it: CephBool

  • yes_i_really_really_mean_it_not_faking: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd pool force-backfill

force backfill of specified pool <who> first

Example command:

ceph osd pool force-backfill --who=poolname

Parameters:

  • who: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool force-recovery

force recovery of specified pool <who> first

Example command:

ceph osd pool force-recovery --who=poolname

Parameters:

  • who: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool get

get pool parameter <var>

Example command:

ceph osd pool get poolname size

Parameters:

  • pool: CephPoolname

  • var: CephChoices strings=(size min_size pg_num pgp_num crush_rule hashpspool nodelete nopgchange nosizechange write_fadvise_dontneed noscrub nodeep-scrub hit_set_type hit_set_period hit_set_count hit_set_fpp use_gmt_hitset target_max_objects target_max_bytes cache_target_dirty_ratio cache_target_dirty_high_ratio cache_target_full_ratio cache_min_flush_age cache_min_evict_age erasure_code_profile min_read_recency_for_promote all min_write_recency_for_promote fast_read hit_set_grade_decay_rate hit_set_search_last_n scrub_min_interval scrub_max_interval deep_scrub_interval recovery_priority recovery_op_priority scrub_priority compression_mode compression_algorithm compression_required_ratio compression_max_blob_size compression_min_blob_size csum_type csum_min_block csum_max_block allow_ec_overwrites fingerprint_algorithm pg_autoscale_mode pg_autoscale_bias pg_num_min pg_num_max target_size_bytes target_size_ratio dedup_tier dedup_chunk_algorithm dedup_cdc_chunk_size bulk)

Ceph Module:

  • osd

Required Permissions:

  • r

osd pool get-quota

obtain object or byte limits for pool

Example command:

ceph osd pool get-quota poolname

Parameters:

  • pool: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • r

osd pool ls

list pools

Example command:

ceph osd pool ls detail

Parameters:

  • detail: CephChoices strings=(detail)

Ceph Module:

  • osd

Required Permissions:

  • r

osd pool mksnap

make snapshot <snap> in <pool>

Example command:

ceph osd pool mksnap poolname my_snap

Parameters:

  • pool: CephPoolname

  • snap: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool rename

rename <srcpool> to <destpool>

Example command:

ceph osd pool rename poolname poolname

Parameters:

  • srcpool: CephPoolname

  • destpool: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool repair

initiate repair on pool <who>

Example command:

ceph osd pool repair --who=poolname

Parameters:

  • who: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool rm

remove pool

Example command:

ceph osd pool rm --pool=poolname --pool2=poolname --yes_i_really_really_mean_it --yes_i_really_really_mean_it_not_faking

Parameters:

  • pool: CephPoolname

  • pool2: CephPoolname

  • yes_i_really_really_mean_it: CephBool

  • yes_i_really_really_mean_it_not_faking: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool rmsnap

remove snapshot <snap> from <pool>

Example command:

ceph osd pool rmsnap poolname my_snap

Parameters:

  • pool: CephPoolname

  • snap: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool scrub

initiate scrub on pool <who>

Example command:

ceph osd pool scrub --who=poolname

Parameters:

  • who: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool set

set pool parameter <var> to <val>

Example command:

ceph osd pool set --pool=poolname --var=size --val=string --yes_i_really_mean_it

Parameters:

  • pool: CephPoolname

  • var: CephChoices strings=(size min_size pg_num pgp_num pgp_num_actual crush_rule hashpspool nodelete nopgchange nosizechange write_fadvise_dontneed noscrub nodeep-scrub hit_set_type hit_set_period hit_set_count hit_set_fpp use_gmt_hitset target_max_bytes target_max_objects cache_target_dirty_ratio cache_target_dirty_high_ratio cache_target_full_ratio cache_min_flush_age cache_min_evict_age min_read_recency_for_promote min_write_recency_for_promote fast_read hit_set_grade_decay_rate hit_set_search_last_n scrub_min_interval scrub_max_interval deep_scrub_interval recovery_priority recovery_op_priority scrub_priority compression_mode compression_algorithm compression_required_ratio compression_max_blob_size compression_min_blob_size csum_type csum_min_block csum_max_block allow_ec_overwrites fingerprint_algorithm pg_autoscale_mode pg_autoscale_bias pg_num_min pg_num_max target_size_bytes target_size_ratio dedup_tier dedup_chunk_algorithm dedup_cdc_chunk_size bulk)

  • val: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool set-quota

set object or byte limit on pool

Example command:

ceph osd pool set-quota poolname max_objects my_val

Parameters:

  • pool: CephPoolname

  • field: CephChoices strings=(max_objects max_bytes)

  • val: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd pool stats

obtain stats from all pools, or from specified pool

Example command:

ceph osd pool stats poolname

Parameters:

  • pool_name: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • r

osd primary-affinity

adjust osd primary-affinity from 0.0 <= <weight> <= 1.0

Example command:

ceph osd primary-affinity osd.0 0.0

Parameters:

  • id: CephOsdName

  • weight: CephFloat range= 0.0..1.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd primary-temp

set primary_temp mapping pgid:<id>|-1 (developers only)

Example command:

ceph osd primary-temp 0 osd.0

Parameters:

  • pgid: CephPgid

  • id: CephOsdName

Ceph Module:

  • osd

Required Permissions:

  • rw

osd purge

purge all osd data from the monitors including the OSD id and CRUSH position

Example command:

ceph osd purge osd.0 --force --yes_i_really_mean_it

Parameters:

  • id: CephOsdName

  • force: CephBool

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd purge-new

purge all traces of an OSD that was partially created but never started

Example command:

ceph osd purge-new osd.0 --yes_i_really_mean_it

Parameters:

  • id: CephOsdName

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd repair

initiate repair on osd <who>, or use <all|any> to repair all

Example command:

ceph osd repair string

Parameters:

  • who: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd require-osd-release

set the minimum allowed OSD release to participate in the cluster

Example command:

ceph osd require-osd-release luminous --yes_i_really_mean_it

Parameters:

  • release: CephChoices strings=(luminous mimic nautilus octopus pacific)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd reweight

reweight osd to 0.0 < <weight> < 1.0

Example command:

ceph osd reweight osd.0 0.0

Parameters:

  • id: CephOsdName

  • weight: CephFloat range= 0.0..1.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd reweight-by-pg

reweight OSDs by PG distribution [overload-percentage-for- consideration, default 120]

Example command:

ceph osd reweight-by-pg --oload=1 --max_change=0.0 --max_osds=1 --pools=poolname

Parameters:

  • oload: CephInt

  • max_change: CephFloat

  • max_osds: CephInt

  • pools: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd reweight-by-utilization

reweight OSDs by utilization [overload-percentage-for-consideration, default 120]

Example command:

ceph osd reweight-by-utilization --oload=1 --max_change=0.0 --max_osds=1 --no_increasing=--no-increasing

Parameters:

  • oload: CephInt

  • max_change: CephFloat

  • max_osds: CephInt

  • no_increasing: CephChoices strings=(–no-increasing)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd reweightn

reweight osds with {<id>: <weight>,…}

Example command:

ceph osd reweightn my_weights

Parameters:

  • weights: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd rm

remove osd(s) <id> [<id>…], or use <any|all> to remove all osds

Example command:

ceph osd rm --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd rm-nodown

allow osd(s) <id> [<id>…] to be marked down (if they are currently marked as nodown), can use <all|any> to automatically filter out all nodown osds

Example command:

ceph osd rm-nodown --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd rm-noin

allow osd(s) <id> [<id>…] to be marked in (if they are currently marked as noin), can use <all|any> to automatically filter out all noin osds

Example command:

ceph osd rm-noin --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd rm-noout

allow osd(s) <id> [<id>…] to be marked out (if they are currently marked as noout), can use <all|any> to automatically filter out all noout osds

Example command:

ceph osd rm-noout --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd rm-noup

allow osd(s) <id> [<id>…] to be marked up (if they are currently marked as noup), can use <all|any> to automatically filter out all noup osds

Example command:

ceph osd rm-noup --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd rm-pg-upmap

clear pg_upmap mapping for <pgid> (developers only)

Example command:

ceph osd rm-pg-upmap 0

Parameters:

  • pgid: CephPgid

Ceph Module:

  • osd

Required Permissions:

  • rw

osd rm-pg-upmap-items

clear pg_upmap_items mapping for <pgid> (developers only)

Example command:

ceph osd rm-pg-upmap-items 0

Parameters:

  • pgid: CephPgid

Ceph Module:

  • osd

Required Permissions:

  • rw

osd safe-to-destroy

check whether osd(s) can be safely destroyed without reducing data durability

Example command:

ceph osd safe-to-destroy --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • r

osd scrub

initiate scrub on osd <who>, or use <all|any> to scrub all

Example command:

ceph osd scrub string

Parameters:

  • who: (string)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd set

set <key>

Example command:

ceph osd set full --yes_i_really_mean_it

Parameters:

  • key: CephChoices strings=(full pause noup nodown noout noin nobackfill norebalance norecover noscrub nodeep-scrub notieragent nosnaptrim pglog_hardlimit)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd set-backfillfull-ratio

set usage ratio at which OSDs are marked too full to backfill

Example command:

ceph osd set-backfillfull-ratio 0.0

Parameters:

  • ratio: CephFloat range= 0.0..1.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd set-full-ratio

set usage ratio at which OSDs are marked full

Example command:

ceph osd set-full-ratio 0.0

Parameters:

  • ratio: CephFloat range= 0.0..1.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd set-group

set <flags> for batch osds or crush nodes, <flags> must be a comma- separated subset of {noup,nodown,noin,noout}

Example command:

ceph osd set-group --flags=string --who=string

Parameters:

  • flags: (string)

  • who: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd set-nearfull-ratio

set usage ratio at which OSDs are marked near-full

Example command:

ceph osd set-nearfull-ratio 0.0

Parameters:

  • ratio: CephFloat range= 0.0..1.0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd set-require-min-compat-client

set the minimum client version we will maintain compatibility with

Example command:

ceph osd set-require-min-compat-client my_version --yes_i_really_mean_it

Parameters:

  • version: (string)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd setcrushmap

set crush map from input file

Example command:

ceph osd setcrushmap 1

Parameters:

  • prior_version: CephInt

Ceph Module:

  • osd

Required Permissions:

  • rw

osd setmaxosd

set new maximum osd value

Example command:

ceph osd setmaxosd 1

Parameters:

  • newmax: CephInt range= 0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd stat

print summary of OSD map

Example command:

ceph osd stat

Ceph Module:

  • osd

Required Permissions:

  • r

osd stop

stop the corresponding osd daemons and mark them as down

Example command:

ceph osd stop --ids=string

Parameters:

  • ids: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd test-reweight-by-pg

dry run of reweight OSDs by PG distribution [overload-percentage-for- consideration, default 120]

Example command:

ceph osd test-reweight-by-pg --oload=1 --max_change=0.0 --max_osds=1 --pools=poolname

Parameters:

  • oload: CephInt

  • max_change: CephFloat

  • max_osds: CephInt

  • pools: CephPoolname (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • r

osd test-reweight-by-utilization

dry run of reweight OSDs by utilization [overload-percentage-for- consideration, default 120]

Example command:

ceph osd test-reweight-by-utilization --oload=1 --max_change=0.0 --max_osds=1 --no_increasing

Parameters:

  • oload: CephInt

  • max_change: CephFloat

  • max_osds: CephInt

  • no_increasing: CephBool

Ceph Module:

  • osd

Required Permissions:

  • r

osd tier add

add the tier <tierpool> (the second one) to base pool <pool> (the first one)

Example command:

ceph osd tier add poolname poolname --force-nonempty

Parameters:

  • pool: CephPoolname

  • tierpool: CephPoolname

  • force_nonempty: CephChoices strings=(–force-nonempty)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd tier add-cache

add a cache <tierpool> (the second one) of size <size> to existing pool <pool> (the first one)

Example command:

ceph osd tier add-cache poolname poolname 1

Parameters:

  • pool: CephPoolname

  • tierpool: CephPoolname

  • size: CephInt range= 0

Ceph Module:

  • osd

Required Permissions:

  • rw

osd tier cache-mode

specify the caching mode for cache tier <pool>

Example command:

ceph osd tier cache-mode poolname writeback --yes_i_really_mean_it

Parameters:

  • pool: CephPoolname

  • mode: CephChoices strings=(writeback readproxy readonly none)

  • yes_i_really_mean_it: CephBool

Ceph Module:

  • osd

Required Permissions:

  • rw

osd tier remove

remove the tier <tierpool> (the second one) from base pool <pool> (the first one)

Example command:

ceph osd tier remove poolname poolname

Parameters:

  • pool: CephPoolname

  • tierpool: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd tier remove-overlay

remove the overlay pool for base pool <pool>

Example command:

ceph osd tier remove-overlay poolname

Parameters:

  • pool: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • rw

Command Flags:

  • deprecated

osd tier rm

remove the tier <tierpool> (the second one) from base pool <pool> (the first one)

Example command:

ceph osd tier rm poolname poolname

Parameters:

  • pool: CephPoolname

  • tierpool: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • rw

osd tier rm-overlay

remove the overlay pool for base pool <pool>

Example command:

ceph osd tier rm-overlay poolname

Parameters:

  • pool: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • rw

osd tier set-overlay

set the overlay pool for base pool <pool> to be <overlaypool>

Example command:

ceph osd tier set-overlay poolname poolname

Parameters:

  • pool: CephPoolname

  • overlaypool: CephPoolname

Ceph Module:

  • osd

Required Permissions:

  • rw

osd tree

print OSD tree

Example command:

ceph osd tree --epoch=0 --states=up

Parameters:

  • epoch: CephInt range= 0

  • states: CephChoices strings=(up down in out destroyed) (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • r

osd tree-from

print OSD tree in bucket

Example command:

ceph osd tree-from --bucket=string --epoch=0 --states=up

Parameters:

  • bucket: (string)

  • epoch: CephInt range= 0

  • states: CephChoices strings=(up down in out destroyed) (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • r

osd unpause

unpause osd

Example command:

ceph osd unpause

Ceph Module:

  • osd

Required Permissions:

  • rw

osd unset

unset <key>

Example command:

ceph osd unset full

Parameters:

  • key: CephChoices strings=(full pause noup nodown noout noin nobackfill norebalance norecover noscrub nodeep-scrub notieragent nosnaptrim)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd unset-group

unset <flags> for batch osds or crush nodes, <flags> must be a comma- separated subset of {noup,nodown,noin,noout}

Example command:

ceph osd unset-group --flags=string --who=string

Parameters:

  • flags: (string)

  • who: (can be repeated)

Ceph Module:

  • osd

Required Permissions:

  • rw

osd utilization

get basic pg distribution stats

Example command:

ceph osd utilization

Ceph Module:

  • osd

Required Permissions:

  • r

osd versions

check running versions of OSDs

Example command:

ceph osd versions

Ceph Module:

  • osd

Required Permissions:

  • r

pg cancel-force-backfill

restore normal backfill priority of <pgid>

Example command:

ceph pg cancel-force-backfill --pgid=0

Parameters:

  • pgid: CephPgid (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • rw

pg cancel-force-recovery

restore normal recovery priority of <pgid>

Example command:

ceph pg cancel-force-recovery --pgid=0

Parameters:

  • pgid: CephPgid (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • rw

pg debug

show debug info about pgs

Example command:

ceph pg debug unfound_objects_exist

Parameters:

  • debugop: CephChoices strings=(unfound_objects_exist degraded_pgs_exist)

Ceph Module:

  • pg

Required Permissions:

  • r

pg deep-scrub

start deep-scrub on <pgid>

Example command:

ceph pg deep-scrub 0

Parameters:

  • pgid: CephPgid

Ceph Module:

  • pg

Required Permissions:

  • rw

pg dump

show human-readable versions of pg map (only ‘all’ valid with plain)

Example command:

ceph pg dump --dumpcontents=all

Parameters:

  • dumpcontents: CephChoices strings=(all summary sum delta pools osds pgs pgs_brief) (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • r

pg dump_json

show human-readable version of pg map in json only

Example command:

ceph pg dump_json --dumpcontents=all

Parameters:

  • dumpcontents: CephChoices strings=(all summary sum pools osds pgs) (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • r

pg dump_pools_json

show pg pools info in json only

Example command:

ceph pg dump_pools_json

Ceph Module:

  • pg

Required Permissions:

  • r

pg dump_stuck

show information about stuck pgs

Example command:

ceph pg dump_stuck --stuckops=inactive --threshold=1

Parameters:

  • stuckops: CephChoices strings=(inactive unclean stale undersized degraded) (can be repeated)

  • threshold: CephInt

Ceph Module:

  • pg

Required Permissions:

  • r

pg force-backfill

force backfill of <pgid> first

Example command:

ceph pg force-backfill --pgid=0

Parameters:

  • pgid: CephPgid (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • rw

pg force-recovery

force recovery of <pgid> first

Example command:

ceph pg force-recovery --pgid=0

Parameters:

  • pgid: CephPgid (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • rw

pg getmap

get binary pg map to -o/stdout

Example command:

ceph pg getmap

Ceph Module:

  • pg

Required Permissions:

  • r

pg ls

list pg with specific pool, osd, state

Example command:

ceph pg ls --pool=1 --states=string

Parameters:

  • pool: CephInt

  • states: (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • r

pg ls-by-osd

list pg on osd [osd]

Example command:

ceph pg ls-by-osd --osd=osd.0 --pool=1 --states=string

Parameters:

  • osd: CephOsdName

  • pool: CephInt

  • states: (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • r

pg ls-by-pool

list pg with pool = [poolname]

Example command:

ceph pg ls-by-pool --poolstr=string --states=string

Parameters:

  • poolstr: (string)

  • states: (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • r

pg ls-by-primary

list pg with primary = [osd]

Example command:

ceph pg ls-by-primary --osd=osd.0 --pool=1 --states=string

Parameters:

  • osd: CephOsdName

  • pool: CephInt

  • states: (can be repeated)

Ceph Module:

  • pg

Required Permissions:

  • r

pg map

show mapping of pg to osds

Example command:

ceph pg map 0

Parameters:

  • pgid: CephPgid

Ceph Module:

  • pg

Required Permissions:

  • r

pg repair

start repair on <pgid>

Example command:

ceph pg repair 0

Parameters:

  • pgid: CephPgid

Ceph Module:

  • pg

Required Permissions:

  • rw

pg repeer

force a PG to repeer

Example command:

ceph pg repeer 0

Parameters:

  • pgid: CephPgid

Ceph Module:

  • osd

Required Permissions:

  • rw

pg scrub

start scrub on <pgid>

Example command:

ceph pg scrub 0

Parameters:

  • pgid: CephPgid

Ceph Module:

  • pg

Required Permissions:

  • rw

pg stat

show placement group status.

Example command:

ceph pg stat

Ceph Module:

  • pg

Required Permissions:

  • r

quorum enter

force monitor back into quorum

Example command:

ceph quorum enter

Ceph Module:

  • mon

Required Permissions:

  • rw

quorum exit

force monitor out of the quorum

Example command:

ceph quorum exit

Ceph Module:

  • mon

Required Permissions:

  • rw

quorum_status

report status of monitor quorum

Example command:

ceph quorum_status

Ceph Module:

  • mon

Required Permissions:

  • r

report

report full status of cluster, optional title tag strings

Example command:

ceph report --tags=string

Parameters:

  • tags: (can be repeated)

Ceph Module:

  • mon

Required Permissions:

  • r

scrub

scrub the monitor stores

Example command:

ceph scrub

Ceph Module:

  • mon

Required Permissions:

  • rw

Command Flags:

  • obsolete

service dump

dump service map

Example command:

ceph service dump

Ceph Module:

  • service

Required Permissions:

  • r

service status

dump service state

Example command:

ceph service status

Ceph Module:

  • service

Required Permissions:

  • r

sessions

list existing sessions

Example command:

ceph sessions

Ceph Module:

  • mon

Required Permissions:

  • r

smart

Query health metrics for underlying device

Example command:

ceph smart my_devid

Parameters:

  • devid: (string)

Ceph Module:

  • mon

Required Permissions:

  • rw

status

show cluster status

Example command:

ceph status

Ceph Module:

  • mon

Required Permissions:

  • r

sync_force

force sync of and clear monitor store

Example command:

ceph sync_force --yes-i-really-mean-it

Parameters:

  • validate: CephChoices strings=(–yes-i-really-mean-it)

Ceph Module:

  • mon

Required Permissions:

  • rw

tell

send a command to a specific daemon

Example command:

ceph tell --target=name --args=string

Parameters:

  • target: CephName

  • args: (can be repeated)

Ceph Module:

  • mon

Required Permissions:

  • rw

time-sync-status

show time sync status

Example command:

ceph time-sync-status

Ceph Module:

  • mon

Required Permissions:

  • r

version

show mon daemon version

Example command:

ceph version

Ceph Module:

  • mon

Required Permissions:

  • r

versions

check running versions of ceph daemons

Example command:

ceph versions

Ceph Module:

  • mon

Required Permissions:

  • r