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'
-v : verbose (summary of the listed content)
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. Use '-' for screen output of the XML content.
-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
-S <site name> : Sort the returned list by the distance to the given site
-e <pattern> : Exclude pattern
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
-m : queue mirror operations to the missing SEs, in case of partial success. Forces '-w'
-q <SEs|QoS:count> : Queue async transfers to the specified targets
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#
``` usage: commit API command only, you should not need to call this directly
Usage: chown -RChanges an owner or a group for a file
-R : do a recursive chown
```
chmod#
```
Usage: chmod -R
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]
Options:
-g: the lfn is a guid
```
md5sum#
usage: md5sum <filename1> [<or guid>] ...
mirror#
mirror Copies/moves a file to one or more other SEs
Usage:
mirror [-g] [-try <number>] [-r SE] [-S [se[,se2[,!se3[,qos:count]]]]] <lfn> [<SE>]
-g: Use the lfn as a guid
-S: specifies the destination SEs/tags to be used
-r: remove this source replica after a successful transfer (a `move` operation)
-try <attempts> Specifies the number of attempts to try and mirror the file (default 5)
grep#
```
usage: grep [-linux grep options]
options:
```
changeDiff#
```
Show changes between the current version of the file and the previous one (same file name with a '~' suffix)
usage: changeDiff [
options:
```
listRemoteDebug#
``` usage: listRemoteDebug: List instances of JR to debug Usage: listRemoteDebug [-options]
options:
-s : Sitename (default: any site)
-host : Hostname (default: any host)
-b : Build Timestamp (long) (default: any ts)
```
addRemoteDebug#
```
usage: addRemoteDebug: add instances of JR to debug
Usage:
addRemoteDebug
options:
-s : Sitename (default: any site)
-host : Hostname (default: any host)
-b : Build Timestamp (long) (default: any ts)
```
listFilesFromCollection#
``` usage: listFilesFromCollection [-options] collection
options:
-z : show size and other file details
-t : total size and number of files at the end of the listing
-s : silent (API only)
```
archiveList#
usage: archiveList <filename1> [<or uuid>] ...
packages#
usage: packages list available packages
-platform : Platform name, default Linux-x86_64
-all : List packages on all platforms. Equivalent to '-p all'
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#
``` jobListMatch: print all the CEs that can run a certain job usage: jobListMatch [jobId]
options:
```
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: setCEstatus [-status status][CE name] [CE name] ...
options:
-status : Status to be set for the CEs (open / locked)
```
submit#
```
usage: submit
<URL> => <LFN>
<URL> => file:///<local path>
```
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, 'w' for waiting
-u <userlist>
-s <sitelist>
-n <nodelist>
-m <masterjoblist>
-o <sortkey>
-j <jobidlist>
-l <query-limit>
-c <cpucores> : Filter jobs requesting this many cores (positive value) or skip a certain number of cores (negative value)
-t <time-limit-start, time-limit-end> : modified time between time-limit-start and time-limit-end in 'hours'. eg: -t 12,6 will output the jobs that were modified between last 12h to last 6h
-M : show only masterjobs
-X : active jobs in extended format (pass an extra -E or -f <flags> if you want other states)
-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; add a -X for a more human-friendly formated output
-trace <jobid> : display the job trace information; add a -X to format the epoch timestamps
-id : only list the matching job IDs, for batch processing (implies -b)
-q : quiet, no user printable output, API function only
-H : print headers
-S : show summary of states across the selection
-v : be verbose about job states and error codes (pass -vv for more details)
```
masterjob#
```
usage: masterjob
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
```
kill#
usage: kill <jobId> [<jobId>[,<jobId>]]
w#
``` usage: w Show currently active users on the Grid
options:
-a : Sort by the number of active jobs
-w : Sort by the number of waiting jobs
-r : Reverse sorting order
```
uptime#
``` usage: uptime
options:
```
resubmit#
resubmit: resubmits a job or a group of jobs by IDs
Usage:
resubmit <jobid1> [<jobid2>....]
top#
usage: top
registerOutput#
```
usage: registerOutput
options:
```
df#
Shows free disk space
Usage: df
du#
``` Gives the disk space usage of one or more directories
usage: du [-ncs]
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 <user>
jquota#
``` usage: jquota Displays information about Job Quotas.
options:
list [username]* : get job quota information for the current account, or the indicated ones
set <user> <field> <value> : to set quota fileds (one of [priority, maxTotalRunningTime, maxTotalCpuCost, maxParallelJobs, maxUnfinishedJobs])
priority default 1
maxTotalRunningTime default 10000000
maxTotalCpuCost default 10000000
maxParallelJobs default 1500
maxUnfinishedJobs default 3000
```
listSEs#
``` listSEs: print all (or a subset) of the defined SEs with their details usage: listSEs [-qos filter,by,qos][-s] [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#
``` usage: setSite [site name]
options:
```
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#
``` Usage: time
options:
return server side timing information
```
commandlist#
usage: commandlist
motd#
usage: motd Message of the day/alice/cern.ch/user/a/alienci/alienci
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#
echo#
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