全部产品
Search

搜索本产品

    数据库备份 DBS：添加备份网关

    文档中心

    数据库备份 DBS：添加备份网关

    更新时间：Aug 07, 2024

    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 ID和AccessKey Secret信息，用于客户端网关的身份识别及注册上线至DBS控制台。具体操作，请参见创建AccessKey。

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

        说明

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

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

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

      • Linux系统：root权限。

      • Windows系统：管理员权限。

    • 在备份SQL Server时，需要向NT AUTHORITY\SYSTEM账号授权Sysadmin角色。可执行如下SQL命令进行设置：

      ALTER SERVER ROLE [sysadmin] ADD MEMBER [NT AUTHORITY\SYSTEM]
GO
      说明

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

    注意事项

    • 若您之前已经安装过DBS备份网关，并希望进行重新安装，建议您先卸载原备份网关、删除备份文件夹dbs_agent，并清理环境后再进行新的安装。具体操作，请参见卸载网关。

    • 部分旧版本备份网关存在Log4j漏洞，具体请参见阿里云产品关于 Log4j2漏洞（CVE-2021-44228）的影响声明。建议使用备份网关0.0.129版本以下的用户尽快升级到最新版本，并为物理备份计划重新连接备份网关。升级方法，请参见升级备份网关。

    安装方法

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

    说明

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

    图形化安装方式

    1. 登录DBS控制台。

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

      备份地域选择备份网关

      说明

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

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

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

      执行安装命令

      说明

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

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

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

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

        说明

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

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

      5. 确认备份网关地域，并输入AccessKey ID和AccessKey Secret信息，单击下一步。

        说明

        • 再次确认备份网关地域为数据库就近所在的地域，如需调整请选择目标地域。

        • 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命令进行设置：

      ALTER SERVER ROLE [sysadmin] ADD MEMBER [NT AUTHORITY\SYSTEM]
GO

    • 备份网关升级或重装后，网关名称和网关创建时间是否会发生变化？更换操作系统之后网关名称和网关创建时间是否会发生变化？

      • 若您的硬件环境（CPU型号/MAC地址）没有发生变更，备份网关升级或者重装，备份网关名称和创建时间不会变化。

      • 若您更换操作系统，备份网关名称和创建时间将会发生变化。

        说明

        例如将CentOS 7.9系统更换为Alibaba Cloud Linux 3.2104 LTS系统，备份网关名称和创建时间则会发生变化。

      • 若您重装操作系统（重装前和重装后的操作系统相同），备份网关名称和创建时间不会发生变化。

        说明

        例如将CentOS 7.9系统重装为CentOS 8.5系统，备份网关名称和创建时间不会发生变化。

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

      解决方案：部分旧版本备份网关存在Log4j漏洞，具体请参见阿里云产品关于 Log4j2漏洞（CVE-2021-44228）的影响声明。建议使用备份网关0.0.129版本以下的用户，请尽快升级到最新版本，并为物理备份计划重新连接备份网关。升级方法，请参见升级备份网关。

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

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

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

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

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

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

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

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

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

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