適用於 Microsoft Windows 的 Sun Java Enterprise System 5 安裝指南

第 7 章解除安裝 Java ES 元件

本章提供解除安裝使用 Java ES 安裝程式安裝的 Sun Java Enterprise System (Java ES) 元件的指示。

本章包含以下各節：

解除安裝程式的運作方式

Java ES 提供了用於移除使用 Java ES 安裝程式安裝在系統中之 Java ES 元件的解除安裝程式。

解除安裝程式的限制

如同 Java ES 安裝程式，解除安裝程式可在圖形或無訊息模式中執行。

解除安裝程式僅移除使用 Java ES 安裝程式安裝的 Java ES 元件。若要移除不是使用 Java ES 安裝程式安裝的 Java ES 元件，請依照 Java ES 元件文件中的指示執行動作。
必須在每台包含 Java ES 元件的主機上分別執行解除安裝程式。不支援遠端解除安裝。在每台主機上，您都可以選取一個或多個 Java ES 元件來進行移除。
解除安裝程式可以移除配置檔案和使用者資料檔案。檔案視每個元件而異。

解除安裝程序完成後，您可能需要移除其他檔案和目錄。如需依產品提供的資訊，請參閱檢閱 Java ES 元件的解除安裝運作方式。
解除安裝程式僅為其執行時所在的系統檢查 Java ES 元件相依性，發現相依性時它會發出警告。

處理相依性

解除安裝程式的運作方式可能會依您所安裝的 Java ES 元件及它們之間的相互關係而有所不同。

解除安裝程式會識別安裝在相同主機上之產品間的相依性。如果您嘗試解除安裝某個 Java ES 元件，而本機主機上安裝了與該元件相依的產品，則解除安裝程式會發出警告。

例如，若您嘗試從主機解除安裝 Access Manager，而此主機還安裝了 Portal Server，則解除安裝程式會警告您 Portal Server 無法在沒有 Access Manager 的情況下運作。
在大部份的狀況下，如果沒有其他 Java ES 元件相依於某個 Java ES 元件，您便可以解除安裝該元件。

例如，Portal Server 相依於 Access Manager，但 Access Manager 並不相依於 Portal Server。如果您嘗試解除安裝 Portal Server，解除安裝程式不會發佈警告，因為 Access Manager 不需要 Portal Server 即可運作。

注意 –

解除安裝 Java ES 元件時，您必須確定為該 Java ES 元件配置了哪些產品 (可能需要進行一些額外配置)。否則，您的系統上可能會出現配置為支援已不再存在之產品的 Java ES 元件。

解除安裝程式無法識別以下相依性：

來自遠端主機的相依性
由配置產生的相依性

來自遠端主機的 Java ES 元件相依性

部份 Java ES 元件相依性可以透過遠端主機上部署的 Java ES 元件得到滿足。解除安裝程式無法識別這些相依性關係。

例如，如果您解除安裝 Directory Server，解除安裝程式並不會警告您 Access Manager 依存於 Directory Server，即使兩個產品部署在相同的主機上。這是因為另一台主機上的另一個 Directory Server 實例可以支援 Access Manager。

由配置產生的 Java ES 元件相依性

解除安裝程式無法識別因安裝後配置所導致的 Java ES 元件相依性。

驗證先決條件

下表列出解除安裝之前應該執行的作業。有些作業可能不適用於您的特定情況。

左欄列出您執行這些工作應遵守的順序，右欄包含其他有用資訊及說明的位置。

表 7–1 檢核清單


作業說明	說明或有用的資訊
1. 檢閱您計劃解除安裝之各個 Java ES 元件的需求和運作方式。	檢閱 Java ES 元件的解除安裝運作方式
2. 識別因配置而產生之元件相依性，並採取適當的措施，例如備份資料、從支援的 Java ES 元件取消配置相依的 Java ES 元件，或按照適當的順序解除安裝 Java ES 元件。	處理相依性
3. 若您計劃在後續安裝中重複使用所要解除安裝之 Java ES 元件的配置或使用者資料，請將它們備份或歸檔。	檢閱 Java ES 元件的解除安裝運作方式
4. 確定代管配置目錄的 Directory Server 實例正在執行。備註：大部份的狀況下， Web 容器和 Directory Server 在解除安裝前應在執行，其他伺服器則應關閉。	本 Directory Server 實例必須執行，如此解除安裝程式才能取消您正在解除安裝之 Java ES 元件的配置。

檢閱 Java ES 元件的解除安裝運作方式

檢閱本節中的相關表格，以檢視解除安裝程式對 Java ES 元件執行的動作。規劃要採取的步驟，以防止資料遺失或相依性連接的遺失。

本節包含以下小節：

Access Manager 的解除安裝運作方式

表 7–2 Access Manager 的解除安裝詳細資訊


主題	詳細資訊
配置資料	不會移除 Directory Server 中的任何項目 (包括 Access Manager 特定資料)。
此元件需要的其他安裝	Directory Server Web 容器
需要此安裝的產品	Portal Server (必須位於 Access Manager SDK 所在的主機上)
解除安裝前的作業	無
解除安裝後的作業	僅對於 Web Server 或 Application Server 上的完整安裝，解除安裝過程才會取消配置 Web 容器中的 Access Manager。

Application Server 的解除安裝運作方式

表 7–3 Application Server 解除安裝詳細資訊


主題	詳細資訊
配置資料和使用者資料	解除安裝期間會移除安裝期間建立的預設網域。解除安裝期間，系統不會移除使用者建立的網域，包括所有管理伺服器和 Application Server 實例。完成解除安裝之前，所有 Administration Server 實例和 Application Server 實例都會停止。
相依性	在同一系統上需要 Message Queue。
需要此安裝的產品	配置為使用 Application Server 做為 Web 容器的元件：Access Manager、Portal Server。
解除安裝前的作業	若要保留配置資料，請複製管理網域目錄。
解除安裝後	若要從系統中完全移除 Application Server，請移除所有剩餘的 Application Server 記錄檔和目錄。Application Server 目錄的預設位置是 `\JavaES-Install-Dir\appserver`。如需 Message Queue 解除安裝後作業的相關資訊，請參閱Message Queue 的解除安裝運作方式。

Directory Server 的解除安裝運作方式

表 7–4 Directory Server 的解除安裝詳細資訊


主題	詳細資訊
配置資料和使用者資料	如果您要解除安裝代管使用者資料的 Directory Server 實例，則解除安裝期間系統會移除 Directory Server LDAP 資料庫。警告：為避免遺失資料，請務必在解除安裝之前備份 Directory Server 資訊。Directory Server 有數種工具和公用程式，用於備份 Directory Server 和遷移配置資料。
相依性	無
需要此安裝的產品	Access Manager Portal Server
解除安裝前的作業	根據需要備份 Directory Server LDAP 資料庫。
解除安裝後的作業	若您以後在同一位置安裝 Directory Server，則安裝目錄一定不能存在。在同一位置重新安裝之前，您可能需要手動移除安裝目錄和所有自訂配置檔案。

Message Queue 的解除安裝運作方式

表 7–5 Message Queue 的解除安裝詳細資訊


主題	詳細資訊
配置資料	解除安裝後特定實例的配置、使用者儲存庫和存取控制檔案都會保留，並可在以後安裝時重複使用。
此元件需要的其他安裝	Directory Server (選擇性)
需要此安裝的產品	Application Server (必須位於 Message Queue 所在的主機上)
解除安裝前的作業	停止任何執行的代理程式。系統會提示您輸入使用者名稱 (管理員) 和密碼：`imqcmd shutdown bkr` [ `-b` `hostName:port`] 如果您並沒有要重新安裝 Message Queue，因此想要刪除動態資料、平面檔案使用者儲存庫以及與各代理程式實例相關的存取控制檔案，請使用下列指令移除這些資料。`imqbrokerd -name` `instanceName` `-remove` `instance` 如果您使用 Message Queue 升級程序檔升級 Message Queue，請記錄您的程序。升級程序檔不會向 Java ES 註冊檔寫入安裝資訊。
解除安裝後的作業	如果您不打算重新安裝 Message Queue，請使用 Java ES 元件文件中的指令清理系統。

Monitoring Console 的解除安裝運作方式

表 7–6 Monitoring Console 的解除安裝詳細資訊


主題	詳細資訊
配置資料	解除安裝後，系統仍會保留使用者資料。但是此資料會在重新安裝前先行移除。
相依性	無
需要此安裝的其他產品	無
解除安裝前的作業	無
解除安裝後的作業

Portal Server 的解除安裝運作方式

表 7–7 Portal Server 的解除安裝詳細資訊


主題	詳細資訊
配置資料和使用者資料	解除安裝期間移除配置資料。取消配置包括移除 Access Manager 中由 Portal Server 建立的服務。解除安裝期間不會移除使用者通道的提供者，並可在以後安裝時重新使用。解除安裝程式不會移除自訂配置資料 (顯示設定檔、特性檔案、資源字串以及其他自訂內容)。在以後的安裝中，僅當 Portal Server 使用同一配置重新安裝到同一主機時，才能重複使用配置資料。
此元件需要的其他安裝	Directory Server Application Server 或 Web Server Access Manager Service Registry
需要此安裝的產品	無
解除安裝前的作業	驗證 Directory Server 和 Web 容器正在執行。
解除安裝後的作業	如果您是在 Web Server 中執行 Portal Server 的，並且您選擇只移除 Portal Server，則必須重新啟動 Access Manager。如需詳細資訊，請參閱Access Manager 的解除安裝運作方式。

Portal Server Secure Remote Access 的解除安裝運作方式

表 7–8 Portal Server Secure Remote Access 的解除安裝詳細資訊


主題	詳細資訊
配置資料	解除安裝期間，系統會移除 Portal Server Secure Remote Access 核心元件的所有配置資料。已部署的所有 Web 應用程式都被解除部署。使用者沒有對 Portal Server Secure Remote Access Gateway、Netlet Proxy 及 Rewriter Proxy 子元件配置資料的存取權限。
此元件需要的其他安裝	Portal Server Secure Remote Access 依賴於 Portal Server，且無法在 Portal Server 上個別解除安裝。 Portal Server、Secure Remote Access Gateway、Netlet Proxy 和 Rewriter Proxy 子元件依賴於 Access Manager SDK。 Portal Server 和 Portal Server Secure Remote Access Support 必須位在同一個主機和同一個目錄中。 Access Manager SDK 必須位於閘道、Netlet 代理程式和 Rewriter 代理程式所在的主機上。閘道、Netlet 代理程式和 Rewriter 代理程式不能位於同一目錄。您無需移除任何相依 Java ES 元件，即可移除任一個 Portal Server Secure Remote Access 元件。您可以在主機上移除閘道並保留 Access Manager SDK。
需要此安裝的產品	無
解除安裝前的作業	無
解除安裝後的作業	無

如果已配置 SRA，則首先使用 psadmin 指令手動解除安裝 SRA 元件。

解除安裝 SRA 元件：

停止 SRA 實例。

stop-sra-instance --adminuser userid --passwordfile password-filename --name sra-instance-name --type instance-type --hostname instance-hostname

刪除 SRA 實例。

psadmin delete-sra-instance --adminuser userid --passwordfile password-filename --name sra-instance-name --type instance-type --hostname instance-hostname

備註 –
解除安裝程式不會解除安裝已配置的 SRA 元件。因此，您需要手動解除安裝已配置的 SRA 元件。若無法手動解除安裝，會導致同一台主機上的後續安裝發生安裝問題。

Service Registry 的解除安裝運作方式

表 7–9 Service Registry 解除安裝詳細資訊


主題	詳細資訊
配置資料	Registry 配置程序會在 `JavaES-install-dir` 目錄中安裝 Registry 資料庫網域和伺服器金鑰庫。將 Service Registry 解除安裝時不會移除該目錄。此安全機制可讓您保留資料庫，以供在以後安裝時或在未來發行版本中使用 (若您想這麼做)。
此元件需要的其他安裝	Application Server (Domain Administration Server 和 Command-Line Administration Tool) HADB Message Queue
需要此安裝的產品	無
解除安裝前的作業	1. 停止 Service Registry 網域，如下所示： `JavaES-install-dir\share\ant\bin\ant.bat -f build-install.xml appserver.domain.stop` 2. 刪除 Service Registry 網域，如下所示： `JavaES-install-dir\share\ant\bin\ant.bat -f build-install.xml appserver.domain.delete` 如果您要保留 Registry 資料庫供日後使用，請先複製 `ServiceRegistry-base` 目錄至另一個位置，再重新安裝 Registry。
解除安裝後的作業	若您為 Registry 資料庫建立了副本，請在重新安裝後將資料庫複製回來。復原資料庫和金鑰庫檔案 (儲存在 3.0 目錄中) 後，請使用特定平台的變數執行下列指令： `JavaES-install-dir\share\ant\bin\ant.bat -f build-install.xml appserver.domain.stop export.registryOperatorCert install.cacerts appserver.domain.start` 此指令讓現有使用者可以繼續使用 Service Registry Web Console。

Web Proxy Server 的解除安裝運作方式

表 7–10 Web Proxy Server 的解除安裝詳細資訊


主題	詳細資訊
配置資料	只會保留安裝位置下別名目錄中的憑證資料庫檔案。所有其他檔案都會移除。
相依性	Directory Server (選擇性) 如果已選取外部 LDAP 存取控制。
解除安裝前的作業	停止所有的 Web Proxy Server 實例。
解除安裝後的作業	憑證資料庫會保留在 `WebProxyServer-base\alias` 目錄下。您需要先移動憑證資料庫，刪除舊的安裝目錄，再重新安裝。

Web Server 的解除安裝運作方式

表 7–11 Web Server 的解除安裝詳細資訊


主題	詳細資訊
配置資料和使用者資料	Web Server 管理伺服器和 Web Server 實例會在解除安裝完成之前停止。若不執行解除安裝程式，則無法移除 Web Server 安裝或實例目錄。
此元件需要的其他安裝	無
需要此安裝的產品	配置為使用 Web Server 做為 Web 容器的元件：Access Manager 和 Portal Server。還有 Application Server 負載平衡外掛程式 (如果 Application Server 使用 Web Server 做為其 Web 容器)。
解除安裝前的作業	無
解除安裝後的作業	若要保留配置資料，請備份安裝位置下的管理伺服器和 Web Server 實例目錄。若您以後在同一位置安裝 Web Server，則安裝目錄一定不能存在。在同一位置重新安裝之前，您可能需要手動移除安裝目錄和所有自訂配置檔案。

在圖形模式下執行解除安裝程式

在您完成驗證先決條件中的相關作業後，便可以執行解除安裝程式。

啟動 Windows 精靈/圖形化解除安裝程式

選擇 [開始] > [設定] > [控制台]。

連按兩下 [新增/移除程式]。

選取 Sun Java Enterprise Systems。

按一下 [變更] 或 [移除]。

出現用於修改或移除程式的 [歡迎] 頁面。

修改目前安裝

在 Install Shield 精靈中選取 [修改]，以便增加新程式功能或移除目前安裝的功能。

按 [下一步]。

顯示 [元件選取] 頁面。

檢查元件。
- 安裝在您系統上的元件會被啟用，可以進行選取。未安裝在您系統上的元件會被停用，無法進行選取。
  - 某些元件包含子元件。展開這些元件以檢視其子元件。
  - 若您取消選取包含子元件的元件，請展開該元件以驗證子元件清單。

請選取您要安裝的元件並取消選取您要解除安裝的元件。按 [下一步]。

解除安裝程式即會修改軟體。

移除所有已安裝元件

在 Install Shield 精靈中選取 [移除]。

按 [下一步]。

將顯示一確認對話方塊。

按一下 [是] 以確認移除。

出現 [安裝狀態] 頁面，隨後出現 [取消配置] 對話方塊。

按一下 [是] 確認取消 Java ES 元件的配置。

產品即被取消配置，而伺服器則被停止並移除。

出現精靈的 [完成] 頁面。您可以按一下 [檢視摘要] 按鈕來檢視安裝或解除安裝的詳細資訊摘要。

按一下 [完成] 以結束解除安裝精靈。

以無訊息模式執行解除安裝程式

若要將多台主機上共用類似配置之 Java ES 元件解除安裝，無訊息解除安裝會很有用。以無訊息模式解除安裝的程序，類似於第 4 章, 以無訊息模式安裝所述的以無訊息模式安裝的程序。

以無訊息模式執行解除安裝

變更至安裝程式所在的目錄：

cd JavaES-install-dir

使用 Setup.bat /r 指令建立回應檔案。

使用 /f1 選項指定建立回應檔案的位置並命名。為避免發生不可預測的結果，請為副檔名為 .iss 的檔案指定絕對路徑。例如，鍵入：

Setup.bat /r /f1"C:\Temp\UninstallExample.iss"

所有鍵入的資料和選取的選項都會記錄在 .iss 檔案中。

回應檔案已準備就緒，可以與記錄解除安裝期間所選取的選項搭配使用。可以手動編輯回應檔案以修改記錄的選項。

現在您可以使用回應檔案來啟動無訊息解除安裝。

變更至安裝程式所在的目錄。

cd JavaES-install-dir

鍵入 Setup.bat /s 指令以啟動無訊息模式解除安裝程序。

使用 /f1 選項以指定 .iss 檔案位置。為了避免產生不可預測的結果，請指定絕對路徑。例如，鍵入：

Setup.bat /s /f1" C:\Temp\UninstallExample.iss"。

(可選擇) 使用 /f2 選項為記錄檔指定替代名稱和位置。為了避免產生不可預測的結果，請指定檔案的絕對路徑。例如，鍵入：

Setup.bat /s /f1"C:\Temp\UninstallExample.iss /f2" C:\Setup.log"。

在解除安裝程式執行時，您可以透過檢查安裝記錄的變更來監視其進度。

第 7 章 解除安裝 Java ES 元件