test

Sun Java System Application Server Enterprise Edition 8.1 2005Q2 管理指南

第 7 章 連接器資源

本章描述如何配置用於存取企業資訊系統 (EIS) 的連接器。本章包括下列小節：

關於連接器

連接器模組也稱為資源介面，是允許應用程式與企業資訊系統 (EIS) 進行互動式操作的 J2EE 元件。EIS 軟體包含各種類型的系統：包括企業資源計劃 (ERP)、主機作業事件處理和非關聯式資料庫。類似其他 J2EE 模組，安裝連接器模組即是部署該連接器模組。

連接器連線池是針對特定 EIS 的一組可重複使用的連線。若要建立連接器連線池，請指定與池關聯的連接器模組 (資源介面)。

連接器資源是為應用程式提供到 EIS 的連線的程式物件。若要建立連接器資源，請指定其 JNDI 名稱及其關聯的連線池。多個連接器資源可以指定單一連線池。應用程式可透過查找資源的 JNDI 名稱定位資源。(如需有關 JNDI 的更多資訊，請參閱 [JNDI 名稱和資源] 部分)。EIS 的連接器資源的 JNDI 名稱通常位於 java:comp/env/eis-specific 子環境中。

Application Server 使用連接器模組 (資源介面) 實作 JMS。請參閱「JMS 資源和連接器資源的關係」一節。

有關連接器連線池的 管理主控台 作業

Procedure設定 EIS 存取

  1. 部署 (安裝) 連接器。請參閱部署連接器模組。

  2. 為連接器建立連線池。請參閱建立連接器連線池。

  3. 建立與連線池關聯的連接器資源。請參閱建立連接器資源。

Procedure建立連接器連線池

開始之前

建立池之前，先部署與該池關聯的連接器模組 (資源介面)。為新池指定的值取決於部署的連接器模組。

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 選取 [連接器連線池] 節點。

  3. 在 [連接器連線池] 頁面中，按一下 [新建]。

  4. 在 [建立連接器連線池] 的第一個頁面中，指定以下設定：

    1. 在 [名稱] 欄位中，輸入池的邏輯名稱。

      建立連接器資源時將指定此名稱。

    2. 從 [資源介面] 組合方塊中選取一個項目。

      該組合方塊顯示已部署的資源介面 (連接器模組) 的清單。

  5. 按 [下一步]。

  6. 在 [建立連接器連線池] 的第二個頁面中，從 [連線定義] 組合方塊中選取一個值。

    組合方塊中的選擇取決於資源介面。通常，會指定一種 ConnectionFactory (工廠實例) 以建立與 EIS 的連線。

  7. 按 [下一步]。

  8. 在 [建立連接器連線池] 的第三個也即最後一個頁面中，執行以下作業：

    1. 在 [一般設定] 區段中檢驗各個值是否正確。

    2. 對於 [池設定] 區段中的欄位，可以保留預設值。

      可以在以後變更這些設定。請參閱「編輯連接器連線池」。

    3. 在 [附加特性] 表中，增加任何所需的特性。

      在 [建立連接器連線池] 的上一個頁面中，從 [連線定義] 組合方塊中選取了一個類別。如果此類別位於伺服器的類別路徑中，則 [附加特性] 表將顯示預設特性。

  9. 按一下 [完成]。

等效的 asadmin 指令

create-connector-connection-pool

Procedure編輯連接器連線池

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 展開 [連接器連線池] 節點。

  3. 選擇要編輯的池的節點。

  4. 在 [編輯連接器連線池] 頁面中，您可以變更控制池中連線的數目的設定。請參閱下表。

    參數 

    說明 

    池的初始大小和最小大小 

    池中連線的最小數目。該值還確定了首次建立池或應用程式伺服器啟動時置於池中的連線的數目。 

    池的最大大小 

    池中連線的最大數目。 

    池設定大小數量 

    當池向最小池大小收縮時，將成批調整大小。此值確定批次中的連線數目。將該值設置過大會延遲連線循環；而將該值設置過小則會導致效率太低。 

    閒置逾時 

    連線可以在儲存區中閒置的最大時間 (以秒表示)。一旦超過此時間，即從池中移除該連線。 

    最長等待時間 

    已請求連線的應用程式在達到連線逾時之前等待的時間。由於預設等待時間過長，應用程式可能會出現無限期當機的情況。 

    一旦失敗 

    選取標記為 [關閉所有連線] 的核取方塊之後，如果單一連線失敗，Application Server 將關閉池中的所有連線，然後重新建立這些連線。如果未選取此核取方塊，則僅在使用個別連線時才會重新建立這些連線。 

    作業事件支援 

    使用 [作業事件支援] 清單可以為連線池選取作業事件支援類型。選擇的作業事件支援以向下相容方式置換與此連線池關聯的資源介面中的作業事件支援屬性。也就是說，它可以支援比資源介面中指定的作業事件層級低或與其相同的作業事件層級，但它不能指定更高的層級。 

    作業事件支援選項包括以下內容： 

    [作業事件支援] 功能表中的 [無] 選項表示資源介面不支援本機資源管理員或 JTA 作業事件，並且不實作 XAResource 或 LocalTransaction 介面。

    [本機] 作業事件支援表示資源介面將透過實作 LocalTransaction 介面來支援本機作業事件。本機作業事件的管理在資源管理員內部進行，不涉及任何外部作業事件管理員。

    XA 作業事件支援表示資源介面將透過實作 LocalTransaction 和 XAResource 介面來支援本機資源管理員和 JTA 作業事件。XA 作業事件由作業事件管理員在資源管理員外部進行控制和協調。本機作業事件的管理在資源管理員內部進行，不涉及任何外部作業事件管理員。

  5. 在 [附加特性] 表中，指定名稱-值對。

    指定的特性取決於此池使用的資源介面。部署程式使用此表指定的名稱-值對可用於置換由資源介面供應商定義的特性的預設值。

  6. 在 [安全性對映] 標籤窗格中，建立或修改用於連線池的安全性對映。

    請參閱關於安全性對映，以取得有關如何建立安全對映的資訊。

  7. 按一下 [儲存]。

Procedure刪除連接器連線池

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 選取 [連接器連線池] 節點。

  3. 在 [連接器連線池] 頁面中，選取要刪除池的核取方塊。

  4. 按一下 [刪除]。

等效的 asadmin 指令

delete-connector-connection-pool

有關連接器資源的 管理主控台 作業

Procedure建立連接器資源

連接器資源 (資料源) 為應用程式提供了與 EIS 的連線。

開始之前

建立連接器資源之前，請先建立連接器連線池。

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 展開 [連接器資源] 節點。

  3. 在 [連接器資源] 頁面中，按一下 [新建]。

  4. 在 [建立連接器資源] 頁面中，指定資源的設定：

    1. 在 [JNDI 名稱] 欄位中，鍵入專屬名稱，例如：eis/myERP。

      請勿遺漏正斜線。

    2. 從 [池名稱] 組合方塊中選擇新連接器資源所屬的連線池。

    3. 若要將資源變更為不可用，請選取 [在所有目標上停用] 單選按鈕。

      依預設，建立資源之後立即可以使用資源 (已啟用)。

    4. 在此頁面的 [目標] 區段中，從 [可用] 欄位中選取連接器資源要常駐的網域、叢集或伺服器實例，然後按一下 [增加]。

      如果您不想將連接器資源部署到 [已選取] 欄位中所列的某個網域、叢集或伺服器實例，請從欄位中選取該實例，然後按一下 [移除]。

  5. 按一下 [確定]。

等效的 asadmin 指令

create-connector-resource

Procedure編輯連接器資源

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 展開 [連接器資源] 節點。

  3. 選取要編輯的連接器資源的節點。

  4. 在 [編輯連接器資源] 頁面中，您可以從 [池名稱] 功能表中選取不同的連線池。

  5. 在 [目標] 標籤窗格中，可以透過按一下 [管理目標] 來編輯連接器資源部署到的目標。

    請參閱建立連接器資源，以取得有關目標的更多資訊。

  6. 按一下 [儲存] 以套用編輯。

Procedure刪除連接器資源

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 選取 [連接器資源] 節點。

  3. 在 [連接器資源] 頁面中，選取要刪除的資源的核取方塊。

  4. 按一下 [刪除]。

等效的 asadmin 指令

delete-connector-resource

Procedure配置連接器服務

使用 [連接器服務] 螢幕可以為部署到此叢集或伺服器實例的所有資源介面配置連接器容器。

  1. 從樹中選擇 [配置]。

  2. 選取要配置的實例：

    • 若要配置特定的實例，請選取該實例的配置節點。例如，對於預設實例 server，請選取 server-config 節點。

    • 若要為將來的實例 (實例使用 default-config 的副本) 配置預設設定，請選取 default-config 節點。

  3. 選取 [連接器服務] 節點。

  4. 在 [關閉逾時] 欄位中指定關閉逾時 (以秒為單位)。

    請輸入一個整數，此整數表示 Application Server 可以等待連接器模組實例的 ResourceAdapter.stop 方法完成的秒數。應用程式伺服器將忽略所需時間超過指定關閉逾時的的資源介面，並且關閉程序將繼續。預設的關閉逾時為 30 秒。按一下 [載入預設值]，可以為部署到此叢集或伺服器實例的資源介面選取預設關閉逾時。

有關管理物件資源的 管理主控台 作業

Procedure建立管理物件資源

封裝在資源介面 (連接器模組) 中的受管理物件為應用程式提供專用功能。例如，受管理物件可以提供對特定於資源介面及其關聯的 EIS 的剖析器的存取。可以管理該物件，亦即，管理員可配置該物件。若要配置物件，請在 [建立或編輯管理物件資源] 頁面上增加名稱－值特性對。建立受管理物件資源時，請將受管理物件與 JNDI 名稱相關聯。

Application Server 使用資源介面實作 JMS。對於已建立的每個 JMS 目標，Application Server 均會自動建立一個管理物件資源。

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 展開 [管理物件資源] 節點。

  3. 在 [受管理物件資源] 頁面中，按一下 [新建]。

  4. 在 [受管理物件資源] 頁面中，指定以下設定：

    1. 在 [JNDI 名稱] 欄位中，鍵入識別資源的專屬名稱。

    2. 在 [資源類型] 欄位中，輸入資源的 Java 類型。

    3. 從 [資源介面] 組合方塊中，選取包含受管理物件的資源介面。

    4. 選取或取消選取核取方塊以啟用或停用資源。

    5. 按 [下一步]。

  5. 在 [建立受管理物件資源] 的第二個頁面中，可以執行以下作業。

    1. 若要使用名稱-值特性對配置受管理物件，請按一下 [新增特性]。

    2. 在此頁面的 [目標] 區段中，從 [可用] 欄位中選取管理物件要常駐的網域、叢集或伺服器實例，然後按一下 [增加]。

      若要從 [已選取] 欄位中所列的某個網域、叢集或伺服器實例中取消部署管理物件，請從該欄位中選取該項，然後按一下 [移除]。

  6. 按一下 [完成]。

等效的 asadmin 指令

create-admin-object

Procedure編輯管理物件資源

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 展開 [受管理物件資源] 節點。

  3. 選取要編輯的受管理物件資源的節點。

  4. 在 [編輯受管理物件資源] 頁面中，修改在 [建立受管理物件資源] 中指定的值。

  5. 在 [目標] 標籤窗格中，可以透過按一下 [管理目標] 來編輯受管理物件部署到的目標。

    請參閱建立管理物件資源，以取得有關目標的更多資訊。

  6. 按一下 [儲存] 以套用編輯。

Procedure刪除管理物件資源

  1. 在樹形元件中，展開 [資源] 節點，然後展開 [連接器] 節點。

  2. 選取 [受管理物件資源] 節點。

  3. 在 [受管理物件資源] 頁面中，選取要刪除的資源的核取方塊。

  4. 按一下 [刪除]。

等效的 asadmin 指令

delete-admin-object