Polecenia

• qcg-cancel - anulowanie zadania
• qcg-clean - usunięcie katalogu roboczego zadnia
• qcg-connect - interaktywne "podłączenie" się do działającego zadania
• qcg-info - wyświetlenie szczegółowej informacji o danym zadaniu
  
• qcg-interactive - zlecenie zadania interaktywnego
• qcg-list - wyświetlenie listy zleconych zadań wraz z informacjami o nich
• qcg-peek - podgląd wyjścia (stdout, stderr) aplikacji
• qcg-proxy - utworzenie certyfikatu proxy użytkownika
• qcg-rcancel - anulowanie rezerwacji
• qcg-refetch - ponowne skopiowanie plików wynikowych zadania
• qcg-reserve - rezerwacja zasobów
• qcg-rinfo - wyświetlenie szczegółowej informacji o rezerwacji
• qcg-rlist - wyświetlenie listy rezerwacji wraz z informacjami o nich
• qcg-sub - zlecenie zadania do wykonania na infrastrukturze QCG zgodnie z uproszczonym opisem

Składnia poleceń

qcg-<command> -h
qcg-<command> --help

qcg-cancel

Anulowanie zadania

Cancel task(s)

usage: qcg-cancel [-h] [-v]   JOBID[/TASKID] [JOBID[/TASKID]] ...
usage: qcg-client cancel_task [-h] [-v]   JOBID[/TASKID] [JOBID[/TASKID]] ...

Options:
 -h,--help      display help message
 -v,--version   display version

Arguments:
 JOBID  identifier of the job
 TASKID optional identifier of the task
        The default identifier of task is 'task'

Polecenie umożliwia annulowanie listy zadań.

Lista zadań do anulowania podawana jest w formacie JOBID[/TASKID], gdzie JOBID to identyfikator eksperymentu zwrócony przez polecenia qcg-sub, TASKID to opcjonalny identyfikator zadania w ramach eksperymentu. W przypadku braku indentyfikatora przyjnowany jest domyślny - "task".

Zadania opisane przy pomocy formatu QCG-Simple nie wymagają podawania identyfikatora zadania, wystarczy tylko JOBID.

qcg-sub

Zlecenie zadania do wykonania na infrastrukturze QCG zgodnie z podanym opisem.

Submit job(s) to the QCG infrastructure

usage: qcg-sub [-h] [-I] [-J | -S | -X] [-R <NUMBER>]  [-v]   FILE [FILE] ...
usage: qcg-client submit_job [-h] [-I] [-J | -S | -X] [-R <NUMBER>]  [-v]   FILE [FILE] ...

Options:
 -h,--help              display help message
 -I,--interactive       Interactive mode
 -J,--jsdl              JSDL dialect
 -R,--repeat <NUMBER>   repeat submission (only for testing)
 -S,--simple            QCG Simple dialect
 -v,--version           display version
 -X,--xml               QCG XML dialect

Arguments:
 FILE   Path to file with job description

Jako argumenty polecenie przyjmuje listę scieżek do plików zawierających opisy zadań.

qsg-sub akceptuje zadania opisane w jednym z nastepująch formatów: QCG-Simple (-S), QCG-JobProfile (-X) oraz JSDL (-J). Domyślnym formatem jest QCG-Simple (-S).

Zlecenie zadania interaktywnego wymaga podania przełącznika -I. W przypadku zlecenia zadania interaktywnego mozliwe jest podanie tylko jednego opisu zadania.

Przełącznik R umożliwia n-krotne zlecenie tego samego zadania w celach testowych (w przyszlości każde wywołanie będzie miało ustawioną zmienną środowiskową informującą o numerze iteracji).

qcg-sub -S experiment.qcg
qcg-sub -I interactive.qcg
qcg-sub -S file1.qcg file2.qcg file3.qcg

qcg-list

qcg-list czas_jednostka [stan,[stan]]

Wyświetlenie listy zleconych zadań wraz z informacjami o nich.
czas_jednostka - Opcjonalnie można podać z jakiego czasu mają być zadania - z ostatnich „liczba” dni („d”), godzin („h”), minut („m”).
stan - Drugim opcjonalnym parametrem jest lista stanów zadań oddzielonych przecinkami (bez spacji). W przypadku niepodania stanów wyświetlane są zadania niezakończone.

qcg-list 
qcg-list 7d
qcg-list 1m
qcg-list 7d finished
qcg-list 1m finished,failed

Dla wygody użytkowników zamiast listy stanów możliwe jest podanie zdefiniowanych stałych:

• all - zadania we wszystkich stanach,
• terminated - zadania zakończone,
• unterminated - zadania niezakończone.

  qcg-list 7d all
  qcg-list 7d terminated
  qcg-list 7d unterminated

qcg-info

qcg-info jobId pokaz_opis

Wyświetlenie szczegółowej informacji o danym zadaniu.
jobId - identyfikator eksperymentu.
pokaz_opis- Jeśli pokaz_opis ma wartość „true” to dodatkowo wyświetlany jest opis zadnia. Domyślną wartością jest „false”.

  qcg-info J1331196390748_date_3099 true

qcg-peek

gcg-peek jobId liczba_znaków

Podgląd wyjścia (stdout, stderr) aplikacji.
jobId - identyfikator eksperymentu,
liczba_znaków- liczba znaków do wyświetlenia,

qcg-peek J1331196390748_date_3099
qcg-peek J1331196390748_date_3099 10

qcg-proxy

qcg-proxy

Utworzenie certyfikatu proxy użytkownika.

qcg-proxy

qcg-clean

qcg-clean jobId

Usunięcie katalogu roboczego zadnia.
jobId - identyfikator eksperymentu

  qcg-clean J1331196390748_date_3099

qcg-interactive

qcg-interactive plik_z_opisem

Zlecenie zadania interaktywnego.
plik_z_opisem - ścieżka do pliku z uproszczonym opisem zadania

  qcg-interactive /home/piontek/tasks/bash.qcg
  qcg-interactive ./tasks/bash.qcg

Korzystając z polecenia qcg-interactive można zlecić wykonanie dowolnej interaktywnej tekstowej aplikacji.

Szczególnie częstym i użytecznym przypadkiem jest interaktywne uruchomienie konsoli poleceń umożliwiające np. kompilację oprogramowani na klastrze, do którego nie ma dostępu poprzez SSH.

W opisie zadania dla interaktywnego uruchomienia konsoli poleceń wystarczy podać nazwę klastra, na którym ma sie uruchomić konsola oraz podać scieżkę do preferowanego interpretera poleceń (np. bash).

#QCG host=inula.man.poznan.pl

/bin/bash

W opisie zadania interaktywnego można korzystać również z innych dyrektyw QCG celem podania np. wymagań zasobowych dla zadania interaktywnego.

qcg-connect

qcg-connetct jobId
Utworzenie z klienta QCG interaktywnej sesji w katalogu roboczym danego zadania
jobId - identyfikator eksperymentu

qcg-connect J1331196390748_date_3099

qcg-refetch

qcg-refetch jobId

Ponowne skopiowanie plików wynikowych zadania.
jobId - identyfikator eksperymentu

  qcg-refetch J1331196390748_date_3099