Statistics
| Branch: | Tag: | Revision:

root / man / hsqueeze.rst @ 958c943b

History | View | Annotate | Download (2.8 kB)

1
HSQUEEZE(1) Ganeti | Version @GANETI_VERSION@
2
=============================================
3

    
4
NAME
5
----
6

    
7
hsqueeze \- Dynamic power management
8

    
9
SYNOPSIS
10
--------
11

    
12
**hsqueeze** {backend options...} [algorithm options...] [reporting options...]
13

    
14
**hsqueeze** \--version
15

    
16
Backend options:
17

    
18
{ **-L[** *path* **]** | **-t** *data-file* }
19

    
20
Algorithm options:
21

    
22
**[ \--minimal-resources=*factor* ]**
23
**[ \--target-resources=*factor* ]**
24

    
25
Reporting options:
26

    
27
**[ -S *file* ]**
28

    
29

    
30
DESCRIPTION
31
-----------
32

    
33
hsqueeze does dynamic power management, by powering up or shutting down nodes,
34
depending on the current load of the cluster. Currently, only suggesting nodes
35
is implemented.
36

    
37
ALGORITHM
38
~~~~~~~~~
39

    
40
hsqueeze considers all online non-master nodes with only externally mirrored
41
instances as candidates for being taken offline. These nodes are iteratively,
42
starting from the node with the least number of instances, added to the set
43
of nodes to be put offline, if possible. A set of nodes is considered as suitable
44
for being taken offline, if, after marking these nodes as offline, balancing the
45
cluster by the algorithm used by **hbal**\(1) yields a situation where all instances
46
are located on online nodes, and each node has at least the target resources free
47
for new instances.
48

    
49
All offline nodes with a tag starting with ``htools:standby`` are
50
considered candidates for being taken online. Those nodes are taken online
51
till balancing the cluster by the algorithm used by **hbal**\(1) yields a
52
situation where each node has at least the minimal resources free for new
53
instances.
54

    
55
OPTIONS
56
-------
57

    
58
-L [*path*]
59
  Backend specification: collect data directly from the master daemon,
60
  which is to be contacted via LUXI (an internal Ganeti protocol). The
61
  option is described in the man page **htools**\(1).
62

    
63
-S *filename*, \--save-cluster=*filename*
64
  If given, the state of the cluster before the squeezing is saved to
65
  the given file plus the extension "original"
66
  (i.e. *filename*.original), and the state at the end of the
67
  squeezing operation is saved to the given file plus the extension "squeezed"
68
  (i.e. *filename*.squeezed).
69

    
70
-t *datafile*, \--text-data=*datafile*
71
  Backend specification: the name of the file holding node and instance
72
  information (if not collecting LUXI). This or one of the
73
  other backends must be selected. The option is described in the man
74
  page **htools**\(1).
75

    
76
\--minimal-resources=*factor*
77
  Specify the amount of resources to be free on each node for hsqueeze not to
78
  consider onlining additional nodes. The value is reported a multiple of the
79
  standard instance specification, as taken from the instance policy.
80

    
81
\--target-resources=*factor*
82
  Specify the amount of resources to remain free on any node after squeezing.
83
  The value is reported a multiple of the standard instance specification, as
84
  taken from the instance policy.