從指令行安裝代理程式

若要從指令行安裝代理程式：

1. 下載代理程式安裝程式，並將其解壓縮至您要在其中安裝代理程式的電腦。完成下列其中一個步驟：
   • 若要從伺服器下載安裝程式，請按一下頁面右上角的說明圖示 ，再按一下工具。然後，按一下 IBM UrbanCode Deploy 代理程式，並下載和解壓縮該檔案。
   • 若要使用指令行在伺服器上尋找安裝程式，請跳至下列位置，並將該檔案複製到目標電腦：installation_folder/opt/tomcat/webapps/ROOT/tools/ibm-ucd-agent.zip
     註： 如果要透過將檔案解壓縮到 UNIX 檔案系統，將代理程式安裝在 IBM z/OS® 上，則必須將安裝套件中數個文字類型檔案的字元編碼轉換為 IBM-1047 編碼。如果要使用 SMP/E 來安裝代理程式，則不必轉換字元編碼。將安裝檔移至 z/OS 電腦，然後解壓縮這些檔案。如果 z/OS 電腦尚未安裝 unzip 程式，請使用 jar 指令來解壓縮這些檔案。例如，在命令提示字元處鍵入下列文字：

     JAVA_HOME/bin/jar xvf ibm-ucd-agent.zip

     執行 convertFilesForZos.sh Script，以將相關檔案的字元編碼轉換為 IBM-1047 編碼。轉換檔案之後，繼續進行安裝。
     註： 如果要將代理程式安裝在 IBM i 上，則必須透過 IBM Portable Application Solutions Environment for i (PASE for i) Shell 來執行指令。將安裝檔移至 i 系統，然後解壓縮這些檔案。執行 ibmi-compatability-fix.sh Script，以將安裝程式更新為使用 PASE for i Shell。執行 Script 之後，繼續進行安裝。
2. 下載並展開安裝套件之後，請開啟安裝程式目錄。
3. 從此目錄中，執行 install-agent.bat 指令 (Windows) 或 install-agent.sh（UNIX、Linux、Mac OS 或 IBM i）。
   註： 如果將代理程式作為 Windows 服務進行安裝，則使用者帳戶必須具有下列專用權：

   • SE_INCREASE_QUOTA_NAME「調整程序的記憶體配額」
   • SE_ASSIGNPRIMARYTOKEN_NAME「取代程序層次記號」
   • SE_INTERACTIVE_LOGON_NAME「在本端登入」
   IBM UrbanCode Deploy 代理程式安裝程式將顯示，並提示您提供下列資訊。您可以透過按 Enter 鍵來接受預設值（顯示在方括弧內）。如果提供了兩個選項（例如，Y/n），則大寫的選項是預設值。

   Enter the directory where agent should be installed.

   例如，輸入 C:\Program Files\IBM\UCDeploy-agent (Windows) 或 /opt/IBM/ibm-ucd/agent (UNIX)。如果該目錄不存在，請輸入 Y，以指示安裝程式為您建立該目錄。如果輸入現有目錄，則程式將向您提供用於升級代理程式的選項。如需升級的相關資訊，請參閱升級伺服器。

   註： 請勿使用任何 Shell 擴充或縮寫，例如波狀符號字元 (~)。

   Please enter the home directory of the JRE/JDK used to run the agent.

   如果已經安裝了 Java™，則 IBM UrbanCode Deploy 會建議將 Java 位置用作預設值。如果要接受預設值，請按 Enter 鍵。否則，請置換預設值，並輸入正確的路徑。

   Will the agent connect to a agent relay instead of directly to the server?

   預設值為 N。如果指定 Y，則系統會提示您配置下列參數：

   hostname or address of the agent relay the agent will connect to

   輸入代理程式中繼的主機名稱或 IP 位址。請指定您安裝代理程式中繼時使用的值。

   agent communication port for the agent relay

   輸入代理程式用來與代理程式中繼進行 JMS 型通訊的埠。預設值為 7916。

   HTTP proxy port for the agent relay

   輸入代理程式用來與代理程式中繼進行 HTTP 通訊的埠。預設值為 20080。

   Enter the host name or address of the server the agent will connect to.

   預設值為 localhost。如果代理程式正連接至叢集伺服器，請指定負載平衡器的主機名稱。

   Enter the agent communication port for the server

   預設值為 7918。

   Do you want to configure another failover server connection?

   預設值為 N。如果第一個伺服器失敗，則代理程式會連接至失效接手伺服器。

   如果要配置失效接手伺服器，請鍵入 y，然後按 Enter 鍵。

   Enter the hostname or address of the server the agent will connect to.

   預設值為 localhost。

   Enter the agent communication port for the server.

   預設值為 7918。

   Do you want to configure another failover server connection?

   預設值為 N。

   Does the server agent communication use mutual authentication with SSL?

   預設值為 N。

   如果使用交互鑑別，則您必須在伺服器與每一個代理程式或代理程式中繼之間手動交換金鑰。如需這個選項的相關資訊，請參閱配置交互鑑別。

   Enter the name for this agent.

   請輸入唯一名稱。伺服器使用此名稱來識別此代理程式。名稱限制為 256 個字元，且無法變更。

   Enter teams to add this agent to, separated by commas.

   預設值為 None。

   在代理程式第一次連接伺服器時，可以將這些代理程式新增至小組。代理程式在其第一次連接至伺服器時，會被指派給特定的團隊。使用逗點來區隔多個小組；尾端空格將予以忽略。不存在的小組名稱也將予以忽略。

   Do you want to install the Agent as Windows service?

   此參數僅適用於 Windows。預設值為 N。作為服務進行安裝時，IBM UrbanCode Deploy 只擷取 PATH 變數的值。一律使用安裝期間擷取的值，即使您稍後變更這些值，亦是如此。對於最新版本的 Windows，必須以管理者身分執行該指令。