使用 launchClient 執行 Java EE 用戶端應用程式

將 Java EE 用戶端應用程式部署到具有「應用程式用戶端」安裝架構的機器或在 WebSphere® Application Server 節點中之後,您可以在該機器上使用 launchClient 指令來啟動應用程式。

開始之前

您必須已部署應用程式,才能使用 launchclient 指令來執行 Java EE 用戶端應用程式。

這項作業只適用於 Java™ EE 用戶端應用程式。

關於這項作業

Java Platform, Enterprise Edition (Java EE) 規格需要支援執行 Java 應用程式 (稱為 Java EE 用戶端應用程式) 並為應用程式提供 Java EE 服務的用戶端儲存器。 Java EE 服務包括命名、安全及資源連線。

程序

  1. 輸入下列指令,以啟動 Java EE 應用程式用戶端:
    app_client_root/bin/launchClient
  2. 將參數傳遞給 launchClient 指令或您的應用程式用戶端程式。 launchClient 指令可讓您執行兩者。
    launchClient 指令要求第一個參數為:
    • 指定要啟動之應用程式用戶端的 EAR 檔。
    • launchClient 使用情形資訊的要求。

    下列範例說明 launchClient 工具的指令行呼叫語法:

    launchClient [-profileName pName | -JVMOptions options | -help | -?] userapp [-CCname=value] [app args]
    
    其中
    • userapp 是包含應用程式用戶端之 EAR 檔的路徑和名稱。
    • -CCname = value 是用戶端儲存器名稱/值配對參數。 如需支援的名稱/值配對引數,請參閱用戶端儲存器參數小節。
    • app args 是傳遞至應用程式用戶端的引數。
    • -profileName 定義多重設定檔安裝架構中應用程式伺服器程序的設定檔。 在單一設定檔環境或應用程式用戶端安裝中執行時,不需要-profileName 選項。

      [Linux][AIX][Windows][HP-UX][Solaris]預設值為 default_profile。

    • -JVMOptions 是有效的 Java 標準或非標準選項字串。 插入引號來括住字串。
    • -help ,-? 會列印用法資訊。
    launchClient 指令的所有其他參數必須以 -CC 字首開頭。

    不是 EAR 檔或使用要求,或不是以 -CC 字首開頭的參數,會被應用程式用戶端執行時期忽略,並直接傳給應用程式用戶端程式。

    launchClient 指令會從三個位置擷取參數:
    • 指令行
    • 內容檔
    • 系統內容
    參數會以列出的順序來解析,指令行值具有最高優先順序,系統內容則為最低。 使用此優先順序,您可以設定及置換預設值。
  3. 指定伺服器名稱。

    [Linux][AIX][Windows][HP-UX][Solaris]依預設, launchClient 指令會使用 localhost 作為 BootstrapHost 內容值。

    當應用程式用戶端安裝在與伺服器相同的電腦上時,這項設定適用於測試應用程式用戶端。 不過,在其他情況下,會以您伺服器的名稱置換此值。 您可以使用下列參數來呼叫 launchClient 指令,以置換 BootstrapHost 值:
    launchClient myapp.ear -CCBootstrapHost=abc.midwest.mycompany.com
    您也可以指定內容檔中的值,並將檔名傳遞至 launchClient Shell ,來置換預設值。

    安全由伺服器控制。 您不需要在用戶端上配置安全,因為用戶端會假設已啟用安全。 如果未啟用伺服器安全,伺服器會忽略安全要求,且應用程式用戶端會如預期般運作。

範例

您可以將 launchClient 值儲存在內容檔中,這是配送預設值的好方法。 然後,您可以在指令行上置換一或多個值。 檔案格式為每行一個 launchClient -CC 參數,不含 -CC 字首。 例如:

[Windows]
 verbose=true classpath=c:\mydir\util.jar;c:\mydir\harness.jar;c:\production\G19
\global.jar BootstrapHost=abc.westcoast.mycompany.com tracefile=c:\WebSphere\mylog.txt 
[Linux][AIX][HP-UX][Solaris]
 verbose=true classpath=/usr/lpp/mydir/util.jar;/usr/lpp/mydir/harness.jar;/usr/lpp
/production/G19/global.jar BootstrapHost=abc.westcoast.mycompany.com tracefile=/usr
/lpp/WebSphere/mylog.txt