HCHECK(1) Ganeti | Version 2.6.2


hcheck - Cluster checker


hcheck {backend options...} [algorithm options...] [reporting options...]

hcheck --version

Backend options:

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

Algorithm options:

[ --no-simulation ] [ --max-cpu cpu-ratio ] [ --min-disk disk-ratio ] [ -l limit ] [ -e score ] [ -g delta ] [ --min-gain-limit threshold ] [ -O name... ] [ --no-disk-moves ] [ --no-instance-moves ] [ -U util-file ] [ --evac-mode ] [ --select-instances inst... ] [ --exclude-instances inst... ]

Reporting options:

[--machine-readable[=CHOICE] ] [ -p[ fields ] ] [ --print-instances ] [ -v... | -q ]


hcheck is the cluster checker. It prints information about cluster's health and checks whether a rebalance done using hbal would help.

This information can be presented in both human-readable and machine-readable way.

Note that it does not take any action, only performs a rebalance simulation if necessary.

For more information about the algorithm details check hbal(1).



Only perform checks based on current cluster state, without trying to simulate rebalancing.

For a detailed description about the options listed above have a look at htools(7), hspace(1) and hbal(1).


Report bugs to project website or contact the developers using the Ganeti mailing list.


Ganeti overview and specifications: ganeti(7) (general overview), ganeti-os-interface(7) (guest OS definitions).

Ganeti commands: gnt-cluster(8) (cluster-wide commands), gnt-job(8) (job-related commands), gnt-node(8) (node-related commands), gnt-instance(8) (instance commands), gnt-os(8) (guest OS commands), gnt-group(8) (node group commands), gnt-backup(8) (instance import/export commands), gnt-debug(8) (debug commands).

Ganeti daemons: ganeti-watcher(8) (automatic instance restarter), ganeti-cleaner(8) (job queue cleaner), ganeti-noded(8) (node daemon), ganeti-masterd(8) (master daemon), ganeti-rapi(8) (remote API daemon).

Ganeti htools: htools(1) (generic binary), hbal(1) (cluster balancer), hspace(1) (capacity calculation), hail(1) (IAllocator plugin), hscan(1) (data gatherer from remote clusters), hinfo(1) (cluster information printer).