This is an old revision of the document!


oarsub notification option

The oarsub command provides an option to send notifications of job events.

Quoting oarsub manual page, the –notify option works as follows:

       --notify <TXT>
           Specify a notification method (mail or command to execute).  Ex:
            --notify "mail:name@domain.com"
            --notify "exec:/path/to/script args"

           args are job_id,job_name,TAG,comment

           TAG can be:
             - RUNNING : when the job is launched
             - END : when the job is finished normally
             - ERROR : when the job is finished abnormally
             - INFO : used when oardel is called on the job
             - SUSPENDED : when the job is suspended
             - RESUMING : when the job is resumed

           By default all TAGs are triggered. It is possible to specify which TAGs must be triggered.  Ex:
            --notify "[END,ERROR]mail:name@domain.com"
            --notify "[RUNNING]mail:name@domain.com"
            --notify "[RUNNING,END,ERROR]exec:/path/to/script args"

Using the exec command, we can setup notification using other means than emails, e.g. xmpp (jabber), twitter, …

XMPP notification

We can use the sendxmpp command line XMPP client, to get notification as jabber instant messages.

To do so, we add the following script in our PATH:

#!/bin/bash
 
MY_ADDRESS="my.name@jabber.fr"
# or for gmail:
# MY_ADDRESS="firstname.lastname@gmail.com"
 
job_id=$1
job_name=$2
TAG=$3
comment=$4
 
sendxmpp $MY_ADDRESS <<EOF
Job $job_id ($job_name) $TAG on My Cluster: $comment
EOF

sendxmpp will have to authenticate itself to a jabber server, with credentials set in our ~/.sendxmpprc (see the manual page of sendxmpprc). We need to have a dedicated jabber user (different from the one we use to get the notification) to send the message, but that's not very expensive.

Assuming that the script is stored in /home/myself/bin/jabber.sh, we can use it with:

$ oarsub --notify "exec:/home/myself/bin/jabber.sh" ...
wiki/job_event_notifications.1458772331.txt.gz · Last modified: 2016/03/23 23:32 by neyron
Recent changes RSS feed GNU Free Documentation License 1.3 Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki