前言

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

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

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

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

背景介绍

服务器资源介绍

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

数据集群部署部署架构

SequoiaDB支持在线升级原理说明

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

在线升级的方法如图示：

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

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

SequoiaDB版本在线升级步骤

升级前环境信息收集

用户在开始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)命令中获取。

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

数据库版本升级

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

作者以升级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.

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版本升级，直至数据库集群所有的服务器数据库版本升级完毕。

总结

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