10 Troubleshooting the Ceph Dashboard #

Verify the Ceph Dashboard module is enabled:

cephuser@adm > ceph mgr module ls

Ensure the Ceph Dashboard module is listed in the enabled_modules section. Example snipped output from the ceph mgr module ls command:

  {
      "always_on_modules": [
          "balancer",
          "crash",
          "devicehealth",
          "orchestrator",
          "osd_support",
          "pg_autoscaler",
          "progress",
          "rbd_support",
          "status",
          "telemetry",
          "volumes"
      ],
      "enabled_modules": [
          "dashboard",
          "iostat",
          "restful"
      ],
      "disabled_modules": [
          {
               ...
          }
      ]
  }

If it is not listed, activate the module with the following command:

cephuser@adm > ceph mgr module enable dashboard

Check the Ceph Manager log file for any errors. To do this, first you will need the name of the Ceph Manager daemon. Find this with the cephadm ls command. It will return output similar to the following snippet:

{ ... ,
  {
    "style": "cephadm:v1",
    "name": "mgr.master.jqxsqf",
    "fsid": "f09a96d0-2a55-11eb-a87b-525400c955e8",
    ...
  },
  ...
}

You can then use the name given by the command above to view the log file:

cephuser@adm > cephadm logs --name mgr.master.jqxsqf -- -f

Ensure the SSL/TSL support is configured properly:

cephuser@adm > ceph config-key get mgr/dashboard/key
cephuser@adm > ceph config-key get mgr/dashboard/crt

Verify the self-signed certificate exists. If not, run:

cephuser@adm > ceph dashboard create-self-signed-cert

See Section 10.1.1, “Creating self-signed certificates” for more information on self-signed certificates or Section 10.1.2, “Using certificates signed by CA” for information on self-signed certificates by CA.

Check that your user credentials are correct. If you are seeing the notification message above when trying to log into the Ceph Dashboard, it is likely you are using the wrong credentials. Double check your username and password, and ensure the caps lock key is not enabled by accident.

If your user credentials are correct, but you are experiencing the same error, check that the user account exists:

cephuser@adm > ceph dashboard ac-user-show USERNAME

This command returns your user data. If the user does not exist, it will print:

Error ENOENT: User USERNAME does not exist

In this case, you will need to create the user. See Section 11.2, “Managing user accounts” for more information on user accounts.

Check if the user is enabled:

cephuser@adm > ceph dashboard ac-user-show USERNAME {..., "enabled": true, ..}

Check if enabled is set to true for your user. If not the user is not enabled, run:

cephuser@adm > ceph dashboard ac-user-enable USERNAME

Check the Ceph Dashboard/mgr logfile(s) for any errors. These can be identified by searching for keywords, such as 500 Internal Server Error, followed by traceback. The end of a traceback contains more details about what exact error occurred.

Check your web browser's Javascript Console for any errors.