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.
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) |
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