cephadm

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-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-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-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-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

dashboard

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-issue-tracker-api-key

Get the ISSUE_TRACKER_API_KEY option value

Example command

ceph dashboard get-issue-tracker-api-key

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-issue-tracker-api-key

Reset the ISSUE_TRACKER_API_KEY option to its default value

Example command

ceph dashboard reset-issue-tracker-api-key

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-issue-tracker-api-key

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

Example command

ceph dashboard set-issue-tracker-api-key

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

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

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 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 rename

Rename a CephFS volume by passing –yes-i-really-mean-it flag

Example command

ceph fs volume rename my_vol_name my_new_vol_name
  --yes_i_really_mean_it

Parameters

vol_name: goodchars= [A-Za-z0-9-_.]
new_vol_name: goodchars= [A-Za-z0-9-_.]
yes_i_really_mean_it: CephBool

Ceph Module

mgr

Required Permissions

rw

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

influx

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

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

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 rotate-key)
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 loki promtail mds rgw nfs iscsi 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 --method=raw

Parameters

–all_available_devices: CephBool
–format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)
–unmanaged: CephBool
–dry_run: CephBool
–no_overwrite: CephBool
–method: CephChoices strings=(raw lvm)

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
  --zonegroup=string --zone=string --port=1 --ssl --dry_run
  --format=plain --unmanaged --no_overwrite

Parameters

svc_id: (string)
placement: (string)
–realm: (string)
–zonegroup: (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, reconfig, or rotate-key for a specific daemon

Example command

ceph orch daemon start my_name

Parameters

action: CephChoices strings=(start stop restart reconfig rotate-key)
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 loki promtail mds rgw nfs iscsi 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 specific 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 high level host information

Example command

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

Parameters

–format: CephChoices strings=(plain json json-pretty yaml xml-pretty xml)
–host_pattern: (string)
–label: (string)
–host_status: (string)
–detail: CephBool

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
  --yes_i_really_mean_it

Parameters

hostname: (string)
–force: CephBool
–yes_i_really_mean_it: 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 set-managed

Set ‘unmanaged: false’ for the given service name

Example command

ceph orch set-managed my_service_name

Parameters

service_name: (string)

Ceph Module

mgr

Required Permissions

rw

Command Flags

mgr

orch set-unmanaged

Set ‘unmanaged: true’ for the given service name

Example command

ceph orch set-unmanaged my_service_name

Parameters

service_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 tuned-profile add-setting

Example command

ceph orch tuned-profile add-setting my_profile_name my_setting
  my_value

Parameters

profile_name: (string)
setting: (string)
value: (string)

Ceph Module

mgr

Required Permissions

rw

Command Flags

mgr

orch tuned-profile apply

Add or update a tuned profile

Example command

ceph orch tuned-profile apply --profile_name=string --placement=string
  --settings=string --no_overwrite

Parameters

profile_name: (string)
placement: (string)
settings: (string)
–no_overwrite: CephBool

Ceph Module

mgr

Required Permissions

rw

Command Flags

mgr

orch tuned-profile ls

Example command

ceph orch tuned-profile ls plain

Parameters

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

Ceph Module

mgr

Required Permissions

r

Command Flags

mgr

orch tuned-profile rm

Example command

ceph orch tuned-profile rm my_profile_name

Parameters

profile_name: (string)

Ceph Module

mgr

Required Permissions

rw

Command Flags

mgr

orch tuned-profile rm-setting

Example command

ceph orch tuned-profile rm-setting my_profile_name my_setting

Parameters

profile_name: (string)
setting: (string)

Ceph Module

mgr

Required Permissions

rw

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 --show_all_versions

Parameters

image: (string)
–tags: CephBool
–show_all_versions: 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 --daemon_types=string
  --hosts=string --services=string --limit=1 --ceph_version=string

Parameters

image: (string)
–daemon_types: (string)
–hosts: (string)
–services: (string)
–limit: CephInt
–ceph_version: (string)

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

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

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

restful

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

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

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 clear-pending

clear pending key

Example command

ceph auth clear-pending my_entity

Parameters

entity: (string)

Ceph Module

auth

Required Permissions

rwx

auth commit-pending

rotate pending key into active position

Example command

ceph auth commit-pending my_entity

Parameters

entity: (string)

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 get-or-create-pending

generate and/or retrieve existing pending key (rotated into place on first use)

Example command

ceph auth get-or-create-pending my_entity

Parameters

entity: (string)

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

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

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

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

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

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 lsflags

list the flags set on a ceph filesystem

Example command

ceph fs lsflags my_fs_name

Parameters

fs_name: (string)

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 rename

rename a ceph file system

Example command

ceph fs rename my_fs_name my_new_fs_name --yes_i_really_mean_it

Parameters

fs_name: (string)
new_fs_name: goodchars= [A-Za-z0-9-_.]
yes_i_really_mean_it: CephBool

Ceph Module

mds

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

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 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 metadata

fetch metadata for mds <role>

Example command

ceph mds metadata string

Parameters

who: (string)

Ceph Module

mds

Required Permissions

r

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 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 versions

check running versions of MDSs

Example command

ceph mds versions

Ceph Module

mds

Required Permissions

r

mgr

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: CephBool

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

mon add

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

Example command

ceph mon add --name=string --addr=0.0.0.0 --location=string

Parameters

name: (string)
addr: CephIPAddr
location: goodchars= [A-Za-z0-9-_.=] (can be repeated)

Ceph Module

mon

Required Permissions

rw

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 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: CephBool

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

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

Example command

ceph mon set_location --name=string --args=string

Parameters

name: (string)
args: goodchars= [A-Za-z0-9-_.=] (can be repeated)

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

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

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

Example command

ceph osd crush add --id=osd.0 --weight=0.0 --args=string

Parameters

id: CephOsdName
weight: CephFloat range= 0.0
args: goodchars= [A-Za-z0-9-_.=] (can be repeated)

Ceph Module

osd

Required Permissions

rw

osd crush add-bucket

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

Example command

ceph osd crush add-bucket --name=string --type=string --args=string

Parameters

name: goodchars= [A-Za-z0-9-_.]
type: (string)
args: goodchars= [A-Za-z0-9-_.=] (can be repeated)

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

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

Example command

ceph osd crush create-or-move --id=osd.0 --weight=0.0 --args=string

Parameters

id: CephOsdName
weight: CephFloat range= 0.0
args: goodchars= [A-Za-z0-9-_.=] (can be repeated)

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 link

link existing entry for <name> under location <args>

Example command

ceph osd crush link --name=string --args=string

Parameters

name: (string)
args: goodchars= [A-Za-z0-9-_.=] (can be repeated)

Ceph Module

osd

Required Permissions

rw

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

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

Example command

ceph osd crush move --name=string --args=string

Parameters

name: goodchars= [A-Za-z0-9-_.]
args: goodchars= [A-Za-z0-9-_.=] (can be repeated)

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

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

Example command

ceph osd crush rule create-erasure my_name my_profile

Parameters

name: goodchars= [A-Za-z0-9-_.]
profile: 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

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

Example command

ceph osd crush set --id=osd.0 --weight=0.0 --args=string

Parameters

id: CephOsdName
weight: CephFloat range= 0.0
args: goodchars= [A-Za-z0-9-_.=] (can be repeated)

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

show_shadow: CephBool

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 unlink

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

Example command

ceph osd crush unlink 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 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

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

Example command

ceph osd pool application set --pool=poolname --app=string
  --key=string --value=string

Parameters

pool: CephPoolname
app: (string)
key: goodchars= [A-Za-z0-9-_.]
value: 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 eio 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 eio 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 octopus --yes_i_really_mean_it

Parameters

release: CephChoices strings=(octopus pacific quincy)
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

Parameters

oload: CephInt
max_change: CephFloat
max_osds: CephInt
no_increasing: CephBool

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 noautoscale)
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: CephBool

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 noautoscale)

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

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

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

service

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

yes_i_really_mean_it: CephBool

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