QCG-SimpleClient oferuje prosty, wzorowany na poleceniech systemu kolejkowego, interfejs do infrastruktury QCG.
Wszystkie polecenia qcg-* wywołane z przełącznikiem h/-help wyświetlają informacje o sposobie ich użycia.
qcg-<command> -h qcg-<command> --help
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ń 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-cancel J1363865127610__1345 qcg-cancel J1363865127610__1345/task qcg-cancel J1363865127610__1345 J1363865128119__5737
Usunięcie katalogu roboczego zadnia, lub grupy zadań.
Clean task(s). Remove working directory usage: qcg-clean [-h] [-v] JOBID[/TASKID] [JOBID[/TASKID]] ... usage: qcg-client clean_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'
Lista zadań 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-clean J1363865127610__1345 qcg-clean J1363865127610__1345/task qcg-clean J1363865127610__1345 J1363865128119__5737
Utworzenie z klienta QCG interaktywnej sesji w katalogu roboczym danego zadania.
Connect to the task. Open interactive terminal in the working directory of the task usage: qcg-connect [-h] [-v] JOBID[/TASKID] usage: qcg-client connect_to_tasks [-h] [-v] 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'
Identyfikator podawany 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 przyjmowany jest domyślny - "task".
Zadania opisane przy pomocy formatu QCG-Simple nie wymagają podawania identyfikatora zadania, wystarczy tylko JOBID.
qcg-connect J1363865127610__1345 qcg-connect J1363865127610__1345/task
Podłączenie interaktywnej sesji do zadania możliwe jest tylko, gdy zdanie jest wykonywane (stan RUNNING).
Wyświetlenie szczegółowej informacji o danym zadaniu, lub zbiorze zadań.
Display information about task(s) usage: qcg-info [-d] [-h] [-v] JOBID[/TASKID] [JOBID[/TASKID]] ... usage: qcg-client task_info [-d] [-h] [-v] JOBID[/TASKID] [JOBID[/TASKID]] ... Options: -d,--description display user's job description -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'
Lista zadań 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.
Opcjonalny przełącznik -d definiuje czy ma być wyświetlony opis z jakim zlecone zostało zadnie. Domyślnie opis nie jest wyświetlany.
Polecnie qcg-interactive zastąpione zostało przez polecnie qcg-sub wywołane z przełącznikiem -I.
qcg-sub -I interactive.qcg
Wyświetlenie listy zleconych zadań wraz z informacjami o nich.
Display information about tasks usage: qcg-list [-h] [-R <NO_LIST>] [-S <period>] [-s <status(es)>] [-v] usage: qcg-client get_tasks [-h] [-R <NO_LIST>] [-S <period>] [-s <status(es)>] [-v] Options: -h,--help display help message -R,--report <NO_LIST> display summary report. Set the optional NO_LIST argument to TRUE to omit the list. -S,--submitted <period> submited in the period of time. If the status is defined the default value of the period is 1 day. -s,--status <status(es)> status(es) of the job. Lack of this option is equivalent to requesting unterminated activities. -v,--version display version
Polecenie wyświetla listę zadań użytkownika.
Opcja -S pozwala okreslic, że wyświetlone mają być zdania zlecone w zadanym okresie czasu. W ciągu ostatnich „liczba” dni („d”), godzin („h”), minut („m”).
Opcja -s pozwala zawęzić listę wyświetlanych zadań do zadań w danym stanie. Możliwe jest podanie wielu stanów rozdzielonych przecinkiem.
Statusy zadań:
Dla wygody użytkowników zamiast listy stanów możliwe jest podanie zdefiniowanych stałych:
Przełącznik -R włacza wyświetlenie reportu przedstawiającego liczbę zadań w każdym stanie.
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 -S file1.qcg file2.qcg file3.qcg
Korzystając z polecenia qcg-sub 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-sub -I interactive.qcg
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
Utworzenie certyfikatu proxy użytkownika.
qcg-proxy
qcg-refetch jobId
Ponowne skopiowanie plików wynikowych zadania.
jobId - identyfikator eksperymentu
qcg-refetch J1331196390748_date_3099