DBS備份網關是一個安裝在資料庫伺服器上的用戶端程式，用於實現資料庫從本地備份到DBS上、進行物理備份和恢複操作、以及實現自動下載備份組至自建伺服器等功能。本文介紹如何安裝DBS備份網關。
使用情境
使用情境 | 情境說明 | 功能說明 |
物理備份 | 物理備份是以資料庫檔案為單位進行備份，備份內容包括作業系統上的資料庫檔案。 | 備份網關會在資料庫伺服器啟動一個進程，用於接收您在DBS控制台上執行的操作任務和備份計劃配置任務，並對資料庫進行備份和恢複操作。 |
私網備份 | 對於處於私網環境的資料庫，如本地IDC私網資料庫或其他雲廠商私網資料庫，DBS無法直接存取並進行備份。 | 備份網關可以作為一個中介軟體，主動訪問DBS服務端和雲端OSS，解決DBS無法直接存取私網資料庫的問題。 |
自動下載備份組 | Database BackupDBS支援自動下載備份組到本地。 | 備份網關會定期訪問雲端儲存，將備份組下載到本地，保證資料的安全性和可靠性。 |
本文操作僅適用於非Bastionhost網路拓撲模型的情境，您只需要在資料庫伺服器上安裝DBS備份網關即可。
對於Bastionhost網路拓撲模型的情境，由於資料庫主機處於內網環境，需要通過Bastionhost代理才能訪問外部網路。備份網關需要能夠通過Bastionhost上的代理網關與外部進行通訊，因此您需要安裝Bastionhost架構的備份網關。具體操作，請參見添加Bastionhost架構備份網關。
前提條件
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的情況下才會使用命令列方式進行安裝。
圖形化安裝方式
登入DBS控制台。
單擊左側導覽列中的備份網關，然後在上方選擇目標地區。
說明請就近選擇資料庫所在的地區進行備份網關的安裝。例如您的資料庫在華東1（杭州）地區，建議安裝華東1（杭州）地區的備份網關。
單擊頁面右上方的添加備份網關。
複本備份網關安裝命令，在Windows命令列視窗中執行命令。
說明您也可以在控制台的安裝命令中找到最新的下載連結，手動下載。
選擇安裝語言，單擊下一步。
閱讀並接受協議條款，單擊下一步。
選擇DBS備份網關，單擊下一步。
說明本文以安裝DBS備份網關為例，用於串連本機資料。如需串連Bastionhost上的資料，請參見添加Bastionhost架構備份網關。
選擇安裝路徑，單擊下一步，並單擊確認。
確認備份網關地區，並輸入AccessKey ID和AccessKey Secret資訊，單擊下一步。
說明再次確認備份網關地區為資料庫就近所在的地區，如需調整請選擇目標地區。
AccessKey資訊以明文方式存放在安裝目錄下的
.\config\dbs-agent.conf中。Bastionhost架構需要在資料庫網關地址文字框中輸入Bastionhost的內網IP地址，資料庫網關連接埠預設為9797。更多詳情，請參見添加Bastionhost架構備份網關。
確認要安裝的組件包，單擊下一步。
軟體將開始安裝，安裝時間大約為1~5分鐘。
安裝完成後，單擊下一步。
單擊完成，此時備份網關已安裝完成。
在Windows運行視窗中，輸入
services.msc，單擊確定，開啟系統的服務管理員。在服務管理員中，確認該服務是否已啟動，如未啟動，請按右鍵AliyunDBSAgent，在彈出的列表中選擇啟動。
說明系統將預設啟動備份網關，您也可以在服務管理員中啟動、停止AliyunDBSAgent的服務。
在DBS控制台，單擊完成安裝。
在備份網關頁面，單擊重新整理，可查看到新添加的備份網關。
命令列安裝方式
登入DBS控制台。
單擊左側導覽列中的備份網關，然後在上方選擇目標地區。
說明請就近選擇資料庫所在的地區進行備份網關的安裝。例如您的資料庫在華東1（杭州）地區，建議安裝華東1（杭州）地區的備份網關。
單擊頁面右上方的添加備份網關。
選擇備份網關所在的網路類型，並複本備份網關安裝命令，在資料庫伺服器上執行安裝命令。
說明公網：通過公網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備份網關為例，用於串連本機資料。如需串連Bastionhost上的資料，請在此步驟輸入
N，系統將切換為資料庫網關（DG），再輸入Y確認組件資訊。詳情操作，請參見添加Bastionhost架構備份網關。輸入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）資訊，適用於Bastionhost情境。本教程為非Bastionhost架構情境，可斷行符號跳過此步驟。
代理網關資訊 (可選，適用於Bastionhost情境) 代理網關地址： [] 代理網關連接埠號碼： [9797]說明Bastionhost架構需要輸入Bastionhost的內網IP地址，連接埠預設為9797。更多操作，請參見添加Bastionhost架構備份網關。
輸入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
無人值守安裝方式
登入DBS控制台。
單擊左側導覽列中的備份網關，然後在上方選擇目標地區。
說明請就近選擇資料庫所在的地區進行備份網關的安裝。例如您的資料庫在華東1（杭州）地區，建議安裝華東1（杭州）地區的備份網關。
單擊頁面右上方的添加備份網關。
複製軟體的下載路徑，並手動下載至伺服器中。
執行如下命令，在指定路徑下安裝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：資料庫網關，用於串連Bastionhost的資料。
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。
原網關卸載完成後，重新安裝備份網關。如何安裝，請參見安裝方法。