doc-exports/docs/mrs/umn/admin_guide_000351.html

<a name="admin_guide_000351"></a><a name="admin_guide_000351"></a>

<h1 class="topictitle1">Restoring IoTDB Metadata</h1>
<div id="body0000001585031377"><div class="section" id="admin_guide_000351__section60718452105032"><h4 class="sectiontitle">Scenario</h4><p id="admin_guide_000351__en-us_topic_0046736764_p50247175">To ensure IoTDB metadata security and prevent the IoTDB service from being unavailable due to IoTDB file damage, IoTDB metadata needs to be backed up. In this way, the system can restore data timely when an exception is reported or an operation does not achieve the expected result, minimizing the impact on services.</p>
<p id="admin_guide_000351__p1247810247307">System administrators can create an IoTDB restoration task on <span id="admin_guide_000351__text67509419010">MRS</span> Manager. Only manual restoration tasks are supported.</p>
<div class="notice" id="admin_guide_000351__note164221638123014"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="admin_guide_000351__ul124221381305"><li id="admin_guide_000351__li35651622155541">Data restoration can be performed only when the system version is consistent with that during data backup.</li><li id="admin_guide_000351__en-us_topic_0046736773_li35796480">To restore the data when services are normal, manually back up the latest management data first and then restore the data. Otherwise, the IoTDB data that is generated after the data backup and before the data restoration will be lost.</li><li id="admin_guide_000351__li6191124425417">You are advised to restore the metadata of only one component in a restoration task to prevent the stop of a service or instance from affecting the data restoration of other components. If data of multiple components is restored at the same time, data restoration may fail.</li></ul>
</div></div>
</div>
<div class="section" id="admin_guide_000351__section16795761105032"><h4 class="sectiontitle">Impact on the System</h4><p id="admin_guide_000351__p2586911111816">After the metadata is restored, the data generated after the data backup and before the data restoration is lost.</p>
</div>
<div class="section" id="admin_guide_000351__section128701329135"><h4 class="sectiontitle">Procedure</h4><ol id="admin_guide_000351__ol31006046105032"><li id="admin_guide_000351__li12320634105032"><span>On <span id="admin_guide_000351__text2657124311811">MRS</span> Manager, choose <strong id="admin_guide_000351__b155632651454041">O&amp;M</strong> &gt; <strong id="admin_guide_000351__b15000728654041">Backup and Restoration</strong> &gt; <strong id="admin_guide_000351__b211985791054041">Backup Management</strong>.</span></li><li id="admin_guide_000351__li13361230105032"><span>In the row where the specified backup task is located, choose <strong id="admin_guide_000351__b74141329114315">More</strong> &gt; <strong id="admin_guide_000351__b111481537144311">View History</strong> in the <strong id="admin_guide_000351__b1012411284312">Operation</strong> column to display the historical execution records of the backup task.</span><p><p class="litext" id="admin_guide_000351__a1eed586b104947faab576bb3bc7900f7">In the window that is displayed, select a success record and click <strong id="admin_guide_000351__b5300937492">View</strong> in the <strong id="admin_guide_000351__b153071373918">Backup Path</strong> column to view its backup path information and find the following information:</p>
<ul class="subitemlist" id="admin_guide_000351__u1dc509486adb4ae8940b219d931db832"><li id="admin_guide_000351__l0b6056a0d39c4757becb4640f3c903ec"><strong id="admin_guide_000351__b109432411154041">Backup Object</strong>: indicates the backup data source.</li><li id="admin_guide_000351__le6e5460ee82c437294e59a24c6e760dc"><strong id="admin_guide_000351__b64455961954041">Backup Path</strong>: indicates the full path where backup files are stored.<p id="admin_guide_000351__afb3a9a49a9104a038791837dcde40ac2">Select the correct path, and manually copy the full path of backup files in <strong id="admin_guide_000351__b182273167054041">Backup Path</strong>.</p>
</li></ul>
</p></li><li id="admin_guide_000351__li62627246105032"><span>On <span id="admin_guide_000351__text97444541811">MRS</span> Manager, choose <strong id="admin_guide_000351__b167914651254041">O&amp;M</strong> &gt; <strong id="admin_guide_000351__b132519532454041">Backup and Restoration</strong> &gt; <strong id="admin_guide_000351__b32130837654041">Restoration Management</strong>.</span></li><li id="admin_guide_000351__li62165674105032"><span>Click <strong id="admin_guide_000351__b18134078554041">Create</strong>.</span></li><li id="admin_guide_000351__li34009756105032"><span>Set <strong id="admin_guide_000351__b72902683154041">Task Name</strong> to the name of the restoration task.</span></li><li id="admin_guide_000351__li1696835325016"><span>Select the cluster to be operated from <strong id="admin_guide_000351__b164530188554041">Recovery Object</strong>.</span></li><li id="admin_guide_000351__li61329238105032"><span>In <strong id="admin_guide_000351__b162558963922847">Restoration Configuration</strong>, select <strong id="admin_guide_000351__b19883329322847">IoTDB</strong> under <strong id="admin_guide_000351__b12603076322847">Metadata and other data</strong>.</span><p><div class="note" id="admin_guide_000351__note2984032138"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="admin_guide_000351__p898583215311">If multiple IoTDB services are installed, select the IoTDB service to be restored.</p>
</div></div>
</p></li><li id="admin_guide_000351__li50096053105032"><span>Select a backup directory type for <strong id="admin_guide_000351__b1110113195718">Path Type</strong>.</span><p><p class="litext" id="admin_guide_000351__p35960371105032">The configurations vary based on backup directory types:</p>
<ul class="subitemlist" id="admin_guide_000351__ul46098990105032"><li class="subitemlist" id="admin_guide_000351__li17990542516"><strong id="admin_guide_000351__b19237109354041">LocalDir</strong>: indicates that the backup files are stored on the local disk of the active management node.<p class="subitemlist" id="admin_guide_000351__p7389124311119">If you select this option, you also need to set <strong id="admin_guide_000351__b202552144654041">Source Path</strong>, which indicates the backup file to be restored, for example, <em id="admin_guide_000351__i63320591854041">Version_Data source_Task execution time</em><strong id="admin_guide_000351__b127876663054041">.tar.gz</strong>.</p>
</li><li class="subitemlist" id="admin_guide_000351__li105716551814"><strong id="admin_guide_000351__b03061802088">NFS</strong>: indicates that backup files are stored in NAS using the NFS protocol.<div class="subitemlist" id="admin_guide_000351__p1680913558111">If you select this option, configure the following parameters:<ul id="admin_guide_000351__ul96991812193314"><li id="admin_guide_000351__li0467122613613"><strong id="admin_guide_000351__b40260770954041">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_000351__b201937571954041">IPv4</strong> or <strong id="admin_guide_000351__b20699531354041">IPv6</strong>.</li></ul>
<ul id="admin_guide_000351__ul51213360578"><li id="admin_guide_000351__li31219365573"><strong id="admin_guide_000351__b180676008554041">Server IP Address</strong>: indicates the IP address of the NAS server.</li><li id="admin_guide_000351__li963620452139"><strong id="admin_guide_000351__b115413401854041">Source Path</strong>: indicates the complete path of the backup file on the NAS server, for example, <em id="admin_guide_000351__i21403144554041">Backup path/Backup task name_Data source_Task creation time/Version_Data source_Task execution time</em><strong id="admin_guide_000351__b209234073154041">.tar.gz</strong>.</li></ul>
</div>
</li><li class="subitemlist" id="admin_guide_000351__li8516195117200"><strong id="admin_guide_000351__b152583530922847">RemoteHDFS</strong>: indicates that the backup files are stored in the HDFS directory of the standby cluster.<div class="subitemlist" id="admin_guide_000351__p117721551112012">If you select this option, configure the following parameters:<ul id="admin_guide_000351__ud179b032526243a1b0db8724345c7606"><li id="admin_guide_000351__li9681194592517"><strong id="admin_guide_000351__b58183464535">Source NameService Name</strong>: <span id="admin_guide_000351__text1781874611539">indicates the NameService name of the backup data cluster, for example, <strong id="admin_guide_000351__b2081813468532">hacluster</strong>.</span> You can obtain it from the <strong id="admin_guide_000351__b108191746105314">NameService Management</strong> page of HDFS of the standby cluster.</li><li id="admin_guide_000351__li117921739133214"><strong id="admin_guide_000351__b785730586">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_000351__b91080840">IPv4</strong> or <strong id="admin_guide_000351__b1023103160">IPv6</strong>.</li><li id="admin_guide_000351__li1017415653416"><strong id="admin_guide_000351__b1528125545314">Source Active NameNode IP Address</strong>: indicates the service plane IP address of the active NameNode in the standby cluster.</li><li id="admin_guide_000351__li52041623171841"><strong id="admin_guide_000351__b19267111115416">Source Standby NameNode IP Address</strong>: indicates the service plane IP address of the standby NameNode in the standby cluster.</li><li id="admin_guide_000351__li12963704250"><strong id="admin_guide_000351__b3354612165411">Source NameNode RPC Port</strong>: indicates the value of <strong id="admin_guide_000351__b4354512125411">dfs.namenode.rpc.port</strong> in the HDFS basic configuration of the standby cluster.</li><li id="admin_guide_000351__l120bbe4f128d42a3b46591aef92040ad"><strong id="admin_guide_000351__b111577312422847">Source Path</strong>: indicates the full path of HDFS directory for storing backup data of the standby cluster, for example, <em id="admin_guide_000351__i1452421513">Backup path/Backup task name_Data source_Task creation time/Version_Data source_Task execution time</em><strong id="admin_guide_000351__b151268750">.tar.gz</strong>.</li></ul>
</div>
</li><li class="subitemlist" id="admin_guide_000351__li94225816111"><strong id="admin_guide_000351__b85141319114">CIFS</strong>: indicates that backup files are stored in NAS using the CIFS protocol.<div class="subitemlist" id="admin_guide_000351__p9275205810111">If you select this option, configure the following parameters:<ul id="admin_guide_000351__ul6996182915367"><li id="admin_guide_000351__li499618292364"><strong id="admin_guide_000351__b833304518">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_000351__b1421624359">IPv4</strong> or <strong id="admin_guide_000351__b1588113588">IPv6</strong>.</li></ul>
<ul id="admin_guide_000351__ul312712363577"><li id="admin_guide_000351__li91281236125716"><strong id="admin_guide_000351__b190127405254041">Server IP Address</strong>: indicates the IP address of the NAS server.</li><li id="admin_guide_000351__li16129123695711"><strong id="admin_guide_000351__b150664753754041">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_000351__b128708959754041">445</strong>.</li><li id="admin_guide_000351__li1412953610578"><strong id="admin_guide_000351__b134409316354041">Username</strong>: indicates the username set when the CIFS protocol is configured.</li><li id="admin_guide_000351__li15130153635719"><strong id="admin_guide_000351__b49391081254041">Password</strong>: indicates the password set when the CIFS protocol is configured.</li><li id="admin_guide_000351__li15413632141317"><strong id="admin_guide_000351__b12534090254041">Source Path</strong>: indicates the complete path of the backup file on the NAS server, for example, <em id="admin_guide_000351__i734809254">Backup path/Backup task name_Data source_Task creation time/Version_Data source_Task execution time</em><strong id="admin_guide_000351__b347236764">.tar.gz</strong>.</li></ul>
</div>
</li><li class="subitemlist" id="admin_guide_000351__li441312313569"><strong id="admin_guide_000351__b2433182813615">SFTP</strong>: indicates that backup files are stored in the server using the SFTP protocol.<div class="subitemlist" id="admin_guide_000351__p841418318563">If you select this option, configure the following parameters:<ul id="admin_guide_000351__ul460550163116"><li id="admin_guide_000351__li1160115019316"><strong id="admin_guide_000351__b1058457983">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_000351__b136219095854041">IPv4</strong> or <strong id="admin_guide_000351__b92437839254041">IPv6</strong>.</li></ul>
<ul id="admin_guide_000351__ul241493118561"><li id="admin_guide_000351__li13115115615224"><strong id="admin_guide_000351__b141894950854041">Server IP Address</strong>: indicates the IP address of the server where the backup data is stored.</li><li id="admin_guide_000351__li3115165620229"><strong id="admin_guide_000351__b184295011754041">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_000351__b177800539954041">22</strong>.</li><li id="admin_guide_000351__li1111585602211"><strong id="admin_guide_000351__b157780260054041">Username</strong>: indicates the username for connecting to the server using the SFTP protocol.</li><li id="admin_guide_000351__li11151156102219"><strong id="admin_guide_000351__b115225547154041">Password</strong>: indicates the password for connecting to the server using the SFTP protocol.</li><li id="admin_guide_000351__li524741513333"><strong id="admin_guide_000351__b57751216254041">Source Path</strong>: indicates the complete path of the backup file on the backup server, for example, <em id="admin_guide_000351__i783422466">Backup path/Backup task name_Data source_Task creation time/Version_Data source_Task execution time</em><strong id="admin_guide_000351__b523424836">.tar.gz</strong>.</li></ul>
</div>
</li></ul>
</p></li><li id="admin_guide_000351__li60000102105032"><span>Click <strong id="admin_guide_000351__b63753313954041">OK</strong>.</span></li><li id="admin_guide_000351__li36127580105032"><span>In the restoration task list, locate the row where the created task is located, and click <strong id="admin_guide_000351__b16717533152317">Start</strong> in the <strong id="admin_guide_000351__b12723163362311">Operation</strong> column.</span><p><ul id="admin_guide_000351__ul11671751105032"><li id="admin_guide_000351__li40888218105032">After the restoration is successful, the progress bar is in green.</li><li id="admin_guide_000351__li11153371105032">After the restoration is successful, the restoration task cannot be executed again.</li><li id="admin_guide_000351__li9266991105032">If the restoration task fails during the first execution, rectify the fault and click <strong id="admin_guide_000351__b174923175654041">Retry</strong> to execute the task again.</li></ul>
</p></li><li id="admin_guide_000351__li13710646201819"><span>Choose <strong id="admin_guide_000351__b316542645215">Cluster</strong> &gt; <strong id="admin_guide_000351__b285630105216">Services</strong> and start the IoTDB service.</span></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="admin_guide_000215.html">Recovering Data</a></div>
</div>
</div>