From 44ce25e7acfd4b4cc6722f3d87fec1f03a4b9b7b Mon Sep 17 00:00:00 2001 From: Dietmar Maurer Date: Fri, 8 Jan 2021 19:17:31 +0100 Subject: [PATCH] tape: docu - improve Administration section --- docs/tape-backup.rst | 23 ++++++++++++++++++++--- 1 file changed, 20 insertions(+), 3 deletions(-) diff --git a/docs/tape-backup.rst b/docs/tape-backup.rst index bc6a1bbd..42c2be3a 100644 --- a/docs/tape-backup.rst +++ b/docs/tape-backup.rst @@ -452,6 +452,23 @@ Tape Jobs Administration -------------- +Many sub-command of the ``proxmox-tape`` command line tools take a +parameter called ``--drive``, which specifies the tape drive you want +to work on. For convenience, you can set that in an environment +variable:: + + # export PROXMOX_TAPE_DRIVE=mydrive + +You can then omit the ``--drive`` parameter from the command. If the +drive has an associated changer device, you may also omit the changer +parameter from commands that needs a changer device, for example:: + + # proxmox-tape changer status + +Should displays the changer status of the changer device associated with +drive ``mydrive``. + + Label Tapes ~~~~~~~~~~~ @@ -469,20 +486,20 @@ Next, you need to write that same label text to the tape, so that the software can uniquely identify the tape too. For a standalone drive, manually insert the new tape cartidge into the -drive and run: +drive and run:: # proxmox-tape label --changer-id --drive .. Note:: For safety reasons, this command fails if the tape contain any data. If you want to overwrite it anways, erase the tape first. -You can verify success by reading back the label: +You can verify success by reading back the label:: # proxmox-tape read-label --drive If you have a tape library, apply the sticky barcode label to the tape cartridges first. Then load those empty tapes into the library. You -can then label all unlabeled tapes with a single command: +can then label all unlabeled tapes with a single command:: # proxmox-tape barcode-label --drive