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-sub

• Zlecenie zadania do wykonania na infrastrukturze QCG zgodnie z uproszczonym opisem
  plik_z_opisem - ścieżka do pliku z uproszczonym opisem zadania

  qcg-sub /home/piontek/tasks/date.qcg
  qcg-sub ./tasks/date.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-cancel

qcg-cancel jobId

Anulowanie zadania.
jobId - identyfikator eksperymentu

  qcg-cancel J1331196390748_date_3099

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

Przykładowe opisy zadań

Uruchomienie na klastrze galera aplikacji „gaussian”.

#QCG queue=plgrid-long
#QCG name=etanal
#QCG note=etanal Gaussian
#QCG output=${JOB_ID}.output
#QCG error=${JOB_ID}.error
#QCG stage-in-file=etanal.gjf -> etanal.gjf
#QCG stage-out-file=wynik.tar -> ${JOB_ID}.tar 
#QCG nodes=1:12
#QCG host=galera.task.gda.pl
#QCG persistent
#QCG walltime=P7D
#QCG notify=mailto:piontek@man.poznan.pl
#QCG memory=15360

#QCG preprocess=echo START
#QCG application=g09
#QCG argument=etanal.gjf 
#QCG postprocess=tar cvf wynik.tar *

Eksperyment polegający na:

• przegraniu z katalogu, z którego wykonano polecenie qcg-sub podkatalogu inputs na klaster na docelowy klaster (reef).
• zleceniu do wykonania na klastrze reef w kolejce plgrid polecenia /bin/tar pakującego przegrany wczesnej katalog inputs do pliku output.tgz.
• przesłaniu pliku output.tgz do katalogu, z którego wykonano polecenie qcg-sub pod tę samą nazwę.

#!/bin/bash

#QCG queue=plgrid
#QCG persistent
#QCG host=reef.man.poznan.pl
#QCG output=output
#QCG error=error

#QCG stage-in-dir=inputs -> inputs

/bin/tar -czf output.tgz inputs/input.*

#QCG stage-out-file=output.tgz -> output.tgz

Uruchomienie aplikacji NAMD

#QCG note=NAMD apoa1
#QCG name=ex_1                                                            
#QCG host=hydra.icm.edu.pl                                                
#QCG walltime=PT10M                                                       
#QCG queue=plgrid                                                         
#QCG nodes=1:12:12                                                        
#QCG persistent                                                           
#QCG output=apoa1.output                                                  
#QCG error=apoa1.error                                                    
#QCG application=NAMD                                                     
#QCG argument=apoa1/apoa1.namd                                            
#QCG stage-in-file=apoa1.zip                                              
#QCG preprocess=unzip apoa1.zip                                           
#QCG stage-out-dir=. -> results                                        
#QCG notify=xmpp:tomasz.piontek@plgrid.pl  
#QCG watch-output=mailto:tp@mail,20,ENERGY