jpcconf port define

形式

jpcconf port define     -key サービスキー
                        [-lhost 論理ホスト名]
                        [-inst インスタンス名]
                        [-only]
                        [-input 定義ファイル名]
                        [-noquery]

jpcconf port define     -key サービスキー
                        [-lhost 論理ホスト名]
                        [-inst インスタンス名]
                        -template 定義ファイル名
                        [-noquery]

ページの先頭へ

機能

jpcconf port defineコマンドは，Performance Managementで使用するポート番号を設定するコマンドです。

ポート番号には固定ポート番号と優先ポート番号があり，サービスの種類によって，コマンドで指定できる内容が異なります。ポート番号の詳細については，「付録C　ポート番号一覧」を参照してください。

なお，jpcconf port defineコマンドを実行すると，現在設定されているポート番号が表示されます。ポート番号を指定しないでリターンキーを押すと，表示されているポート番号が設定されます。

ページの先頭へ

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

• PFM - Manager

• PFM - Agent

• PFM - RM

ページの先頭へ

実行権限

Windowsの場合

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

UNIXの場合

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

ページの先頭へ

格納先ディレクトリ

Windowsの場合

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

UNIXの場合

/opt/jp1pc/tools/

ページの先頭へ

引数

ページの先頭へ

定義ファイルの形式（jpcconf port defineコマンド）

定義ファイルはテキスト形式のファイルです。次に示すセクションおよびラベルで構成されます。ラベルの設定値は，ラベル名の後ろの「=」に続けて指定します。不正なセクション名およびラベル名を指定した場合，該当するセクションおよびラベルは無視されます。

[Common Definitions]セクション

定義ファイルの基本情報を指定するセクションです。このセクションおよびこのセクション内のラベルは省略できません。

Definition File Versionラベル

定義ファイルのバージョンを指定するラベルです。固定で「0001」を指定してください。

[コンポーネント名]セクション

設定するポート番号を指定するセクションです。

コンポーネント名には，ポート番号を設定するサービスが属するコンポーネント名を指定します。このセクションは，コンポーネント名ごとに複数指定できます。

なお，同じ名称のセクションを複数指定した場合，最初に指定したセクションの設定が有効になります。

指定できる値は次のとおりです。

• Common

  Name Server，Status Server，およびAction Handlerサービスで使用するポート番号を設定する場合に指定します。

• Manager

  PFM - Managerの各サービスで使用するポート番号を設定する場合に指定します。

• PFM - Agent，PFM - RMのプロダクト名

  PFM - AgentまたはPFM - RMで使用するポート番号を設定する場合に指定します。なお，プロダクト名については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，Performance Managementの機能について説明している章を参照してください。

インスタンス名サブセクション

PFM - AgentまたはPFM - RMのインスタンス環境のポート番号を指定するサブセクションです。このサブセクションは，コンポーネント名にマルチインスタンスのPFM - AgentまたはPFM - RMを指定した場合だけ指定します。

なお，同じ名称のサブセクションをセクション配下に複数指定した場合，最初に指定したサブセクションの設定が有効になります。

サービス名ラベル

設定するポート番号を指定するラベルです。

なお，同じ名称のラベルをセクションまたはサブセクション配下に複数指定した場合，最初に指定したラベルの設定が有効になります。

• ポート番号を固定しない状態（サービスが再起動されるたびに割り当てられる状態）にする場合は，値に「0」を指定します。ただし，固定の番号が割り当てられているポート番号には，「0」を指定しても固定のポート番号が割り当てられます。

• Performance Managementで割り当てられるデフォルトのポート番号を使用する場合は，値に「auto」を指定します。ただし，固定の番号が割り当てられているポート番号には「auto」を指定できません。

• ポート番号を指定する場合は，1024〜65535の範囲内でかつシステムで使用されていない値を指定してください。

• ポート番号を変更しない場合は，値には何も指定しないでください。

1024〜65535に含まれない値や，autoを除く数値以外の文字列を含む値を指定した場合は，該当するサービスに対する処理がスキップされます。

[コンポーネント名]セクションとサービス名ラベルの指定で使用するコンポーネント名，サービス名，および設定値を次の表に示します。

定義ファイルの記述例を次に示します。

[Common Definitions]
Definition File Version=0001
 
[Common]
Name Server=22285
Status Server=22350
[Manager]
Master Manager=auto
Master Store=auto
Correlator=auto
：
[Windows]
Collector=0
Store=0
：
[Oracle]
[[oracle1]]
Collector=0
Store=0

ページの先頭へ

注意事項

• 11-01未満

  ポート番号設定時に，Performance Managementプログラムのサービスが起動されているときは，ローカルホスト上で起動されているすべてのサービスを停止してからこのコマンドを実行してください。ポート番号の設定が終わったあと，手動でサービスを起動してください。

• 11-01以降

  ポート番号設定時にPerformance Managementプログラムのサービスが起動されているときは，-onlyオプションを指定する場合と指定しない場合とで，サービスの停止の要否が次のようになります。

  -onlyオプションを指定しないでポート番号を設定するとき

  ローカルホスト上で稼働しているすべてのサービスを停止してください。

  -onlyオプションを指定してポート番号を設定するとき

  -keyオプションと-instオプションで指定したサービスを停止してください。

  ポート番号の設定が終わったあと，停止させたサービスを手動で起動してください。

• -noqueryオプションを指定していない場合，サービスを停止させないでこのコマンドを実行しても，コマンドがサービスを停止しますが，完全にサービスを停止できなかった場合，コマンドはエラーとなります。このときは，サービスが完全に停止したことを確認したあと，コマンドを再実行してください。

  また，このコマンドで物理ホスト上のPerformance Managementプログラムのサービスを停止した場合，ポート番号の設定が終わったあと，次に示す方法で物理ホストのPerformance Managementプログラムのサービスを手動で再起動してください。

  • CentOS 7以降，Linux 7以降，Oracle Linux 7以降，またはSUSE Linux 12以降の環境の場合

    サービスの自動起動と自動停止の両方を有効に設定しているときは，サービスの自動停止を有効にするために，systemctl stop jp1_pcコマンドを実行したあとで，systemctl start jp1_pcコマンドを実行して，サービスを起動してください。

    上記以外の設定のときは，jpcspmコマンドを使用してサービスを起動してください。

  • 上記以外の環境の場合

    jpcspmコマンドを使用してサービスを起動してください。

• このコマンドの実行中に，Ctrl+Cキーで中断すると，ポート番号は正しく設定されません。ポート番号を設定し直して，コマンドを再実行してください。

• Name Serverサービスに設定するポート番号については，Performance Managementシステム内の全ホストで同じ番号にする必要があります。

  また，Status Serverサービスに設定するポート番号についても，Performance Managementシステム内の全ホストで同じ番号にする必要があります。

  ほかのPFMサービスについても運用での混乱を避けるため，Performance Managementシステム全体でポート番号とサービス名の対応を統一してください。

• ホスト内でポート番号が重複しないかぎり，Performance Managementが割り当てる固定ポート番号，または優先ポート番号を使用してください。

• このコマンドは，OSのservicesファイルを自動編集します。

• このコマンドを実行した場合に編集されるservicesファイルは，コマンドを実行したホストのローカルファイルだけです。UNIXで，NISまたはNIS+によってservicesファイルを管理している場合，ローカルのservicesファイルに追加されたポート番号を手動でNISサーバに反映してください。

• ポート番号の入力時に現在の設定値として表示される値は，コマンドを実行しているホスト上のservicesファイルに設定された値です。NISまたはNIS+環境で，NISサーバが管理するポート番号の情報と，NISクライアントのservicesファイルの情報が異なっている場合，実際にサービスが使用している値とは異なる情報が表示されることがあります。

• コマンドの実行をCtrl+Cキーやシグナルで中断した場合，特定の戻り値が返りません。そのため，コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。

• -inputオプションを指定した場合，定義ファイルに必要なラベルがないとき，またはDefinition File Versionの値が不正なときは，コマンドの実行が中断されます。-noqueryオプションを同時に指定して，バッチまたはスクリプトファイルなどで処理を自動化したい場合は，定義ファイルの内容が正しいことをあらかじめ確認してください。また，コマンドが正常終了したかどうかは，出力されるメッセージまたは戻り値で確認してください。

• -inputオプションを指定した場合，-keyオプションおよび-inputオプションで指定したサービスのポート番号だけが処理の対象になります。また，同時に-onlyオプションを指定した場合は，定義ファイル中のNameServerのポート番号は処理の対象になりません。なお，定義ファイル中に処理の対象ではないセクション，サブセクション，ラベルがあってもエラーにはなりません。

• 11-00未満から11-00以降に上書きインストールした環境では，-templateオプションを指定した場合に出力される定義ファイルにOpenViewサービス（NNM連携のためのサービス）が含まれます。定義ファイルからOpenViewサービスの行は削除してください。

  削除せずに-inputオプションで定義ファイルを読み込んだ場合，servicesファイルにOpenViewサービスのポート番号が設定されます。その場合，serviceファイルを編集しOpenViewサービスの行を削除してください。ただし，OpenViewサービスが設定されていても，動作には影響ありません。

  OpenViewサービスの行を定義ファイルに出力させないようにするには，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録の，移行時の注意事項（バージョン11-00以降）について説明している個所を参照してください。

• UNIXの場合，このコマンドでStatus Serverのポート番号を22350に設定した場合，次のメッセージが出力されることがあります。

  jpcconf port define ： KAVE05918-W 指定したポート番号は他で使用されています

  この場合，/etc/servicesに次の記載がある可能性があります。

  CodeMeter 22350/tcp

  この記載は，記載されている製品のインストールの有無に関わらずOSのインストール時点からservicesファイルに記載されているものです。そのため，当該製品の使用の有無を確認し，使用されていない場合はこの記載をコメントアウトしてください。

  当該製品を使用している，もしくはそれ以外の製品でポート番号が登録されている場合は，サーバ内でポート番号の重複が発生しないようにしてください。

  なお，PFM - Managerで使用しているポート番号および変更方法については，マニュアル「JP1/Performance Management 設計・構築ガイド」の，ポート番号の設定およびポート番号の設定変更手順について説明している個所を参照してください。

ページの先頭へ

戻り値

ページの先頭へ

使用例

jpcconf port define -key all

# jpcconf port define -key Oracle -only

ページの先頭へ

非対話形式のコマンドの運用例

-noqueryオプション，-inputオプション，および-templateオプションを使用することで，Performance Managementからの問い合わせを抑止した状態でセットアップを実行できます。運用例を次に示します。

# jpcconf port define -key Windows -template AgentPort01.txt
# jpcconf port define -key Oracle -template AgentPort02.txt

# jpcconf port define -key Windows -input AgentPort01.txt -noquery
# jpcconf port define -key Oracle -input AgentPort02.txt -noquery

ページの先頭へ