Synnefo » snf-ganeti » ganeti-local

  The execution of the job series can be interrupted, see below for

  signal handling.

SIGNAL HANDLING

---------------

When executing jobs via LUXI (using the ``-X`` option), normally hbal

will execute all jobs until either one errors out or all the jobs finish

successfully.

Since balancing can take a long time, it is possible to stop hbal early

in two ways:

- by sending a ``SIGINT`` (``^C``), hbal will register the termination

  request, and will wait until the currently submitted jobs finish, at

  which point it will exit (with exit code 1)

- by sending a ``SIGTERM``, hbal will immediately exit (with exit code

  2); it is the responsibility of the user to follow up with Ganeti the

  result of the currently-executing jobs

Note that in any situation, it's perfectly safe to kill hbal, either via

the above signals or via any other signal (e.g. ``SIGQUIT``,

``SIGKILL``), since the jobs themselves are processed by Ganeti whereas

hbal (after submission) only watches their progression. In this case,

the use will again have to query Ganeti for job results.

The exit status of the command will be zero, unless for some reason the

algorithm fatally failed (e.g. wrong node or instance data), or (in case

of job execution) either one of the jobs has failed or the balancing was

interrupted early.

The program does not check all its input data for consistency, and

sometime aborts with cryptic errors messages with invalid data.