請利用這個頁面來更新已經安裝在伺服器的企業應用程式、模組或檔案。
指定您在「企業應用程式」頁面上選取的已安裝(或已部署)的應用程式名稱。
在應用程式更新選項下,指定以新的(或更新過的)企業應用程式 .ear 檔,取代已安裝在伺服器的應用程式。
在選取這個選項之後,請執行下列動作:
如果瀏覽器和更新的檔案或模組在相同機器中(不論伺服器是否也在相同機器中),請使用本端檔案系統。 所有更新選項都能使用本端檔案系統。
如果應用程式檔案在現行 Cell 環境定義的任何節點中,請使用遠端檔案系統。
在多重伺服器的安裝架構上,如果節點代理程式或部署管理程式是在所選節點上執行,您可以使用遠端檔案系統來瀏覽節點的整個檔案系統。 在瀏覽期間,只會顯示 .ear、.jar、.sar 或 .war 檔。
另外,也請利用遠端檔案系統選項來指定已常駐在執行應用程式伺服器之機器的應用程式檔案。例如,欄位值可能是 app_server_install_root/installableApps/test.ear。如果您正在安裝獨立式 WAR 模組,請同時指定環境定義根目錄。
環境定義根目錄和定義好的 Servlet 對映(來自 WAR 檔)組合起來就是完整的 URL,使用者就會輸入這個 URL 來存取 Servlet。 比方說,如果環境定義根目錄是 /gettingstarted,而 Servlet 對映是 MySession,URL 便是 http://host:port/gettingstarted/MySession。
當更新完整應用程式時,會解除安裝舊的應用程式,安裝新的應用程式。在儲存配置變更且進行了後續的同步化之後,即會在將執行應用程式的節點上展開應用程式檔案。如果更新應用程式時,應用程式正在節點中執行,就會停止應用程式,更新應用程式檔案,再啟動應用程式。
在應用程式更新選項下,指定在已安裝的應用程式中取代或新增模組。
這個模組可能是 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。
之後,指定是否只顯示您需要提供資訊的安裝選項,或顯示所有安裝選項。
當您指定好該模組的必要資訊之後,請按下一步,顯示一個精靈來更新應用程式檔案。這時類似於安裝精靈的更新精靈會提供用來指定或編輯模組連結資訊的欄位。 請依照需要來完成更新精靈中的步驟。
在應用程式更新選項下,指定在已安裝的應用程式中取代或新增檔案。
請利用這個選項來更新應用程式所用的檔案(不是 .ear、.war、.sar、.rar 或在某些情況下的 .jar 檔)。 您可以使用這個選項來新增或更新未定義為應用程式模組的 .jar 檔。如果要更新 .ear 檔,請使用取代整個應用程式選項。 如果要更新定義為應用程式模組的 .war 檔、.sar 檔、.rar 檔或 .jar 檔,請使用取代或新增單一模組選項。
選取這個選項之後,請指定該檔案是在本端還是遠端檔案系統上,以及指定該檔案的完整路徑名稱。這個路徑會提供更新後的檔案在安裝之前的位置。如需本端檔案系統和遠端檔案系統的相關資訊,請參閱取代整個應用程式的說明。
在相對路徑(模組 URI)上,請從 .ear 檔根目錄開始,指定檔案的相對路徑。比方說,如果該檔位於模組 hello.jar 的 com/company/greeting.class 下,請指定 hello.jar 這個相對路徑。
如果要取代檔案,相對路徑必須符合已安裝的應用程式中,即將更新檔案的相對路徑。
如果要在已安裝的應用程式增加新檔案,這時不能符合已安裝應用程式中現有檔案的相對路徑。 該值是指您所要的新檔案路徑。
在您指定檔案系統和相對路徑後,請按下一步。
在應用程式更新選項下,指定上傳壓縮檔來更新已安裝之應用程式的多個檔案。 這個選項的單一用途,就是在所安裝之應用程式中,取代檔案、新增檔案以及刪除檔案(根據壓縮檔的內容而定)。 壓縮檔中的每一個項目,都被視為一個檔案,而該壓縮檔從根目錄算起的路徑,則被視為該檔在所安裝之應用程式中的相對路徑。
選取這個選項之後,請指定該壓縮檔是在本端還是遠端檔案系統上,以及指定該壓縮檔的完整路徑名稱。您可能會使用本端檔案系統,因為您在上傳的是壓縮檔,而遠端瀏覽功能只適用於 .ear、.sar、.war 或 .jar 檔。 請指定一個有效的壓縮檔格式,例如,.zip 或 .gzip。 這個路徑會提供壓縮檔在安裝之前的位置。這個選項會將壓縮檔解壓縮到安裝的應用程式目錄下。
如果瀏覽器和更新的檔案或模組在相同機器中(不論伺服器是否也在相同機器中),請使用本端檔案系統。 所有更新選項都能使用本端檔案系統。
如果要取代檔案,則壓縮檔中的檔案,必須與所安裝之應用程式中即將更新的檔案,具有同樣的相對路徑。
如果要在所安裝的應用程式中新增一個檔案,則壓縮檔中的檔案,必須與所安裝之應用程式中的檔案,具有不同的相對路徑。
檔案在已安裝之應用程式中的相對路徑,是將模組的相對路徑(如果檔案是在模組內)和在模組根目錄之後(用 / 分開)的檔案相對路徑連結起來而形成的。
即將刪除的檔案層次 | 要加到壓縮檔中的 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 檔包含 .*.dat 和 tools/test.jar 檔。 webmod.war/META-INF/ibm-partialapp-delete.props 檔包含 com/test/.*.jsp 和 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