Admin use of UCC

You can use UCC to keep track of your jobs, or, with appropriate permissions, keep track of all the resources on a site. UCC allows to list jobs, Grid sites, and applications, including full details. Using the scripting facility, UCC can be extended to other administrative tasks.

Security considerations

Usually, each UNICORE user has only access to his or her own resources (such as jobs). For administrative use, you will need to aquire administrator privileges. There are two ways to achieve this.

  • create a dedicated certificate and map it to role "admin" in the XUUDB. This method is recommended if you want to remotely administrate UNICORE/X.
  • use the server keystore for UCC, which will also give you administrator privileges (on UNICORE 6.2.0 and later). This is useful if you are logged on to the UNICORE/X server.

Filtering lists

The commands that list server-side things (list-jobs etc) accept a filtering option, that can be used to limit the results of the operation. Filtering works on the resource properties of the resource in question.

Filtering is enabled by the "-f" or "--filter" option of the form

-f XMLNAME OPERATOR VALUE

where XMLNAME is the name of an XML Element from the WSRF resource properties document.

For example, to list all your running jobs:

ucc list-jobs -f Status equals RUNNING

To list all jobs submitted on Nov 13, 2007:

ucc list-jobs -f SubmissionTime contains 2007-11-13

etc.

operator (long and short form) description
equals, eq String equality (ignoring case)
notequals, neq String inequality (ignoring case)
contains, c Substring
notcontains, nc not substring
greaterthan, gt Lexical comparison
lessthan, lt Lexical comparison

WSRF commands

UCC supports low-level WSRF operations using the "wsrf" command.

To destroy a resource,

ucc wsrf destroy <Address>

To get a property listing

ucc wsrf getproperties <Address>

To extend the lifetime of a resource

ucc wsrf extend <Address> <Days>

Commands can be abbreviated, e.g. ucc wsrf d <Address>