Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Wstęp

Aby postęp wykonania zadania był monitorowany przez usługi QCG należy zadanie uruchomić z odpowiednimi parametrami.

...

Niniejszy dokument przedstawia procedurę uruchomienia zadania z opcją monitoringu z wykorzystaniem podstawowych narzędzi dostępowych QCG: QCG-SimpleClient i QCG-Icon.

 

QCG-SimpleClient

Definicja zadania

Zadanie, którego postęp wykonania ma być monitorowany musi zawierać dyrektywę "#QCG watch-output".

Dyrektywa ta odpowiedzialna jest za poinformowanie systemu o konieczności uruchomienia dodatkowego procesu monitorującego aplikację.

Jednym z argumentów dyrektywy "watch-output" jest skrypt monitorujący.

Skrypt monitorujący

Skrypt monitorujący postęp aplikacji uruchamiany jest automatycznie, cyklicznie przez środowisko QCG.Rolą tego skrypty jest wyszukanie zadanej informacji i przekazanie jej w odpowiednim formacie na standardowe wyjście. Format danych wypisywanych przez skrypt monitorujący jest uzależniony od używanego schematu. Informacjaze standardowego wyjścia jest przechwytywana i wysyłana do usługi QCG-Monitor.

Skrypt monitorujący musi być przesłany wraz z zadaniem za pomocą dyrektywy "#QCG stage-in-file".

Format wyjścia skryptu monitorującego

Wyjście skryptu monitorującego w pierwszej linii musi zawierać definicję formatu pozostałych danych w postaci

Code Block
qcg.monitor.scheme=format

gdzie format jest jednym z predefiniowanych formatów rozumianych przez usługę QCG-Monitor.

 

Dyrektywa #QCG monitor

W przypadku korzystanie z tekstowego narzędzia QCG-SimpleClient i opisu zadania w formacie QCG-Simple do poinformowania systemu, ze zdanie ma być monitorowane przez usługi QCG służy dyrektywa #QCG monitor.

Przykładowe zadanie

Przykładowe opis zadania dla aplikacji gaussian z monitoringiem postępu wykonania:

Code Block
#!/bin/bash

#QCG host=novabem
#QCG queue=plgrid
#QCG note=Naphthalene gaussian

#QCG output=${JOB_ID}.output
#QCG error=${JOB_ID}.error

#QCG stage-in-file=Naphthalene.gjf
#QCG stage-in-file=gaussian.ntf
#QCG stage-out-dir=.->result.${JOB_ID}

#QCG nodes=1:212
#QCG walltime=PT10MPT30M

#QCG notify=xmpp:piotr.kopta@plgrid.pl
#QCG watch-output=20,gaussian.ntfmonitor

#QCG application=g09
#QCG argument=Naphthalene.gjf

 

QCG-Icon

Program QCG-Icon

...

(od wersji 1.5.0) umożliwia Monitorowanie zadań za pomocą e-Mail, XMPP oraz portalu QCG-Monitoring.

Aby skorzystać z monitorowania poprzez portal, w oknie zlecania zadania programu QCG-Icon, w zakładce Monitoring, należy ustawić typ monitoringu na element Portal:

Image Added

Parametr Częstotliwość monitoringu określa oczekiwaną częstotliwość wykonywania zdarzeń monitorujących. Przykładowo, ustawienie przez użytkownika wartości pola na 60 oznacza chęć aktualizowania informacji w Portalu w odstępach 60-cio sekundowych. Należy mieć na uwadze, iż rzeczywista częstotliwość wysyłania jest zależna od kilku czynników i może być inna niż oczekiwana przez użytkownika.
Parametr Schemat monitorowania definiuje w jaki sposób informacje o postępie wykonywania aplikacji będą prezentowane w portalu monitoringu. Jeżeli pole pozostanie puste, użyty zostanie domyślny schemat monitoringu dla wybranej aplikacji.

Dodatkowe informacje o monitoringu z poziomu programu QCG-Icon można znaleźć tutaj.