1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
.\" @(#)$RCSfile: srmv2.man,v $ $Revision: 1.3 $ $Date: 2005/08/05 15:19:05 $ CERN IT-GD/CT Jean-Philippe Baud
.\" Copyright (C) 1999-2005 by CERN/IT/GD/CT
.\" All rights reserved
.\"
.TH SRMV2 1 "$Date: 2005/08/05 15:19:05 $" LCG "DPM Administrator Commands"
.SH NAME
srmv2 \- start the SRM v2 server
.SH SYNOPSIS
.B srmv2
[
.BI -c " config_file"
] [
.BI -l " log_file"
]
.SH DESCRIPTION
.LP
The
.B srmv2
command starts the SRM v2 server.
This command is usually executed at system startup time
.RB ( /etc/rc.local ).
This will read the Disk Pool Manager "request" database configuration file,
create a pool of threads and look for requests.
Each of them is processed in a thread which opens a connection to the
database server if necessary.
When a request has been completed, the thread becomes idle until it is allocated
to another request.
The connection to the database server is kept open between 2 requests.
.LP
All error messages and statistical information are kept in a log.
.LP
The Disk Pool Manager listen port number can be defined on client hosts and
on the server itself in either of the following ways:
.RS
.LP
setting an environment variable SRMV2_PORT
.RS
.HP
setenv SRMV2_PORT 8444
.RE
.LP
an entry in
.B /etc/shift.conf
like:
.RS
.HP
SRMV2 PORT 8444
.RE
.RE
.LP
If none of these methods is used, the default port number is taken from the
definition of SRMV2_PORT in srm_server.h.
.LP
The Disk Pool Manager "request" database keeps the requests and their status
even after completion.
.LP
The Disk Pool Manager configuration file contains password information for the
database and must be readable/writable only by root.
It contains a single line in the format:
.HP
.RS
username/password@server
.RE
or
.RS
username/password@server/dbname
.RE
.sp
where 'username' and 'password' are the credentials to login to the database
instance identified by 'server'. If 'dbname' is not specified, "dpm_db" is used.
.LP
In the log each entry has a timestamp.
All entries corresponding to one request have the same request id.
For each user command there is one message giving information about
the requestor (hostname, dn) and one message SRM98 giving the command
itself.
The completion code of the command is also logged.
.SH OPTIONS
.TP
.BI -c " config_file"
Specifies a different path for the Disk Pool Manager configuration file.
.TP
.BI -l " log_file"
Specifies a different path for the Disk Pool Manager log file.
.SH FILES
.TP 1.5i
.B /etc/DPMCONFIG
configuration file
.TP
.B /var/log/srmv2/log
.SH EXAMPLES
.TP
Here is a small log:
.nf
12/03 15:54:51 17419 srmv2: started
12/03 16:54:54 17419,0 PrepareToPut: request by xxx from lxb1908.cern.ch
12/03 16:54:54 17419,0 PrepareToPut: SRM98 - PrepareToPut 3 bfc51f99-17bd-4a45-b440-0fc33ec7a8d4
12/03 16:54:54 17419,0 PrepareToPut: SRM98 - PrepareToPut 0 srm://lxb0722.cern.ch:8444//dpm/dteam/srm_test_suite_file.17702.19410
.fi
.SH SEE ALSO
.B dpm(1)
|
