/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 — 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> »</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 <design-2.1.rst></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"><</span><span class="n">cluster</span><span class="o">></span> <span class="p">[</span><span class="o"><</span><span class="n">cluster</span><span class="o">...></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> »</li>
</ul>
</div>
<div class="footer" role="contentinfo">
© 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>
|