Checking service status

Check the service status of the storage cluster, by using the ceph orch ls command.

Before you begin

Before you begin, make sure that you have the following prerequisites in place:
  • A running IBM Storage Ceph cluster.
  • Log in to the cephadm shell.

About this task

You can check the service status of the storage cluster with the ceph orch ls command. This command checks the status of the following services of the storage cluster:
  • Print a list of services.
  • Locate the service whose status you want to check.
  • Print the status of the service.
Note: If the services are applied with the ceph orch apply command while bootstrapping, changing the service specification file is complicated. Instead, you can use the --export option with the ceph orch ls command to export the running specification, update the yaml file, and reapply the service.

Procedure

  • Print a list of services.
    ceph orch ls [--service_type SERVICE_TYPE] [--service_name SERVICE_NAME] [--export] [--format FORMAT] [--refresh]

    The format can be plain, json, json-pretty, yaml, xml-pretty, or xml.

    For example,
    [ceph: root@host01 /]# ceph orch ls
  • Check the status of a particular service or a daemon.
    ceph orch ls [--service_type SERVICE_TYPE] [--service_name SERVICE_NAME] [--refresh]
    For example,
    ceph: root@host01 /]# ceph orch ls --service-type mds
    [ceph: root@host01 /]# ceph orch ls --service-name rgw.realm.myzone
  • Export the service specification.
    For example,
    [ceph: root@host01 /]# ceph orch ls --service-type mgr --export > mgr.yaml
    [ceph: root@host01 /]# ceph orch ls --export > cluster.yaml

    This exports the file in the .yaml file format. This file can be used with the ceph orch apply -i command to retrieve the service specification of a single service.