On this page

How-to

Check your disks' health

The Disk health page shows each disk's own health report, its temperature and its age. Disks often warn of trouble weeks before they fail, so checking here can save your files.

Before you begin

  • Disk health is set up. Run ./install.sh again and answer Yes to Set up Disk health reports? The installer asks for your computer's password, because reading a disk's report needs administrator rights. You enter it in the terminal yourself. Read Change what Starboard can access.
  • The computer needs smartmontools, the program that reads the reports. The installer installs it if it is missing.

Once set up, a small job on the server reads every disk every 30 minutes. Starboard only reads the reports it saves.

Steps

  1. Go to System, then Storage, then Disk health.
  2. Read the tiles: how many disks are To check, the Hottest disk and the Oldest disk.
  3. Find each disk in the table, most urgent first. Its Status is one of these: - Healthy: nothing to do. - Needs attention: the disk has counted problems, such as damaged areas. - Failing: the disk failed its own health check. - Not reported: the report has no health result.
  4. To read everything about one disk, select SMART report in its row. SMART is the disk's own health record.
  5. Read the advice in the report. To keep a copy, select Download the full report.

Read the disks now

Select Read disks now to ask for new reports straight away. The button says Reading the disks…, and the new reports arrive in about a minute.

Things to note

  • Temperature: under 45°C is fine for a hard disk. Hot disks wear out sooner, so check the airflow around them.
  • Powered on: plan to replace a disk after about 5 years.
  • Temperature, last 30 days in each report is a chart of hourly readings. Starboard takes them while Disk health is open, or while it watches in the background.
  • Recent events lists self-tests and changes, newest first.
  • To be told when a disk reports a problem, read Activate alerts.
  • The ready-made image has no installer. Set up the job by hand with sudo deploy/install-smart.sh and a folder for the reports. Then share that folder with Starboard and set STARBOARD_SMART_DIR to it.

If it does not work

  • Disk health is not set up: answer Yes to Set up Disk health reports? in ./install.sh.
  • No SMART reports yet: the job has not run yet. Wait up to 30 minutes, then select Check again.
  • No Read disks now button: Starboard cannot ask for a reading. Run ./install.sh again to set Disk health up afresh.
  • Failing: back up what is on the disk now, and replace it. If it is a pool disk, read A pool disk has failed.
  • Needs attention: back up what is on the disk and plan to replace it. Check again after the next report to find out if the counts are rising.

Find out more

This page on GitHub, where the help is written.