The page describes the usage of the QCG-Broker Client, which is the command line text client for the QCG-Broker service.

System pre-requirements

• Installed qcg-broker-client package. The RPM installation procedure for SL5/6 is described here

User Requirements

• User's credential To secure the communication and authenticate the user to the service the X509 proxy certificate is needed.

Configuration

For its work the client needs user credentials to be present and properly configured. Additionally every user can overwrite some global settings to adapt configuration to its own preferences.

For details please visit the QCG-Client Configuration? page.

QCG Broker Client

The QCG-Client is a java based text client offering access to the QCG infrastructure from the command-line level. The QCG-Client is offered in two versions and the choice of version depends on user's experience and needs:

• QCG-SimpleClient (recommended) is a set of tools (similar to ones offered by queuing systems) for managing of jobs. For user's convenience the simple format of description of jobs (based on #QCG directives) was proposed allowing in a simple way to describe the most popular use cases.
• QCG-AdvancedClient - the client intended for more experienced users requiring more advanced features like workflows, parameter sweep, tasks with many groups of processes with different requirements. The job has to be described by XML document.

QCG Simple Client

The QCG Simple client is recommended for all users who do not need advanced capabilities of the QCG middleware like workflows, parallel jobs with topologies or parameter sweep jobs. In return, it offers access to the most frequently used functionality in very simple and intuitive way. The QCG Simple client consists of a set of command line tools modelled after the set of tools known from popular queueing systems. All tasks submitted to be executed by QCG-Broker must be described in a formal way using the concept of directives known also from queueing systems.

qcg-* Tools

Set of tools allowing to submit/control tasks and to reserve/control resources managed by the QCG infrastructure.

The detailed description of the qcg-* tools?

Submission and controlling of tasks:

• qcg-cancel - cancel task(s)
• qcg-clean - clean the working directories of given tasks
• qcg-connect - connect interactive session to the task
• qcg-info - display detailed information about the given tasks
• qcg-list - lists tasks in the system
• qcg-peek - display ending of (stdout, stderr) streams
• qcg-proxy - create user proxy certificate
• qcg-refetch - try to copy once again output files/directories
• qcg-refresh_proxy - refresh user proxy certificate for given tasks
• qcg-sub - submit the task to be processes by QCG services

Resources reservation and controll:

• qcg-rcancel - cancel reservation(s)
• qcg-reserve - reserve resources
• qcg-rinfo - display information about the given reservation(s)
• qcg-rlist - list reservation in the system

QCG-Simple description format