jalien Command Reference#
cd#
pwd#
mkdir#
usage: mkdir [-options] <directory> [<directory>[,<directory>]]
options:
-p : create parents as needed
-silent : execute command silently
rmdir#
usage: rmdir [<option>] <directory>
options:
--ignore-fail-on-non-empty : ignore each failure that is solely because a directory is non-empty
-p : --parents Remove DIRECTORY and its ancestors. E.g., 'rmdir -p a/b/c' is similar to 'rmdir a/b/c a/b a'.
-v : --verbose output a diagnostic for every directory processed
: --help display this help and exit
: --version output version information and exit
-silent : execute command silently
ls#
usage: ls [-options] [<directory>]
options:
-l : long format
-a : show hidden .* files
-F : add trailing / to directory names
-b : print in guid format
-c : print canonical paths
-H : human readable file sizes (1024-based); implies '-l'
find#
usage: find [flags] <path> <pattern>
options:
-a : show hidden .* files
-s : no sorting
-c : print the number of matching files
-x <target LFN> : create the indicated XML collection with the results of the find operation
-d : return also the directories
-w[h] : long format, optionally human readable file sizes
-j <queueid> : filter files created by a certain job ID
-l <count> : limit the number of returned entries to at most the indicated value
-o <offset> : skip over the first /offset/ results
-r : pattern is a regular expression
-f : return all LFN data as JSON fields (API flag only)
-y : (FOR THE OCDB) return only the biggest version of each file
toXml#
usage: toXml [-i] [-x xml_file_name] [-a] [-l list_from] [lfns]
options:
-i : ignore missing entries, continue even if some paths are not/no longer available
-x : write the XML content directly in this target AliEn file
-a : (requires -x) append to the respective collection
-l : read the list of LFNs from this file, one path per line
cat#
usage: cat [-options] [<filename>]
options:
-o : outputfilename
-n : number all output lines
-b : number nonblank output lines
-E : shows ends - display $ at end of each line number
-T : show tabs -display TAB characters as ^I
whereis#
usage: whereis [-options] [<filename>]
options:
-g : use the lfn as guid
-r : resolve links (do not give back pointers to zip archives)
-l : lookup the LFN of the ZIP archive (slow and expensive IO operation, only use it sparingly!)
cp#
usage: cp [-options] <source> [<target>]
Source and target paths can be one of the following formats:
file://<local file on disk>
alien://<path in the Grid catalogue>
or without a prefix, in which case it's treated as a Grid path
options:
-g : treat the Grid path as a GUID
-S <SEs|QoS:count> : Storage target specifications for uploading, default is 'disk:2'
-t : no target needed, create a local temporary file instead, print out the local path at the end
-silent : execute command silently
-w : wait for all replicas to complete upload before returning (default false)
-W : do _not_ wait for all replicas to complete upload, return as soon as the first replica is available
-T : Use this many concurrent download threads (where possible) - default 1
-d : delete local file after a successful upload (i.e. move local to Grid)
-j <job ID> : the job ID that has created the file
client-side implementation
rm#
usage: rm <LFN> [<LFN>[,<LFN>]]
options:
-f : ignore nonexistent files, never prompt
-r, -R : remove directories and their contents recursively
-i : prompt before every removal (for JSh clients)
mv#
touch#
type#
lfn2guid#
guid2lfn#
guidinfo#
access#
usage: access [options] <read|write> <lfn> [<specs>]
-s : for write requests, size of the file to be uploaded, when known
-m : for write requests, MD5 checksum of the file to be uploaded, when known
-j : for write requests, the job ID that created these files, when applicable
-f : for read requests, filter the SEs based on the given specs list
-u : for read requests, print http(s) URLs where available, and the envelopes in urlencoded format
commit#
chown#
Usage: chown -R <user>[.<group>] <file>
Changes an owner or a group for a file
-R : do a recursive chown
chmod#
Usage: chmod -R <octal mode> <path> [<path>...]
Changes the access mode for a catalogue path
-R : do a recursive chmod starting from the given path
deleteMirror#
Removes a replica of a file from the catalogue
Usage:
deleteMirror [-g] <lfn> <se> [<pfn>]
Options:
-g: the lfn is a guid
md5sum#
mirror#
mirror Copies a file into another SE
Usage:
mirror [-g] [-try <number>] [-S [se[,se2[,!se3[,qos:count]]]]] <lfn> [<SE>]
-g: Use the lfn as a guid
-S: specifies the destination SEs to be used
-try <NumOfAttempts> Specifies the number of attempts to try and mirror the file
grep#
changeDiff#
Show changes between the current version of the file and the previous one (same file name with a '~' suffix)
usage: changeDiff [<filename>]
options:
listFilesFromCollection#
usage: listFilesFromCollection [-options] collection
options:
-z : show size and other file details
-s : silent (API only)
packages#
listCEs#
listCEs: print all (or a subset) of the defined CEs with their details
usage: listCEs [-s] [CE name] [CE name] ...
options:
-s : print summary information
-p : filter by partition names
-v : print verbose output (including partitions)
jobListMatch#
listpartitions#
listpartitions: print all (or a subset) of the defined partitions
usage: listpartitions [-v] [Partition name] [Partition name] ...
options:
-v : print verbose output (including member CEs)
setCEstatus#
setCEstatus: Sets the status of a set of Computing Elements
usage: listpartitions [-status status] [CE name] [CE name] ...
options:
-status : Status to be set for the CEs (open / locked)
submit#
ps#
usage: ps [-options]
options:
-F l | -Fl | -L : long output format
-f <flags|status> : any number of (long or short) upper case job states, or 'a' for all, 'r' for running states, 'f' for failed, 'd' for done, 's' for queued
-u <userlist>
-s <sitelist>
-n <nodelist>
-m <masterjoblist>
-o <sortkey>
-j <jobidlist>
-l <query-limit>
-M : show only masterjobs
-X : active jobs in extended format
-A : select all owned jobs of you
-W : select all jobs which are waiting for execution of you
-E : select all jobs which are in error state of you
-a : select jobs of all users
-b : do only black-white output
-jdl <jobid> : display the job jdl
-trace <jobid> <tag>* : display the job trace information
-id : only list the matching job IDs, for batch processing (implies -b)
masterjob#
usage: masterjob <jobId> [-options] [merge|kill|resubmit|expunge]
options:
-status <status> : display only the subjobs with that status
-id <id> : display only the subjobs with that id
-site <id> : display only the subjobs on that site
-printid : print also the id of all the subjobs
-printsite : split the number of jobs according to the execution site
merge : collect the output of all the subjobs that have already finished
kill : kill all the subjobs
resubmit : resubmit all the subjobs selected
expunge : delete completely the subjobs
You can combine kill and resubmit with '-status <status>' and '-id <id>'.
For instance, if you do something like 'masterjob <jobId> -status ERROR_IB resubmit',
all the subjobs with status ERROR_IB will be resubmitted
kill#
w#
uptime#
resubmit#
top#
registerOutput#
df#
du#
Gives the disk space usage of one or more directories
usage: du [-ncs] <path>
options:
-n : Print raw numbers in machine readable format
-c : Include collections in the summary information
-s : Print a summary of all parameters
fquota#
fquota: Displays information about File Quotas.
usage: fquota list [-<options>]
Options:
-unit = B|K|M|G: unit of file size
jquota#
usage: jquota Displays information about Job Quotas.
options:
list [username] : get job quota information for the current account, or the indicated one
set <user> <field> <value> : to set quota fileds (one of maxUnfinishedJobs, maxTotalCpuCost, maxTotalRunningTime)
listSEs#
listSEs: print all (or a subset) of the defined SEs with their details
usage: listSEs [-qos filter,by,qos] [-s] [SE name] [SE name] ...
options:
-qos : filter the SEs by the given QoS classes. Comma separate entries for 'AND', pass multiple -qos options for an 'OR'
-s : print summary information
listSEDistance#
listSEDistance: Returns the closest working SE for a particular site. Usage
options:
-site : site to base the results to, instead of using the default mapping of this client to a site
-read : use the read metrics, optionally with an LFN for which to sort the replicas. Default is to print the write metrics.
-qos : restrict the returned SEs to this particular tag
setSite#
testSE#
Test the functional status of Grid storage elements
Usage: testSE [options] <some SE names, numbers or @tags>
-v : verbose error messages even when the operation is expected to fail
-c : show full command line for each test
-t : time each operation
-a : test all SEs (obviously a very long operation)
listTransfer#
listTransfer: returns all the transfers that are waiting in the system
Usage:
listTransfer [-status <status>] [-user <user>] [-id <queueId>] [-verbose] [-master] [-summary] [-all_status] [-jdl] [-destination <site>] [-list=<number(all transfers by default)>] [-desc]
uuid#
stat#
xrdstat#
usage: xrdstat [-d [-i]] [-v] [-p PID,PID,...] [-s SE1,SE2,...] [-c] <filename1> [<or UUID>] ...
options:
-d : Check by physically downloading each replica and checking its content. Without this a stat (metadata) check is done only.
-i : When downloading each replica, ignore `stat` calls and directly try to fetch the content.
-s : Comma-separated list of SE names to restrict the checking to. Default is to check all replicas.
-c : Print the full command line in case of errors.
-v : More details on the status.
-p : Comma-separated list of job IDs to check the input data of
-o : Only show the online status (for files with tape replicas in particular)
-O : Request the file to be brought online
-4 : Force IPv4 usage on all commands
-6 : Force IPv6 usage on all commands
resyncLDAP#
optimiserLogs#
Usage: lastOptimiserLog [-l] [-v] [-f <frequency>] <classnames or metanames>
Gets the last log from the optimiser
-v : Verbose, displays the frequency, last run timestamp and log
-l : List the class names that match a query
-f <value> : Frequency, in seconds
showTagValue#
usage: showtagValue [flags] <filename> [<filename>...]
options:
-t : restrict to this (comma separated) tag list only (default is to return all available tags)
-c : restrict to these (comma separated) list of attributes
-l : list available tags only
time#
timing#
commandlist#
motd#
ping#
usage: ping
-c : Number of iterations
-s : Sleep between iterations, default 1000 (milliseconds)
-n : Numeric IP addresses, don't try to resolve anything
version#
whoami#
user#
whois#
usage: whois [account name]
options:
-s : search for the given string(s) in usernames
-f : also search in full names
-e : search in email addresses too
-d : search in X509 DN (subject) fields
-a : search for the given string in all the above fields
groups#
token#
usage: token [-options]
options:
-u <username> : switch to another role of yours
-v <validity (days)> : default depends on token type
-t <tokentype> : can be one of: job, jobagent, host, user (default)
-jobid <job DN extension> : expected to be present in a job token
-hostname <FQDN> : required for a host certificate
lfnexpiretime#
usage: lfnexpiretime [-options] [<file>]
options:
-r : removes the expire time set for an LFN
-a : add a new expire time for the given LFN
-e : extends the current expire time for the given LFN
-d <number> : specifies the number of days in the expire time
-w <number> : specifies the number of weeks in the expire time
-m <number> : specifies the number of months in the expire time
-y <number> : specifies the number of years in the expire time