Common options to UCC

This page lists the options understood by all UCC commands. Most commands have additional options. You can get a summary of these by calling a UCC command with the "-h" option.

Common Options

option (short and long form) description
-c,--configuration Properties_file Properties file containing your preferences. By default, a file 'userhome/.ucc/preferences' is checked.
-k,--keystore Keystore_file Keystore containing your user credential and trusted certificates
-n,--alias Alias Key entry alias (by default, the first key entry is used)
-p,--password Password Keystore password
-x,--storetype jks/pkcs12 Keystore type (default is "jks")
-T,--truststore Truststore_file (optional) Truststore in JKS format containing your trusted certificates
-Y,--truststorePassword Password Truststore password
-o,--output Output_dir Directory for any output produced (default is the current directory)
-r,--registry List_of_Registry_URLs The comma-separated list of URLs of UNICORE registries
-v,--verbose Verbose mode
-h,--help print help message
-y,--with-timing Timing mode (may not be supported by all commands)

Configuration file

By default, UCC checks for the existence of a file userhome/.ucc/preferences and reads default settings from there. As shown above, you can use a different file by specifiying it on the commandline using the "-c" option.

The configuration file can contain default settings for many commandline options, which are given in the form option name=value where option name is the long form of the option.

For example, to set your keystore and registry, the file can contain the following settings

keystore=user-keystore.p12
storetype=pkcs12
password=XXXXXXX
registry=https://localhost:8080/XNJS/services/Registry?res=default_registry

(Note: if you store your password there, you should make the file non-readable by others)

The configuration file may also contain low-level options, for example if you need to specify connection timeouts, etc. Please refer to the documentation of the WSRFlite toolkit at http://www.unicore.eu/documentation/manuals/unicore6/wsrflite and the UNICORE/X documentation at http://www.unicore.eu/documentation/manuals/unicore6/unicorex

For example, to set the timeout when establishing a connection to 5 seconds, you would use

http.connection.timeout=5000