How-to
Use a disk as a backup disk
A backup disk is not part of the pool: it protects it. Starboard offers two kinds, parity and copy.
Which kind
| Parity, with SnapRAID (recommended) | Copy, with rsync | |
|---|---|---|
| Disks needed | One, at least as big as the biggest pool disk | Enough space for the folders copied |
| Protects | Every disk in the pool: one failed disk can be rebuilt | The folders you choose |
| Readable on its own | No: the files are rebuilt from it with the other disks | Yes: a plain copy |
| When | Every night at 02:00 | Every night at 02:00 |
| Files deleted in the pool | Can be got back until the next check | Moved to a dated .removed folder on the copy disk |
Neither is a full backup on its own. The backup disk is in the same computer, so keep a third copy of what matters somewhere else. Read Pools are not backups.
Before you begin
- The pool has at least one disk. Read Add a disk to the pool.
- For parity, the computer has SnapRAID:
sudo apt install snapraid
- Note the last 4 characters of the disk's serial number. A parity disk is always erased first.
- Have your Starboard password ready.
Steps
- Go to System, then Storage, then Pool, and select Add a disk.
- Choose the disk, then select Continue to What it is for.
- Under Use it, select Parity disk (recommended backup) or Copy disk.
- For a copy disk, enter the folders in the pool to copy, with commas between them, such as
media, photos. - Select Continue to Check, read the check, then select Continue to Confirm.
- Enter the end of the serial number if the disk is being erased, and your Starboard password.
- Select Erase and use as a backup disk, or Add the disk.
The first check runs that night at 02:00. Parity's first check reads every disk and can take many hours.
Things to note
- Backup disks on the Pool page shows the last check and its result, in words.
- If more than 5% of the files were deleted since the last check, the parity check does not run, so they can still be got back. Starboard says so. Check the pool; the next night's check then runs as usual.
- Once a week the parity check also re-reads 8% of the files, to find damage early.
- To stop using a backup disk, select Stop using beside it. The disk is not erased. Without a parity disk, nothing can rebuild a failed pool disk.
If it does not work
- Parity disk is not offered: the disk is smaller than the biggest pool disk, or the pool is empty.
- Install these first: snapraid: install SnapRAID, then try again.
- /etc/snapraid.conf was not written by Starboard: SnapRAID is already set up by hand on this computer, and Starboard leaves it alone.
- Check failed: read the message on the Pool page, then A pool disk has failed.
Find out more
This page on GitHub, where the help is written.