Scroll to navigation

DPM(8) DPM Administrator Commands DPM(8)

NAME

dpm - start the Disk Pool Manager

SYNOPSIS

dpm [ -c config_file ] [ -l log_file ] [ -t nbfthreads ] [ -T nbsthreads ] [ -4 | -6 ]

DESCRIPTION

The dpm command starts the Disk Pool Manager. This command is usually executed at system startup time (/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.

All error messages and statistical information are kept in a log.

The Disk Pool Manager listen port number can be defined on client hosts and on the server itself in either of the following ways:

setting an environment variable DPM_PORT

setenv DPM_PORT 5015

an entry in /etc/shift.conf like:

DPM PORT 5015

If none of these methods is used, the default port number is taken from the definition of DPM_PORT in dpm_constants.h.

The Disk Pool Manager host name can be defined on client hosts in either of the following ways:

setting an environment variable DPM_HOST, for example:

setenv DPM_HOST sehost

an entry in /etc/shift.conf for example:

DPM HOST sehost

If none of these methods is used, the default host is taken from the definition of DpmHost in site.def.

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 /etc/shift.conf can set the retention period for the requests:

DPM REQCLEAN req_retention

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).

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:

username/password@server
or
username/password@server/dbname

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.

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.

OPTIONS

-c config_file
Specifies a different path for the Disk Pool Manager configuration file.
-l log_file
Specifies a different path for the Disk Pool Manager log file. The special value syslog will send the log messages to the system logger syslogd.
-t nbfthreads
specifies the number of fast threads. The number of fast threads + the number of slow threads + the number of disk pools + 2 must be less than DPM_MAXNBTHREADS (currently 100). Default is 20.
-T nbsthreads
specifies the number of slow threads. The number of fast threads + the number of slow threads + the number of disk pools + 2 must be less than DPM_MAXNBTHREADS (currently 100). Default is 20.
-4
only try to listen on IPv4 addresses
-6
only try to listen on IPv6 addresses

FILES

/etc/DPMCONFIG
configuration file
/var/log/dpm/log

EXAMPLES

Here is a small log:
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
    

SEE ALSO

Clogit(3), dpm-shutdown(8)
$Date$ LCG