This file is indexed.

/usr/share/doc/ganeti/html/cluster-merge.html is in ganeti-doc 2.16.0~rc2-1build1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <title>Merging clusters &#8212; Ganeti 2.16.0~rc2 documentation</title>
    <link rel="stylesheet" href="_static/style.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '2.16.0~rc2',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true,
        SOURCELINK_SUFFIX: '.txt'
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="search" title="Search" href="search.html" />
    <link rel="next" title="Cluster Keys Replacement" href="cluster-keys-replacement.html" />
    <link rel="prev" title="Ganeti administrator’s guide" href="admin.html" /> 
  </head>
  <body>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="cluster-keys-replacement.html" title="Cluster Keys Replacement"
             accesskey="N">next</a></li>
        <li class="right" >
          <a href="admin.html" title="Ganeti administrator’s guide"
             accesskey="P">previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">Ganeti 2.16.0~rc2 documentation</a> &#187;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="merging-clusters">
<h1>Merging clusters<a class="headerlink" href="#merging-clusters" title="Permalink to this headline"></a></h1>
<p>With <code class="docutils literal"><span class="pre">cluster-merge</span></code> from the <code class="docutils literal"><span class="pre">tools</span></code> directory it is possible to
merge two or more clusters into one single cluster.</p>
<p>If anything goes wrong at any point the script suggests you rollback
steps you’ve to perform <em>manually</em> if there are any. The point of no
return is when the master daemon is started the first time after merging
the configuration files. A rollback at this point would involve a lot of
manual work.</p>
<p>For the internal design of this tool have a look at the <cite>Automated
Ganeti Cluster Merger &lt;design-2.1.rst&gt;</cite> document.</p>
<div class="section" id="merge-clusters">
<h2>Merge Clusters<a class="headerlink" href="#merge-clusters" title="Permalink to this headline"></a></h2>
<p>The tool has to be invoked on the cluster you like to merge the other
clusters into.</p>
<p>The usage of <code class="docutils literal"><span class="pre">cluster-merge</span></code> is as follows:</p>
<div class="highlight-default"><div class="highlight"><pre><span></span><span class="n">cluster</span><span class="o">-</span><span class="n">merge</span> <span class="p">[</span><span class="o">--</span><span class="n">debug</span><span class="o">|--</span><span class="n">verbose</span><span class="p">]</span> <span class="p">[</span><span class="o">--</span><span class="n">watcher</span><span class="o">-</span><span class="n">pause</span><span class="o">-</span><span class="n">period</span> <span class="n">SECONDS</span><span class="p">]</span> \
<span class="p">[</span><span class="o">--</span><span class="n">groups</span> <span class="p">[</span><span class="n">merge</span><span class="o">|</span><span class="n">rename</span><span class="p">]]</span> <span class="o">&lt;</span><span class="n">cluster</span><span class="o">&gt;</span> <span class="p">[</span><span class="o">&lt;</span><span class="n">cluster</span><span class="o">...&gt;</span><span class="p">]</span>
</pre></div>
</div>
<p>You can provide multiple clusters. The tool will then go over every
cluster in serial and perform the steps to merge it into the invoking
cluster.</p>
<p>These options can be used to control the behaviour of the tool:</p>
<dl class="docutils">
<dt><code class="docutils literal"><span class="pre">--debug</span></code>/<code class="docutils literal"><span class="pre">--verbose</span></code></dt>
<dd>These options are mutually exclusive and increase the level of output
to either debug output or just more verbose output like action
performed right now.</dd>
<dt><code class="docutils literal"><span class="pre">--watcher-pause-period</span></code></dt>
<dd>Define the period of time in seconds the watcher shall be disabled,
default is 1800 seconds (30 minutes).</dd>
<dt><code class="docutils literal"><span class="pre">--groups</span></code></dt>
<dd>This option controls how <code class="docutils literal"><span class="pre">cluster-merge</span></code> handles duplicate node
group names on the merging clusters. If <code class="docutils literal"><span class="pre">merge</span></code> is specified then
all node groups with the same name will be merged into one. If
<code class="docutils literal"><span class="pre">rename</span></code> is specified, then conflicting node groups on the remove
clusters will have their cluster name appended to the group name. If
this option is not speicifed, then <code class="docutils literal"><span class="pre">cluster-merge</span></code> will refuse to
continue if it finds conflicting group names, otherwise it will
proceed as normal.</dd>
</dl>
</div>
<div class="section" id="rollback">
<h2>Rollback<a class="headerlink" href="#rollback" title="Permalink to this headline"></a></h2>
<p>If for any reason something in the merge doesn’t work the way it should
<code class="docutils literal"><span class="pre">cluster-merge</span></code> will abort, provide an error message and optionally
rollback steps. Please be aware that after a certain point there’s no
easy way to rollback the cluster to its previous state. If you’ve
reached that point the tool will not provide any rollback steps.</p>
<p>If you end up with rollback steps, please perform them before invoking
the tool again. It doesn’t keep state over invokations.</p>
</div>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
  <h3><a href="index.html">Table Of Contents</a></h3>
  <ul>
<li><a class="reference internal" href="#">Merging clusters</a><ul>
<li><a class="reference internal" href="#merge-clusters">Merge Clusters</a></li>
<li><a class="reference internal" href="#rollback">Rollback</a></li>
</ul>
</li>
</ul>

  <h4>Previous topic</h4>
  <p class="topless"><a href="admin.html"
                        title="previous chapter">Ganeti administrator’s guide</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="cluster-keys-replacement.html"
                        title="next chapter">Cluster Keys Replacement</a></p>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="_sources/cluster-merge.rst.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </div>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <div><input type="text" name="q" /></div>
      <div><input type="submit" value="Go" /></div>
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="cluster-keys-replacement.html" title="Cluster Keys Replacement"
             >next</a></li>
        <li class="right" >
          <a href="admin.html" title="Ganeti administrator’s guide"
             >previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">Ganeti 2.16.0~rc2 documentation</a> &#187;</li> 
      </ul>
    </div>
    <div class="footer" role="contentinfo">
        &#169; Copyright 2018, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Google Inc..
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.6.7.
    </div>
  </body>
</html>