Synnefo » snf-ganeti

**hspace** {backend options...} [algorithm options...] [request options...]

[output options...] [-v... | -q]

Backend options:

{ **-m** *cluster* | **-L[** *path* **] [-X]** | **-t** *data-file* |

Algorithm options:

**[ -O *name...* ]**

Request options:

Output options:

**[-p**[*fields*]**]**

  RAM).

INI_MEM_OVERHEAD, FIN_MEM_OVERHEAD

  itself and unacounted memory (e.g. due to hypervisor overhead).

INI_MEM_EFF, HTS_INI_MEM_EFF

  example, the cluster might still have 100GiB disk free, but with no

  memory left for instances, we cannot allocate another instance, so

  in effect the disk space is unallocable. Note that the CPUs here

  hasn't been specified this will be -1.

ALLOC_USAGE

The options that can be passed to the program are as follows:

  Overrides the disk template for the instance read from the cluster;

  one of the Ganeti disk templates (e.g. plain, drbd, so on) should be

  passed in.

  The maximum virtual to physical cpu ratio, as a floating point number

  greater than or equal to one. For example, specifying *cpu-ratio* as

  **2.5** means that, for a 4-cpu machine, a maximum of 10 virtual cpus

  make sense, as that means other resources (e.g. disk) won't be fully

  utilised due to CPU restrictions.

  The minimum amount of free disk space remaining, as a floating point

  number. For example, specifying *disk-ratio* as **0.25** means that

  at least one quarter of disk space should be left free on nodes.

  Restrict the number of instance allocations to this length. This is

  not very useful in practice, but can be used for testing hspace

  itself, or to limit the runtime for very big clusters.

  Prints the before and after node status, in a format designed to allow

  the user to understand the node's most important parameters. See the

  man page **htools**(1) for more details about this option.

  are reported by RAPI as such, or that have "?" in file-based input

  in any numeric fields.

  If given, the state of the cluster at the end of the allocation is

  saved to a file named *filename.alloc*, and if tiered allocation is

  enabled, the state after tiered allocation will be saved to

  either hspace itself (with different parameters) or for example

  hbal, via the ``-t`` option.

  Backend specification: the name of the file holding node and instance

  information (if not collecting via RAPI or LUXI). This or one of the

  other backends must be selected. The option is described in the man

  which is to be contacted via LUXI (an internal Ganeti protocol). The

  option is described in the man page **htools**(1).

  Backend specification: similar to the **-t** option, this allows

  overriding the cluster data with a simulated cluster. For details

  about the description, see the man page **htools**(1).

  This option overrides the instance size read from the cluster for the

  *standard* allocation mode, where we simply allocate instances of the

  same, fixed size until the cluster runs out of space.

  holds:

  - the disk size of the instance (units can be used)

  An example description would be *100G,4g,2* describing an instance

  specification of 100GB of disk space, 4GiB of memory and 2 VCPUs.

  This option overrides the instance size for the *tiered* allocation

  mode. In this mode, the algorithm starts from the given specification

  and allocates until there is no more space; then it decreases the

  the instance count for these two modes are not related one to

  another.

  By default, the output of the program is in "human-readable" format,

  i.e. text descriptions. By passing this flag you can either enable

  (``--machine-readable`` or ``--machine-readable=yes``) or explicitly

  disable (``--machine-readable=no``) the machine readable format

  described above.

  Increase the output verbosity. Each usage of this option will

  increase the verbosity (currently more than 2 doesn't make sense)

  from the default of one.

  Decrease the output verbosity. Each usage of this option will

  decrease the verbosity (less than zero doesn't make sense) from the

  default of one.

  Just show the program version and exit.

UNITS