...

Aviso can be used as a Python API or as Command-Line Interface (CLI) application.  Here Here a few steps to quickly get a working configuration listening to notifications.

...

1. Install AVISO following instructions on: https://pyaviso.readthedocs.io/en/latest/guide/getting_started.html#installing 
   
   
2. Configure MARS credentials following instructions on Access MARS
   
   

3. Create a configuration file in the default location ~/.aviso/config.yaml

   Code Block
   language yml
   username_file: ~/.marsrc/mars.email key_file: ~/.marsrc/mars.token notification_engine: type: etcd_rest host: aviso.ecmwf.int port: 443 https: true configuration_engine: type: etcd_rest host: aviso.ecmwf.int port: 443 https: true schema_parser: ecmwf remote_schema: True auth_type: ecmwf

   
   

4. Create ~/.marsrc/mars.email and ~/.marsrc/mars.token files. mars.email file should contain “email” listed here: https://api.ecmwf.int/v1/key and mars.token file should contain “key” shown on the same page.
   
   
5. Crate a listener configuration file with following content:
   1. Example for dissemination:
      

      Code Block
      language yml title listener_diss.yaml
      listeners: - event: dissemination request: destination: <user_destination> class: od expver: 1 domain: g stream: enfo step: [1,2,3] triggers: - type: echo

      Note the dissemination event listener. request describes for which dissemination event users want to execute the triggers. It is made of a set of fields. Users have to specify only the fields they wants to use as filters. destination is a mandatory field and it is associated to one or more destinations which are linked to the user's ECMWF account. Only the notifications complying with all the fields defined will execute the trigger. The trigger in this example is echo. This will simply print out the notification to the console output.
      
      
   2. Example for MARS:
      

      Code Block
      language yml title listener_mars.yaml
      listeners: - event: mars request: class: od expver: 1 domain: g stream: enfo step: [1,2,3] triggers: - type: echo

      Note, in the MARS event listener, destination field is not present.
      
      
6. If AVISO is installed in conda or Python virtual environment, activate the environment first:
   1. Python virtual environment: "myenv"
      

      Code Block
      language bash
      source {PATH_TO_MY_ENV}/myenv/bin/activate

   2. Conda:
      

      Code Block
      language bash
      conda activate

      
      
      
7. Launch the AVISO application to listen ECMWF defined in your configuration file:
   

   Code Block
   language bash
   aviso listen listener_diss.yaml #or aviso listen listener_mars.yaml

Once in execution this command will create a process waiting for notifications. Users can terminate the application by typing CTRL+C .
Note, the configuration file is only read at start time, therefore every time users make changes to it they need to restart the listening process.

Upgrading

...

AVISO installation

To upgrade Aviso to a newer version once it is available run the following command:

...