4. アンインストール

本章では、WebOTX Portalのアンインストール方法について説明します。

事前のバックアップに関しては、 [ 高度な管理と運用サイクルガイド > 1. バックアップ/リストア > 1.2. 環境の退避 ]を参照してください。

4.1. アンインストール前の作業

4.1.1. Windows
4.1.2. Linux

4.1.1. Windows

4.1.1.1. WebOTX Portal

WebOTX Portal をアンインストールする前に次の作業を行なってください。

Webサーバの停止
IISなどの外部Webサーバを使用している場合は、Webサーバを停止してください。停止方法は、各Webサーバのマニュアルを参照してください。
WebOTXサービスの停止
全てのWebOTXのサービスを停止します。停止するサービスは次のとおりですので「コントロールパネル」の「サービスマネージャ」で停止してください。

WebOTX AS Agent Service

WebOTX WatchServer (Enterprise でインストール選択した場合のみ)
DBサーバの起動確認
WebOTX Portal のアンインストール実行時、ポートレットの配備解除を行いますので、 DBサーバにアクセスします。事前にDBサーバが起動しているかを確認してください。

この作業が終わったら[ 4.2. アンインストール作業 ]に進みます。

4.1.1.2. EnterpriseDirectoryServer

EnterpriseDirectoryServer をアンインストールする前に次の作業を行なってください。

EnterpriseDirectoryServer が起動している場合は終了します。
[スタート]→[管理ツール]→[サービス](Windows 2003の場合)より、以下のサービスを停止してください。
- EDS Manager
- EDS Protocol Server
- EDS Replica
必要に応じてEnterpriseDirectoryServer のデータをバックアップしてください。

この作業が終わったら[ 4.2. アンインストール作業 ]に進みます。

4.1.2. Linux

4.1.2.1. WebOTX Portal

Linux では、WebOTX Portal のみをアンインストールすることはできません。
マシンにインストールされている WebOTX 製品のアンインストールを同時に行います。
WebOTX Portal のアンインストールを行う前に次の作業を行なってください。

WebOTXドメインの停止
rootユーザでログインし、次のコマンドを実行してドメインを停止してください。

root> /opt/WebOTX/bin/otxadmin stop-domain WebOTXAdmin
DBサーバの起動確認
次項の「WebOTXの定義情報環境の削除」では、ポートレットの配備解除を行うため、 DBサーバにアクセスを行います。事前にDBサーバが起動しているかを確認してください。
WebOTX Portal の定義情報環境の削除
WebOTX Portal の定義情報環境を削除する際には、環境変数「JAVA_HOME」にJDKのインストールディレクトリが設定されている必要があります。 envコマンドなどで環境変数を確認後、次のコマンドを実行してください。

root> /opt/WebOTX/lib/ant/bin/ant -buildfile /opt/WebOTX/Portal/portal_setup.xml -Dbasedir=/opt/WebOTX/Portal -Dotxdir=/opt/WebOTX -logfile /opt/WebOTX/Portal/portal_uninstall.log -Dinstall.state=uninstall
実行結果は、/opt/WebOTX/Portal/portal_uninstall.logファイルに出力されていますので確認してください。
WebOTXの定義情報環境の削除
V9からはwouninst.sh実行時にWebOTXの定義情報環境の削除を選択して実行することが可能になりましたので、[ 4.2. アンインストール作業 ] に進んでください。
V8以前と同様に事前にWebOTXの定義情報環境を削除する場合のみ以降の作業を行ってください。

WebOTXの定義情報環境を削除する際には、環境変数「JAVA_HOME」にJDKのインストールディレクトリが設定されている必要があります。 envコマンドなどで環境変数を確認後、次のコマンドを実行してください。

root> /opt/WebOTX/lib/ant/bin/ant -buildfile /opt/WebOTX/setup.xml -Dbasedir=/opt/WebOTX -logfile /opt/WebOTX/ant_uninstall.log uninstall
実行結果は、/opt/WebOTX/ant_uninstall.logファイルに出力されていますので確認してください。

この作業が終わったら[ 4.2. アンインストール作業 ]に進みます。

4.1.2.2. EnterpriseDirectoryServer

EnterpriseDirectoryServerをアンインストールする前に次の作業を行なってください。

EnterpriseDirectoryServerが起動している場合は、以下のコマンドをrootユーザで実行してください。
- Linuxの場合)
  root> /opt/nec/eds/bin/EDAGENT stop

この作業が終わったら[ 4.2. アンインストール作業 ]に進みます。

4.2. アンインストール作業

WebOTX Portal をアンインストールする手順について説明します。

4.2.1. Windows
4.2.2. Linux

4.2.1. Windows

4.2.1.1. WebOTX Portal

本節ではWindows版のWebOTX Portalのアンインストールについて説明します。

WebOTXメディアのDVD-ROM媒体を DVD-ROMドライブに挿入すると、WebOTX製品の統合セットアップ画面が表示されます。画面右のインストール済み製品フィールドからアンインストールする製品名を選び、[Uninstall」ボタンを押します。
Windowsインストーラが起動し「インストール準備中」というメッセージのあとに次の画面が表示されます。「次へ」ボタンを押してください。
[プログラムの保守]画面が表示されます。アンインストールを行うために「削除」を選択し「次へ」ボタンを押します。

(参考) プログラムの修復を行う場合には「修復」を選択します。
インストール時に「WebOTX Portal 実行サーバ」をインストールしている場合、[削除オプション]画面が表示されます。
WebOTX Portal 実行サーバのアンインストールに伴って、ドメイン情報を削除するときは「ドメイン情報の削除」をチェック後「次へ」ボタンを押してください。

他のWebOTX製品がまだインストールされている場合や、アンインストール後も定義情報(ドメインの情報)を残したい場合は、そのまま「次へ」ボタンを押します。
[WebOTX Application Server の情報設定]画面が表示されます。「ユーザ名」と「パスワード」を設定し、「次へ」ボタンを押します。
[プログラムの削除]画面が表示されます。「削除」ボタンを押してファイルの削除を開始します。
[アンインストール処理中です。]画面が表示され、WebOTX Portal 環境の削除が始まります。削除が終了するまで時間がかかりますので、しばらくお待ちください。
[アンインストールしています]画面が表示され、ファイルの削除が始まります。削除が終了するまで時間がかかりますので、しばらくお待ちください。
次の画面が表示されたら、アンインストールは完了です。「完了」ボタンを押します。
コンピュータを再起動してください。

[注意事項]

アンインストールは、必ずAdministratorsグループに所属した管理者権限があるユーザで実行してください。
Windows Server 2008/R2 でアンインストールを行う場合は、Build-in Administrator ユーザで実行するか、管理者権限のあるユーザでも「管理者として実行」により WebOTX のメディアに格納されているインストーラを起動してください。
アンインストールする製品以外のWebOTX 製品がマシンにインストールされている場合には、「定義情報の削除」をチェックしないでください。
「定義情報の削除」を選択した場合でも、インストールフォルダにディレクトリやファイルが残る場合があります。アンインストール完了後、すべて削除してください。
Windows 2003 の「コントロールパネル」－「プログラムの追加と削除」で「削除」ボタンを選んだ場合、または、Windows 2008/R2の「コントロールパネル」－「プログラムと機能」で「アンインストール」を選んだ場合には、上記の画面は表示されずにアンインストールが始まります。この場合、定義情報は削除されません。
また、この場合には「WebOTX Application Server SSL通信ライブラリ」が同時にアンインストールされずに残りますので、「コントロールパネル」の「プログラムの追加と削除」または「プログラムと機能」から、別途「WebOTX Application Server SSL通信ライブラリ」をアンインストールしてください。

4.2.1.2. EnterpriseDirectoryServer

コントロールパネルの「アプリケーションの追加と削除」から「EnterpriseDirectoryServer」を選択し、「追加と削除」ボタンを押します。
Windows2003/XP の場合、「アプリケーションの追加と削除」から「変更」または「削除」ボタンを押します。
EnterpriseDirectoryServer削除の確認画面が表示されますので、[はい]をクリックし、アンインストールを開始します。
アンインストールでは、ファイルの削除、サービスの削除、レジストリの削除、環境変数の削除等が行われます。

以上で EnterpriseDirectoryServerのアンインストールは完了です。

4.2.2. Linux

4.2.2.1. WebOTX Portal

WebOTX Portalは複数のインストール・パッケージから構成されています。 WebOTX Portalを含む WebOTX製品をアンインストールする際にはすべての製品をアンインストールしてください。そのためのスクリプトを提供していますのでこれを利用してアンインストールしてください。

/opt/share.nec/bin/wouninst.sh として配置されるアンインストール・スクリプトは、現在インストールされている全てのWebOTXに関連するパッケージをアンインストールします。

手順は次のとおりです。

ログイン名 root でログインします。
login: root
アンインストール・スクリプトが配置されたディレクトリに移ります。
root> cd /opt/share.nec/bin
アンインストール・スクリプトを実行します。
root> ./wouninst.sh
WebOTXの定義情報環境の削除の確認画面が表示されます。
```
Would you like to delete the configuration environment of WebOTX? [y,n] (Default: n)
(All domains will be deleted when 'y' is enterd.)
```
WebOTXの定義情報環境を削除するには「y」を入力してください。
※「y」を入力すると全ドメインの情報が削除されます。
WebOTXの定義情報環境を残すには「n」を入力してください。

Caution
WebOTXの定義情報環境を削除する際には、環境変数「JAVA_HOME」にJDKのインストールディレクトリが設定されている必要があります。
環境変数「JAVA_HOME」が未設定の場合、アンインストールはキャンセルされアンインストール・スクリプトが終了します。
再実行する場合は、環境変数「JAVA_HOME」設定後に再度アンインストール・スクリプトの実行から行ってください。

また、アンインストールスクリプトではWebOTX Portalの定義情報環境の削除は行いません。
WebOTX Portalの定義情報環境の削除を行う場合、次のアンインストール確認画面で「q」を入力してキャンセルし、[ 4.1. アンインストール前の作業 > 4.1.2. Linux > 4.1.2.1. WebOTX Portal ]の[ 3.WebOTX Portal の定義情報環境の削除 ]の作業を行ったのち再度アンインストールスクリプトを実行してください。
アンインストール確認画面が表示されます。
```
      *******************************************************************
      * Uninstallation of WebOTX on your computer. To continue, enter y.*
      * Enter q to exit the uninstall. [y, q]                           *
      *******************************************************************
      
```
アンインストールを開始するには「y」を入力してください。キャンセルするには「q」を入力してください。

キャンセルした場合にはアンインストール・スクリプトが終了します。再実行する場合は、再度アンインストール・スクリプトの実行から行ってください。
スクリプトは、自動的にインストールされているプロダクトを検索してアンインストールを開始します。
ライセンスチェッカをアンインストールします。
・Linuxの場合)

root> rpm -e OTXUTIL

この作業が終わったら[ 4.3. アンインストール後の作業 ]に進んでください。

4.2.2.2. EnterpriseDirectoryServer (Linux)

ログイン名 root でログインします。
login: root
EnterpriseDirectoryServerをアンインストールします。
Linuxの場合)

rpmコマンドを利用してパッケージをアンインストールします。

root> rpm -e eds eds-server (サーバマシンへのインストールを行っていた場合) root> rpm -e eds eds-client (クライアントコンポーネントをインストールした場合) root> rpm -e eds eds-devel (開発環境をインストールした場合)

4.3. アンインストール後の作業

アンインストール後に行う必要のある作業について説明します。

4.3.1. WebOTX Portal

WebOTXの動作環境(ドメイン情報)ファイルの削除を行なってください。
WebOTXの動作環境(ドメイン情報)が残っている場合があります。 WebOTXを再インストールしない場合は、次のファイルを削除してください。

Windowsの場合)

<WebOTXのインストールディレクトリ>\domains 配下の全ファイル <WebOTXのインストールディレクトリ>\Portal 配下の全ファイル

Linuxの場合)

/opt/WebOTX/Portal 配下の全ファイル /opt/WebOTX/ant_setup.log /opt/WebOTX/ant_uninstall.log /opt/WebOTX/(ユーザドメイン名).properties /opt/WebOTX/logs/WOAgentSvc.log WebOTXの定義情報環境の削除を行っていない場合は以下のファイルも残ります。 /opt/WebOTX/domains 配下の全ファイル /opt/WebOTX/lib/install 配下の全ファイル /opt/WebOTX/lib/templates 配下の全ファイル /opt/WebOTX/config/asenv.conf /opt/WebOTX/config/cacerts.jks /opt/WebOTX/bin/otxadmin /opt/WebOTX/bin/asant /opt/WebOTX/bin/jspc /opt/WebOTX/bin/makecpk /opt/WebOTX/bin/prcstop.sh /etc/WebOTX/otx.conf

Windowsの場合で、Windowsファイアウォールが有効な環境の場合、「コントロールパネル」－「Windowsファイアウォール」の「例外設定」に登録されている次の設定情報を削除してください。
なお、「WebOTX Web Server 2.2」は、「Webサーバ2.2」のインストールを　行った場合に登録されます。

プログラムおよびサービス	登録内容
Java	<JAVA_HOME>\jre\bin\java.exe
Java	<JAVA_HOME>\bin\java.exe
Javaw	<JAVA_HOME>\jre\bin\javaw.exe
Javaw	<JAVA_HOME>\bin\javaw.exe
namesv.exe	<INSTALLDIR>\ObjectBroker\bin\Namesv.exe
oad.exe	<INSTALLDIR>\ObjectBroker\bin\oad.exe
WebOTX Web Server 2.2	<INSTALLDIR>\WebServer22\bin\httpd.exe

<JAVA_HOME> ... インストール時に指定したJDK インストール先フォルダ
<INSTALLDIR> ... WebOTX インストール先フォルダ

4.3.2. Webコンテナと外部Webサーバとの連携の設定解除

WebコンテナとWebOTX Webサーバ以外の外部Webサーバとの連携の設定を行った場合、下記の作業を行ってください。

WebOTXをアンインストールしても、外部Webサーバには連携設定の内容が残っているため、連携設定を解除せずそのままWebサーバを使い続けた場合、システムによってはWebサーバが正常に起動しなくなる可能性があります。
特に Unix 環境で Webサーバを自動起動に設定している場合、最悪 Unix が起動しなくなる恐れがあります。

Webサーバごとの連携設定の解除方法を下記に説明します。

IIS
1. IISマネージャを起動します。
2. 仮想ディレクトリの削除
  
  連携していた「Webサイト」を展開し、仮想ディレクトリ「webcont」を削除します。
3. ISAPIフィルタの削除
  
  連携していたWebサイトのプロパティを開き、「ISAPIフィルタ」タブから「webcont」を削除します。
4. 認証設定の変更
  
  IISの設定時に変更した基本認証の設定を必要に応じて変更してください。また、Webコンテナの認証ユーザをWindowsシステムに登録した場合、不要ならばWindowsシステムのユーザを削除してください。
- IIS6.0の場合
  
  IIS6.0を使用している場合、下記の設定変更も必要です。 IISマネージャで左のツリーから「Webサービス拡張」を選択します。右画面にWebサービスの拡張状態が表示されますので、「Webコンテナ用ISAPIモジュール」を指定し、右クリックメニューから削除を選び削除します。
- IIS7.0/7.5の場合
  
  IIS7.0/7.5を使用している場合、下記の設定変更も必要です。 IISマネージャでサーバーの階層で機能ビューの「ISAPIおよびCGIの制限」をダブルクリックします。「Webコンテナ用ISAPIモジュール」を選択し、右クリックメニューから削除を選び削除します。
Apache

Apacheのインストールディレクトリのconfディレクトリ配下にあるhttpd.confファイルを編集します。「# TM_WS_PLUGIN-start 」から「# TM_WS_PLUGIN-end」の記述を削除してください。
# TM_WS_PLUGIN-start include "<WEBOTX_DOMAIN_HOME>/config/WebCont/mod_jk-22.conf-auto" # TM_WS_PLUGIN-end