ICAgent是云日志服務進行日志采集的工具，運行在需要采集日志的主機中。使用云日志服務在主機采集日志時，需要安裝ICAgent。您可以通過以下操作指導在主機中安裝ICAgent。
前提條件
安裝ICAgent前，請確保本地瀏覽器的時間、時區與主機的時間、時區一致。如果不一致，可能會導致日志上報出錯。
安裝方式說明
ICAgent有兩種安裝方式，請按照您的場景進行選擇。
表 1 安裝方式
| 方式 | 適用場景 |
|---|---|
| 首次安裝 | 該服務器上未安裝過ICAgent。 |
| 繼承安裝（Linux環境支持） | 您有多個服務器需要安裝ICAgent，其中一個服務器已經通過首次安裝方式裝好了ICAgent，對于沒有安裝ICAgent的其他多個服務器，您可以采用該安裝方式。 |
首次安裝（Linux環境）
-
在云日志服務管理控制臺，單擊“主機管理”。
-
在主機管理頁面，單擊右上角“安裝ICAgent”。
-
“安裝系統”選擇“Linux”。
-
“主機類型”選擇“區域內主機”。
-
選擇“安裝方式”。
-
獲取AK/SK，方法請參考：如何獲取服務AK/SK。
請獲取并使用公共用戶賬號的AK/SK，請勿使用個人賬號的AK/SK。
注意請確保公共用戶賬號及其創建的AK/SK不會被刪除或禁用。AK/SK被刪除，會導致安裝的ICAgent無法正常上報數據到LTS。
-
創建IAM委托。
-
-
單擊“復制命令”，復制ICAgent安裝命令。
-
使用PuTTY等遠程登錄工具，以root用戶登錄所在region待安裝ICAgent的服務器，執行ICAgent安裝命令進行安裝，當選擇安裝方式為“獲取AK/SK”時需根據提示輸入已獲取到的AK/SK。
說明當顯示“ICAgent install success”時，表示安裝成功，ICAgent已安裝在了/opt/oss/servicemgr/目錄。安裝成功后，在云日志服務左側導航欄中選擇“主機管理 \> 主機”，查看該服務器中ICAgent的狀態。
如果安裝失敗，請卸載ICAgent后重新安裝，如果還未安裝成功，請聯系技術支持。
首次安裝（Windows環境）
-
在主機管理頁面，單擊右上角“安裝ICAgent”。
-
“安裝系統”選擇“Windows”。
-
主機類型選擇“區域內主機”。
-
下載ICAgent安裝包到Windows服務器。
您可以通過點擊界面提供的ICAgent壓縮包或者下載地址，下載ICAgent安裝包。
-
將ICAgent安裝包存放到目錄（如：C:\ICAgent）并解壓。
-
在文本框中輸入AK/SK，生成ICAgent安裝命令，獲取AK/SK方法請參考：如何獲取服務AK/SK。
說明如果AK/SK過期或者被刪除，可能導致ICAgent狀態顯示異常。請創建新的AK/SK并生成的新的安裝命令，登錄到節點重新安裝即可。
-
單擊“復制命令”，復制ICAgent安裝命令。
-
打開cmd窗口并進入ICAgent安裝包的解壓目錄，執行ICAgent安裝命令進行安裝。
當顯示“Service icagent installed successfully”時，表示安裝成功。
說明如果安裝了第三方殺毒軟件，需要添加ICAgent為信任程序，否則可能導致ICAgent安裝失敗。
如果需要卸載ICAgent，請在ICAgent安裝包解壓目錄下，雙擊執行“_ICAgent安裝包解壓目錄_\\ICProbeAgent\\bin\\manual\\win\\uninstall.bat”腳本，當顯示“icagent removed successfully”時，表示卸載成功。
卸載ICAgent不會刪除對應目錄的文件，請您根據實際情況自行刪除。
查詢ICAgent的狀態，請在ICAgent安裝包解壓目錄下，打開cmd窗口，執行命令“sc query icagent”，狀態為RUNNING，表示ICAgent正在運行中；提示“The specified service does not exist as an installed service”或者“指定的服務未安裝”，表示ICAgent已卸載。
卸載后重新安裝ICAgent，如果一直處于“pending”狀態，可以在任務管理器中結束ICAgent相關進程，然后再次重新安裝ICAgent。
繼承安裝（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下，并在同一個網段中。
批量安裝功能依賴python3.\*版本，如果安裝時提示找不到python請安裝python版本后重試。
前提條件
已收集需要安裝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狀態。
