Cosminexus V9 アプリケーションサーバ システム構築・運用ガイド

[目次][用語][索引][前へ][次へ]

付録J.1 Application Serverをインストールおよびアンインストールするときの注意事項

Application Serverをインストールおよびアンインストールするときの注意事項を作業のタイミングに分けて説明します。

<この項の構成>
(1) 作業前に確認する注意事項
(2) 作業中に確認する注意事項
(3) 作業後に確認する注意事項

(1) 作業前に確認する注意事項

分類 注意事項 新規インストール 更新インストール アンインストール
OS共通 ユーザ定義ファイルなど,カスタマイズ用のファイルが格納されたディレクトリ以外は,すべて削除されます。このため,製品のディレクトリ下に必要なファイルを格納しないでください。
削除対象となっているディレクトリは無条件に削除されます。このため,これらのディレクトリにユーザ固有のファイルなどを格納しないでください。
このバージョンの製品または評価版をインストールしてアンインストールしたあとに古いバージョンの製品をインストールする場合は,インストール先にこのバージョンで作成された環境(<Application Serverのインストールディレクトリ>\CC,または/opt/Cosminexus/CC)が残っていないことを確認してください。このバージョンで作成された環境が残っていると,古いバージョンへ移行されないため,製品の動作やそのあとの更新インストールなどが保証されません。このバージョンで作成された環境が残っている場合は,インストール先を変更するか,このバージョンで作成された環境を削除または移動してからインストールしてください。
Windows共通 この製品は,後継製品とする旧製品のアプリケーションサーバがインストール済みの環境にはインストールできません。この場合は,インストール済みの旧製品をアンインストールしたあとに,インストールしてください。
製品をインストールする前に,インストール先ディスクの空き容量を確認し,インストールに必要な空き容量が十分確保されていることを確認してください。
製品を更新インストールする場合は,必ずインストール前に,ユーザ作成ファイルなどの必要なファイルをバックアップしてください。
また,異なるバージョンへの更新インストール(バージョンアップ)をする場合,製品で提供しているファイルをほかのディレクトリにコピーして運用しているときは,更新インストール後に新しくインストールされたファイルをコピーし直してから運用してください。
製品をインストールおよびアンインストールする前に,起動中のアプリケーションは終了させてください。常駐プログラムも終了させてください。
この製品が提供するプログラムやサービスを実行中の状態で,インストールまたはアンインストールすると障害が発生することがあります。製品が提供するプログラムやサービス,および不要なプログラムやサービスは停止した状態にしてから,インストールまたはアンインストールしてください。
この製品が提供するファイルを使用中の状態で,インストールまたはアンインストールすると障害が発生することがあります。製品が提供するファイルは使用しない状態にしてから,インストールまたはアンインストールしてください。
「Hitachi Web Server」サービスが登録されている環境では,同一バージョンの更新インストール(上書き)をする前に,「Hitachi Web Server」サービスを停止してください。
製品および構成ソフトウェアのインストールおよびアンインストール開始時に,セットアップの準備を示すダイアログが表示されます。このダイアログ内のキャンセルボタンは押さないでください。
バージョンダウンとなるような更新インストールは実行しないでください。
Management Serverおよび運用管理エージェントのサービスのログオンアカウントには,デフォルトであるローカルシステムアカウント以外は指定しないでください。ただし,J2EEアプリケーションからネットワークリソースへアクセスする場合には,運用管理エージェントのサービスのログオンアカウントをローカルホストのAdministratorsグループに所属するように設定してください。
単体版のWeb Serverがインストール済みの環境に,HTTP Serverはインストールできません。単体版のWeb Serverをアンインストールしてから,インストールしてください。
単体版のWeb Serverをアンインストールする前に,必要なファイルをバックアップしてください。
単体版のWeb Serverがインストール済みの環境に製品をインストールする場合は,単体版のWeb Serverで使用していたファイル(httpsd.confなどのコンフィグファイルやユーザが作成したコンテンツ)を移行し,新しいインストールディレクトリに対応するように,必要な修正をしてください。
Windows x64 インストール先に<システムドライブ>:\Windows\System32 ディレクトリ下は指定しないでください。
次に示す製品の場合,Windowsの32ビット版製品がインストール済みの環境に,Windowsの64ビット版製品はインストールできません。
  • Application Server
  • Developer
  • Service Architect
  • Service Platform
Windowsの64ビット版製品を誤ってインストールした場合はアンインストールしてください。Windowsの64ビット版製品をインストールする場合には,Windowsの32ビット版製品をアンインストールしたあとに,インストールを実施してください。
Windows x86 Windows XPに次の製品をインストールする場合,Windows XPで修正プログラムQ328310が適用されているときは,製品のインストール前に,修正プログラムQ329623を適用してください。
  • Client
  • Developer
  • Service Architect
次に示す製品の場合,Windowsの64ビット版製品がインストール済みの環境に,Windowsの32ビット版製品はインストールできません。
  • Application Server
  • Developer
  • Service Architect
  • Service Platform
Windowsの32ビット版製品を誤ってインストールした場合はアンインストールしてください。Windowsの32ビット版製品をインストールする場合には,Windowsの64ビット版製品をアンインストールしたあとに,インストールを実施してください。
UNIX共通 次の製品を使用する場合には,製品の共通モジュールを必ずインストールしてください。
  • Application Server
  • Service Platform
また,アプリケーションサーバ Version 6以前のCommon Libraryがすでにインストールされている場合は,Common Libraryをアンインストールしたあとに,製品の共通モジュールをインストールしてください。
製品のインストールおよびアンインストールでは,PPインストーラを使用します。インストールおよびアンインストールにはroot権限が必要です。
トレース共通ライブラリは,製品の構成ソフトウェアをアンインストールしたときに,必要に応じてアンインストールされます。ただし,トレース共通ライブラリのアンインストールに失敗してメッセージが表示された場合には,コマンドを実行してトレース共通ライブラリ単体でアンインストールすることもできます。
アンインストールするには,次のコマンドを実行します。
/opt/hitachi/HNTRLib2/etc/hntr2setup
メニューが表示されるので,通常アンインストールは「9」を,強制アンインストールは「0」を選択してください。
インストールディレクトリが変更されていたときは,新規インストールになります。
OSインストール後のデフォルトの設定では,/etc/hostsファイルに127.0.0.1のIPアドレスに対して自ホスト名が設定されます。TPBrokerを使って通信する場合には,ネットワークインタフェースに割り当てられたIPアドレスに対して自ホスト名が設定されている必要があります。そのため,/etc/hostsファイルには,自ホスト名に対してネットワークインタフェースに割り当てられた適切なIPアドレスを設定してください。
OSインストール後のデフォルトの設定では,/etc/hostsファイルに127.0.0.1のIPアドレスに対して自ホスト名が設定されます。Performance Tracerを使う場合には,ネットワークインタフェースに割り当てられたIPアドレスに対して自ホスト名が設定されている必要があります。そのため,/etc/hostsファイルには,自ホスト名に対してネットワークインタフェースに割り当てられた適切なIPアドレスを設定してください。
Application ServerおよびService Platformの場合,インストール先に,ディスク占有量分の空きがあることを確認してください。ディスク占有量については,「リリースノート」でご確認ください。
Application ServerおよびService Platformの場合,一時ディレクトリ(/tmp)に,ディスク占有量分の空きがあることを確認してください。ディスク占有量については,「リリースノート」でご確認ください。 /tmpに空きがない場合は,容量に空きがあるディレクトリを環境変数TMPDIRに設定してからインストールしてください。

(凡例)○:該当します。 −:該当しません。


(2) 作業中に確認する注意事項

分類 注意事項 新規インストール 更新インストール アンインストール
Windows共通 「Hitachi Web Server」サービスが登録されている環境では,同一バージョンの更新インストール(上書き)時にエラー(レジストリアクセスエラーなど)が発生した場合は,アンインストールしたあと,再度インストールしてください。
インストーラを使用してインストールしているときは,絶対に,製品の提供媒体をCD-ROMドライブから外したり,インストーラを強制終了させたりしないでください。これらの操作をすると,インストール情報に不整合が発生し,以降,インストールおよびアンインストールが実行できなくなるおそれがあります。
インストールの処理を完了するためにインストール終了後,必ずOSを再起動してください。なお,インストール後,アンインストールする場合もインストールを完了させるためにOSを再起動してから,アンインストールしてください。
製品をアンインストールした場合,または製品に含まれる構成ソフトウェアをアンインストールした場合は,アンインストールを完了させるために必ずOSを再起動させてください。
製品および製品に含まれる構成ソフトウェアでは,インストール終了処理に時間が掛かることがあります。インストールが完了し,次の画面に移るまで待ってください。
インストール中にキャンセルした場合は,キャンセルした構成ソフトウェアからあとのインストール処理がキャンセルされます。キャンセルした構成ソフトウェアより前に処理が完了した構成ソフトウェアはインストールされた状態になります。
また,アンインストール中にキャンセルした場合も,キャンセルした構成ソフトウェアからあとのアンインストール処理がキャンセルされます。キャンセルした構成ソフトウェアより前に処理が完了した構成ソフトウェアはアンインストールされた状態になります。
途中で一度もアンインストールしないで,同一バージョンの更新インストールを複数回実行したあとにアンインストールをすると,エラーが発生して失敗することがあります。この場合は,再度アンインストールを実行してください。一部のディレクトリおよびファイルが削除されないことがありますが,次回のインストールの実行には影響ありません。
インストールの途中でインストーラから呼び出しているconime.exeプロセスが終了しないまま,インストール処理がハングアップすることがあります。conime.exeプロセスが存在している状態でインストール処理がハングアップした場合は,タスクマネージャ(Taskmgr.exe)などから起動中のconime.exeを終了させてください。

(凡例)○:該当します。 −:該当しません。


(3) 作業後に確認する注意事項

分類 注意事項 新規インストール 更新インストール アンインストール
OS共通 インストールに失敗した場合は,次の点を確認してください。
  • 起動しているサービスやアクセス中のファイル,ディレクトリがないか
  • ファイル,ディレクトリのアクセス権が拒否されていないか
異なるバージョンへの更新インストール(バージョンアップ)をして環境を移行した場合,作業ディレクトリは旧バージョンで使用していたディレクトリを引き続き使用します。旧バージョンの作業ディレクトリを誤って削除しないようにしてください。
08-00より前から08-00以降への更新インストール(バージョンアップ)をした場合,運用管理ポータルの「論理サーバのアプリケーション管理」は,V7互換モードで動作します。V8モードで動作したい場合は,mserver.propertiesのcom.cosminexus.mngsvr.compat.operation_appキーに「false」を設定してください。
運用管理エージェントの設定ファイルであるadminagent.xmlは,インストール時に上書きされ,既存のファイルはadminagent.xml.bakとして退避されます。adminagent.xmlを編集して運用している場合は,新たにインストールされたファイルに,以前に編集した項目を再編集してください。
snapshotログ収集先対象リストファイルであるsnapshotlog.conf,およびsnapshotlog.2.confは,インストール時に上書きされ,既存のファイルはsnapshotlog.conf.bak,およびsnapshotlog.2.conf.bakとして退避されます。snapshotログの収集対象を編集して運用している場合は,新たにインストールされたファイルに,以前に編集した項目を再編集してください。
Windows共通 「Hitachi Web Server」サービスが登録されている環境では,同一バージョンの更新インストール(上書き)をしたあと,「Hitachi Web Server」サービスがそのまま残ります。「Cosminexus HTTP Server」サービスは登録されません。
「Hitachi Web Server」サービスが登録されている環境では,Web Serverから異なるバージョンへの更新インストール(バージョンアップ)をする場合,HTMLマニュアル,GUIサーバ管理機能に関するファイル,ディレクトリ,ユティリティなどが削除されないで残ることがあります。これらのファイルは更新後のバージョンでは使用できません。
UNIX共通 インストール先のディレクトリおよびファイルは,root権限のあるユーザだけが更新できます。このため,Component Container管理者を設定している場合は,次に示すディレクトリおよびファイルに,Component Container管理者の書き込み権限を設定してください。
  • /opt/Cosminexus/c4web/attachmentsディレクトリ
  • /opt/Cosminexus/c4web/confディレクトリ以下のファイル
  • /opt/Cosminexus/c4web/logsディレクトリ
また,添付ファイルの退避先ディレクトリや,トレースファイルの出力先ディレクトリを指定している場合は,そのディレクトリの属性も設定してください。
なお,同一バージョンの更新インストール(上書き)をした場合,各ディレクトリおよびファイルの属性はデフォルトの状態に戻ります。この場合,運用に合わせて,各ディレクトリおよびファイルの属性を変更してください。

(凡例)○:該当します。 −:該当しません。