vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/css/umn/css_01_0186.html
Wuwan, Qi 050b395397 CSS UMN 23.2.1 20230926 
Reviewed-by: Kacur, Michal <michal.kacur@t-systems.com>
Co-authored-by: Wuwan, Qi <wuwanqi1@noreply.gitea.eco.tsi-dev.otc-service.com>
Co-committed-by: Wuwan, Qi <wuwanqi1@noreply.gitea.eco.tsi-dev.otc-service.com>
2024-01-10 14:23:15 +00:00

212 lines
31 KiB
HTML
Raw Blame History

<a name="css_01_0186"></a><a name="css_01_0186"></a>
<h1 class="topictitle1">Upgrading Versions</h1>
<div id="body0000001470931617"><p id="css_01_0186__en-us_topic_0000001470931617_p13292152113517">Same version upgrade and cross-version upgrade are supported. Same version upgrade is to upgrade the kernel patch of a cluster to fix problems or optimize performance. Cross-version upgrade is to upgrade the cluster version to enhance functions or incorporate versions.</p>
<div class="section" id="css_01_0186__en-us_topic_0000001470931617_section13666141813174"><h4 class="sectiontitle">Description</h4><p id="css_01_0186__en-us_topic_0000001470931617_p1526146182"><strong id="css_01_0186__en-us_topic_0000001470931617_b183752017983">Principle</strong></p>
<p id="css_01_0186__en-us_topic_0000001470931617_p11304144501414">Nodes in the cluster are upgraded one by one so that services are not interrupted. The upgrade process is as follows: bring a node offline, migrate its data to another node, create a new node of the target version, and mount the NIC ports of the offline node to the new node to retain the node IP address. After a new node is added to the cluster, other nodes will be updated in the same way in sequence. If there is a large amount of data in a cluster, the upgrade duration depends on the data migration duration.</p>
<p id="css_01_0186__en-us_topic_0000001470931617_p370315625715"><strong id="css_01_0186__en-us_topic_0000001470931617_b15135194795710">Process</strong></p>
<ol id="css_01_0186__en-us_topic_0000001470931617_ol105582214585"><li id="css_01_0186__en-us_topic_0000001470931617_li14229143455813"><a href="#css_01_0186__en-us_topic_0000001470931617_section15487721183320">Pre-Upgrade Check</a></li><li id="css_01_0186__en-us_topic_0000001470931617_li778133615583"><a href="css_01_0268.html">Creating a Snapshot</a></li><li id="css_01_0186__en-us_topic_0000001470931617_li1855814218587"><a href="#css_01_0186__en-us_topic_0000001470931617_section1733204451717">Creating an Upgrade Task</a></li></ol>
<p id="css_01_0186__en-us_topic_0000001470931617_p1612114527816"><strong id="css_01_0186__en-us_topic_0000001470931617_b416115245718">Version Restrictions</strong></p>
<div class="p" id="css_01_0186__en-us_topic_0000001470931617_p3718114410818">The supported target version varies according to the current cluster version. For details, see <a href="#css_01_0186__en-us_topic_0000001470931617_table34837148252">Table 1</a>.
<div class="tablenoborder"><a name="css_01_0186__en-us_topic_0000001470931617_table34837148252"></a><a name="en-us_topic_0000001470931617_table34837148252"></a><table cellpadding="4" cellspacing="0" summary="" id="css_01_0186__en-us_topic_0000001470931617_table34837148252" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Version restrictions</caption><thead align="left"><tr id="css_01_0186__en-us_topic_0000001470931617_row1251511492510"><th align="left" class="cellrowborder" valign="top" width="49.919999999999995%" id="mcps1.3.2.7.2.2.3.1.1"><p id="css_01_0186__en-us_topic_0000001470931617_p85151714112513">Current Version</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="50.080000000000005%" id="mcps1.3.2.7.2.2.3.1.2"><p id="css_01_0186__en-us_topic_0000001470931617_p65151414192517">Target Version</p>
</th>
</tr>
</thead>
<tbody><tr id="css_01_0186__en-us_topic_0000001470931617_row2051591442519"><td class="cellrowborder" valign="top" width="49.919999999999995%" headers="mcps1.3.2.7.2.2.3.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p6515121412254">6.2.3</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.2.7.2.2.3.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p351510141258">6.5.4, 6.8.23</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row1051511442514"><td class="cellrowborder" valign="top" width="49.919999999999995%" headers="mcps1.3.2.7.2.2.3.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p175151614112514">6.5.4</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.2.7.2.2.3.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p7515614182515">6.8.23</p>
</td>
</tr>
<tr id="css_01_0186__row1155212555413"><td class="cellrowborder" valign="top" width="49.919999999999995%" headers="mcps1.3.2.7.2.2.3.1.1 "><p id="css_01_0186__p455217559416">6.8.23</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.2.7.2.2.3.1.2 "><p id="css_01_0186__p1155213551246">7.6.2, 7.10.2</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row1151517143256"><td class="cellrowborder" valign="top" width="49.919999999999995%" headers="mcps1.3.2.7.2.2.3.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p195161914112517">7.1.1</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.2.7.2.2.3.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p651621419257">7.6.2, 7.10.2</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row1551613144255"><td class="cellrowborder" valign="top" width="49.919999999999995%" headers="mcps1.3.2.7.2.2.3.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p2516314162518">7.6.2</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.2.7.2.2.3.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p1451611442515">7.10.2</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row4516121414258"><td class="cellrowborder" valign="top" width="49.919999999999995%" headers="mcps1.3.2.7.2.2.3.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p195165144255">7.9.3</p>
</td>
<td class="cellrowborder" valign="top" width="50.080000000000005%" headers="mcps1.3.2.7.2.2.3.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p1751610141252">7.10.2</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row195191324015"><td class="cellrowborder" colspan="2" valign="top" headers="mcps1.3.2.7.2.2.3.1.1 mcps1.3.2.7.2.2.3.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p15203336144118">Note:</p>
<ul id="css_01_0186__en-us_topic_0000001470931617_ul178285284113"><li id="css_01_0186__en-us_topic_0000001470931617_li38275254115">7.6.2 and 7.10.2 are mainstream versions. You are advised to upgrade your clusters to these two versions. The supported target versions are displayed in the drop-down list of <strong id="css_01_0186__en-us_topic_0000001470931617_b9787123992519">Target Image</strong>.</li><li id="css_01_0186__en-us_topic_0000001470931617_li1682135215418">Clusters of version 5.<em id="css_01_0186__i132661772814">X</em> cannot be upgraded. Clusters of versions 6.2.3 and 6.5.4 can be upgraded to 6.8.23 and then to 7<em id="css_01_0186__i7717186135012">.X.X</em>.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
</div>
<div class="section" id="css_01_0186__en-us_topic_0000001470931617_section512992641719"><h4 class="sectiontitle">Constraints</h4><ul id="css_01_0186__en-us_topic_0000001470931617_ul1364472812569"><li id="css_01_0186__en-us_topic_0000001470931617_li1364412812569">A maximum of 20 clusters can be upgraded at the same time. You are advised to perform the upgrade during off-peak hours.</li><li id="css_01_0186__en-us_topic_0000001470931617_li15950742758">Clusters that have ongoing tasks cannot be upgraded.</li><li id="css_01_0186__en-us_topic_0000001470931617_li8602118181413">Once started, an upgrade task cannot be stopped until it succeeds or fails.</li><li id="css_01_0186__en-us_topic_0000001470931617_li647774542513">During the upgrade, nodes are replaced one by one. Requests sent to a node that is being replaced may fail. In this case, you are advised to access the cluster through the VPC Endpoint service or a dedicated load balancer.</li><li id="css_01_0186__en-us_topic_0000001470931617_li7809240135113">During the upgrade, the Kibana and Cerebro components will be rebuilt and cannot be accessed. Different Kibana versions are incompatible with each other. During the upgrade, you may fail to access Kibana due to version incompatibility. A cluster can be accessed after it is successfully upgraded.</li></ul>
</div>
<div class="section" id="css_01_0186__en-us_topic_0000001470931617_section15487721183320"><a name="css_01_0186__en-us_topic_0000001470931617_section15487721183320"></a><a name="en-us_topic_0000001470931617_section15487721183320"></a><h4 class="sectiontitle">Pre-Upgrade Check</h4><p id="css_01_0186__en-us_topic_0000001470931617_p77281246332">To ensure a successful upgrade, you must check the items listed in the following table before performing an upgrade.</p>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_01_0186__en-us_topic_0000001470931617_table1591172853715" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Pre-upgrade checklist</caption><thead align="left"><tr id="css_01_0186__en-us_topic_0000001470931617_row1914162917376"><th align="left" class="cellrowborder" valign="top" width="13.87%" id="mcps1.3.4.3.2.5.1.1"><p id="css_01_0186__en-us_topic_0000001470931617_p2147294378">Check Item</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="7.5200000000000005%" id="mcps1.3.4.3.2.5.1.2"><p id="css_01_0186__en-us_topic_0000001470931617_p166281128811">Check Method</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="41.620000000000005%" id="mcps1.3.4.3.2.5.1.3"><p id="css_01_0186__en-us_topic_0000001470931617_p14153294375">Description</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="36.99%" id="mcps1.3.4.3.2.5.1.4"><p id="css_01_0186__en-us_topic_0000001470931617_p51522910376">Normal Status</p>
</th>
</tr>
</thead>
<tbody><tr id="css_01_0186__en-us_topic_0000001470931617_row21552914379"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p1015142912375">Cluster status</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p26291921988">System check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p115202933718">After an upgrade task is started, the system automatically checks the cluster status. Clusters whose status is <strong id="css_01_0186__en-us_topic_0000001470931617_b584216118409">green</strong> or <strong id="css_01_0186__en-us_topic_0000001470931617_b3692141464017">yellow</strong> can provide services properly and have no unallocated primary shards.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p915112916375">The cluster status is <strong id="css_01_0186__en-us_topic_0000001470931617_b115667383415">Available</strong>.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row91513293377"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p171552917377">Node quantity</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p156291221682">System check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p1615152918372">After an upgrade task is started, the system automatically checks the number of nodes. The total number of data nodes and cold data nodes in a cluster must be greater than or equal to 3 so that services will not be interrupted.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p14150295373">The total number of data nodes and cold data nodes in a cluster must be greater than or equal to 3.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row151592973718"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p41514291373">Disk capacity</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p116293219819">System check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p6133317143020">After an upgrade task is started, the system automatically checks the disk capacity. During the upgrade, nodes are brought offline one by one and then new nodes are created. Ensure that the disk capacity of all the remaining nodes can process all data of the node that has been brought offline.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p6152297376">After a node is brought offline, the remaining nodes can contain all data of the cluster.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row4278661557"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p827914618552">Data backup</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p1227916620550">System check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p118221016856">Check whether the maximum number of primary and standby shards of indexes in a cluster can be allocated to the remaining data nodes and cold data nodes. Prevent backup allocation failures after a node is brought offline during the upgrade.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p37921934105614">Maximum number of primary and standby index shards plus 1 must be less than or equal to the total number of data nodes and cold data nodes before the upgrade.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row7151929123717"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p715192915372">Data backup</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p186291621811">Manual check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p015192933714">Before the upgrade, back up data to prevent data loss caused by upgrade faults. When submitting an upgrade task, you can determine whether to enable the system to check for the backup of all indexes.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p1415129193714">Check whether data has been backed up.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row181519291370"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p11157296378">Resources</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p1562918210815">System check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p41502903717">After an upgrade task is started, the system automatically checks resources. Resources will be created during the upgrade. Ensure that resources are available.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p181502953712">Resources are available and sufficient.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row191518296375"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p115202933719">Custom plugins</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p14629623820">System and manual check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p14314172516342">Perform this check only when custom plugins are installed in the source cluster. If a cluster has a custom plugin, upload all plugin packages of the target version on the plugin management page before the upgrade. During the upgrade, install the custom plugin in the new nodes. Otherwise, the custom plugins will be lost after the cluster is successfully upgraded. After an upgrade task is started, the system automatically checks whether the custom plugin package has been uploaded, but you need to check whether the uploaded plugin package is correct.</p>
<div class="note" id="css_01_0186__en-us_topic_0000001470931617_note17183122318137"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="css_01_0186__p1761217146396">If the uploaded plugin package is incorrect or incompatible, the plugin package cannot be automatically installed during the upgrade. As a result, the upgrade task fails. To restore a cluster, you can terminate the upgrade task and restore the node that fails to be upgraded by <a href="css_01_0156.html">Replacing a Specified Node</a>.</p>
<p id="css_01_0186__en-us_topic_0000001470931617_p117319661912">After the upgrade is complete, the status of the custom plugin is reset to <strong id="css_01_0186__en-us_topic_0000001470931617_b6951173021110">Uploaded</strong>.</p>
</div></div>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p31532993714">The plugin package of the cluster to be upgraded has been uploaded to the plugin list.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row51582914379"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p13154291377">Custom configurations</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p96291529811">System check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p101512912373">During the upgrade, the system automatically synchronizes the content of the cluster configuration file <span class="filepath" id="css_01_0186__en-us_topic_0000001470931617_filepath114015324334"><b>elasticsearch.yml</b></span>.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p1470495618134">Clusters' custom configurations are not lost after the upgrade.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row11151529173712"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p01513295372">Non-standard operations</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p1562912184">Manual check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p181552919377">Check whether non-standard operations are contained in the upgrade. Non-standard operations refer to manual operations that are not recorded. These operations cannot be automatically transferred during the upgrade, for example, modification of the <span class="filepath" id="css_01_0186__en-us_topic_0000001470931617_filepath87331753204116"><b>Kibana.yml</b></span> configuration file, system configuration, and route return.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p11151929143718">Some non-standard operations are compatible. For example, the modification of a security plugin can be retained through metadata, and the modification of system configuration can be retained using images. Some non-standard operations, such as the modification of the <span class="filepath" id="css_01_0186__en-us_topic_0000001470931617_filepath970795110435"><b>kibana.yml</b></span> file, cannot be retained, and you must back up the file in advance.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row815129163719"><td class="cellrowborder" valign="top" width="13.87%" headers="mcps1.3.4.3.2.5.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p1715112911376">Compatibility check</p>
</td>
<td class="cellrowborder" valign="top" width="7.5200000000000005%" headers="mcps1.3.4.3.2.5.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p2062913219818">System and manual check</p>
</td>
<td class="cellrowborder" valign="top" width="41.620000000000005%" headers="mcps1.3.4.3.2.5.1.3 "><p id="css_01_0186__en-us_topic_0000001470931617_p21562973717">After a cross-version upgrade task is started, the system automatically checks whether the source and target versions have incompatible configurations. If a custom plugin is installed for a cluster, the version compatibility of the custom plugin needs to be manually checked.</p>
</td>
<td class="cellrowborder" valign="top" width="36.99%" headers="mcps1.3.4.3.2.5.1.4 "><p id="css_01_0186__en-us_topic_0000001470931617_p2074216589164">Configurations before and after the cross-version upgrade are compatible.</p>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="css_01_0186__en-us_topic_0000001470931617_section1733204451717"><a name="css_01_0186__en-us_topic_0000001470931617_section1733204451717"></a><a name="en-us_topic_0000001470931617_section1733204451717"></a><h4 class="sectiontitle">Creating an Upgrade Task</h4><ol id="css_01_0186__en-us_topic_0000001470931617_ol11954122215571"><li id="css_01_0186__en-us_topic_0000001470931617_li1173513611411">Log in to the <span id="css_01_0186__en-us_topic_0000001470931617_text197351036151410">CSS</span> management console.</li><li id="css_01_0186__en-us_topic_0000001470931617_li17735636141417">In the navigation pane on the left, choose <span class="parmname" id="css_01_0186__en-us_topic_0000001470931617_parmname11735163601413"><b>Clusters</b></span>. On the cluster list page that is displayed, click the name of a cluster.</li><li id="css_01_0186__en-us_topic_0000001470931617_li19736114155310">On the displayed basic cluster information page, click <span class="wintitle" id="css_01_0186__en-us_topic_0000001470931617_wintitle2065917399547"><b>Version Upgrade</b></span>.</li><li id="css_01_0186__en-us_topic_0000001470931617_li162456171820">On the displayed page, set upgrade parameters.
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="css_01_0186__en-us_topic_0000001470931617_table1436065715216" frame="border" border="1" rules="all"><caption><b>Table 3 </b>Upgrade parameters</caption><thead align="left"><tr id="css_01_0186__en-us_topic_0000001470931617_row1636125711210"><th align="left" class="cellrowborder" valign="top" width="18.12%" id="mcps1.3.5.2.4.1.2.3.1.1"><p id="css_01_0186__en-us_topic_0000001470931617_p173613573215">Parameter</p>
</th>
<th align="left" class="cellrowborder" valign="top" width="81.88%" id="mcps1.3.5.2.4.1.2.3.1.2"><p id="css_01_0186__en-us_topic_0000001470931617_p123616570215">Description</p>
</th>
</tr>
</thead>
<tbody><tr id="css_01_0186__en-us_topic_0000001470931617_row636111571211"><td class="cellrowborder" valign="top" width="18.12%" headers="mcps1.3.5.2.4.1.2.3.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p1336175720210">Upgrade Type</p>
</td>
<td class="cellrowborder" valign="top" width="81.88%" headers="mcps1.3.5.2.4.1.2.3.1.2 "><ul id="css_01_0186__en-us_topic_0000001470931617_ul139512427616"><li id="css_01_0186__en-us_topic_0000001470931617_li19517421668"><strong id="css_01_0186__en-us_topic_0000001470931617_b767514912716">Same version upgrade</strong>: Upgrade the kernel patch of the cluster. The cluster version number remains unchanged.</li><li id="css_01_0186__en-us_topic_0000001470931617_li695204213617"><strong id="css_01_0186__en-us_topic_0000001470931617_b1781011182715">Cross version upgrade</strong>: Upgrade the cluster version.</li></ul>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row43611257192115"><td class="cellrowborder" valign="top" width="18.12%" headers="mcps1.3.5.2.4.1.2.3.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p3361175792110">Target Image</p>
</td>
<td class="cellrowborder" valign="top" width="81.88%" headers="mcps1.3.5.2.4.1.2.3.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p1936145717218">Image of the target version. When you select an image, the image name and target version details are displayed.</p>
</td>
</tr>
<tr id="css_01_0186__en-us_topic_0000001470931617_row3361257142113"><td class="cellrowborder" valign="top" width="18.12%" headers="mcps1.3.5.2.4.1.2.3.1.1 "><p id="css_01_0186__en-us_topic_0000001470931617_p1536120570214">Agency</p>
</td>
<td class="cellrowborder" valign="top" width="81.88%" headers="mcps1.3.5.2.4.1.2.3.1.2 "><p id="css_01_0186__en-us_topic_0000001470931617_p17361957182112">Select an IAM agency to grant the upgrade permission to the current account.</p>
<p id="css_01_0186__en-us_topic_0000001470931617_p697283115108">If no agency is available, click <span class="uicontrol" id="css_01_0186__en-us_topic_0000001470931617_uicontrol14906194912118"><b>Create Agency</b></span> to go to the IAM console and create an agency.</p>
<div class="note" id="css_01_0186__en-us_topic_0000001470931617_note9969917163718"><span class="notetitle"> NOTE: </span><div class="notebody"><p id="css_01_0186__en-us_topic_0000001470931617_p1970121723714">The selected agency must be assigned the <strong id="css_01_0186__en-us_topic_0000001470931617_b2083343511288">Tenant Administrator</strong> or <strong id="css_01_0186__en-us_topic_0000001470931617_b883393522816">VPC Administrator</strong> policy.</p>
</div></div>
</td>
</tr>
</tbody>
</table>
</div>
</li><li id="css_01_0186__en-us_topic_0000001470931617_li637205501913">After setting the parameters, click <span class="uicontrol" id="css_01_0186__en-us_topic_0000001470931617_uicontrol1271162372014"><b>Submit</b></span>. Determine whether to enable <strong id="css_01_0186__b12312174262813">Check full index snapshot</strong> and <strong id="css_01_0186__b55722265298">Perform cluster load detection</strong> and click <strong id="css_01_0186__en-us_topic_0000001470931617_b12437115413314">OK</strong>.<p id="css_01_0186__p13159136527">If a cluster is overloaded, the upgrade task may suspend or fail. Enabling <span class="parmvalue" id="css_01_0186__parmvalue1394791455212"><b>Cluster load detection</b></span> can effectively avoid failures. If any of the following situations occurs during the detection, wait or reduce the load. If you urgently need to upgrade the version and you have understood the upgrade failure risks, you can disable the <span class="parmvalue" id="css_01_0186__parmvalue1763119305147"><b>Cluster load detection</b></span> function. The cluster load detection items are as follows:</p>
<ul id="css_01_0186__ul103491858155210"><li id="css_01_0186__li4349258135212"><strong id="css_01_0186__b17880699342">nodes.thread_pool.search.queue &lt; 1000</strong>: check whether the maximum number of search queues is less than 1000.</li><li id="css_01_0186__li0349358195215"><strong id="css_01_0186__b8293155133412">nodes.thread_pool.write.queue &lt; 200</strong>: Check whether the maximum number of write queues is less than 200.</li><li id="css_01_0186__li103491058105217"><strong id="css_01_0186__b1909152063510">nodes.process.cpu.percent &lt; 90</strong>: Check whether the maximum CPU usage is less than 90%.</li><li id="css_01_0186__li2349105805215"><strong id="css_01_0186__b73901840153810">nodes.os.cpu.load_average/Number of CPU cores &lt; 80%</strong>: Check whether the ratio of the maximum load to the number of CPU cores is less than 80%.</li></ul>
</li><li id="css_01_0186__en-us_topic_0000001470931617_li14901712161314">View the upgrade task in the task list. If the task status is <strong id="css_01_0186__en-us_topic_0000001470931617_b10121044173214">Running</strong>, you can expand the task list and click <strong id="css_01_0186__en-us_topic_0000001470931617_b130848113211">View Progress</strong> to view the upgrade progress.<div class="fignone" id="css_01_0186__en-us_topic_0000001470931617_fig14780141943712"><span class="figcap"><b>Figure 1 </b>Viewing the upgrade progress</span><br><span><img id="css_01_0186__en-us_topic_0000001470931617_image1478015195373" src="en-us_image_0000001714802181.png"></span></div>
<p id="css_01_0186__en-us_topic_0000001470931617_p12331182821816">If the task status is <strong id="css_01_0186__en-us_topic_0000001470931617_b3326151733313">Failed</strong>, you can retry or terminate the task.</p>
<ul id="css_01_0186__en-us_topic_0000001470931617_ul4177156142712"><li id="css_01_0186__en-us_topic_0000001470931617_li4177135682711">Retry the task: Click <span class="uicontrol" id="css_01_0186__en-us_topic_0000001470931617_uicontrol1421711213356"><b>Retry</b></span> in the <strong id="css_01_0186__en-us_topic_0000001470931617_b92499614340">Operation</strong> column.</li><li id="css_01_0186__en-us_topic_0000001470931617_li425783119518">Terminate the task: Click <span class="uicontrol" id="css_01_0186__en-us_topic_0000001470931617_uicontrol881321115219"><b>Terminate</b></span> in the <strong id="css_01_0186__en-us_topic_0000001470931617_b66031445133818">Operation</strong> column.<div class="notice" id="css_01_0186__en-us_topic_0000001470931617_note1287372111316"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><ul id="css_01_0186__en-us_topic_0000001470931617_ul1254097171319"><li id="css_01_0186__en-us_topic_0000001470931617_li35401071139">Same version upgrade: If the upgrade task status is <strong id="css_01_0186__en-us_topic_0000001470931617_b18593417153919">Failed</strong>, you can terminate the upgrade task.</li><li id="css_01_0186__en-us_topic_0000001470931617_li95401271131">Cross version upgrade: You can stop an upgrade task only when the task status is <strong id="css_01_0186__en-us_topic_0000001470931617_b2232050173916">Failed</strong> and no node has been upgraded.</li></ul>
</div></div>
<p id="css_01_0186__en-us_topic_0000001470931617_p121121032105115">After an upgrade task is terminated, the <span class="parmname" id="css_01_0186__en-us_topic_0000001470931617_parmname1323511213219"><b>Task Status</b></span> of the cluster is rolled back to the status before the upgrade, and other tasks in the cluster are not affected.</p>
</li></ul>
</li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="css_01_0207.html">Elasticsearch</a></div>
</div>
</div>
View Git Blame Copy Permalink