From d46be38d4adfd821b44781a95b252977277ecf76 Mon Sep 17 00:00:00 2001 From: Maarten Litmaath <Maarten.Litmaath@cern.ch> Date: Sun, 31 Oct 2021 17:30:16 +0100 Subject: [PATCH] Updated the VObox startup scripts documentation. --- docs/site/vobox_startup_scripts.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/docs/site/vobox_startup_scripts.md b/docs/site/vobox_startup_scripts.md index 3e81161..a528138 100644 --- a/docs/site/vobox_startup_scripts.md +++ b/docs/site/vobox_startup_scripts.md @@ -1,12 +1,12 @@ # JAliEn Startup Scripts -JAliEn Startup Scripts are used to control CE and MonaLisa services in VOboxes. The scripts will reside in `/cvmfs/alice.cern.ch/scripts/vobox` +JAliEn startup scripts are used to control CE and MonaLisa services on VOboxes. The production versions reside in `/cvmfs/alice.cern.ch/scripts/vobox`. # Usage ``` Usage: jalien-vobox <Command> [<Service>] -<Command> is one of: start status stop restart mlstatus +<Command> is one of: start status stop restart mlstatus check <Service> is one of: ce monalisa (defaulting to both if not specified) ``` @@ -14,7 +14,7 @@ Usage: jalien-vobox <Command> [<Service>] Running a command without specifying a service will run the command on both CE and MonaLisa services. ## Configuration -Both the services are able to start without any configurations. However, the following parameters can be overridden by defining them in `$HOME/.alien/config/version.properties` as key-value pairs. +The following parameters can be overridden by defining them in `$HOME/.alien/config/version.properties` as key-value pairs, but their (unspecified) default values should usually be fine: ``` MONALISA_HOME=<MonaLisa package location> @@ -22,13 +22,13 @@ MONALISA=<MonaLisa version> JALIEN=<JAliEn version> ``` -> Note: as the MonaLisa package is not available in CVMFS yet, for now one can define MONALISA_HOME to specify the MonaLisa package location. If it is not locally available, please use `install` as the value for `<MonaLisa package location>`. +> Note: MONALISA_HOME would typically be used to specify a `local` installation. The value `install` can be used to have a default version downloaded and configured. -> Note: the JAliEn MonaLisa package is not yet ready for widespread use, as it lacks a few features that are important for operations. - -If it is required to run any shell command before starting either of the services, they can be added in `$HOME/.alien/config/CE.env` or `$HOME/.alien/config/ml.env`. The former should typically contain a command to define the `X509_USER_PROXY` that should be used by the JAliEn CE to submit its jobs, for example as follows: +If it is required to run any shell command before starting either of the services, they can be added in `$HOME/.alien/config/CE.env` or `$HOME/.alien/config/ml.env`. Both files should typically contain a command to define the `X509_USER_PROXY` if needed for job submission by the JAliEn CE and which should then be monitored by MonALISA, for example as follows: ``` export X509_USER_PROXY=`ls -t /var/lib/vobox/alice/proxy_repository/*lcgadmin | sed q` ``` +> Note: the JAliEn CE needs to have a valid `VObox token` to be able to submit jobs. + -- GitLab