The script dcache provides some high-level administrative operations on dCache. This include starting, stopping or restarting either individual dCache components or all components configured to run locally.

In general, the dcache script takes a single command followed by zero or more arguments for that command. These commands include start, stop and restart.

To obtain a list of components that are currently running, use the status command. For example:

[root@dcache-node] # /opt/d-cache/bin/dcache status
Domain                    Status      Pid Log file
lmDomain                  running   17203 /var/log/lmDomain.log
dCacheDomain              running   17251 /var/log/dCacheDomain.log
chimeraDomain             running   17311 /var/log/chimeraDomain.log
dirDomain                 running   17379 /var/log/dirDomain.log
adminDomain               running   25230 /var/log/adminDomain.log
httpdDomain               running   17522 /var/log/httpdDomain.log
utilityDomain             running   17603 /var/log/utilityDomain.log
infoProviderDomain        running   17655 /var/log/infoProviderDomain.log
gPlazma-dcache-nodeDomain running   17746 /var/log/gPlazma-dcache-nodeDomain.log
dcap-dcache-nodeDomain    running   17860 /var/log/dcap-dcache-nodeDomain.log
xrootd-dcache-nodeDomain  running   17918 /var/log/xrootd-dcache-nodeDomain.log
gridftp-dcache-nodeDomain running   18022 /var/log/gridftp-dcache-nodeDomain.log
gsidcap-dcache-nodeDomain running   18102 /var/log/gsidcap-dcache-nodeDomain.log
srm-dcache-nodeDomain     running   18134 /opt/d-cache/libexec/apache-tomcat-5.5.20/logs/catalina.out
dcache-nodeDomain         running   18401 /var/log/dcache-nodeDomain.log

The dcache script is also used to stop all dCache components running on a node in a controlled fashion. For example:

[root@dcache-node] # /opt/d-cache/bin/dcache stop
Stopping dcache-nodeDomain (pid=22444) 0 1 2 3 Done
Using CATALINA_BASE:   /opt/d-cache/libexec/apache-tomcat-5.5.20
Using CATALINA_HOME:   /opt/d-cache/libexec/apache-tomcat-5.5.20
Using CATALINA_TMPDIR: /opt/d-cache/libexec/apache-tomcat-5.5.20/temp
Using JRE_HOME:       /usr/java/jdk1.5.0_16
Stopping srm-dcache-node (pid=22248) 0 Done
Stopping gsidcap-dcache-nodeDomain (pid=22199) 0 Done
Stopping gridftp-dcache-nodeDomain (pid=22094) 0 Done
Stopping xrootd-dcache-nodeDomain (pid=21996) 0 Done
Stopping dcap-dcache-nodeDomain (pid=21924) 0 Done
Stopping gPlazma-dcache-nodeDomain (pid=21837) 0 Done
Stopping infoProviderDomain (pid=21757) 0 Done
Stopping utilityDomain (pid=21657) 0 Done
Stopping httpdDomain (pid=21580) 0 1 2 3 Done
Stopping adminDomain (pid=21502) 0 Done
Stopping dirDomain (pid=21425) 0 Done
Stopping chimeraDomain (pid=21344) 0 Done
Stopping dCacheDomain (pid=21291) 0 Done
Stopping lmDomain (pid=21226) 0 Done

To start all componants appropriate for the node, simply use the command dcache start. The script will start the components that are appropriate for this node, listing the process ID (pid) for each as they are started. For example:

[root@dcache-node] # /opt/d-cache/bin/dcache start
Starting lmDomain  Done (pid=21226)
Starting dCacheDomain  Done (pid=21291)
Starting chimeraDomain  Done (pid=21344)
Starting dirDomain  Done (pid=21425)
Starting adminDomain  Done (pid=21502)
Starting httpdDomain  Done (pid=21580)
Starting utilityDomain  Done (pid=21657)
Starting infoProviderDomain  Done (pid=21757)
Starting gPlazma-dcache-nodeDomain  Done (pid=21837)
Starting dcap-dcache-nodeDomain  Done (pid=21924)
Starting xrootd-dcache-nodeDomain  Done (pid=21996)
Starting gridftp-dcache-nodeDomain  Done (pid=22094)
Starting gsidcap-dcache-nodeDomain  Done (pid=22199)
Using CATALINA_BASE:   /opt/d-cache/libexec/apache-tomcat-5.5.20
Using CATALINA_HOME:   /opt/d-cache/libexec/apache-tomcat-5.5.20
Using CATALINA_TMPDIR: /opt/d-cache/libexec/apache-tomcat-5.5.20/temp
Using JRE_HOME:       /usr/java/jdk1.5.0_16

Pinging srm server to wake it up, will take few seconds ...
- Unable to find required classes (javax.activation.DataHandler and javax.mail.internet.MimeMultipart). Attachment support is disabled.
VersionInfo : v2.2
backend_type:dCache

Done
Starting dcache-nodeDomain  Done (pid=22444)

Individual components may be started or stopped by naming the component as an argument to the dcache start command. For example:

[root@dcache-node] # /opt/d-cache/bin/dcache stop utility
Stopping utilityDomain (pid=5684) 0 Done
[root@dcache-node] # /opt/d-cache/bin/dcache start utility
Starting utilityDomain  Done (pid=7494)

The dcache restart command is a synonym for stop followed by start. It takes an optional argument: the component to restart. If no argument is specified then all components of dCache on the node are restarted.

[root@dcache-node] # /opt/d-cache/bin/dcache restart utility
Stopping utilityDomain (pid=28150) 0 Done
Starting utilityDomain  Done (pid=31272)