From a27f8f43e97850d82167870f5bd0ccef22fd8f3c Mon Sep 17 00:00:00 2001
From: Thomas Glatthor <Thomas.Glatthor@ic3s.de>
Date: Wed, 3 Sep 2008 09:46:16 +0000
Subject: [PATCH] tips about lsscsi tool and new command "status slots storage"

---
 docs/manuals/de/concepts/autochangers.tex | 35 +++++++++++++++++++++++
 docs/manuals/de/concepts/tutorial.tex     |  2 +-
 docs/manuals/de/console/bconsole.tex      |  7 +++--
 3 files changed, 41 insertions(+), 3 deletions(-)

diff --git a/docs/manuals/de/concepts/autochangers.tex b/docs/manuals/de/concepts/autochangers.tex
index e36ab588..2a0e5806 100644
--- a/docs/manuals/de/concepts/autochangers.tex
+++ b/docs/manuals/de/concepts/autochangers.tex
@@ -116,6 +116,20 @@ benutzen, um herauszufinden, welches das Autochanger-Kontroll-Device ist,
 ({\bf /dev/sg0} f\"{u}r die erste Zeile, {\bf /dev/sg1} f\"{u}r die zweite, ...)
 das Sie in der Konfiguration unter {\bf Changer Device = } angeben m\"{u}ssen.
 
+Falls verf\"{u}gbar k\"{o}nnen Sie auch das Kommando {\bf lsscsi} benutzen.
+Unten sehen Sie dazu ein Beispiel, das Changer-Device ist dabei mit {\bf mediumx}
+bezeichnet und entspricht dem Device {\bf /dev/sg10}.
+\footnotesize
+\begin{verbatim}
+$ lsscsi -g
+ [1:0:2:0]    tape    SEAGATE  ULTRIUM06242-XXX 1619  /dev/st0  /dev/sg9
+ [1:0:14:0]   mediumx STK      L180             0315  /dev/sch0 /dev/sg10
+ [2:0:3:0]    tape    HP       Ultrium 3-SCSI   G24S  /dev/st1  /dev/sg11
+ [3:0:0:0]    enclosu HP       A6255A           HP04  -         /dev/sg3
+ [3:0:1:0]    disk    HP 36.4G ST336753FC       HP00  /dev/sdd  /dev/sg4
+\end{verbatim}
+\normalsize
+
 F\"{u}r weiterf\"{u}hrende Information \"{u}ber SCSI-Ger\"{a}te, schauen Sie bitte in den Abschnitt
 \ilink{Linux SCSI Tricks}{SCSITricks} aus dem Tape-Testing-Kapitel des Handbuchs.
 
@@ -881,6 +895,27 @@ Die Angabe des {\bf Cleaning Prefix} kann in der Pool-Konfiguration benutzt werd
 Tapes (Barcodes) im Katalog mit dem {\bf VolStatus} {\bf Cleaning} gekennzeichnet werden sollen.
 Das verhindert, dass Bacula versucht auf dem Tape zu schreiben.
 
+\section{Volumes im Autochanger anzeigen}
+
+Mit dem Console-Kommando {\bf status slots storage=xxx} k\"{o}nnen Sie sich
+den Inhalt des angegebenen Autochangers anzeigen lassen:
+\footnotesize
+\begin{verbatim}
+ Slot |  Volume Name    |  Status  |      Type         |    Pool        |  Loaded |
+------+-----------------+----------+-------------------+----------------+---------|
+    1 |           00001 |   Append |  DiskChangerMedia |        Default |    0    |
+    2 |           00002 |   Append |  DiskChangerMedia |        Default |    0    |
+    3*|           00003 |   Append |  DiskChangerMedia |        Scratch |    0    |
+    4 |                 |          |                   |                |    0    |
+\end{verbatim}
+\normalsize
+
+Falls ein {\bf *} neben einer Slot-Nummer angezeigt wird bedeutet das,
+dass der Inhalt des Autochangers nicht synchron mit der Katalog-Datenbank ist.
+In diesem Fall m\"{u}ssen Sie das Console-Kommmando {\bf update slots} ausf\"{u}hren,
+um die Volume-Eintr\"{a}ge in der Katalog-Datenbank zu aktualisieren. 
+
+
 \label{interface}
 \section{Bacula Autochanger Schnittstelle}
 \index[general]{Schnittstelle!Bacula Autochanger }
diff --git a/docs/manuals/de/concepts/tutorial.tex b/docs/manuals/de/concepts/tutorial.tex
index c1f922b3..74a1f1a0 100644
--- a/docs/manuals/de/concepts/tutorial.tex
+++ b/docs/manuals/de/concepts/tutorial.tex
@@ -195,7 +195,7 @@ files <jobid=nn>]; from catalog
   release    release <storage-name>
   reload     reload conf file
   run        run <job-name>
-  status     status [storage | client]=<name>
+  status     status [[slots] storage=<name> | dir | client]=<name>
   setdebug   sets debug level
   setip      sets new client address -- if authorized
   show       show (resource records) [jobs | pools | ... | all]
diff --git a/docs/manuals/de/console/bconsole.tex b/docs/manuals/de/console/bconsole.tex
index 5f37aa73..c15e9593 100644
--- a/docs/manuals/de/console/bconsole.tex
+++ b/docs/manuals/de/console/bconsole.tex
@@ -1113,12 +1113,15 @@ setdebug level=nn [trace=0/1 client=<client-name> | dir | director |
 \item [status]
    \index[general]{status}
    Das status-Kommando zeigt den momentanen Status des gew\"{a}hlten Dienstes an
-   (Director, Storage oder eines Clients). Es kann wie folgt aufgerufen werden:
+   (Director, Storage oder eines Clients). Beim Storage-Dienst k\"{o}nnen Sie
+   sich den Laufwerks-Status oder den Inhalt des Autochangers anzeigen lassen.
+   Der Client zeigt Informationen \"{u}ber aktuell laufende Jobs und deren
+   Geschwindigkeit an. Es kann wie folgt aufgerufen werden:
 
 \footnotesize
 \begin{verbatim}
 status [all | dir=<dir-name> | director |
-  client=<client-name> | storage=<storage-name> |
+  client=<client-name> | [slots] storage=<storage-name> |
   days=nnn]
 \end{verbatim}
 \normalsize
-- 
2.39.5