準備應用程式更新設定

請利用這個頁面來更新已經安裝在伺服器的企業應用程式、模組或檔案。

如果要檢視這個管理主控台頁面,請執行下列動作:
  1. 按一下應用程式 > 應用程式類型 > WebSphere 企業應用程式
  2. 選取已經安裝而且您要更新的應用程式或模組。
  3. 按一下更新
按一下更新,顯示一個頁面,幫助您更新您部署在 Cell 上的應用程式檔案。您可以更新完整的應用程式、一個模組、一個檔案或應用程式的一部分。 如果新檔案或模組,與伺服器中現有的檔案或模組具有同樣的相對路徑,則新檔案或模組會取代現有的檔案或模組。如果伺服器沒有這個新檔案或模組,它會加到已部署的應用程式中。
要更新的應用程式

指定您在「企業應用程式」頁面上選取的已安裝(或已部署)的應用程式名稱。

取代整個應用程式

應用程式更新選項下,指定以新的(或更新過的)企業應用程式 .ear 檔,取代已安裝在伺服器的應用程式。

在選取這個選項之後,請執行下列動作:

  1. 指定 .ear 檔是在本端還是遠端檔案系統上,以及指定該應用程式的完整路徑名稱。這個路徑會提供更新後的 .ear 檔在安裝之前的位置。

    如果瀏覽器和更新的檔案或模組在相同機器中(不論伺服器是否也在相同機器中),請使用本端檔案系統。 所有更新選項都能使用本端檔案系統

    如果應用程式檔案在現行 Cell 環境定義的任何節點中,請使用遠端檔案系統

    在多重伺服器的安裝架構上,如果節點代理程式或部署管理程式是在所選節點上執行,您可以使用遠端檔案系統來瀏覽節點的整個檔案系統。 在瀏覽期間,只會顯示 .ear.jar.sar.war 檔。

    另外,也請利用遠端檔案系統選項來指定已常駐在執行應用程式伺服器之機器的應用程式檔案。例如,欄位值可能是 app_server_install_root/installableApps/test.ear。如果您正在安裝獨立式 WAR 模組,請同時指定環境定義根目錄。

    提示: 在應用程式安裝期間,通常會從執行瀏覽器的用戶端機器中,將應用程式檔案上載到執行管理主控台的伺服器機器,以便部署到其中。在這種情況下,請利用執行管理主控台的 Web 瀏覽器來選取將上傳到伺服器機器的模組。 不過,在某些情況下,應用程式檔案會常駐在 Cell 中的任何節點的檔案系統中。如果要讓應用程式伺服器安裝這些檔案,請使用遠端檔案系統選項。
  2. 如果您在安裝獨立式 Web 應用程式 (WAR) 或階段作業起始通訊協定 (SIP) 模組 (SAR),請指定 WAR 或 SAR 檔的環境定義根目錄。

    環境定義根目錄和定義好的 Servlet 對映(來自 WAR 檔)組合起來就是完整的 URL,使用者就會輸入這個 URL 來存取 Servlet。 比方說,如果環境定義根目錄是 /gettingstarted,而 Servlet 對映是 MySession,URL 便是 http://host:port/gettingstarted/MySession

  3. 下一步來顯示更新應用程式檔案的精靈。這個更新精靈與安裝精靈相當類似,它可以提供欄位讓您指定或編輯應用程式連結資訊。請依照需要來完成更新精靈中的步驟。

當更新完整應用程式時,會解除安裝舊的應用程式,安裝新的應用程式。在儲存配置變更且進行了後續的同步化之後,即會在將執行應用程式的節點上展開應用程式檔案。如果更新應用程式時,應用程式正在節點中執行,就會停止應用程式,更新應用程式檔案,再啟動應用程式。

取代或新增單一模組

應用程式更新選項下,指定在已安裝的應用程式中取代或新增模組。

這個模組可能是 Web 模組(.war 檔)、Enterprise Bean 模組(EJB .jar 檔)、SIP 模組(.sar 檔)或資源配接器模組(連接器 .rar 檔)。

選取這個選項之後,請指定該模組是在本端還是遠端檔案系統上,以及指定該模組的完整路徑名稱。這個路徑會提供更新後的模組在安裝之前的位置。如需本端檔案系統遠端檔案系統的相關資訊,請參閱上述取代整個應用程式的說明。

如果要取代模組,指定的相對路徑(模組 URI)必須符合已安裝的應用程式中將更新之模組的路徑。

如果要將新模組新增到已安裝的應用程式中,指定的相對路徑不能符合已安裝的應用程式中某個模組的路徑。 該值是指您所要的新模組路徑。

如果您在安裝獨立式 Web 或 SIP 模組,請指定環境定義根目錄值。 環境定義根目錄和定義好的 Servlet 對映(來自 .war 檔)組合起來就是完整的 URL,使用者就會輸入這個 URL 來存取 Servlet。 比方說,如果環境定義根目錄是 /gettingstarted,而 Servlet 對映是 MySession,URL 便是 http://host:port/gettingstarted/MySession

之後,指定是否只顯示您需要提供資訊的安裝選項,或顯示所有安裝選項。

當您指定好該模組的必要資訊之後,請按下一步,顯示一個精靈來更新應用程式檔案。這時類似於安裝精靈的更新精靈會提供用來指定或編輯模組連結資訊的欄位。 請依照需要來完成更新精靈中的步驟。

在新增或更新單一模組之後,當儲存配置變更時,會在產品配置儲存庫中,將新的或更新的模組儲存在部署的應用程式中。 當這些變更與節點同步化時,會在節點的檔案系統中新增或更新模組。如果新增或更新模組時,應用程式正在節點中執行,就會發生下列狀況之一:
  • 如果是更新 Web 模組,執行中的 Web 模組便會停止,這時會更新 Web 模組檔,再啟動 Web 模組。
  • 如果是新增模組,在節點中展開新增的模組之後,就會在執行應用程式的應用程式伺服器中啟動新增的模組。應用程式不需要重新啟動。
  • 如果應用程式的類別載入器原則設定為 Single,因而所有模組都共用同一個類別載入器,就會停止整個應用程式,再重新啟動,使模組層次的變更生效。
  • 如果產品配置的安全提供者不支援動態更新,就會停止整個應用程式,再重新啟動,使模組層次的變更生效。
  • 至於模組的所有其他更新,便會停止整個應用程式,更新模組檔,再啟動整個應用程式。
取代或新增單一檔案

應用程式更新選項下,指定在已安裝的應用程式中取代或新增檔案。

請利用這個選項來更新應用程式所用的檔案(不是 .ear.war.sar.rar 或在某些情況下的 .jar 檔)。 您可以使用這個選項來新增或更新未定義為應用程式模組的 .jar 檔。如果要更新 .ear 檔,請使用取代整個應用程式選項。 如果要更新定義為應用程式模組的 .war 檔、.sar 檔、.rar 檔或 .jar 檔,請使用取代或新增單一模組選項。

選取這個選項之後,請指定該檔案是在本端還是遠端檔案系統上,以及指定該檔案的完整路徑名稱。這個路徑會提供更新後的檔案在安裝之前的位置。如需本端檔案系統遠端檔案系統的相關資訊,請參閱取代整個應用程式的說明。

在相對路徑(模組 URI)上,請從 .ear 檔根目錄開始,指定檔案的相對路徑。比方說,如果該檔位於模組 hello.jarcom/company/greeting.class 下,請指定 hello.jar 這個相對路徑。

如果要取代檔案,相對路徑必須符合已安裝的應用程式中,即將更新檔案的相對路徑。

如果要在已安裝的應用程式增加新檔案,這時不能符合已安裝應用程式中現有檔案的相對路徑。 該值是指您所要的新檔案路徑。

在您指定檔案系統和相對路徑後,請按下一步

在新增或更新單一檔案之後,當儲存配置變更時,會在產品配置儲存庫中,將新的或更新的檔案儲存在部署的應用程式中。 當這些變更與節點同步化時,會在節點的檔案系統中新增或更新檔案。如果新增或更新檔案時,應用程式正在節點中執行,就會發生下列狀況之一:
  • 當檔案在應用程式 Meta 資料範圍(META-INF 目錄)新增,或是在任何應用程式範圍或非 Web 模組中更新時,會停止整個應用程式、新增或更新檔案,然後再重新啟動整個應用程式。
  • 當檔案在應用程式非 Meta 資料範圍(META-INF 目錄之外,但不在任何模組中)新增,變更會儲存在檔案系統中,而不會重新啟動執行中的應用程式。
  • 當檔案新增或更新到 Web 模組 Meta 資料(META-INFWEB-INF 目錄)中,會停止執行中的 Web 模組、新增或更新 Web 模組檔,然後再啟動 Web 模組。
  • 至於 Web 模組中的所有其他檔案,便會在節點的檔案系統新增或更新檔案,且不會停止應用程式或它的任何元件。
取代、新增或刪除多個檔案

應用程式更新選項下,指定上傳壓縮檔來更新已安裝之應用程式的多個檔案。 這個選項的單一用途,就是在所安裝之應用程式中,取代檔案、新增檔案以及刪除檔案(根據壓縮檔的內容而定)。 壓縮檔中的每一個項目,都被視為一個檔案,而該壓縮檔從根目錄算起的路徑,則被視為該檔在所安裝之應用程式中的相對路徑。

選取這個選項之後,請指定該壓縮檔是在本端還是遠端檔案系統上,以及指定該壓縮檔的完整路徑名稱。您可能會使用本端檔案系統,因為您在上傳的是壓縮檔,而遠端瀏覽功能只適用於 .ear.sar.war.jar 檔。 請指定一個有效的壓縮檔格式,例如,.zip.gzip。 這個路徑會提供壓縮檔在安裝之前的位置。這個選項會將壓縮檔解壓縮到安裝的應用程式目錄下。

如果瀏覽器和更新的檔案或模組在相同機器中(不論伺服器是否也在相同機器中),請使用本端檔案系統。 所有更新選項都能使用本端檔案系統

如果要取代檔案,則壓縮檔中的檔案,必須與所安裝之應用程式中即將更新的檔案,具有同樣的相對路徑。

如果要在所安裝的應用程式中新增一個檔案,則壓縮檔中的檔案,必須與所安裝之應用程式中的檔案,具有不同的相對路徑。

檔案在已安裝之應用程式中的相對路徑,是將模組的相對路徑(如果檔案是在模組內)和在模組根目錄之後(用 / 分開)的檔案相對路徑連結起來而形成的。

如果要從已安裝的應用程式移除一個檔案,請利用任何保存檔範圍內,一個名叫 META-INF/ibm-partialapp-delete.props 的檔案,在壓縮檔中指定 Meta 資料。 ibm-partialapp-delete.props 檔必須是 ASCII 檔,它會列出該保存檔中即將刪除的檔案,每行一個項目。 該項目可以包含一個識別多個檔案的字串型樣(例如,正規表示式)。這些即將刪除之檔案的檔案路徑,與含有 META-INF/ibm-partialapp-delete.props 檔的保存檔路徑,必須是相對關係。
即將刪除的檔案層次 要加到壓縮檔中的 Metadata.props 檔
應用程式 在壓縮檔中加入 META-INF/ibm-partialapp-delete.props。 在 Metadata.props 檔中,列出即將刪除的檔案。檔案路徑與 META-INF/ibm-partialapp-delete.props 檔位置是相對的關係。

比方說,如果要從 my.ear 檔的根目錄刪除 utils/config.xmi 檔,請在 META-INF/ibm-partialapp-delete.props 檔中,加上 utils/config.xmi 這一行。

模組 請在壓縮檔中併入 module_uri/META-INF/ibm-partialapp-delete.props

如果要刪除模組中的某個檔案,請將相對於模組的檔案路徑併入 Meta 資料 .props 檔中。比方說,如果要從 my.jar 模組中刪除 a/b/c.jsp,請將 a/b/c.jsp 併入壓縮檔內的 my.jar/META-INF/ibm-partialapp-delete.props 檔中。

如果要刪除模組中的多個檔案,請在 metadata.props 檔中列出即將刪除的檔案,每行一個項目。 比方說,如果要從 my.war 檔中刪除所有 JavaServer Pages(.jsp 檔),請在 my.war/META-INF/ibm-partialapp-delete.props 檔中併入 .*jsp 這一行。 這一行是使用正規表示式 .*jsp,來識別 my.war 中所有的 .jsp 檔。

您可以使用一個局部應用程式檔案來新增、刪除和更新多個檔案。

在指定檔案系統路徑後,請按下一步

在局部更新應用程式之後,當儲存配置變更時,會在 WebSphere® Application Server 配置儲存庫中,將新的或更新的應用程式檔儲存在部署的應用程式中。當這些變更與節點同步化時,會在節點的檔案系統中新增或更新檔案。由於局部應用程式選項會更新多個檔案,因此,會利用局部應用程式中的個別檔案來判斷重新啟動的應用程式元件。

範例

以下是局部應用程式壓縮檔中的項目範例:

util.jar
META-INF/ibm-partialapp-delete.props
foo.jar/com/mycomp/xyz.class
xyz.war/welcome.jsp
xyz.war/WEB-INF/web.xml
webmod.war/META-INF/ibm-partialapp-delete.props

在這個範例中,META-INF/ibm-partialapp-delete.props 檔包含 .*.dattools/test.jar 檔。 webmod.war/META-INF/ibm-partialapp-delete.props 檔包含 com/test/.*.jspWEB-INF/test.xmi 檔。

局部應用程式更新選項會執行下列動作:
  • 新增或取代已部署的應用程式中的 util.jar
  • 新增或取代已部署的應用程式的 foo.jar 檔內的 com/mycomp/xyz.class
  • 刪除應用程式中的 *.dat 檔,但不從任何模組中刪除它們。
  • 刪除應用程式中的 tools/test.jar
  • 新增或取代已部署的應用程式之 xyz.war 模組內的 welcome.jsp
  • 取代已部署的應用程式之 xyz.war 模組內的 WEB-INF/web.xml
  • 刪除 webmod.war 模組中的 com/test/*.jsp
  • 刪除 webmod.war 模組中的 WEB-INF/test.xmi

跳出 META-INF/ibm-partialapp-delete.props 檔中的正規表示式 meta 字元。例如,如果要刪除名為 Abc 類別的內部類別,請使用正規表示式 Abc\$.*,其中 $ 是藉由反斜線 (\) 跳出的正規表示式 meta 字元。

META-INF/ibm-partialapp-delete.props 檔可能含有下列文字:

.*.dat

webmod.war/META-INF/ibm-partialapp-delete.props:
com/test/.*.jsp
WEB-INF/test.xmi



標示(線上)的鏈結表示需要存取網際網路。

相關概念
相關工作
相關參考
企業應用程式集合


檔名: urun_rapp_update.html