[pbs-devel] [PATCH proxmox-backup 1/3] docs: tape: replace 'export-media' with 'export-media-set'

[pbs-devel] [PATCH proxmox-backup 1/3] docs: tape: replace 'export-media' with 'export-media-set'

[Dominik Csapak]

there is no 'export-media' option, only 'export-media-set'

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 docs/tape-backup.rst | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/tape-backup.rst b/docs/tape-backup.rst
index f54c00b8..cda84a6f 100644
--- a/docs/tape-backup.rst
+++ b/docs/tape-backup.rst
@@ -664,16 +664,16 @@ dust protection than inside a drive:
 
 .. Note:: For failed jobs, the tape remains in the drive.
 
-For tape libraries, the ``export-media`` option moves all tapes from
+For tape libraries, the ``export-media-set`` option moves all tapes from
 the media set to an export slot, making sure that the following backup
 cannot use the tapes. An operator can pick up those tapes and move them
 to a vault.
 
 .. code-block:: console
 
- # proxmox-tape backup-job update job2 --export-media
+ # proxmox-tape backup-job update job2 --export-media-set
 
-.. Note:: The ``export-media`` option can be used to force the start
+.. Note:: The ``export-media-set`` option can be used to force the start
    of a new media set, because tapes from the current set are no
    longer online.
 
-- 
2.30.2

[pbs-devel] [PATCH proxmox-backup 2/3] docs: tape: document advanced changer options

[Dominik Csapak]

there is currently only one, but describe what it does and how to set
options in general.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 docs/tape-backup.rst | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/docs/tape-backup.rst b/docs/tape-backup.rst
index cda84a6f..2d673374 100644
--- a/docs/tape-backup.rst
+++ b/docs/tape-backup.rst
@@ -326,6 +326,25 @@ the status output:
  │ slot          │       14 │            │             │
  └───────────────┴──────────┴────────────┴─────────────┘
 
+
+Advanced options
+^^^^^^^^^^^^^^^^
+
+Since not all tape changer behave the same, there is sometimes the need
+for configuring advanced options.
+
+Currently there are the following:
+
+* `eject-before-unload` : This is needed for some changers that require a tape
+  to be ejected before unloading from the drive.
+
+You can set these options with `proxmox-tape` like this:
+
+.. code-block:: console
+
+ # proxmox-tape changer update sl3 --options eject-before-unload=true
+
+
 .. _tape_drive_config:
 
 Tape drives
-- 
2.30.2

[pbs-devel] [PATCH proxmox-backup 3/3] docs: tape: add lto 9 considerations

[Dominik Csapak]

LTO-9 requires a bit of special handling while formatting/first use, so
document that, so nobody is suprised by this behaviour.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 docs/tape-backup.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/docs/tape-backup.rst b/docs/tape-backup.rst
index 2d673374..c528d578 100644
--- a/docs/tape-backup.rst
+++ b/docs/tape-backup.rst
@@ -98,6 +98,31 @@ so it takes 33 hours to read the 12TB needed to fill up an LTO-8 tape. If you wa
 to write to your tape at full speed, please make sure that the source
 datastore is able to deliver that performance (for example, by using SSDs).
 
+LTO-9+ considerations
+~~~~~~~~~~~~~~~~~~~~
+
+Since LTO-9, it is necessary to initialize new media in your drives, this is
+called `Media Optimization`. This usually takes between 40 and 120 minutes per
+medium. It is recommended to initialize your media in this manner with the
+tools provided by your hardware vendor of your drive or changer. Some tape
+changers have a method to 'bulk' initialize your media.
+
+Because of this, formatting tapes is handled differently in Proxmox Backup
+Server to avoid re-optimizing on each format/labelling. If you want to format
+your media for use with the Proxmox Backup Server the first time or after use
+with another program, either use the functionality of your drive/changer, or
+use the 'slow' format on the cli:
+
+.. code-block:: console
+
+ # proxmox-tape format --drive your-drive --fast 0
+
+This will completely remove all pre-existing data and trigger a `Media
+Optimization` pass.
+
+If you format a partitioned LTO-9 medium with the 'fast' method (the default or
+by setting `--fast 1`), only the first partition will be formatted, so make
+sure to use the 'slow' method.
 
 Terminology
 -----------
-- 
2.30.2

[pbs-devel] applied: [PATCH proxmox-backup 1/3] docs: tape: replace 'export-media' with 'export-media-set'

[Dietmar Maurer]

applied all three patches