Introduction

• LValert is The LIGO-Virgo Alert System (LVAlert)

  • a prototype notification service built on the xmpp (jabber) protocol and the pubsub extension.
  • It provides a basic notification tool which allows multiple producers and consumers of notifications.

Install

• We can't install lvalert by igwn on conda environment. (see lvalert_admin broken on both conda igwn-py2 and igwn-py37 environments)

  • because lvalert depends on legacy package (pyxmpp)

• To install lvalert on python2,

  sudo apt install python-ligo-lvalert

Setting in advance

• visit https://lvalert-test.cgca.uwm.edu and activate your account.

• prepare $HOME/.netrc

  • albert.einstein should be your KAGRA account.

  • PASSWORD should be the password you set at Account Activation site.

  $ echo 'machine lvalert.cgca.uwm.edu login albert.einstein password PASSWORD' >> ~/.netrc
  $ echo 'machine lvalert-playground.cgca.uwm.edu login albert.einstein password PASSWORD' >> ~/.netrc
  $ echo 'machine lvalert-test.cgca.uwm.edu login albert.einstein password PASSWORD' >> ~/.netrc
  $ chmod 0600 ~/.netrc

Usage of LVAlert command

• get a list of existing nodes

  $ lvalert_admin -s lvalert-playground.cgca.uwm.edu --get-nodes

• create a test node

  $ lvalert_admin -s lvalert-playground.cgca.uwm.edu --create --node test_k1det
  Creating node test_k1det
  Successfully completed operation

• subscribe a node

  $ lvalert_admin -s lvalert-playground.cgca.uwm.edu --subscribe --node test_k1det
  Successfully subscribed to node test_k1det

• remove a note

  $ lvalert_admin -s lvalert-playground.cgca.uwm.edu --delete --node test_k1det

• check current subscriptions

  $ lvalert_admin -s lvalert-playground.cgca.uwm.edu --subscriptions

Links

• Tagoshi-san's note

• git repository(lvalert)

• LVAlert Users Guide

• https://lscsoft.docs.ligo.org/lvalert/index.html