SequoiaDB版本在线升级介绍说明

你的名字 2022-06-09 11:53 132阅读 0赞

![74f70a199901550d4ccc836ae9de774c-sz\_180174.png@1l\_640w.png][74f70a199901550d4ccc836ae9de774c-sz_180174.png_1l_640w.png]

# 1.前言 #

在[SequoiaDB][]数据库发展过程中，基本保持每半年对外发行一个正式的Release版本。并且每个新发布的Release版本相对老版本而言，性能方面都有很大的提高，并且数据库也会在新版本中加入很多新的功能，希望能够提高数据库开发的易用性。

在[SequoiaDB][]发展过程中，越来越多的开发者了解到它，并且对它发生兴趣。现在已经有越来越多的用户在学习、研究SequoiaDB，并且也有越来越多的企业用户在对SequoiaDB经过充分测试后，决定将[SequoiaDB][]部署在企业的生产环境中，利用[SequoiaDB][]分布式存储的优势，对外提供高并发、低延时的数据操作服务。

在很多[SequoiaDB][]的企业客户中，使用[SequoiaDB][SequoiaDB 1]数据库的生产系统都是企业内部比较重要的系统，必须支持24\*7对外提供服务，所以即使在对数据库实施版本升级的同时，也必须要满足数据库服务不停机的技术要求。

本文通过SequoiaDB在线升级原理介绍与详细升级步骤说明，向广大SequoiaDB用户提供一个可操作的数据库在线升级方案文档，希望能够对即将给SequoiaDB做版本升级的用户提供帮助。

# 2.背景介绍 #

## 2.1 服务器资源介绍 ##

<table> 
 <tbody> 
 <tr> 
 <td colspan="2"> 服务器数目：3台 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; CPU </td> 
 <td> &nbsp; 2&nbsp;CORE </td> 
 </tr> 
 <tr> 
 <td> &nbsp; 内存 </td> 
 <td> &nbsp; 4GB </td> 
 </tr> 
 <tr> 
 <td> &nbsp; 磁盘 </td> 
 <td> &nbsp; 1&nbsp;*&nbsp;100GB </td> 
 </tr> 
 <tr> 
 <td> &nbsp; 网卡 </td> 
 <td> &nbsp; 千兆网 </td> 
 </tr> 
 </tbody> 
</table>

## 2.2 操作系统及数据库软件版本 ##

<table> 
 <tbody> 
 <tr> 
 <td> &nbsp; 操作系统 </td> 
 <td> &nbsp; SuSE&nbsp;11&nbsp;SP2 </td> 
 </tr> 
 <tr> 
 <td> &nbsp; SequoiaDB（旧） </td> 
 <td> &nbsp; 1.12.5&nbsp;Enterprise </td> 
 </tr> 
 <tr> 
 <td> &nbsp; SequoiaDB（新） </td> 
 <td> &nbsp; 2.6&nbsp;Enterprise </td> 
 </tr> 
 </tbody> 
</table>

## 2.3 数据集群部署部署架构 ##

![图片1.png][1.png]

# 3.版本升级兼容性说明 #

![Center][]

Sequoiadb不支持版本降级。2.0版本由于lzw算法有调整，以及lob存储结构的调整，与其他版本不兼容，不支持升级到其他版本。

# 4.SequoiaDB支持在线升级原理说明 #

在Sequoiadb集群中，如果部署的环境为所有节点组都是3份数据冗余，那样用户就可以逐一对每台服务器上的数据库版本进行升级。

在线升级的方法如图示：

![图片2.png][2.png]

用户首先选择一台服务器，将其所有的Sequoiadb 进程停止，停止当前机器所有的数据库服务可以参考 sdbstop 命令的使用方式，然后直接使用新版本的数据库安装包覆盖安装老的版本。新版数据库安装完毕后，它会自动将本台机器的所有Sequoiadb 相关进程启动。一旦升级的数据库服务成功启动后，则代表此服务器完成了数据库版本升级。

用户可以通过相同的方式对其余几台服务器进行相同的操作，直至所有服务器都完成了版本升级，并且所有的数据库服务都已经成功启动。

# 5.SequoiaDB版本在线升级步骤 #

##     ##

## 5.1 升级前环境信息收集 ##

用户在开始SequoiaDB集群版本升级之前，应该先对SequoiaDB集群的基本情况有一个大概的了解，并且将数据库的信息收集起来。

检查SequoiaDB数据库的安装路径已经操作系统分配给数据库的系统用户，此步骤建议用户在所有部署了SequoiaDB服务的机器上执行

切换到root权限

su \- root

查看SequoiaDB数据库的安装路径与操作系统分配的用户

cat /etc/default/sequoiadb

以作者的环境举例，打印的内容如下：

NAME=sdbcm

SDBADMIN\_USER=sdbadmin

INSTALL\_DIR=/opt/sequoiadb

MD5=d60fdabd78e05f0ad482b938f1df1d72

通过/etc/default/sequoiadb文件，用户可以快速了解到SequoiaDB的基本情况

用户再通过sdb shell控制台，了解SequoiaDB数据库集群的部署情况

切换到sdbadmin用户

su - sdbadmin

进入sdb shell控制台

/opt/sequoiadb/bin/sdb

连接数据库Coord节点

> db = new Sdb("localhost", 11810)

查看SequoiaDB集群部署情况

> db.list(7)

以作者环境为例，打印内容为（由于篇幅太长，文档里做了省略）：

"Group": \[

"dbpath": "/opt/sequoiadb/database/catalog/11800",

"HostName": "sdb1",

"Service": \[

"Type": 0,

"Name": "11800"

\},

"Type": 1,

"Name": "11801"

\},

"Type": 2,

"Name": "11802"

\},

"Type": 3,

"Name": "11803"

\],

"NodeID": 1

\},

**……**

"HostName": "sdb3",

"dbpath": "/opt/sequoiadb/database/data/11930",

"Service": \[

"Type": 0,

"Name": "11930"

\},

"Type": 1,

"Name": "11931"

\},

"Type": 2,

"Name": "11932"

\],

"NodeID": 1008

\],

"GroupID": 1002,

"GroupName": "group3",

"PrimaryNode": 1008,

"Role": 0,

"Status": 1,

"Version": 4,

"\_id": \{

"$oid": "580c1fc9a378cafcebe4e956"

用户从打印的信息中，基本可以了解到SequoiaDB共使用了多少台服务器，建立了多少个数据组，每个数据组又包含多少个节点，节点的数据存储路径和端口号分别是什么，用户都可以从db.list(7)命令中获取。

作者根据演示环境，整理信息如下：

<table> 
 <tbody> 
 <tr> 
 <td> ReplicaGroup </td> 
 <td colspan="4"> 详细信息 </td> 
 </tr> 
 <tr> 
 <td> 机器名 </td> 
 <td> 端口号 </td> 
 <td> 数据存储路径 </td> 
 <td> 是否为主节点 </td> 
 </tr> 
 <tr> 
 <td> Catalog </td> 
 <td> sdb1 </td> 
 <td> 11800 </td> 
 <td> /opt/sequoiadb/database/catalog/11800 </td> 
 <td> YES </td> 
 </tr> 
 <tr> 
 <td> sdb2 </td> 
 <td> 11800 </td> 
 <td> /opt/sequoiadb/database/catalog/11800 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb3 </td> 
 <td> 11800 </td> 
 <td> /opt/sequoiadb/database/catalog/11800 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> group1 </td> 
 <td> sdb1 </td> 
 <td> 11910 </td> 
 <td> /opt/sequoiadb/database/data/11910 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb2 </td> 
 <td> 11910 </td> 
 <td> /opt/sequoiadb/database/data/11910 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb3 </td> 
 <td> 11910 </td> 
 <td> /opt/sequoiadb/database/data/11910 </td> 
 <td> YES </td> 
 </tr> 
 <tr> 
 <td> group2 </td> 
 <td> sdb1 </td> 
 <td> 11920 </td> 
 <td> /opt/sequoiadb/database/data/11920 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb2 </td> 
 <td> 11920 </td> 
 <td> /opt/sequoiadb/database/data/11920 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb3 </td> 
 <td> 11920 </td> 
 <td> /opt/sequoiadb/database/data/11920 </td> 
 <td> YES </td> 
 </tr> 
 <tr> 
 <td> group3 </td> 
 <td> sdb1 </td> 
 <td> 11930 </td> 
 <td> /opt/sequoiadb/database/data/11930 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb2 </td> 
 <td> 11930 </td> 
 <td> /opt/sequoiadb/database/data/11930 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb3 </td> 
 <td> 11930 </td> 
 <td> /opt/sequoiadb/database/data/11930 </td> 
 <td> YES </td> 
 </tr> 
 <tr> 
 <td> Coord </td> 
 <td> sdb1 </td> 
 <td> 11810 </td> 
 <td> /opt/sequoiadb/database/coord/11810 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb2 </td> 
 <td> 11810 </td> 
 <td> /opt/sequoiadb/database/&nbsp;coord&nbsp;/11810 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> sdb3 </td> 
 <td> 11810 </td> 
 <td> /opt/sequoiadb/database/&nbsp;coord&nbsp;/11810 </td> 
 <td> NO </td> 
 </tr> 
 <tr> 
 <td> OM </td> 
 <td> sdb1 </td> 
 <td> 11780 </td> 
 <td> /opt/sequoiadb/database/om/11780 </td> 
 </tr> 
 </tbody> 
</table>

##     ##

## 5.2 数据库版本升级 ##

升级步骤必须逐台服务器执行，不能够同时在所有服务器上执行升级数据库版本步骤。

作者以升级01服务器为例，详细记录一台服务器上升级SequoiaDB版本的步骤。

切换sdbadmin用户

su - sdbadmin

停止当前服务器的sdbcm服务

/opt/sequoiadb/bin/sdbcmtop

停止当前服务器所有的SequoiaDB服务

/opt/sequoiadb/bin/sdbstop

/opt/sequoiadb/bin/sdbstop -p 11780

检查当前服务器是否所有SequoiaDB服务器停止

/opt/sequoiadb/bin/sdblist -t all -m run

如果还有SequoiaDB服务在运行，执行sdblist命令会在屏幕上打印SequoiaDB正在运行的服务信息，例如

sdbom(11780) (31966)

Total: 1

确认所有的SequoiaDB均停止后，开始对当前服务器升级SequoiaDB版本

切换root权限

su - root

为SequoiaDB执行软件赋予可执行权限

chmod a+x /opt/sequoiadb-2.6-linux\_x86\_64-enterprise-installer.run

执行SequoiaDB新版本安装命令

/opt/sequoiadb-2.6-linux\_x86\_64-enterprise-installer.run

让用户选择安装时的语言，这里选择1，英文

Please select the installation language

\[1\] English - English

\[2\] Simplified Chinese - 简体中文

Please choose an option \[1\] : 1

然后出来一堆license的内容，让用户选择直接忽略选择1，如果希望了解详情选择2查看

License Agreement for Evaluation of Programs

\[1\] Agree The License: For More License's Detail, Please Check The License File After Installation

\[2\] Read The License

Please choose an option \[1\] : 1

让用户选择是否同意本license，这里选择y(YES)

Do you accept this license? \[y/n\]: y

软件检测到本机器已经安装了SequoiaDB，让用户选择是否升级版本，这里选择Y(YES)

An existing installation has been detected in /opt/sequoiadb. Change to upgrade mode? \[Y/n\]: y

安装软件已经准备就绪了，是否继续安装，这里选择Y(YES)

Setup is now ready to begin installing SequoiaDB Server on your computer.

Do you want to continue? \[Y/n\]: Y

然后软件就开始正式安装，会出现以下的内容

Please wait while Setup installs SequoiaDB Server on your computer.

Installing

0% \_\_\_\_\_\_\_\_\_\_\_\_\_\_ 50% \_\_\_\_\_\_\_\_\_\_\_\_\_\_ 100%

Begin to upgrade package ......

\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  check list \*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*

Check: configure file /etc/default/sequoiadb is exists ...... ok

Check: get install directory and user in /etc/default/sequoiadb ...... ok

Check: install dir /opt/sequoiadb is not empty ...... ok

Check: compatibility between version 1.12.5 Enterprise and 2.6 Enterprise ...... ok

Check: disk space is enough ...... ok

Check: user sdbadmin is exist, and get group ......  ok

Check: relevant processes are stoped ...... ok

\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#\#

只要屏幕上出现以下信息，则证明SequoiaDB软件版本升级已经成功了

Setup has finished installing SequoiaDB Server on your computer.

##     ##

## 5.3 SequoiaDB版本升级后检查 ##

在SequoiaDB版本升级后，sdbcm会自动将当前机器的所有SequoiaDB服务启动，用户可以通过sdblist命令查看确认。用户在执行命令前，作者建议用户还是首先切换系统用户

su - sdbadmin

查看SequoiaDB数据库服务启动情况。

/opt/sequoiadb/bin/sdblist -t all -m local

例如作者的环境，打印的内容为：

sequoiadb(11920) (12808) D

sequoiadb(11930) (12811) D

sdbom(11780) (12792)

sequoiadb(11910) (12812) D

sequoiadb(11810) (12805) S

sequoiadb(11800) (12780) C

sdbcm(11790) (12770)

sdbcmd (12768)

Total: 8

如果有存在一些节点没有正常启动，会打印如下信息

sequoiadb(11920) (12808) D

sequoiadb(11930) (12811) D

sdbom(11780) (12792)

sequoiadb(11910) (12812) D

sequoiadb(11810) (-) S

sequoiadb(11800) (12780) C

sdbcm(11790) (12770)

sdbcmd (12768)

Total: 8

显示sequoiadb(11810) (-) S 则说明这个节点是存在于本服务器的，但是该节点并没有启动。

SequoiaDB版本升级后，虽然所有的进程都已经启动，但是用户还需要确认启动的节点已经恢复正常，并且能够正常提供服务。

用户在检查节点是否恢复正常时，只要检查编目节点和数据节点的状态，也就是

sequoiadb(11920) (12808) D

sequoiadb(11930) (12811) D

sequoiadb(11910) (12812) D

sequoiadb(11800) (12780) C

用户进入SequoiaDB Shell

/opt/sequoiadb/bin/sdb

挑选其中一个节点，进行连接检查

> var db = new Sdb("localhost", 11910);

> db.snapshot(6, \{\}, \{"ServiceStatus":null\});

> db.close();

只要snapshot(6)打印的内容\{"ServiceStatus": true\} 等于true，则代表此节点服务已经恢复正常，处于正常运行状态，如果为false，则代表此节点状态还没有恢复，通常情况下，ServiceStatus=false，为节点处于全量同步状态。

重复此动作，检查其余的localhost:11920、localhost:11930、localhost:11800节点状态是否正常。如果有节点状态不正常，就需要耐心等待节点完成数据检查或者数据同步，直至节点状态恢复正常，当前服务器的SequoiaDB版本升级才算结束。

> var db = new Sdb("localhost", 11920);

> db.snapshot(6, \{\}, \{"ServiceStatus":null\});

> db.close();

> var db = new Sdb("localhost", 11920);

> db.snapshot(6, \{\}, \{"ServiceStatus":null\});

> db.close();

> var db = new Sdb("localhost", 11800);

> db.snapshot(6, \{\}, \{"ServiceStatus":null\});

> db.close();

当用户完成当前服务器的SequoiaDB版本升级，则可以在两外一台服务器上执行相同命令，开始SequoiaDB版本升级，直至数据库集群所有的服务器数据库版本升级完毕。

# 6.总结 #

由于SequoiaDB集群部署时，是通过3台服务器互相做数据冗余，从而保证整个数据库集群的数据安全性，并且每台服务器的数据库进程都相互独立，中间没有任何的数据依赖。用户在对数据库版本进行升级时，可以利用这数据冗余3份的特点，通过对整个数据库集群做滚动升级的方式，逐一对各台服务器上的SequoiaDB数据库版本做升级操作，从而完成所有服务器的数据库版本升级。

[产品特性][Link 1]  
[解决方案与案例 ][Link 2]  
[数据库下载 ][Link 3]  
[技术文档 ][Link 4]

微信客服：  
sequoiadb111

![%$(LAXO\}X%1H2\{JOLG640GP.jpg][LAXO_X_1H2_JOLG640GP.jpg]

[74f70a199901550d4ccc836ae9de774c-sz_180174.png_1l_640w.png]: /images/20220609/fad2fffe425b4c3ab8329babe7e56a81.png
[SequoiaDB]: http://product.sequoiadb.com/cn/
[SequoiaDB 1]: http://www.sequoiadb.com/cn/
[1.png]: /images/20220609/01997ea35acf4787ab74cd559bdf6fcf.png
[Center]: /images/20220609/072564c6af194a5aa67137ba9df37f26.png
[2.png]: /images/20220609/216f48d59d314a81b2aa00f642e568d3.png
[Link 1]: http://product.sequoiadb.com/
[Link 2]: http://solution.sequoiadb.com/
[Link 3]: http://download.sequoiadb.com/
[Link 4]: http://doc.sequoiadb.com/
[LAXO_X_1H2_JOLG640GP.jpg]: /images/20220609/c8e512f14c8e4f879669eb747a5a38fe.png