]> git.sur5r.net Git - bacula/docs/blobdiff - docs/manual/tapetesting.tex
Reconvert images including new ones
[bacula/docs] / docs / manual / tapetesting.tex
index 8e451ee67c484d4d557664ee5c617b3f098cffbd..b645e5115ff5c9aa3815111d63159a22bb4a3f2a 100644 (file)
@@ -45,6 +45,10 @@ one.
    item). When doing this, you should consult the \ilink{Storage Daemon
    Configuration}{StoredConfChapter} of this manual.
 
+\item If you are using a Fibre Channel to connect your tape drive to
+   Bacula, please be sure to disable any caching in the NSR (network
+   storage router, which is a Fibre Channel to SCSI converter).
+
 \item Run the btape {\bf test} command:  
 
    \footnotesize
@@ -55,10 +59,10 @@ one.
 \end{verbatim}
 \normalsize
 
-It isn't necessary to run the autochanger part of the  test at this time,  but
-do not go past this point until the basic test succeeds. If you do have 
-an autochanger, please be sure to read the
-\ilink{Autochanger chapter}{AutochangersChapter} of this manual.
+   It isn't necessary to run the autochanger part of the test at this time,
+   but do not go past this point until the basic test succeeds.  If you do
+   have an autochanger, please be sure to read the \ilink{Autochanger
+   chapter}{AutochangersChapter} of this manual.
 
 \item Run the btape {\bf fill} command, preferably with two volumes.  This
    can take a long time. If you have an autochanger and it  is configured, Bacula
@@ -71,15 +75,16 @@ an autochanger, please be sure to read the
    program can be found in the platform/freebsd directory. The instructions
    for its use are at the top of the file.
 
-\item Run Bacula, and backup a reasonably small directory,  say 60 Megabytes.
-   Do three successive backups of this  directory. 
+\item Run Bacula, and backup a reasonably small directory, say 60
+   Megabytes.  Do three successive backups of this directory.
 
-\item Stop Bacula, then restart it. Do another full backup  of the same
-   directory. Then stop and restart Bacula. 
+\item Stop Bacula, then restart it.  Do another full backup of the same
+   directory.  Then stop and restart Bacula.
 
 \item Do a restore of the directory backed up, by entering the  following
    restore command, being careful to restore it to  an alternate location:  
 
+
 \footnotesize
 \begin{verbatim}
    restore select all done
@@ -88,10 +93,10 @@ an autochanger, please be sure to read the
 \end{verbatim}
 \normalsize
 
-Do a {\bf diff} on the restored directory to ensure it is identical  to the
-original directory. If you are going to backup multiple different systems
-(Linux, Windows, Mac, Solaris, FreeBSD, ...), be sure you test the restore
-on each system type.
+   Do a {\bf diff} on the restored directory to ensure it is identical  to the
+   original directory. If you are going to backup multiple different systems
+   (Linux, Windows, Mac, Solaris, FreeBSD, ...), be sure you test the restore
+   on each system type.
 
 \item If you have an autochanger, you should now go back to the  btape program
    and run the autochanger test:  
@@ -104,17 +109,17 @@ on each system type.
 \end{verbatim}
 \normalsize
 
-Adjust your autochanger as necessary to ensure that it works  correctly. See
-the Autochanger chapter of this manual  for a complete discussion of testing
-your autochanger.  
+   Adjust your autochanger as necessary to ensure that it works  correctly. See
+   the Autochanger chapter of this manual  for a complete discussion of testing
+   your autochanger.  
 
 \item We strongly recommend that you use a dedicated SCSI
-controller for your tape drives. Scanners are known to induce
-serious problems with the SCSI bus, causing it to reset. If the
-SCSI bus is reset while Bacula has the tape drive open, it will
-most likely be fatal to your tape since the drive will rewind.
-These kinds of problems show up in the system log. For example,
-the following was most likely caused by a scanner:
+   controller for your tape drives. Scanners are known to induce
+   serious problems with the SCSI bus, causing it to reset. If the
+   SCSI bus is reset while Bacula has the tape drive open, it will
+   most likely be fatal to your tape since the drive will rewind.
+   These kinds of problems show up in the system log. For example,
+   the following was most likely caused by a scanner:
 
 \footnotesize
 \begin{verbatim}
@@ -354,13 +359,74 @@ your tape drive.
 
 You can find out what SCSI devices you have by doing: 
 
+\footnotesize
+\begin{verbatim}
+lsscsi
+\end{verbatim}
+\normalsize
+
+Typical output is:
+
+\footnotesize
+\begin{verbatim}
+[0:0:0:0]    disk    ATA      ST3160812AS      3.AD  /dev/sda
+[2:0:4:0]    tape    HP       Ultrium 2-SCSI   F6CH  /dev/st0
+[2:0:5:0]    tape    HP       Ultrium 2-SCSI   F6CH  /dev/st1
+[2:0:6:0]    mediumx OVERLAND LXB              0107  -
+[2:0:9:0]    tape    HP       Ultrium 1-SCSI   E50H  /dev/st2
+[2:0:10:0]   mediumx OVERLAND LXB              0107  -
+\end{verbatim}
+\normalsize
+
+There are two drives in one autochanger: /dev/st0 and /dev/st1
+and a third tape drive at /dev/st2.  For using them with Bacula, one
+would normally reference them as /dev/nst0 ... /dev/nst2.  Not also,
+there are two different autochangers identified as "mediumx OVERLAND LXB".
+They can be addressed via their /dev/sgN designation, which can be
+obtained by counting from the beginning as 0 to each changer.  In the
+above case, the two changers are located on /dev/sg3 and /dev/sg5. The one
+at /dev/sg3, controls drives /dev/nst0 and /dev/nst1; and the one at
+/dev/sg5 controles drive /dev/nst2.
+
+If you do not have the {\bf lsscsi}  command, you can obtain the same
+information as follows:
+
 \footnotesize
 \begin{verbatim}
 cat /proc/scsi/scsi
 \end{verbatim}
 \normalsize
 
-For example, I get the following: 
+For the above example with the three drives and two autochangers,
+I get:
+
+\footnotesize       
+\begin{verbatim}
+Attached devices:
+Host: scsi0 Channel: 00 Id: 00 Lun: 00
+  Vendor: ATA      Model: ST3160812AS      Rev: 3.AD
+  Type:   Direct-Access                    ANSI SCSI revision: 05
+Host: scsi2 Channel: 00 Id: 04 Lun: 00
+  Vendor: HP       Model: Ultrium 2-SCSI   Rev: F6CH
+  Type:   Sequential-Access                ANSI SCSI revision: 03
+Host: scsi2 Channel: 00 Id: 05 Lun: 00
+  Vendor: HP       Model: Ultrium 2-SCSI   Rev: F6CH
+  Type:   Sequential-Access                ANSI SCSI revision: 03
+Host: scsi2 Channel: 00 Id: 06 Lun: 00
+  Vendor: OVERLAND Model: LXB              Rev: 0107
+  Type:   Medium Changer                   ANSI SCSI revision: 02
+Host: scsi2 Channel: 00 Id: 09 Lun: 00
+  Vendor: HP       Model: Ultrium 1-SCSI   Rev: E50H
+  Type:   Sequential-Access                ANSI SCSI revision: 03
+Host: scsi2 Channel: 00 Id: 10 Lun: 00
+  Vendor: OVERLAND Model: LXB              Rev: 0107
+  Type:   Medium Changer                   ANSI SCSI revision: 02
+\end{verbatim}
+\normalsize
+
+
+As an additional example, I get the following (on a different machine from the
+above example):
 
 \footnotesize
 \begin{verbatim}