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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
|
.\" @(#)$RCSfile: dpm.man,v $ $Revision: 3146 $ $Date: 2010-02-04 13:24:04 +0100 (Thu, 04 Feb 2010) $ CERN IT-GD/CT Jean-Philippe Baud
.\" Copyright (C) 1999-2009 by CERN/IT/GD/CT
.\" All rights reserved
.\"
.TH DPM 1 "$Date: 2010-02-04 13:24:04 +0100 (Thu, 04 Feb 2010) $" LCG "DPM Administrator Commands"
.SH NAME
dpm \- start the Disk Pool Manager
.SH SYNOPSIS
.B dpm
[
.BI -c " config_file"
] [
.BI -l " log_file"
] [
.BI -4
|
.BI -6
]
.SH DESCRIPTION
.LP
The
.B dpm
command starts the Disk Pool Manager.
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.
If the Disk Pool Manager is being shutdown or 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 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 DPM_PORT
.RS
.HP
setenv DPM_PORT 5015
.RE
.LP
an entry in
.B /etc/shift.conf
like:
.RS
.HP
DPM PORT 5015
.RE
.RE
.LP
If none of these methods is used, the default port number is taken from the
definition of DPM_PORT in dpm_constants.h.
.LP
The Disk Pool Manager host name can be defined on client hosts
in either of the following ways:
.RS
.LP
setting an environment variable DPM_HOST, for example:
.RS
.HP
setenv DPM_HOST sehost
.RE
.LP
an entry in
.B /etc/shift.conf
for example:
.RS
.HP
DPM HOST sehost
.RE
.RE
.LP
If none of these methods is used, the default host is taken from the
definition of DpmHost in site.def.
.LP
The Disk Pool Manager "request" database keeps the requests and their status
even after completion.
By default, the requests are kept for ever, but an entry in
.B /etc/shift.conf
can set the retention period for the requests:
.RS
.HP
DPM REQCLEAN req_retention
.RE
.sp
where req_retention can be "Inf" (for infinite) or expressed in years (suffix 'y'),
months (suffix 'm'), days (suffix 'd'), hours (suffix 'h') or seconds (no suffix).
.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 DP092 giving information about
the requestor (hostname, uid, gid) and one message DP098 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.
.TP
.BI -4
only try to listen on IPv4 addresses
.TP
.BI -6
only try to listen on IPv6 addresses
.SH FILES
.TP 1.5i
.B /etc/DPMCONFIG
configuration file
.TP
.B /var/log/dpm/log
.SH EXAMPLES
.TP
Here is a small log:
.nf
11/23 07:06:17 24395 dpm_serv: started
11/23 07:06:17 24395 dpm_serv: Supported protocols are: rfio gsiftp
11/23 07:06:17 24395 dpm_getpoolconf: getting existing disk pool configuration from the DB
12/06 07:09:11 18163,1 dpm_srv_put: DP092 - put request by 395,1028 from lxb0722.cern.ch
12/06 07:09:15 18163,1 dpm_srv_put: DP098 - put 2 59d0946e-1063-4a78-92f3-687a11efc1f6
12/06 07:09:15 18163,1 dpm_srv_put: DP098 - put 0 /dpm/dteam/testjpb22
.fi
.SH SEE ALSO
.B dpm-shutdown(1)
|
