Scroll to navigation

DPMCOPYD(8) DPM Administrator Commands DPMCOPYD(8)

NAME

dpmcopyd - start the Disk Pool Manager Copy backend

SYNOPSIS

dpmcopyd [ -c config_file ] [ -l log_file ] [ -4 | -6 ]

DESCRIPTION

The dpmcopyd command starts the Disk Pool Manager Copy backend. This command is usually executed at system startup time (/etc/rc.local). This will read the Disk Pool Manager "request" database configuration file and look for requests. Each of them is processed in a child process which opens a connection to the database server if necessary.

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

The maximum number of child processes is set by default to 20. If there are more concurrent requests, they remain in the queue until a worker process is available. The maximum number of child processes can be changed by putting an entry in /etc/shift.conf for example:

DPMCOPYD MAX_WORKERS 30

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

setting an environment variable DPMCOPYD_PORT

setenv DPMCOPYD_PORT 5017

an entry in /etc/shift.conf like:

DPMCOPYD PORT 5017

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

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

setting an environment variable DPMCOPYD_HOST, for example:

setenv DPMCOPYD_HOST sehost

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

DPMCOPYD 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 Copy backend "request" database keeps the requests and their status even after completion.

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 process id. For each user command there is one message giving information about the requestor DN and several lines when getting the TURLs for the source/destination files and when doing the copy 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.
-4
only try to listen on IPv4 addresses
-6
only try to listen on IPv6 addresses

FILES

/etc/DPMCONFIG
configuration file
/var/log/dpmcopy/log

EXAMPLES

Here is a small log:
03/27 09:34:30 29631 dpmcopyd: started
03/27 17:04:36 21024 dpmcopyd: inc_reqctr request from lxb6133v1.cern.ch
03/27 17:04:36 21024 dpmcopyd: decrementing reqctr
03/27 17:04:36 21129 dpmcopyd: processing request d3cc74d5-f9c0-4e21-83d2-a29fd8e692af from /DC=ch/DC=cern/OU=Organic Units/OU=Users/CN=baud/CN=373165/CN=Jean-Philippe Baud
03/27 17:04:36 21129 dpmcopy_push: calling dpm_get
03/27 17:04:36 21129 dpmcopy_push: dpm_get returned request token 25bd8353-6ee1-4d60-b7cb-a5120dfa1069
03/27 17:04:37 21129 dpmcopy_push: calling srmv2_put
03/27 17:04:37 21129 dpmcopy_push: srmv2_put returned request token 85872006-11d6-404b-8ebe-0b9fd85031b8
03/27 17:04:42 21129 dpmcopy_push: copying gsiftp://lxb6133v1.cern.ch/lxb6133v1.cern.ch:/dpm_data/dteam/2008-03-27/jpbt1.1.0 to gsiftp://lxdpm102.cern.ch/lxdpm102.cern.ch:/data01/dteam/2008-03-27/jpbt9.478949.0
03/27 17:04:43 21129 dpmcopy_push: dpm_copyfile returned 0, serrno = 0
03/27 17:04:43 21129 dpmcopy_push: calling srmv2_putdone
03/27 17:04:44 21024 dpmcopyd: process 21129 exiting with status 0
    

SEE ALSO

Clogit(3)
$Date: 2012-06-06 16:39:34 +0200 (Wed, 06 Jun 2012) $ LCG