input/releases/qpid-broker-j-7.1.9/book/Java-Broker-Backup-And-Recovery-Virtualhost-Node.html.in

<div class="docbook"><div class="navheader"><table summary="Navigation header" width="100%"><tr><th align="center" colspan="3">11.2.&#160;Virtualhost Node</th></tr><tr><td align="left" width="20%"><a accesskey="p" href="Java-Broker-Backup-And-Recovery.html">Prev</a>&#160;</td><th align="center" width="60%">Chapter&#160;11.&#160;Backup And Recovery</th><td align="right" width="20%">&#160;<a accesskey="n" href="Java-Broker-Backup-And-Recovery-Virtualhost.html">Next</a></td></tr></table><hr /></div><div class="section"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node"></a>11.2.&#160;Virtualhost Node</h2></div></div></div><p>To perform a complete backup of a Virtualhost node whilst it is stopped (or Broker down),
      simply copy all the files the exist beneath
        <code class="literal">${QPID_WORK}/&lt;nodename&gt;/config</code>, assuming the virtualhost node is in
      the standard location. This will copy all configuration that belongs to that virtualhost
      node.</p><p>The technique for backing up a virtualhost node whilst it is running depends on its
      type.</p><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-BDB"></a>11.2.1.&#160;BDB</h3></div></div></div><p>BDB module includes the "hot" backup utility <code class="literal">org.apache.qpid.server.store.berkeleydb.BDBBackup</code>.
        This utility can perform the backup when the broker is running.</p><p>You can run this class from command line like in an example below:</p><div class="example"><a id="d0e7183"></a><p class="title"><strong>Example&#160;11.1.&#160;Performing store backup by using <code class="classname">BDBBackup</code> class
          directly</strong></p><div class="example-contents"><div class="cmdsynopsis"><p><code class="command">java</code>   -cp <em class="replaceable"><code>"${QPID_HOME}/lib/*"</code></em>   org.apache.qpid.server.store.berkeleydb.BDBBackup \ <br />  -fromdir <em class="replaceable"><code>${QPID_WORK}/&lt;nodename&gt;/config</code></em>   -todir <em class="replaceable"><code>path/to/backup/folder</code></em> </p></div></div></div><br class="example-break" /><p>In the example above BDBBackup utility is called to backup the store at
          <code class="literal">${QPID_WORK}/&lt;nodename&gt;/config</code> and copy store logs into
          <code class="literal">path/to/backup/folder</code>.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-BDB-HA"></a>11.2.2.&#160;BDB-HA</h3></div></div></div><p>See <a class="xref" href="Java-Broker-Backup-And-Recovery-Virtualhost-Node.html#Java-Broker-Backup-And-Recovery-Virtualhost-Node-BDB" title="11.2.1.&#160;BDB">Section&#160;11.2.1, &#8220;BDB&#8221;</a></p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>BDB-HA VirtualHost node backups are node specific. You cannot use the backup of one node to recover a different node. To backup a group a backup of each node needs to be taken separately.</p></div></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-Derby"></a>11.2.3.&#160;Derby</h3></div></div></div><p>Not yet supported</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-JDBC"></a>11.2.4.&#160;JDBC</h3></div></div></div><p>The responsibility for backup is delegated to the database server itself. See the
        documentation accompanying it. Any technique that takes a consistent snapshot of the
        database is acceptable.</p></div><div class="section"><div class="titlepage"><div><div><h3 class="title"><a id="Java-Broker-Backup-And-Recovery-Virtualhost-Node-JSON"></a>11.2.5.&#160;JSON</h3></div></div></div><p>JSON stores its config in a single text file. It can be safely backed up using standard
        command line tools.</p></div></div><div class="navfooter"><hr /><table summary="Navigation footer" width="100%"><tr><td align="left" width="40%"><a accesskey="p" href="Java-Broker-Backup-And-Recovery.html">Prev</a>&#160;</td><td align="center" width="20%"><a accesskey="u" href="Java-Broker-Backup-And-Recovery.html">Up</a></td><td align="right" width="40%">&#160;<a accesskey="n" href="Java-Broker-Backup-And-Recovery-Virtualhost.html">Next</a></td></tr><tr><td align="left" valign="top" width="40%">Chapter&#160;11.&#160;Backup And Recovery&#160;</td><td align="center" width="20%"><a accesskey="h" href="Apache-Qpid-Broker-J-Book.html">Home</a></td><td align="right" valign="top" width="40%">&#160;11.3.&#160;Virtualhost</td></tr></table></div></div>