Files
doc-exports/docs/dcs/umn/dcs-migration-0312003.html
chenjunjie ab5f2db011 DCS UMN 20240705 version
Reviewed-by: Mützel, Andrea <andrea.muetzel@t-systems.com>
Co-authored-by: chenjunjie <chenjunjie@huawei.com>
Co-committed-by: chenjunjie <chenjunjie@huawei.com>
2025-02-26 10:24:22 +00:00

83 lines
36 KiB
HTML

<a name="dcs-migration-0312003"></a><a name="dcs-migration-0312003"></a>
<h1 class="topictitle1">Online Migration Between Instances</h1>
<div id="body8662426"><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p1244713381103">If the source and target instances are interconnected and the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b143842192411">SYNC</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b20384171917418">PSYNC</strong> commands are supported by the source instance, data can be migrated online in full or incrementally from the source to the target.</p>
<div class="note" id="dcs-migration-0312003__en-us_topic_0000001935864141_note163110283525"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p4701259102114">During online migration, data is essentially synchronized in full to a new replica. Therefore, perform online migration during low-demand hours. Otherwise, source instance CPU usage may surge and latency may increase.</p>
</div></div>
<div class="section" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section15790816165711"><h4 class="sectiontitle">Notes and Constraints</h4><ul id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ul56215114194"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li618634772016">You cannot use public networks for online migration.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li963201191917">Before migrating data, read through <a href="dcs-migration-090626002.html">Migration Solution Notes</a> to learn about the DCS data migration function and select an appropriate target instance.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li1780945272915">Migrating a later Redis instance to an earlier one may fail.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li18051932613">For earlier instances whose passwords contain single quotation marks ('), modify the password for online migration or try other methods.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li2988793125">By default, a cluster instance has only one DB (DB0). Before you migrate data from a multi-DB single-node or master/standby instance to a Redis Cluster instance, check whether any data exists on databases other than DB0. To ensure that the migration succeeds, move all data to DB0 by referring to <a href="dcs-migration-090626001.html">Online Migration with Rump</a>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li12127172742014">During online migration, you are advised to set <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b286126635">repl-timeout</strong> on the source instance to 300s and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b18611361133">client-output-buffer-slave-hard-limit</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b138611618318">client-output-buffer-slave-soft-limit</strong> to 20% of the maximum memory of the instance.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li773103010264">To migrate to an instance with SSL enabled, disable the SSL setting first. For details, see <a href="dcs-ug-023129.html">Transmitting DCS Redis Data with Encryption Using SSL</a>.</li></ul>
</div>
<div class="section" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section1128152020384"><h4 class="sectiontitle">Prerequisites</h4><ul id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ul727834515383"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li1527810451382">If a target DCS Redis instance is not available, create one first. For details, see <a href="dcs-ug-0312003.html">Creating a DCS Redis Instance</a>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li1394816445398">If you already have a DCS Redis instance, you do not need to create one again. For comparing migration data and reserving sufficient memory, you are advised to clear the instance data before the migration. For details, see <a href="dcs-ug-0312018.html">Clearing DCS Instance Data</a>.<p id="dcs-migration-0312003__en-us_topic_0000001935864141_p12232105715390">If the data exists on the target instance, the replicated data between the source and target is overwritten. If the data exists only on the target instance, the data will be retained.</p>
</li></ul>
</div>
<div class="section" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section157769524519"><h4 class="sectiontitle">Creating an Online Migration Task</h4><ol id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ol81391154144716"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li390016374490"><span>Log in to the DCS console.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p193754334219"><strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b383985310819">If the source and target Redis are under different accounts, use the source account to log in to DCS.</strong></p>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li397632810712"><span>Click <span><img id="dcs-migration-0312003__en-us_topic_0000001935864141_i0d8b8411c49244f694e4f9ebeef4b3c5" src="en-us_image_0000001962038446.png"></span> in the upper left corner of the console and select the region where your <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b152730271894">source</strong> instance is located.</span><p><div class="note" id="dcs-migration-0312003__en-us_topic_0000001935864141_note1641203313110"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p18818341014">Only when the online migration task and the source Redis are under an account and in a region, the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b2021193617133">SYNC</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b28381938151310">PSYNC</strong> commands of the source Redis are allowed. Otherwise, online migration cannot be performed.</p>
</div></div>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li16119587498"><span>In the navigation pane, choose <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b39351247123317">Data Migration</strong>. The migration task list is displayed.</span></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li67372014165120"><span>Click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b13334015205519">Create Online Migration Task</strong>.</span></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li1381824764611"><span>Enter the task name and description.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p87011743104513">The task name must start with a letter, contain 4 to 64 characters, and contain only letters, digits, hyphens (-), and underscores (_).</p>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li114411588467"><span>Configure the VPC, subnet, and security group for the migration task.</span><p><div class="note" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_note8226825195811"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ul12308184119132"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li8969127101514">Use the VPC of the source or target Redis.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li13308204111130">The online migration task uses a tenant IP address (<strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b197811218123710">Migration ECS</strong> displayed on the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b167811718103719">Basic Information</strong> page of the task.) If a whitelist is configured for the source or target instance, add the migration IP address to the whitelist or disable the whitelist.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li18308441171318">To allow the VM used by the migration task to access the source and target instances, set an outbound rule for the task's security group to allow traffic through the IP addresses and ports of the source and target instances. By default, all outbound traffic is allowed.</li></ul>
</div></div>
</p></li></ol>
</div>
<div class="section" id="dcs-migration-0312003__en-us_topic_0000001935864141_section0422112610171"><h4 class="sectiontitle">Checking the Network</h4><ol id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ol1260417035216"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li16049019525"><span>Check whether the source Redis instance, the target Redis instance, and the migration task are configured with the same VPC.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p188021330165115">If yes, go to <a href="#dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section14919536272">Configuring the Online Migration Task</a>. If no, go to <a href="#dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li160420185217">2</a>.</p>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li160420185217"><a name="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li160420185217"></a><a name="en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li160420185217"></a><span>Check whether the VPCs configured for the source Redis instance, the target Redis instance, and the migration task are connected to ensure that the VM resource of the migration task can access the source and target Redis instances.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p1480253095111">If yes, go to <a href="#dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section14919536272">Configuring the Online Migration Task</a>. If no, go to <a href="#dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li423483319412">3</a>.</p>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li423483319412"><a name="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li423483319412"></a><a name="en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li423483319412"></a><span>Perform the following operations to establish the network.</span><p><ul id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ul17325432414"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li7271615152516">If the source and target Redis instances are <span id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ph4272141572517">in the same DCS region</span>, create a VPC peering connection by referring to "Peering Connection" in <em id="dcs-migration-0312003__en-us_topic_0000001935864141_i16457149181916">Virtual Private Cloud (VPC) User Guide</em>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li831118331565">If the source and target Redis instances are in different DCS regions, create a connection by referring to the <em id="dcs-migration-0312003__en-us_topic_0000001935864141_i3419115815206">Direct Connect User Guide</em>.</li></ul>
</p></li></ol>
</div>
<div class="section" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section14919536272"><a name="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section14919536272"></a><a name="en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section14919536272"></a><h4 class="sectiontitle">Configuring the Online Migration Task</h4><ol id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ol20242048298"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li187884091914"><span>On the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b787651612226">Online Migration</strong> tab page, click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b208765165228">Configure</strong> in the row containing the online migration task you just created.</span></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li18777171715209"><a name="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li18777171715209"></a><a name="en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li18777171715209"></a><span>Select a migration type.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p72342811211">Supported migration types are <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b7961135591712">Full</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b1096125531711">Full + Incremental</strong>, which are described in <a href="#dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_table55653322215">Table 1</a>.</p>
<p id="dcs-migration-0312003__en-us_topic_0000001935864141_p1336613185314">To <a href="#dcs-migration-0312003__en-us_topic_0000001935864141_section12424655143818">switch DCS instance IPs</a> after instance migration, select <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1555321222414">Full + Incremental</strong> for the migration type.</p>
<div class="tablenoborder"><a name="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_table55653322215"></a><a name="en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_table55653322215"></a><table cellpadding="4" cellspacing="0" summary="" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_table55653322215" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Migration type description</caption><thead align="left"><tr id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_row5587330229"><th align="left" class="cellrowborder" valign="top" width="27.47%" id="mcps1.3.7.2.2.2.3.2.3.1.1"><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p758103372214">Migration Type</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="72.53%" id="mcps1.3.7.2.2.2.3.2.3.1.2"><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p1058153311225">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_row1958203312220"><td class="cellrowborder" valign="top" width="27.47%" headers="mcps1.3.7.2.2.2.3.2.3.1.1 "><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p458153332210">Full</p>
</td>
<td class="cellrowborder" valign="top" width="72.53%" headers="mcps1.3.7.2.2.2.3.2.3.1.2 "><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p125833322217">Suitable for scenarios where services can be interrupted. Data is migrated at one time. <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b2535184111510">Source instance data updated during the migration will not be migrated to the target instance.</strong></p>
</td>
</tr>
<tr id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_row205815338228"><td class="cellrowborder" valign="top" width="27.47%" headers="mcps1.3.7.2.2.2.3.2.3.1.1 "><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p85863316221">Full + incremental</p>
</td>
<td class="cellrowborder" valign="top" width="72.53%" headers="mcps1.3.7.2.2.2.3.2.3.1.2 "><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p858103352214">Suitable for scenarios requiring minimal service downtime. The incremental migration parses logs to ensure data consistency between the source and target instances.</p>
<p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p110411470116">Once the migration starts, it remains <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1239633218259">Migrating</strong> until you click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b43962323258">Stop</strong> in the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b13961832182514">Operation</strong> column. After the migration is stopped, data in the source instance will not be lost, but data will not be written to the target instance. When the transmission network is stable, the delay of incremental migration is within seconds. The actual delay depends on the transmission quality of the network link.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="fignone" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_fig23511729101218"><span class="figcap"><b>Figure 1 </b>Selecting the migration type</span><br><span><img id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_image2036555461718" src="en-us_image_0000001955094688.png"></span></div>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li76295537920"><span>Only if <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b49878456252">Migration Type</strong> is set to <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b29879457251">Full + Incremental</strong>, you can specify a bandwidth limit.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p197736619241">The data synchronization rate can be kept around the bandwidth limit.</p>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li13649906333"><span>Specify <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b34193412271">Auto-Reconnect</strong>. If this option is enabled, automatic reconnections will be performed indefinitely in the case of a network exception.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p67501140810">Full synchronization will be triggered and requires more bandwidth if incremental synchronization becomes unavailable. Exercise caution when enabling this option.</p>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li974533414185"><span>Configure <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b3314825122811">Source Redis</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1891962917288">Target Redis</strong>.</span><p><ol type="a" id="dcs-migration-0312003__en-us_topic_0000001935864141_ol1555514535326"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li13555165319328">Set <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b693419218358">Source Redis Type</strong> to <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b116091302354">Redis in the cloud</strong> and add <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b23933593610">Source Redis Instance</strong>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li9907815183313">Configure <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b993755923719">Target Redis Type</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1582032133811">Target Redis Instance</strong>:<ul id="dcs-migration-0312003__en-us_topic_0000001935864141_ul2161162093310"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li671817229332">If the target Redis and migration task are in a VPC, or across VPCs over a network in a region, set <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b5559959134317">Target Redis Type</strong> to <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b134701755204319">Redis in the cloud</strong> and add <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b137741519447">Target Redis Instance</strong>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li16161520163310">If the target Redis and migration task are in different regions, set <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b45211048184716">Target Redis Type</strong> to <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b3853135016479">Self-hosted Redis</strong> and add <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1034819711485">Target Redis Instance</strong>. If the target Redis is a Redis Cluster, enter the IP addresses and ports of all masters in the cluster and separate multiple addresses with commas (,). For example: <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1991810485119">192.168.1.1:6379,192.168.0.0:6379</strong></li></ul>
</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li142491381316">Configure <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1139145818514">Source Redis Instance Password</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b53450118521">Target Redis Instance Password</strong>: If the instance is password-protected, click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b162141111105118">Test Connection</strong> to check whether the instance password is correct and whether the network is connected. If the instance is not password-protected, click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b7131131815246">Test Connection</strong> directly.<p id="dcs-migration-0312003__en-us_topic_0000001935864141_p1992114918157">Currently, the users created in <a href="dcs-ug-221220.html">Managing Users</a> are unavailable here.</p>
</li></ol>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li1348442114911"><span>Click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b13194159102331">Next</strong>.</span></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li3625202214190"><span>Confirm the migration task details and click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b144078323546">Submit</strong>.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p9625422141910">Go back to the data migration task list. After the migration is successful, the task status changes to <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b15447174915118">Successful</strong>.</p>
<p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p4880126112412">If the migration fails, click the migration task and check the log on the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b335084213548">Migration Logs</strong> page.</p>
<div class="note" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_note4427420124517"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ul4321452125415"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li3321952195412">Once full + incremental migration starts, it remains <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b97341914165517">Migrating</strong> after full migration.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li23211252175420">To manually stop a migration task, select the check box on the left of the migration task and click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b15871442195617">Stop</strong> above the migration task.</li></ul>
</div></div>
</p></li></ol>
</div>
<div class="section" id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_section3718231268"><h4 class="sectiontitle">Verifying the Migration</h4><p id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_p1571161034711">After the migration is complete, check data integrity in the following way.</p>
<ol id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_ol11257313194715"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li94593118471">Connect the source Redis and the target Redis. For details, see <a href="dcs-ug-0326009.html">Accessing a DCS Redis Instance Through redis-cli</a>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li10257713154717">Run the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1984811531475">info keyspace</strong> command on the source and the target Redis to check the values of <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1884820539719">keys</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b118481653872">expires</strong>.<div class="fignone" id="dcs-migration-0312003__en-us_topic_0000001935864141_fig19418122142418"><span class="figcap"><b>Figure 2 </b>Checking instance data</span><br><span><img id="dcs-migration-0312003__en-us_topic_0000001935864141_image141813218246" src="en-us_image_0000001990974029.png"></span></div>
</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li1878042516480">Calculate the differences between the values of <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b7585046192918">keys</strong> and <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_b2585204614294">expires</strong> of the source Redis and the target Redis. If the differences are the same, the data is complete and the migration is successful.</li></ol>
<div class="note" id="dcs-migration-0312003__en-us_topic_0000001935864141_note056170794"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p1657001596">During full migration, source Redis data updated during the migration will not be migrated to the target instance.</p>
</div></div>
</div>
<div class="section" id="dcs-migration-0312003__en-us_topic_0000001935864141_section12424655143818"><a name="dcs-migration-0312003__en-us_topic_0000001935864141_section12424655143818"></a><a name="en-us_topic_0000001935864141_section12424655143818"></a><h4 class="sectiontitle">(Optional) Switching DCS Instance IP Addresses</h4><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p11840105818189">The prerequisites for switching source and target Redis instance IP addresses are as follows. The target Redis can be accessed automatically on a client after the switch.</p>
<p id="dcs-migration-0312003__en-us_topic_0000001935864141_p18296610165612"><strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b15178422142312">Prerequisites:</strong></p>
<ul id="dcs-migration-0312003__en-us_topic_0000001935864141_ul4247514112120"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li52471614172116">This function is supported by basic edition DCS Redis 4.0 instances and later, <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b593834495810">but not by professional edition DCS Redis instances</strong>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li524741418214">For DCS Redis 3.0 instances, contact customer service to enable the whitelist for Redis 3.0 instance IP switches. The instance IP addresses can be switched only when the source instance is a DCS Redis 3.0 instance and the target instance is a basic edition DCS Redis 4.0, 5.0, or 6.0 instance.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li182471114112115">The IP addresses of a source or target instance with public access enabled cannot be switched.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li2651414152315">Instance IPs can be switched only for the source and target Redis that are single-node, master/standby, read/write splitting, or Proxy Cluster instances.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li367971172719"><strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b18951555122716">Full + Incremental</strong> must be selected in <a href="#dcs-migration-0312003__en-us_topic_0000001935864141_en-us_topic_0292880550_dcs-migration-190703003_li18777171715209">2</a>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li121479425411">The source and target Redis instance ports must be consistent.</li></ul>
<div class="notice" id="dcs-migration-0312003__en-us_topic_0000001935864141_note338831716433"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ol id="dcs-migration-0312003__en-us_topic_0000001935864141_ol14309115714817"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li43092575815">Online migration will stop during the switching.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li2030915573819">Instances will be read-only for one minute and disconnected for several seconds during the switching. </li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li373164010347">If your application cannot reconnect to Redis or handle exceptions, you may need to restart the application after the IP switching.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li1130910571288">If the source and target instances are in different subnets, the subnet information will be updated after the switching.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li17309135718816">If the source is a master/standby instance, the IP address of the standby node will not be switched. Ensure that this IP address is not used by your applications.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li1630918571184">If your applications use a domain name to connect to Redis, the domain name will be used for the source instance. Select <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b8611119164913">Yes</strong> for <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b183710329493">Switch Domain Name</strong>.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li18309157481">Ensure that the passwords of the source and target instances are the same. If they are different, verification will fail after the switching.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li2391459144817">If a whitelist is configured for the source instance, ensure that the same whitelist is configured for the target instance before switching IP addresses.</li></ol>
</div></div>
<ol id="dcs-migration-0312003__en-us_topic_0000001935864141_ol43115541812"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li13269132134611"><span>On the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b2080817560288">Data Migration</strong> &gt; <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b980935617287">Online Migration</strong> page, when the migration task status changes to <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b188090568287">Incremental migration in progress</strong>, choose <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b138096563284">More</strong> &gt; <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b3809356162818">Switch IP</strong> in the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b13809105622814">Operation</strong> column.</span></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li1992351284614"><span>In the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b4391525182414">Switch IP</strong> dialog box, select whether to switch the domain name.</span><p><div class="note" id="dcs-migration-0312003__en-us_topic_0000001935864141_note1659121725213"><img src="public_sys-resources/note_3.0-en-us.png"><span class="notetitle"> </span><div class="notebody"><ul id="dcs-migration-0312003__en-us_topic_0000001935864141_ul35917178526"><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li1359161711526">If a Redis domain name is used on the client, switch it or you must modify the domain name on the client.</li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li185916175526">If the domain name switch is not selected, only the instance IP addresses will be switched.</li></ul>
</div></div>
</p></li><li id="dcs-migration-0312003__en-us_topic_0000001935864141_li1959171765216"><span>Click <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1970718588275">OK</strong>. The IP address switching task is submitted successfully. When the status of the migration task changes to <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b171121359286">IP switched</strong>, the IP address switching is complete.</span><p><p id="dcs-migration-0312003__en-us_topic_0000001935864141_p948124214715">To restore the IPs, choose <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1952864103214">More</strong> &gt; <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b1526707113216">Roll Back IP</strong> in the operation column. The IPs are rolled back when the task is in the <strong id="dcs-migration-0312003__en-us_topic_0000001935864141_b136781511327">Successful</strong> state.</p>
</p></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dcs-migration-0312008.html">Migrating Data Between DCS Instances</a></div>
</div>
</div>