To run UCC, you need the SUN Java 5 JRE or SDK (or later). If not installed on your system, you can download it from here.
You can get the latest version from the SourceForge download page.
To install, unpack the distribution in a directory of your choice. It's a good idea to add the bin/ directory to your PATH variable,
export PATH=$PATH:<UCC_HOME>/bin
where UCC_HOME is the directory you installed UCC in.
Windows note: Setting environment variables can be done (as administrator) using the Control panel->System->Extras panel.
Though you can specify your keystore location and other parameters on the commandline, it is easiest to place this information in a file, so that you do not have to key in this information repeatedly.
UCC checks by default whether the file userhome/.ucc/preferences exists, and reads it. To specify keystore, password and your preferred UNICORE 6 registry URL, the file should look as follows.
keystore=<your keystore> password=<your password> registry=<your registry URL>
Note: If you are worried about security, and do not want specify the password: UCC will ask for it if it is not given in the preferences or on the commandline.
Windows note: To create the .ucc folder, you might have to use the command prompt "mkdir" command. Also, the backslash '\' character needs to be written using an extra backslash '\\'
For example, if you are using the UNICORE 6 quickstart installation for testing, you could use
registry=https://localhost:8080/DEMO-SITE/services/Registry?res=default_registry
Note: If you wish to change the default property file location, you can set a Java VM property in the UCC start script, for example by editing the command that starts UCC
java .... -Ducc.preferences=<preferences location> ....
You need a keystore in jks or p12 format, that contains your user certificate and the certificate(s) of the certificate authorities that you trust. The trusted certificates can also reside in a separate file in jks format. Here is a full configuration example.
keystore=<your keystore> password=<your password> storetype=<jks or pkcs12> #optional: configure separate truststore (must be JKS) truststore=<your truststore> truststorePassword=<your password>
UCC writes some messages to the console, more if you choose the verbose mode (-v option). If you need real logging (e.g. when using the batch mode), you can edit the UCC_HOME/conf/logging.properties file, which configures the Log4J logging infrastructure used in UNICORE.
UCC can be extended with additional commands. To add commands to UCC, a so-called extensions file is used that relates the command names and the names of the corresponding Java class:
# #sample UCC extensions file # mycommand=eu.unicore.ucc.commands.MyCommand foo=org.foo.ucc.Foo
This file is specified in the UCC start script (UCC_HOME/bin/ucc on UNIX, ucc.bat on Windows). By default, the file is 'UCC_HOME/conf/extensions'.
The necessary Java code (jar files) must be placed in the UCC_HOME/lib directory .