TWiki> LCG Web>LCGGridDeployment>LCGSoftware>DataManagementTop>DataManagementDocumentation>DpmApi>DpmApiOld (2010-10-27, RicardoBritoDaRochaSecondary) EditAttachPDF

All the DPM man pages can be found here : DPM CLI and API.

Below is a description of each DPM command / method.

DPNS Client Timeouts

From version 1.5.8 onwards, timeouts and retries are implemented at the DPNS client level.

3 environment variables can be used:

  • $DPNS_CONNTIMEOUT -> sets the connect timeout in seconds
  • $DPNS_CONRETRY -> sets the number of retries
  • $DPNS_CONRETRYINT -> sets the retry interval in seconds

The default is to retry for one week.

DPM Name Server Command Line Interface

COMMAND DESCRIPTION
dpns-chmod change access mode of a DPM directory/file in the name server
dpns-chown change owner and group of a DPM directory/file in the name server
dpns-entergrpmap define a new group entry in Virtual Id table
dpns-enterusrmap define a new user entry in Virtual Id table
dpns-getacl get DPM directory/file access control lists
dpns-ln make a symbolic link to a file or a directory in the DPM Name Server
dpns-ls list DPM name server directory/file entries
dpns-mkdir make DPM directory in the name server
dpns-modifygrpmap modify group entry corresponding to a given virtual gid
dpns-modifyusrmap modify user entry corresponding to a given virtual uid
dpns-rename rename a DPM file or directory in the name server
dpns-rm remove DPM files or directories in the name server
dpns-rmgrpmap suppress group entry corresponding to a given virtual gid or group name
dpns-rmusrmap suppress user entry corresponding to a given virtual uid or user name
dpns-setacl set DPM directory/file access control lists

For more details, please refer to the corresponding man page.

DPM Command Line Interface

COMMAND DESCRIPTION
dpm-addfs add a filesystem to a disk pool
dpm-addpool define a new disk pool
dpm-modifyfs modify the parameters of a disk pool filesystem
dpm-modifypool modify a disk pool definition
dpm-qryconf display the Disk Pool Manager configuration
dpm-rmfs remove a filesystem from a disk pool definition
dpm-rmpool remove a disk pool definition

DPM Name Server API

COMMAND DESCRIPTION
dpns_aborttrans abort a transaction
dpns_access check existence/accessibility of a file/directory
dpns_addreplica add a replica for a given file
dpns_chdir change DPNS current directory used by the name server
dpns_chmod change access mode of a DPNS directory/file in the name
dpns_chown change owner and group of a DPM directory/file in the name server
dpns_closedir close DPNS directory opened by dpns_opendir in the name server
dpns_creat create a new DPNS file or reset it in the name server
dpns_delreplica delete a replica for a given file
dpns_endsess end session
dpns_endtrans end transaction mode
dpns_entergrpmap define a new group entry in Virtual Id table
dpns_enterusrmap define a new user entry in Virtual Id table
dpns_getacl get DPNS directory/file access control lists
dpns_getcwd get DPNS current directory used by the name server
dpns_getgrpbygid get group name associated with a given virtual gid
dpns_getgrpbynam get virtual gid associated with a given group name
dpns_getidmap get virtual uid/gid(s) associated with a given dn/role(s)
dpns_getreplica get the replica entries associated with a DPNS file in the name server
dpns_getusrbynam get virtual uid associated with a given user name
dpns_getusrbyuid get user name associated with a given virtual uid
dpns_lchown identical to dpns_chown except for symbolic links: it does not follow the link but changes the ownership of the link itself
dpns_listrep4gc list replica entries that can be garbage collected
dpns_listreplica list replica entries for a given file
dpns_listreplicax list replica entries for a given pool/server/filesystem
dpns_mkdir create a new DPNS directory in the name server
dpns_modifygrpmap modify group entry corresponding to a given virtual gid
dpns_modifyusrmap modify user entry corresponding to a given virtual uid
dpns_opendirxg open a DPNS directory, having the specified GUID, in the name server
dpns_readdir read DPNS directory opened by dpns_opendir in the name server
dpns_readdirx read DPNS directory opened by dpns_opendir in the nameserver
dpns_readdirxr identical to dpns_readdir + returns the replicas
dpns_readlink read value of a symbolic link in the DPM Name Server
dpns_rename rename a DPNS file or directory in the name server
dpns_rewinddir reset position to the beginning of a DPNS directory opened by dpns_opendir in the name server
dpns_rmdir remove a DPM directory in the name server
dpns_rmgrpmap suppress group entry corresponding to a given virtual gid or group name
dpns_rmusrmap suppress user entry corresponding to a given virtual uid or user name
dpns_setacl set DPM directory/file access control lists
dpns_setatime set last access time for a regular file to the current time
dpns_seterrbuf set receiving buffer for error messages
dpns_setfsize set filesize for a regular file; set also last modification time to the current time
dpns_setfsizeg set filesize for a regular file having the given GUID; set also last modification time to the current time
dpns_setptime set replica pin time
dpns_setratime set replica last access (read) date
dpns_setrstatus set replica status
dpns_startsess start session
dpns_starttrans start transaction mode
dpns_stat get information about a DPNS file or directory in the name server
dpns_statr get information about a DPNS file or directory in the name server
dpns_symlink make a symbolic link to a file or a directory in the DPM Name Server
dpns_umask set and get DPNS file creation mask used by the name server
dpns_unlink remove a DPNS file entry in the name server
dpns_utime set last access and modification times

For more details, please refer to the corresponding man page.

DPM API

COMMAND DESCRIPTION
dpm_abortreq abort a given get, put or copy request
dpm_addfs add a filesystem to a disk pool
dpm_addpool define a new disk pool
dpm_copy copy a set of existing files
dpm_extendfilelife extend file lifetime
dpm_get make a set of existing files available for I/O
dpm_getpoolfs get list of filesystems for a given pool
dpm_getpools get list of pools
dpm_getprotocols get the list of supported protocols
dpm_getreqid get request id for a set of requests
dpm_getreqsummary get summary for a set of requests
dpm_getspacemd get space metadata
dpm_getspacetoken get space token
dpm_getstatus_copyreq get status for a dpm_copy request
dpm_getstatus_getreq get status for a dpm_get request
dpm_getstatus_putreq get status for a dpm_put request
dpm_modifyfs modify the parameters of a disk pool filesystem
dpm_modifypool modify a disk pool definition
dpm_put make a set of existing files available for I/O
dpm_putdone mark a set of files as complete
dpm_releasespace release space
dpm_relfiles release a set of files
dpm_reservespace reserve space
dpm_rm delete a set of files
dpm_rmfs remove a filesystem from a disk pool definition
dpm_rmpool remove a disk pool definition
dpm_seterrbuf set receiving buffer for error messages
dpm_updatespace update space

Help !

For any help/question, please contact GGUS at helpdesk@ggusNOSPAMPLEASE.org (remove the NOSPAM !). Your ROC will help you, and contact the appropriate experts if necessary.

-- SophieLemaitre - 16 Mar 2006

Edit | Attach | Watch | Print version | History: r1 | Backlinks | Raw View | WYSIWYG | More topic actions
Topic revision: r1 - 2010-10-27 - RicardoBritoDaRochaSecondary
 
    • Cern Search Icon Cern Search
    • TWiki Search Icon TWiki Search
    • Google Search Icon Google Search

    LCG All webs login

This site is powered by the TWiki collaboration platform Powered by PerlCopyright &© 2008-2021 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
or Ideas, requests, problems regarding TWiki? use Discourse or Send feedback