Commit 81fd6b28 authored by Eric Cano's avatar Eric Cano
Browse files

Added documentation for tpconfig, labeling and library registration.

parent a8e5857f
......@@ -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}
......
Supports Markdown
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment