在 Windows 上安裝主機代理程式

支援的 JDK

主機代理程式需要 Java 8 或 Java 11 執行時期。 建議您使用來自相同主機上受監視 JVM 之相同供應商的 JDK。

支援下列 JDK 執行主機代理程式:

• IBM Semeru 執行時期™ JDK/J9 11 (偏好) ^[2]
• Azul Zulu JDK 8 ^{[2: 1]}
• OpenJDK JDK 8
• AdoptOpenJDK
• Oracle Hotspot JDK 8
• Amazon Corretto JDK 8
• IBM J9 8

重要事項: 請確定系統上的任何使用者都可以使用 JVM。 建議您使用您選擇之 Java 發行套件的最新可用修補程式版本。 主機代理程式需要支援 TLSv1.3 的 JDK (適用於所有現行 JDK 8 和 JDK 11 建置)。 如果您使用不支援高度加密的 JDK 套件，可能會出現類似 "java.lang.RuntimeException: Could not generate DH key pair" 的錯誤。

安裝 JDK

若要啟動主機代理程式，您的 Windows 主機必須具有支援的 JDK。 使用下列其中一個選項來安裝 JDK:

• 安裝主機代理程式之後，請直接將 JDK 放在 <instana-agent-install-dir>/jvm 目錄中，並確定 <instana-agent-install-dir>/jvm/bin/java.exe 檔存在。
• 在您選擇的目錄中安裝 JDK ，並將其路徑設為環境變數 JAVA_HOME。 安裝主機代理程式之後，您也可以使用 instana-agent-install-dir>/bin/setenv.bat 檔案來設定 JAVA_HOME 環境變數。

選用配置

如果您偏好在沒有互動的情況下進行安裝，則可以透過執行下列指令來無聲自動執行代理程式安裝程式:

AgentBootstrap.exe INSTANA_AGENT_ENDPOINT=<your-host> INSTANA_AGENT_ENDPOINT_PORT=<your-port> INSTANA_AGENT_KEY=<your-agent-key> INSTANA_AGENT_MODE=<apm | infrastructure | off> INSTANA_DOWNLOAD_KEY=<your-download-key> /quiet

提示: 在 Instana 使用者介面中， Windows 安裝程式 (自動式) 選項會提供指令完整的參數值，供您複製並執行。

您必須提供 /quiet 參數以防止顯示 GUI ，因此您可以無聲自動執行安裝程序，而無需任何使用者互動。

下列參數必須傳遞至指令:

檢查主機代理程式的狀態

安裝主機代理程式之後，您可以在 Instana 使用者介面中的「代理程式」儀表板上檢查其狀態。 若要顯示「代理程式」儀表板，請在 Instana 使用者介面的資訊看板上按一下 其他 > 代理程式 。

提示: 若要在主機代理程式的長清單中尋找代理程式，您可以將搜尋列與 windows 或其他搜尋字串 (例如 Windows 主機名稱) 搭配使用。

如需主機代理程式作為 Windows 服務的狀態，請檢查 instana-agent-service的 Windows 服務清單。

如果您要解除安裝主機代理程式，請在已安裝主機代理程式的 Windows 主機上執行 Windows 安裝程式，然後選取 解除安裝 選項。

1. 下載 .zip 檔

1. 登入 Instana ，然後按一下 其他 > 代理程式 > 安裝 Instana 代理程式 > Windows。

2. 從 技術 清單中，選取 壓縮保存檔。

3. 選取符合系統架構的保存檔; 64bit、 32bit、 64bit static或 32bit static，然後按一下 下載。

   

4. 將下載的 .zip 檔解壓縮至您選擇的資料夾。

2. 啟動主機代理程式

主機代理程式已預先配置您的帳戶設定。

若要啟動主機代理程式，請執行下列指令:

<instana-agent-install-dir>\bin\start.bat

3. 檢查主機代理程式的狀態

安裝主機代理程式之後，您可以在 Instana 使用者介面中的「代理程式」儀表板上檢查其狀態。 若要顯示「代理程式」儀表板，請在 Instana 使用者介面的資訊看板上按一下 其他 > 代理程式 。

提示: 若要在主機代理程式的長清單中尋找代理程式，您可以將搜尋列與 windows 或其他搜尋字串 (例如 Windows 主機名稱) 搭配使用。

若要檢查 Windows 主機上主機代理程式的狀態，請執行下列指令:

<instana-agent-install-dir>\bin\status.bat

若要停止主機代理程式，請執行下列指令:

<instana-agent-install-dir>\bin\stop.bat

如果您想要解除安裝主機代理程式，請停止代理程式，然後刪除安裝資料夾。

4. 選用項目: 將主機代理程式安裝為 Windows 服務

如果您想要將主機代理程式安裝為 Windows 服務，建議您使用「服務封套」。 如需「服務封套」的相關資訊，請參閱 WinSW。

<service>
 <id>instana-agent</id>
 <name>Instana Agent</name>
 <description>Instana Agent</description>
 <!-- start -->
 <executable>"<instana-agent-install-dir>\bin\karaf.bat"</executable>
 <startargument>daemon</startargument>
 <!-- stop -->
 <stopexecutable>"<instana-agent-install-dir>\bin\karaf.bat"</stopexecutable>
 <stopargument>stop</stopargument>
 <stoptimeout>10sec</stoptimeout>
 <!-- logging -->
 <logpath><instana-agent-install-dir>\data\log</logpath>
 <log mode="roll-by-time">
   <pattern>yyyyMMdd</pattern>
 </log>
</service>

instana-agent.exe install

net start instana-agent-service