forked from docs/doc-exports
Yang, Tong
2195db241c
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com> Reviewed-by: Rechenburg, Matthias <matthias.rechenburg@t-systems.com> Co-authored-by: Yang, Tong <yangtong2@huawei.com> Co-committed-by: Yang, Tong <yangtong2@huawei.com>
68 lines
19 KiB
HTML
68 lines
19 KiB
HTML
<a name="admin_guide_000350"></a><a name="admin_guide_000350"></a>
|
|
|
|
<h1 class="topictitle1">Backing Up IoTDB Metadata</h1>
|
|
<div id="body0000001585191369"><div class="section" id="admin_guide_000350__sbf7de999ef6f4ec7ada122bb4f6bbc39"><h4 class="sectiontitle">Scenario</h4><p id="admin_guide_000350__en-us_topic_0046736764_p50247175">To ensure IoTDB metadata security and prevent the IoTDB service from being unavailable due to IoTDB metadata file damages, you need to back up IoTDB metadata. The backup data can be used to recover the system if an exception occurs or the operation has not achieved the expected result, minimizing the adverse impacts on services.</p>
|
|
<p id="admin_guide_000350__p133291155122820">You can create a backup task on <span id="admin_guide_000350__text67509419010">MRS</span> Manager to back up IoTDB metadata. Both automatic and manual backup tasks are supported.</p>
|
|
</div>
|
|
<div class="section" id="admin_guide_000350__s1b2b090a07e447b58ba4e60370d64404"><h4 class="sectiontitle">Prerequisites</h4><ul id="admin_guide_000350__ul781611295189"><li id="admin_guide_000350__le9ac0667a43d455fa6c4b811935ad455">The backup type, period, policy, and other specifications have been planned based on the service requirements and you have checked whether <em id="admin_guide_000350__i235814063610">Data storage path</em><strong id="admin_guide_000350__b133599073614">/LocalBackup/</strong> has sufficient space on the active and standby management nodes.</li></ul>
|
|
<ul id="admin_guide_000350__ube9a3e31e3214e57ade6488b9708e3c5"><li id="admin_guide_000350__li9837811115617">If you want to back up data to NAS, you have deployed the NAS server in advance.</li></ul>
|
|
<ul id="admin_guide_000350__ul193411218101717"><li id="admin_guide_000350__lb80a243195ff415bb79d73f765e4982c">Time is consistent between the active and standby clusters and the NTP services on the active and standby clusters use the same time source.</li></ul>
|
|
<ul id="admin_guide_000350__en-us_topic_0046736768_ul24781121"><li id="admin_guide_000350__en-us_topic_0046736768_li63284394">Backup policies, including the backup task type, period, backup object, backup directory, and Yarn queue required by the backup task are planned based on service requirements.</li><li id="admin_guide_000350__en-us_topic_0046736768_li32688641">The HDFS in the standby cluster has sufficient space. You are advised to save backup files in a custom directory.</li></ul>
|
|
</div>
|
|
<div class="section" id="admin_guide_000350__section10441133319018"><h4 class="sectiontitle">Procedure</h4><ol id="admin_guide_000350__ol885566615256"><li id="admin_guide_000350__li514247915256"><span>On <span id="admin_guide_000350__text663205161520">MRS</span> Manager, choose <strong id="admin_guide_000350__b179913132363">O&M</strong> > <strong id="admin_guide_000350__b198001113123610">Backup and Restoration</strong> > <strong id="admin_guide_000350__b108018131361">Backup Management</strong>.</span></li><li id="admin_guide_000350__li1388766715256"><span>Click <strong id="admin_guide_000350__b198994220442620">Create</strong>.</span></li><li id="admin_guide_000350__li18138124631813"><span>Set <strong id="admin_guide_000350__b1213231713610">Name</strong> to the name of the backup task.</span></li><li id="admin_guide_000350__li2832102653918"><span>Select the cluster to be operated from <strong id="admin_guide_000350__b177911518163618">Backup Object</strong>.</span></li><li id="admin_guide_000350__li1759563715256"><span>Set <strong id="admin_guide_000350__b10632142063617">Mode</strong> to the type of the backup task.</span><p><p id="admin_guide_000350__en-us_topic_0165590410_p226614614816"><strong id="admin_guide_000350__b5417112210361">Periodic</strong> indicates that the backup task is executed by the system periodically. <strong id="admin_guide_000350__b1741862212366">Manual</strong> indicates that the backup task is executed manually.</p>
|
|
|
|
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="admin_guide_000350__en-us_topic_0165590410_table193081738154917" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Periodic backup parameters</caption><thead align="left"><tr id="admin_guide_000350__en-us_topic_0165590410_row430813818490"><th align="left" class="cellrowborder" valign="top" width="21.84%" id="mcps1.3.3.2.5.2.2.2.3.1.1"><p id="admin_guide_000350__en-us_topic_0165590410_p113081938184918">Parameter</p>
|
|
</th>
|
|
<th align="left" class="cellrowborder" valign="top" width="78.16%" id="mcps1.3.3.2.5.2.2.2.3.1.2"><p id="admin_guide_000350__en-us_topic_0165590410_p173081538114915">Description</p>
|
|
</th>
|
|
</tr>
|
|
</thead>
|
|
<tbody><tr id="admin_guide_000350__en-us_topic_0165590410_row18308838144917"><td class="cellrowborder" valign="top" width="21.84%" headers="mcps1.3.3.2.5.2.2.2.3.1.1 "><p id="admin_guide_000350__en-us_topic_0165590410_p030893804920">Started</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="78.16%" headers="mcps1.3.3.2.5.2.2.2.3.1.2 "><p id="admin_guide_000350__en-us_topic_0165590410_p103081838144917">Indicates the time when the task is started for the first time.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000350__en-us_topic_0165590410_row1530813813494"><td class="cellrowborder" valign="top" width="21.84%" headers="mcps1.3.3.2.5.2.2.2.3.1.1 "><p id="admin_guide_000350__en-us_topic_0165590410_p1930833815494">Period</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="78.16%" headers="mcps1.3.3.2.5.2.2.2.3.1.2 "><p id="admin_guide_000350__en-us_topic_0165590410_p7308183834918">The task execution interval. Value options include <strong id="admin_guide_000350__b9792150175014">Hours</strong> and <strong id="admin_guide_000350__b117957015010">Days</strong>.</p>
|
|
</td>
|
|
</tr>
|
|
<tr id="admin_guide_000350__en-us_topic_0165590410_row7308103810493"><td class="cellrowborder" valign="top" width="21.84%" headers="mcps1.3.3.2.5.2.2.2.3.1.1 "><p id="admin_guide_000350__en-us_topic_0165590410_p16308153834910">Backup Policy</p>
|
|
</td>
|
|
<td class="cellrowborder" valign="top" width="78.16%" headers="mcps1.3.3.2.5.2.2.2.3.1.2 "><p id="admin_guide_000350__p116297352516">Indicates a periodic backup policy.</p>
|
|
<ul id="admin_guide_000350__en-us_topic_0165590410_ul17277134745017"><li id="admin_guide_000350__en-us_topic_0165590410_li7277247105018"><strong id="admin_guide_000350__b6129449162717">Full backup at the first time and incremental backup subsequently</strong></li><li id="admin_guide_000350__en-us_topic_0165590410_li0512161105112"><strong id="admin_guide_000350__b36631252142710">Full backup every time</strong></li><li id="admin_guide_000350__en-us_topic_0165590410_li10673122011516"><strong id="admin_guide_000350__b146416568273">Full backup once every n times</strong></li></ul>
|
|
<div class="note" id="admin_guide_000350__en-us_topic_0165590410_note181551254522"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="admin_guide_000350__p159171420442">Incremental backup is not supported when component metadata is backed up. Only <strong id="admin_guide_000350__b92831524120">Full backup every time</strong> is supported.</p>
|
|
</div></div>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
</div>
|
|
</p></li><li id="admin_guide_000350__li2414301115256"><span>In <strong id="admin_guide_000350__b57920660893034">Configuration</strong>, select <strong id="admin_guide_000350__b116863454293034">IoTDB</strong> under <strong id="admin_guide_000350__b70879873293034">Metadata and other data</strong>.</span><p><div class="note" id="admin_guide_000350__note19296173343310"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="admin_guide_000350__p1129723317334">If there are multiple IoTDB services, all IoTDB services are backed up by default. You can click <strong id="admin_guide_000350__b156117181719">Assign Service</strong> to specify the services to be backed up.</p>
|
|
</div></div>
|
|
</p></li><li id="admin_guide_000350__li4457996415256"><span>Set <strong id="admin_guide_000350__b11305017151710">Path Type</strong> of <strong id="admin_guide_000350__b123111817131711">IoTDB</strong> to a backup directory type.</span><p><div class="litext" id="admin_guide_000350__p1596050715256">The following backup directory types are supported:<ul class="subitemlist" id="admin_guide_000350__u695c04bfc9fd4e808744a464ebe243f6"><li class="subitemlist" id="admin_guide_000350__li118191832175017"><strong id="admin_guide_000350__b1118047144216">LocalDir</strong>: indicates that the backup files are stored on the local disk of the active management node and the standby management node automatically synchronizes the backup files. By default, the backup files are stored in <em id="admin_guide_000350__i1775901110425">Data storage path</em><strong id="admin_guide_000350__b276121119423">/LocalBackup/</strong>.<p class="subitemlist" id="admin_guide_000350__p1913323335020">If you select this option, you need to set the maximum number of replicas to specify the number of backup file sets that can be retained in the backup directory.</p>
|
|
</li><li class="subitemlist" id="admin_guide_000350__li38277407507"><strong id="admin_guide_000350__b114251026124216">NFS</strong>: indicates that backup files are stored in the NAS using the NFS protocol.<div class="subitemlist" id="admin_guide_000350__p943134125019">If you select this option, set the following parameters:<ul id="admin_guide_000350__ul127408275"><li id="admin_guide_000350__li5786748202918"><strong id="admin_guide_000350__b8861143113422">IP Mode</strong>: indicates the mode of the target IP address. The system automatically selects the IP address mode based on the cluster network type, for example, <strong id="admin_guide_000350__b1135443415428">IPv4</strong> or <strong id="admin_guide_000350__b1535612346429">IPv6</strong>.</li></ul>
|
|
<ul id="admin_guide_000350__ul131981043121213"><li id="admin_guide_000350__li84531639101211"><strong id="admin_guide_000350__b205381236124216">Server IP Address</strong>: indicates the IP address of the NAS server.</li><li id="admin_guide_000350__li168383310145"><strong id="admin_guide_000350__b1164910381425">Server Shared Path</strong>: indicates the configured shared directory of the NAS server. (The shared path of the server cannot be set to the root directory, and the user group and owner group of the shared path must be <strong id="admin_guide_000350__b9424176505">nobody:nobody</strong>.)</li><li id="admin_guide_000350__li198801542069"><strong id="admin_guide_000350__b1269320402427">Maximum Number of Backup Copies</strong>: indicates the number of backup file sets that can be retained in the backup directory.</li></ul>
|
|
</div>
|
|
</li><li class="subitemlist" id="admin_guide_000350__lff9acdbe32b44f9ab63e29d337acb6b8"><strong id="admin_guide_000350__b430044311429">RemoteHDFS</strong>: indicates that the backup files are stored in the HDFS directory of the standby cluster.<div class="subitemlist" id="admin_guide_000350__en-us_topic_0165590410_p4401348125813">If you select this option, set the following parameters:<ul id="admin_guide_000350__ul165141635941"><li id="admin_guide_000350__li10541031232"><strong id="admin_guide_000350__b118587765114">Destination NameService Name</strong>: indicates the NameService name of the standby cluster, for example, <strong id="admin_guide_000350__b28591072514">hacluster</strong>. You can obtain it from the <strong id="admin_guide_000350__b183022126430">NameService Management</strong> page of HDFS of the standby cluster.</li></ul>
|
|
<ul id="admin_guide_000350__en-us_topic_0165590410_ul35551413145719"><li id="admin_guide_000350__li040871275519"><strong id="admin_guide_000350__b17171215154313">IP Mode</strong>: indicates the mode of the target IP address. The system automatically selects the IP address mode based on the cluster network type, for example, <strong id="admin_guide_000350__b385811165435">IPv4</strong> or <strong id="admin_guide_000350__b0861116194319">IPv6</strong>.</li><li id="admin_guide_000350__li3502122517242"><strong id="admin_guide_000350__b3679139185118">Destination Active NameNode IP Address</strong>: indicates the service plane IP address of the active NameNode in the standby cluster.</li><li id="admin_guide_000350__en-us_topic_0165590410_li35760164145447"><strong id="admin_guide_000350__b121344127519">Destination Standby NameNode IP Address</strong>: indicates the service plane IP address of the standby NameNode in the standby cluster.</li><li id="admin_guide_000350__li12963704250"><strong id="admin_guide_000350__b17546712195014">Destination NameNode RPC Port</strong>: indicates the value of <strong id="admin_guide_000350__b1754751211509">dfs.namenode.rpc.port</strong> in the HDFS basic configuration of the standby cluster.</li><li id="admin_guide_000350__en-us_topic_0165590410_li53406027145447"><strong id="admin_guide_000350__b4412408177">Target Path</strong>: indicates the HDFS directory for storing standby cluster backup data. The storage path cannot be an HDFS hidden directory, such as a snapshot or recycle bin directory, or a default system directory, such as <strong id="admin_guide_000350__b4417314464">/hbase</strong> or <strong id="admin_guide_000350__b249432469">/user/hbase/backup</strong>.</li><li id="admin_guide_000350__li133962206298"><strong id="admin_guide_000350__b04031271461">Maximum Number of Backup Copies</strong>: indicates the number of backup file sets that can be retained in the backup directory.</li></ul>
|
|
</div>
|
|
</li><li class="subitemlist" id="admin_guide_000350__li1299617428503"><strong id="admin_guide_000350__b6959830164610">CIFS</strong>: indicates that backup files are stored in the NAS using the CIFS protocol.<div class="subitemlist" id="admin_guide_000350__p1255817436508">If you select this option, set the following parameters:<ul id="admin_guide_000350__ul16410165319298"><li id="admin_guide_000350__li1241145352917"><strong id="admin_guide_000350__b1676493710465">IP Mode</strong>: indicates the mode of the target IP address. The system automatically selects the IP address mode based on the cluster network type, for example, <strong id="admin_guide_000350__b46511239184615">IPv4</strong> or <strong id="admin_guide_000350__b265212395468">IPv6</strong>.</li></ul>
|
|
<ul id="admin_guide_000350__ul19998175216165"><li id="admin_guide_000350__li14202144861616"><strong id="admin_guide_000350__b16793164194611">Server IP Address</strong>: indicates the IP address of the NAS server.</li><li id="admin_guide_000350__li5203184891618"><strong id="admin_guide_000350__b1710944614463">Port</strong>: indicates the port number used to connect to the NAS server over the CIFS protocol. The default value is <strong id="admin_guide_000350__b2011624674615">445</strong>.</li><li id="admin_guide_000350__li121901359121615"><strong id="admin_guide_000350__b122171487464">Username</strong>: indicates the username set when the CIFS protocol is configured.</li><li id="admin_guide_000350__li10297967178"><strong id="admin_guide_000350__b713815094614">Password</strong>: indicates the password set when the CIFS protocol is configured.</li><li id="admin_guide_000350__li1220411480164"><strong id="admin_guide_000350__b03120523466">Server Shared Path</strong>: indicates the configured shared directory of the NAS server. (The shared path of the server cannot be set to the root directory, and the user group and owner group of the shared path must be <strong id="admin_guide_000350__b1290691535016">nobody:nobody</strong>.)</li><li id="admin_guide_000350__li1359884302813"><strong id="admin_guide_000350__b126431654134619">Maximum Number of Backup Copies</strong>: indicates the number of backup file sets that can be retained in the backup directory.</li></ul>
|
|
</div>
|
|
</li><li class="subitemlist" id="admin_guide_000350__li441312313569"><strong id="admin_guide_000350__b1690574467">SFTP</strong>: indicates that backup files are stored in the server using the SFTP protocol.<p class="subitemlist" id="admin_guide_000350__p841418318563">If you select this option, set the following parameters:</p>
|
|
<ul id="admin_guide_000350__ul12284175320615"><li id="admin_guide_000350__li1645434672512"><strong id="admin_guide_000350__b1748280194711">IP Mode</strong>: indicates the mode of the target IP address. The system automatically selects the IP address mode based on the cluster network type, for example, <strong id="admin_guide_000350__b3235725478">IPv4</strong> or <strong id="admin_guide_000350__b142361294715">IPv6</strong>.</li><li id="admin_guide_000350__li12315361364"><strong id="admin_guide_000350__b199725484714">Server IP Address</strong>: indicates the IP address of the server where the backup data is stored.</li><li id="admin_guide_000350__li92311736466"><strong id="admin_guide_000350__b4854862479">Port</strong>: indicates the port number used to connect to the backup server over the SFTP protocol. The default value is <strong id="admin_guide_000350__b7855176154715">22</strong>.</li><li id="admin_guide_000350__li3231136567"><strong id="admin_guide_000350__b178303894715">Username</strong>: indicates the username for connecting to the server using the SFTP protocol.</li><li id="admin_guide_000350__li1523193617616"><strong id="admin_guide_000350__b16988141475">Password</strong>: indicates the password for connecting to the server using the SFTP protocol.</li><li id="admin_guide_000350__li42323361963"><strong id="admin_guide_000350__b4686316184718">Server Shared Path</strong>: indicates the backup path on the SFTP server.</li><li id="admin_guide_000350__li3232123612620"><strong id="admin_guide_000350__b17736181914712">Maximum Number of Backup Copies</strong>: indicates the number of backup file sets that can be retained in the backup directory.</li></ul>
|
|
</li></ul>
|
|
</div>
|
|
</p></li><li id="admin_guide_000350__li6567536315256"><span>Click <strong id="admin_guide_000350__b146910541178">OK</strong>.</span></li><li id="admin_guide_000350__li3081012415256"><span>In the <strong id="admin_guide_000350__b49351628114820">Operation</strong> column of the created task in the backup task list, click <strong id="admin_guide_000350__b9937528124818">More</strong> and select <strong id="admin_guide_000350__b18938182834814">Back Up Now</strong> to execute the backup task.</span><p><p id="admin_guide_000350__p1981094718128">After the backup task is executed, the system automatically creates a subdirectory for each backup task in the backup directory. The format of the subdirectory name is <em id="admin_guide_000350__i137721932104813">Backup task name</em><strong id="admin_guide_000350__b17774113219483">_</strong><em id="admin_guide_000350__i7775832154817">Task creation time</em>, and the subdirectory is used to save data source backup files.</p>
|
|
<p id="admin_guide_000350__ab1ce28c122084e08bf166362836a4c3d">The format of the backup file name is <em id="admin_guide_000350__i671016356482">Version</em><strong id="admin_guide_000350__b67118351483">_</strong><em id="admin_guide_000350__i17712143564812">Data source</em><strong id="admin_guide_000350__b5714123510485">_</strong><em id="admin_guide_000350__i157157359482">Task execution time</em><strong id="admin_guide_000350__b1716203511481">.tar.gz</strong>.</p>
|
|
</p></li></ol>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<div class="familylinks">
|
|
<div class="parentlink"><strong>Parent topic:</strong> <a href="admin_guide_000201.html">Backing Up Data</a></div>
|
|
</div>
|
|
</div>
|
|
|