cta-rmcd.1cta 2.62 KB
Newer Older
Dennis Waldron's avatar
Dennis Waldron committed
1
2
3
.\" Copyright (C) 2002 by CERN/IT/PDP/DM
.\" All rights reserved
.\"
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
CTA supports two types of tape libraries, SCSI compatible ones and Oracle
Automatic Cartridge System (ACS) ones.  The cta-taped daemon requires a tape
library daemon to be installed and run on the same tape server as itself.
There are two types of CTA tape library daemons, one for SCSI compatible tape
libraries and one for ACS tape libraries.

A SCSI compatible tape library requires the following daemon:

\fBrmcd\fP

The installation RPM for the \fBrmcd\fP daemon and its manual page is:

\fBcta-rmc-server-0.0-XX.slc6.x86_64\fP

The \fBcta-rmcd\fP daemon can be started, stopped and its status queried using
the usual service commands:

Dennis Waldron's avatar
Dennis Waldron committed
21
.SH NAME
22
23
24
25
26
\fBservice cta-rmcd start the device file of the tape library\fP 
.br
\fBservice cta-rmcd status\fP
.br
\fBservice cta-rmcd stop\fP
Dennis Waldron's avatar
Dennis Waldron committed
27
.SH SYNOPSIS
28
.B cta-rmcd
29
.I smc_ldr
Dennis Waldron's avatar
Dennis Waldron committed
30
31
32
.SH DESCRIPTION
.LP
The
33
.B cta-rmcd
Dennis Waldron's avatar
Dennis Waldron committed
34
command starts the Remote Media Changer daemon.
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
This command is usually executed at system startup time
.RB ( /etc/rc.local ).
.LP
.I smc_ldr
is the picker device as defined in /dev.
.LP
If the Remote Media Changer daemon is not active,
the requests are automatically retried by the client API.
.LP
All error messages and statistical information are kept in a log.
.LP
The Remote Media Changer daemon listen port number can be defined on client
hosts and on the Remote Media Changer host itself in either of the following
ways:
.RS
.LP
setting an environment variable RMC_PORT
.RS
.HP
setenv RMC_PORT 5014
.RE
.LP
an entry in
.B /etc/castor/castor.conf
like:
.RS
.HP
RMC	PORT	5014
.RE
.LP
an entry in
.B /etc/services
like:
.RS
.HP
rmc           5014/tcp                        # CASTOR Remote Media Changer
.RE
.RE
.LP
If none of these methods is used, the default port number is taken from the
definition of RMC_PORT in rmc_constants.h.
.LP
.RE
.RE
Dennis Waldron's avatar
Dennis Waldron committed
79
.LP
80
In the log each entry has a timestamp.
Dennis Waldron's avatar
Dennis Waldron committed
81
82
83
84
85
86
For each user command there is one message RMC92 giving information about
the requestor (hostname, uid, gid) and one message RMC98 giving the command
itself.
The completion code of the command is also logged.
.SH FILES
.TP 1.5i
87
.B /var/log/cta/cta-rmcd.log
Dennis Waldron's avatar
Dennis Waldron committed
88
89
90
91
92
93
94
95
96
97
98
99
100
.SH EXAMPLES
.TP
Here is a small log:
.nf
12/06 11:40:58  7971 rmc_srv_mount: RMC92 - mount request by 0,0 from tpsrv015.cern.ch
12/06 11:40:58  7971 rmc_srv_mount: RMC98 - mount 000029/0 on drive 2
12/06 11:41:08  7971 rmc_srv_mount: returns 0
12/06 11:42:43  7971 rmc_srv_unmount: RMC92 - unmount request by 0,0 from tpsrv015.cern.ch
12/06 11:42:43  7971 rmc_srv_unmount: RMC98 - unmount 000029 2 0
12/06 11:42:48  7971 rmc_srv_unmount: returns 0
.fi
.SH AUTHOR
\fBCASTOR\fP Team <castor.support@cern.ch>