ICAgent是云日志服務進行日志采集的工具，運行在需要采集日志的服務器中。使用云日志服務在區域外主機采集日志時，需要安裝ICAgent。您可以通過以下操作指導在區域外主機中安裝ICAgent。
前提條件
安裝ICAgent前，請確保本地瀏覽器的時間、時區與主機的時間、時區一致。如果不一致，可能會導致日志上報出錯。
安裝方式說明
ICAgent有兩種安裝方式，請按照您的場景進行選擇。
表 1 安裝方式
| 方式 | 適用場景 |
|---|---|
| 首次安裝 | 該服務器上未安裝過ICAgent。 |
| 繼承安裝（Linux環境支持） | 您有多個服務器需要安裝ICAgent，其中一個服務器已經通過首次安裝方式裝好了ICAgent，對于沒有安裝ICAgent的其他多個服務器，您可以采用該安裝方式。 |
首次安裝（Linux環境）
非本區域的服務器安裝ICAgent，請先在彈性云主機控制臺購買一臺彈性云主機作為跳板機，具體操作請參考購買ELB和多主機作為跳板機，然后執行如下操作：
說明推薦CentOS 6.5 64bit及其以上版本的鏡像， 最低規格為1vCPUs | 1GB，推薦規格為2vCPUs | 4GB。
-
在當前region區購買一臺ECS主機當跳板機，修改跳板機ECS使用的安全組規則。
-
在ECS詳情頁，單擊安全組頁簽，進入安全組列表頁。
-
單擊具體的安全組名，單擊“更改安全組規則”，進入安全組詳情頁。
-
在該安全組詳情頁，單擊“入方向規則 > 添加規則 ”，按表2添加安全組規則。
表 2 安全組規則
方向 協議 端口 說明 入方向 TCP 8149、8102、8923、30200、30201、80 ICAgent發送數據到跳板機的端口列表。 說明將安全組的入方向端口8149、8102、8923、30200、30201、80開啟，保證非本區域的VM到跳板機ECS的數據連通性。
-
-
在云日志服務管理控制臺，單擊“主機管理”。
-
在主機管理頁面，單擊右上角“安裝ICAgent”。
-
“安裝系統”選擇“Linux”。
-
“主機類型”選擇“區域外主機”。
-
在跳板機上開通轉發端口。
- 輸入跳板機私有IP，生成跳板機轉發命令。
說明跳板機私有IP是指VPC內網IP。
-
單擊“復制命令”，復制跳板機轉發命令。
-
以root用戶登錄跳板機，執行SSH Tunnel轉發命令。
ssh -f -N -L {跳板機ip}:8149:{elbip}:8149 -L {跳板機ip}:8102:{elbip}:8102 -L {跳板機ip}:8923:{elbip}:8923 -L {跳板機ip}:30200:{elbip}:30200 -L {跳板機ip}:30201:{elbip}:30201 -L {跳板機ip}:80:icagent-{region}.obs.{region}.daliqc.cn:80 {跳板機ip}根據命令提示輸入root用戶密碼即可。
-
執行netstat -lnp | grep ssh命令查看對應端口是否被偵聽。
說明在瀏覽器地址欄里輸入“//跳板機ECS的IP地址”。如果訪問成功，說明安全組規則已經生效。
如果跳板機ECS掉電重啟，請重新執行如上命令。
-
獲取AK/SK，填寫DC和跳板機連接IP。
說明DC：自定義節點所屬數據中心名稱，便于分類查看主機。
跳板機連接IP：使用EIP方式連接，為跳板機彈性公網IP，使用云專線VPC對等連接方式，為跳板機VPC內網IP。
-
復制ICAgent安裝命令。
-
使用PuTTY等遠程登錄工具，以root用戶登錄所在region待安裝ICAgent的服務器，執行ICAgent安裝命令進行安裝。
說明當顯示“ICAgent install success”時，表示安裝成功，ICAgent已安裝在了/opt/oss/servicemgr/目錄。安裝成功后，在云日志服務左側導航欄中選擇“主機管理 \> 主機”，查看該服務器中ICAgent的狀態。
如果安裝失敗，請卸載ICAgent后重新安裝，如果還未安裝成功，請聯系技術支持。
首次安裝（Windows環境）
非本區域的服務器安裝ICAgent，請先在彈性云主機控制臺購買一臺Linux操作系統的彈性云主機作為跳板機，具體操作請參考購買ELB和多主機作為跳板機，然后執行如下操作：
說明推薦CentOS 6.5 64bit及其以上版本的鏡像， 最低規格為1vCPUs | 1GB，推薦規格為2vCPUs | 4GB。
-
在當前region區購買一臺Linux操作系統的ECS主機當跳板機，修改跳板機ECS使用的安全組規則。
-
在ECS詳情頁，單擊安全組頁簽，進入安全組列表頁。
-
單擊具體的安全組名，單擊“更改安全組規則”，進入安全組詳情頁。
-
在該安全組詳情頁，單擊“入方向規則 > 添加規則 ”，按[表3]添加安全組規則。
表 3 安全組規則
方向 協議 端口 說明 入方向 TCP 8149、8102、8923、30200、30201、80 ICAgent發送數據到跳板機的端口列表。 說明將安全組的入方向端口8149、8102、8923、30200、30201、80開啟，保證非本區域的VM到跳板機ECS的數據連通性。
-
-
在云日志服務管理控制臺，單擊“主機管理”。
-
在主機管理頁面，單擊右上角“安裝ICAgent”。
-
“安裝系統”選擇“Windows”。
-
主機類型選擇“區域外主機”。
-
在跳板機上開通轉發端口。
-
輸入跳板機私有IP，生成跳板機轉發命令。
說明跳板機私有IP是指VPC內網IP。
-
單擊“復制命令”，復制跳板機轉發命令。
-
以root用戶登錄跳板機，執行SSH Tunnel轉發命令。
ssh -f -N -L {跳板機ip}:8149:{elbip}:8149 -L {跳板機ip}:8102:{elbip}:8102 -L {跳板機ip}:8923:{elbip}:8923 -L {跳板機ip}:30200:{elbip}:30200 -L {跳板機ip}:30201:{elbip}:30201 -L {跳板機ip}:80:icagent-{region}.obs.{region}.daliqc.cn:80 {跳板機ip}根據命令提示輸入root用戶密碼即可。
-
執行netstat -lnp | grep ssh命令查看對應端口是否被偵聽。
說明在瀏覽器地址欄里輸入“//跳板機ECS的IP地址”。如果訪問成功，說明安全組規則已經生效。
如果跳板機ECS掉電重啟，請重新執行如上命令。
-
-
通過界面提示鏈接，下載ICAgent安裝包。
-
將ICAgent安裝包存放到Windows主機目錄（如：C:\ICAgent）并解壓。
-
獲取AK/SK。
-
生成安裝命令，并復制該命令。
-
在文本框中跳板機連接IP，手動替換AK/SK，生成安裝命令。
說明跳板機連接IP：使用EIP方式連接，為跳板機彈性公網IP，使用云專線VPC對等連接方式，為跳板機VPC內網IP。
-
單擊“復制命令”，復制ICAgent安裝命令。
-
-
打開cmd窗口并進入ICAgent安裝包的解壓目錄，執行ICAgent安裝命令進行安裝。
說明當顯示“Service icagent installed successfully”時，表示安裝成功。安裝成功后，在左側導航欄中選擇“主機管理 \> 主機”，查看ICAgent狀態。
如果安裝失敗，請卸載ICAgent后重新安裝，如果還未安裝成功，請聯系技術支持。
購買ELB和多主機作為跳板機
如果單跳板機有單點故障的風險，可以按照該方式提高接入的可靠性。
-
創建跳板機彈性云主機的Linux操作系統。
說明根據業務規格配置CPU、內存，推薦規格為2vCPUs | 4GB以上。
-
以root用戶登錄跳板機，使用該跳板機的內部IP，創建ssh通道。
- 在彈性云主機管理控制臺找到已創建的機器，獲取私有IP。
- 在云日志管理控制臺，依次單擊“主機管理 > 安裝ICAgent”，進入安裝ICAgent頁面。選擇對應的操作系統，再選擇主機類型為“區域外主機”，并填入私有IP，生成安裝口令，登錄跳板機，創建ssh通道。
-
如果有多個跳板機，重復[2]，并且將多個跳板機放入同一個VPC中。在創建彈性云主機，網絡配置時，選擇同一個虛擬私有云。
-
創建ELB。在創建時需注意以下幾點。
- 創建ELB時選擇與跳板機ECS相同的VPC。
- 新建彈性公網IP，作為跳板機連接IP。
- 帶寬根據業務量購買，并進行適配。
-
分別為TCP的端口30200、30201、8149、8923、8102添加監聽器。
-
為后端服務器組添加所有跳板機。
繼承安裝（Linux環境）
您有多個服務器需要安裝ICAgent，其中一個服務器已經通過首次安裝方式裝好了ICAgent，且該服務器“/opt/ICAgent/“路徑下存在ICAgent的安裝包ICProbeAgent.tar.gz，對于沒有安裝ICAgent的服務器，可以通過該方式對服務器進行一鍵式繼承安裝。
-
在已安裝ICAgent的服務器上執行如下命令，其中_x.x.x.x_表示待安裝ICAgent服務器的IP地址。
bash /opt/oss/servicemgr/ICAgent/bin/remoteInstall/remote_install.sh -ip x.x.x.x
-
根據提示輸入待安裝ICAgent的服務器root用戶密碼。
說明如果已安裝ICAgent的服務器安裝過expect工具，執行上述命令后，即可完成安裝。如果已安裝ICAgent的服務器未安裝expect工具，請根據提示輸入密碼，進行安裝。
請確保已安裝ICAgent的服務器可以使用root用戶執行SSH、SCP命令，來與待安裝ICAgent的服務器進行遠端通信。
當顯示“ICAgent install success”時，表示安裝成功，ICAgent已安裝在了/opt/oss/servicemgr/目錄。安裝成功后，在云日志服務左側導航欄中選擇主機管理 \> 主機”，查看該服務器ICAgent的狀態。
如果安裝失敗，請卸載ICAgent后重新安裝，如果還未安裝成功，請聯系技術支持。
繼承批量安裝（Linux環境）
您有多個服務器需要安裝ICAgent，其中一個服務器已經通過首次安裝方式裝好了ICAgent，且該服務器“/opt/ICAgent/“路徑下存在ICAgent的安裝包ICProbeAgent.tar.gz，對于沒有安裝ICAgent的服務器，可以通過該方式對服務器進行一鍵式繼承批量安裝。
注意批量安裝的服務器需同屬一個VPC下，并在同一個網段中。
前提條件
已收集需要安裝Agent的所有服務器的IP地址、密碼，按照iplist.cfg格式整理好，并上傳到已安裝過ICAgent機器的/opt/ICAgent/目錄下。iplist.cfg格式示例如下所示，IP地址與密碼之間用空格隔開：
192.168.0.109 密碼（請根據實際填寫）
192.168.0.39 密碼（請根據實際填寫）
說明
iplist.cfg中包含您的敏感信息，建議您使用完之后進行清理。
如果所有服務器的密碼一致，iplist.cfg中只需列出IP，無需填寫密碼，在執行時輸入此密碼即可；如果某個IP密碼與其他不一致，則需在此IP后填寫其密碼。
操作步驟
-
在已安裝ICAgent的服務器上執行如下命令。
bash /opt/oss/servicemgr/ICAgent/bin/remoteInstall/remote_install.sh -batchModeConfig /opt/ICAgent/iplist.cfg
根據腳本提示輸入待安裝機器的root用戶默認密碼，如果所有IP的密碼在iplist.cfg中已有配置，則直接輸入回車鍵跳過即可，否則請輸入默認密碼。
batch install begin Please input default passwd: send cmd to 192.168.0.109 send cmd to 192.168.0.39 2 tasks running, please wait... 2 tasks running, please wait... 2 tasks running, please wait... End of install agent: 192.168.0.39 End of install agent: 192.168.0.109 All hosts install icagent finish.請耐心等待，當提示All hosts install icagent finish.時，則表示配置文件中的所有主機安裝操作已完成。
-
安裝完成后，在云日志服務左側導航欄中選擇“主機管理 > 主機”，查看服務器的ICAgent狀態。
