release notes | Book: 1.9.5, 1.9.12 (opt, FHS), 2.11 (FHS), 2.12 (FHS), 2.13 (FHS), 2.14 (FHS), | Wiki | Q&A black_bg
Web: Multi-page, Single page | PDF: A4-size, Letter-size | eBook: epub black_bg

Renaming a Pool

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 service:

[root] # jobs/pool[2] -pool=<poolDomainName> stop

Rename the pool in the <poolDomain>.poollist-file. Restart the service:

[root] # jobs/pool -pool=<poolDomainName> -logfile=<dCacheLocation>/log/<poolDomainName>Domain.log start

Register the files on the pool with

(<poolname>) admin > pnfs register

[2] Filenames will always be relative to the dCache installation directory, which defaults to /opt/d-cache/.