設定環境變數來側寫伺服器

側寫伺服器可讓您分析執行 Web 應用程式時的效能、執行緒作業及記憶體用量。 在某些情況下,您必須先在目標主機電腦上設定環境變數,才能在側寫模式下啟動伺服器。 您必須在啟動伺服器進行側寫之前設定環境變數。在執行 z/OS® 的電腦上,您也需要對 Rational® Agent Controller 使用的目錄設定權限。

決定您是否必須手動設定側寫的環境變數

在某些情況下,您不需要於側寫時在目標電腦上手動設定環境變數;工作台會自動為您設定。 不過,在某些情況下,您必須手動設定環境變數。下列因素決定是否需要手動設定環境變數,以及要設定哪些環境變數:
  • 伺服器的目標電腦是否為安裝工作台的同一部電腦(本端伺服器),或伺服器是否位於不同電腦(遠端伺服器)。
  • 使用者 ID 對 WebSphere® Application Server(本端伺服器)的 /java/jre/bin/ 目錄是否具有寫入權。
  • 已安裝的 Rational Agent Controller 版本(遠端伺服器)。
下表顯示自動設定或必須手動設定環境變數的情況。
表 1. 側寫時自動或手動設定環境變數的情況. 針對本端和遠端伺服器設定環境變數。
環境變數 本端伺服器 遠端伺服器
  • Windows
    PATH
  • Linux
    Solairis
    LD_LIBRARY_PATH
  • AIX
    z/OS
    LIBPATH
由工作台自動設定。 如果遠端伺服器使用 Rational Agent Controller 8.3 版或更新版本,則自動設定。否則,手動設定。
註:
z/OS
您必須確定 LIBPATH 環境變數包含路徑 <XML 工具箱安裝目錄>/xml4c-5_7/lib。

比方說,如果您將 XML 工具箱安裝在 /usr/lpp/ixm/IBM/xml4c-5_7,則 LIBPATH 環境變數必須包含路徑:LIBPATH=/usr/lpp/ixm/IBM/xml4c-5_7/lib。

註:
z/OS
您在 <XML 工具箱安裝目錄>/xml4c-5_7/lib 及其他目錄上也必須具有讀取和執行權限。請參閱 設定在 z/OS 上進行側寫的檔案許可權。
TPTP_AC_HOME 由工作台自動設定。 如果遠端伺服器使用 Rational Agent Controller 8.3 版或更新版本,則自動設定。否則,手動設定。
PROBEKIT_HOME(只有在您使用「探測插入項目」監視器選項時才需要。) 由工作台自動設定。 手動設定。
JAVA_PROFILER_HOME 由工作台自動設定 如果遠端伺服器位於使用 Rational Agent Controller 8.3 版或更新版本的 Windows 或 Linux 作業系統上,則自動設定。否則,手動設定。

手動設定本端伺服器的側寫環境變數

如果伺服器和工作台在同一部機器上執行,請完成下列步驟:
  1. 在 IBM® Rational Software Delivery Platform 的安裝目錄下尋找下列外掛程式資料夾
    註: 當相同的外掛程式有多個版本時,一律挑選具有最新版本號碼和時間戳記的外掛程式。
    表 2. 用於定義在本端伺服器進行側寫的環境變數的外掛程式路徑. 使用外掛程式路徑來決定環境變數。
    說明 外掛程式路徑
    <Agent Controller 起始目錄>
    • Windows
      <install_dir>\IBMIMShared\plugins\org.eclipse.tptp.platform.ac.win_<XXXX>\agent_controller
    • Linux
      <install_dir>/IBMIMShared/plugins/org.eclipse.tptp.platform.ac.linux_<XXXX>/agent_controller
    其中 <install_dir> 是 IBM Rational Software Delivery Platform 的安裝目錄,<XXXX> 取決於作業系統的架構。 將 <XXXX> 替換成適當的處理器,您可以選取 ia32 代表 32 位元處理器、em64 代表 64 位元處理器,或 ipf 代表 Itanium 系列處理器,例如 org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<yyyymmddtttt>,其中 <n.n.n> 是版本號碼,<yyyymmddtttt> 是外掛程式的日期和時間戳記。
    <Probekit 起始目錄>
    • Windows
      <install_dir>\IBMIMShared\plugins\org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>\os\win32\x86
    • Linux
      <install_dir>/IBMIMShared/plugins/org.eclipse.hyades.probekit<n.n.n>.v<yyyymmddtttt>/os/linux/x86
    其中 <install_dir> 是 IBM Rational Software Delivery Platform 的安裝目錄,<XXXX> 取決於作業系統的架構。 將 <XXXX> 替換成適當的處理器,您可以選取 ia32 代表 32 位元處理器、em64 代表 64 位元處理器,或 ipf 代表 Itanium 系列處理器,例如 org.eclipse.tptp.platform.ac.win_ia32_<n.n.n>.v<yyyymmddtttt>,其中 <n.n.n> 是版本號碼,<yyyymmddtttt> 是外掛程式的日期和時間戳記。
  2. 啟動工作台和應用程式伺服器之前,設定下列環境變數。開啟命令提示字元並輸入下列指令,將 <Agent Controller 起始目錄> 和選用的 <Probekit 起始目錄> 更換為您在先前步驟中決定的外掛程式路徑:
    Windows
    set TPTP_AC_HOME=<Agent Controller 起始目錄> set PROBEKIT_HOME=<Probekit 起始目錄> set PATH=%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%;%PATH%
    Linux
    export TPTP_AC_HOME=<Agent Controller 起始目錄> export PROBEKIT_HOME=<Probekit 起始目錄> export LD_LIBRARY_PATH=$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME:$LD_LIBRARY_PATH

手動設定在遠端伺服器進行側寫的環境變數

如果應用程式伺服器和工作台在不同電腦上執行,請完成下列步驟:
註: 如果您側寫遠端應用程式伺服器,您必須將 Rational Agent Controller 安裝在應用程式伺服器所在的同一部機器上。 請確認應用程式伺服器的啟動處理程序可取用下列環境變數設定。
在遠端應用程式伺服器所在的電腦上,在啟動工作台和應用程式伺服器之前,手動設定任何環境變數。您可以在目標系統上手動設定下列環境變數,請將 <AC 安裝目錄> 更換成 Rational Agent Controller 的安裝目錄。此外,如果您使用探測插入項目監視器選項,請指定 PROBEKIT_HOME 環境變數:
Windows
set TPTP_AC_HOME=<AC 安裝目錄> set JAVA_PROFILER_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.tptp.javaprofiler set PROBEKIT_HOME=%TPTP_AC_HOME%\plugins\org.eclipse.hyades.probekit set PATH=%JAVA_PROFILER_HOME%;%TPTP_AC_HOME%\bin;%TPTP_AC_HOME%\lib;%PROBEKIT_HOME%\lib;%PATH%
Linux
Solairis
export TPTP_AC_HOME=<AC 安裝目錄> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LD_LIBRARY_PATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LD_LIBRARY_PATH
AIX
export TPTP_AC_HOME=<AC 安裝目錄> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH
z/OS
export TPTP_AC_HOME=<AC 安裝目錄/RACzOS64 或 31 位元> export JAVA_PROFILER_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.tptp.javaprofiler export XERCESC_HOME=<XML 工具箱安裝目錄>/xml4c-5_7/lib export PROBEKIT_HOME=$TPTP_AC_HOME$/plugins/org.eclipse.hyades.probekit export LIBPATH=$JAVA_PROFILER_HOME:$TPTP_AC_HOME/bin:$TPTP_AC_HOME/lib:$XERCESC_HOME/lib:$PROBEKIT_HOME/lib:$LIBPATH

其中 <XML 工具箱安裝目錄> 通常是 /usr/lpp/ixm/IBM。

註: 如果您已在安裝 Rational Agent Controller 時啟用安全,請輸入下列指令:
  • extattr +ap <Rational Agent Controller 目錄>/lib/*
  • extattr +ap <Rational Agent Controller 目錄>/plugins/org.eclipse.tptp.javaprofiler/*
  • extattr +ap <XML 工具箱安裝目錄>/xml4c-5_7/lib/*

啟動工作台

設定必要的環境變數之後,請從命令提示字元啟動 IBM Rational Software Delivery Platform 工作台,讓工作台處理程序可以取用環境變數。例如,執行下列指令:
Windows
C:\Program Files\IBM\SDP>eclipse
Linux
/opt/IBM/SDP>./eclipse
註: 使用 WebSphere Application Server 進行側寫時,您可以在伺服器安裝的 /bin 資料夾下的 setupCmdLine.bat (Windows) 或 setupCmdLine.sh (Linux) 檔案中,新增環境變數設定。

設定在 z/OS 上進行側寫的檔案許可權

z/OS
如果在 z/OS 上側寫,您在下列目錄(及其路徑中的所有目錄)上必須具有讀取和執行權限:
  • <Rational Agent Controller 安裝目錄>/lib/*
  • <Rational Agent Controller 安裝目錄>/plugins/org.eclipse.tptp.javaprofiler/*
  • <XML 工具箱安裝目錄>/xml4c-5_7/lib*
註: 這些目錄路徑中的所有目錄也需要讀取和執行權限。 比方說,如果 <Rational Agent Controller 安裝目錄> 是 /opt/IBM/RAC,則您在 /opt、/opt/IBM、/opt/IBM/RAC 及 /opt/IBM/RAC/lib/ 目錄上都需要讀取和執行權限。
如果要執行指令 umask 022 來給予這些目錄上的正確權限,請執行下列動作:
  1. 在 UNIX 系統服務 Shell 中,切換至 <Rational Agent Controller 安裝目錄>/RACzOS31bit/bin 目錄。
  2. 執行下列指令:umask 022
  3. 啟動 Agent Controller:./ACStart.sh。
Icon that indicates the type of topic Reference topic
Timestamp icon Last updated: last_date

File name: rprofilingenvvar.html