cta-rmcd.1cta 3.14 KB
Newer Older
1
2
.\" The CERN Tape Archive (CTA) project
.\" Copyright (C) 2021  CERN
Dennis Waldron's avatar
Dennis Waldron committed
3
.\"
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
.\" This program is free software: you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation, either version 3 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program.  If not, see <http://www.gnu.org/licenses/>.
.TH CTA-RMCD "1cta" "$Date: 2021/03/11 14:44:00 $" CTA "CTA"
.SH NAME
cta-rmcd \- Media changer daemon
.SH SYNOPSIS
.BI "cta-rmcd [OPTIONS]"
21

22
23
24
25
.SH DESCRIPTION
CTA supports SCSI-compatible tape libraries. The cta-taped daemon requires a tape
library daemon to be installed and run on the same tape server as itself.
.P
26
27
A SCSI compatible tape library requires the following daemon:

28
\fBcta-rmcd\fP
29
30
31

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

32
\fBcta-rmcd-MAJORVERSION-MINORVERSION.el7.cern.x86_64.rpm\fP
33
34
35

The \fBcta-rmcd\fP daemon can be started, stopped and its status queried using
the usual service commands:
36
37
.LP
\fBservice cta-rmcd start /device/file/of/the/tape/library\fP 
38
39
40
41
.br
\fBservice cta-rmcd status\fP
.br
\fBservice cta-rmcd stop\fP
Dennis Waldron's avatar
Dennis Waldron committed
42
43
.LP
The
44
.B cta-rmcd
Dennis Waldron's avatar
Dennis Waldron committed
45
command starts the Remote Media Changer daemon.
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
This command is usually executed at system startup time
.RB ( /etc/rc.local ).
.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
66
.B /etc/cta/cta-rmcd.conf
67
68
69
70
71
72
73
74
75
76
77
like:
.RS
.HP
RMC	PORT	5014
.RE
.LP
an entry in
.B /etc/services
like:
.RS
.HP
78
rmc           5014/tcp                        # CTA Remote Media Changer
79
80
81
82
83
84
85
86
.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
87
.LP
88
In the log each entry has a timestamp.
Dennis Waldron's avatar
Dennis Waldron committed
89
90
91
92
93
94
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
95
.B /var/log/cta/cta-rmcd.log
Dennis Waldron's avatar
Dennis Waldron committed
96
97
98
99
100
101
102
103
104
105
106
107
.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
108
CERN CTA Team, https://cta.web.cern.ch