Table of Contents
- Mounting Chimera through NFS
- Using dCap with a mounted file system
- Communicating with Chimera
- Directory Tags
The inner dCache components talk to the namespace via a module called
PnfsManager, which in turn communicates with the Chimera database using a thin Java layer. In addition to
PnfsManager a direct access to the file system view is providing an
NFSv4.1 server. Clients can
NFS-mount the namespace locally. This offers the opportunity to use OS-level tools like
ls, mkdir, mv for Chimera. Direct I/O-operations like
cat are possible with the
The properties of Chimera are defined in /usr/share/dcache/defaults/chimera.properties. For customisation the files /etc/dcache/layouts/mylayout.conf or /etc/dcache/dcache.conf should be modified (see the section called “Defining domains and services”.
This example shows an extract of the /etc/dcache/layouts/mylayout.conf file in order to run dCache with
[namespaceDomain] [namespaceDomain/pnfsmanager] [namespaceDomain/nfs] nfs.version=3
If you want to run the NFSv4.1 server you need to add the corresponding nfs service to a domain in the /etc/dcache/layouts/mylayout.conf file and start this domain.
[namespaceDomain] [namespaceDomain/pnfsmanager] [namespaceDomain/nfs] nfs.version = 4.1
If you wish dCache to access your Chimera with a PostgreSQL user other than chimera then you must specify the username and password in /etc/dcache/dcache.conf.
MOUNTING CHIMERA THROUGH NFS
dCache does not need the Chimera filesystem to be mounted but a mounted file system is convenient for administrative access. This offers the opportunity to use OS-level tools like
mkdir for Chimera. However, direct I/O-operations like
cp are not possible, since the
NFSv3 interface provides the namespace part only. This section describes how to start the Chimera
NFSv3 server and mount the name space.
If you want to mount Chimera for easier administrative access, you need to edit the /etc/exports file as the Chimera
NFS server uses it to manage exports. If this file doesn’t exist it must be created. The typical exports file looks like this:
/ localhost(rw) /data # or # /data *.my.domain(rw)
As any RPC service Chimera
rpcbind service to run on the host. Nevertheless rpcbind has to be configured to accept requests from Chimera NFS.
On RHEL6 based systems you need to add
into /etc/sysconfig/rpcbind and restart
rpcbind. Check your OS manual for details.
[root] # service rpcbind restart Stopping rpcbind: [ OK ] Starting rpcbind: [ OK ]
If your OS does not provide
NFS can use an embedded
rpcbind. This requires to disable the
portmap service if it exists.
PROMPT-ROOT /etc/init.d/portmap stop Stopping portmap: portmap
and restart the domain in which the
NFS server is running.
Example: [root] # dcache restart namespaceDomain
Now you can mount Chimera by
[root] # mount localhost:/ /mnt
and create the root of the CHIMERA namespace which you can call data:
[root] # mkdir -p /mnt/data
If you don’t want to mount chimera you can create the root of the Chimera namespace by
[root] # /usr/bin/chimera mkdir /data
You can now add directory tags. For more information on tags see the section called “Directory Tags”.
[root] # /usr/bin/chimera writetag /data sGroup "chimera" [root] # /usr/bin/chimera writetag /data OSMTemplate "StoreName sql"
USING DCAP WITH A MOUNTED FILE SYSTEM
If you plan to use
dCap with a mounted file system instead of the URL-syntax (e.g.
dccp /data/file1 /tmp/file1), you need to mount the root of Chimera locally (remote mounts are not allowed yet). This will allow us to establish wormhole files so
dCap clients can discover the
[root] # mount localhost:/ /mnt [root] # mkdir /mnt/admin/etc/config/dCache [root] # touch /mnt/admin/etc/config/dCache/dcache.conf [root] # touch /mnt/admin/etc/config/dCache/'.(fset)(dcache.conf)(io)(on)' [root] # echo "<door host>:<port>" > /mnt/admin/etc/config/dCache/dcache.conf
The default values for ports can be found in Chapter 29, dCache Default Port Values (for
dCap the default port is 22125) and in the file /usr/share/dcache/defaults/dcache.properties. They can be altered in /etc/dcache/dcache.conf
Create the directory in which the users are going to store their data and change to this directory.
[root] # mkdir -p /mnt/data [root] # cd /mnt/data
Now you can copy a file into your dCache
[root] # dccp /bin/sh test-file 735004 bytes (718 kiB) in 0 seconds
and copy the data back using the
[root] # dccp test-file /tmp/testfile 735004 bytes (718 kiB) in 0 seconds
The file has been transferred succesfully.
Now remove the file from the dCache.
[root] # rm test-file
When the configuration is complete you can unmount Chimera:
[root] # umount /mnt
Please note that whenever you need to change the configuration, you have to remount the root
localhost:/to a temporary location like /mnt.
COMMUNICATING WITH CHIMERA
Many configuration parameters of Chimera and the application specific meta data is accessed by reading, writing, or creating files of the form .(command)(para). For example, the following prints the ChimeraID of the file /data/some/dir/file.dat:
[user] $ cat /data/any/sub/directory/'.(id)(file.dat)' 0004000000000000002320B8 [user] $
From the point of view of the
NFS protocol, the file .(id)(file.dat) in the directory /data/some/dir/ is read. However, Chimera interprets it as the command id with the parameter file.dat executed in the directory /data/some/dir/. The quotes are important, because the shell would otherwise try to interpret the parentheses.
Some of these command files have a second parameter in a third pair of parentheses. Note, that files of the form .(command)(para) are not really files. They are not shown when listing directories with
ls. However, the command files are listed when they appear in the argument list of
ls as in
[user] $ ls -l '.(tag)(sGroup)' -rw-r--r-- 11 root root 7 Aug 6 2010 .(tag)(sGroup)
Only a subset of file operations are allowed on these special command files. Any other operation will result in an appropriate error. Beware, that files with names of this form might accidentally be created by typos. They will then be shown when listing the directory.
Each file in Chimera has a unique 18 byte long ID. It is referred to as ChimeraID or as pnfsID. This is comparable to the inode number in other filesystems. The ID used for a file will never be reused, even if the file is deleted. dCache uses the ID for all internal references to a file.
The ID of the file ** example.org/data/examplefile** can be obtained by reading the command-file ** .(id)(examplefile)** in the directory of the file.
[user] $ cat /example.org/data/'.(id)(examplefile)' 0000917F4A82369F4BA98E38DBC5687A031D
A file in Chimera can be referred to by the ID for most operations.
The name of a file can be obtained from the ID with the command
nameof as follows:
[user] $ cd /example.org/data/ [user] $ cat '.(nameof)(0000917F4A82369F4BA98E38DBC5687A031D)' examplefile
And the ID of the directory it resides in is obtained by:
[user] $ cat '.(parent)(0000917F4A82369F4BA98E38DBC5687A031D)' 0000595ABA40B31A469C87754CD79E0C08F2
This way, the complete path of a file may be obtained starting from the ID.
In the Chimera namespace, each directory can have a number of tags. These directory tags may be used within dCache to control the file placement policy in the pools (see the section called “The Pool Selection Mechanism”). They might also be used by a tertiary storage system for similar purposes (e.g. controlling the set of tapes used for the files in the directory).
Directory tags are not needed to control the behaviour of dCache. dCache works well without directory tags.
CREATE, LIST AND READ DIRECTORY TAGS IF THE NAMESPACE IS NOT MOUNTED
You can create tags with
[user] $ /usr/bin/chimera writetag <directory> <tagName> "<content>"
list tags with
[user] $ /usr/bin/chimera lstag <directory>
and read tags with
[user] $ /usr/bin/chimera readtag <directory> <tagName>
Example: Create tags for the directory
[user] $ /usr/bin/chimera writetag /data sGroup "myGroup" [user] $ /usr/bin/chimera writetag /data OSMTemplate "StoreName myStore"
list the existing tags with
[user] $ /usr/bin/chimera lstag /data Total: 2 OSMTemplate sGroup
and their content with
[user] $ /usr/bin/chimera readtag /data OSMTemplate StoreName myStore [user] $ /usr/bin/chimera readtag /data sGroup myGroup
CREATE, LIST AND READ DIRECTORY TAGS IF THE NAMESPACE IS MOUNTED
If the namespace is mounted, change to the directory for which the tag should be set and create a tag with
[user] $ cd <directory> [user] $ echo '<content1>' > '.(tag)(<tagName1>)' [user] $ echo '<content2>' > '.(tag)(<tagName2>)'
Then the existing tags may be listed with
[user] $ cat '.(tags)()' .(tag)(<tagname1>) .(tag)(<tagname2>)
and the content of a tag can be read with
[user] $ cat '.(tag)(<tagname1>)' <content1> [user] $ cat '.(tag)(<tagName2>)' <content2>
Create tags for the directory data with
[user] $ cd data [user] $ echo 'StoreName myStore' > '.(tag)(OSMTemplate)' [user] $ echo 'myGroup' > '.(tag)(sGroup)'
list the existing tags with
[user] $ cat '.(tags)()' .(tag)(OSMTemplate) .(tag)(sGroup)
and their content with
[user] $ cat '.(tag)(OSMTemplate)' StoreName myStore [user] $ cat '.(tag)(sGroup)' myGroup
A nice trick to list all tags with their contents is
[user] $ grep "" $(cat ".(tags)()") .(tag)(OSMTemplate):StoreName myStore .(tag)(sGroup):myGroup
DIRECTORY TAGS AND COMMAND FILES
When creating or changing directory tags by writing to the command file as in
[user] $ echo '<content>' > '.(tag)(<tagName>)'
one has to take care not to treat the command files in the same way as regular files, because tags are different from files in the following aspects:
tagNameis limited to 62 characters and the
contentto 512 bytes. Writing more to the command file, will be silently ignored.
If a tag which does not exist in a directory is created by writing to it, it is called a primary tag.
Tags are inherited from the parent directory by a newly created directory. Changing a primary tag in one directory will change the tags inherited from it in the same way. Creating a new primary tag in a directory will not create an inherited tag in its subdirectories.
Moving a directory within the CHIMERA namespace will not change the inheritance. Therefore, a directory does not necessarily inherit tags from its parent directory. Removing an inherited tag does not have any effect.
Empty tags are ignored.
DIRECTORY TAGS FOR dCache
The following directory tags appear in the dCache context:
OSMTemplate Must contain a line of the form “
HSMType tag is normally determined from the other existing tags. E.g., if the tag
osm is assumed. With this tag it can be set explicitly. A class implementing that HSM type has to exist. Currently the only implementations are
sGroup The storage group is also used to construct the storage class if the
cacheClass The cache class is only used to control on which pools the files in a directory may be stored, while the storage class (constructed from the two above tags) might also be used by the HSM. The cache class is only needed if the above two tags are already fixed by HSM usage and more flexibility is needed.
hsmInstance If not set, the
hsmInstance tag will be the same as the
HSMType tag. Setting this tag will only change the name as used in the storage class and in the pool commands.
WriteToken Assign a
WriteToken tag to a directory in order to be able to write to a space token without using the
STORAGE CLASS AND DIRECTORY TAGS
The storage class is a string of the form
StoreNameis given by the OSMTemplate tag,
StorageGroup by the sGroup tag and
hsm-type by the HSMType tag. As mentioned above the HSMType tag is assumed to be osm if the tag OSMTemplate exists.
In the examples above two tags have been created.
Example: [user] $ /usr/bin/chimera lstag /data Total: 2 OSMTemplate sGroup
As the tag OSMTemplate was created the tag HSMType is assumed to be osm. The storage class of the files which are copied into the directory /data after the tags have been set will be myStore:myGroup@osm.
If directory tags are used to control the behaviour of dCache and/or a tertiary storage system, it is a good idea to plan the directory structure in advance, thereby considering the necessary tags and how they should be set up. Moving directories should be done with great care or even not at all. Inherited tags can only be created by creating a new directory.
Assume that data of two experiments, experiment-a and experiment-b is written into a namespace tree with subdirectories /data/experiment-a and /data/experiment-b. As some pools of the dCache are financed by experiment-a and others by experiment-b they probably do not like it if they are also used by the other group. To avoid this the directories of experiment-a and experiment-b can be tagged.
[user] $ /usr/bin/chimera writetag /data/experiment-a OSMTemplate "StoreName exp-a" [user] $ /usr/bin/chimera writetag /data/experiment-b OSMTemplate "StoreName exp-b"
Data from experiment-a taken in 2010 shall be written into the directory /data/experiment-a/2010 and data from experiment-a taken in 2011 shall be written into /data/experiment-a/2011. Data from experiment-b shall be written into /data/experiment-b. Tag the directories correspondingly.
[user] $ /usr/bin/chimera writetag /data/experiment-a/2010 sGroup "run2010" [user] $ /usr/bin/chimera writetag /data/experiment-a/2011 sGroup "run2011" [user] $ /usr/bin/chimera writetag /data/experiment-b sGroup "alldata"
List the content of the tags by
[user] $ /usr/bin/chimera readtag /data/experiment-a/2010 OSMTemplate StoreName exp-a [user] $ /usr/bin/chimera readtag /data/experiment-a/2010 sGroup run2010 [user] $ /usr/bin/chimera readtag /data/experiment-a/2011 OSMTemplate StoreName exp-a [user] $ /usr/bin/chimera readtag /data/experiment-a/2011 sGroup run2011 [user] $ /usr/bin/chimera readtag /data/experiment-b/2011 OSMTemplate StoreName exp-b [user] $ /usr/bin/chimera readtag /data/experiment-b/2011 sGroup alldata
As the tag OSMTemplate was created the HSMType is assumed to be osm. The storage classes of the files which are copied into these directories after the tags have been set will be
- exp-a:run2010@osm for the files in /data/experiment-a/2010
- exp-a:run2011@osm for the files in /data/experiment-a/2011
- exp-b:alldata@osm for the files in /data/experiment-b*
To see how storage classes are used for pool selection have a look at the example ’Reserving Pools for Storage and Cache Classes’ in the PoolManager chapter.
There are more tags used by dCache if the