Page History

UNICORE (Uniform Interface to Computing Resources) offers a ready-to-run Job submission system including client and server software. UNICORE makes distributed computing and data resources available in a seamless and secure way in intranets and the internet (https://www.unicore.eu/).

UCC (Unicore Command Line Client)

The UNICORE Commandline Client (UCC) is a full-featured client for accessing UNICORE services. It requires a Java runtime environment, version 8 11 or later. We recommend using the OpenJDK.

UCC offers * :

• Job submission and management

• Data movement (upload, download, server-to-server copy, etc) using the UNICORE storage management functions and the available data transfer protocols

• Storage functions (ls, mkdir, ...) including creation of storage instances via storage factories

• UNICORE Workflow service support and much more

https://sourceforge.net/projects/unicore/files/Clients/

• .

Installation and Startup

The following instructions were taken from the UNICORE Command Line Client User guide, for more info please refer to the UNICORE official documentation.

Prerequisites

• Operating Systems: currently Linux and Microsoft Windows are supported;
• To run UCC, you need a Java runtime version 11 or later (OpenJDK preferred).

Procedure

1. Download the installation archive

2. Untar the tar.gz file and copy it in your home directory

1. or in the folder you prefer.
2. Download the CA certificates by clicking on "Package with individual certs from CAcerts file in gz format" at this page. Copy in the folder ~/.unicore/certificates/ and untar it.
3. Download the following certificate file unicore.hpc.cineca.it.CA.pem and add it to the certificate folder (not mandatory, but avoids "Add exception" requests at each ucc command launch).
4. Login to UserDB using OpenID credentials and copy your OIDC token bearer visualized at this page.
5. Configure your UCC preferences file (~/.ucc/preferences) adding

1. a few lines as information into the file,

1. and insert your OIDC/OAuth2 token bearer.
   When finished, the file should appear as follows:

#################################################################

# User preferences for UCC
authentication-method=bearer-token
token=eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwi.....FkyV3pVSUFzc0RwaVprRURZV1U4Ukh3In0.eyJqdGkiOiJiMDBmNTkyMS01YjkxLTQzMGQtOTBjZC05ZDY4OTc4ODY4MTciLCJleHAiOjE2Njc5MzY0MTEsIm5iZiI6MCw.......cLXA

# configure truststore containing trusted CA certs
truststore.type=directory

# if type is 'directory'
truststore.directoryLocations.1=/home/<user>/.unicore/certificates/*.pem
truststore.directoryEncoding=PEM

# do not check the SSL cert contains correct hostname
client.serverHostnameChecking=NONE

# The address(es) of the registries to contact
# (space separated list)

registry=https://unicore.hpc.cineca.it:9111/PRACE/services/Registry?res=default_registry
# default directory for output
output=.
protocols=UFTP BFT

#################################################################