jpcconf port define

形式

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

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

ページの先頭へ

機能

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

Performance Managementプログラムのサービスまたはプログラムが使用するポート番号のうち，次の表のポート番号以外はサービスが再起動されるたびに自動的に割り当てられるため，再起動前と異なるポート番号が使用されることがあります。

これら以外のポート番号を任意の番号に設定したい場合，このコマンドを実行します。

ポート番号に指定できる値は，1024〜65535の範囲内かつシステムで使用されていない数値です。ポート番号を指定しない場合は，Performance Managementで割り当てられたポート番号が設定されます。ポート番号を指定しないでリターンキーを押すと，表示されているポート番号が設定されます。

システム内でポート番号が重複しないかぎり，Performance Managementで割り当てられるポート番号を使用してください。Performance Managementで割り当てられるポート番号については，「付録C　ポート番号一覧」を参照してください。

指定するポート番号は，同一装置内で重複していないものを選択する必要があります。

同一装置内の論理ホストと物理ホストの両方にPerformance Managementシリーズプログラムのサービスがない場合は，それぞれに重複しないポート番号を割り当てる必要があります。

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

PFM - ManagerとPFM - Web Console間，PFM - ManagerとPFM - Agent間，またはPFM - ManagerとPFM - RM間のファイアウォールを通過させる場合は，ポート番号を固定値に設定する必要があります。これらのファイアウォールを通過させるための設定については，「付録C　ポート番号一覧」を参照してください。

ページの先頭へ

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

• PFM - Manager

• PFM - Agent

• PFM - Base

• 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およびNNM Object Managerサービスで使用するポート番号を設定する場合に指定します。

• 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」を指定します。

  なお，Name Server，OpenView（NNMとNNM Object Manager間），Status Server，View（PFM - Web ConsoleとView Server間）サービスについては，「0」を指定しても，固定のポート番号が割り当てられます。

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

  ただし，次の表に示すサービスについては，「auto」は指定しないで，固定のポート番号を指定してください。

  サービス名※	ポート番号
  Name Server	22285
  OpenView（NNMとNNM Object Manager間）	22292
  Status Server	22350
  View（PFM - Web ConsoleとView Server間）	22286

  注※　コマンド実行時の表示名がサービス名と異なる項目は，表示名を記載しています。

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

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

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

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

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

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

ページの先頭へ

注意事項

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

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

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

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

  ほかのPFMサービスについても運用での混乱を避けるため，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オプションを同時に指定して，バッチまたはスクリプトファイルなどで処理を自動化したい場合は，定義ファイルの内容が正しいことをあらかじめ確認してください。また，コマンドが正常終了したかどうかは，出力されるメッセージまたは戻り値で確認してください。

ページの先頭へ

戻り値

ページの先頭へ

使用例

すべてのPerformance Managementプログラムのサービスのポート番号を固定値にする場合のコマンド実行例を次に示します。

jpcconf port define -key all

ページの先頭へ

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

-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

ページの先頭へ