jpcconf host hostmode

形式

jpcconf host hostmode    -mode {uname|hostname|alias
                         -aliasname エイリアス名}
                         -d バックアップディレクトリ名
                         [-dbconvert {convert|delete}]

jpcconf host hostmode     -display

ページの先頭へ

機能

jpcconf host hostmodeコマンドの形式ごとに機能を説明します。

形式1

物理ホスト環境の監視ホスト名の取得方法を変更します。なお，このコマンドを実行する場合，定義情報や性能情報などはすべて引き継がれます。

形式2

監視ホスト名の取得方法および監視ホスト名を表示します。

ページの先頭へ

コマンドを実行できるホスト

• PFM - Manager

• PFM - Agent

• PFM - RM

ページの先頭へ

実行権限

Windowsの場合

Administrators権限を持つユーザー（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合

rootユーザー権限を持つユーザー

ページの先頭へ

格納先ディレクトリ

Windowsの場合

インストール先フォルダ\tools\

UNIXの場合

/opt/jp1pc/tools/

ページの先頭へ

引数

ページの先頭へ

注意事項

• jpcconf host hostmodeコマンドを実行する場合は，実行ホスト上のPFM - ManagerまたはPFM - Baseのバージョンが09-00以降，かつPFM - Agentがすべて08-00以降である必要があります。

  PFM - Agent 07-50以前をインストールする場合，事前に監視ホスト名設定機能を使用しない設定に戻す必要があります。設定を戻す方法を，OSごとに説明します。

  • Windowsの場合

    jpcconf host hostmode -mode hostname -d d:\backup^※コマンドを実行します。

  • UNIXの場合

    jpcconf host hostmode -mode uname -d /home/backup^※コマンドを実行します。

  注※

  バックアップ先のディレクトリは任意です。

  jpcconf host hostmodeコマンドを実行するために必要な，実行ホスト上でのPFM - Manager，PFM - Base，PFM - Agentのバージョンの組み合わせを次の表に示します。

• 形式1でjpcconf host hostmodeコマンドを実行する場合は，指定したホストのサービスがすべて停止している必要があります。

• jpcconf host hostmodeコマンドの-dオプションに指定するディレクトリには，目安として，指定したホストにあるPFM - AgentおよびPFM - RMのStoreデータベース容量およびインポートディレクトリにあるデータベース容量の合計と同量の空きディスク容量が必要です。ただし，Storeデータベースの格納先ディレクトリおよびインポートディレクトリを変更している場合，変更後のディレクトリのデータベース容量を基に，必要なディスク容量を算出してください。

• jpcconf host hostmodeコマンドの実行中に他コマンドを実行しないでください。他コマンドを実行した場合，jpcconf host hostmodeコマンドまたは他コマンドの実行に失敗するおそれがあります。

• jpcconf host hostmodeコマンドの実行に失敗し，KAVE05183-Eメッセージが出力された場合，次の手順に従って回復してください。

  1. 直前のメッセージを確認しエラーの要因を取り除いてください。

  2. コマンド失敗時にKAVE05172-Iメッセージが出力されているかどうか確認してください。

     出力されている場合は，バックアップディレクトリにバックアップしたデータを，バックアップ元にリストアしてください。

     バックアップデータには，次の表に示すデータがバックアップされているので，それぞれバックアップ先からバックアップ元にリストアしてください。なお，Windows環境では，次の表の"/"は，"\"と読み替えてください。

     分類	バックアップ元	バックアップ先
     Storeデータベース	各エージェントのStoreディレクトリ	マルチインスタンスエージェントの場合： バックアップディレクトリ/agtX※1/インスタンス/store シングルインスタンスエージェントの場合： バックアップディレクトリ/agtX※1/store
     定義ファイル	インストール先ディレクトリ/jpcns.ini	バックアップディレクトリ/jpcns.ini
     	インストール先ディレクトリ/jpcns_backup.ini	バックアップディレクトリ/jpcns_backup.ini
     	インストール先ディレクトリ/jpccomm.ini	バックアップディレクトリ/jpccomm.ini
     	インストール先ディレクトリ/agtX※1/agent/agtlist.ini※2	バックアップディレクトリ/agtX※1/agent/agtlist.ini※2
     	インストール先ディレクトリ/agtX※1/store/stolist.ini※2	バックアップディレクトリ/agtX※1/store/stolist.ini※2
     	インストール先ディレクトリ/bin/statsvr/restart.ini	バックアップディレクトリ/bin/statsvr/restart.ini
     	インストール先ディレクトリ/sys/jp1sysEvent.ini	バックアップディレクトリ/sys/jp1sysEvent.ini

     注※1　agtXは，エージェントのサービスキーです。各エージェントのサービスキーについては，各エージェントのマニュアルを参照してください。

     注※2　マルチインスタンスエージェントの場合だけです。

  3. コマンドを再実行してください。

ページの先頭へ

戻り値

ページの先頭へ

使用例1

監視ホスト名の取得方法を，hostnameコマンドで取得する方法に変更する場合のコマンド実行例を次に示します。

jpcconf host hostmode -mode hostname -d d:\backup -dbconvert convert

ページの先頭へ

使用例2

監視ホスト名の取得方法を，エイリアス名を使用する方法に変更する場合のコマンド実行例を次に示します。

jpcconf host hostmode -mode alias -aliasname aliasA -d d:\backup -dbconvert convert

ページの先頭へ

使用例3

監視ホスト名の取得方法および監視ホスト名を表示する場合のコマンド実行例を次に示します。表示されるhostmodeは監視ホスト名の取得方法を示し，hostnameは監視ホスト名を示します。aliasnameは，エイリアス名を示します。

jpcconf host hostmode -display

ページの先頭へ