從指令行來包裝 Liberty 伺服器

從指令行,您可以建立含有下列內容的壓縮檔:Liberty 執行時期環境、共用資源目錄中的檔案、特定伺服器,以及內嵌在伺服器中的應用程式。您也可以選擇從壓縮檔中排除執行時期二進位檔。

關於這項作業

Liberty 伺服器是輕量型,因此,您很容易將伺服器安裝架構包裝在一個壓縮檔中。之後您可以儲存這個套件,將它配送給同事,然後利用它將安裝架構部署到不同的位置或其他機器,甚至是將安裝架構內嵌在正式作業發行套件中。

您想包裝的伺服器安裝架構不能已加入群體中。您只能包裝獨立式伺服器。

適用於分散式平台註: 產生的檔案是利用 UTF-8 進行項目名稱編碼來建立的,因此用來開啟檔案的工具必須能夠使用 UTF-8 進行項目名稱編碼。Java™ SDK 中的 jar 指令使用這個格式。

程序

  1. 開啟指令行,然後切換至 wlp/bin 目錄。
  2. 停止伺服器
  3. 執行 package 指令,建立套件。

    您可以包裝 Liberty 伺服器執行時期

    • 包裝 Liberty 伺服器。

      除了在 z/OS® 上,預設保存檔格式為 .pax 之外,在所有其他平台上,預設保存檔格式都是 .zip。您也可以產生 .jar

      如果您沒有指定伺服器名稱,則會使用 defaultServer。 如果您沒有指定 --archive 參數,package_file_name 會使用 server_name 值,壓縮檔建立在 ${server.output.dir} 目錄中。

      為您的環境選擇正確的指令。

      • 適用於分散式平台適用於 IBM i 平台

        使用此指令來產生 .zip 保存檔。

        server package server_name --archive=package_file_name.zip --include=all

        其中 package_file_name.zip 是您選擇的檔名。這個檔名可以包含完整路徑名稱。如果省略完整路徑,會在 ${server.output.dir} 目錄中建立一個名為 package_file_name.zip 的壓縮檔。

      • 適用於分散式平台適用於 IBM i 平台

        使用此指令來產生 .jar 保存檔。.jar 保存檔的優點是,bin 目錄中的 Script 會保留其權限,所以能夠在已安裝套件的情況下執行。

        server package server_name --archive=package_file_name.jar --include=all
        其中 package_file_name.jar 是您選擇的檔名。

        如需此保存檔之解壓縮選項的相關資訊,請參閱 Java 保存檔解壓縮選項

      您也可以搭配這個指令使用 --include 選項。例如,--include=all 選項會將執行時期二進位檔及相關的檔案包裝在 ${WLP_USER_DIR} 目錄中;--include=usr 選項只會將相關檔案包裝在 ${WLP_USER_DIR} 目錄中,實際上會從壓縮檔中排除執行時期二進位檔。

      --include=usr 選項不適用於 .jar 的保存檔格式。

      如果您使用 --include=minify 選項,server 指令只會包裝執行時期環境的部分,以及 ${WLP_USER_DIR} 目錄中執行伺服器所需要的檔案。這個選項會大幅減少結果保存檔的大小。

      minify 作業所保留執行時期環境的部分,取決於您在包裝的伺服器中配置的特性。只有那些執行伺服器所需要的特性會保留下來,其餘特性會被刪除。 因此,您之後無法啟用已移除的特性。比方說,如果只保留 servlet-3.0 特性,您之後就無法啟用 jpa-2.0 特性。

      如果配置有了改變,您可以重複 minify 作業來進一步縮減保存檔的大小。 不過,minify 作業沒有反向作業,因此,如果您稍後又需要一或多個已移除的特性,您必須以完整的 Liberty 伺服器來重新開始。

      minify 作業在執行中,會暫時啟動伺服器,而您會看到相關聯的訊息。因此,您不能將 --include=minify 選項用於無法啟動的伺服器,但您可以用 --include=all--include=usr 選項來包裝它。

      您可以搭配 --include=minify 選項來使用 --os 選項,以指定您希望所包裝伺服器可加以支援的作業系統。

      例如,如果要包裝伺服器但移除 z/OS 支援,請使用下列指令:
      server package --archive="nozos.zip" --include=minify --os=-z/OS
      如果要包裝伺服器並保留 OS/400® 支援,但移除 z/OS 支援,請使用下列指令:
      server package --archive="small.zip" --include=minify --os=OS/400,-z/OS
      如果要包裝僅支援 Linux 的伺服器,請使用下列指令:
      server package --archive="linux.zip" --include=minify --os=Linux
    • 包裝 Liberty 執行時期。

      建立一個執行時期保存檔,其中包含 wlp 目錄,但不包含 usr 目錄。伺服器套件的命名慣例是 package_name.zip,如下列範例所示:CustomerPortalApp.zip。如果要建立執行時期保存檔,請執行不含伺服器名稱但含有 --include=wlp 選項的 package 指令。

      server package --include=wlp

      如果要指定套件檔名稱和目標位置,請新增 --archive=package_path_name 選項,如下列範例所示。

      server package --include=wlp --archive=c:\temp\myPackage.zip

      如果您沒有使用 --archive 選項來指定有效的套件名稱或目標位置,則指令會在 $WLP_OUTPUT_DIR 位置中,建立 wlp.zip 執行時期保存檔,依預設,這個位置是 ${wlp.install.dir}/usr/servers 目錄。執行指令之前,目標位置必須已存在。因此,如果目標位置是 c:\tempC:\temp 目錄必須存在且具備寫入權,這樣指令才能將保存檔寫入至 C:\temp 目錄。


指示主題類型的圖示 作業主題

檔名:twlp_setup_package_server.html