使用 WebSphere Application Server 管理 Java API 來建立自訂 Java 管理用戶端程式

本節說明如何開發 Java™ 程式，以利用產品管理應用程式設計介面 (API) 來存取 WebSphere® Application Server 管理系統。

開始之前

這項作業假設基本熟悉「Java 管理延伸 (JMX)」API 程式設計。如需 Java API 的相關資訊，請檢視應用程式設計介面文件。

關於這項作業

當您開發及執行使用各種 JMX 連接器且已啟用安全的管理用戶端時，請使用下列準則。當您遵循這些準則時，您可以保證 JMX 連接器不同實作之間的行為。不支援任何偏離這些準則的程式設計模型。

在建立及使用另一個管理用戶端之前，請先建立及使用單一管理用戶端。
在相同的執行緒上建立及使用管理用戶端。
請使用下列其中一種方式來指定使用者 ID 和密碼，以建立新的管理用戶端:
- 在內容檔中指定預設使用者 ID 和密碼。
- 請指定預設值以外的使用者 ID 和密碼。建立具有非預設使用者 ID 及密碼的管理用戶端之後，請在建立後續管理用戶端時指定非預設使用者 ID 及密碼。

程序

開發管理用戶端程式。
建置並執行管理用戶端程式。
建置及執行程式所需的步驟取決於程式碼執行的應用程式環境類型。

如需如何建置及執行管理用戶端程式的詳細資料，請參閱使用應用程式用戶端。
如果您的管理用戶端使用「簡易物件存取通訊協定 (SOAP)」作為其連接器，您必須將 Java Secure Socket Extension (JSSE) 配置成您的傳輸層。產品使用支援 Secure Sockets Layer (SSL) 和傳輸層安全 (TLS) ，以及 Java Secure Sockets Extension (JSSE) 和系統 SSL 套件。
為用來執行管理用戶端的使用者 ID 建立數位憑證。如果您想要使用「系統授權機能 (SAF)」來建立數位憑證，並將它們儲存在 SAF 金鑰環中，請參閱定義用戶端出埠要求的 SSL 安全。 (您可以儲存您建立的金鑰環名稱，以便在下一步中使用。)
更新soap.client.props中的檔案profile_root/properties管理用戶端使用 SAF 金鑰環名稱的目錄。請參閱「將系統授權機能金鑰環與 Java Secure Sockets Extension 搭配使用」的第二個步驟，以取得更新的指示。soap.client.props檔案。
建置管理用戶端程式。
請使用 javac 指令來編譯它，並在類別路徑引數中提供必要 JAR 檔的位置。
例如，如果您的安裝目錄是/DeploymentManager一般指令類似下列範例:
```
javac -extdirs "$JAVA_HOME/lib/ext;
/DeploymentManager/classes;/DeploymentManager/lib;
/DeploymentManager/lib/ext"  MyAdminClient.java
```
(前一個指令分割為多行以進行發佈。)
執行管理用戶端程式。
透過設定執行時期環境來執行管理用戶端程式，以便程式可以找到所有必備項目。中的許多批次或 Script 檔bin安裝根目錄下的目錄會執行類似的功能。以下是執行管理用戶端程式 (名稱為) 的批次檔範例MyAdminClient如下所示:
```
@echo off

binDir=`dirname "$0"`       
. "$binDir/setupCmdLine.sh"


"$JAVA_HOME/bin/java" "$CLIENTSOAP" "-Dwas.install.root=$WAS_HOME"
"-Dwas.repository.root=$CONFIG_ROOT" 
-Dcom.ibm.CORBA.BootstrapHost=$COMPUTERNAME 
 "-Djava.ext.dirs=$JAVA_HOME/lib/ext;$WAS_HOME/classes;
$WAS_HOME/lib;$WAS_HOME/lib/ext" MyAdminClient $@
```
(前一個批次檔的內容會分割成多行以進行發佈。)