博客 > SequoiaDB 版本在线升级介绍说明

SequoiaDB 版本在线升级介绍说明

 2017-07-07  SequoiaDB

74f70a199901550d4ccc836ae9de774c-sz_180174.png@1l_640w.png

前言

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

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

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

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

 

背景介绍

服务器资源介绍

服务器数目:3

CPU

2 CORE

内存

4GB

磁盘

1 * 100GB

网卡

千兆网

 

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

操作系统

SuSE 11 SP2

SequoiaDB(旧)

1.12.5 Enterprise

SequoiaDB(新)

2.6 Enterprise

 

数据集群部署部署架构


图片1.png 


 

 

SequoiaDB支持在线升级原理说明

 

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

在线升级的方法如图示:

图片2.png

 

用户首先选择一台服务器,将其所有的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)命令中获取。

作者根据演示环境,整理信息如下:

ReplicaGroup

详细信息

机器名

端口号

数据存储路径

是否为主节点

Catalog

sdb1

11800

/opt/sequoiadb/database/catalog/11800

YES

sdb2

11800

/opt/sequoiadb/database/catalog/11800

NO

sdb3

11800

/opt/sequoiadb/database/catalog/11800

NO

group1

sdb1

11910

/opt/sequoiadb/database/data/11910

NO

sdb2

11910

/opt/sequoiadb/database/data/11910

NO

sdb3

11910

/opt/sequoiadb/database/data/11910

YES

group2

sdb1

11920

/opt/sequoiadb/database/data/11920

NO

sdb2

11920

/opt/sequoiadb/database/data/11920

NO

sdb3

11920

/opt/sequoiadb/database/data/11920

YES

group3

sdb1

11930

/opt/sequoiadb/database/data/11930

NO

sdb2

11930

/opt/sequoiadb/database/data/11930

NO

sdb3

11930

/opt/sequoiadb/database/data/11930

YES

Coord

sdb1

11810

/opt/sequoiadb/database/coord/11810

NO

sdb2

11810

/opt/sequoiadb/database/ coord /11810

NO

sdb3

11810

/opt/sequoiadb/database/ coord /11810

NO

OM

sdb1

11780

/opt/sequoiadb/database/om/11780




数据库版本升级

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

作者以升级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数据库版本做升级操作,从而完成所有服务器的数据库版本升级。



%$(LAXO}X%1H2{JOLG640GP.jpg

准备开始体验 SequoiaDB 巨杉数据库?