[[ucc_faq]]
Frequently asked questions
--------------------------


Configuration
~~~~~~~~~~~~~

==== Do I really have to store my password in the preferences file? Isn't this insecure?

Putting the password in a file or giving it as a commandline parameter can be considered 
insecure. The file could be read by others, and the commandline parameters may be visible 
in for example in the output of the 'ps' command.  
Thus, UCC will simply ask for the password in case you did not specify it.

==== How can I enable more detailed logging?

UCC uses log4j, by default the configuration is done in <UCC_HOME>/conf/logging.properties
You can edit this file and increase the logging levels, choose to log to a file or to the 
console, etc.


==== How can I set the HTTP connection timeout?

In your properties file, set
  
--------------
http.connection.timeout=<timeout in milliseconds>
--------------

==== How can I log the SOAP messages sent and received by UCC?

In your properties file, set
  
--------------
#log outgoing  messages
log.outgoing=true
#log incoming messages
log.incoming=true
--------------
  
which will log the messages on INFO level.

==== How can I generate a proxy cert and add it to my message in order to use e.g. GridFTP?

In your properties file, add
  
--------------
#enable proxy cert out handler
uas.security.out.handler.classname=de.fzj.unicore.uas.security.ProxyCertOutHandler
--------------
    
which will add a handler that creates a proxy cert and adds it to the message.

Usage
~~~~~

==== Can I use multiple registries with UCC?
  
Yes. Simply use a comma-separated list of URLs for the "-c" option. However, you 
may only use a single key/truststore, so all registries (and sites listed in 
them) must accept the same security credentials. 
  
==== Can I upload and execute my own executable?

Yes. Check xref:ucc_jobs[].
  
==== Can I use UCC to list the contents of the registry?

Using the 'wsrf' command, and the UNIX grep utility, this is very easy, 
for example

--------------
ucc wsrf getproperties https://localhost:8080/DEMO-SITE/services/Registry?res=default_registry | grep Address
--------------

will list the addresses of all services registered in the registry.

==== How can I use plain JSDL files instead of a .u JSON file for job submission?

Add the "-j" option when submitting a job.
  
==== I get strange errors related to security

Make sure to set and use an alias for your key entry, otherwise you might
experience strange errors, especially when using PKCS12 keystores.
Also read the general UNICORE FAQ on www.unicore.eu[the UNICORE website] 
which contains descriptions of many common errors.
  
==== Are the JSDL documents and workflow documents validated?

The JSDL documents passed to the run command and to submit-workflow are validated,
and any errors are logged. If you wish UCC to stop in case of validation errors, you need 
to set a property

-----------------
ucc.validation.fail_on_errors=true
-----------------


