在 Linux 系統上的安裝前作業

您必須先完成必要的預先安裝作業，然後才能在 Linux 系統上安裝代理程式。 部分預先安裝作業是代理程式特定的，而其他作業適用於多個代理程式。

註： 這些需求是對「系統產品相容性報告」中所指示需求的補充。
如需代理程式的現行版本需求及相依關係，請參閱 系統需求 (APM Developer Center)，以取得指向「系統產品相容性報告」的鏈結。

所有代理程式

下列預先安裝作業適用於所有代理程式：

測試連線
在安裝代理程式之前，請確保您的系統可以與 Cloud APM 伺服器 通訊。如需檢查與 Cloud APM 伺服器 連線的相關資訊，請參閱網路連線。
非 root 使用者安裝
您必須具有安裝目錄的讀取、寫入及執行許可權。 否則，會取消安裝。 如需非 root 使用者安裝的相關資訊，請參閱以非 root 使用者身分安裝代理程式。
安裝路徑的 70 字元限制
安裝目錄及其路徑不得超過 70 個字元。
設定 CANDLEHOME 環境變數
如果您之前已使用「ITM Agent Converter」在相同的受管理系統上安裝及配置代理程式，則 CANDLEHOME 環境變數已變更成已使用「Agent Converter」安裝代理程式的目錄。 您必須先將 CANDLEHOME 環境變數設為不同的目錄，再安裝及配置原生 Cloud APM 代理程式，否則無法啟動原生 Cloud APM 代理程式。

特定的作業系統

Red Hat Enterprise Linux (RHEL) 8
在 RHEL 8 上需要 libnsl.so.1 套件
依預設，在 Red Hat Enterprise Linux 8.0 版中不會安裝 libnsl.so.1。如果沒有此套件，則無法順利安裝任何代理程式。請管理者為您設定儲存庫，然後執行下列指令：
yum install libnsl
在成功安裝之後，您可以查看 /usr/lib64/libnsl.so.1。
註： 只有代理程式才需要 libnsl.so.1 套件。您不需要對資料收集器執行此步驟。
針對部分代理程式略過必要條件掃描器
在必要條件掃描器更新為與最新需求相容之前，對於部分代理程式，您可以略過必要條件掃描器。如需適當的實務範例及指示，請參閱略過必要條件掃描器。
註： 您不需要對資料收集器執行此步驟。

特定的代理程式

下列預先安裝作業適用於指定的代理程式：

DataPower® 代理程式
您必須執行 ulimit -d unlimited 指令來確保 max data segment size 系統環境變數已設為 unlimited。 此代理程式無法安裝在您要監視之 DataPower 應用裝置所在的機器上。
DataStage® 代理程式
  1. 在 DSODBConfig.cfg 檔中啟用參數。 請完成下列步驟：
    1. 在編輯器中的下列位置開啟 DSODBConfig.cfg 檔：
      • infosphere_information_server_install_dir/Server/DSODB
    2. 透過移除 # 符號，解除註解下列參數：
      • MonitorLinks=1
      • JobRunUsage=1
      • ResourceMonitor=1
      • DSODBON=1
    3. 將這些參數的值編輯為等於 1。
  2. 複製用於代理程式電腦上 meta 資料儲存庫配置的資料庫 JDBC 驅動程式。
    1. 類型 4 JDBC 4 或者更新版本。 範例：db2jcc4.jar
    2. 適用於 Oracle 的類型 4 JDBC 驅動程式。 範例：ojdbc6.jar
    3. 適用於 MS SQ 的 JDBC 驅動程式：
      • Sqljdbc41.jar 需要 JRE 7 且支援 JDBC 4.1 API。
      • Sqljdbc42.jar 需要 JRE 8 且支援 JDBC 4.2 API。
HTTP Server 代理程式
如果以 root 使用者身分來安裝這個代理程式，則必須使用同一使用者 ID 來執行及配置該代理程式。
如果您以非 root 使用者身分安裝並執行代理程式，則非 root 使用者必須具有與啟動 IBM® HTTP 伺服器之使用者相同的使用者 ID。 否則，此代理程式在探索 IBM HTTP 伺服器 時會遇到問題。 可使用相同的使用者 ID 來執行及配置代理程式。
Linux KVM 代理程式
Monitoring Agent for Linux KVM 是一個多重實例暨多重連線代理程式，它支援連接到 Enterprise Linux 型 KVM Hypervisor 和 Red Hat Enterprise Virtualization Manager (RHEV-M) 環境。您可以建立此代理程式的多個實例，用來監視 RHEV-M 或 KVM Hypervisor 環境中的多個 Hypervisor。您還可以在不同的虛擬機器之間監視虛擬化工作量並分析資源容量。若要將代理程式連接到 KVM Hypervisor 環境中的虛擬機器，則必須安裝必備項目：libvirt*.rpm 和 Korn Shell 直譯器 (pdksh)。此代理程式會透過遠端連接至管理虛擬機器的 libvirt Hypervisor 來收集度量值。
Microsoft SQL Server 代理程式
若要監視 Microsoft SQL 環境，必須先安裝 Microsoft SQL Server 及 Microsoft SQL ODBC 驅動程式，然後再安裝 Monitoring Agent for Microsoft SQL Server。例如，若要在 Red Hat Enterprise Linux 上安裝 ODBC 驅動程式，請使用下列指令：
sudo yum install unixODBC
sudo yum install msodbcsql17
若要完成執行必要條件檢查程式，需要在 Cloud Application Performance Management 8.1.4.0 版 Server Interim Fix 15 (8.1.4.0-IBM-APM-SERVER-IF0015.tar) 或更新版本上配置代理程式。
MongoDB 代理程式
您必須在 MongoDB 資料庫伺服器安裝所在的系統上安裝及配置 MongoDB 代理程式。
MySQL 代理程式
若要監視 MySQL 環境，必須先安裝 MySQL 伺服器及 MySQL JDBC 驅動程式，然後再安裝 Monitoring Agent for MySQL。 例如，若要在 Red Hat Enterprise Linux 上安裝 JDBC 驅動程式，請使用下列指令：
yum install mysql-connector-java
在您安裝代理程式之後與必備項目檢查 MySQL 包裝名稱的期間，若您使用的提供者並不是 Red Hat 而是 Oracle 之類的話，可能會出現警告。 若「MySQL 伺服器」及 JDBC 驅動程式是可用的，該警告並不會造成安裝失敗，您可以不處理這個訊息。 範例輸出： 
Scenario: Prerequisite Scan
KSE - Monitoring Agent for MySQL Prerequisite Checker [version 01000005]:
Property                               Result   Found                                     Expected 
========                      ====== =====       ======== 
os.package.mysql-server         WARN  Unavailable  mysql-server-5.1.12+
os.package.mysql-connector-java WARN Unavailable mysql-connector-java-5.
1.12+
Node.js 代理程式
您用來執行受監視的應用程式的 Node.js 版本必須與預設安裝的版本相同。
目前不支援 Node.js 第 5 版。
OpenStack 代理程式
在可以使用 OpenStack 代理程式之前，必須先將下列軟體安裝到代理程式安裝所在的伺服器上：
  • Python 2.6.0 或更新版本，或者 Python 2.7.0 或更新版本
  • 最新 OpenStack 用戶端：
    • OpenStack
    • Keystone
    • Neutron
    • Swift

    若要安裝 OpenStack 指令行用戶端，請參閱安裝 OpenStack 指令行用戶端。

  • Python 用於遠端存取的 Paramiko 程式庫。
    註： 如果您想要在全新的 RedHat Linux 伺服器上安裝 OpenStack 代理程式，則請在安裝 Paramiko 程式庫之前，執行下列指令來安裝必要的軟體： 
    wget https://ftp.dlitz.net/pub/dlitz/crypto/pycrypto/pycrypto-2.6.1.tar.gz
yum install gcc/openssl-devel/libffi-devel
  • KornShell
Oracle Database 代理程式
在 Red Hat Enterprise Linux 第 5 版和第 6 版以及 SUSE Linux Enterprise Server 第 11 版和第 12 版 x64 上，如果 Oracle Database 代理程式遠端監視 Oracle 資料庫，則您必須先安裝 Oracle 即時用戶端。 請安裝 Oracle Technology Network - 即時用戶端下載 處提供的 Oracle 即時用戶端。
Oracle Database 代理程式 支援即時用戶端 10.x 版、11.x 版及 12.x 版。
PHP 代理程式
如果使用 root 使用者身分來部署 PHP 應用程式，您必須使用 root 使用者身分來安裝、配置、啟動或停止代理程式。 如果是使用非 root 使用者身分來部署 PHP 應用程式，您可以使用 root 使用者身分或相同的非 root 使用者身分來安裝、配置、啟動或停止代理程式。
您必須已安裝現有的 WordPress 應用程式。 PHP 代理程式會監視 WordPress 3.7.1 版或更新版本。
代理程式只會評估 WordPress 應用程式中 PHP 要求的效能。 不會評估 CSS 及 JS 載入。
代理程式不會使用 URL 引數來識別 URL。
Python 資料收集器
Python 資料收集器 會監視 Django 應用程式。
Response Time Monitoring Agent

在安裝 Response Time Monitoring 代理程式 之前，請檢查這裡的安裝規劃區段：規劃安裝。

SAP HANA Database 代理程式
  1. 在 Linux 系統上安裝 SAP HANA 資料庫用戶端 HDBSQL 1.00.102.06 版或更新版本。
    重要： 若為 RHEL 5.x 64 位元作業系統，請安裝 Linux SUSE 9 on x86_64 64bit SAP HANA 資料庫用戶端，而不是 Linux on x86_64 64bit。 若為 RHEL 6.x 或更新版本的 64 位元作業系統，請安裝 Linux on x86_64 64bit SAP HANA 資料庫用戶端。
  2. 執行下列指令，以將安裝目錄的路徑新增至 LD_LIBRARY_PATH 環境變數：

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:install_directory_path

    範例：export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/sap/hdbclient，其中 /usr/sap/hdbclient 表示 SAP HANA 資料庫用戶端的安裝路徑。

重要：

如果 SAP HANA 資料庫用戶端的安裝路徑未新增至 LD_LIBRARY_PATH 環境變數，則必備項目掃描器會傳回 FAIL 結果

您利用匯出指令新增的環境變數只會針對終端機的特定階段作業持續保存。 因此，請確保您執行代理程式安裝 Script 所在的終端機，是之前用於新增環境變數的終端機。

Synthetic Playback 代理程式
若要安裝 Synthetic Playback 代理程式，作業系統使用者需要下列許可權：
  • 啟用安裝映像檔的讀取及執行權限。
  • 啟用代理程式首頁的寫入權
若要執行 Synthetic Playback 代理程式，作業系統使用者需要下列許可權：
  • 啟用代理程式安裝位置及其子目錄與檔案的讀取、寫入及執行權限。
  • 啟用執行 Mozilla Firefox 的許可權。
  • 確保 Mozilla Firefox 執行二進位檔位於使用者設定檔的 PATH 環境變數中。
安裝 Synthetic Playback 代理程式 之前，必須完成下列步驟：
  1. 使用 Cloud APM 主控台來同步化代理程式安裝位置。
  2. 安裝 Mozilla Firefox 及 Xvfb 顯示伺服器。
  3. 驗證 Xvfb 顯示伺服器是否在工作中。 執行下列指令：
    # Xvfb -ac

    不應產生錯誤輸出。

  4. 檢查 Xvfb 處理程序是否在執行中。 執行下列指令： 
    # ps -ef|grep Xvfb

    範例輸出：

    root 7192 1 0 Jan14 ? 00:00:14 Xvfb -ac
root 20393 17900 0 02:05 pts/0 00:00:00 grep -i xvfb
  5. 停止 Xvfb 處理程序。 執行下列指令：
    # kill -9 7192
  6. 導覽至 install_dir/etc/hosts 並編輯 hosts 檔的開頭以併入下列參數： 
    127.0.0.1 localhost

    然後，儲存並關閉 hosts 檔。

WebSphere® Applications 代理程式
安裝代理程式之前，必要條件檢查程式會檢查 ulimit 在 Linux 系統上是否設為 524000。 您必須執行 ulimit -d 524000 指令，來確保 max data segment size 系統環境變數已設為 524000。