Command Usage: samadmin v8_1_5 samadmin disallow disk
|  |
Command Description:
Mark a station cache disk as INACTIVE, for (e.g.,) hardware problems, etc. This
does NOT require a station reboot; but the station must be running in order
to tell it to mark the disk as inactive.
You must be a station administrator for this station in order to mark the disk as
INACTIVE.
You must specify the mount point as a fully specified mount point:
sam disallow disk --mount=d0mino.fnal.gov:/sam/cache1 --station=central-analysis
If you specify the --keepCachedFiles option, the contents of the disk
will not be destroyed. This is useful in the case where, for example,
a disk is on a node that is not responding, and you do not want any more
files to be delivered to that node, but you expect that at some point in
the future the node will be rebooted or the network will come back, etc.,
and the cached files on that disk will once again become available.
If the --keepCachedFiles option is NOT specified, the contents of the
disk will be destroyed. This is useful in the case when you are disallowing
a disk due to physical hardware problem on that disk.
Usage:
samadmin disallow disk <--requiredOptions> [--options] [-flags]
samadmin disallow station disk <--requiredOptions> [--options] [-flags]
Where:
--requiredOptions:
--mountPoint=<value> # mount point of this station cache disk
--station=<value> # station where this disk should be marked as INACTIVE
--options:
--keepCachedFiles # do NOT destroy the contents of the disk by removing all cached files
--connect=<value> # oracle username/password for connecting to this database
--corbaCallTimeout=<value> # time in seconds for CORBA method calls to return before timing out (default: 0; zero implies no timeout)
--retryInterval=<value> # retry interval base in seconds; will multiply this base times retryCount (default: 5)
--retryJitter=<value> # retry jitter, random jitter added to base retry interval times retryCount (default: 5)
--retryMaxCount=<value> # number of times to retry CORBA calls for retriable exceptions (default: 25; zero implies no retries)
-flags:
-c # automatically close all servants after each method call
-d # debug mode
-s # retrySilently mode (do not issue messages to stderr on proxy retries)
-t # time-it mode (print additional info on timings)
-v # verbose mode
Required Data Types:
connect : string
corbaCallTimeout : int
mountPoint : string
retryInterval : int
retryJitter : int
retryMaxCount : int
station : string
You may omit "-c" if the $SAM_PYAPI_AUTO_CLOSE_SERVANTS environmental variable is set.
You may omit "--connect=<value>" if the $SAM_ORACLE_CONNECT environmental variable is set.
You may omit "--corbaCallTimeout=<value>" if the $SAM_PYAPI_CORBA_CALL_TIMEOUT environmental variable is set.
You may omit "--retryInterval=<value>" if the $SAM_PYAPI_RETRY_INTERVAL environmental variable is set.
You may omit "--retryJitter=<value>" if the $SAM_PYAPI_RETRY_JITTER environmental variable is set.
You may omit "--retryMaxCount=<value>" if the $SAM_PYAPI_RETRY_MAX_COUNT environmental variable is set.
You may omit "-s" if the $SAM_PYAPI_RETRY_SILENTLY environmental variable is set.
You may omit "--station=<value>" if the $SAM_STATION environmental variable is set.
UNIX ExitStatus:
Success : 0
Unhandled exceptions : 127
See Also: