Online Deployment

Scripts for deploying Aframe and AMPLFI models for online analysis

Getting Started

Note In the below setup, we will be using the CLI tools installed in the root Aframe environment

First build the online deployment apptainer image

poetry run build-containers online

Next, you can initialize an online run directory, which will add template config.yaml and run.sh files that will need to be populated with arguments specific to your analysis.

poetry run aframe-init online --directory /path/to/online

Once the files are populated correctly, the analysis can be launched via

bash run.sh

Uploading Events to GraceDB

Uploading events to gracedb requires the use of scitokens

If you do not have access to GraceDB but still want to launch an analysis, you can set

server = "local"

in the configuration, which will write events to disk instead of uploading to GraceDB

Crontab

A crontab file is also added to the directory, which will automatically refresh scitokens used for gracedb authentication, as well as relaunch run.sh if there are any failures. Make sure to adjust the token refresh commands with your own credentials, and then you can launch the analysis with

crontab crontab