rmcd.man 3.58 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
.TH RMCD "8castor" "$Date: 2009/08/18 09:43:01 $" CASTOR "rmc Administrator Commands"
Dennis Waldron's avatar
Dennis Waldron committed
5
6
7
.SH NAME
rmcd \- start the Remote Media Changer daemon
.SH SYNOPSIS
Steven Murray's avatar
Steven Murray committed
8
.B rmcd [OPTIONS]
Dennis Waldron's avatar
Dennis Waldron committed
9
10
11
12
13
.SH DESCRIPTION
.LP
The
.B rmcd
command starts the Remote Media Changer daemon.
Steven Murray's avatar
Steven Murray committed
14
15
.SH OPTIONS
.TP
Steven Murray's avatar
Steven Murray committed
16
\fB\-f
Steven Murray's avatar
Steven Murray committed
17
Remain in the foreground.
Steven Murray's avatar
Steven Murray committed
18
19
20
21
22
.SH CASTOR CONFIGURATION PARAMETERS READ BY THE SERVER
The remote media changer daemon reads and uses the following CASTOR
configuration parameters which are specified within the CASTOR
configuration file /etc/castor/castor.conf.
.TP
23
24
25
26
27
28
29
30
31
32
\fBRMC MODE
The compatibility mode of the the remote media-changer daemon.  Valid values
are ACS, MOCK and SMC.  A remote media-changer daemon can either be configured
to work with an ACS compatible tape library or with a SCSI compatible tape
library.  In addition a remote media-changer daemon can be configured to run
in MOCK mode for debugging purposes.  In MOCK mode a remote media-changer will
do nothing but log the client requests it receives.  It is \fBNOT\f[]
recommended to run a remote media-changer daemon in MOCK mode in production
unless you really know what you are doing.
.TP
Steven Murray's avatar
Steven Murray committed
33
34
35
36
\fBRMC PORT
The port on which the remote media changer daemon will listen for client
requests.  The default value is 5014.  This configuration parameter should
\fBNOT\fP normally be set and the default should be used.
37
38
39
40
41
.TP
\fBRMC SMCDEV
The path to the device file representing the SCSI media changer.  This
configuration parameter is only read by a remote media-changer daemon
configured to run in SMC compatibility mode. See \fBRMC MODE\f[] above.
Steven Murray's avatar
Steven Murray committed
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

.SH CASTOR CONFIGURATION PARAMETERS READ BY THE CLIENTS
The clients of the remote media changer daemon read and use the following
CASTOR configuration parameters which are specified within the CASTOR
configuration file /etc/castor/castor.conf.
.TP
\fBRMC HOST
The host on which the rmcd daemon is running and listening for client requests.
.TP
\fBRMC PORT
The port on which the remote media changer daemon will listen for client
requests.  The default value is 5014.  This configuration parameter should
\fBNOT\fP normally be set and the default should be used.

.SH ENVIRONMENT VARIABLES READ BY THE CLIENTS
The clients of the remote media changer daemon read and use the following
environment variables.  Please note that an environment variable will override
the equivalent CASTOR configuration parameter located within the CASTOR
configuration file /etc/castor/castor.conf.
.TP
\fBRMC_HOST
63
64
The same meaning as the CASTOR configuration parameter \fBRMC HOST\f[]
described above.
Steven Murray's avatar
Steven Murray committed
65
66
.TP
\fBRMC_PORT
67
The same meaning as the CASTOR configuration parameter \fBRMC PORT\f[] described
Steven Murray's avatar
Steven Murray committed
68
69
70
above.

.SH THE SERVER LOG FILE
Dennis Waldron's avatar
Dennis Waldron committed
71
.LP
72
All error messages and statistical information are written to the file
Steven Murray's avatar
Steven Murray committed
73
/var/log/castor/rmcd.log.  Each entry within the log has a timestamp.
Dennis Waldron's avatar
Dennis Waldron committed
74
75
76
77
78
79
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
80
.B /var/log/castor/rmcd.log
Dennis Waldron's avatar
Dennis Waldron committed
81
82
83
84
85
86
87
88
89
90
91
92
93
.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>