備份網關是一個安裝在數據庫服務器上的客戶端程序，用于實現數據庫從本地備份到DBS上、進行物理備份和恢復操作、以及實現自動下載備份集至自建服務器等功能。本文介紹如何安裝DBS備份網關。
使用場景
服務器備份網關
使用場景 | 場景說明 | 功能說明 |
物理備份 | 物理備份是以數據庫文件為單位進行備份，備份內容包括操作系統上的數據庫文件。 | 備份網關會在數據庫服務器啟動一個進程，用于接收您在DBS控制臺上執行的操作任務和備份計劃配置任務，并對數據庫進行備份和恢復操作。 |
私網備份 | 對于處于私網環境的數據庫，如本地IDC私網數據庫或其他云廠商私網數據庫，DBS無法直接訪問并進行備份。 | 備份網關可以作為一個中間件，主動訪問DBS服務端和云端OSS，解決DBS無法直接訪問私網數據庫的問題。 |
自動下載備份集 | 數據災備（DBS）支持自動下載備份集到本地。 | 備份網關會定期訪問云存儲，將備份集下載到本地，保證數據的安全性和可靠性。 |
您只需要在數據庫服務器上安裝DBS備份網關即可。
堡壘機架構備份網關
公司內部的數據庫處于內網環境中，無法直接連接外部網絡，可以通過在堡壘機上安裝代理網關，然后在數據庫主機中安裝DBS備份網關來進行數據備份。具體操作步驟如下：
步驟 | 說明 |
在堡壘機上安裝代理網關。 代理網關的主要功能是在備份時接收從DBS備份網關所在的數據庫主機發送過來的數據，并將數據轉發至DBS云存儲中（外網）；同時，在進行恢復或下載數據庫時，代理網關也可以接收DBS云存儲發回的數據，并轉發至數據庫主機上。 | |
在數據庫所在服務器上安裝DBS備份網關，且在安裝時，填寫代理網關的IP地址（即堡壘機的內網IP地址）。 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角色?？蓤绦腥缦耂QL命令，或通過圖形化界面進行設置：
SQL命令
ALTER SERVER ROLE [sysadmin] ADD MEMBER [NT AUTHORITY\SYSTEM] GO圖形化界面
說明AliyunDBSAgent默認的啟動賬號為NT AUTHORITY\SYSTEM。
注意事項
若您之前已經安裝過DBS備份網關，并希望進行重新安裝，建議您先卸載原備份網關、刪除備份文件夾
dbs_agent，并清理環境后再進行新的安裝。具體操作，請參見卸載網關。部分舊版本備份網關存在Log4j漏洞，具體請參見【漏洞通告】Apache Log4j2 遠程代碼執行漏洞（CVE-2021-44228/CVE-2021-45046）。建議使用備份網關0.0.129版本以下的用戶盡快升級到最新版本，并為物理備份計劃重新連接備份網關。升級方法，請參見升級備份網關。
安裝方法
DBS備份網關會根據系統環境，自動選擇圖形化或命令行的方式進行安裝，同時您也可以通過無人值守的方式安裝備份網關。
默認會優先選擇圖形化方式進行安裝（例如判斷當前環境是否支持GUI，例如Windows或Linux的GNOME、KDE），僅在不支持GUI的情況下才會使用命令行方式進行安裝。
圖形化安裝方式
登錄數據管理DMS 5.0。
單擊控制臺左上角的
圖標，選擇。說明若您使用的是非極簡模式的控制臺，在頂部菜單欄中，選擇。
單擊頁面右上角的添加備份網關。
復制備份網關安裝命令，在Windows命令行窗口中執行命令。
說明您也可以在控制臺的安裝命令中找到最新的下載鏈接，手動下載。
選擇安裝語言，單擊下一步。
閱讀并接受協議條款，單擊下一步。
選擇DBS備份網關，單擊下一步。
說明本文以安裝DBS備份網關為例，用于連接本機數據。如需連接堡壘機上的數據，請參見添加堡壘機架構備份網關。
選擇安裝路徑，單擊下一步，并單擊確認。
確認備份網關地域，并輸入AccessKey ID和AccessKey Secret信息，單擊下一步。
說明再次確認備份網關地域為數據庫就近所在的地域，如需調整請選擇目標地域。
AccessKey信息以明文方式存放在安裝目錄下的
.\config\dbs-agent.conf中。堡壘機架構需要在數據庫網關地址文本框中輸入堡壘機的內網IP地址，數據庫網關端口默認為9797。更多詳情，請參見添加堡壘機架構備份網關。
確認要安裝的組件包，單擊下一步。
軟件將開始安裝，安裝時間大約為1~5分鐘。
安裝完成后，單擊下一步。
單擊完成，此時備份網關已安裝完成。
在Windows運行窗口中，輸入
services.msc，單擊確定，打開系統的服務管理器。在服務管理器中，確認該服務是否已啟動，如未啟動，請右鍵單擊AliyunDBSAgent，在彈出的列表中選擇啟動。
說明系統將默認啟動備份網關，您也可以在服務管理器中啟動、停止AliyunDBSAgent的服務。
在DBS控制臺，單擊完成安裝。
在備份網關頁面，單擊刷新，可查看到新添加的備份網關。
命令行安裝方式
登錄數據管理DMS 5.0。
單擊控制臺左上角的
圖標，選擇。說明若您使用的是非極簡模式的控制臺，在頂部菜單欄中，選擇。
單擊頁面右上角的添加備份網關。
選擇備份網關所在的網絡類型，并復制備份網關安裝命令，在數據庫服務器上執行安裝命令。
說明公網：通過公網IP訪問DBS。
ECS私網/VPC：通過阿里云專線訪問DBS。
在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]選擇安裝語言。輸入0表示選擇中文，1表示選擇英文。
Select your language 0 [x] chn 1 [ ] eng Input selection: 0輸入1，并閱讀備份網關協議。
Press 1 to continue, 2 to quit, 3 to redisplay 1輸入1，接受網關協議。
Press 1 to accept, 2 to reject, 3 to redisplay 1選擇安裝組件，Y表示安裝備份網關（Agent），N表示安裝代理網關（數據庫網關DG）。本文以安裝備份網關為例，請選擇Y。
─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── 組件選擇 ─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── ----- Agent ----- Enter Y for Yes, N for No: Y DG Not Selected Done!說明本文以安裝DBS備份網關為例，用于連接本機數據。如需連接堡壘機上的數據，請在此步驟輸入
N，系統將切換為數據庫網關（DG），再輸入Y確認組件信息。詳情操作，請參見添加堡壘機架構備份網關。輸入1，繼續安裝。
Press 1 to continue, 2 to quit, 3 to redisplay 1選擇安裝路徑，回車表示默認安裝在默認路徑
/usr/local/aliyun/dbs_agent下。如需安裝于其他路徑下，請手動輸入目標路徑。本文以安裝在默認路徑下為例演示。確認安裝路徑，O表示確認安裝，C表示取消安裝。
目標目錄將創建在 : /usr/local/aliyun/dbs_agent -------------------------------------- Enter O for OK, C to Cancel: O確認備份網關的地域信息，并按回車鍵。
說明再次確認備份網關地域為數據庫就近所在的地域，如需調整請根據提示輸入目標地域對應的數字。
輸入阿里云AccessKey信息。請正確填寫，填寫錯誤會導致安裝失敗。
阿里云AccessKey信息 (請確保該對應賬戶已經授予了AliyunDBSFullAccess和AliyunOSSFullAccess權限) AccessKey ID： [] LTAI5t***************** Access Key Secret： [] YaVXD8*************************（可選）輸入代理網關（數據庫網關DG）信息，適用于堡壘機場景。本教程為非堡壘機架構場景，可回車跳過此步驟。
代理網關信息 (可選，適用于堡壘機場景) 代理網關地址： [] 代理網關端口號： [9797]說明堡壘機架構需要輸入堡壘機的內網IP地址，端口默認為9797。更多操作，請參見添加堡壘機架構備份網關。
輸入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 ]
返回添加備份網關頁面，單擊頁面右下角完成安裝按鈕。
在備份網關頁面，單擊刷新按鈕，可查看到新添加的備份網關。
（可選）您可以在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
無人值守安裝方式
登錄數據管理DMS 5.0。
單擊控制臺左上角的
圖標，選擇。說明若您使用的是非極簡模式的控制臺，在頂部菜單欄中，選擇。
單擊頁面右上角的添加備份網關。
復制軟件的下載路徑，并手動下載至服務器中。
執行如下命令，在指定路徑下安裝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
從官網下載的軟件名稱。
升級備份網關
卸載原備份網關、刪除備份文件夾dbs_agent，并清理環境。方法如下：
Linux系統
登錄Linux系統后，執行
cd /usr/local/aliyun/dbs_agent命令進入默認安裝目錄。在安裝目錄下執行
java -jar Uninstaller/uninstaller.jar -c命令卸載原備份網關。如下圖所示，表示卸載成功。
執行
cd /usr/local/aliyun命令返回上一級目錄。在上級目錄執行
sudo rm -rf dbs_agent命令刪除dbs_agent文件夾。
Windows系統
在Windows系統的程序和功能中卸載AliyunDBSAgent。
手動刪除dbs_agent文件夾。
說明DBS備份網關的默認安裝路徑為
C:\Program Files\aliyun\dbs_agent。
原網關卸載完成后，重新安裝備份網關。如何安裝，請參見安裝方法。
堡壘機代理網關
公司內部的數據庫處于內網環境中，無法直接連接外部網絡，可以通過在堡壘機上安裝代理網關，然后在數據庫主機中安裝DBS備份網關來進行數據備份。具體操作步驟如下：
堡壘機中安裝代理網關
代理網關的主要功能是在備份時接收從DBS備份網關所在的數據庫主機發送過來的數據，并將數據轉發至DBS云存儲中（外網）；同時，在進行恢復或下載數據庫時，代理網關也可以接收DBS云存儲發回的數據，并轉發至數據庫主機上。
安裝代理網關（堡壘機）
本文以在Linux系統的堡壘機上安裝代理網關為例。DBS支持命令行、圖形化等多種安裝方式，更多安裝方式及前提條件與注意事項等信息，請參見添加備份網關。
Windows系統的堡壘機上安裝代理網關的方法，請參見Windows系統的堡壘機。
登錄數據管理DMS 5.0。
單擊控制臺左上角的
圖標，選擇。說明若您使用的是非極簡模式的控制臺，在頂部菜單欄中，選擇。
單擊頁面右上角的添加備份網關。
選擇備份網關所在網絡類型，并復制備份網關安裝命令，在數據庫服務器上執行安裝命令。
說明公網：通過公網IP訪問DBS。
ECS私網/VPC：通過阿里云專線訪問DBS。
在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 16:04:52-- 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 19.9MB/s in 11s 2023-08-25 16:05:03 (21.4 MB/s) - ‘aliyunDBSAgentInstaller.jar’ saved [247955671/247955671]選擇安裝語言。輸入0表示選擇中文，1表示選擇英文。
Select your language 0 [x] chn 1 [ ] eng Input selection: 0輸入1，并閱讀網關協議。
Press 1 to continue, 2 to quit, 3 to redisplay 1輸入1，接受網關協議。
Press 1 to accept, 2 to reject, 3 to redisplay 1選擇安裝組件，Y表示安裝備份網關（Agent），N表示安裝代理網關（數據庫網關DG）。本文以安裝代理網關為例，請選擇N，再輸入Y確認組件信息。
Enter Y for Yes, N for No: N -- DG -- Enter Y for Yes, N for No: Y Done!輸入1，繼續安裝。
Press 1 to continue, 2 to quit, 3 to redisplay 1選擇安裝路徑，回車表示默認安裝在默認路徑
/usr/local/aliyun/dbs_agent下。如需安裝于自定義路徑下，請手動輸入目標路徑，并輸入1進行確認。本文以安裝在自定義目錄
/usr/local/aliyun/daili_dbs_agent下為例演示。選擇安裝路徑 : [/usr/local/aliyun/dbs_agent] /usr/local/aliyun/daili_dbs_agent Press 1 to continue, 2 to quit, 3 to redisplay 1確認安裝組件，輸入1開始安裝。
等待安裝完成即可，安裝時間大約為1~5分鐘。
選擇你要安裝的包 : [x] Pack '代理網關基礎文件' required Done! Press 1 to continue, 2 to quit, 3 to redisplay 1 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── 安裝中 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── ==================== Installation started Platform: linux,version=3.10.0-1XXX.XX.X.el7.x86_64,arch=x64,symbolicName=null,javaVersion=1.8.0_372 [ Starting to unpack ] [ Processing package: 代理網關基礎文件 (1/1) ] Cleaning up the target folder ... [ Unpacking finished ] Installation finished ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── 安裝完成 ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── Installation was successful Application installed on /usr/local/aliyun/daili_dbs_agent [ Writing the uninstaller data ... ] [ Console installation done ]
執行如下命令，確認代理網關是否已安裝成功。
ps aux | grep app_aliyun_proxy如下表示進程正常，代理網關已安裝成功。若出現其他無法解決的報錯，請到DBS客戶咨詢群（釘釘群號：35585947）進行咨詢。
[root@iZbp****** ~]# ps aux | grep app_aliyun_proxy root 1**** 0.0 0.5 7***** 9*** ? Ssl 16:06 0:00 /usr/local/aliyun/daili_dbs_agent/dist/app_aliyun_proxy/app_aliyun_proxy -addr :9797 -logdir /usr/local/aliyun/daili_dbs_agent/logs root 2**** 0.0 0.0 1***** 9** pts/1 S+ 16:08 0:00 grep --color=auto app_aliyun_proxy堡壘機代理網關安裝完成之后，在數據庫主機中安裝備份網關即可進行數據備份，詳情請參見：安裝備份網關。
常見問題
備份SQL Server時，顯示備份賬號權限不足。
解決方案：在備份SQL Server時，需要向NT AUTHORITY\SYSTEM賬號賦予Sysadmin角色。您可以執行如下SQL命令，或通過圖形化界面進行設置：
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漏洞，具體請參見【漏洞通告】Apache Log4j2 遠程代碼執行漏洞（CVE-2021-44228/CVE-2021-45046）。建議使用備份網關0.0.129版本以下的用戶，請盡快升級到最新版本，并為物理備份計劃重新連接備份網關。升級方法，請參見升級備份網關。
本地服務器顯示備份網關已安裝成功，但控制臺的備份網關頁面沒有顯示已安裝好的網關，可能是什么原因？
備份網關可能還未啟動。請參見圖形化安裝方式的步驟5~步驟6啟動已安裝好的備份網關。
確認服務器備份網關安裝地域與控制臺備份網關所在地域是否一致。
請查看您的agent日志中是否出現報錯。例如，AccessKey信息有誤等。
未刷新備份網關列表。請在備份網關頁面，單擊刷新按鈕，查看到新添加的備份網關。
備份網關安裝成功后，控制臺顯示網關離線，可能是什么原因？
備份網關可能還未啟動。請參見圖形化安裝方式的步驟5~步驟6啟動已安裝好的備份網關。
確認服務器備份網關安裝地域與控制臺備份網關所在地域是否一致。
可能由于網絡不通或路由問題導致網關離線。
服務器安裝的JRE或JDK版本可能有誤。請參見本文前提條件訪問官網安裝JRE1.8版本或JDK8u261版本的Java環境。