Added documentation for tpconfig, labeling and library registration.

doc/cta.tex

@@ -715,10 +715,6 @@ For a complete reference of the user commands see the next chapter.
 
 \section{Running \texttt{tapeserverd}}
 
-\subsection{Populating the minimal information in the scheduler database}
-
-TODO
-
 \subsection{Tapeserverd configuration}
 
 The tape drives can now be indicated to tapeserverd through the \texttt{/etc/castor/TPCONFIG} file:
@@ -749,9 +745,78 @@ userid     jid  dgn        stat dvn                 rl  vsn    vid
                 VLSTK      down VDSTK2@devbox
 \end{boxedverbatim}
 
+Using \texttt{tpstat} and \texttt{tpconfig}, one can put the drive up and see it attempt to schedule itself 
+in the logs (either \texttt{/var/log/messages} or \texttt{/var/log/castor/tapeserverd.log} depending on the 
+installation and leftovers from previous castor tape server.
+
+The log typically look like (simplified) in a loop:
+
+\begin{boxedverbatim}
+MSG="ProcessForker handling a ProcessForker message" type="ForkDataTransfer" len="47"
+MSG="ProcessForker handling ForkDataTransfer message" unitName="VDSTK1"
+MSG="ProcessForker forked data-transfer session" pid="32453"
+MSG="Closed command receiver socket" cmdSocket="7"
+MSG="Data-transfer child-process started" unitName="VDSTK1"
+MSG="Got process ID of the data-transfer session from the ProcessForker" pid="32453"
+MSG="Child of ProcessForker instantiated a ZMQ context" contextAddr="0x17494b0"
+MSG="ProcessForker child process terminated" terminatedPid="32453" WEXITSTATUS="0" WCOREDUMP="false" WIFCONTINUED="false"
+MSG="ProcessForker notifying TapeDaemon of process exit" pid="32453" exitCode="0" payloadLen="6"
+MSG="ProcessForkerConnectionHandler handling a message" type="ProcessExited" payloadLen="6"
+MSG="ProcessForkerConnectionHandler handling ProcessExited message" pid="32453" exitCode="0"
+MSG="Tape session finished"
+\end{boxedverbatim}
+
 \subsection{Tape labelling}
 
-TODO
+Tapes can be labelled with this command:
+
+\begin{verbatim}
+$ castor-tape-label -u VDSTK1 -V V31001 -f
+\end{verbatim}
+
+This leads to this kind of logs:
+
+\begin{boxedverbatim}
+MSG="Label session mounted tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false" librarySlot="smc@devbox,0"
+MSG="Label session loaded tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false"
+MSG="Label session rewinding tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false"
+MSG="Label session successfully rewound tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false"
+MSG="Label session is writing label to tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false"
+MSG="Label session has written label to tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false"
+MSG="Label session unloading tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false"
+MSG="Label session unloaded tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false"
+MSG="Label session dismounting tape" uid="500" gid="500" TPVID="V31001" unitName="VDSTK1" logicalLibrary="VLSTK" force="false" librarySlot="smc@devbox,0"
+\end{boxedverbatim}
+
+\subsection{Preparing the environment for migrations}
+The library and tapes need to be registered for the migrations:
+
+\begin{boxedverbatim}
+$ ../CTA-build/cmdline/cta  ll add -n VLSTK -m "Adding library"
+$ ../CTA-build/cmdline/cta  ll ls
+VLSTK 56549 1028 localhost 1445332074 Adding library
+$ ../CTA-build/cmdline/cta  tp add -n tapepool0 -p 5 -m "Adding tape pool"
+$ ../CTA-build/cmdline/cta  tp ls
+tapepool0 5 56549 1028 localhost 1445332179 Adding tape pool
+$ ../CTA-build/cmdline/cta  ta add -l VLSTK -t tapepool0 -c 1000000000 -m "Adding tape"  -v V31001
+$ ../CTA-build/cmdline/cta  ta add -l VLSTK -t tapepool0 -c 1000000000 -m "Adding tape"  -v V31002
+$ ../CTA-build/cmdline/cta  ta add -l VLSTK -t tapepool0 -c 1000000000 -m "Adding tape"  -v V31003
+$ ../CTA-build/cmdline/cta  ta add -l VLSTK -t tapepool0 -c 1000000000 -m "Adding tape"  -v V31004
+$ ../CTA-build/cmdline/cta  ta add -l VLSTK -t tapepool0 -c 1000000000 -m "Adding tape"  -v V31005
+$ ../CTA-build/cmdline/cta  ta ls
+V31001 VLSTK 1000000000 tapepool0 0 56549 1028 localhost 1445332198 Adding tape
+V31002 VLSTK 1000000000 tapepool0 0 56549 1028 localhost 1445332211 Adding tape
+V31003 VLSTK 1000000000 tapepool0 0 56549 1028 localhost 1445332212 Adding tape
+V31004 VLSTK 1000000000 tapepool0 0 56549 1028 localhost 1445332214 Adding tape
+V31005 VLSTK 1000000000 tapepool0 0 56549 1028 localhost 1445332215 Adding tape
+$ ../CTA-build/cmdline/cta sc add -n storageclass0 -c 1 -i 666 -m "c"
+$ ../CTA-build/cmdline/cta sc ls
+storageclass0 1 56549 1028 localhost 1445335733 c
+$ ../CTA-build/cmdline/cta chown 56549 1028 /
+$ ../CTA-build/cmdline/cta mkdir /test
+$ ../CTA-build/cmdline/cta ssc /test storageclass0
+$ ../CTA-build/cmdline/cta ar add -s storageclass0 -c 1 -t tapepool0 -m " "
+\end{boxedverbatim}
 
 \chapter{The Command Line Interface}