3.2.3　インストール・アンインストール時の注意事項

(1)　インストールについて

• ほかの製品のインストール先フォルダと同じフォルダにインストールしないでください。

• JP1/Baseによって作成される最上位フォルダ（JP1Base），下位フォルダ，およびファイルは，ユーザーが指定したインストール先フォルダの権限を継承します。インストール先フォルダには，次に示す権限（参照，実行，更新）を設定することをお勧めします。

  • AdministratorsグループおよびSYSTEMアカウント：フルコントロール

  • Usersアカウント：読み取りと実行

• インストール時に，ファイルmsvcrt.dllを置き換えるかどうかを問い合わせるダイアログボックスが表示された場合，必ず［再起動］を選択してファイルを置き換え，インストール後にシステムを再起動してください。「無視」を選択して古いバージョンのmsvcrt.dllを残した場合，イベントの時刻がずれるなど，正しく動作しなくなることがあります。

  また，ほかの製品をインストールしたあとに，イベントの時刻がずれるなどの動作不正が発生した場合は，JP1/Baseを再インストールしてください。

• JP1/Baseをインストールすると，環境変数PATHにJP1/Baseのbinフォルダのパスが自動的に追加されます。JP1/Baseのbinフォルダのパスが追加された結果，環境変数PATHの長さがOSでの上限値を超える場合，JP1/Baseはインストールできません。環境変数PATHの指定から不要なパスを削除してから，再度インストール操作を実施してください。

• 環境変数PATHに複数のパスが記述されている場合，左側に記述されているものほど参照するときの優先順位が高くなります。環境変数PATHに設定されるJP1/Baseのbinフォルダのパスの位置が，JP1/AJS3 - ViewまたはJP1/IM - Viewのbinフォルダよりも右側にあると，JP1/IM - ManagerやJP1/AJS3など，JP1/Baseを前提とする製品が正常に動作しないおそれがあります。環境変数PATHに設定されるJP1/AJS3 - ViewまたはJP1/IM - Viewのbinフォルダは，JP1/Baseのbinフォルダの右側に設定してください。

• 新規インストール時のインストール先フォルダの選択画面で，「システムドライブ:\Program Files(x86)」配下の「Hitachi」を，先頭「H」が大文字，その他を小文字以外で指定した場合，「Hitachi」固定（先頭「H」が大文字，「itachi」が小文字）でインストール先フォルダが作成されます。

  （例：「HITACHI」「hitachi」と指定した場合も，「Hitachi」となります。）

  製品動作には影響ありませんので，継続して使用してください。

• インストール先フォルダに記号（; # '%など）を含まないでください。記号を含むインストール先フォルダにインストールした場合，正常に動作しません。

• インストール先のドライブは，ローカルドライブを使用してください。ネットワークドライブを使用しないでください。

• インストールの前に，次のプログラムを停止してください。またインストール後にOSの再起動要求があった場合は，指示に従って再起動してください。

  • JP1/Baseのすべてのサービス

  • JP1/Baseを前提とする製品のすべてのサービス

  • JP1イベントを使用しているアプリケーション

  • 統合トレース機能（HNTRLib2）のサービス

• インストール時，およびjp1bshasetupコマンドの実行時に，Windows Defenderに警告が出力されることがありますが，これはサービスの登録を行ったために出力される内容であり，問題ありません。

• 次の条件のインストール先フォルダにインストールした場合，IM構成管理を用いたプロファイルの収集や反映が正常に動作しません。

  （a）インストール先フォルダの一部に「()」を含み，半角スペースを含まない場合

  （例）C:\ProgramFiles(x86)\Hitachi\JP1Base\

  （b）インストール先フォルダに特殊文字「@&^」を含む場合

  （例）C:\JP1@\Program Files (x86)\Hitachi\JP1Base\

  （例）C:\JP1&\Program Files (x86)\Hitachi\JP1Base\

  （例）C:\JP1^\Program Files (x86)\Hitachi\JP1Base\

  IM構成管理を使用する場合，この例のようなインストール先フォルダにJP1/Baseをインストールしないでください。なお，次のようなインストール先フォルダにJP1/Baseをインストールした場合，問題はありません。

  （例）C:\Program Files (x86)\Hitachi\JP1Base\

ページの先頭へ

(2)　再インストールについて

• JP1/Baseを上書きインストールする場合は，「JP1/Base」で始まる名称のサービス，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを必ず終了してください。

• JP1/Baseをアンインストールしてから，再インストールする場合には，JP1/BaseおよびJP1/Baseを前提とする製品をすべてアンインストールしたあとに，JP1/Base，JP1/Baseを前提とする製品の順に再インストールをしてください。

  • JP1/IM - Managerの場合

    JP1/IM - Managerもアンインストールしたあと，JP1/BaseおよびJP1/IM - Managerを再インストールしてください。

  • JP1/AJSの場合

    JP1/AJSもアンインストールしたあと，JP1/BaseおよびJP1/AJSを再インストールしてください。

  • JP1/AJS2 for Mainframeの場合

    JP1/AJS2 for Mainframeのサービスを停止してからJP1/Baseをアンインストールしてください。JP1/Baseを再インストールしたあと，JP1/AJS2 for Mainframeを再セットアップしてください。

  • JP1/Power Monitorの場合

    JP1/Power MonitorはJP1/Baseよりも先にアンインストールしてください。そのあと，JP1/BaseおよびJP1/Power Monitorを再インストールしてください。

• JP1/IM - Managerを同一ホストにインストールしている場合，JP1/Baseをアンインストールして別のフォルダにJP1/Baseをインストールすると，JP1/IM - Managerが正常に動作しなくなります。

  この場合，JP1/IM - Managerをアンインストールして，インストール先フォルダを削除して再インストールしてください。

ページの先頭へ

(3)　Windows環境への設定

JP1/Baseのインストール時に環境変数PATHに，JP1/Baseのbinフォルダのパスと，統合トレース機能（HNTRLib2）のパスとして日立共通フォルダのパスが設定されます。

日立共通フォルダのパス（x86環境の場合）

システムドライブ\Program files\Common Files\HITACHI

日立共通フォルダのパス（x64環境の場合）

32bit版HNTRLib2

システムドライブ\Program files (x86)\Common Files\HITACHI

64bit版HNTRLib2

システムドライブ\Program files\Common Files\HITACHI

また，servicesファイルに「付録C　ポート番号一覧」に示すポート番号が設定されます。

ページの先頭へ

(4)　アンインストールについて

• JP1/Baseをアンインストールした場合，ほかのJP1製品も使用する共通の定義ファイルが削除されるため，ほかのJP1製品が動作できなくなります。

• JP1/AJS，JP1/Baseをインストールしたあと，JP1/AJSだけをアンインストールすると，その後イベントサービスが起動しなくなることがあります。この場合，イベントサーバ設定ファイル（conf）のinclude ajs-confパラメーターの行を削除するか，コメント扱い（行の先頭に#を付ける）にしてください。

• インストーラーのログとして次のファイルが作成されます。アンインストールが正常終了したあとに削除してください。

  Windowsのインストール先フォルダ\Temp\HCDINST\製品形名[_{1|2|3|4|5}].LOG

• 環境変数PATHに設定したJP1/Baseのbinフォルダのパス，およびservicesファイルへ設定したポート番号は，JP1/Baseのアンインストールで削除されます。サービス名jp1imcmdaは，JP1/IM - Viewがインストールされている場合，削除されません。削除されない設定情報について不要であれば，削除してください。ただし，サービス名jp1imcmdaは，JP1/IM - Viewがインストールされている場合，削除しないでください。また，日立共通フォルダのパスは統合トレース機能（HNTRLib2）以外の製品でも使用するため，削除の際は十分注意してください。

• JP1/Baseをアンインストールしたときに，スタートメニューにプログラムフォルダが残る場合があります。不要な場合はWindowsのヘルプを参照して削除してください。

• JP1/Baseを前提とする製品をインストールしたままJP1/Baseをアンインストールしないでください。

ページの先頭へ

(5)　上書きインストールについて

以前のバージョンの製品を使用している環境に上書きインストールする場合，次の点にご注意ください。

• バージョン6のJP1/IM - Central ConsoleまたはJP1/AJSと，バージョン7以降のJP1/Baseは，同一ホストにインストールできません。

• バージョン6以前のJP1/Baseにバージョン7以降のJP1/Baseを上書きインストールするとHNTRLib2がインストールされますが，HNTRLibが残ったままになります。不要であれば，HNTRLibを利用するプログラムがないことを確認してからHNTRLibをアンインストールしてください。

• バージョン8で，コマンド実行履歴ファイル（ISAM）の保存形式が変更になりました。そのため，JP1/IMを使用している環境で，バージョン8以降のJP1/Baseを07-51以前のバージョンから上書きインストールした場合，JP1/IMの運用開始までの間に必ずjcocmdconvコマンドを実行してください。

  このコマンドを実行すると，バージョン7以前のJP1/Baseに蓄積されたコマンド実行履歴ファイル（ISAM）を，バージョン8以降のコマンド実行履歴ファイル（ISAM）に移行できます。このコマンドを実行しなかった場合，バージョン7以前に蓄積されたコマンド実行履歴が参照できません。また，クラスタ運用時には，共有ディスクにアクセスできる状態で，実行系か待機系のどちらか一方から論理ホストに対し，jcocmdconvコマンドを1回だけ実行してください。

  jcocmdconvコマンドの詳細については，「15.　コマンド」の「jcocmdconv」を参照してください。

  なお，コマンド実行履歴はマネージャーホスト（JP1/IMと同ホスト）のJP1/Baseだけに作成されます。

• 09-00では，イベントサーバ設定ファイル（conf）のoptionsパラメーターにsave-repフラグが追加されました。このフラグを設定すると，イベントDBの重複防止テーブルをファイル上に保持します。設定しない場合は，重複防止テーブルをメモリー上に保持します。そのため，イベントサーバの再起動時に，重複防止テーブルが破棄されたあとで再構築され，他ホストから転送されたJP1イベントの受信に時間が掛かります。他ホストから転送されたJP1イベントを受信するイベントサーバでは，save-repフラグを設定することを推奨します。

  なお，08-50以前のバージョンから上書きインストールした場合は，このフラグが設定されていないため，次の手順で重複防止テーブルをファイル上に構築してください。

  1. イベントサーバ設定ファイルのoptionsパラメーターにsave-repフラグを追加する。

     イベントサーバ設定ファイルについては，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

  2. jevdbmkrepコマンドを実行する。

     jevdbmkrepコマンドについては，「15.　コマンド」の「jevdbmkrep」を参照してください。

  3. イベントサーバを起動する。

• 09-10では，ログファイルトラップ起動定義ファイル（jevlog_start.conf）が追加されました。09-10以降のJP1/IMと連携している場合，IM構成管理を使用しているときは，このファイルを使用すると，IM構成管理からログファイルトラップの起動・停止を管理できます。

  IM構成管理からログファイルトラップの起動・停止を管理する場合，起動順序定義ファイル（JP1SVPRM.DAT）でログファイルトラップを起動するように定義しているときは，次の作業を実施して，ログファイルトラップを起動するための定義をログファイルトラップ起動定義ファイルに移行してください。

  • 起動順序定義ファイルで設定していた，ログファイルトラップを起動するための定義を削除する。

  • ログファイルトラップ起動定義ファイルに，起動・停止したいログファイルトラップを設定する。

  ログファイルトラップ起動定義ファイルについては，「16.　定義ファイル」の「ログファイルトラップ起動定義ファイル」を参照してください。

  なお，移行の際は，次の点に注意してください。

  • jevlogstartコマンドオプションにログファイルトラップ動作定義ファイル名（-fオプション）を必ず指定してください。

  • 監視名またはログファイルトラップ動作定義ファイル名が，ほかのログファイルトラップと重複しないようにしてください。重複している場合は，別の名称に変更してください。

• 11-00では，Windowsのスタートメニューから［プログラム］−［JP1_Base］で表示されるメニュー名称が変更されました。10-50以前のバージョンから上書きインストールした場合は，メニュー名称が次のとおり変更されます。

  10-50以前のメニュー名称	11-00以降のメニュー名称
  環境設定	JP1_Base Setup
  管理者コンソール	JP1_Base Console

  注　メニュー名称は任意に変更できます。

• 11-50以降では，大規模なシステム（エージェント1,024台以上）でJP1/IM - Managerのリモートコマンドや自動アクションを使用する運用の場合，従来のコマンド実行履歴ファイルのレコード数（初期設定で20,000レコード）では不足するおそれがあるため，レコード数を拡張することを推奨します。

  なお，コマンド実行履歴ファイルの自動再編成機能を有効にしている場合，ファイルのサイズに応じてJP1/Baseの起動時間が増加するため，運用に支障がないことを確認してください。詳細については，「4.9　コマンド実行履歴ファイルの自動再編成機能について」を参照してください。

• JP1/Baseを上書きインストールすると，再起動が必要になる場合があります。

• JP1/Baseを上書きインストールする前に，JP1/Baseを前提とする製品を停止してください。

• JP1/Baseを上書きインストールする前に，HNTRLib2を使用する製品を停止してください。

  HNTRLib2を使用する製品の情報はhntr2getnameコマンドを使用することで取得できます。コマンドプロンプトを起動して，次のコマンドを実行してください。

  cd システムドライブ\Program Files\Hitachi\HNTRLib2\bin\
  hntr2getname

• JP1/Baseを上書きインストールする場合は，「JP1/Base」で始まる名称のサービス，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを必ず終了してください。

ページの先頭へ

(6)　バージョンアップの注意事項

バージョンアップは，上書きインストールでできます。この場合，定義内容はすべて引き継がれますが，次に示す注意事項があります。

• Windowsでの言語設定について

  1. 各言語（日本語/英語/中国語（簡体字））のどれかでJP1/Baseを利用する場合，言語設定が統一されていることを確認してからインストールしてください。

     Windows 7の場合

     設定内容	設定個所	確認個所
     システムロケール	［コントロールパネル］−［地域と言語］−［管理］	［Unicode対応でないプログラムの言語］
     言語および地域の形式	［コントロールパネル］−［地域と言語］−［形式］	［形式］
     	［コントロールパネル］−［地域と言語］−［場所］	［現在の場所］
     テキスト表示，音声および手書き文字に使用する言語	［コントロールパネル］−［地域と言語］−［キーボードと言語］	［表示言語］
     キーボードおよび入力言語	［コントロールパネル］−［地域と言語］−［キーボードと言語］−［キーボードの変更］−［テキストサービスと入力言語］	［既定の言語］
     		［インストールされているサービス］

     Windows Server 2019，Windows Server 2016，Windows Server 2012 R2，Windows 8.1，Windows Server 2012，Windows 8の場合

     設定内容	設定個所	確認個所
     システムロケール	［コントロールパネル］−［地域］−［管理］−［システムロケールの変更］−［地域の設定］	［Unicode対応でないプログラムの言語］
     言語および地域の形式	［コントロールパネル］−［地域］−［形式］	［形式］
     	［コントロールパネル］−［地域］−［場所］	［主な使用場所］

  2. 言語設定を日本語に変更後，［コントロールパネル］−［地域と言語のオプション］−［管理］タブを表示し，［ようこそ画面と新しいユーザーアカウント］−［設定のコピー］をチェックして設定をコピーしてください。コピー後にOSを再起動してください。

  3. JP1/Base をインストールしてください。

• バージョンアップ前製品のプログラムフォルダを手動で変更した場合は，バージョンアップインストールしてもプログラムフォルダは削除されません。不要な場合は，バージョンアップインストール完了後に手動で削除してください。

ページの先頭へ

(7)　ディスク複製インストール時の注意事項

JP1/Baseは，JP1/ServerConductor/Deployment ManagerおよびHitachi Compute Systems Manager Deployment Manager Plug-inのディスク複製インストール，または仮想化プラットフォームが提供するイメージファイル化による複製機能に対応した日立プログラムプロダクトです。

ディスク複製インストール時，JP1/Baseの各定義ファイルは基本的にインストールとセットアップ後のデフォルトの定義内容で複製することを推奨します。

ただし，定義内容を変更して複製先でも同一の設定をする場合は，次の点に注意してください。

ページの先頭へ

(8)　サイレントインストール機能について

JP1/Baseは，サイレントインストール機能によるインストール方法が利用できます。

実行コマンド

提供媒体のドライブ:\_OWNEXE\HPPSINST.BAT /提供媒体のドライブ:\_PPDIR\PLA2C6LC\DISK1 /"インストール先のフルパス"

サイレントインストール時の注意事項

• 提供媒体をHDD上にコピーして実行する場合は，スペースを含まないディレクトリパス上に媒体の内容をすべてコピーしてください。また，コピーしたファイル群はコンペアなど（バイナリレベル）で一致することを確認してください。

• インストールが正常終了したかどうかは，実行結果の戻り値を参照してください。戻り値については，JP1のWebサイトに公開しているドキュメントを参照してください。

ページの先頭へ