使用管理主控台將 EBA 資產新增至組合單元

請利用管理主控台來新增組合單元,其中包含先前匯入的 EBA 資產加上配置資訊。 配置資訊可以包括 HTTP 階段作業管理、環境定義根目錄、虛擬主機、安全角色、執行身分角色、Session Enterprise Bean 的 JNDI 對映、EJB 參照的 JNDI 對映,以及 OSGi 應用程式的 Web 應用程式或藍圖資源參照連結。

開始之前

您可以依照這個主題中的說明,利用管理主控台,或依照 利用 wsadmin 指令,將 EBA 資產新增至組合單元中的說明,利用 addCompUnit 指令,將 EBA 資產新增至商業層次應用程式。

一個 EBA 資產只能新增至一個商業層次應用程式。 商業層次應用程式以 Cell 範圍為範圍,因此在 Cell 中只能部署一個 OSGi 應用程式實例。

此作業會進行下列假設:
  • 您已匯入 EBA 檔作為資產 (如 將 OSGi 應用程式部署成商業層次應用程式中所述) ,然後將您的變更儲存至主要配置 (這會導致從已配置的軟體組儲存庫下載任何軟體組相依關係)。
  • 您已定義目標虛擬主機。 如果要使用管理主控台來檢查現有的虛擬主機,請按一下 環境 > 虛擬主機
  • 您已想要與每一個藍圖資源參照相關聯。 如果要使用管理主控台來檢查現有的 JCA 鑑別別名,請按一下 安全 > 廣域安全 > [鑑別] Java 鑑別和授權服務 > J2C 鑑別資料

關於此作業

OSGi 組合單元由 EBA 資產 (選擇性地) 一或多個複合軟體組延伸,以及下列部分或所有配置資訊組成:
  • 從組合單元到目標應用程式伺服器、Web 伺服器或叢集的對映。
  • 配置應用程式的階段作業管理程式、環境定義根目錄或虛擬主機。
  • 從 Enterprise Bean 至 JNDI 名稱的對映。
  • 連結至任何相關聯的 Web 應用程式或藍圖資源參照。
  • 從安全角色到特定使用者或群組的對映。

您可以使用「 設定選項設定 」精靈,將新的組合單元新增至商業層次應用程式。 資產的內容會決定精靈中的特定步驟。 這個主題說明您在新增 EBA 資產時所配置的主要元素。 如需精靈可能提示您配置之所有元素的一般說明,請參閱。

除了透過下列程序來指定 EBA 資產的配置資訊之外,您也可以稍後依照 修改 OSGi 組合單元的配置中的說明來變更它。 例如,如果您更新 EBA 資產中的軟體組,或取代複合軟體組延伸,則可能會建立需要其他配置的資源,例如新的或變更的 Blueprint 資源參照,或安全角色對映。

程序

  1. 啟動管理主控台。
  2. 將先前匯入的資產 (EBA 檔案) 新增為已部署的資產。
    1. 如果您剛建立新的商業層次應用程式,則已顯示商業層次應用程式的一般內容,其中包括 [已部署的資產] 新增 > 新增資產選項。 否則,請導覽至 應用程式 > 應用程式類型 > 商業層次應用程式 > application_name > [已部署資產] 新增 > 新增資產
      即會顯示可用資產的清單。
    2. 選取要新增的資產,然後按一下 繼續
      即會顯示「 設定選項設定 」精靈。
  3. 精靈步驟: 設定選項。

    視需要變更組合單元設定,然後按 下一步 如需相關資訊,請參閱。

  4. 精靈步驟: 將組合單元對映至目標。

    選取部署目標應用程式伺服器或 Web 伺服器。 如需相關資訊,請參閱。

  5. 精靈步驟: 對映 Web 模組的環境定義根目錄。

    從清單中選取 Web 應用程式組合 (WAB) ,然後輸入 WAB 的環境定義根目錄。 例如, /sample。 如需相關資訊,請參閱 Web 模組的環境定義根目錄 [設定]

  6. 精靈步驟: 對映 Web 模組的虛擬主機。

    即會顯示此資產中可用的 WAB 清單。 對於每一個 WAB ,您可以從清單中選取不同的虛擬主機來變更相關聯的虛擬主機。 如果您在 ibm-web-bnd.xml.xmi 檔案中指定 WAB 的現有虛擬主機,依預設會設定指定的虛擬主機。 否則,預設虛擬主機設定是 default_host如需相關資訊,請參閱 Web 模組的虛擬主機 [設定]

  7. 精靈步驟: 將安全角色對映至使用者或群組。

    視需要變更安全對映。 如需相關資訊,請參閱 安全角色至使用者或群組對映 [設定]

  8. 精靈步驟: 將 RunAs 角色對映至使用者

    您可以將指定的使用者身分和密碼對映至 RunAs 角色。 此對映可讓您指定個別使用者的應用程式特定專用權,以便他們可以使用另一個使用者身分來執行特定作業。 如需相關資訊,請參閱 使用者 [集合] 的RunAs 角色

  9. 精靈步驟: 連結藍圖資源參照。

    即會顯示此資產中可用的藍圖資源參照清單。 對於每一個參照,您可以選擇性地從清單中選取鑑別別名。 只有在每個目標伺服器或叢集上都存在預設鑑別別名時,才會提供預設鑑別別名 (來自 ibm-eba-bnd.xml 檔案)。 如需相關資訊,請參閱 藍圖資源參照 [設定]

  10. 精靈步驟: 將 Web 模組資源參照對映至資源。

    會顯示此資產中可用的 Web 應用程式資源參照清單。 亦即,類型為 resource-ref (資源參照) 的資源,如 Java 規格 JSR-250: Java 平台的一般註釋中所定義。 針對每一個參照,指定執行時期環境中用來識別資源的 JNDI 名稱。 選擇性地設定鑑別內容及延伸資料來源自訂內容,這會影響在執行時期存取資源的方式。 如果要指定 JNDI 名稱對映,請在方框中輸入 JNDI 名稱,或按一下 瀏覽 ... 然後從 可用資源清單中選取資源參照。 如果要修改鑑別方法,或設定適用於資料庫連線的延伸資料來源自訂內容,請選取單一參照,然後按一下 修改資源鑑別方法 ...延伸內容 ... 如需相關資訊,請參閱 Web 模組資源參照 [設定]

  11. 精靈步驟: 將 Web 模組訊息目的地參照連結至受管理物件。

    即會顯示此資產中可用的 Web 應用程式訊息目的地及資源環境參照的清單。 亦即,類型為 message-destination-ref (訊息目的地參照) 或 resource-env-ref (資源環境參照) 的資源,如 Java 規格 JSR-250: Java Platform 的「共用註釋」中所定義。 針對每一個參照,指定執行時期環境中用來識別資源的 JNDI 名稱。 如需相關資訊,請參閱 Web 模組訊息目的地參照 [設定]

  12. 精靈步驟: 提供 EJB JNDI 名稱

    對於組合單元中的每一個 Session Enterprise Bean ,您可以指定在執行時期環境中用來識別 Enterprise Bean 的 JNDI 名稱。 如需相關資訊,請參閱 EJB JNDI 名稱 [設定]

  13. 精靈步驟: 對映 EJB 參照

    對於 ejb-jar.xml 檔、 web.xml 檔或組合單元中的 @EJB 註釋所定義的每一個 EJB 參照,您可以指定在執行時期環境中用來識別 EJB 參照的 JNDI 名稱。 如需相關資訊,請參閱 EJB 參照 [設定]

  14. 精靈步驟: 將 EJB 資源參照對映至資源

    會顯示這個資產中可用的 EJB 資源參照清單。 亦即,類型為 resource-ref (資源參照) 的資源,如 Java 規格 JSR-250: Java 平台的一般註釋中所定義。 針對每一個參照,指定執行時期環境中用來識別資源的 JNDI 名稱。 如需相關資訊,請參閱 EJB 資源參照 [設定]

  15. 精靈步驟: 將 EJB 訊息目的地參照連結至受管理物件

    會顯示這個資產中可用的 EJB 訊息目的地和資源環境參照的清單。 亦即,類型為 message-destination-ref (訊息目的地參照) 或 resource-env-ref (資源環境參照) 的資源,如 Java 規格 JSR-250: Java Platform 的「共用註釋」中所定義。 針對每一個參照,指定執行時期環境中用來識別資源的 JNDI 名稱。 如需相關資訊,請參閱 EJB 訊息目的地參照 [設定]

  16. 精靈步驟: 對映 EJB 環境項目

    對於 ejb-jar.xml 檔中的 env-entry 元素或組合單元中的 @Resource 註釋所定義的每一個簡式環境項目,您可以指定環境項目的值。 如需相關資訊,請參閱 EJB 環境項目 [設定]

  17. 精靈步驟: 連結訊息驅動 Bean 的接聽器

    對於 ejb-jar.xml 檔或組合單元中的 @MessageDriven 註釋所定義的每一個訊息驅動 Bean (MDB) ,您可以指定將 MDB 接聽器連結至 MDB 所需的設定。 透過將接聽器連結至 MDB ,您可以配置 MDB 與 MDB 從中接收訊息之 JMS 目的目的地的關聯。 如需相關資訊,請參閱 訊息驅動 Bean 的接聽器 [設定]

  18. 精靈步驟: 摘要

    即會顯示您的選擇摘要。 如果要完成建立組合單元,請按一下 完成。 如果有您要變更的設定,請按 上一步 來檢閱設定。

  19. 儲存您對配置儲存庫所做的變更。

結果

產品會建立應用程式、模組或共用程式庫關係的組合單元。 單元名稱會顯示在商業層次應用程式的設定頁面上已部署的資產清單中。 若要檢視設定頁面,請按一下 應用程式 > 應用程式類型 > 商業層次應用程式 > application_name

下一步

附註: 匯入 OSGi 應用程式的企業軟體組保存檔 (EBA) 作為資產之後,您可以更新現有軟體組的版本,但無法將額外軟體組新增至資產。 不過,在您將資產當作組合單元新增至商業層次應用程式之後,您可以將一或多個複合軟體組新增至組合單元來延伸商業層次應用程式。 請參閱 新增或移除 OSGi 組合單元的延伸

您現在已準備好 啟動您的商業層次應用程式