Provided by: ganeti-htools_2.9.3-1_amd64 bug

NAME

       harep - Ganeti auto-repair tool

SYNOPSIS

       harep [ [-L | --luxi ] = socket ] [ --job-delay = seconds ]

       harep --version

DESCRIPTION

       Harep is the Ganeti auto-repair tool.  It is able to detect that an instance is broken and
       to generate a sequence of jobs that will fix it, in accordance to the policies set by  the
       administrator.

       Harep is able to recognize what state an instance is in (healthy, suspended, needs repair,
       repair disallowed, pending repair, repair  disallowed,  repair  failed)  and  to  lead  it
       through  a  sequence  of  steps  that  will  bring the instance back to the healthy state.
       Therefore, harep is mainly meant to be run regularly and frequently using a cron  job,  so
       that  is can actually follow the instance along all the process.  At every run, harep will
       update the tags it adds to instances that describe its repair status, and will submit jobs
       that actually perform the required repair operations.

       By  default, harep only reports on the health status of instances, but doesn't perform any
       action, as they  might  be  potentially  dangerous.   Therefore,  harep  will  only  touch
       instances that it has been explicitly authorized to work on.

       The  tags  enabling  harep, can be associated to single instances, or to a nodegroup or to
       the whole cluster, therefore affecting all the instances they contain.  The possible  tags
       share the common structure:

              ganeti:watcher:autorepair:<type>

       where <type> can have the following values:

       · fix-storage:  allow  disk  replacement or fix the backend without affecting the instance
         itself (broken DRBD secondary)

       · migrate: allow instance migration

       · failover: allow instance reboot on the secondary

       · reinstall: allow disks to be recreated and the instance to be reinstalled

       Each element in the list of tags, includes all the authorizations  of  the  previous  one,
       with fix-storage being the least powerful and reinstall being the most powerful.

       In  case  multiple  autorepair  tags  act  on  the same instance, only one can actually be
       active.  The conflict is solved according to the following rules:

       1. if multiple tags are in the same object, the least destructive takes precedence.

       2. if the tags are across objects, the nearest tag wins.

       Example: A cluster has instances I1 and I2, where I1 has the failover tag, and the cluster
       has  both  fix-storage and reinstall.  The I1 instance will be allowed to failover, the I2
       instance only to fix-storage.

OPTIONS

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

       -L socket, --luxi=socket
              collect data via Luxi, optionally using the given socket path.

       --job-delay=seconds
              insert this much delay before the execution of repair jobs to  allow  the  tool  to
              continue processing instances.

REPORTING BUGS

       Report   bugs   to  project  website  (http://code.google.com/p/ganeti/)  or  contact  the
       developers using the Ganeti mailing list (ganeti@googlegroups.com).

SEE ALSO

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

       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-storage(8) (storage 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), mon-collector(7) (data collectors interface).

COPYRIGHT

       Copyright (C) 2006, 2007, 2008, 2009, 2010, 2011, 2012 Google Inc.  Permission is  granted
       to  copy,  distribute  and/or  modify under the terms of the GNU General Public License as
       published by the Free Software Foundation; either version 2 of the License,  or  (at  your
       option) any later version.

       On  Debian  systems,  the  complete text of the GNU General Public License can be found in
       /usr/share/common-licenses/GPL.