文档

添加备份网关

DBS备份网关是一个安装在数据库服务器上的客户端程序,用于实现数据库从本地备份到DBS上、进行物理备份和恢复操作、以及实现自动下载备份集至自建服务器等功能。本文介绍如何安装DBS备份网关。

使用场景

使用场景

场景说明

功能说明

物理备份

物理备份是以数据库文件为单位进行备份,备份内容包括操作系统上的数据库文件。

备份网关会在数据库服务器启动一个进程,用于接收您在DBS控制台上执行的操作任务和备份计划配置任务,并对数据库进行备份和恢复操作。

私网备份

对于处于私网环境的数据库,如本地IDC私网数据库或其他云厂商私网数据库,DBS无法直接访问并进行备份。

备份网关可以作为一个中间件,主动访问DBS服务端和云端OSS,解决DBS无法直接访问私网数据库的问题。

自动下载备份集

数据库备份DBS支持自动下载备份集到本地。

备份网关会定期访问云存储,将备份集下载到本地,保证数据的安全性和可靠性。

说明
  • 本文操作仅适用于非堡垒机网络拓扑模型的场景,您只需要在数据库服务器上安装DBS备份网关即可。

  • 对于堡垒机网络拓扑模型的场景,由于数据库主机处于内网环境,需要通过堡垒机代理才能访问外部网络。备份网关需要能够通过堡垒机上的代理网关与外部进行通信,因此您需要安装堡垒机架构的备份网关。具体操作,请参见添加堡垒机架构备份网关

前提条件

  • DBS备份计划的备份方式物理备份。(逻辑备份无需安装备份网关)

  • 请确保已在数据库服务器上安装了Java环境。具体要求如下:

    • Linux服务器:必须安装JRE(Java Runtime Environment)1.8版本,您可以访问官网进行下载、安装。

    • Windows服务器:必须安装JDK(Java SE Development Kit)8u261版本,您可以访问官网进行下载和安装,其他版本会导致备份预检查失败。

    说明

    您可以在命令行窗口中执行java -version命令,确认当前Java版本是否正确。

  • 目标用户已完成如下动作:

    • 已创建AccessKey,并获取AccessKey IDAccessKey Secret信息,用于客户端网关的身份识别及注册上线至DBS控制台。具体操作,请参见创建AccessKey

    • 若用RAM账号(阿里云子账号)进行添加,需要获得AliyunDBSFullAccess和AliyunOSSFullAccess权限,具体操作,请参见为RAM用户授权

      说明
      • 主账号默认在开通DBS服务时已开通以上权限。

      • 添加成功后,当前账号下的所有用户在DBS控制台都可以看到该备份网关。

  • 请确保服务器安装路径的磁盘空间大于1 GB,并具备如下服务器权限:

    • Linux系统:root权限。

    • Windows系统:管理员权限。

  • 在备份SQL Server时,需要向NT AUTHORITY\SYSTEM账号授权Sysadmin角色。可执行如下SQL命令,或通过图形化界面进行设置:

    • SQL命令

      ALTER SERVER ROLE [sysadmin] ADD MEMBER [NT AUTHORITY\SYSTEM]
      GO
    • 图形化界面图形化界面设置

    说明

    AliyunDBSAgent默认的启动账号为NT AUTHORITY\SYSTEM。

注意事项

安装方法

DBS备份网关会根据系统环境,自动选择图形化或命令行的方式进行安装,同时您也可以通过无人值守的方式安装备份网关。

说明

默认会优先选择图形化方式进行安装(例如判断当前环境是否支持GUI,例如Windows或Linux的GNOME、KDE),仅在不支持GUI的情况下才会使用命令行方式进行安装。

图形化安装方式

  1. 登录DBS控制台

  2. 单击左侧导航栏中的备份网关,然后在上方选择目标地域。

    备份地域选择备份网关
    说明

    请就近选择数据库所在的地域进行备份网关的安装。例如您的数据库在华东1(杭州)地域,建议安装华东1(杭州)地域的备份网关。

  3. 单击页面右上角的添加备份网关

  4. 复制备份网关安装命令,在Windows命令行窗口中执行命令。

    执行安装命令
    说明

    您也可以在控制台的安装命令中找到最新的下载链接,手动下载。

    1. 选择安装语言,单击下一步

    2. 阅读并接受协议条款,单击下一步

    3. 选择DBS备份网关,单击下一步

      说明

      本文以安装DBS备份网关为例,用于连接本机数据。如需连接堡垒机上的数据,请参见添加堡垒机架构备份网关

    4. 选择安装路径,单击下一步,并单击确认

    5. 确认备份网关地域,并输入AccessKey IDAccessKey Secret信息,单击下一步

      输入AK信息
      说明
      • 再次确认备份网关地域为数据库就近所在的地域,如需调整请选择目标地域。

      • AccessKey信息以明文方式存放在安装目录下的.\config\dbs-agent.conf中。

      • 堡垒机架构需要在数据库网关地址文本框中输入堡垒机的内网IP地址,数据库网关端口默认为9797。更多详情,请参见添加堡垒机架构备份网关

    6. 确认要安装的组件包,单击下一步

      软件将开始安装,安装时间大约为1~5分钟。

    7. 安装完成后,单击下一步

    8. 单击完成,此时备份网关已安装完成。

  5. 在Windows运行窗口中,输入services.msc,单击确定,打开系统的服务管理器。

  6. 在服务管理器中,确认该服务是否已启动,如未启动,请右键单击AliyunDBSAgent,在弹出的列表中选择启动

    启动备份网关
    说明

    系统将默认启动备份网关,您也可以在服务管理器中启动、停止AliyunDBSAgent的服务。

  7. 在DBS控制台,单击完成安装

    备份网关页面,单击刷新,可查看到新添加的备份网关。

    image.png

命令行安装方式

  1. 登录DBS控制台

  2. 单击左侧导航栏中的备份网关,然后在上方选择目标地域。

    备份地域选择备份网关
    说明

    请就近选择数据库所在的地域进行备份网关的安装。例如您的数据库在华东1(杭州)地域,建议安装华东1(杭州)地域的备份网关。

  3. 单击页面右上角的添加备份网关

  4. 选择备份网关所在的网络类型,并复制备份网关安装命令,在数据库服务器上执行安装命令。

    说明
    • 公网:通过公网IP访问DBS。

    • ECS私网/VPC:通过阿里云专线访问DBS。

    1. 在Linux命令行中,执行安装命令,系统会下载并自动运行安装包。示例如下:

      [root@iZbp****** ~]# wget -O aliyunDBSAgentInstaller.jar https://aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com/installer/0.0.141/aliyunDBSAgentInstaller-0.0.141.jar && sudo java -Dregion=cn-hangzhou -jar aliyunDBSAgentInstaller.jar
      --2023-08-25 15:44:35--  https://aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com/installer/0.0.141/aliyunDBSAgentInstaller-0.0.141.jar
      Resolving aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com (aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com)... 100.XXX.XX.XX, 100.XXX.XX.XX, 100.XXX.XX.XX, ...
      Connecting to aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com (aliyun-dbs.oss-cn-hangzhou-internal.aliyuncs.com)|100.XXX.XX.XX|:443... connected.
      HTTP request sent, awaiting response... 200 OK
      Length: 247955671 (236M) [application/x-java-archive]
      Saving to: ‘aliyunDBSAgentInstaller.jar’
      
      100%[=====================================================================================================================================================================>] 247,955,671 17.4MB/s   in 13s    
      
      2023-08-25 15:44:49 (17.6 MB/s) - ‘aliyunDBSAgentInstaller.jar’ saved [247955671/247955671]
    2. 选择安装语言。输入0表示选择中文,1表示选项英文。

      Select your language
      0  [x] chn
      1  [ ] eng
      Input selection: 
      0
    3. 输入1,并阅读备份网关协议。

      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    4. 输入1,接受网关协议。

      Press 1 to accept, 2 to reject, 3 to redisplay
      1
    5. 选择安装组件,Y表示安装备份网关(Agent),N表示安装代理网关(数据库网关DG)。本文以安装备份网关为例,请选择Y

      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      组件选择
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      
      -----
      Agent
      -----
      Enter Y for Yes, N for No: 
      Y
      DG Not Selected
      Done!
      说明

      本文以安装DBS备份网关为例,用于连接本机数据。如需连接堡垒机上的数据,请在此步骤输入N,系统将切换为数据库网关(DG),再输入Y确认组件信息。详情操作,请参见添加堡垒机架构备份网关

    6. 输入1,继续安装。

      Press 1 to continue, 2 to quit, 3 to redisplay
      1
    7. 选择安装路径,回车表示默认安装在默认路径/usr/local/aliyun/dbs_agent下。如需安装于其他路径下,请手动输入目标路径。本文以安装在默认路径下为例演示。

    8. 确认安装路径,O表示确认安装,C表示取消安装。

      目标目录将创建在 :
      /usr/local/aliyun/dbs_agent
      --------------------------------------
      Enter O for OK, C to Cancel: 
      O
    9. 确认备份网关的地域信息,并按回车键。

      说明

      再次确认备份网关地域为数据库就近所在的地域,如需调整请根据提示输入目标地域对应的数字。

    10. 输入阿里云AccessKey信息。请正确填写,填写错误会导致安装失败。

      阿里云AccessKey信息 (请确保该对应账户已经授予了AliyunDBSFullAccess和AliyunOSSFullAccess权限)
      AccessKey ID: [] 
      LTAI5t*****************
      Access Key Secret: [] 
      YaVXD8*************************
    11. (可选)输入代理网关(数据库网关DG)信息,适用于堡垒机场景。本教程为非堡垒机架构场景,可回车跳过此步骤。

      代理网关信息 (可选,适用于堡垒机场景)
      代理网关地址: [] 
      
      代理网关端口号: [9797] 
      说明

      堡垒机架构需要输入堡垒机的内网IP地址,端口默认为9797。更多操作,请参见添加堡垒机架构备份网关

    12. 输入1,并确认安装组件,继续输入1开始安装。

      等待安装完成即可,安装时间大约为1~5分钟。

      Press 1 to continue, 2 to quit, 3 to redisplay
      1
      
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      选择安装组件
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      
      选择你要安装的包 :
      
        [x] Pack 'DBS备份网关基础文件' required
      Done!
      
      Press 1 to continue, 2 to quit, 3 to redisplay
      1
      
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      安装中
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      
      ====================
      Installation started
      
      Platform: linux,version=3.10.0-1160.XX.X.el7.x86_64,arch=x64,symbolicName=null,javaVersion=1.8.0_372
      [ Starting to unpack ]
      [ Processing package: DBS备份网关基础文件 (1/1) ]
      Cleaning up the target folder ...
      [ Unpacking finished ]
      Installation finished
      
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      安装完成
      ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
      
      Installation was successful
      Application installed on /usr/local/aliyun/dbs_agent
      [ Writing the uninstaller data ... ]
      [ Console installation done ]
  5. 返回添加备份网关页面,单击页面右下角完成安装按钮。

    image.png
  6. 备份网关页面,单击刷新按钮,可查看到新添加的备份网关。

    image.png
  7. (可选)您可以在Linux系统中使用如下命令管理备份网关。

    • 启动备份网关命令:/usr/local/aliyun/dbs_agent/bin/aliyun-dbs-agent.sh start

    • 停止备份网关命令:/usr/local/aliyun/dbs_agent/bin/aliyun-dbs-agent.sh stop

    • 重启备份网关命令:/usr/local/aliyun/dbs_agent/bin/aliyun-dbs-agent.sh restart

    • 卸载备份网关:在安装目录下执行java -jar Uninstaller/uninstaller.jar -c

无人值守安装方式

  1. 登录DBS控制台

  2. 单击左侧导航栏中的备份网关,然后在上方选择目标地域。

    说明

    请就近选择数据库所在的地域进行备份网关的安装。例如您的数据库在华东1(杭州)地域,建议安装华东1(杭州)地域的备份网关。

  3. 单击页面右上角的添加备份网关

  4. 复制软件的下载路径,并手动下载至服务器中。

    image.png
  5. 执行如下命令,在指定路径下安装DBS备份网关。

    java -Dregion=<备份网关所在地域> -DINSTALL_GROUP=<备份组件> -Dakid=<AccessKey ID> -Daksecret=<AccessKey Secret信息> -DINSTALL_PATH=/usr/local/aliyun/dbs_agent -jar aliyunDBSAgentInstaller.jar -options-system -language eng

    参数

    说明

    Dregion

    备份网关所在地域。建议为数据库所在的地域。

    说明

    若不填写,默认为cn-hangzhou(杭州)。

    DINSTALL_GROUP

    安装的组件。取值说明:

    • Agent:DBS备份网关,用于连接本机数据。

    • DG:数据库网关,用于连接堡垒机的数据。

    Dakid

    AccessKey ID。

    Daksecret

    AccessKey Secret信息。

    DINSTALL_PATH

    软件安装路径。

    aliyunDBSAgentInstaller.jar

    从官网下载的软件名称。

升级备份网关

  1. 卸载原备份网关、删除备份文件夹dbs_agent,并清理环境。方法如下:

    Linux系统

    1. 登录Linux系统后,执行cd /usr/local/aliyun/dbs_agent命令进入默认安装目录。

    2. 在安装目录下执行java -jar Uninstaller/uninstaller.jar -c命令卸载原备份网关。如下图表示卸载成功。swss

    3. 执行cd /usr/local/aliyun命令返回上一级目录。

    4. 在上级目录执行sudo rm -rf dbs_agent命令删除dbs_agent文件夹。

    Windows系统

    1. 在Windows系统的程序和功能中卸载AliyunDBSAgent。

    2. 手动删除dbs_agent文件夹。

      说明

      DBS备份网关的默认安装路径为C:\Program Files\aliyun\dbs_agent

  2. 原网关卸载完成后,重新安装备份网关。如何安装,请参见安装方法

常见问题

  • 备份SQL Server时,显示备份账号权限不足。

    解决方案:在备份SQL Server时,需要向NT AUTHORITY\SYSTEM账号赋予Sysadmin角色。您可以执行如下SQL命令,或通过图形化界面进行设置:

    • SQL命令

      ALTER SERVER ROLE [sysadmin] ADD MEMBER [NT AUTHORITY\SYSTEM]
      GO
    • 图形化界面图形化界面设置

  • 备份网关升级或重装后,网关名称是否会发生变化?

    若您的硬件环境(CPU型号/MAC地址)没有发生变更,备份网关名称则不会变化。

  • 物理备份网关开启安全升级。

    解决方案:部分旧版本备份网关存在Log4j漏洞,具体请参见【漏洞通告】Apache Log4j2 远程代码执行漏洞(CVE-2021-44228/CVE-2021-45046)。建议使用备份网关0.0.129版本以下的用户,请尽快升级到最新版本,并为物理备份计划重新连接备份网关。升级方法,请参见升级备份网关

  • 本地服务器显示备份网关已安装成功,但DBS控制台的备份网关页面没有显示已安装好的网关,可能是什么原因?

    • 备份网关可能还未启动。请参见图形化安装方式的步骤5~步骤6启动已安装好的备份网关。

    • 确认服务器备份网关安装地域与DBS控制台备份网关所在地域是否一致。

    • 请查看您的agent日志中是否出现报错。例如,AccessKey信息有误等。

    • 未刷新备份网关列表。请在备份网关页面,单击刷新按钮,可查看到新添加的备份网关。

  • 备份网关安装成功后,DBS控制台显示网关离线,可能是什么原因?

    • 备份网关可能还未启动。请参见图形化安装方式的步骤5~步骤6启动已安装好的备份网关。

    • 确认服务器备份网关安装地域与DBS控制台备份网关所在地域是否一致。

    • 可能由于网络不通或路由问题导致网关离线。

    • 服务器安装的JRE或JDK版本可能有误。请参见本文前提条件访问官网安装JRE1.8版本或JDK8u261版本的Java环境。

  • 本页导读 (1)