A pool may be renamed with the following procedure, regardless of the type of files stored on it.

Disable file transfers from and to the pool with

(<poolname>) admin > pool disable -strict

Then make sure, no transfers are being processed anymore. All the following commands should give no output:

(<poolname>) admin > queue ls queue
(<poolname>) admin > mover ls
(<poolname>) admin > p2p ls
(<poolname>) admin > pp ls
(<poolname>) admin > st jobs ls
(<poolname>) admin > rh jobs ls

Now the files on the pools have to be unregistered on the pnfs server with

(<poolname>) admin > pnfs unregister

Even if the pool contains precious files, this is no problem, since we will register them again in a moment. The files might not be available for a short moment, though. Log out of the pool, and stop the domain running the pool:

[root] # /opt/d-cache/bin/dcache stop <poolDomain>
Stopping <poolDomain> (pid=6070) 0 1 2 3 done
[root] #

Adapt the name of the pool in the layout files of your dCache installation to include your new pool-name. For a general overview of layout-files see the section called “Defining domains and services”.

[<poolDomain>]
[<poolDomain>/pool]
name=swimmingPool
path=/pool/

[<poolDomain>]
[<poolDomain>/pool]
name=carPool
path=/pool/

Register the files on the pool with

(<poolname>) admin > pnfs register