JP1 Version 13　JP1/Base 運用ガイド

3021-3-L09

前書き

対象製品

適用OSのバージョン，JP1/Baseが前提とするサービスパックやパッチなどの詳細についてはリリースノートで確認してください。

●JP1/Integrated Management 3 - Manager（適用OS：Windows）

P-2A2C-8EDL JP1/Integrated Management 3 - Manager 13-00

製品構成一覧および内訳形名

P-CC2A2C-9MDL JP1/Integrated Management 3 - Manager 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC2A2C-6HDL JP1/Integrated Management 3 - View 13-00（適用OS：Windows 10，Windows Server 2016，Windows Server 2019，Windows Server 2022，Windows 11）

P-CC2A2C-9GDL JP1/Integrated Management 3 - Agent 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC842C-9GDL JP1/Integrated Management 3 - Agent 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC2A2C-6LDL JP1/Base 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC842C-6LDL JP1/Base 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

●JP1/Automatic Job Management System 3 - Manager（適用OS：Windows）

P-2A12-3KDL JP1/Automatic Job Management System 3 - Manager 13-00

製品構成一覧および内訳形名

P-CC2A12-4KDL JP1/Automatic Job Management System 3 - Manager 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC2912-39DL JP1/Automatic Job Management System 3 - Web Console 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC8412-39DL JP1/Automatic Job Management System 3 - Web Console 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC2A12-3NDL JP1/Automatic Job Management System 3 - Print Option Manager 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC2A2C-6LDL JP1/Base 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

●JP1/Integrated Management 3 - Manager（適用OS：Linux）

P-842C-8EDL JP1/Integrated Management 3 - Manager 13-00

製品構成一覧および内訳形名

P-CC842C-9MDL JP1/Integrated Management 3 - Manager 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9）

P-CC9W2C-9MDL JP1/Integrated Management 3 - Manager 13-00（適用OS：SUSE Linux 12，SUSE Linux 15）

P-CC2A2C-6HDL JP1/Integrated Management 3 - View 13-00（適用OS：Windows 10，Windows Server 2016，Windows Server 2019，Windows Server 2022，Windows 11）

P-CC2A2C-9GDL JP1/Integrated Management 3 - Agent 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC842C-9GDL JP1/Integrated Management 3 - Agent 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC2A2C-6LDL JP1/Base 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC842C-6LDL JP1/Base 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

●JP1/Automatic Job Management System 3 - Manager（適用OS：Linux）

P-8412-3KDL JP1/Automatic Job Management System 3 - Manager 13-00

製品構成一覧および内訳形名

P-CC8412-4KDL JP1/Automatic Job Management System 3 - Manager 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC2912-39DL JP1/Automatic Job Management System 3 - Web Console 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC8412-39DL JP1/Automatic Job Management System 3 - Web Console 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC8412-3NDL JP1/Automatic Job Management System 3 - Print Option Manager 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC842C-6LDL JP1/Base 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

●JP1/Automatic Job Management System 3 - Agent（適用OS：Windows）

P-2A12-33DL JP1/Automatic Job Management System 3 - Agent 13-00

製品構成一覧および内訳形名

P-CC2A12-43DL JP1/Automatic Job Management System 3 - Agent 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

P-CC2A2C-6LDL JP1/Base 13-00（適用OS：Windows Server 2016，Windows Server 2019，Windows Server 2022）

●JP1/Automatic Job Management System 3 - Agent（適用OS：AIX）

P-1M12-33DL JP1/Automatic Job Management System 3 - Agent 13-00

製品構成一覧および内訳形名

P-CC1M12-43DL JP1/Automatic Job Management System 3 - Agent 13-00（適用OS：AIX）

P-CC1M2C-6LDL JP1/Base 13-00（適用OS：AIX）

●JP1/Automatic Job Management System 3 - Agent（適用OS：Linux）

P-8412-33DL JP1/Automatic Job Management System 3 - Agent 13-00

製品構成一覧および内訳形名

P-CC8412-43DL JP1/Automatic Job Management System 3 - Agent 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

P-CC842C-6LDL JP1/Base 13-00（適用OS：Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，SUSE Linux 15）

輸出時の注意

本製品を輸出される場合には、外国為替及び外国貿易法の規制並びに米国輸出管理規則など外国の輸出関連法規をご確認の上、必要な手続きをお取りください。

なお、不明な場合は、弊社担当営業にお問い合わせください。

商標類

HITACHI，Cosminexus，HiRDB，JP1は，株式会社 日立製作所の商標または登録商標です。

Active Directoryは，マイクロソフト 企業グループの商標です。

AIXは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

AMDは，Advanced Micro Devices, Inc.の商標です。

IBMは，世界の多くの国で登録されたInternational Business Machines Corporationの商標です。

Intelは，Intel Corporation またはその子会社の商標です。

Internet Explorerは，マイクロソフト 企業グループの商標です。

Linuxは，Linus Torvalds氏の米国およびその他の国における登録商標です。

Microsoftは，マイクロソフト 企業グループの商標です。

Oracle(R)，Java及びMySQLは，Oracle，その子会社及び関連会社の米国及びその他の国における登録商標です。

Red Hat is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hatは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

Red Hat Enterprise Linux is a registered trademark of Red Hat, Inc. in the United States and other countries.

Red Hat Enterprise Linuxは，米国およびその他の国におけるRed Hat, Inc.の登録商標です。

すべてのSPARC商標は，米国SPARC International, Inc. のライセンスを受けて使用している同社の米国およびその他の国における商標または登録商標です。SPARC商標がついた製品は，米国Sun Microsystems, Inc. が開発したアーキテクチャに基づくものです。

UNIXは，The Open Groupの登録商標です。

Visual C++は，マイクロソフト 企業グループの商標です。

Windowsは，マイクロソフト 企業グループの商標です。

Windows Serverは，マイクロソフト 企業グループの商標です。

その他記載の会社名，製品名などは，それぞれの会社の商標もしくは登録商標です。

マイクロソフト製品の表記について

このマニュアルでは，マイクロソフト製品の名称を次のように表記しています。

表記

正式名称

Microsoft Cluster Server

Microsoft(R) Cluster Server

Microsoft Internet Explorer

Microsoft(R) Internet Explorer

Windows(R) Internet Explorer(R)

Visual C++

Microsoft(R) Visual C++(R)

Windows 10

Windows(R) 10 Enterprise 64-bit

Windows(R) 10 Home 64-bit

Windows(R) 10 Pro 64-bit

Windows 11

Windows(R) 11 Enterprise

Windows(R) 11 Home

Windows(R) 11 Pro

Windows Server 2016

Microsoft(R) Windows Server(R) 2016 Datacenter

Microsoft(R) Windows Server(R) 2016 Standard

Windows Server 2019

Microsoft(R) Windows Server(R) 2019 Datacenter

Microsoft(R) Windows Server(R) 2019 Standard

Windows Server 2022

Microsoft(R) Windows Server(R) 2022 Datacenter

Microsoft(R) Windows Server(R) 2022 Standard

Windows 10，Windows Server 2016，Windows Server 2019，Windows Server 2022，およびWindows 11を総称してWindowsと表記することがあります。

発行

2023年6月　3021-3-L09

著作権

Copyright (C) 2023, Hitachi, Ltd.

Copyright (C) 2023, Hitachi Solutions, Ltd.

奥付

マニュアル発行元

株式会社 日立製作所

〒100‒8280　東京都千代田区丸の内一丁目6番6号

変更内容

変更内容（3021-3-L09）　JP1/Base　13-00

追加・変更内容

変更個所

次の適用OSを追加した。

Microsoft(R) Windows Server(R) 2022

Red Hat(R) Enterprise Linux(R) Server 9 (64-bit x86_64)

Oracle Linux(R) Operating System 9

−

次の適用OSを削除した。

Windows(R) 10 Enterprise 32-bit

Windows(R) 10 Home 32-bit

Windows(R) 10 Pro 32-bit

HP-UX 11i V3 (IPF)

Solaris 11 (SPARC)

Red Hat(R) Enterprise Linux(R) Server 6 (64-bit x86_64)

Oracle Linux(R) Operating System 6 (x64)

CentOS 6 (x64)

CentOS 7

CentOS 8

−

次の機能を削除した。

JP1/SES互換機能

SNMPトラップ変換機能

これに伴い，上記の機能に関連する項目の説明を削除または変更した。

−

JP1/Baseをインストールする手順（Windowsの場合）の説明に，JP1/AJSまたはJP1/IMの提供媒体に同梱されたJP1/Baseを選択する手順を追加した。

3.2.1

12-50以前のJP1/Baseに13-00以降のJP1/Baseを上書きインストールする場合の注意事項を追加した。

3.2.3(5)，3.3.4(5)

次の項目に関する説明を追加して，2038年以降も使用する場合の説明を記載した。

Linuxで運用する場合のbig timestampsの有効化

コマンド実行のサービスの起動の抑止

JP1/Baseの起動プロセス定義ファイル

3.3.4(9)，7.1.1，7.2，付録A.1，付録A.2

Linuxで使用できる文字コードに英語のUTF-8を追加した。

また，JP1/Baseの定義ファイルに次のファイルを追加した。

文字コードマッピング定義ファイル

言語種別マッピング定義ファイル

これに伴い，バージョンアップインストール後に文字コードと言語種別のマッピング定義を変更するための手順を追加した。

3.4.2，3.4.2(3)，付録A.2

SSL通信で楕円曲線暗号（ECC）を利用できるようにした。

これに伴い，サーバ側のSSL通信環境のセットアップについて，秘密鍵の作成に関する説明を変更した。また，楕円曲線暗号を利用する場合のopensslコマンドの使用例，およびSSL通信定義ファイルでの秘密鍵ファイル名の指定に関する説明を追加した。

6.13.2，openssl，SSL通信定義ファイル

イベントフィルターの文法について，条件文の属性名の「B.TIME（登録時刻）」と「B.ARRIVEDTIME（到着時刻）」に対する数値の範囲を変更した。

これに伴い，条件文の比較キーワードの「RANGE」，「TRANGE」，「WITHIN」の説明を変更した。

イベントフィルターの文法

イベントサーバ設定ファイルの次のパラメーターを，必須パラメーターから選択パラメーターに変更した。

include

optionsのv5-unused

イベントサーバ設定ファイル

SSL通信定義ファイルで指定できるSSL通信のバージョンにTLS1.3を追加した。

また，ECC形式の暗号スイートの指定に関する説明を追加した。

SSL通信定義ファイル

オートスケール連携で使用するAWS CLI対応のスクリプトを追加した。

付録A.1，付録A.1(1) ，付録A.2，付録A.2(1) ，付録L，付録L.1，付録L.1(3) ，付録L.5，付録L.8(1) ，付録L.8(4) ，付録L.10

（凡例）

−：該当なし

単なる誤字・脱字などはお断りなく訂正しました。

はじめに

このマニュアルは，JP1/Baseの機能および操作方法について説明したものです。なお，このマニュアルは各OS共通のマニュアルです。OSごとに差異がある場合は，本文中でそのつど内容を書き分けています。

対象読者

次の方を対象としています。

JP1/Baseを導入および運用するシステム管理者。

JP1/Baseを前提とするJP1製品（JP1/IM，JP1/AJS，JP1/Power Monitorなど）を使ったシステムを導入，構築および運用するシステム管理者またはシステムオペレーター。

マニュアルの構成

このマニュアルは，次に示す編から構成されています。

第1編　概要編

JP1/Baseの概要について説明しています。

第2編　機能編

JP1/Baseの機能について説明しています。

第3編　構築編

JP1/Baseのインストールとセットアップの方法について説明しています。クラスタシステムでJP1/Baseを運用する場合や，複数ネットワークでJP1/Baseを運用する場合の設定方法についても説明しています。

第4編　運用・操作編

JP1/Baseの各機能の設定方法や操作方法について説明しています。

第5編　リファレンス編

JP1/Baseで使用できるコマンド，JP1/Baseの定義ファイル，JP1/Baseが出力するイベントについて説明しています。

第6編　トラブルシューティング編

JP1/Baseでトラブルが発生したときの原因と対処について説明しています。

JP1/Baseマニュアルの使い分けについて

JP1/Baseのマニュアルは3冊に分かれています。次に示す表で各マニュアルの記載内容をご確認の上，利用目的に合わせてマニュアルをお読みください。

マニュアル名

記載内容

JP1/Base 運用ガイド

JP1/Baseの概要・機能

各機能の設定

コマンド，定義ファイル，JP1イベント

トラブルシューティング

プロセス，ポート番号，操作ログ

JP1/Base メッセージ

メッセージ

JP1/Base 関数リファレンス

JP1プログラムやユーザーアプリケーションでJP1イベントを発行・取得する方法

関数

コマンドの文法で使用する記号

コマンドとパラメーターの説明で使用する記号を，次のように定義します。

記号

意味

｜

(ストローク)

複数の項目に対し，項目間の区切りを示し，「または」の意味を示す。

（例）

「A｜B｜C」は，「A，BまたはC」を示す。

｛　｝

この記号で囲まれている複数の項目の中から，必ず1組の項目を選択する。項目の区切りは|で示す。

（例）

｛A｜B｜C｝は「A，BまたはCのどれかを指定する」ことを示す。

[　]

この記号で囲まれている項目は任意に指定できる（省略してもよい）。

複数の項目が記述されている場合には，すべてを省略するか，どれか一つを選択する。

（例）

[A]は「何も指定しない」か「Aを指定する」ことを示す。

[B | C]は「何も指定しない」か「BまたはCを指定する」ことを示す。

…

(点線)

この記号の直前に示された項目を繰り返して複数個，指定できる。

（例）

「A，B，…」は「AのあとにBを必要個数指定する」ことを示す。

＿

(下線)

括弧内のすべてを省略したときに，システムがとる標準値を示す。標準値がない場合は，指定した項目だけが有効である。

（例）

[A | B]はこの項目を指定しなかった場合に，Aを選択したと見なすことを示す。

△

空白を表す。

△₀：0個以上の空白（空白を省略できる）

△₁：1個以上の空白（空白を省略できない）

JP1/Baseのインストール先フォルダの表記

このマニュアルでは，JP1/Baseのインストール先フォルダを次のように表記しています。

製品名

インストール先フォルダの表記

インストール先フォルダ※

JP1/Base

インストール先フォルダ

システムドライブ:¥Program Files (x86)¥Hitachi¥JP1Base

注※　各製品を初期設定のままインストールした場合のインストール先フォルダを表しています。「システムドライブ:¥ProgramData」と表記している部分は，インストール時のOS環境変数によって決定されるため，環境によって異なる場合があります。

このマニュアルで使用する「Administrators権限」について

このマニュアルで表記している「Administrators権限」とは，ローカルPCに対するAdministrators権限です。ローカルPCに対してAdministrators権限を持つユーザーであれば，ローカルユーザー，ドメインユーザー，およびActive Directory環境で動作に違いはありません。

このマニュアルで使用するディレクトリ名

このマニュアルでは，原則としてLinuxのディレクトリ名を使用しています。ただし，シンボリックリンクが設定されているので，Linux以外のUNIX系のOSをご使用の方もマニュアルのディレクトリ名を使用できます。

なお，LinuxとLinux以外のUNIX系のOSでディレクトリ名が異なる場合は，それぞれのディレクトリ名を併記しています。

第1編　概要編

1　JP1/Baseの概要

この章では，JP1/Baseの概要について説明します。

1.1　JP1/Baseの機能概要

JP1/Baseは，JP1/IMを使用した統合管理システムやJP1/AJSを使用したジョブ管理システムの基盤となる製品です。システム内のイベントやJP1ユーザーを管理したり，サービスの起動を制御したりできます。

次に，JP1/Baseが提供する機能を示します。

ユーザー管理

JP1/Baseでは，JP1製品の専用アカウントであるJP1ユーザーを管理しています。OSのアカウントとは別に，独立して管理され，ユーザーごとに他ホストに対する操作権限を詳細に管理できるため，セキュリティを強化できます。

JP1/Baseのユーザー管理には，次に示す二つの機能があります。

ユーザー認証

ユーザー認証では，JP1/IM - ManagerやJP1/AJS - Managerなど，JP1のマネージャー製品がインストールされた各ホストにユーザーがアクセスする権限，および各ホスト上にあるJP1資源（ジョブ，ジョブネット，イベントなど）に対して操作する権限を管理します。

ユーザーマッピング

ユーザーマッピングとは，専用アカウントであるJP1ユーザーに対して，OSに登録されているユーザーの権限を与える機能です。JP1ユーザーとして認証サーバに登録されたユーザーは，各ホストのOSに登録されているユーザーの権限で各ホストの操作を実行できるようになります。

サービスの起動管理（Windows限定）

サービスの起動順序や終了順序を制御します。なお，終了順序を制御する場合，JP1/Power Monitorが必要です。

イベントサービス

システムで何らかの事象が発生したときにJP1/Baseに通知されるJP1イベントを管理したり，ほかのホストとJP1イベントを送受信したりします。イベントフィルターを使って，重要なイベントだけをマネージャーへ転送することもできます。

イベント変換

ログメッセージやイベントログをJP1イベントに変換します。変換されたJP1イベントは，イベントサービスが提供しているイベントDBに格納され，JP1シリーズのプログラムが発行するJP1イベントと同様に管理できます。イベント変換機能には，次に示す三つの機能があります。

ログファイルトラップ

アプリケーションプログラムのログをJP1イベントに変換します。

イベントログトラップ（Windows限定）

WindowsのイベントログをJP1イベントに変換します。

定義の収集・配布（JP1/IM用）

JP1/BaseやJP1製品で定義した情報を，JP1/IMで収集・配布できます。この機能を利用すると次のことが行えます。

IM構成管理による定義情報の管理

IM構成管理を使用している場合は，IM構成管理・ビューアーを操作して，JP1/Baseの定義情報を管理できます。IM構成管理はJP1/IM - Manager 09-00で追加された機能です。

各ホストのJP1/Baseで定義した情報をマネージャーホストで一括収集して確認できるため，効率良く定義情報を管理できます。また，マネージャーホストで定義情報を編集し，各ホストのJP1/Baseに配布し，定義情報を更新することもできます。

IM構成管理によるサービスの稼働情報の確認

IM構成管理を使用している場合は，IM構成管理・ビューアーを操作して，JP1/Baseのサービスの稼働情報を確認できます。

コマンドによるイベントサービスの定義情報の収集と配布

JP1/Baseが提供するコマンドを実行して，イベントサービスとイベント変換で使用する定義ファイルの定義情報を収集・配布できます。

JP1製品の定義情報の収集

JP1/AJSのジョブネット定義やJP1/SSO定義など，JP1製品が管理する定義情報を収集できます。収集された定義情報はJP1/IMの監視対象としてJP1/IMで管理されます。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」を参照してください。

プロセス管理

JP1/Baseの起動，停止などの動作を制御します。以下の機能を制御します。

ユーザー管理

定義情報収集・配布

ヘルスチェック

ローカルアクション

構成管理

JP1/IMのシステム構成を管理します。

コマンド実行

JP1/IMから要求されたコマンドを実行します。

サービス管理制御

JP1/IMの構成管理のエージェント機能を制御します。

プロセス間通信

JP1/IMの構成管理とサービス管理制御との通信などで使用する通信基盤です。

ヘルスチェック

JP1/Baseの各プロセスを監視し，プロセスにハングアップなどの異常が生じた場合にメッセージやJP1イベントで通知します。この機能を使用すると，プロセスの異常を早期に検知できます。また，異常が発生したプロセスを容易に特定できるため，異常時の影響を最小限に抑えた対処ができます。

ローカルアクション

特定のJP1イベントを契機に，自動的にコマンドを実行します。障害発生時などに，メール送信や電話連絡などのコマンドを実行してシステム管理者に通知したり，再起動などの処置を実行したりできます。

ISAMファイル関連のユーティリティコマンド

JP1/Baseでは，ISAMを利用する場合に役立つユーティリティコマンドを提供しています。このコマンドの詳細については，「15.　コマンド」を参照してください。

統合トレース機能（HNTRLib2）

JP1/Baseを前提とする製品（JP1/IMやJP1/AJS）を含めた動作処理の流れをトレースします。トレースした結果は，ログ情報として保管され，障害が発生した場合などの原因究明に役立ちます。

1.1.1　OSごとのJP1/Baseの機能サポート状況（Windowsの場合）

JP1/Baseが提供する各機能は，OSによってはサポートされていない機能もあります。

Windowsの場合のOSごとのサポート状況を次の表に示します。

表1‒1　OSによるJP1/Baseの各機能サポート状況一覧（Windowsの場合）

機能一覧

OS（Windows）

2016，2019，2022

ユーザー管理

ユーザー認証

○

ディレクトリサーバによるユーザー認証※1

○

ユーザーマッピング

○

サービスの起動管理

起動順序の制御

○

終了順序の制御※2

○

イベントサービス

△※3

イベント変換

ログファイルトラップ

○

イベントログトラップ

○

定義収集・配布

IM構成管理による定義情報の管理・サービスの稼働情報の確認

○

コマンドによるイベントサービスの定義情報の収集と配布

○

JP1製品の定義情報の収集

○

プロセス管理

○

ヘルスチェック

○

ローカルアクション

○

ISAMファイル関連のユーティリティコマンド

○

統合トレース（HNTRLib2）

○

IPv4アドレスでの通信機能

○

IPv6アドレスでの通信機能

○

（凡例）

2016，2019，2022：Windows Server 2016，Windows Server 2019，およびWindows Server 2022

○：サポートしている。

△：一部サポートしていない。

−：サポートしていない。

注※1　連携するディレクトリサーバはActive Directoryです。

注※2　終了順序を制御したい場合，JP1/Power Monitorが必要です。

注※3　バージョン5互換用イベントはサポートしていません。

1.1.2　OSごとのJP1/Baseの機能サポート状況（UNIXの場合）

JP1/Baseが提供する各機能は，OSによってはサポートされていない機能もあります。

UNIXの場合のOSごとのサポート状況を次の表に示します。

表1‒2　OSによるJP1/Baseの各機能サポート状況一覧（UNIXの場合）

機能一覧

OS（UNIX）

AIX

Linux

ユーザー管理

ユーザー認証

○

○

ディレクトリサーバによるユーザー認証※

−

−

ユーザーマッピング

○

○

サービスの起動管理※

起動順序の制御

−

−

終了順序の制御

−

−

イベントサービス

○

○

イベント変換

ログファイルトラップ

○

○

イベントログトラップ※

−

−

定義収集・配布

IM構成管理による定義情報の管理・サービスの稼働情報の確認

○

○

コマンドによるイベントサービスの定義情報の収集と配布

○

○

JP1製品の定義情報の収集

○

○

プロセス管理

○

○

ヘルスチェック

○

○

ローカルアクション

○

○

ISAMファイル関連のユーティリティコマンド

○

○

統合トレース（HNTRLib2）

○

○

IPv4アドレスでの通信機能

○

○

IPv6アドレスでの通信機能

−

○

（凡例）

AIX：AIX

Linux：Linux

○：サポートしている。

△：一部サポートしていない。

−：サポートしていない。

注※　UNIXではサポートしていません。

第2編　機能編

2　JP1/Baseの機能詳細

この章では，JP1/Base機能について説明します。

2.1　ユーザーを管理する

JP1/IM，JP1/AJSなどのJP1製品では，さまざまなOSが混在する分散システムで安全に運用するために，専用アカウントであるJP1ユーザーを使用しています。JP1/Baseは，JP1ユーザーを管理します。

JP1/Baseのユーザー管理には，次に示す二つの機能があります。

ユーザー認証

ユーザーマッピング

ユーザー認証については2.1.1〜2.1.4，ユーザーマッピングについては2.1.5で説明します。

2.1.1　ユーザー認証とは

ユーザー認証では，ビューアー（JP1/IM - View，JP1/AJS - Viewなど）からマネージャー（JP1/IM - Manager，JP1/AJS - Managerなど）へのログイン要求を確認し，ログインしたJP1ユーザーが，ジョブやジョブネットなどJP1で扱う資源（JP1資源）に対してどのような操作ができるかを設定・管理できます。JP1資源へのアクセス可否や操作権限の情報をJP1認証情報といいます。JP1認証情報は，認証サーバ上でJP1ユーザーごとにまとめて管理・制御されます。

認証サーバにいつ接続されるかについては，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。

(1)　ユーザー認証について

ユーザーがJP1/IM - ViewやJP1/AJS - Viewなどのビューアーからログインする際，不正なユーザーによるアクセスを防止するためユーザー認証を行います。ユーザーがログイン時に入力したJP1ユーザー名およびパスワードが，あらかじめ登録されたJP1ユーザー名およびパスワードに合致するかどうかを確認します。通常，JP1ユーザー名およびパスワードは認証サーバに登録され，ユーザー認証は認証サーバ上で行います。

なお，Windowsの場合，ディレクトリサーバと連携してユーザー認証できます。ディレクトリサーバと連携したユーザー認証については，「2.1.4　ディレクトリサーバと連携したユーザー認証とは」を参照してください。

(2)　JP1資源に対する操作権限の管理について

ログインしたすべてのJP1ユーザーが，システム上に存在するJP1資源に対してあらゆる操作を実行できるのは，セキュリティ上問題があります。そのため，JP1ユーザーごとに，JP1資源に対するアクセス権限および操作権限を制御する必要があります。

JP1ユーザーがどのJP1資源にアクセスできるかは，JP1資源をグループ化したJP1資源グループに対して設定します。

例えば，JP1/AJSでは，ジョブやジョブネットなどのJP1資源を幾つかのグループに分けたものをJP1資源グループとして扱います。JP1/IMでは，JP1/IMの各種設定をJP1資源グループとして扱います。

また，JP1資源グループへのアクセスを許可されたJP1ユーザーが，JP1資源グループに対してどのような操作ができるかを，JP1権限レベルとして設定します。

(3)　パスワードポリシーによる管理

JP1ユーザーの登録およびJP1ユーザーのパスワード変更時に，パスワードポリシーに該当するパスワードかどうかをチェックします。これにより，安易なパスワードの登録抑止やJP1への不正アクセスのリスクを軽減して，高いセキュリティを維持します。

パスワードポリシーで設定する項目を次の表に示します。

設定項目

設定範囲

最小文字数

6〜32バイト

最小文字種

1〜4種類または特定文字種

数字

英大文字

英小文字

記号（JP1ユーザーのパスワードに使用できるもの）

さらに高度なパスワードポリシーを適用して運用する場合は，ディレクトリサーバ（Active Directory）と連携して，ディレクトリサーバのパスワードポリシーを設定してください。

(4)　ユーザー認証の例

jp1user1が，JP1/AJS - Managerにログインする場合のユーザー認証の例を，次の図に示します。

図2‒1　ユーザー認証の例

マネージャーホストでは，どのホストにインストールされたJP1/Baseを認証サーバとして参照するか指定しておきます。認証サーバは，JP1/Baseがインストールされたホストであれば，どのホストでもかまいません。認証サーバに他ホストを指定した場合は，他ホストにユーザー認証を要求します。

認証サーバのホストにログインした場合，および認証サーバ以外のホストにログインした場合のユーザー認証の例を，次の図に示します。

図2‒2　認証サーバのホストにログインした場合および認証サーバ以外のホストにログインした場合のユーザー認証の例

2.1.2　ユーザー認証圏とは

ユーザー認証をする際に同一の認証サーバを参照しているホストの集まりを，ユーザー認証圏といいます。ユーザー認証圏は，認証サーバが管理するホストの範囲を示しています。ユーザー認証圏を構築するには，JP1/IM - ManagerやJP1/AJS - Managerなどのマネージャー製品がインストールされた各ホストで同じ認証サーバを指定します。

JP1/IM，JP1/AJSを例に説明します。

通常，JP1/IM - ViewからJP1/IM - Managerへ接続する際，またはJP1/AJS - ViewからJP1/AJS - Managerへ接続する際，ユーザー認証が必要です。しかし，JP1/IM - ViewからJP1/IM - Managerにログインした状態で，JP1/IM - ViewからJP1/AJS - Viewのモニター画面を呼び出してほかのホストのJP1/AJS - Managerに接続する場合，JP1/AJS - Viewの接続先ホストがJP1/IM - Viewでログインしたホストと同一認証圏内であれば，ログインが不要になります。JP1/AJS - Viewの接続先ホストがJP1/IM - Viewでログインしたホストと異なる認証圏の場合は，そのホストを管理する認証サーバに登録されているJP1ユーザー名でログインする必要があります。

(1)　ユーザー認証圏を二つ構築した場合のユーザー認証の例

ユーザー認証圏を二つ構築した場合のユーザー認証の例を次の図に示します。

図2‒3　ユーザー認証圏を二つ構築した場合のユーザー認証の例

(2)　認証サーバの信頼性を高めるための運用例

認証サーバは，システム全体のユーザーを管理する重要なホストです。何らかの理由によって認証サーバに接続できなくなった場合に業務が停止しないように，運用方法を検討する必要があります。認証サーバの信頼性を高めるための運用例を次に示します。

セカンダリー認証サーバを設置する

セカンダリー認証サーバを設置すると，プライマリー認証サーバの障害発生時にセカンダリー認証サーバに切り替えて業務を継続できます。セカンダリー認証サーバについては，「2.1.3　セカンダリー認証サーバとは」を参照してください。

認証サーバをクラスタ運用する

JP1/Baseは，クラスタ運用に対応しています。クラスタシステムで認証サーバを使用すると，実行系サーバの障害発生時に待機系サーバに自動的に切り替えて業務を継続できます。クラスタシステムで認証サーバを使用する場合は，「5.　クラスタシステムで運用する場合の設定」を参照してください。

認証サーバへの接続状態を監視する

認証サーバへの接続状態を常時監視すると，認証サーバの停止やネットワーク障害によって認証サーバへ接続できなかった場合に，速やかに検知して対処できます。JP1/Baseでは，認証サーバへ接続できなかった場合に統合トレースログにメッセージを出力するため，このログを監視すると，認証サーバへの接続状態を把握できます。

また，セカンダリー認証サーバを設置した場合には，認証サーバへの接続状態が自動で変更された場合に統合トレースログに通知されるメッセージを，JP1イベントとして発行できます。認証サーバの閉塞状態をJP1イベントで監視したい場合は，「4.　JP1/Baseの障害に備えた設定」を参照してください。

2.1.3　セカンダリー認証サーバとは

一つのユーザー認証圏内に認証サーバを2台設置できます。1台は，通常時に利用する認証サーバで，もう1台は，予備として稼働する認証サーバです。通常時に利用する認証サーバをプライマリー認証サーバ，予備として稼働する認証サーバをセカンダリー認証サーバと呼びます。セカンダリー認証サーバを設置した場合，何らかの理由によってプライマリー認証サーバに接続できなかったときに，自動的に接続先をセカンダリー認証サーバに切り替えて，業務の停止を防ぎます。

(1)　セカンダリー認証サーバの設定

セカンダリー認証サーバを設置する場合，各ホスト上でセカンダリー認証サーバとして使用するホストを指定します。また，プライマリー認証サーバとセカンダリー認証サーバで，JP1/Baseのバージョン，JP1ユーザーおよび操作権限の設定が異なっていると，切り替えが発生したときに認証エラーになることがあるため，プライマリー認証サーバの設定情報を，セカンダリー認証サーバにコピーします。

(2)　プライマリー認証サーバへの接続が失敗した場合の接続処理の流れ

プライマリー認証サーバへの接続が失敗した場合の接続処理の流れを次の図に示します。

図2‒4　プライマリー認証サーバへの接続が失敗した場合の接続処理の流れ

図2-4のように，接続に失敗した認証サーバに接続を試みない状態のことを閉塞状態といいます。閉塞状態かどうかは，GUI（Windows限定）やコマンドで確認でき，閉塞状態であれば閉塞中と表示されます。

(3)　認証サーバの状態と接続先認証サーバの選択方法

認証サーバの状態と接続先認証サーバの選択方法を，次の表に示します。

認証サーバの状態

接続先認証サーバの選択方法

プライマリー認証サーバ：閉塞中でない

セカンダリー認証サーバ：閉塞中でない

プライマリー認証サーバへ接続を試みる。プライマリー認証サーバとの接続に失敗した場合は，プライマリー認証サーバを閉塞状態に設定し，セカンダリー認証サーバへ接続を試みる。セカンダリー認証サーバとの接続に失敗した場合，セカンダリー認証サーバを閉塞状態に設定する。

プライマリー認証サーバ：閉塞中

セカンダリー認証サーバ：閉塞中でない

セカンダリー認証サーバへ接続を試みる。セカンダリー認証サーバとの接続に失敗した場合は，セカンダリー認証サーバを閉塞状態に設定し，プライマリー認証サーバへの接続は行わない。

プライマリー認証サーバ：閉塞中でない

セカンダリー認証サーバ：閉塞中

プライマリー認証サーバへ接続を試みる。プライマリー認証サーバとの接続に失敗した場合は，プライマリー認証サーバを閉塞状態に設定し，セカンダリー認証サーバへの接続は行わない。

プライマリー認証サーバ：閉塞中

セカンダリー認証サーバ：閉塞中

プライマリー認証サーバへ接続を試み，接続に成功した場合，プライマリー認証サーバの閉塞状態を解除する。

プライマリー認証サーバとの接続に失敗した場合は，セカンダリー認証サーバに接続を試み，接続に成功した場合，セカンダリー認証サーバの閉塞状態を解除する。

セカンダリー認証サーバとの接続に失敗した場合は接続エラーとなる。

ユーザーが意図的に両認証サーバを閉塞状態に設定しても，JP1/IM - ViewやJP1/AJS - Viewなどでログインなどがされた場合は，認証サーバに接続しようと試み，接続に成功すると，認証サーバの閉塞状態は解除されます。

両認証サーバへの接続が閉塞状態になると，システム上の業務が停止することになります。そのため，閉塞状態になったことを素早く検知して，閉塞状態となった原因を取り除く必要があります。

閉塞状態になったことを検知する方法として，JP1/Baseでは，認証サーバへの接続状態が自動で変わったときにJP1イベントを発行できます。JP1イベントを発行すると，JP1/IM - Viewなどから，認証サーバへの接続状態を監視できます。初期設定ではJP1イベントは発行されません。JP1イベントを発行したい場合は，「4.3　プロセスの異常終了および認証サーバの切り替え発生を検知する」を参照してください。

なお，セカンダリー認証サーバに接続中に，プライマリー認証サーバの障害が回復した場合は，手動でプライマリー認証サーバの閉塞状態を解いてください。解除方法については，「8.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）」を参照してください。

注意事項

接続先認証サーバの切り替えが発生するのは，通信障害や認証サーバが起動していなかった場合だけです。実行ユーザーの入力ミスやパスワードミスで切り替えが発生することはありません。

2.1.4　ディレクトリサーバと連携したユーザー認証とは

ユーザー認証では，JP1認証情報（JP1ユーザー認証情報およびJP1操作権限），またはJP1認証情報のうちJP1ユーザー認証情報だけをディレクトリサーバと連携して管理できます。この機能を，ディレクトリサーバ連携といいます。連携するディレクトリサーバはActive Directoryです。

ディレクトリサーバ連携する場合，ユーザーのパスワードはディレクトリサーバで管理（ディレクトリサーバのポリシーで管理）されるため，JP1/Baseのパスワードポリシー定義では，管理しません。

ディレクトリサーバ連携には，JP1認証情報をディレクトリサーバで管理する方法と，JP1認証情報のうちJP1ユーザー認証情報だけをディレクトリサーバで管理する方法があります。ディレクトリサーバ連携を使用しないユーザー認証と合わせて，次の表に管理対象を示します。

表2‒1　JP1認証情報の管理方法

ユーザー認証の方法

JP1認証情報

JP1ユーザー認証情報

JP1操作権限

ユーザー名

パスワード

ディレクトリサーバ連携を使用しない

認証サーバで管理

認証サーバで管理

認証サーバで管理

JP1認証情報をディレクトリサーバで管理する

ディレクトリサーバで管理

ディレクトリサーバで管理

ディレクトリサーバで管理

JP1ユーザー認証情報だけをディレクトリサーバで管理する

認証サーバとディレクトリサーバで管理

ディレクトリサーバで管理

認証サーバで管理

JP1ユーザーにはJP1認証情報の管理種別として，ユーザー認証の方法ごとにJP1ユーザー種別があります。ユーザー認証の方法ごとのJP1ユーザー種別を次の表に示します。

表2‒2　JP1ユーザー種別

ユーザー認証の方法

JP1ユーザー種別

ディレクトリサーバ連携を使用しない（認証サーバでユーザー認証する）

標準ユーザー

JP1認証情報をディレクトリサーバで管理する

DSユーザー

JP1ユーザー認証情報だけをディレクトリサーバで管理する

連携ユーザー

どのJP1ユーザーを標準ユーザー，DSユーザー，または連携ユーザーとするかは，認証サーバで設定します。なお，次に示す組み合わせでJP1ユーザー種別を併用することもできます。アカウント管理者は，アカウントがどこに定義されているかを意識してJP1ユーザー種別を設定します。

標準ユーザーとDSユーザー※

標準ユーザーと連携ユーザー

注※

ユーザー認証しようとするユーザー名が標準ユーザーとDSユーザーの両方に存在する場合は，標準ユーザーとしてユーザー認証をします。

DSユーザーの場合，次に示す運用ができます。

JP1認証情報をディレクトリサーバで管理できる。

JP1認証情報（JP1ユーザー認証情報およびJP1操作権限）をディレクトリサーバで管理します。ディレクトリサーバ（Active Directory）のアカウントをJP1ユーザーとして使用でき，JP1操作権限と一緒に管理できます。

Active DirectoryのセキュリティグループにJP1操作権限を設定できる。

Active Directoryではセキュリティグループを用いることで，ユーザーアカウントを管理しやすい単位にまとめることができます。セキュリティグループにJP1操作権限を設定することで，そのセキュリティグループに所属するアカウントにもJP1操作権限を付与することができ，JP1操作権限を容易に設定できます。なお，JP1操作権限が設定されているセキュリティグループをDSグループといいます。

また，セキュリティグループはさらに上位のセキュリティグループに所属する設定もできるため，上位のセキュリティグループに設定されたJP1操作権限も付与されます。

図2‒5　セキュリティグループへのJP1操作権限の設定

連携ユーザーの場合，次に示す運用ができます。

JP1認証情報のうちJP1ユーザー認証情報だけをディレクトリサーバで管理できる。

JP1ユーザー認証情報をディレクトリサーバが管理します。JP1ユーザー名，JP1操作権限は認証サーバが管理します。

(1)　ディレクトリサーバ連携の設定

初期設定では，ディレクトリサーバ連携は無効に設定されています。ディレクトリサーバと連携するためには，共通定義の設定を変更する必要があります。設定の詳細については，「8.2　ディレクトリサーバと連携してユーザー認証する場合の設定（Windows限定）」を参照してください。

設定を変更したあと，ディレクトリサーバとの接続状態および設定内容をコマンドで確認できます。また，ディレクトリサーバがトラブルのために使用できなくなった場合，コマンドを使って一時的に接続先を切り替えられます。

(2)　ディレクトリサーバと連携したユーザー認証の例

JP1認証情報をディレクトリサーバで管理する場合のユーザー認証の例を次の図に示します。

図2‒6　JP1認証情報をディレクトリサーバで管理する場合のユーザー認証の例

JP1ユーザー認証情報だけをディレクトリサーバで管理する場合のユーザー認証の例を次の図に示します。

図2‒7　JP1ユーザー認証情報だけをディレクトリサーバで管理する場合ユーザー認証の例

(3)　ディレクトリサーバと連携してユーザー認証をする場合の注意事項

JP1/Baseの認証サーバでの認証処理のほかに次の処理が発生するため，ユーザー認証に時間が掛かることがあります。

認証サーバとディレクトリサーバ間の通信

ディレクトリサーバでのユーザー認証

なお，認証サーバとディレクトリサーバ間の通信はLDAPプロトコルが使用されます。

2.1.5　ユーザーマッピングとは

JP1ユーザーが他ホストに対してジョブやコマンドを実行する際，ジョブやコマンドを実行するホスト上のOSユーザー権限が必要になります。そのため，ジョブやコマンドを実行したいホスト上でJP1ユーザーとOSユーザーを対応づける必要があります。これをユーザーマッピングといいます。

ユーザーマッピングでは，次に示す三つの内容を対応づけて設定します。

どのJP1ユーザーからの実行命令を許可するか

どのサーバホストからの実行命令を許可するか

ジョブやコマンドをどのOSユーザーの権限で実行するか

メモ

UNIXの場合は，OSユーザー名だけでOSユーザーとして実行できますが，Windowsの場合は，OSユーザー名とパスワードが必要なため，OSユーザーのパスワードも管理します。このため，WindowsでOSユーザーのパスワードを変更した場合，JP1/Baseのパスワード情報も変更してください。

(1)　ユーザーマッピングの例（JP1/AJSの場合）

JP1/AJSの場合のユーザーマッピングの例を次の図に示します。

図2‒8　ユーザーマッピングの例（JP1/AJSの場合）

JP1/AJS - ViewからJP1/AJS - Managerにログインする場合には，JP1/AJS - Managerがインストールされたホスト上でもJP1ユーザーとOSユーザーをマッピングする必要があります。そのため，HostA（マネージャーホスト）およびHostB（ジョブを実行するエージェントホスト）でユーザーマッピングの設定が必要です。

詳細については，マニュアル「JP1/Automatic Job Management System 3 構築ガイド」を参照してください。

(2)　ユーザーマッピングの例（JP1/IMの場合）

JP1/IMの場合のユーザーマッピングの例を次の図に示します。

図2‒9　ユーザーマッピングの例（JP1/IMの場合）

JP1/IM - Viewからの操作で，HostD（エージェントホスト）でコマンドを実行するため，HostDでユーザーマッピングの設定が必要です。また，HostEで自動アクションを実行するため，HostEでユーザーマッピングの設定が必要です。

なお，自動アクションを実行するユーザーは，JP1/IM - Manager上で定義します。

2.2　サービスの起動順序および終了順序を制御する（Windows限定）

JP1/Baseでは，JP1シリーズ製品，およびJP1以外の製品のサービスの起動・終了順序を詳細に管理できます。

JP1/IMやJP1/AJSなど，JP1/Baseを前提とする製品のサービスは，JP1/Baseのサービスの起動後に起動する必要があります。また，JP1イベントを発行する製品のサービスも，JP1/Baseのサービスの起動後に起動する必要があります。JP1/Baseのサービスが起動する前にJP1イベントが発行された場合，JP1/Baseに登録できないためです。

なお，サービスを終了させたい場合，同一マシン上にJP1/Power Monitorがインストールされている必要があります。JP1/Power Monitorの詳細については，マニュアル「JP1/Power Monitor」を参照してください。

起動時には，まず起動管理サービス（JP1/Base Control Service）が起動し，その後，起動順序定義ファイル（JP1SVPRM.DAT）での記述順に，各サービスが起動されます。起動順序定義ファイル（JP1SVPRM.DAT）で指定した時間を過ぎてもサービスが起動しなかった場合は，次のサービスが起動されます。また，すべてのサービスが起動したあとに実行するコマンド名を指定することもできます。

JP1/Power Monitorからのシャットダウン時には，起動時と逆の順序で各サービスが終了したあと，起動管理サービスが終了します。この場合には，各サービスが終了したあとに実行するコマンド名を指定できます。

初期設定では，JP1/Base，JP1/IM，JP1/AJSの順番でサービスが起動するように設定されています。JP1/IMまたはJP1/AJSを使用しない場合には，Windowsイベントログにエラーメッセージが出力されるため，起動順序定義ファイル（JP1SVPRM.DAT）を編集してください。

2.3　イベントサービスを使ってJP1イベントを送受信する

システム内の各ホスト上では，「ディスク容量が不足しています」「通信エラーが発生しました」など，さまざまな事象が発生します。JP1/Baseでは，このような事象のうち，JP1/Baseに通知される事象をJP1イベントとして管理できます。

2.3.1　イベントサービスとは

イベントサービスとは，システム内で発生した事象をJP1イベントとして，登録および管理するための機能です。

JP1/Baseのイベントサービスでは，次のことができます。

JP1イベントをイベントDBに保存する。

JP1/Baseに通知されたJP1イベントは，イベントDBというファイルに蓄積されます。イベントDBは，各ホストのJP1/Baseに存在します。

JP1イベントをほかのホストへ転送する。

各ホストで発生したJP1イベントを上位の管理サーバへ転送できます。転送したいJP1イベントの条件を指定して，重要なJP1イベントだけを上位の管理サーバへ転送できます。これによって，各ホストの状態を管理サーバで監視したり，対処の必要な事象が発生した場合に管理サーバ上で素早く検知して対処したりできます。

また，JP1イベントの転送が，ネットワークの障害や転送先イベントサーバの停止によって失敗した場合，自動的に転送をリトライできます。

これらの機能を，イベントサーバというプログラムが管理しています。イベントサーバを起動すると，JP1イベントを送受信できる状態になります。

2.3.2　イベントDBとは

イベントDBとは，JP1/Baseがインストールされたホストで発生したJP1イベントを蓄積するファイルです。

イベントDBは次のファイルで構成されています。

データ（IMEvent0.dat，IMEvent1.dat）

インデックス（IMEvent0.idx，IMEvent1.idx）

転送情報（IMEvent0.fwd，IMEvent1.fwd）

重複防止テーブル（IMEvent.rep）

イベントサービスのサービスが起動すると，これらのファイルが自動生成されます。データ，インデックス，転送情報はそれぞれ二つずつ生成されます。最初に一方のファイルが使用され，それがイベントサーバ設定ファイル（conf）のdb-sizeパラメーターで指定した容量に達すると，もう一方のファイルに切り替わります。二つ目のファイルの容量がいっぱいになると，一つ目のファイルの内容がすべて削除されたあとに新しくJP1イベントが蓄積されます。

(1)　イベントDBの切り替え

イベントDBが切り替わる流れを次の図に示します。

図2‒10　イベントDBが切り替わる流れ

イベントDBが切り替わるタイミングは，イベントDBの容量がイベントサーバ設定ファイルに指定した容量に達した場合，またはJP1イベントの保管期限がイベントサーバ設定ファイルに指定した期限に達した場合です。また，コマンドを使って意図的に切り替えることもできます。

イベントDBの内容は，JP1/IM - Viewの［イベントコンソール］画面から確認したり，コマンドを使ってcsvファイルに出力して確認したりできます。JP1/IM - Viewについては，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」を参照してください。イベントDBの内容をcsv出力する方法については，「10.3　イベントDBの内容をcsvファイルに出力する」を参照してください。

(2)　イベントDBの破損を検知するタイミング

イベントDBを直接編集したり，イベントサービスの稼働中に，OSのコマンドやバックアップ用のソフトウェアでイベントDBをバックアップおよびリストアしたりすると，イベントDBを破損するおそれがあるためご注意ください。

JP1/Baseは，次に示すタイミングでイベントDBが破損したかどうかを検知します。

イベントサービスの起動時

JP1イベントの転送時

イベント取得関数によるJP1イベント取得時※

JP1/IM - Viewからのイベント検索時※

注※

イベントDBのアクティブ面，スタンバイ面ごとに，1回だけメッセージが出力されます。イベントDBのアクティブ面が破損した場合，アクティブ面に登録されているJP1イベントを取得または検索すると，破損を通知するメッセージが1回だけ出力されます。スタンバイ面が破損した場合も同様です。

メッセージをJP1/IM - View上で確認したい場合は，メッセージをJP1イベントに変換して，マネージャーホストへ転送してください。イベント変換の詳細については，「11.　イベント変換の設定」を参照してください。

(3)　JP1イベントの重複登録チェック

イベントサービスには，イベントDBに同一のJP1イベントが重複して登録されることを防止するため，重複登録チェック機能があります。重複登録チェックを行わないと，次の場合にJP1イベントが重複して登録されるおそれがあります。

転送されたJP1イベントを送受信するホスト間で通信障害が発生した場合

複数ホストに転送するJP1イベントの再転送先ホストが集約されている場合

JP1イベントの転送経路が循環している場合

(4)　重複防止テーブル

重複防止テーブルは，重複登録チェック機能を行うためのテーブルです。重複防止テーブルは，転送元ホストごとの転送実績レコードを記録し，転送されたJP1イベントを受信した場合に，レコードを追加したり更新したりします。転送実績レコードには発行元イベントDB内通し番号の最大値など，重複登録チェック時にイベントDBの検索時に必要な情報が記録されています。

重複防止テーブルは，イベントサーバ設定ファイル（conf）のoptionsパラメーターにsave-repフラグを指定した場合，ファイルに保持します。save-repフラグを指定しない場合，メモリーに保持します。転送されたJP1イベントを受信するイベントサーバでは，ファイルに保持する場合とメモリーに保持する場合で動作に違いがあるため，ファイルに保持して運用することを推奨します。

重複防止テーブルをファイルに保持する場合と，メモリーに保持する場合の動作の違いを次に示します。

ファイルに保持する場合

重複防止テーブルを不揮発的に保持します。このため，イベントサーバを再起動しても，クリアされません。重複防止テーブルに記録されていない転送元ホストからJP1イベントを受信した場合は，転送実績がないと判断してすぐに登録します。転送されたJP1イベントの登録に必要な時間は，転送実績に関係なく一定になります。

サーバリプレースやディスク障害などで転送元ホストのイベントDBが失われ，転送元ホストのイベントDB内通し番号が0に戻った場合に，転送元ホストまたは転送先ホストで重複防止テーブルクリア用JP1イベント（ユーザイベント）を発行すると，運用中に重複防止テーブルから転送元ホストの発行元イベントDB内通し番号の最大値をクリアできます。

重複防止テーブルクリア用JP1イベント（ユーザイベント）

イベントID：7FFF8001

メッセージ：DPT CLEAR EVENT

OBJECT_NAME：転送元イベントサーバ名（転送先ホストで発行する場合だけ必要）

メモリーに保持する場合

重複防止テーブルを揮発的に保持します。このため，イベントサーバを再起動すると，クリアされてしまいます。重複防止テーブルに記録されていない転送元ホストからJP1イベントを受信した場合は，過去の転送実績をイベントDBから検索し，そのあと重複防止テーブルに登録します。転送されたJP1イベントの登録に必要な時間は，転送実績によって変化します。

また，新たに追加したエージェントから転送されたJP1イベントを受信した場合には，イベントDBに登録されているすべてのJP1イベントに対して検索が行われるため，JP1イベントを使用する処理が遅延する場合があります。遅延する時間はイベントDBのサイズに比例して長くなります。

2.3.3　JP1/Baseが取得するJP1イベントの種類

表2‒3　JP1/Baseが取得するJP1イベントの種類

種類

説明

JP1の各プログラムが発行するJP1イベント

JP1の各プログラムが発行するJP1イベントを取得できます。バージョン5以前の製品であるJP1/SESで認識したイベントの属性を拡張したJP1イベントを認識できます。また，バージョン5以前の製品であるJP1/IMが取得できるイベントを取得できます。

各イベントの詳細については，各プログラムのマニュアルを参照してください。

jevsendコマンドまたはjevsenddコマンドでユーザーがイベントサーバに登録したJP1イベント

jevsendコマンドおよびjevsenddコマンドを実行すると，JP1イベントをイベントサーバに登録できます（jevsenddコマンドを使うと，JP1イベントがイベントサーバに登録されたかどうかを確認できます）。なお，jevsendコマンドまたはjevsenddコマンドを使ってイベントサーバに登録したJP1イベントを，JP1/IM - Viewの［イベントコンソール］画面に表示させたい場合は，拡張属性の項目「重大度」を指定する必要があります。

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

また，JP1イベント発行関数を使うと，JP1イベントをユーザーアプリケーションから直接発行でき，逆にJP1イベント取得関数を使って，JP1イベントをユーザーアプリケーションで直接取得できます。詳細については，マニュアル「JP1/Base 関数リファレンス」を参照してください。

アプリケーションプログラムのログファイル

アプリケーションプログラムのログファイルに出力される情報をJP1イベントに変換して取得できます。変換方法については，「11.1　アプリケーションプログラムのログファイルを変換する」を参照してください。

Windowsのイベントログ

Windowsのイベントログに出力される情報をJP1イベントに変換して取得できます。変換方法については，「11.2　Windowsのイベントログを変換する」を参照してください。

2.3.4　JP1イベントの転送

JP1/Baseでは，各ホストで発生したJP1イベントをJP1/IM - Managerで定義したシステム構成に従って上位のホストに転送できます。発生したJP1イベントのうち，障害通知や警告情報などの重要なJP1イベントだけを転送することもできます。

上位のホストに転送するJP1イベントの条件（イベントフィルター）は，転送設定ファイル（forward）で定義します。初期設定では，JP1/IM - Managerで定義した階層に従って，重要なJP1イベントが上位の管理サーバに転送されるように設定されています。

エージェントからサブマネージャー，サブマネージャーからマネージャーにJP1イベントを転送していく例を次の図に示します。

図2‒11　イベントフィルターを使ったJP1イベントの転送例

マネージャーホストに転送されたJP1イベントは，JP1/IM - Viewで確認できます。JP1/IM - Viewからマネージャーホストにログインし，転送されたJP1イベントを確認することでシステム全体の状況を監視できます。また，障害を通知するJP1イベントに対して自動アクションを実行し，回復処理をすることもできます。

JP1イベントの転送のリトライ

一時的なネットワークの障害や転送先のイベントサービスの停止などによって，JP1イベントの転送に失敗した場合，初期設定では転送をリトライします。リトライする期間やリトライ間隔などの設定は，イベントサーバ設定ファイル（conf）で行います。

2.4　ログメッセージおよびイベントログをJP1イベントに変換する

JP1/Baseのイベントサービスでは，ログメッセージおよびイベントログをJP1イベントに変換して管理できます。

JP1/Baseで使用できるイベント変換を次に示します。

ログファイルトラップ

アプリケーションプログラムのログファイルに出力される情報をJP1イベントに変換します。

イベントログトラップ（Windows限定）

Windowsのイベントログに出力される情報をJP1イベントに変換します。

2.4.1　アプリケーションプログラムのログファイルを変換する

アプリケーションプログラムのログファイルの情報をJP1イベントに変換してイベントDBに登録する流れを次の図に示します。

図2‒12　アプリケーションプログラムのログファイルの変換から登録までの流れ

ログファイルトラップを使用するには，ログファイルトラップ動作定義ファイルを作成し，監視するログファイルの出力形式と，JP1イベントに変換したいログデータの条件を指定します。その後，コマンドを実行すると，ログファイルトラップ管理サービス（デーモン）を基盤としてログファイルトラップが生成され，ログファイルを監視します。監視条件に一致するログデータがあると，JP1イベントに変換してイベントDBに登録します。複数のログファイルトラップを同時に起動できるため，さまざまなログファイルを異なる条件で監視できます。また，一つのログファイルトラップで複数のログファイルを監視することもできます。

JP1イベントとして登録できるメッセージは，jevlogstartコマンドで-mオプションを省略した場合，511バイトまでです。JP1イベントに変換するメッセージが511バイトを超えた場合，以降のメッセージを切り捨てます。メッセージの長さを拡張したい場合は，jevlogstartコマンドで-mオプションに値を指定すると，1,023バイトまで登録できます。

2.4.2　ログファイルトラップの前提条件

ログファイルトラップを使用する場合は，次の条件が必要です。

次に示すファイルの文字コードやコマンドを実行した時のロケール情報（LANGなどの言語種別）がすべて統一されていること。ただし，WindowsでUnicode（UTF-8，UTF-16）形式のファイル（以降，Unicodeファイルと呼びます）を監視する場合は，jevlogstartコマンドに-gオプションを指定してログファイルトラップを起動してください。その際，ログファイルトラップ動作定義ファイルは，UnicodeではなくOSの起動している言語で作成してください。

ログファイルトラップの対象となるログファイル

ログファイルトラップ動作定義ファイル

jevlogstartコマンド

文字コード，およびロケール情報が統一されていない場合は，文字化けやログファイルトラップが生成されないなどの現象が発生することがあります。

イベントサービス，およびログファイルトラップ管理サービス（デーモン）が起動していること。

Windowsの場合，初期設定ではイベントサービス，およびログファイルトラップ管理サービスは，システムの起動時に自動的に起動するように設定されています。

UNIXの場合，それぞれサービスの起動コマンドを実行する必要があります。サービスの起動方法については「7.2　JP1/Baseを起動および終了する（UNIXの場合）」を参照してください。

2.4.3　ログファイルトラップによる監視の開始と終了

ログファイルの監視は，jevlogstartコマンドを実行してログファイルトラップが起動した時点で開始し，一定の間隔で監視を続けます。監視間隔は，jevlogstartコマンドの-tオプションで変更できます。jevlogstartコマンドの-tオプションを省略した場合，監視間隔は10秒です。ログファイルの監視が終了するタイミングは，jevlogstopコマンドのオプションの指定によって異なります。

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

ログファイルトラップを再起動した場合，ログファイルトラップの停止後から，次に起動するまでの間に出力されたログは監視されません。

ログファイルトラップの起動と終了

jevlogstartコマンド，およびjevlogstopコマンドを使用します。ログファイルがまだ存在しない場合でも，jevlogstartコマンドに-rオプションを指定すると，ログファイルが作成されるまでログファイルトラップを待機させられます。

また，ログファイルトラップ起動定義ファイルを使用すると，ログファイルトラップ管理サービス（デーモン）の起動時に，自動的にログファイルトラップを起動できます。

ログファイルトラップ起動定義ファイルを使用した場合のログファイルトラップの起動の流れを次に示します。

図2‒13　ログファイルトラップ起動定義ファイルを使用した場合のログファイルトラップの起動の流れ

ログファイルトラップ起動定義ファイルには，起動するログファイルトラップおよび起動オプション（jevlogstartコマンドで指定する内容）を指定します。ログファイルトラップ管理サービス（デーモン）起動時に，ログファイルトラップ起動定義ファイルが読み込まれ，起動定義ファイルに指定されているログファイルトラップが自動的に起動されます。

なお，ログファイルトラップを個別に停止したり，個別に動作定義ファイルを再読み込みしたりする場合は，ログファイルトラップを起動したときに標準出力される識別用のID番号，またはログファイルトラップを起動したときに設定した監視名を指定してコマンドを実行してください。

ログファイルトラップで変換されたJP1イベントの属性については，「17.3.1(27)　ログファイルトラップ動作定義ファイルのACTDEFパラメーターで指定されたイベントIDの詳細」を参照してください。

2.4.4　監視できるログファイル

ログファイルトラップは，さまざまな形式のログファイルを監視できます。監視対象のログファイルの形式を確認して，ログファイルトラップ動作定義ファイルにログファイルの形式を指定します。

ここでは，監視できるログファイルの形式を説明します。ログファイルの形式を確認する流れについては，「11.1.1　アプリケーションプログラムのログファイルの形式を確認する」を参照してください。

監視できるログファイルの形式を次に示します。

シーケンシャルファイル（SEQ）

シーケンシャルファイル（SEQ2）

シーケンシャルファイル（SEQ3）

ラップアラウンドファイル（WRAP1）

ラップアラウンドファイル（WRAP2）

マルチプロセス対応トレースファイル（HTRACE）

UPDタイプのログファイル（UPD）

UNIXのログファイルトラップでは，シンボリックリンクが設定されたファイルも監視できます。ただし，リンク先の変更に対応できるログファイルの形式はSEQ2だけです。

(1)　監視できるログファイルの形式（SEQ）

シーケンシャルファイル（SEQ）

一つのログファイルに追加書き込みし続けるファイル，または，ログファイルが一定の容量に達すると，別のファイル名で新たにログファイルを作成して書き込むファイルです。

ログファイルトラップ動作定義ファイルには「SEQ」と指定します。

監視対象のログファイルのサイズに制限はありません。

シーケンシャルファイル（SEQ）の動作を次の図に示します。

図2‒14　シーケンシャルファイル（SEQ）の動作

(2)　監視できるログファイルの形式（SEQ2）

シーケンシャルファイル（SEQ2）

Windowsの場合

同一ボリューム内でファイル名を変更したあと，変更前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

UNIXの場合

ファイル名を変更，またはファイルをいったん削除したあと，変更または削除前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

ログファイルトラップ動作定義ファイルには「SEQ2」と指定します。

監視対象のログファイルのサイズに制限はありません。

シーケンシャルファイル（SEQ2）の動作を次の図に示します。

図2‒15　シーケンシャルファイル（SEQ2）の動作

(3)　監視できるログファイルの形式（SEQ3）

シーケンシャルファイル（SEQ3）

Windows限定

ファイルをいったん削除したあと，削除前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

Windowsでは，この形式のログファイルを監視する場合，ログファイルトラップ動作定義ファイルには「SEQ3」と指定します。Windowsでログファイルトラップ動作定義ファイルに「SEQ2」を指定しても，この形式のログファイルは監視できません。

監視対象のログファイルのサイズに制限はありません。

シーケンシャルファイル（SEQ3）の動作を次の図に示します。

図2‒16　シーケンシャルファイル（SEQ3）の動作

(4)　監視できるログファイルの形式（WRAP1）

ラップアラウンドファイル（WRAP1）

ログファイルが一定の容量に達すると，ラップアラウンドして，再び先頭からデータを上書きする形式のファイルです。

ログファイルトラップ動作定義ファイルには「WRAP1」と指定します。

監視できるログファイルのサイズは2ギガバイト未満です。

また，監視対象のファイルと同じサイズの空きディスク容量が必要です。

ラップアラウンドファイル（WRAP1）の動作を次の図に示します。

図2‒17　ラップアラウンドファイル（WRAP1）の動作

(5)　監視できるログファイルの形式（WRAP2）

ラップアラウンドファイル（WRAP2）

ログファイルが一定の容量に達してラップアラウンドするとき，データを削除して再び先頭からデータを書き込む形式のファイルです。

ログファイルトラップ動作定義ファイルには「WRAP2」と指定します。

監視対象のログファイルのサイズに制限はありません。

ラップアラウンドファイル（WRAP2）の動作を次の図に示します。

図2‒18　ラップアラウンドファイル（WRAP2）の動作

(6)　監視できるログファイルの形式（HTRACE）

マルチプロセス対応トレースファイル（HTRACE）

Cosminexusなどの日立のミドルウェア製品が出力するログファイルの形式の一つで，複数のプロセスが一組のトレースファイルを共有するメモリマップドファイルを使用した固定サイズのファイルです。

ログファイルトラップ動作定義ファイルには「HTRACE」と指定します。

ログファイルの書き込み方法はラップアラウンドファイル（WRAP1）と同様です。マルチプロセス対応トレースファイル（HTRACE）の場合は，ログファイルが一定の容量（16メガバイトが上限）に達すると，ラップアラウンドして，再び先頭からデータを上書きします。データの書き込み時にファイルの更新日時は更新されません。監視対象のログファイルがマルチプロセス対応トレースファイルかどうかは，各製品のマニュアルを参照してください。

マルチプロセス対応トレースファイル（HTRACE）の動作を次の図に示します。

図2‒19　マルチプロセス対応トレースファイル（HTRACE）の動作

(7)　監視できるログファイルの形式（UPD）

UPDタイプのログファイル（UPD）

ファイル名に日付など不定な文字列が設定されるログファイルを監視するときに使用します。不定な文字列部分は，ワイルドカードで指定します。

ログファイルトラップ起動時には，ワイルドカードの指定に該当するファイルのうち，最新の更新日時のログファイルを監視対象とします。また，ログファイルトラップ起動中（監視中）は，監視中に新規作成されたワイルドカードの指定に該当するファイルのうち，最新の更新日時のログファイルへと監視を切り替えます。したがって，ログが書き込まれたときにファイルの更新日時情報が更新される必要があります。

一つのログファイルに追加書き込みし続けるファイル，または，ログファイルが一定の容量に達すると，別のファイル名で新たにログファイルを作成して書き込むファイル（シーケンシャルファイル）を継続して監視できます。

ログファイルトラップ動作定義ファイルには「UPD」と指定します。

監視対象のログファイルのサイズに制限はありません。

UPDタイプのログファイルの動作を次の図に示します。

図2‒20　UPDタイプのログファイルの動作

起動コマンド（jevlogstartコマンド）実行時，監視対象ファイル名はワイルドカードを含むように指定する。

ワイルドカード指定に該当するファイルだけ（上限1,000）が監視対象の候補となる。

起動時に上限を超えていた場合，起動エラーとなります。また，監視中に上限を超えた場合，エラーメッセージを出力して，ログファイルトラップを停止します。

起動時は，監視対象候補のファイルの中から最新更新日時のログファイル一つを決定して，監視を開始する。

起動中は，監視間隔（1秒）ごとに監視対象ログファイルの見直し（新規ファイルが作成されているかどうか）をする。

新規にファイルが作成されていた場合，監視中の未処理分のログを処理したあと，監視対象のログファイルを切り替える。

新規に作成されたファイルだけが監視の切り替えの対象であり，そのほかのファイルの最終更新日時が更新されても監視の切り替えはしません。新規ファイルが複数個あった場合は，その中から最新更新日時のファイル一つを決定して，切り替え対象とします。

2.4.5　監視できないログファイル

次に示すログファイルは，ログファイルトラップで監視できません。

毎回ファイルの先頭からログ情報が記録されるファイル

作成時にNULL文字がファイルサイズ分出力されていて，出力されたログでNULL文字が上書きされるファイル（マルチプロセス対応トレースファイル（HTRACE）の監視を除く）

ラップアラウンド時にログがすべて削除されないで，出力済みの一部のログだけが削除されるファイル

データが書き込まれても日時が更新されないファイル，およびデータが書き込まれないのに日時が更新されるファイル

ラップアラウンドファイル（WRAP1）およびUPDタイプのログファイルを監視する場合，ログファイルトラップがログファイルを読み込む際に，更新日時を参照します。このようなファイルを監視すると，ログファイルトラップが正常に動作しないことがあります。

バイナリーデータを含むファイル

ログファイル中の1行の終了文字以外でバイナリーデータを含むレコードがあるファイルです。

ファイル名が特定できないファイル（UPDタイプのログファイルの監視を除く）

プロセスIDなど，ファイル名にその時々に応じて値が変わるものを含んでいるファイルです。

ネットワークファイル

他コンピュータのファイルを，ファイル共有などでアクセスした場合，ネットワークの障害や遅延の際に動作を保証できません。

1行だけ出力されるログファイル

ログファイルに常に1行しかログが存在しないファイルです。

排他されるファイル

ログファイルトラップは，ログファイルを読み込みモードで開きます。読み込みモードでログファイルへアクセスできない場合は監視できません。また，Windowsでログの出力プログラムが排他をかけてからログを出力する場合は排他に失敗し，ログが出力されないことがあります。

JP1/Baseがサポートしていない言語で出力されるファイル

JP1/BaseがWindowsでサポートしている言語はMS932，Unicode（UTF-8，UTF-16），およびCです。JP1/BaseがUNIXでサポートしている言語については，「3.4.2　使用する言語種別を設定する（UNIXの場合）」を参照してください。

シーケンシャルファイル（SEQ3）を監視する場合

ログ出力側で次に示す条件を満たしていないと，ログを正しく監視できないおそれがあります。

ログ出力側でログが出力された直後は，一定時間（監視間隔時間に1秒以上足した時間）経過したあとに，ログファイルが削除されること。

ログが出力された直後にログファイルが削除された場合，図2-22に示すように，削除前に蓄積されていたログを読み込めないおそれがあります。

ログ出力側でログ切り替え（ファイル削除および再作成）をする場合，ファイル削除または再作成のエラー発生時にリトライ処理をしていること。

Windowsでは，ログファイルトラップがログファイルを読み込んでいる（ファイルの状態がOPEN）ときは，ログ出力側によるログ切り替えに失敗することがあります。

ログファイルトラップは，監視間隔中はログファイルの状態をCLOSEにしているため，ログ出力側は一度ログ切り替えに失敗しても，リトライ処理をすることでログ切り替えができるようになります。したがって，ログ出力側でログ切り替えの際にリトライ処理が組み込まれていないと，ログ出力に失敗するおそれがあります。

図2‒21　シーケンシャルファイル（SEQ3）でログ出力を監視できないケース

2.4.6　監視できるログファイル数

WindowsおよびUNIXで監視できるログファイル数の目安を次に示します。

Windowsの場合

監視できるログファイル数の最大値は次の式に従います。

（凡例）

a：監視するログファイルの総数（同一ファイルでも加算する）

b：JP1/AJSのログファイル監視ジョブで監視するログファイルの総数（同一ファイルでも加算する）

m：jevlogstartコマンドの実行数

n：JP1/AJSのログファイル監視ジョブの実行数

UNIXの場合

一つのログファイルトラップで監視できる監視ファイルの最大数は100ですが，UNIXのシステム上で監視できる監視ファイルの最大数は，カーネルパラメーターの設定（ファイルオープン数の設定）次第となります。

2.4.7　ログファイルの監視失敗時のリトライ

ログファイルの更新元プログラムがログファイルを更新するタイミングと，ログファイルトラップがログファイルを監視するタイミングが競合すると，ログファイルの更新元プログラムによってログファイルに排他が掛けられ，ログファイルのオープンや読み込みに失敗する場合があります。このように，一時的に監視に失敗した場合に，監視をリトライします。

なお，一つのログファイルトラップで複数のログファイルを監視する場合，一つのログファイルの監視に失敗すると，そのログファイルに対してはリトライを行い，ほかのログファイルの監視は続行します。

リトライによって監視を回復できなかった場合は，該当のログファイルの監視を停止します。エラーメッセージで示されるログファイルに異常がないかどうかを確認してください。監視に失敗したログファイルを再度監視したい場合は，jevlogstartコマンドでログファイルトラップを新たに起動してください。

監視の開始時にログファイルをオープンできなかった場合と，監視中にログファイルの読み込みに失敗した場合のリトライの動作について次に説明します。

(1)　監視開始時にログファイルのオープンに失敗した場合

jevlogstartコマンドでログファイルトラップを起動するとき，監視対象のログファイルをオープンします。このとき，ログファイルの更新元プログラムなどによって排他が掛けられていると，ログファイルをオープンできないため監視を開始できません。このような場合，ログファイルのオープンをリトライします。リトライ間隔およびリトライ回数は，ログファイルトラップ動作定義ファイルで設定できます。ログファイルトラップ動作定義ファイルでリトライ間隔およびリトライ回数を省略したときは，1秒後に1回リトライします。

リトライによってログファイルのオープンに成功した場合は，オープンに成功した時点から監視が開始されます。

指定した回数リトライしてもログファイルをオープンできなかった場合，またはリトライ開始から3,600秒経過してもオープンできなかった場合は，エラーメッセージおよびJP1イベント（00003A20）で通知します。JP1イベントの詳細については，「17.3.1(14)　イベントID：00003A20の詳細」を参照してください。

監視開始時に，一時的にログファイルのオープンに失敗した場合のリトライの例を次の図に示します。図の例では，リトライ間隔が1秒，リトライ回数が3回の場合の動作を示します。

図2‒22　監視開始時にログファイルのオープンに失敗した場合のリトライの例

(2)　監視中にログファイルの読み込みに失敗した場合

ログファイルの監視中にログファイルの読み込みに失敗した場合は，10ミリ秒間隔で5回リトライします。5回リトライしても回復しなかった場合は，次の監視のタイミングまで待機します。次の監視タイミングでも読み込みに失敗すると，再度10ミリ秒間隔で5回リトライします。リトライ間隔とリトライ回数は固定です。

10ミリ秒間隔で5回のリトライを1セットとしてカウントし，このセットのリトライを繰り返します。何セットまでリトライを繰り返すかは，リトライを継続する回数のしきい値としてログファイルトラップ動作定義ファイルで設定できます。ログファイルトラップ動作定義ファイルでリトライを継続する回数のしきい値を省略した場合は，100セットまでリトライを繰り返します。

指定した回数リトライが行われても回復しない場合は，該当のログファイルの監視が停止し，JP1イベント（00003A21）で通知します。JP1イベントの詳細については，「17.3.1(15)　イベントID：00003A21の詳細」を参照してください。

監視中にログファイルの読み込みに失敗した場合のリトライの例を次の図に示します。図の例では，リトライを継続する回数のしきい値を3回に設定した場合の動作を示します。

図2‒23　ログファイルの読み込みに失敗した場合のリトライの例

2.4.8　イベントサービスへの接続失敗時のリトライ（ログファイルトラップの場合）

ログファイルトラップがイベントサービスに接続できなかった場合，接続をリトライするかどうかは，ログファイルトラップ動作定義ファイルの設定によります。接続をリトライしたい場合は，ログファイルトラップ動作定義ファイルに，ログファイルトラップごとに設定します。指定した回数リトライが行われてもイベントサービスに接続できなかった場合，ログファイルトラップは起動に失敗，または停止します。ログファイルトラップ動作定義ファイルでログファイルトラップごとの接続のリトライ回数を省略したときは，10秒間隔で3回のリトライを行います。

リトライ中に変換されたJP1イベントは，指定した件数まで保留されます。指定した件数を超過してJP1イベントが発生すると，超過したJP1イベントは消去されます。

イベントサービスへの接続に成功すると，保留された順番にJP1イベントをイベントサービスに送信します。また，イベントサービスに接続できたことをJP1イベントで通知します。JP1イベントの詳細については，「17.3.1(13)　イベントID：00003A10の詳細」を参照してください。

2.4.9　Windowsのイベントログを変換する

WindowsのイベントログをJP1イベントに変換してイベントDBに登録する流れを次の図に示します。

図2‒24　Windowsのイベントログの変換から登録までの流れ

イベントログトラップを使用するには，イベントログトラップ動作定義ファイル（ntevent.conf）を作成し，JP1イベントに変換したいログデータの条件を指定します。イベントサービス，イベントログトラップサービスの順番でサービスが起動すると，イベントログトラップが生成され，イベントログを監視します。監視条件に一致するイベントログがあると，JP1イベントに変換してイベントDBに登録します。

イベントログトラップによるJP1イベント変換時に，監視条件ごとにイベントIDと監視名を指定できます。イベントIDや監視名を指定することで，どの監視条件に一致して変換されたJP1イベントなのか判別できます。

変換されたJP1イベントの重大度は，変換前のイベントログの種類に対応しています。

イベントサービスは，システムの起動時に自動的に起動するように初期設定されていますが，イベントログトラップサービスは自動で起動しません。イベントログトラップサービスを自動起動および自動終了したい場合は，起動管理を使用して，イベントサービスが起動したあとにイベントログトラップサービスが起動するように設定してください。

イベントログトラップでは，JP1イベントとして登録できるメッセージは1,023バイトまでです。JP1イベントに変換するメッセージが1,023バイトを超えた場合，1,023バイト以降のメッセージを切り捨てます。JP1イベントの属性については，「17.3.1(26)　イベントID：00003A71またはイベントログトラップ動作定義ファイルのフィルターで指定されたイベントIDの詳細」を参照してください。

2.4.10　イベントログトラップによる監視の開始と終了

イベントログトラップは，リアルタイムにイベントログを監視します。イベントログトラップサービスを起動した時点から終了する時点までに発生したイベントログのうち，監視条件と一致するイベントログを即時にJP1イベントに変換します。

2.4.11　イベントサービスへの接続失敗時のリトライ（イベントログトラップの場合）

イベントログトラップの起動時およびイベントログをトラップした際にイベントサービスに接続できなかった場合は，あらかじめイベントログトラップ動作定義ファイル（ntevent.conf）で設定しておくことで接続をリトライできます。

2.5　大量発生イベントの転送を抑止する

JP1/IMを使用した統合管理システムで，監視対象のエージェントでJP1イベントが大量に発生した場合，エージェントからマネージャー（JP1/IM - Manager）へのイベント転送を抑止できます。大量発生イベントの転送を抑止することで，マネージャーへの負荷を軽減できます。

2.5.1　大量発生イベントとは

大量発生イベントとは，短期間にユーザーの想定を超えて大量に発生するJP1イベントのことです。エージェントホストで障害が発生したり，ログファイルトラップで監視中のログが大量に出力されたりすると，JP1イベントが大量に発生することがあります。

2.5.2　大量発生イベントへの対策

JP1/IMを使用した統合管理システムで，監視対象のエージェントでJP1イベントが大量に発生すると，マネージャーへ大量のJP1イベントが転送されて，マネージャーに負荷が掛かるおそれがあります。その対策として，大量発生イベントの転送をマネージャーから抑止する方法としきい値を設定して大量発生イベントの転送を自動的に抑止する方法があります。

大量発生イベントの転送をマネージャーから抑止する

イベント転送抑止コマンド（jevagtfwコマンド）を使用して，特定のエージェントからのイベント転送を抑止します。

しきい値を設定して大量発生イベントの転送を自動的に抑止する

大量発生イベントを検知するためのしきい値を設定して，イベント転送を自動的に抑止します。

メモ

ログファイルトラップがJP1イベントを大量に発行している場合，該当のログファイルトラップをマネージャーから停止できます。マネージャーからエージェントのログファイルトラップを個別に停止する方法としては，IM構成管理を使用する方法があります。IM構成管理を使用すると，IM構成管理・ビューアーの［プロファイル表示/編集］画面から，抑止対象のログファイルトラップのプロセスを停止できます。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

2.5.3　JP1イベントが大量発生しているエージェントからのイベント転送をマネージャーから抑止する

JP1イベントが大量発生しているエージェントからのイベント転送をマネージャーから抑止できます。エージェントのイベント転送をマネージャーから抑止するには，マネージャー上のJP1/Baseのイベント転送抑止コマンド（jevagtfwコマンド）を使用します。なお，jevagtfwコマンドの詳細については，「15.　コマンド」の「jevagtfw」を参照してください。

イベント転送抑止コマンド（jevagtfwコマンド）の主な機能を次に示します。

イベント転送抑止の設定

イベント転送抑止

抑止対象のエージェントのイベント転送設定を，転送を抑止する設定に変更します。

受信イベント破棄

抑止対象のエージェントから転送されてくるJP1イベントを，マネージャーのイベントDBに格納しないで破棄します。

イベント転送抑止の解除

イベント転送抑止中のエージェントのイベント転送設定を，転送抑止前の設定に戻します。

イベント転送抑止状態の確認

イベント転送抑止中の各エージェントの抑止状態を出力します。

これらの機能によって，エージェントからのイベント転送をマネージャーから制御できるため，大量発生イベントに対して迅速に対処できるようになります。

この機能を使用するには，マネージャーホスト（JP1/IM - Managerインストールホスト）のJP1/Baseのバージョンが，10-50以降である必要があります。また，抑止対象となるエージェントホストのJP1/Baseのバージョンは，08-00以降である必要があります。

この機能でイベント転送を抑止できるエージェントの上限数は，10,000台です。なお，構成定義の管理対象でないエージェントのイベント転送も抑止できます。

(1)　抑止対象となるJP1イベントについて（jevagtfwコマンドによるイベント転送抑止の場合）

jevagtfwコマンドによるイベント転送抑止で，抑止対象となるJP1イベントは，転送設定ファイル（forward）の設定に従って転送されるJP1イベントです。

次に示すJP1イベントは，抑止対象になりません。

あて先指定転送イベント

あて先指定転送イベントに該当するJP1イベントを次に示します。

jevsendコマンドまたはjevsenddコマンドで送信先イベントサーバを指定して転送するJP1イベント。

JP1/AJSのイベント送信ジョブなど，イベントサービスと連携するプログラムが，転送設定ファイル（forward）を使用しないで，特定のホストへ転送するJP1イベント。

自動転送イベント

転送設定ファイル（forward）に指定された転送設定ブロックの抽出条件に一致しなくても転送されるイベントです。

自動転送イベントに該当するJP1イベントを次に示します。

JP1/Baseの起動通知イベント（00004724）

JP1/Baseの停止通知イベント（00004725）

しきい値による抑止通知イベント（00003D0B）

しきい値による抑止解除通知イベント（00003D0C）

しきい値による抑止全解除通知イベント（00003D0D）

しきい値による抑止継続通知イベント（00003D0E）

なお，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定した場合は，自動転送イベントも通常のイベントと同様に抑止対象になります。

(2)　イベント転送抑止を設定する

jevagtfwコマンドの-sオプションを使用して，抑止対象のエージェントのイベント転送設定を，転送を抑止する設定にします。また，抑止対象のエージェントから転送されてくるJP1イベントを，マネージャーのイベントDBに格納しないで破棄する設定にします。

jevagtfwコマンドによるイベント転送抑止の設定の流れを次の図に示します。

図2‒25　jevagtfwコマンドによるイベント転送抑止の設定の流れ

jevagtfwコマンドを-sオプションを指定して実行する。

抑止対象となるエージェントからの受信イベントを破棄する。

エージェントの転送設定ファイル（forward）の情報をバックアップする。

イベント転送抑止用の転送設定ファイル（forward_suppressファイルまたは任意の転送抑止定義ファイル）をエージェントへ送信して，転送設定ファイル（forward）を更新する。※1

更新された転送設定ファイル（forward）をリロードして適用する。※2

転送設定ファイル（forward）に従って，イベント転送を抑止する。

注※1　通信エラーによってイベント転送抑止用の転送設定ファイル（forward_suppressファイルまたは任意の転送抑止定義ファイル）の送信に失敗した場合，イベント転送抑止の処理を中止します。エージェントの転送設定ファイル（forward）は，コマンド実行前の状態と変わりません。

注※2　更新された転送設定ファイル（forward）の適用に失敗した場合，バックアップした転送設定ファイル（forward_backup）をエージェントへ送信して適用（リストア）します。なお，そのリストアに失敗した際は，次のメッセージを出力します。

KAJP1434-E ホスト名へのforwardファイルのリストアに失敗しました (file=ファイル名)

イベント転送抑止

エージェントのイベント転送抑止を設定します。図2-26の3〜6に該当します。

受信イベント破棄

イベント転送抑止中のエージェントから転送されたJP1イベントを，マネージャーのイベントDBに登録しないで破棄します。図2-26の2に該当します。

破棄の対象となるJP1イベント

破棄の対象となるJP1イベントは，転送設定ファイル（forward）の設定に従って転送されるJP1イベントです。あて先指定転送イベントおよび自動転送イベントは，破棄の対象ではありません。あて先指定転送イベントおよび自動転送イベントの詳細については，「(1)　抑止対象となるJP1イベントについて（jevagtfwコマンドによるイベント転送抑止の場合）」を参照してください。

エージェントからサブマネージャーを経由してマネージャーにJP1イベントを転送する場合でも，抑止対象のエージェントが発行したJP1イベントであれば，破棄の対象になります。

特定のJP1イベントを破棄の対象から除外したい場合

破棄の対象から除外したいJP1イベントがある場合は，イベントサーバ設定ファイル（conf）のundisposedidsパラメーターを定義することで，特定のJP1イベントを破棄の対象から除外できます。

なお，受信イベントを破棄した場合でも，送信元のイベントサーバでは転送に成功したものとして処理します。

(3)　イベント転送抑止を解除する

jevagtfwコマンドの-rオプションを使用して，エージェントのイベント転送抑止を解除します。jevagtfwコマンドによるイベント転送抑止の解除の流れを次の図に示します。

図2‒26　jevagtfwコマンドによるイベント転送抑止の解除の流れ

jevagtfwコマンドを-rオプションを指定して実行する。

受信イベントの破棄を解除する。

エージェントの転送設定ファイル（forward）と抑止時に送信したイベント転送抑止用の転送設定ファイル（forward_suppressまたは任意の転送抑止定義ファイル）の内容を比較する。

比較した結果，差分が生じた場合はイベント転送抑止の解除処理を中止します。

抑止時にバックアップした転送設定ファイル（forward_backup）をエージェントへ送信して，転送設定ファイル（forward）を更新する。

更新された転送設定ファイル（forward）をリロードして適用する。

転送設定ファイル（forward）に従って，イベント転送を再開する。

イベント転送抑止中に転送設定ファイル（forward）の設定を変更した場合

イベント転送抑止を解除する際に，転送設定ファイル（forward）の設定が変更されているかどうかチェックします。転送設定ファイル（forward）の設定が変更されていた場合，次に示すエラーメッセージを出力して，イベント転送抑止の解除処理を中止します。

KAJP1415-E ホスト名の転送抑止用のforwardファイルの内容が抑止時と異なります
KAJP1432-E ホスト名のイベント転送抑止の解除に失敗しました

この場合，次に示すどちらかの対処が必要になります。

イベント転送抑止を強制的に解除する（jevagtfwコマンドに-rおよび-fオプションを指定して実行する）。

転送設定ファイル（forward）の設定をイベント転送抑止前の設定に戻しても問題ない場合，強制的に解除してください。

マネージャーだけイベント転送抑止を解除する（jevagtfwコマンドに-rおよび-mオプションを指定して実行する）。

イベント転送抑止中に変更した転送設定ファイル（forward）の設定を継続したい場合は，マネージャーだけイベント転送抑止を解除します。エージェントの転送設定ファイル（forward）は，イベント転送抑止前の設定に戻りません。この場合は，マネージャーが保持している抑止時にバックアップした転送設定ファイル（forward_backup）の設定内容と比較して，必要な定義が漏れていないかどうか確認してください。

(4)　イベント転送抑止状態を確認する

jevagtfwコマンドの-lオプションを使用して，イベント転送抑止中の各エージェントの抑止状態を確認できます。確認できる情報を次に示します。

イベント転送抑止中のエージェントホスト名。

イベント転送抑止の開始時刻。

受信イベント破棄の状態（受信イベントを破棄する設定かどうか）。

イベント転送抑止の状態（イベント転送を抑止する設定かどうか）。

(5)　イベント転送抑止の継続を通知する

jevagtfwコマンドによるイベント転送抑止によって，イベント転送が抑止されていることを通知するJP1イベントを発行できます。イベント転送抑止の状態が一定期間継続すると次に示すメッセージとJP1イベント（00003D05）を発行します。

KAJP1087-W jevagtfwコマンドによるイベント転送抑止が累計抑止時間秒間継続しています (server=ホスト名)

通知の有無および通知間隔は，イベントサーバ設定ファイル（conf）で設定します。詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

システムの日時変更による影響

システムの日時を変更した場合，イベント転送抑止の継続通知の動作に次に示す影響があります。

システムの日時を進めた場合，本来の間隔よりも短い間隔でイベント転送抑止の継続通知が発生します。

システムの日時を戻した場合，イベント転送抑止の継続通知が遅延します。

(6)　jevagtfwコマンドによるイベント転送抑止で使用するファイルおよびディレクトリ

jevagtfwコマンドによるイベント転送抑止では，イベント転送抑止用の転送設定ファイル（forward_suppres）やエージェントごとの抑止情報をマネージャーで管理します。jevagtfwコマンドによるイベント転送抑止で使用するファイルおよびディレクトリについて説明します。

格納場所

jevagtfwコマンドによるイベント転送抑止で使用するファイルおよびディレクトリは，イベントサーバ設定ファイル（conf）や転送設定ファイル（forward）と同様に，イベントサーバインデックスファイル（index）で指定したディレクトリの配下に格納されます。初期設定の格納場所を次に示します。

Windowsの場合

インストール先フォルダ¥conf¥event¥servers¥default

UNIXの場合

/etc/opt/jp1base/conf/event/servers/default

ファイルおよびディレクトリ構成

jevagtfwコマンドによるイベント転送抑止で使用するファイルおよびディレクトリの構成を，次の図に示します。

図2‒27　jevagtfwコマンドによるイベント転送抑止で使用するファイルおよびディレクトリの構成

ファイルおよびディレクトリの説明

jevagtfwコマンドによるイベント転送抑止で使用するファイルおよびディレクトリの一覧を次の表に示します。

表2‒4　jevagtfwコマンドによるイベント転送抑止で使用するファイルおよびディレクトリの一覧

ファイルまたはディレクトリ

説明

/suppress/forward_suppress

イベント転送抑止用の転送設定ファイルです。

イベント転送抑止時に，エージェントへ送信します。初期設定では，次の内容（コメント）が設定されています。

# The manager has suppressed forwarding of events by this agent.
# Check with the administrator of the manager before editing this file.

記述形式は，転送設定ファイル（forward）と同じです。転送設定ファイル（forward）の記述形式については，「16.　定義ファイル」の「転送設定ファイル」を参照してください。

/suppress/forward_suppress.model

イベント転送抑止用の転送設定ファイル（forward_suppress）のモデルファイルです。

/suppress/転送抑止定義ファイル名

ユーザーが任意に設定する転送抑止定義ファイルです。

エージェントごとに異なる転送抑止設定をしたい場合，任意のファイル名の転送抑止定義ファイルを用意して，jevagtfwコマンドの-sオプションでファイル名を指定します。

/suppress/statdb.bin

抑止状態を管理するバイナリファイルです。

/suppress/エージェントのホスト名

エージェントホストごとの抑止情報を格納するディレクトリです。

このディレクトリは，jevagtfwコマンドでイベント転送の抑止が成功したときに作成されます。ユーザーが削除しないかぎり保持されます。

/suppress/エージェントのホスト名/forward_suppress

イベント転送抑止時にエージェントに送信したイベント転送抑止用の転送設定ファイルの設定情報です。

イベント転送抑止の解除時に，このファイルの内容とエージェントの転送設定ファイルの内容を比較します。

/suppress/エージェントのホスト名/forward_backup

イベント転送抑止時にエージェントから取得した転送設定ファイルのバックアップ情報です。

イベント転送抑止の解除時に，このファイルの内容をエージェントの転送設定ファイルに再設定します。※

/suppress/エージェントのホスト名/log

イベント転送の抑止および抑止解除を記録するログファイルです。logファイルが64KBを超えた場合，ファイル名をlog.oldに変更して，新規にlogファイルを作成します。

/suppress/エージェントのホスト名/log.old

注※　イベント転送抑止時に，エージェントの転送設定ファイルに1行当たり1,023バイトを超える定義（無効な定義）があった場合，1,024バイト以降の情報は削除されてバックアップされます。イベント転送抑止の解除時には，1行当たり1,024バイト以降の情報が削除された転送設定が再設定されます。そのため，1行当たり1,023バイトを超えて無効だった定義が，1,023バイト以内になることで有効な定義になるおそれがあります。

機種依存文字の使用について

次に示すファイルには機種依存文字を使用しないでください。コメント行も同様です。

suppress/forward_suppress

suppress/任意ファイル名

これらのファイルは，イベント転送抑止時にエージェントへ送信されます。その際に機種依存文字を使用していると，文字化けや文字の欠落が発生するおそれがあります。文字化けや文字の欠落が発生した場合，イベント転送抑止の解除時にエラー（KAJP1415-E）で，イベント転送抑止の解除に失敗します。

KAJP1415-E ホスト名の転送抑止用のforwardファイルの内容が抑止時と異なります

2.5.4　しきい値を設定して大量発生イベントの転送を自動的に抑止する

大量発生イベントを検知するためのしきい値を設定しておくことで，イベント転送を自動的に抑止できます。また，しきい値を下回る状態が続いた場合は，大量発生イベントが収束したと判定して自動的にイベント転送の抑止を解除できます。この大量発生イベントを検知するためのしきい値に該当する条件をイベント転送抑止条件といいます。

イベント転送抑止条件は，抑止対象となるエージェントの転送設定ファイル（forward）の転送抑止設定ブロック（suppress〜end-suppress）で設定します。例えば，5秒間で50件以上のJP1イベントが3回連続で発生した場合に，イベント転送を抑止するような条件を設定します。

イベント転送抑止条件に，想定する大量発生イベントを設定することで，エージェントからの大量発生イベントの転送を未然に防げます。

図2‒28　しきい値によるイベント転送抑止の概要

なお，この機能を使用するには，抑止対象となるエージェントホストのJP1/Baseのバージョンが，10-50以降である必要があります。

(1)　抑止対象となるJP1イベントについて（しきい値によるイベント転送抑止の場合）

しきい値によるイベント転送抑止で抑止対象となるJP1イベントは，転送設定ファイル（forward）の設定に従って転送されるJP1イベントです。転送設定ファイル（forward）の転送設定（to）で抽出したJP1イベントのうち，イベント転送抑止条件のあて先およびイベントフィルターに該当するJP1イベントの件数をチェックします。該当するJP1イベントの件数がしきい値を超えた場合，転送設定ファイル（forward）によるイベント転送が抑止されます。

なお，あて先指定イベントおよび自動転送イベントは抑止対象ではありません。あて先指定転送イベントおよび自動転送イベントの詳細については，「2.5.3(1)　抑止対象となるJP1イベントについて（jevagtfwコマンドによるイベント転送抑止の場合）」を参照してください。

(2)　イベント転送抑止条件を複数設定した場合のイベント転送について

イベント転送抑止条件は，転送設定ファイル（forward）に複数設定できます。イベント転送抑止条件を複数設定した場合，抑止条件ごとに該当するJP1イベントの件数をチェックします。転送されるJP1イベントは，すべての抑止条件で抑止対象外と判定されたJP1イベントになります。

イベント転送抑止条件を複数設定した場合のJP1イベントの転送について，次の図に示します。

図2‒29　イベント転送抑止条件を複数設定した場合のJP1イベントの転送

(3)　大量発生イベントの検知と収束

イベント転送抑止条件には，大量発生イベントを定義するために，JP1イベントの発生状況を表す設定項目として，単位時間，しきい値，確認回数があります。ここでは，単位時間，しきい値，確認回数を基に大量発生イベントの検知と収束について説明します。

各設定項目の説明を次の表に示します。

表2‒5　大量発生イベントを定義するためのJP1イベントの発生状況を表す設定項目

設定項目

説明

単位時間

しきい値を判定する期間です。単位時間の起点は最初にイベント転送抑止条件のJP1イベントを検知した時点およびイベント転送の抑止が解除された時点となります。

しきい値

単位時間当たりのJP1イベントの件数です。

確認回数

大量発生イベントの発生と収束を判定する単位時間の回数です。イベント転送を抑止する場合と抑止を解除する場合で異なる回数を指定できます。

大量発生イベントの検知

単位時間当たりのJP1イベントの件数が，確認回数で指定した回数分連続してしきい値以上になった場合，大量発生イベントを検知したと判定して，イベント転送を抑止します。

例えば，単位時間が5秒，しきい値が50件，確認回数が3回と設定した場合，JP1イベントの発生件数が5秒間で50件以上の状態が，3回連続した時点からイベント転送の抑止が開始されます。

大量発生イベントを検知したと判定して，イベント転送を抑止するタイミングを，JP1イベントの発生状況と合わせて次の図に示します。

図2‒30　イベント転送を抑止するタイミング

この図で示したように，確認回数を3回に指定した場合は，3回目の単位時間内で，最初にしきい値に指定した件数を超えた時点から転送抑止が開始されます。

大量発生イベントの収束

イベント転送を抑止している状態で，イベント転送抑止条件の単位時間当たりのJP1イベントの件数が，確認回数で指定した回数分連続してしきい値未満になった場合，大量発生イベントが収束したと判定して，イベント転送の抑止を解除します。

例えば，単位時間が5秒，しきい値が50件，確認回数が3回と設定した場合，JP1イベントの発生件数が5秒間で50件未満の状態が，3回連続した時点からイベント転送の抑止が解除されます。

大量発生イベントが収束したと判定して，イベント転送の抑止を解除するタイミングを，JP1イベントの発生状況と合わせて次の図に示します。

図2‒31　イベント転送の抑止を解除するタイミング

(4)　転送状態の遷移について

しきい値によるイベント転送抑止には，イベント転送抑止条件ごとに転送状態（抑止解除または抑止）があります。転送状態は，いくつかの要因で状態が遷移します。

転送状態の遷移と要因の関係を，次に図に示します。

図2‒32　転送状態の遷移と要因

転送状態

抑止解除

イベント転送を抑止しない状態です。

抑止

イベント転送を抑止する状態です。

要因

起動

イベントサービスを起動（jevstartコマンドを実行）する。

大量発生イベントの検知

イベント転送抑止条件の単位時間当たりのJP1イベントの件数が，確認回数で指定した回数分連続してしきい値以上になる。

大量発生イベントの収束

イベント転送抑止条件の単位時間当たりのJP1イベントの件数が，確認回数で指定した回数分連続してしきい値未満になる。

リロード

転送設定ファイル（forward）をリロード（jevreloadコマンドを実行）する。

停止

イベントサービスを停止（jevstopコマンドを実行）する。

転送状態が遷移したときに，メッセージおよびJP1イベントを出力します。転送状態が遷移したときに出力するメッセージおよびJP1イベントを次の表に示します。

表2‒6　転送状態が遷移したときのメッセージおよびJP1イベント

項番

要因

転送状態

メッセージ

JP1イベント

遷移元

遷移先

1

起動

−

抑止解除

−

−

2

大量発生イベントの検知

抑止解除

抑止

KAJP1083-W ホスト名はしきい値によるイベント転送抑止を開始します (抑止条件=識別子)

00003D0B

3

大量発生イベントの収束

抑止

抑止解除

KAJP1084-I ホスト名はしきい値によるイベント転送抑止を解除しました (抑止条件=識別子)

00003D0C

4

リロード

KAJP1085-I ホスト名はしきい値によるイベント転送抑止をすべて解除しました

00003D0D

5

停止

−

−

（凡例）

−：該当なし。

(5)　転送抑止状態を確認する

イベント転送抑止条件ごとに，JP1イベントの転送抑止状態を確認できます。転送抑止状態を確認するには，jevfwstatコマンドを使用します。詳細については，「15.　コマンド」の「jevfwstat」を参照してください。

(6)　抑止状態の継続を通知する

しきい値によるイベント転送抑止によって，イベント転送が抑止されていることを，定期的にマネージャーへ通知できます。イベント転送抑止の状態が一定期間継続すると次に示すメッセージとJP1イベント（00003D0E）を発行します。

KAJP1086-W ホスト名のイベント転送抑止が累計抑止時間秒間継続しています (抑止条件=識別子)

通知の有無および通知間隔は，イベントサーバ設定ファイル（conf）で設定します。詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

(7)　しきい値によるイベント転送抑止の注意事項

しきい値によるイベント転送抑止を設定したエージェントのイベントサーバが稼働しているときに，マシンのシステムの日時を変更した場合，転送状態が不正に遷移したり，抑止状態の継続通知が不正に通知されたりするおそれがあります。

システムの日時を変更した場合の影響を次に示します。

システムの日時を進めた場合の影響

大量発生イベントが収束していなくても収束したものと誤って判定し，イベント転送抑止を解除するおそれがあります。

抑止状態が一定時間継続していなくても抑止状態の継続が通知されるおそれがあります。

システムの日時を戻した場合の影響

大量発生イベントが発生していなくても発生したものと誤って判定し，イベント転送を抑止するおそれがあります。

抑止状態が一定時間継続しても抑止状態の継続が通知されないおそれがあります。

2.6　定義情報を収集・配布する（JP1/IM限定）

JP1/BaseおよびJP1/IMで構成されたシステムでは，定義情報を管理できます。サービスの稼働情報を確認し，イベントサービスの定義情報の収集および配布ができます。

2.6.1　IM構成管理による定義情報の管理

IM構成管理を使用している場合は，IM構成管理・ビューアーを操作して，JP1/Baseの定義情報を管理できるようになります。IM構成管理は，JP1/IM - Manager 09-00でサポートされた機能です。

IM構成管理・ビューアーでできることを，次に示します。

JP1/Baseの定義ファイルの内容や，現在有効になっている定義情報（各サービスの起動時に使用した定義ファイルの内容）を収集し，内容を確認する

JP1/Baseの定義ファイルを編集して，各ホストのJP1/Baseに配布する

JP1/IMの構成定義ファイルに定義されたホスト以外のJP1/Baseを管理する場合は，JP1/Baseのホストアクセス制限定義ファイルに，アクセスを許可するマネージャーホストを定義しておきます。定義ファイルの詳細については，「16.　定義ファイル」の「ホストアクセス制限定義ファイル」を参照してください。

IM構成管理による定義情報の管理については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

2.6.2　IM構成管理によるサービスの稼働情報の確認

IM構成管理を使用している場合は，IM構成管理・ビューアーを操作して，JP1/Baseのサービスの稼働情報を確認できるようになります。

IM構成管理によるサービスの稼働情報の確認については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

IM構成管理を使用していない場合は，JP1/Baseのjbsgetopinfoコマンドによって，自ホストのサービスの稼働情報を確認することもできます。

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

2.6.3　コマンドによるシステム階層構成の管理

JP1/BaseおよびJP1/IMで構成されたシステムの階層構成を管理する方法には，IM構成管理を使用する方法とJP1/Baseが提供する構成管理機能（構成定義に関するコマンド）を使用する方法があります。ここでは，JP1/Baseが提供する構成管理機能を使用する場合のシステム階層構成の管理について説明します。

JP1/Baseが提供する構成管理機能では，システムの階層構成を定義した構成定義情報を，構成定義に関するコマンドを使用してマネージャーとエージェントに設定します。

構成定義に関するコマンドには次に示すコマンドがあります。

jbsrt_distrib（構成定義情報の下位ホストへの配布）

jbsrt_sync（下位ホストからの構成定義情報の収集および更新）

jbsrt_del（構成定義情報の削除）

jbsrt_get（構成定義情報の表示）

これらのコマンドを使用して，構成定義情報をマネージャーからエージェントへ配布したり，エージェントから構成定義情報を収集してマネージャーの構成定義情報を更新したりします。

コマンドの詳細については，「15.　コマンド」の「jbsrt_distrib」，「jbsrt_sync」，「jbsrt_del」，および「jbsrt_get」を参照してください。

構成定義情報を設定する際は，マネージャーでJP1/IMの構成定義ファイル（jbs_route.conf）に階層構成を定義した上で，jbsrt_distribコマンドを実行して下位ホストに定義情報を配布します。構成定義情報の設定の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」のIM構成管理を使用しない場合のシステムの階層構成の設定について説明している個所を参照してください。

(1)　構成定義情報の配布

管理対象のホストが追加されたり，削除されたりした場合，エージェントの構成定義情報を更新（jbsrt_distribコマンドを実行して新しい構成定義情報を配布）する必要があります。構成定義情報の配布には，次に示す二つの配布方式があります。

一括配布方式

構成定義上のすべてのホストに構成定義情報の削除または配布を実施します。

差分配布方式

構成定義上で変更が生じたホストだけに構成定義情報の削除または配布を実施します。JP1/Base 11-10から追加された方式です。

ここでは，差分配布方式について説明します。

(2)　差分配布方式を使用する場合の前提条件

差分配布方式を使用する場合は，マネージャーホストおよびサブマネージャーホストに次に示す条件があります。

JP1/IM - Managerのバージョンが11-00以降である。

JP1/Baseのバージョンが11-10以降である。

(3)　配布方式の選択

jbsrt_distribコマンド実行時にどちらの配布方式で動作するかは，共通定義情報（JBSRT_DISTRIB_VERSION）で指定します。

JBSRT_DISTRIB_VERSIONの設定値が1の場合

差分配布方式

JBSRT_DISTRIB_VERSIONの設定値が0の場合

一括配布方式

また，共通定義情報（JBSRT_DISTRIB_VERSION）の設定に関係なく，jbsrt_distribコマンドのオプションで明示的に配布方式を指定することもできます。

jbsrt_distribコマンドで-Dオプションを指定した場合

差分配布方式

jbsrt_distribコマンドで-Lオプションを指定した場合

一括配布方式

-Dオプションと-Lオプションのどちらのオプションも省略した場合は，共通定義情報（JBSRT_DISTRIB_VERSION）の設定値に従います。

なお，JP1/Baseを新規インストールした場合，JBSRT_DISTRIB_VERSIONは1（差分配布方式）で設定されます。JP1/Base 11-10より前のバージョンから上書きインストールした場合，JBSRT_DISTRIB_VERSIONは未定義（一括配布方式）で設定されます。

共通定義情報（JBSRT_DISTRIB_VERSION）で配布方式を指定する場合の設定方法については，「12.2.1　構成定義情報の配布方式を指定する」を参照してください。

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

(4)　差分配布方式を使用して運用する場合の注意事項

次に示すようなケースで個別にエージェントやサブマネージャーの構成定義情報を削除した場合，マネージャーからは削除したホストを差分として抽出できないため，一括配布方式で配布を実施してください。

jbsrt_distribコマンドではなく，jbsrt_delコマンドで構成定義情報を直接削除した。

マシン自体をリプレースした。

(5)　通信タイムアウト時間の見直し

3階層以上のシステム階層構成で運用する場合，サブマネージャー以下の構成定義の配布や同期に時間が掛かり統合マネージャーに一定時間応答が返らないことで，構成管理機能のコマンド（jbsrt_distrib，jbsrt_sync）やIM構成管理を使用したシステム階層構成の反映や同期がタイムアウトする場合があります。

タイムアウトは主に，サブマネージャー以下のエージェントの台数が多い場合や，サブマネージャーとエージェントの間のネットワーク回線が低速である場合などに発生します。

下位ホストに異常がないにも関わらずタイムアウトが発生する場合には，上記のケースが要因と考えられるため，統合マネージャーの通信タイムアウト時間を長く調整してください。通信タイムアウト時間の設定方法については，「16.　定義ファイル」の「共通定義設定用ファイル（構成管理機能）」を参照してください。

なお，システム階層構成内のマネージャーホスト上で構成定義の配布や同期の処理に掛かった時間は，メッセージKAVB3185-Iで確認できます。設定値を調整する際の目安にしてください。

2.6.4　コマンドによるイベントサービスの定義情報の収集と配布

ここでは，コマンドによるイベントサービスの定義情報の収集と配布について説明します。JP1/IMを使用してシステムの運用監視をする場合，各ホストのJP1/Baseでどの事象をJP1イベントとして管理するか，また，どのJP1イベントを上位ホストに転送するか検討し，定義する必要があります。各ホストのJP1/Baseで定義した情報を一つ一つ確認し，変更する方法もありますが，効率が悪く，定義を誤るおそれがあります。

JP1/Baseでは，各ホストのJP1/Baseで定義した情報をマネージャーホストで一括収集して確認できます。また，マネージャーホストで定義情報を編集し，各ホストのJP1/Baseに配布し，定義情報を更新することもできます。これによって効率良く，イベントサービスに関する定義情報を管理できます。

イベントサービスの定義情報の収集・配布の流れを次の図に示します。

図2‒33　イベントサービスの定義情報の収集・配布の流れ

(1)　イベントサービスの定義情報の収集および配布に必要な条件

JP1/BaseおよびJP1/IM - Managerをインストールする。

システムの各ホストにインストールする必要のある製品と，製品のバージョンを次に示します。

ホスト

必要な製品

定義情報を収集・配布するホスト

JP1/Base（バージョン7以降）

JP1/IM - Central Console（バージョン7）またはJP1/IM - Manager（バージョン8以降）

定義情報の収集先・配布先ホスト

JP1/Base（バージョン7以降）

定義情報を収集および配布するホストのJP1/IM - Managerでシステム構成を定義する。

定義情報を収集および配布する際，JP1/IM - Managerの構成定義を利用します。システム構成で定義した管理対象ホストが，収集先および配布先となります。システム構成の定義については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」を参照してください。

重要

マネージャーホスト上で，管理対象ホストの定義情報を収集および配布する際，サブマネージャーホストを経由しないで管理対象ホストと直接通信します。マネージャーホストとサブマネージャーホストの間にファイアウォールを設置している場合は，ポート番号20306について，マネージャーホストからすべての管理対象ホストに対して通過できるようにファイアウォールを設定し直してください。また，マネージャーホストと管理対象ホスト間で名前解決できるようにしてください。

(2)　収集および配布できる定義情報

次に示す定義ファイルの定義情報を収集および配布できます。

表2‒7　収集および配布できる定義情報（Windowsの場合）

定義ファイル

ファイル名

転送設定ファイル

インストール先フォルダ¥conf¥event¥servers¥default¥forward

共有フォルダ¥jp1base¥event¥forward

ログファイルトラップ動作定義ファイル

インストール先フォルダ¥conf¥任意に指定したファイル

イベントログトラップ動作定義ファイル

インストール先フォルダ¥conf¥event¥ntevent.conf

ログファイルトラップ起動定義ファイル※

インストール先フォルダ¥conf¥event¥jevlog_start.conf

注※　ログファイルトラップ起動定義ファイルを配布収集する場合，収集元，配布元のホスト，および収集先，配布先のホストにインストールされているJP1/Baseのバージョンを09-50以降にする必要があります。

表2‒8　収集および配布できる定義情報（UNIXの場合）

定義ファイル

ファイル名

転送設定ファイル

/etc/opt/jp1base/conf/event/servers/default/forward

共有ディレクトリ/event/forward

ログファイルトラップ動作定義ファイル

/etc/opt/jp1base/conf/任意に指定したファイル

ログファイルトラップ起動定義ファイル※

/etc/opt/jp1base/conf/event/jevlog_start.conf

注※　ログファイルトラップ起動定義ファイルを配布収集する場合，収集元，配布元のホスト，および収集先，配布先のホストにインストールされているJP1/Baseのバージョンを09-50以降にする必要があります。

2.6.5　JP1製品の定義情報の収集

JP1/IM - Managerのセントラルスコープでは，JP1/AJSで定義した業務（ジョブネット）やJP1/SSOで監視する情報など，JP1シリーズ製品が管理する定義情報をツリー形式の監視画面に表示できます。監視画面上の情報は，JP1/IM - Managerで定義したシステム構成に従って自動的に生成されます。自動生成に必要な定義情報は，JP1/Baseの定義収集・配布機能が収集します。

JP1/Baseが収集する定義情報を次に示します。

JP1/AJSで自動実行している業務の情報

JP1/SSOで監視しているカテゴリー情報やアプリケーション情報

JP1/PFMで監視しているパフォーマンス情報

詳細については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」を参照してください。

2.7　プロセスのハングアップや異常終了を検知する

JP1/Baseのプロセスが無限ループやデッドロックの状態となった場合に，異常を検知してメッセージやJP1イベントを発行し，オペレーターにJP1/Baseの回復を促せます。これを，ヘルスチェック機能といいます。

2.7.1　ヘルスチェック機能を利用した障害対策の流れ

ヘルスチェック機能を利用した障害対策の流れを，次の図に示します。

図2‒34　ヘルスチェック機能を利用した障害対策の流れ

ヘルスチェック機能は，初期設定では無効になっています。有効にするには，共通定義情報に登録し，監視対象ホストやプロセスの監視間隔を設定します。設定方法については，「4.2.1　ヘルスチェック機能を有効にする」を参照してください。

プロセス管理機能を起動すると，プロセスの監視が開始されます。

2.7.2　ヘルスチェック機能で検知できる障害

ヘルスチェック機能で検知できる障害を次に示します。

プロセスのハングアップ

プロセスがハングアップした場合に異常を検知して通知します。ハングアップとは，無限ループやデッドロックなどが原因で，プロセスが処理要求を受け付けなくなる状態を指します。

プロセスの異常終了

プロセス自体が異常と判断して終了した場合に，プロセスの異常を検知して通知します。ただし，OSのkillコマンドなどによってプロセスが強制終了した場合は，異常終了として検知できません。この場合は，プロセスの応答がない状態として異常を検知します。

2.7.3　ヘルスチェック機能を利用したプロセス監視の仕組み

ヘルスチェック機能は，プロセス自体が異常と判断して終了した場合と，プロセスがハングアップした場合を異常として検知します。プロセスがハングアップしているかどうかは，各プロセスが行っている処理に掛かる時間と，プロセスごとに設定されているしきい値を比較します。各プロセスが行っている処理に掛かる時間は，共有メモリーを介して監視します。

ヘルスチェック機能の概要を次の図に示します。

図2‒35　ヘルスチェック機能の概要

ヘルスチェック機能では，業務規模などによって影響を受けにくい，プロセスが行う個々の内部処理を監視単位としています。そのため，異常しきい値や警告しきい値には，カスタマイズする必要のない値が設定されています。

2.7.4　ヘルスチェック機能の監視対象プロセス

(1)　ヘルスチェック機能の監視対象のプロセス一覧

ヘルスチェック機能が監視するプロセスを次の表に示します。なお，表中のプロセス名は，Windowsの場合はタスクマネージャ，UNIXの場合はpsコマンドで表示されるプロセス名です。

表2‒9　ヘルスチェック機能の監視対象のプロセス一覧

項番

機能

プロセス名

Windows

UNIX

1

プロセス管理

jbs_spmd.exe

jbs_spmd

2

認証サーバ

jbssessionmgr.exe

jbssessionmgr

3

構成管理

jbsroute.exe

jbsroute

4

コマンド実行

jcocmdapi.exe

jcocmdcom.exe

jcocmdexe.exe

jcocmd.exe

jcocmdapi

jcocmdcom

jcocmdexe

jcocmd

5

プラグインサービス

jbsplugind.exe

jbsplugincom.exe

jbsplugin

jbsplugincom

6

イベントサービス

jevservice.exe

jevservice

7

ログファイルトラップ

jevtraplog.exe

jevlogd

jelparentim

jelchildim

8

イベントログトラップ（Windows限定）

jevtrapevt.exe

−

9

ヘルスチェック

jbshcd.exe

jbshchostd.exe

jbshcd

jbshchostd

10

サービス管理制御

jbssrvmgr.exe

jbssrvmgr

11

ローカルアクション

jbslcact.exe

jbslcact

12

プロセス間通信

jbscomd.exe

jbscomd_ses.exe

jbscomd_rcv.exe

jbscomd_snd.exe

jbscomd_api.exe

jbscomd

jbscomd_ses

jbscomd_rcv

jbscomd_snd

jbscomd_api

（凡例）

−：該当なし。

プロセス管理の起動用プロセス（jbs_service），および起動管理（jbapmsrvcecon）は，サービスを起動，停止するだけのプロセスのため監視しません。また，統合トレース機能（hntr2mon）は，JP1/Base以外の製品も使用する機能のため監視しません。

(2)　ヘルスチェック機能が出力するメッセージ中のプロセス名および機能名一覧

ヘルスチェック機能が出力するメッセージ中のプロセス名および機能名を次の表に示します。

表2‒10　ヘルスチェック機能のメッセージ中のプロセス名および機能名一覧

項番

機能

プロセス名

機能名

1

プロセス管理

jbs_spmd

jbsspmd

2

認証サーバ

jbssessionmgr

jbssessionmgr

3

構成管理

jbsroute

jbsroute

4

コマンド実行

JCOCMDAPI

JCOCMDCOM

JCOCMDEXE

JCOCMDROUTER

jcocmd

5

プラグインサービス

jbsplugind

jbsplugincom

jbsplugin

6

イベントサービス

Windowsの場合

jevservice

UNIXの場合

jevservice

jevservice

7

ログファイルトラップ

Windowsの場合

jevtraplog

UNIXの場合

jelchildim

jelparentim

jevlogd

jevtraplog

8

イベントログトラップ（Windows限定）

jevtrapevt

jevtrapevt

9

ヘルスチェック

jbshcd

jbshchostd

jbshcd

jbshchostd

10

サービス管理制御

jbssrvmgr

jbssrvmgr

11

ローカルアクション

jbslcact

jbslcact

12

プロセス間通信

jbscomd

jbscomd_ses

jbscomd_rcv

jbscomd_snd

jbscomd_api

JBSCOM

2.7.5　ヘルスチェック機能を利用した他ホストの監視

ヘルスチェック機能は，JP1/Base自身の障害を検知することを目的としていますが，ヘルスチェック機能自体にハングアップなどの異常が生じると，JP1/Baseの障害を検知できなくなります。また，JP1/IM - Managerを利用したシステムでは，イベントサービスに異常が生じると，JP1イベントを発行，および転送できないため，異常を検知しても上位ホストへ通知できなくなります。

JP1/Baseは，自ホストのプロセスの異常を検知，または通知する手段がなくなった場合に備え，他ホストからヘルスチェック機能およびイベントサービスのプロセスの状態を監視できます。1台のホストで2,500台まで監視できます。

JP1/IM - Managerを利用したシステムでの他ホストの監視方法，および他ホストを監視する場合の運用方法について説明します。

(1)　JP1/IM - Managerを利用したシステムでの他ホスト監視

他ホストのJP1/Baseのヘルスチェック機能，およびイベントサービスが正常に稼働しているかどうかを監視できます。

次の図に示す構成例を基に，JP1/IM - Managerを利用したシステムでの他ホストの監視について説明します。

図2‒36　JP1/IM - Managerを利用したシステムでの他ホスト監視の例

図の例では，各ホストで次のように設定されています。

ホスト

役割

他ホスト監視の設定

hostA

マネージャーホスト

hostB，hostXを監視する。

hostB

サブマネージャーホスト

hostA，hostY，hostZを監視する。

hostX

エージェントホスト

設定なし。

hostY

エージェントホスト

設定なし。

hostZ

エージェントホスト

設定なし。

エージェントホストhostY，およびマネージャーホストhostAで，ヘルスチェック機能，およびイベントサービスに異常が生じた場合の処理について説明します。

hostYのヘルスチェック機能に異常が生じた場合

hostBのヘルスチェック機能が異常を検知してJP1イベントを発行します。発行されたJP1イベントはhostAに転送され，JP1/IM - ViewにhostYの異常通知が表示されます。

hostYのイベントサービスに異常が生じた場合

hostYのヘルスチェック機能が異常を検知しますが，JP1イベントを発行できないため，hostBのヘルスチェック機能が異常を検知してJP1イベントを発行します。hostBで発行されたJP1イベントはhostAに転送され，JP1/IM - ViewにhostYの異常通知が表示されます。

hostAのヘルスチェック機能に異常が生じた場合

hostBのヘルスチェック機能が異常を検知してJP1イベントを発行します。発行されたJP1イベントはhostAに転送され，JP1/IM - ViewにhostAの異常通知が表示されます。

hostAのイベントサービスに異常が生じた場合

hostAのJP1/IM - Managerでヘルスチェック機能を有効にしている場合は，JP1/IM - Managerのヘルスチェック機能がhostAのイベントサービスの異常を検知し，JP1/IM - ViewにhostAの異常通知が表示されます。

(2)　監視対象ホストの数が多い場合の運用方法

1台のホストで複数のホストを監視する場合，ヘルスチェック機能は1台ずつホストのプロセス状況を確認します。1台のホストの監視に掛かる時間は3秒程度です。そのため，1台のホストが監視するホスト数が多いと監視に時間が掛かります。

例えば，1台のホストで200台のホストを監視すると，すべてのホストを監視し終わるまでに600秒程度掛かります。監視時間を短縮したい場合は，監視対象ホストをグループに分け，グループごとに擬似的なマネージャーホストを決めて監視してください。

図2‒37　200台のホストを監視する場合の運用例

図の例では監視対象ホストを20台ずつのグループに分けています。また，マネージャーホストhostAから擬似的なマネージャーホストhost1，host21などを監視するよう設定します。グループごとに監視すると，監視に掛かる時間を60秒程度に短縮できます。

(3)　1回ごとの監視に掛かった時間を知りたい場合

1回ごとの監視（ポーリング）に掛かった時間を知りたい場合は，ポーリング完了メッセージ（KAVA7239-I）で確認できます。ポーリング完了メッセージ（KAVA7239-I）は，1回の監視が完了するごとに次に示すメッセージが出力されます。

KAVA7239-I ヘルスチェックによる監視が完了しました. (ホスト名=監視元ホスト名, 監視時間=監視時間秒, 監視間隔=監視間隔秒)

ポーリング完了メッセージ（KAVA7239-I）は，ヘルスチェック定義ファイルのPOLLENDMSGパラメーターにYESを指定すると出力されます。インストール時は出力しない設定になっています。ヘルスチェック定義ファイルの詳細については，「16.　定義ファイル」の「ヘルスチェック定義ファイル」を参照してください。

(4)　階層管理した構成で障害が発生した場合の運用方法

監視対象ホストを階層管理している構成で，障害が発生した場合の運用方法について次の図で説明します。

図2‒38　階層管理している構成で，障害が発生した場合の運用例

hostBのヘルスチェック機能やイベントサービスに障害が発生した場合，hostBが監視しているhostDやhostEの異常を検知，および通知できなくなります。

hostBが短時間で復旧した場合は，hostBの停止中にhostDやhostEで障害が発生してJP1イベントが発行されても，JP1イベントの転送のリトライによって，hostBが回復した時点でJP1イベントが転送されます。hostBの復旧に長時間掛かる場合は，hostBが復旧するまでの間，hostAからhostD，hostEを直接監視するようヘルスチェック定義ファイル（jbshc.conf）を設定し直す必要があります。

このように階層管理している構成では，サブマネージャーホストの障害に備えて，マネージャーホストから直接エージェントホストを監視するよう定義したヘルスチェック定義ファイル（jbshc.conf）をあらかじめ用意しておくと便利です。

(5)　一時的な障害で監視エラーが発生する場合の運用方法

ヘルスチェック機能の他ホスト監視では，システムに負荷が掛かったりネットワークに問題が発生したりして，監視対象ホストの監視が失敗した場合，監視元ホスト（マネージャー）に異常を通知します。

ただし，システムやネットワークの障害が一時的な場合，時間を置くことで障害が回復するときもあるため，そのつど監視元ホストに異常を通知したくないケースもあります。そのようなケースでは，異常が発生したと判断するしきい値（監視しきい値）を指定します。監視しきい値には，監視に連続で失敗した回数を指定します。指定した回数に達した場合，監視対象で異常が発生したと判断して，監視元ホストに異常を通知します。

監視しきい値を設定しない場合と監視しきい値に3を設定した場合の動作の違いを次の図に示します。

図2‒39　ヘルスチェック機能の監視しきい値による動作の違い

図に示したように，監視しきい値を設定しない場合は，監視が1回失敗した時点でエラーメッセージを通知します。それに対して，監視しきい値に3を設定した場合は，3回連続で監視に失敗した時点でエラーメッセージを通知します。なお，監視しきい値に1を設定した場合は，監視しきい値を設定しない場合と同じ動作になります。

監視しきい値は，ヘルスチェック定義ファイル（jbshc.conf）で指定できます。なお，監視しきい値を設定すると，「監視間隔×（監視しきい値-1）」秒程度監視対象ホストの異常の検知が遅れます。通常の運用では，監視しきい値は初期設定の1（回）のままで運用してください。監視しきい値を変更する場合は，障害やエラーの発生状況を考慮して値を検討してください。

監視の失敗が一時的な障害であるかどうかは，出力されるメッセージを目安に判断します。目安となるメッセージを次に示します。

監視が失敗したときにKAVA7223-EメッセージまたはKAVA7229-Wメッセージが出力される。

そのあとの接続確認で監視ができる状態になって，KAVA7224-Iメッセージが出力される。

上記の順番でメッセージが出力されている場合は，一時的に障害が発生して，そのあと障害が回復したことを示しています。また，監視が失敗した要因としては，監視対象ホストへの接続の失敗，監視対象ホストとのセッションの切断，接続処理や通信処理のタイムアウトなどがあります。要因については，KAVA7223-EメッセージまたはKAVA7229-Wメッセージに出力される詳細情報を確認してください。なお，メッセージの詳細情報を出力するには，ヘルスチェック定義ファイル（jbshc.conf）のERROR_DETAILパラメーターが有効（ON）になっている必要があります。監視が失敗した要因が接続処理または通信処理のタイムアウトの場合は，通信タイムアウト時間の見直しも必要です。

(6)　監視間隔の見直し

他ホストを監視する場合は，ヘルスチェック定義ファイル（jbshc.conf）で監視間隔を指定できます。運用を開始する前に試運転をして，指定した監視間隔が妥当かどうか確認してください。このとき，統合トレースログにKAVA7219-Wのメッセージが出力された場合は，指定した監視間隔が短いおそれがあります。「16.　定義ファイル」の「ヘルスチェック定義ファイル」に記載してある見積もり式を参照して，監視間隔を設定し直してください。

(7)　通信タイムアウト時間の見直し

監視対象ホストのシステム負荷が高い状態の場合，監視対象ホストから監視元ホスト（マネージャー）への他ホスト監視の応答が遅延して，監視に失敗することがあります。そのような場合，マネージャー側の通信タイムアウト時間を調整して，タイムアウトによる監視の失敗を減らすことができます。

通信タイムアウト時間は，ヘルスチェック定義ファイル（jbshc.conf）で指定できます。なお，通信タイムアウト時間を監視間隔よりも長く設定すると，監視間隔の時間内で監視が完了しないおそれがあるため，通信タイムアウト時間は監視間隔よりも短くなるように設定してください。通常の運用では，通信タイムアウト時間は初期設定の60（秒）のままで運用してください。次に示すような状況で処理遅延が発生している場合は，運用状況に合わせて通信タイムアウト時間の見直しを検討してください。

一時的または定期的にシステム負荷が高まる。

システムの限界性能に近い状態で運用している。

通信タイムアウトが発生したかどうかは，監視が失敗したときに出力されるKAVA7223-EメッセージまたはKAVA7229-Wメッセージの詳細情報を確認してください。要因に「接続処理がタイムアウトしました」または「通信処理がタイムアウトしました」が出力されている場合は，通信タイムアウトが発生していることを示します。なお，メッセージの詳細情報を出力するには，ヘルスチェック定義ファイル（jbshc.conf）のERROR_DETAILパラメーターが有効（ON）になっている必要があります。

(8)　監視対象ホストが停止する場合の運用方法

監視元ホストと監視対象ホストにインストールされているJP1/Baseのバージョンが両方とも09-10以降の場合，監視対象ホストの起動・停止を監視するかどうかを選択できます。監視対象ホストの起動・停止を監視すると，運用上計画的にホストが停止する場合，正常に停止したホストはエラーとして通知されません。

監視対象ホストの起動・停止を監視する場合と監視しない場合の動作の違いを次の図に示します。

図2‒40　監視対象ホストの起動・停止を監視する場合と監視しない場合の動作の違い

JP1/Baseが起動・停止した場合，JP1イベントを発行します。監視対象ホストの起動・停止を監視する場合は，監視対象ホストの停止通知イベントを受信すると，KAVA7228-Iメッセージを出力します。この場合，停止通知イベントを受信したあとも，指定された監視間隔で接続確認をしますが，接続できなくても正常な運用と見なし，エラーの通知はしません。

なお，監視元ホストのJP1/Baseが停止中は，監視対象ホストの停止通知イベントを受信できません。そのため，監視元ホストのJP1/Baseが起動後，監視した実績がない監視対象ホストに対して，監視が失敗した場合は，KAVA7229-Wメッセージを出力します。

KAVA7229-W 停止通知を受けていない ホストB に接続できないため監視ができません.

また，監視した実績がある監視対象ホストまたは起動通知イベントを受信した監視対象ホストに対して，監視が失敗した場合は，KAVA7223-Eメッセージを出力します。

KAVA7223-E ホストB に接続できないため監視ができません.

KAVA7229-WメッセージまたはKAVA7223-Eメッセージを出力した監視対象ホストが，接続確認によって監視できる状態になった場合，またはその監視対象ホストから起動通知イベントを受信した場合，KAVA7224-Iメッセージを出力して監視を再開します。

メモ

監視対象ホストの起動・停止を監視する場合は，監視対象ホストで起動通知イベントと停止通知イベントを監視元ホストへ転送する設定が必要です。

一方，監視対象ホストの起動・停止を監視しない場合は，起動または停止通知イベントを受信しても，メッセージを出力しません。この場合，停止通知イベントを受信したあとも，通常の監視をして，接続できない場合はKAVA7223-Eメッセージを出力します。

現在どちらの設定になっているかは，ヘルスチェック（他ホスト監視）を起動したときに出力されるメッセージで確認できます。設定とメッセージIDの対応を次に示します。

設定

メッセージID

監視対象ホストの起動・停止を監視する

KAVA7231-I

監視対象ホストの起動・停止を監視しない

KAVA7230-I

監視対象ホストの起動・停止を監視するかどうかの設定は，ヘルスチェック定義ファイル（jbshc.conf）のSTOP_CHECKパラメーターで変更できます。

2.8　JP1イベントを契機にコマンドを実行する

エージェントホストで障害発生などのJP1イベントが発行された場合に，登録したコマンドをエージェントホスト内で自動的に実行できます。これを，ローカルアクションといいます。マネージャーとエージェント間のネットワークに掛かる負荷を軽減することができ，マネージャーとエージェント間でネットワーク障害が発生した場合でもコマンドを実行できます。

JP1/BaseのローカルアクションとJP1/IM - Managerの自動アクションとの比較を，次の図に示します。

図2‒41　ローカルアクションと自動アクションの比較

ローカルアクションを実行するには，ローカルアクション実行定義ファイルを作成し，どのJP1イベントが発生した場合にどのコマンドを実行するかを指定しておきます。指定したJP1イベントが発生すると，JP1/Baseは発生したJP1イベントに対応するコマンドを自動的に実行します。

ローカルアクションでは，アクション開始イベントおよびアクション完了イベントを発行することもできるため，これらのイベントをマネージャーホストに転送すれば，マネージャーホストでローカルアクションの実行や結果を確認できます。アクションの実行履歴は，ローカルアクション実行履歴ログにも出力されます。

2.8.1　ローカルアクションの実行に必要な条件

エージェントにインストールされているJP1/Baseのバージョンが09-00以降である。

JP1/IMでシステム構成定義が定義され，ローカルアクションを実行するホストに配布されている。

なお，マネージャーおよびサブマネージャーにインストールされているJP1/IM - ManagerおよびJP1/Baseのバージョンがすべて09-00以降で，IM構成管理を使用している場合は，IM構成管理の機能によって，ローカルアクション実行定義ファイルをマネージャーホストで定義し，各エージェントホストに一括配布できます。IM構成管理による定義情報の管理については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

また，ローカルアクションの実行条件（ローカルアクション実行定義ファイルに定義するイベントフィルター）で対象となるJP1イベントは，次に示す自イベントサーバに登録されたJP1イベントだけです。

自イベントサーバから自イベントサーバあてに発行されたイベント（JP1イベントの登録要因：1）。

他イベントサーバから自イベントサーバあてに発行されたイベント（JP1イベントの登録要因：3）。

例えば，jevsendコマンド（-dオプションを指定）やjevsenddコマンドなどで自ホストの他イベントサーバから自イベントサーバに登録された場合です。

他イベントサーバから転送されたJP1イベント（JP1イベントの登録要因：4）は対象外です。

2.8.2　ローカルアクションで実行できるコマンド

ローカルアクションで実行できるコマンドの形式を次に示します。

Windowsの場合

実行形式ファイル（.com，.exe）

バッチファイル（.bat）

JP1/Scriptのスクリプトファイル（.spt）

（ただし，.sptファイルが実行できるように関連づけが設定されていること）

UNIXの場合

UNIXのコマンド

シェルスクリプト

ただし，次のようなコマンドは実行できません。

対話操作を必要とするコマンド

画面を表示するコマンド

エスケープシーケンスや制御コードを伴うコマンド

デーモンなどの，終了しないコマンド

Windowsメッセージ機構やDDEなど，デスクトップとの対話が必要なコマンド（Windowsの場合）

shutdownやhaltなど，OSをシャットダウンするコマンド

2.8.3　ローカルアクションの実行状態

ローカルアクションは，JP1/Baseの起動時に自動で起動するように設定されています。ローカルアクションが起動すると，自ホストに登録されるJP1イベントを取得し，ローカルアクション実行定義ファイルで指定した条件と比較します。取得したJP1イベントと条件が合致すると，対応するコマンドを実行します。なお，ローカルアクション実行定義ファイルの条件は上から比較するため，優先度の高い条件を上位に定義するようにしてください。

ローカルアクションの実行状態は，jbslistlcactコマンドで確認できます。実行状態には，「実行待ち」および「実行中」があり，これらの状態のアクションはキャンセルすることもできます。また，ローカルアクション実行条件の成立から実行完了までの実行状態の変化は，JP1イベントおよびローカルアクション実行履歴ログで通知します。

ローカルアクションの実行状態を次の図に示します。

図2‒42　ローカルアクションの流れと実行状態

実行待ちおよび実行中のローカルアクションの数は，次に示す機能で制御することもできます。

(1)　同一アクションの抑止

一定時間に同じアクションが複数回実行されるのを抑止できます。管理者へのメール通知など，一定時間に一度実行されればよいアクションに使用できます。抑止を設定すると，抑止時間内に条件が成立しても実行待ちにしません。

(2)　実行待ちアクション数の制限

実行待ちにできるアクションの上限値を指定できます。指定した上限値を超えた場合は，条件が成立してもアクションを実行待ちにしません。

(3)　同時実行数の制御

同時に実行できるアクションの上限値を指定できます。指定した上限値を超えていない場合だけ，アクションを実行します。上限値を超えた場合，アクションは実行待ちのままです。

2.8.4　ローカルアクションの休止

ローカルアクションを停止しないで，一時的に休止できます。休止前に実行待ちおよび実行中のローカルアクションはキャンセルされないで，そのまま実行されます。ローカルアクションが休止の間，JP1イベントは取得されないため，新しいローカルアクションが実行待ちになることはありません。また，ローカルアクションの休止が解除された場合，解除時点からJP1イベントを取得して，ローカルアクションを実行します。

2.9　各種システム構成への対応

2.9.1　クラスタシステムでの運用

JP1/Baseは，クラスタシステムでの運用に対応しています。

JP1/Baseをクラスタ運用することによって，サーバ障害などが発生した場合でも実行系から待機系に処理を引き継いで，システム運用管理を継続できます。

詳細については，「5.　クラスタシステムで運用する場合の設定」を参照してください。

2.9.2　非クラスタ環境での論理ホスト運用

通常，論理ホストのJP1/Baseは，クラスタシステムでクラスタソフトと連携して運用します。しかし，IPアドレスとディスク領域を用意し，JP1/Baseの論理ホストをセットアップすると，クラスタソフトと連携しなくてもフェールオーバーしない論理ホスト環境でJP1/Baseを運用できます。

詳細については，「5.9　非クラスタ環境で論理ホストを運用する場合の設定」を参照してください。

2.10　JP1/Baseの通信方式

この節では，JP1/Baseの通信方式の概要について説明します。この節および「6.　ネットワーク構成に応じたJP1/Baseの通信設定」で説明する通信に対する考え方は，JP1/Baseを前提とする製品（JP1/IMやJP1/AJSなど）でも同様となります。

JP1/Baseには二つの通信方式があり，インストールした時点，または論理ホストをセットアップした時点で，適切な通信方式が自動で設定されます。

ネットワークの構成や運用方法によっては，通信方式を手動で設定する必要があります。さまざまなネットワーク構成に適したJP1/Baseの通信設定の詳細については，「6.　ネットワーク構成に応じたJP1/Baseの通信設定」を参照してください。

メモ

イベントサービスの通信については，JP1/Baseのバージョン9まではイベントサーバ設定ファイル（conf）を使用した独自の通信方式だけサポートしていましたが，JP1/Baseのバージョン10からはjp1hosts2情報に対応しています。jp1hosts2情報を使用して運用する場合，JP1/Baseのほかの機能と同様，JP1/Base本体の通信と同じ設定で動作します。jp1hosts情報を使用する特別な理由がないかぎり，jp1hosts2情報を使用した運用を推奨します。なお，イベントサービスの通信は，06-51以前の通信設定には対応していません。

jp1hosts2情報を使用すると，物理ホストに定義してある名前解決するためのホスト定義を論理ホストでも利用できます。この機能を物理マージ機構といいます。特別な理由がないかぎり，物理ホストにだけホスト定義することを推奨します。

2.10.1　推奨する通信方式

JP1/Baseでは，通信でのバインド方式として次に示すバインド方式を推奨しています。

(1)　物理ホストだけでJP1/Baseを運用する場合に推奨する通信方式

物理ホストだけでJP1/Baseを運用する場合：ANYバインド方式

ANYバインド方式では，IPアドレスを意識しないでポート番号だけを利用して通信を行います。通信の待ち受け処理では，ホストに割り当てられているすべてのIPアドレスあてにきたデータを受信できます。接続処理では，ホストが複数のサブネットを利用している場合でも，すべてのサブネット上のホストにデータを送信できます。

クラスタ運用する場合にANYバインド方式にすると，物理ホストあてのデータを論理ホストで受信したり，論理ホストあてのデータを物理ホストで受信したり，正しく通信できないおそれがあります。

(2)　論理ホストを使用する（クラスタ運用する）場合に推奨する通信方式

論理ホストを使用する（クラスタ運用する）場合：IPバインド方式

IPバインド方式では，一つのNIC（Network Interface Card）に複数のIPアドレスが割り当てられていているときや，1台のホストにNICが複数あるときなど，ホストが使用するIPアドレスが複数ある場合でも，特定のIPアドレスあてにきたデータだけを受信できます。また，接続処理では，特定のIPアドレスを使用しているNICだけを経由します。

クラスタ運用する場合，1台のホストに物理ホストと論理ホストが混在したり，複数の論理ホストを同時に起動したりすることがあります。このような場合でも，物理ホスト・論理ホストそれぞれのIPアドレスあてにきたデータだけを受信します。

通信方式は，初期設定ではANYバインド方式が設定されています。クラスタ運用する場合は，次に示すクラスタシステム用の設定をしたときに，物理ホストと論理ホストの両方でIPバインド方式が設定されます。

Windowsの場合：GUI（jp1bshasetup.exe）またはコマンド（jbs_setup_clusterコマンド）でクラスタシステム用の設定をしたとき。

UNIXの場合：コマンド（jp1base_setup_clusterコマンド）でクラスタシステム用の設定をしたとき。

注意事項

いったんクラスタシステム用の設定をしたホストでは，論理ホストをすべて削除しても物理ホストの通信方式はANYバインド方式に戻りません。物理ホストだけの運用に戻したい場合は，「6.3.2　JP1/Base本体の通信方式を変更する」を参照して，通信方式をANYバインド方式に戻してください。

2.10.2　ANYバインド方式とIPバインド方式の待ち受け処理の違い

JP1/Baseの通信方式が，ANYバインド方式だった場合とIPバインド方式だった場合で通信の待ち受け処理がどう変わるのか図を使って説明します。

(1)　JP1/BaseがANYバインド方式で起動した場合の待ち受け処理

JP1/Baseの通信方式が，ANYバインド方式だった場合の通信の待ち受け処理を次の図に示します。

図2‒43　hostAのJP1/BaseがANYバインド方式で起動した場合の待ち受け処理

hostAのNICにはIPアドレス10.0.0.10と10.0.0.11が割り当てられています。なお，hostA自体は自分のホスト名から10.0.0.10でしかIPアドレスの解決ができないと仮定します（実際にOSによっては，一つのホスト名から一つのIPアドレスしか解決できないものがあります）。また，hostXではhostAはIPアドレス10.0.0.10で解決され，hostYではhostAはIPアドレス10.0.0.11で解決されるとします。

hostAでJP1/BaseがANYバインド方式で起動した場合，hostXからもhostYからもデータを受け取れます。ANYバインド方式の場合，IPアドレスを意識しないでポート番号だけを利用して通信をするため，10.0.0.10あてにきたデータも10.0.0.11あてにきたデータも受け取れます。

(2)　JP1/BaseがIPバインド方式で起動した場合の待ち受け処理

JP1/Baseの通信方式が，IPバインド方式だった場合の待ち受け処理を次の図に示します。

図2‒44　hostAのJP1/BaseがIPバインド方式で起動した場合の待ち受け処理

hostAでJP1/BaseがIPバインド方式で起動した場合，10.0.0.10あてにきたデータだけをJP1/Baseは受け取り，10.0.0.11あてにきたデータを認識できません。これはhostAが，ポート番号が同じでもIPアドレスのあて先が自分と異なるものは受け付けないよう動作するためです。

2.10.3　ホスト名に対応するIPアドレスの確認方法

JP1/Baseで使用したいホスト名がどのIPアドレスを解決できているのか，確認が必要になることがあります。これは，hostsファイルで，一つのホスト名に対し，複数のIPアドレスが割り当てられているよう設定されていても，OSがその設定を有効と認めていない場合があるためです。

JP1/Baseで使用したいホスト名がどのIPアドレスで解決できているのか確認する場合は，次のコマンドを実行してください。

jp1ping ホスト名

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

2.10.4　JP1/Baseの通信方式の注意事項

JP1/Baseは通信をする際，ホスト名を意識して動作します。物理ホスト上で動作する場合はhostnameコマンドで返されるホスト名を自ホスト名と認識し，論理ホスト上で動作する場合はクラスタシステム用の設定をした際に指定した論理ホスト名を自ホスト名と認識して動作します。そのため，次の事項にご注意ください。

基本的には代表となるホスト名を一つだけ使用し，複数のエイリアス名による運用は避けてください。

ホスト名に対して割り当てられているIPアドレスを解決できない場合，正しく動作しません。

ホスト名からIPアドレスへの変換，およびIPアドレスからホスト名への変換（逆引き）の両方ができるように設定してください。特に，DNSサーバ（Active Directory含む）で名前解決をする場合は，両方の変換ができるように設定する必要があります。

複数LAN接続の環境の場合，名前解決によって複数のIPアドレスが取得される環境では，送信時に，ホスト名に対応する最優先のIPアドレスが使用されます。

送信をIPバインド方式にしている場合，送信側のIPアドレスは，自ホスト名に対応する最優先のIPアドレスが使用されます。

非ループバックアドレスからループバックアドレス，およびその逆方向の接続を行うと通信障害が発生します。これは非ループバックアドレスが同一ホスト内のものであっても同様です。そのため，JP1/Baseの運用でループバックアドレスを使用することはできません。また，アドレス解決の結果，ループバックアドレスとなるホスト名での運用もできません。

JP1/Baseで使用するIPアドレスとホスト名をhostsファイルに定義する場合は，IPアドレスとホスト名の組み合わせが重複しないように定義してください。

Linuxの場合，JP1/Baseを使用する環境では，net.ipv4.ip_nonlocal_bindに1を設定しないでください。net.ipv4.ip_nonlocal_bindに1が設定されていると，JP1/IM構成管理のプロファイル収集が失敗します。net.ipv4.ip_nonlocal_bindの設定内容はsysctlコマンドで確認できます。

# sysctl net.ipv4.ip_nonlocal_bind

net.ipv4.ip_nonlocal_bindに1が設定されている場合，次のどちらかの手順を実施してください。

/etc/sysctl.confファイルの本パラメータの記述を削除し，システムを再起動または「sysctl -w net.ipv4.ip_nonlocal_bind=0」コマンドを実行してから，JP1/Baseを前提とするプログラムとJP1/Baseを再起動する。

/etc/sysctl.confファイルの設定を「net.ipv4.ip_nonlocal_bind = 0」に変更し，「sysctl -p」コマンドを実行してから，JP1/Baseを前提とするプログラムとJP1/Baseを再起動する。

JP1/Baseは通信時のホスト名から，一意のホスト名・IPアドレスが求まらない環境では使用できません。そのため，ダイナミック・モード（そのときに空いている番号を割り当てて，自動的にルールを設定および変更する方法）のNATやポート変換機能を含むNAPT（IP Masquerade，NAT+）には対応していません。

DHCPの使用

DHCPによって，JP1/Baseが使用するIPアドレスを管理する場合，IPアドレスの割り当て期限を無制限にしてIPアドレスが変わらないようにしてください。

JP1/Baseの動作中に，使用するIPアドレスが変更されると正常に動作できません。

2.11　JP1/BaseをJP1/Base管理者で運用する（UNIX限定）

JP1管理者グループおよびJP1/Base管理者を設定することによって，JP1/Baseのシステム管理者（スーパーユーザー）以外のOSユーザーでも，JP1/Baseを運用できるようになります。JP1管理者グループは，ユーザーが任意に作成できるOSのユーザーグループです。JP1管理者グループに所属していて，JP1/Baseを運用する権限を与えられたユーザーをJP1/Base管理者と呼びます。

JP1管理者グループとJP1/Base管理者の関係を，次の図に示します。

図2‒45　JP1/管理者グループとJP1/Base管理者の関係

JP1/Base管理者は，JP1/Baseのシステム管理者がJP1/Base管理者での運用を有効にするまでの環境設定をしたあとに，JP1/Baseのシステム管理者に代わってJP1/Baseを運用します。

JP1/BaseをJP1/Base管理者で運用する場合の詳細については，「付録J　JP1/Base管理者での運用（UNIX限定）」を参照してください。

2.12　JP1/Baseの互換性

この節では，JP1/Baseとイベントサービス機能で連携できる製品との互換性，また，JP1/Baseと旧バージョンのJP1/Baseとの互換性について説明します。

2.12.1　旧バージョンのJP1/Baseとの互換性および接続性

JP1/Baseは，旧バージョンのJP1/Baseと互換性を持ちます。ただし，旧バージョンとの接続性については，JP1/IM - ManagerやJP1/AJS3など上位製品の制限に従います。上位製品の接続性については，上位製品のマニュアルを参照してください。また，次に示す場合には注意が必要です。

(1)　JP1/IMを使用していてコマンド実行履歴がある場合

バージョン8で，コマンド実行履歴ファイル（ISAM）の保存形式が変更になりました。そのため，バージョン7以前のJP1/IMを使用していてコマンド実行履歴ファイル（ISAM）がある場合は，JP1/Baseのバージョンアップ後，JP1/IMの運用開始までの間に必ずjcocmdconvコマンドを実行してください。

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

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

(2)　JP1/IM用とJP1/AJS用のJP1ユーザーの操作権限を設定する場合

JP1/IM 08-00とJP1/AJS 08-00では，新たにJP1ユーザーの操作権限が追加されました。新たに追加されたJP1ユーザーの操作権限を設定する場合，認証サーバのバージョンが07-51以前では設定できません。

(3)　JP1/IM用定義情報を収集および配布する場合

イベントサービスの定義情報の収集と配布や，JP1製品の定義情報を収集する場合，収集元，配布元のホスト，および収集先，配布先のホストにインストールされているJP1/Baseのバージョンを07-00以降にする必要があります。

(4)　コマンドの戻り値を参照するシェルスクリプトを使用している場合

JP1/Base 06-71では，次に示すコマンドの戻り値が変更されました。

jbsacllint

jbsaclreload

jbsadduser

jbschgpasswd

jbslistuser

jbsrmuser

06-51以前のJP1/Baseで，上記コマンドの戻り値を参照するシェルスクリプトを使用していた場合，そのシェルスクリプトは，07-00以降のJP1/Baseで正常に動作しなくなるおそれがあります。このため，上記コマンドの戻り値の利用については見直しが必要です。各コマンドの戻り値については，「15.　コマンド」を参照してください。

(5)　暗号通信機能がないホストと通信する場合

例えば，社内環境とクラウド環境で通信をする環境の場合，社内環境のエージェントホストは非SSL通信を使用し，クラウド環境のエージェントホストはSSL通信を使用する，混在した通信での運用が考えられます。この場合，非SSL通信するホストを非SSL通信ホスト設定ファイルに設定することで，暗号通信機能がないホストと通信をすることができます。

非SSL通信ホスト設定ファイルの詳細については，「16.　定義ファイル」の「非SSL通信ホスト設定ファイル」を参照してください。

第3編　構築編

3　インストールとセットアップ

この章では，JP1/Baseのインストールとセットアップ，およびバックアップとリカバリーについて説明します。

なお，JP1/Baseをインストールする前に，JP1/Baseが前提とするOSの追加パッケージやパッチなどの適用が必要です。詳細については，リリースノートを確認してください。

3.1　インストールとセットアップの流れ

JP1/Baseのインストールの開始からシステムの運用開始までの作業の流れについて説明します。

なお，インストールおよびセットアップをするユーザーには，Windowsの場合はAdministrators権限，UNIXの場合はスーパーユーザー権限が必要です。

図3‒1　インストールとセットアップの作業の流れ

3.2　インストール（Windowsの場合）

この節では，Windows版JP1/Baseのインストール，アンインストール，およびインストール・アンインストール時の注意事項について説明します。

3.2.1　インストール

JP1/Baseをインストールする手順を次に示します。

プログラムを終了する。

JP1/Baseをインストールする前に，JP1の全プログラム，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを終了してください。

提供媒体をドライブに入れる。

インストーラーの起動後，JP1/AJSまたはJP1/IMに同梱されたJP1/Baseを選択し，インストーラーの指示に従ってインストールを進めてください。

インストール時には，次の項目を設定します。

ユーザー情報

インストール先フォルダ

インストール先フォルダの初期設定は次のとおりです。

システムドライブ¥Program Files (x86)¥Hitachi¥JP1Base

システムドライブ¥Program Files¥配下にはインストールしないでください。64ビットモジュールとの混在によって，動作上問題が発生することがあります。

自動セットアップ処理

新規にインストールする場合だけ，「自動セットアップの選択」画面が表示されます。［セットアップ処理を行う］をチェックすると，自動で初期設定が行われ，インストール完了後すぐに運用できる状態になります。

自動セットアップ処理を行う場合に設定される項目を次の表に示します。

表3‒1　ユーザー管理機能に関する初期設定値

設定項目

内容

認証サーバの設定

認証サーバ名

自ホスト名

JP1ユーザーの設定

JP1ユーザー名

jp1admin

パスワード

jp1admin

JP1資源グループ

*

所有する権限

JP1_AJS_Admin，JP1_JPQ_Admin，JP1_AJSCF_Admin，JP1_CSA_Admin，JP1_HPS_Admin，JP1_PFM_Admin，JP1_Console_Admin，JP1_CF_Admin，JP1_CM_Admin，JP1_Rule_Admin，JP1_ITSLM_Admin，JP1_Audit_Admin，JP1_DM_Admin，JP1_SSO_Admin，Cosminexus_vMNG_Admin，HCS_UserMng_Admin，HCS_HDvM_Admin，HCS_HRpM_Admin，HCS_HTSM_Admin，HCS_HSNM2_Modify，HCS_HFSM_Admin，HCS_HCSM_Admin，HCS_HGLM_Admin，HCS_HTnM_Admin，JP1_AO_Admin，JP1_IMNP_Admin，UCNP_Admin，HNP_Admin，JP1_Analytics_Admin，JP1_ITDM_Admin，ISCF_Admin，JP1_IOTDM_Admin

ユーザーマッピングの設定

OSユーザー名とそのパスワード

OSユーザー名とそのパスワードの入力画面が表示されます。OSユーザー名とパスワードを入力してください。

マッピングするJP1ユーザー名

jp1admin

サーバホスト名

*

JP1ユーザーとOSユーザーのマッピング

JP1ユーザー（jp1admin）と登録したOSユーザーをマッピングします。

自動セットアップ処理を行わない場合は，JP1ユーザーの設定だけが行われます。

各設定項目の詳細については，「8.1　ユーザー管理の設定（Windowsの場合）」を参照してください。

インストーラーを実行すると，統合トレース機能（HNTRLib2）もインストールされます。HNTRLib2のインストール先は，次のとおりです。

32bit版HNTRLib2

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2

64bit版HNTRLib2

システムドライブ¥Program Files¥Hitachi¥HNTRLib2

HNTRLib2のインストール先はシステムドライブ固定です。インストール先を変更することはできません。

システムを再起動する。

再起動を要求された場合は，Windowsを再起動します。

JP1/NETM/DM，JP1/IT Desktop Management 2およびJob Management Partner 1/Software Distributionを使ったリモートインストール（ソフトウェアの配布）について

JP1/Baseは，JP1/NETM/DM，JP1/IT Desktop Management 2およびJob Management Partner 1/Software Distributionを使ったリモートインストールに対応しています。JP1/Baseの場合，次に示すインストールに対応しています。

新規インストール

インストール対象ホストにJP1/Baseを新規にインストールできます。ただし，JP1/NETM/DM，JP1/IT Desktop Management 2およびJob Management Partner 1/Software Distributionを使ったリモートインストールでは，自動セットアップ処理はできません。

バージョンアップインストール

リモートインストールすると，JP1/Baseインストール済みホストのJP1/Baseをバージョンアップできます。

実際の操作・運用方法については，JP1/NETM/DM，JP1/IT Desktop Management 2またはJob Management Partner 1/Software Distributionのマニュアルを参照してください。JP1/Baseをパッケージングする際は，必ずJP1/NETM/DM 09 -00 以降，Job Management Partner 1/Software Distribution 09 -00 以降，または JP1/IT Desktop Management 2のパッケージャを使用してください。なお，JP1/NETM/DMは日本でだけ販売している製品です。

3.2.2　アンインストール

JP1/Baseをアンインストールする手順を次に示します。

プログラムを終了する。

アンインストールする前にWindowsの［コントロールパネル］の［サービス］から，「JP1/Base」で始まるサービスをすべて停止してください。

JP1/Baseをアンインストールする。

Windowsの［コントロールパネル］の［プログラムと機能］から「JP1/Base」をアンインストールしてください。

JP1/Baseを前提とする製品がインストールされている場合，メッセージKAVA1870-Eを出力してアンインストールできません。

その場合は，対象のJP1製品をアンインストールしたあとに，「JP1/Base」をアンインストールしてください。

システムを再起動する。

JP1/Baseの動作環境を無効にするために，システムを再起動する必要があります。上記手順の終了後，システムを再起動してください。

ユーザーファイルを削除する。※

JP1/Baseの削除では，インストール後に作成された定義ファイルやログファイルなどは削除されません。

初期状態にする場合は，JP1/Baseをインストールしていたフォルダをエクスプローラで削除してください。

注※　JP1/Baseをアンインストールすると，HNTRLib2が自動的にアンインストールされます。ただし，HNTRLib2を利用するプログラムがほかにある場合は，そのプログラムがすべてアンインストールされた時点でHNTRLib2がアンインストールされます。

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

インストールの前に，ウィルスチェックソフトなどの常駐アプリケーションを終了してください。終了しなかった場合，インストールに失敗することがあります。

インストール，セットアップおよびアンインストールするには，管理者権限が必要です。UACが有効な環境で管理者（Administrator）以外のユーザーからこれらの操作をする場合は，管理者に昇格してください。なお，UACが無効な環境である場合は，Administratorsグループに所属するユーザーでこれらの操作をしてください。

インストール，アンインストールおよび修正パッチの適用時には，次のサービスのスタートアップの種類を「無効」にしないでください。「無効」にすると，インストール，アンインストールまたは修正パッチの適用に失敗するおそれがあります。

「Application Experience」サービス

「Windows Modules Installer」サービス

JP1/Baseを使用中に上書きインストールまたはアンインストールした場合，次のメッセージダイアログが表示されることがあります。

システムの実行中に更新できないファイルまたはサービスを，セットアップで更新する必要があります。続行する場合は，セットアップを完了するために再起動が必要となります。

このダイアログが表示された場合は，［キャンセル］ボタンをクリックして中断し，起動中のJP1/Baseのすべてのサービス，およびJP1/Baseの使用中のアプリケーションを停止したあと，再度上書きインストールまたはアンインストールしてください。

文字コード（JIS第3水準，第4水準）を含むインストールパスへはインストールしないでください。

新規インストール，上書きインストール，およびバージョンアップインストール後にシステムの再起動要求がある場合には必ずシステムを再起動してください。

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

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

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

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

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

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

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

JP1/Baseをインストールすると，環境変数PATHにJP1/Baseのbin，bin¥extフォルダのパスが自動的に追加されます。JP1/Baseのbin，bin¥extフォルダのパスが追加された結果，環境変数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/Baseを前提とする製品をアンインストールしないでJP1/Baseを強制的にアンインストールしたあと，再インストールする場合は，退避されたJP1/Base以外の共通定義情報を復旧する必要があります。退避した共通定義情報の復旧手順については，「(10)　JP1/Baseを前提とするJP1製品の共通定義情報の復旧手順」を参照してください。

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

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

(3)　Windows環境への設定

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

日立共通フォルダのパス

32bit版HNTRLib2

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

64bit版HNTRLib2

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

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

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

次の製品がインストールされている場合，メッセージKAVA1870-Eを出力してアンインストールできません。

JP1/AJS3 - Manager

JP1/AJS3 - Agent

JP1/AJS3 - Agent Minimal Edition

JP1/AJS3 - WOA

JP1/Power Monitor

JP1/IM2 - Manager

JP1/IM2 - View

JP1/IM2 - EG

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のヘルプを参照して削除してください。

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

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

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

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

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

jevdbmkrepコマンドを実行する。

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

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

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のイベントサービスを利用しているすべてのプログラムを必ず終了してください。

12-10以降では，物理ホストのイベントサーバをFQDN名で運用している場合に，JP1イベント取得関数を使用するときは，イベントサーバインデックスファイルにイベントサーバ名「*」（自ホスト名のイベントサーバ名）の定義を追加してください。定義をしない場合，JP1イベント取得に失敗します。

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

12-50以前のJP1/Baseに13-00以降のJP1/Baseを上書きインストールすると，JP1/SESイベントを使用する製品と連携するための機能で使用するファイルおよびフォルダが残ったままになります。これらのファイルおよびフォルダはJP1/Baseの動作に影響がありません。

(6)　Windowsでの言語設定について

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

Windows Server 2016の場合

設定内容

設定個所

確認個所

システムロケール

［コントロールパネル］−［地域］−［管理］−［システムロケールの変更］−［地域の設定］

［Unicode対応でないプログラムの言語］

言語および地域の形式

［コントロールパネル］−［地域］−［形式］

［形式］

［コントロールパネル］−［地域］−［場所］

［主な使用場所］

Windows Server 2022，Windows Server 2019の場合

設定内容

設定個所

確認個所

システムロケール

［コントロールパネル］−［地域］−［管理］−［システムロケールの変更］−［地域の設定］

［Unicode対応でないプログラムの言語］

言語および地域の形式

［コントロールパネル］−［地域］−［形式］

［形式］

［設定］−［地域］

［地域と地域設定］

注意事項

［コントロールパネル］−［地域］−［管理］タブで，［Unicodeではないプログラムの言語］の［システムロケールの変更］の［ベータ：ワールドワイド言語で Unicode UTF-8 を使用］にチェックが入っていると，文字化けすることがありますので注意してください。

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

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

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

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

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

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

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

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

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

(a)　複製前の注意事項

ユーザー管理機能の設定

ユーザーマッピングのOSユーザーにAdministratorを指定する場合，複製後に再設定する必要があります。

イベントサービスの動作環境の設定

イベントサーバインデックスファイル，イベントサーバ設定ファイルおよびAPI設定ファイルの各パラメーターにIPアドレスやホスト名，イベントサーバ名は設定しないでください。

システム構成の定義情報削除

複製先のホストをJP1/IMのシステム構成配下に定義する場合には，すでに設定されている構成定義情報をjbsrt_delコマンドで削除してください。

(b)　複製後の注意事項

イベントデータベースの初期化

ディスク複製インストール時に，内部的に生成されたホスト名でリブートされることで，イベントデータベースにJP1イベントが残ることがあります。運用を始める前にイベントデータベースを初期化してください。

ディスク複製インストールの操作・運用方法については，JP1/ServerConductor/Deployment ManagerおよびHitachi Compute Systems Manager Deployment Manager Plug-inのユーザーズガイドを参照してください。仮想化プラットフォームの複製機能については，仮想化ソフトウェアのマニュアルを参照してください。

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

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

実行コマンド

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

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

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

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

(10)　JP1/Baseを前提とするJP1製品の共通定義情報の復旧手順

JP1/Baseを前提とするJP1製品をアンインストールしないで，JP1/Baseを再インストールする場合に，共通定義情報を復旧する手順を次に示します。

なお，復旧手順の実施中は，JP1/BaseサービスやJP1製品のサービスを起動しないでください。

また，共通定義情報の復旧手順を誤った場合に備えて，次のコマンドを実行して全てのJP1製品の共通定義情報をバックアップしてください。

物理ホストの場合

jbsgetcnf > バックアップファイル名

論理ホストの場合

jbsgetcnf -h 論理ホスト名 > バックアップファイル名

JP1/Baseをバックアップする。

バックアップの詳細については，「3.5.2　バックアップとリカバリー（Windowsの場合）」を参照してください。

JP1/IM - Manager がインストールされている場合は，コマンド実行履歴ファイル （ISAM）のバックアップを行ってください。コマンド実行履歴ファイル（ISAM）のバックアップについては，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」（データベースのバックアップおよびリカバリー）を参照してください。

統合トレースログが削除される場合があるため，復旧手順実施前のログを採取してください。ログの採取方法については「18.4　資料の採取方法」を参照してください。

共通定義情報退避ファイルの出力先を確認する。

共通定義情報退避ファイルの出力先（Windowsのインストール先フォルダ¥Temp¥）の空きディスク容量が十分（1＋0.4×論理ホスト数［MB］以上）あること，エディタ等で共通定義情報退避ファイル出力先フォルダやファイルの排他を掛けていないこと，アクセス権限があることを確認してください。

空きディスク容量が無い場合，共通定義情報退避ファイルのファイルサイズが0byteになるなど，正しく出力されません。

排他が掛かっている場合やアクセス権限が無い場合，アンインストール時にメッセージKAVA1871-Eを出力してエラーになります。

システム環境変数JP1_BASE_UNINST_FORCEに1を設定する。

JP1/Baseをアンインストールする。

Windowsの［コントロールパネル］の［プログラムと機能］から「JP1/Base」をアンインストールしてください。

JP1/Baseを前提とする製品がインストールされている場合でもアンインストールが実行されます。

アンインストール時にJP1/Baseを除いた共通定義情報が，共通定義情報退避ファイルとして出力されます。

物理ホストの場合：Windowsのインストール先フォルダ¥Temp¥JP1_COMDEF¥comdef_JP1_DEFAULT.conf

論理ホストの場合：Windowsのインストール先フォルダ¥Temp¥JP1_COMDEF¥comdef_論理ホスト名.conf

環境変数JP1_BASE_UNINST_FORCEの設定を解除する。

システムを再起動する。

JP1/Baseの動作環境を無効にするために，システムを再起動してください。

ユーザーファイルを削除する。

JP1/Baseのファイルおよびフォルダをエクスプローラで削除してください。

JP1/Baseを再度インストールする。

インストールの詳細については，「3.2.1　インストール」を参照してください。

インストール先フォルダは変更できません。

JP1/Baseを再度セットアップする。

クラスタ運用している場合は論理ホストを作成してください。

論理ホスト名（大文字・小文字），ファイルフォルダは変更できません。

アダプタコマンド設定ファイル（インストール先フォルダ¥plugin¥conf¥*.conf）を手順1のバックアップからリカバリーしてください。

JP1/IM - Managerがインストールされている場合は，コマンド実行履歴ファイル（ISAM）を手順1のバックアップからリカバリーしてください。

イベントDBを手順1のバックアップからリカバリーしてください。イベントDBのリカバリーについては，「3.5.2(4)(a)　転送設定ファイルで他ホストにJP1イベントを転送していない場合のリカバリー手順」を参照して行ってください。

JP1/Baseの環境構築を行ってください。

JP1/Baseの環境をリカバリーする場合

JP1/Baseのその他定義ファイル，共通定義情報，jp1hosts2情報を手順1のバックアップからリカバリーしてください。

リカバリーの詳細については，「3.5.2(3)　設定情報のリカバリー」を参照してください。

JP1/Baseの環境を構築しなおす場合

JP1/Baseを再度セットアップしてください。

セットアップの詳細については，「3.4　セットアップ」を参照してください。

また，必要に応じてその他の設定を行ってください。

他製品のセットアップでJP1/Base の設定を行っている場合は，設定しなおしてください。

手順4で出力された共通定義情報退避ファイルを使用して，jbssetcnfコマンドを実行する。

JP1/Baseを除いたJP1製品の共通定義を復旧します。物理ホストおよびすべての論理ホストに対してコマンドを実行します。

jbssetcnf 共通定義情報退避ファイル名

手順4で出力された共通定義情報退避ファイルの出力先フォルダを削除する。

共通定義情報退避ファイルの出力先フォルダ（Windowsのインストール先フォルダ¥Temp¥JP1_COMDEF¥）を削除してください。

3.3　インストール（UNIXの場合）

この節では，UNIX版JP1/Baseのインストール，アンインストール，インストール・アンインストール時の注意事項，およびセットアップ前の作業について説明します。

3.3.1　インストール

JP1/Baseをインストールする手順を次に示します。

プログラムを終了する。

JP1/Baseをインストールする前に，JP1の全プログラム，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを終了してください。

Hitachi PP Installerを実行する。

Hitachi PP Installerの指示に従ってJP1/Baseをインストールしてください。Hitachi PP Installerの操作手順については，「3.3.2　Hitachi PP Installerの使用方法」を参照してください。

新規にインストールする場合だけ，自動でセットアップの初期設定が行われ，インストール完了後すぐにJP1/Baseを運用できるようになります。

自動セットアップで設定される項目を次の表に示します。

表3‒2　ユーザー管理機能に関する初期設定値

設定項目

内容

認証サーバの設定

認証サーバ名

自ホスト名

JP1ユーザーの設定

JP1ユーザー名

jp1admin

パスワード

jp1admin

JP1資源グループ

*

所有する権限

JP1_AJS_Admin，JP1_JPQ_Admin，JP1_AJSCF_Admin，JP1_CSA_Admin，JP1_HPS_Admin，JP1_PFM_Admin，JP1_Console_Admin，JP1_CF_Admin，JP1_CM_Admin，JP1_Rule_Admin，JP1_ITSLM_Admin，JP1_Audit_Admin，JP1_DM_Admin，JP1_SSO_Admin，Cosminexus_vMNG_Admin，HCS_UserMng_Admin，HCS_HDvM_Admin，HCS_HRpM_Admin，HCS_HTSM_Admin，HCS_HSNM2_Modify，HCS_HFSM_Admin，HCS_HCSM_Admin，HCS_HGLM_Admin，HCS_HTnM_Admin，JP1_AO_Admin，JP1_IMNP_Admin，UCNP_Admin，HNP_Admin，JP1_Analytics_Admin，JP1_ITDM_Admin，ISCF_Admin，JP1_IOTDM_Admin

ユーザーマッピングの設定

マッピングするJP1ユーザー名

jp1admin

JP1ユーザーが操作命令を出すサーバホスト名

*

JP1ユーザーとOSユーザーのマッピング

JP1ユーザー（jp1admin）と，各ホストに登録されているOSユーザー（root）をマッピングします。

各設定項目の詳細については，「8.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

Hitachi PP Installerを実行すると，統合トレース機能（HNTRLib2）もインストールされます。HNTRLib2のインストール先は，/opt/hitachi/HNTRLib2/です。

JP1/NETM/DM，JP1/IT Desktop Management 2およびJob Management Partner 1/Software Distributionを使ったリモートインストール（ソフトウェアの配布）について

JP1/Baseは，JP1/NETM/DM，JP1/IT Desktop Management 2およびJob Management Partner 1/Software Distributionを使ったリモートインストールに対応しています。JP1/Baseの場合，次に示すインストールに対応しています。

新規インストール

インストール対象ホストにJP1/Baseを新規にインストールできます。

バージョンアップインストール

リモートインストールすると，JP1/Baseインストール済みホストのJP1/Baseをバージョンアップできます。

実際の操作・運用方法については，JP1/NETM/DM，JP1/IT Desktop Management 2またはJob Management Partner 1/Software Distributionのマニュアルを参照してください。JP1/Baseをパッケージングする際は，必ずJP1/NETM/DM 09 -00 以降，Job Management Partner 1/Software Distribution 09 -00 以降，または JP1/IT Desktop Management 2のパッケージャを使用してください。なお，JP1/NETM/DMは日本でだけ販売している製品です。

3.3.2　Hitachi PP Installerの使用方法

Hitachi PP Installerは，JP1/Baseの提供媒体に格納されています。

Hitachi PP Installerを使用するときの注意事項

Hitachi PP Installerを使用するときはスーパーユーザー権限が必要です。スーパーユーザーでログインするか，またはsuコマンドでユーザーをスーパーユーザーに変更してください。

(1)　Hitachi PP Installerの起動

JP1/Baseをテープ媒体からインストールする場合

ドライブにJP1/Baseの提供媒体をセットする。

次のコマンドを実行して，Hitachi PP Installerを取り出す。

tar xf デバイスファイル名

次のコマンドを実行して，Hitachi PP Installerを起動する。

/etc/hitachi_setup -i デバイスファイル名

JP1/BaseをCD-ROM媒体からインストールする場合

ドライブにJP1/Baseの提供媒体をセットする。

ドライブ装置をマウントする。

次のコマンドを実行します。マウント方法は，ご使用のOS，ハードウェアおよび環境によって異なります。マウント方法の詳細はOSのマニュアルを参照してください。

AIXの場合：

/usr/sbin/mount -r -v cdrfs /dev/cd0 /cdrom

Linuxの場合：

/bin/mount -r -o mode=0544 /dev/cdrom /mnt/cdrom

注　太字のデバイススペシャルファイル名，および下線部の提供媒体ファイルシステムのマウントディレクトリ名は，環境によって異なりますので注意してください。

次のコマンドを実行して，Hitachi PP Installerをインストールおよび起動する。

/cdrom/XXXX/setup /mnt/cdrom

XXXXの部分は，ご使用のOSによって異なります。

なお，Linuxでは，自動的にマウントされるため，デバイススペシャル名の「/mnt/cdrom」には，自動的にマウントされたデバイススペシャル名を指定してください。

(2)　JP1/Baseのインストール

Hitachi PP Installerを使用して，JP1/Baseをインストールできます。Hitachi PP Installerを起動すると，初期画面が表示されます。表示される初期画面例を次の図に示します。

図3‒2　Hitachi PP Installerの初期画面例

初期画面で「I」を入力すると，インストールできるソフトウェアの一覧が表示されます。「JP1/Base」にカーソルを移動し，スペースバーで選択します。さらに「I」を入力すると，JP1/Baseがインストールされます。インストール完了後，「Q」を入力すると初期画面に戻ります。

(3)　JP1/Baseのアンインストール

Hitachi PP Installerを使用して，JP1/Baseをアンインストール（削除）できます。

次のコマンドを実行して，Hitachi PP Installerを起動します。

/etc/hitachi_setup

Hitachi PP Installerの初期画面が表示されます。初期画面については，「図3-2　Hitachi PP Installerの初期画面例」を参照してください。

初期画面で「D」を入力すると，削除できるソフトウェアの一覧が表示されます。「JP1/Base」にカーソルを移動し，スペースバーで選択します。さらに「D」を入力すると，JP1/Baseが削除されます。削除完了後，「Q」を入力すると，初期画面に戻ります。

(4)　バージョン情報の表示

Hitachi PP Installerを使用して，現在インストールされている日立製品のバージョンを確認できます。

次のコマンドを実行して，Hitachi PP Installerを起動します。

/etc/hitachi_setup

Hitachi PP Installerの初期画面が表示されます。初期画面については，「図3-2　Hitachi PP Installerの初期画面例」を参照してください。

初期画面で「L」を入力すると，インストール済みの日立製品の一覧が表示されます。

3.3.3　アンインストール

JP1/Baseをアンインストールする手順を次に示します。

プログラムを終了する。

JP1のプログラムをすべて終了してください。イベントサービスを利用しているプログラムもすべて終了してください。

JP1/AJS - Managerを使用している場合は，JP1/AJS Monitorサービスを終了してください。

Hitachi PP Installerを実行する。

Hitachi PP Installerの指示に従ってJP1/Baseをアンインストールしてください。アンインストールでは，JP1/Baseのインストールディレクトリ以下のユーザーファイルも削除されます。したがって，必要なファイルはバックアップをとってからアンインストールしてください。

JP1/Baseを前提とする製品がインストールされている場合，「Deletion failed.」と表示され，アンインストールに失敗します。その場合，次のJP1/Baseインストールログ（最新の更新日時のログファイル）にKAVA1870-Eメッセージが出力されていることを確認してください。

/tmp/HITACHI_JP1_INST_LOG/jp1base_inst{1|2|3|4|5}.log

対象のJP1製品をアンインストールしたあとに，Hitachi PP Installerの指示に従ってJP1/Baseをアンインストールしてください。

注意事項

JP1/Baseをアンインストールすると，HNTRLib2が自動的にアンインストールされます。ただし，HNTRLib2を利用するプログラムがほかにある場合は，そのプログラムがすべてアンインストールされた時点でHNTRLib2がアンインストールされます。

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

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

「Install failed」などと表示され，Hitachi PP Installerを使ったインストールが失敗した場合，/etc/.hitachi/.hitachi.logにログが出力されます。なお，このログファイルは，次にHitachi PP Installerを起動すると上書きされるので，必要に応じてバックアップをとってください。

また，/tmp/HITACHI_JP1_INST_LOGディレクトリ下にインストール時のログが出力されます。

インストール先のドライブは，ローカルディスクを使用してください。ネットワーク接続のディスク（NFS，NASなど）をマウントしインストールしないでください。

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

JP1/Baseを上書きインストールする場合は，JP1/BaseとJP1シリーズすべてのプログラム，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを必ず終了してください。

JP1/AJS - Managerを使用している場合は，JP1/AJS Monitorサービスを終了してください。

JP1/Baseを上書きインストールすると統合トレース機能（HNTRLib2）が停止します。このため，JP1/Baseを起動しても統合トレースログで情報の採取ができません。JP1/Baseを上書きインストールした場合は，統合トレース機能（HNTRLib2）が起動しているかpsコマンドを使って確認してください（hntr2monプロセスが稼働していれば起動しています）。統合トレース機能（HNTRLib2）が起動していなければ，hntr2monコマンドを使って起動してください。hntr2monコマンドの詳細については，「15.　コマンド」の「hntr2mon（UNIX限定）」を参照してください。

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

JP1/IM - Managerの場合

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

JP1/AJSの場合

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

JP1/AJS2 for Mainframeの場合

JP1/AJS2 for Mainframeもアンインストールしたあと，JP1/BaseおよびJP1/AJS2 for Mainframeを再インストールしてください。そのあと，JP1/BaseおよびJP1/AJS2 for Mainframeを再セットアップしてください。

JP1/Power Monitorの場合

JP1/Baseを再インストールしたあと，JP1/BaseおよびJP1/Power Monitorを再セットアップしてください。ただし，JP1/AJSとの連携セットアップや論理ホストのセットアップを実行していない場合は，JP1/Power Monitorを再セットアップする必要はありません。

JP1/Baseを前提とする製品をアンインストールしないでJP1/Baseを強制的にアンインストールしたあと，再インストールする場合は，退避されたJP1/Base以外の共通定義情報を復旧する必要があります。退避した共通定義情報の復旧手順については，「(8)　JP1/Baseを前提とするJP1製品の共通定義情報の復旧手順」を参照してください。

(3)　OS環境への設定

JP1/Baseのインストール時に，/etc/servicesファイルに「付録C　ポート番号一覧」に示すポート番号が設定されます。これらの設定情報は，JP1/Baseのアンインストールで削除されます。

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

JP1/Baseのアンインストール後は，次に示すディレクトリが残っていないか確認し，残っている場合は削除してください。

/etc/opt/jp1base

/opt/jp1base

/var/opt/jp1base

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

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

/tmp/HITACHI_JP1_INST_LOG/jp1base_inst{1|2|3|4|5}.log

servicesファイルに設定したサービス名jesrdのポート番号は削除されません。不要であれば，削除してください。

次の製品がインストールされている場合，メッセージKAVA1870-Eを出力してアンインストールできません。

JP1/AJS3 - Manager

JP1/AJS3 - Agent

JP1/AJS3 - Agent Minimal Edition

JP1/AJS3 - WOA

JP1/Power Monitor

JP1/IM2 - Manager

JP1/IM2 - View

JP1/IM2 - EG

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

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

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

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

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

jevdbmkrepコマンドを実行する。

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

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

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

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

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

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

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

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

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

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

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

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

JP1/Baseを上書きインストールする場合は，JP1/BaseとJP1シリーズすべてのプログラム，およびJP1/Baseのイベントサービスを利用しているすべてのプログラムを必ず終了してください。

JP1/AJS - Managerを使用している場合は，JP1/AJS Monitorサービスを終了してください。

12-10以降では，物理ホストのイベントサーバをFQDN名で運用している場合に，JP1イベント取得関数を使用するときは，イベントサーバインデックスファイルにイベントサーバ名「*」（自ホスト名のイベントサーバ名）の定義を追加してください。定義をしない場合，JP1イベント取得に失敗します。

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

12-50以前のJP1/Baseに13-00以降のJP1/Baseを上書きインストールすると，JP1/SESイベントを使用する製品と連携するための機能で使用するファイルおよびディレクトリが残ったままになります。これらのファイルおよびディレクトリはJP1/Baseの動作に影響がありません。

(6)　ディスク複製インストール時の注意事項（Linux限定）

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

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

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

(a)　複製前の注意事項

イベントサービスの動作環境の設定

イベントサーバインデックスファイル，イベントサーバ設定ファイルおよびAPI設定ファイルの各パラメーターにIPアドレスやホスト名，イベントサーバ名は設定しないでください。

システム構成の定義情報削除

複製先のホストをJP1/IMのシステム構成配下に定義する場合には，すでに設定されている構成定義情報をjbsrt_delコマンドで削除してください。

(b)　複製後の注意事項

イベントデータベースの初期化

ディスク複製インストール時に，内部的に生成されたホスト名でリブートされることで，イベントデータベースにJP1イベントが残ることがあります。運用を始める前にイベントデータベースを初期化してください。

ディスク複製インストールの操作・運用方法については，JP1/ServerConductor/Deployment ManagerおよびHitachi Compute Systems Manager Deployment Manager Plug-inのユーザーズガイドを参照してください。仮想化プラットフォームの複製機能については，仮想化ソフトウェアのマニュアルを参照してください。

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

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

実行コマンド

AIXの場合：

提供媒体/AIX/setup -f -k 製品形名 提供媒体のパス

Linuxの場合：

提供媒体/X64LIN/setup -f -k 製品形名 提供媒体のパス

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

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

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

(8)　JP1/Baseを前提とするJP1製品の共通定義情報の復旧手順

JP1/Baseを前提とするJP1製品をアンインストールしないで，JP1/Baseを再インストールする場合に，共通定義情報を復旧する手順を次に示します。

なお，復旧手順の実施中は，JP1/BaseサービスやJP1製品のサービスを起動しないでください。

また，共通定義情報の復旧手順を誤った場合に備えて，次のコマンドを実行して全てのJP1製品の共通定義情報をバックアップしてください。

物理ホストの場合

jbsgetcnf > バックアップファイル名

論理ホストの場合

jbsgetcnf -h 論理ホスト名 > バックアップファイル名

JP1/Baseをバックアップする。

バックアップの詳細については，「3.5.3　バックアップとリカバリー（UNIXの場合）」を参照してください。

JP1/IM - Manager がインストールされている場合は，コマンド実行履歴ファイル （ISAM）のバックアップを行ってください。コマンド実行履歴ファイル（ISAM）のバックアップについては，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」（データベースのバックアップおよびリカバリー）を参照してください。

統合トレースログが削除される場合があるため，復旧手順実施前のログを採取してください。ログの採取方法については「18.4　資料の採取方法」を参照してください。

共通定義情報退避ファイルの出力先を確認する。

共通定義情報退避ファイルの出力先（/tmp/）の空きディスク容量が十分（1＋0.4×論理ホスト数［MB］以上）あること，エディタ等で共通定義情報退避ファイル出力先ディレクトリやファイルの排他を掛けていないこと，アクセス権限があることを確認してください。

空きディスク容量が無い場合，共通定義情報退避ファイルのファイルサイズが0byteになるなど，正しく出力されません。

排他が掛かっている場合やアクセス権限が無い場合，アンインストール時にメッセージKAVA1871-Eを出力してエラーになります。

次の環境変数を設定する。

# JP1_BASE_UNINST_FORCE=1

# export JP1_BASE_UNINST_FORCE

JP1/Baseをアンインストールする。

「3.3.3　アンインストール」を参照し，Hitachi PP Installerの指示に従ってJP1/Baseをアンインストールしてください。

JP1/Baseを前提とする製品がインストールされている場合でもアンインストールが実行されます。

アンインストール時にJP1/Baseを除いた共通定義情報が，共通定義情報退避ファイルとして出力されます。

物理ホストの場合：/tmp/JP1_COMDEF/comdef_JP1_DEFAULT.conf

論理ホストの場合：/tmp/JP1_COMDEF/comdef_論理ホスト名.conf

環境変数JP1_BASE_UNINST_FORCEの設定を解除する。

JP1/Baseを再度インストールする。

インストールの詳細については，「3.3.1　インストール」を参照してください。

JP1/Baseを再度セットアップする。

クラスタ運用している場合は論理ホストを作成してください。

論理ホスト名（大文字・小文字），共有ディレクトリは変更できません。

アダプタコマンド設定ファイル（/opt/jp1base/plugin/conf/*.conf）を手順1のバックアップからリカバリーしてください。

JP1/IM - Managerがインストールされている場合は，コマンド実行履歴ファイル（ISAM）を手順1のバックアップからリカバリーしてください。

イベントDBを手順1のバックアップからリカバリーしてください。イベントDBのリカバリーについては，「3.5.3(4)(a)　転送設定ファイルで他ホストにJP1イベントを転送していない場合のリカバリー手順」を参照して行ってください。

JP1/Baseの環境構築を行ってください。

JP1/Baseの環境をリカバリーする場合

JP1/Baseのその他定義ファイル，共通定義情報，jp1hosts2情報を手順1のバックアップからリカバリーしてください。

リカバリーの詳細については，「3.5.3(3)　設定情報のリカバリー」を参照してください。

JP1/Baseの環境を構築しなおす場合

JP1/Baseを再度セットアップしてください。

セットアップの詳細については，「3.4　セットアップ」を参照してください。

また，必要に応じてその他の設定を行ってください。

他製品のセットアップでJP1/Baseの設定を行っている場合は，設定しなおしてください。

手順4で出力された共通定義情報退避ファイルを使用して，jbssetcnfコマンドを実行する。

JP1/Baseを除いたJP1製品の共通定義を復旧します。物理ホストおよびすべての論理ホストに対してコマンドを実行します。

jbssetcnf 共通定義情報退避ファイル名

手順4で出力された共通定義情報退避ファイルの出力先ディレクトリを削除する。

共通定義情報退避ファイルの出力先ディレクトリ（/tmp/JP1_COMDEF/）を削除してください。

(9)　Linuxで運用する場合のbig timestampsの有効化について

Linuxのxfsファイルシステムは，big timestamps※を有効化することで，2038年以降も使用できます。デフォルトでは無効になっているため，2038年1月19日3時14分7秒（UTC）までに，使用するOSのマニュアルを参照して，big timestampsを有効化した上で運用してください。

注※

inodeのタイムスタンプとクオータ有効期限のタイプスタンプのデータサイズを拡大する設定です。

3.4　セットアップ

3.4.1　使用する言語種別を設定する（Windowsの場合）

新規インストールの場合，インストール時のロケール（システムロケール）に合わせて，JP1/Baseの言語環境が設定されます。ロケール（システムロケール）ごとに設定されるJP1/Baseの言語環境を次の表に示します。

表3‒3　ロケール（システムロケール）ごとに設定されるJP1/Baseの言語環境

ロケール（システムロケール）

言語環境

日本語

日本語

中国語

中国語

日本語または中国語以外

英語

インストール後にロケール（システムロケール）を変更する場合は，次の表に示す文字コードの設定が必要になります。

表3‒4　Windowsの文字コード

OS

言語種別

文字コード

Windows

日本語

SJIS

中国語

GB18030

英語

C

(1)　文字コードの設定手順

jp1bs_param.confを編集する。

インストール先フォルダ¥conf¥jp1bs_param.confファイルをエディターで開き，"LANG"="文字コード"の文字コードの部分に，表3-4で示した文字コードの値を設定してください。

ファイルを保存したあと，Administrators権限で次に示すコマンドを実行する。

インストール先フォルダ¥bin¥jbssetcnf インストール先フォルダ¥conf¥jp1bs_param.conf

JP1/Baseを起動または再起動する。

設定はJP1/Baseの起動時に有効になります。JP1/Baseが起動済みの場合は，再起動してください。

3.4.2　使用する言語種別を設定する（UNIXの場合）

言語種別を環境変数LANGで設定します。

JP1/Baseの動作する言語種別を，次のように設定してください。

同一ホスト内で動作するJP1/Baseを前提とする製品（JP1/IMやJP1/AJS）の文字コードは，JP1/Baseと統一してください。

UTF-8ロケール環境でJP1/Baseを動作させる場合には，システムを次のどちらかに整える必要があります。

システム上のすべてのJP1/Baseをバージョン8以降にし，JP1/Baseを前提とする製品はUTF-8コードに対応したバージョンにしてください。

バージョン7のJP1/Baseがシステム内に混在する場合は，UTF-8ロケール環境で発行されたJP1イベントを正しく処理できません。この場合，UTF-8ロケール環境のJP1/Baseをバージョン8以降にし，JP1/Baseを文字コード互換モードで動作するように設定する必要があります。

自動起動および自動終了の設定は，インストール時の環境変数LANGに設定されている文字コードに合わせて設定されます。ただし，表3-5で示した文字コード以外が設定されている場合は，環境変数LANGにCを設定します。必要に応じて変更してください。

次に示すような場合，自動起動スクリプトの環境変数LANGの言語種別を日本語にする必要があります。

転送設定ファイル（forward）のイベントフィルターに日本語を指定する場合

ユーザープログラム内でJP1イベント取得関数（JevGetOpen）のlpszFilterパラメーターに日本語を指定する場合

JP1/IMを使用してJP1/IMの各種フィルターに日本語を指定する場合※

注※　言語種別の設定が必要なサーバの条件については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

各OSで使用できる文字コードと環境変数LANGの値を次の表に示します。

表3‒5　UNIXの文字コードおよび環境変数LANGの値

OS

言語種別

文字コード

環境変数LANGの値

AIX

日本語

SJIS

Ja_JP.IBM-932またはJa_JP

EUCJIS

ja_JP.IBM-eucJPまたはja_JP

UTF-8

JA_JP.UTF-8，JA_JP，またはja_JP.UTF-8

中国語

GB18030

Zh_CNまたはZh_CN.GB18030

UTF-8※1

ZH_CNまたはZH_CN.UTF-8

英語

C

C

Linux

日本語

SJIS※²

ja_JP.SJISまたはja_JP.sjis

EUCJIS

使用不可

UTF-8

ja_JP.UTF-8またはja_JP.utf8

中国語

GB18030

zh_CN.GB18030またはzh_CN.gb18030

UTF-8

zh_CN.UTF-8またはzh_CN.utf8

英語

UTF-8※3

en_US.UTF-8またはen_US.utf8

C

C

注※1　ログファイルトラップ機能にだけ対応しています。ログファイルトラップで，UTF-8で出力されたログを監視できます。

注※2　SUSE Linuxの場合だけ有効です。

注※3　JP1/Base 13-00より前のバージョンからバージョンアップインストールする場合，Linuxの英語のUTF-8を適用するには，バージョンアップインストール後に，文字コードと言語種別のマッピング定義の変更が必要です。詳細については，「(3)　バージョンアップインストール後の文字コードと言語種別のマッピング定義の変更」を参照してください。

(1)　言語種別の設定手順

jp1bs_env.confを編集する。

/etc/opt/jp1base/conf/jp1bs_env.confファイルをエディターで開き，表3-5で示した環境変数LANGの値を設定します。この定義は，JP1/Baseの次回起動時から有効となります。

jp1bs_param.confを編集する。

"LANG"="文字コード"の文字コードの部分に，表3-5で示した文字コードの値を設定してください。

ファイルを保存したあと，スーパーユーザー権限またはJP1/Base管理者権限で次に示すコマンドを実行する。

/opt/jp1base/bin/jbssetcnf /etc/opt/jp1base/conf/jp1bs_param.conf

自動起動スクリプト（jbs_start）を編集する。

自動起動スクリプト（jbs_start）を使用する場合は，環境変数LANGに手順1で設定したjp1bs_env.confの言語種別と同じ値を設定してください。

イベントサービスを自動起動スクリプト（jbs_start）ではなく手動で起動する場合，イベントサービス起動時のロケール情報（環境変数LANGなど）を，jp1bs_env.confの言語種別と合わせてください。

例えば，jp1bs_env.confの言語種別にja_JP.UTF-8を設定した場合，自動起動スクリプト（jbs_start）の環境変数LANGを，次のように変更してください。

## Set Environment-variables
PATH=/sbin:/bin:/usr/bin:/opt/jp1base/bin
LANG=ja_JP.UTF-8
SHLIB_PATH=/opt/jp1base/lib:/opt/hitachi/common/lib

JP1/Baseをクラスタシステムで実行する場合は，同様にjbs_start.clusterの環境変数LANGの値を，論理ホストのjp1bs_env.confの言語種別と同じ値に変更してください。

JP1/Baseを起動または再起動する。

設定はJP1/Baseの起動時に有効になります。JP1/Baseが起動済みの場合は，再起動してください。

(2)　文字コード互換モードの設定手順

モデルファイル（jbslm_setup.conf.model）をコピーして，jbslm_setup.confを作成する。

jbslm_setup.conf.modelの格納先

/etc/opt/jp1base/conf/

指定するパラメーター

パラメーターの形式を次に示します。

[JP1_DEFAULT¥JP1BASE¥]

"LANG_MODE"=dword:{00000000 | 00000001}

0：文字コード互換モードで動作しない。

1：文字コード互換モードで動作する。日本語UTF-8コードから日本語EUCコードへ変換する。

論理ホストの場合，JP1_DEFAULTを論理ホスト名に置き換えてください。

jbssetcnfコマンドを実行する。

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

JP1/Baseを起動または再起動する。

設定はJP1/Baseの起動時に有効になります。JP1/Baseが起動済みの場合は，再起動してください。

(3)　バージョンアップインストール後の文字コードと言語種別のマッピング定義の変更

JP1/Base 13-00では，Linuxの文字コードおよび言語種別のマッピング定義に，英語のUTF-8を追加しています。

JP1/Base 13-00より前のバージョンからバージョンアップインストールする場合，文字コードおよび言語種別のマッピング定義については，バージョンアップ前の定義を維持するため，バージョンアップインストール後に，JP1/Base 13-00で追加した文字コードと言語種別のマッピング定義を適用する場合は，次の手順を実施してください。

モデルファイル（eventenc.dat.model，eventlng.dat.model）をコピーして，eventenc.dat，eventlng.datを作成する。

次のコマンドを実行して，各定義ファイルを変更してください。

文字コードマッピング定義ファイルの変更

cp -p /opt/jp1base/lib/eventenc.dat.model /opt/jp1base/lib/eventenc.dat

言語種別マッピング定義ファイルの変更

cp -p /opt/jp1base/lib/eventlng.dat.model /opt/jp1base/lib/eventlng.dat

JP1/Baseサービス，イベントサービス，ログファイルトラップ管理サービスを起動または再起動する。

設定は各サービスの起動時に有効になります。起動済みの場合は，再起動してください。

3.4.3　簡体字中国語の環境で運用するための注意事項

(1)　文字コードGB18030に関する制限

中国語の文字コードは，GB18030-2000に対応しています。JP1/Baseの入力項目ごとに，指定できるGB18030の文字コードの範囲が異なります。

項番

入力項目

GB18030の文字コード範囲

1バイト

（ASCII）

2バイト

（GBK）

4バイト

（Unicode）

1

ホスト名（物理ホスト名・論理ホスト名）

○

×

×

2

OSアカウント（ドメイン名・ユーザ名）

○

×

×

3

ファイルのパス

○

×

×※1

4

コマンドライン

○

×

×※1

5

共通定義情報の定義名および値

○

×

×

6

定義ファイルの記述内容※2

○

○

○

7

監視対象ログの内容

○

○

○

8

JP1イベントの属性（メッセージ・拡張属性）

○

○

○

（凡例）

○：文字コードに対応している

×：文字コードに対応していない

注※1　4バイト（Unicode）が指定された場合，半角の?に置換されます。

注※2　定義ファイル内に記述するファイルのパス/コマンドラインは，項番3および項番4と同じ文字コードの範囲になります。

(2)　Unicodeに関する制限

Unicode（4バイトのGB18030またはUTF-8）の文字列中に含まれる文字コードについては，基本多言語面（Basic Multilingual Plane）の範囲だけを保証します。

Unicode（4バイトのGB18030またはUTF-8）の文字列中にサロゲートペアが含まれる場合，正規表現の結果が意図しないものになることがあります。

(3)　機能仕様の注意事項

(a)　イベントサービス

イベントフィルターの正規表現

Windowsでは，正規表現は拡張正規表現が適用されます。拡張正規表現の文法で指定してください。

UNIXでは，正規表現は設定された定義が適用されます。

JP1イベントの登録

登録されるJP1イベントは，文字コードがUTF-8で登録されます。基本属性のコードセットには，"UTF-8"が設定されます。

基本属性のメッセージには長さの制限（1023バイト）があるため，UTF-8に変換した結果，上限値を超えた場合，超過分は切り捨てられます。この場合，KAJP1082-Wのメッセージがログに出力されます。

jevexportコマンド

-lオプションに指定するコードセット名として，「GB18030」が指定できます。

-lオプションに「GB18030」を指定して，-aオプションが指定された場合，見出し行には英語で出力されます。

(b)　ログファイルトラップ

既存の機能と同様に中国語（簡体字）で出力されるログファイルを監視できます。

動作定義ファイルの正規表現

Windowsでは，正規表現は拡張正規表現が適用されます。拡張正規表現の文法で指定してください。

UNIXでは，正規表現は設定された定義が適用されます。

JP1イベントの登録

登録されるJP1イベントは，文字コードがUTF-8で登録されます。基本属性のコードセットには，「UTF-8」が設定されます。

(c)　イベントログトラップ（Windows限定）

中国語（簡体字）の環境では，Unicodeによる監視ができます。

動作定義ファイルの正規表現

正規表現は拡張正規表現が適用されます。拡張正規表現の文法で指定してください。

JP1イベントの登録

登録されるJP1イベントは，文字コードがUTF-8で登録されます。基本属性のコードセットには，「UTF-8」が設定されます。

(d)　ローカルアクション

実行定義ファイルの正規表現

Windowsでは，正規表現は拡張正規表現が適用されます。拡張正規表現の文法で指定してください。

UNIXでは，正規表現は設定された定義が適用されます。

3.4.4　カーネルパラメーターを調整する（UNIX限定）

カーネルパラメーターを調整し，JP1/Baseの実行に必要なリソースを割り当ててください。調整が必要なカーネルパラメーターはOSごとに異なります。

詳細については，「付録G　カーネルパラメーター一覧」を参照してください。

カーネルパラメーターとは，UNIXシステムが使用するリソースを調整して最適化するための設定です。次のような値を調整します。

ファイルシステムの調整：ファイルの最大オープン数，ファイルの最大ロック数

共用メモリーの調整：共用メモリーの最大サイズ，共用メモリーの最大数

セマフォの調整：セマフォの最大数，セマフォの最大アンドゥ数

カーネルパラメーターについての詳しい説明は，各OSのマニュアルやUNIXの参考文献を参照してください。

3.4.5　使用する正規表現を拡張する

JP1/Baseでは，上位ホストに転送するJP1イベントのイベントフィルターや，JP1イベントに変換したいWindowsのイベントログやアプリケーションログのフィルター条件などで正規表現を使用できます。

初期設定では，次の正規表現を使用できます。

表3‒6　初期設定で使用できる正規表現

OS

使用できる正規表現

Windows

JP1独自の正規表現

UNIX

各OSが提供する基本正規表現

JP1/Baseの正規表現に従って動作するプログラムおよび定義ファイルは次のとおりです。

転送設定ファイル（forward）で指定するイベントフィルター

イベントログトラップ動作定義ファイル（ntevent.conf），ログファイルトラップ動作定義ファイルで指定するフィルター部分

jevexportコマンドで使用するフィルターファイル

ローカルアクション実行定義ファイルで指定するイベントフィルター

JP1/IM - ViewからのJP1イベントの検索※1

JP1/BaseのイベントサーバからJP1イベントを取得する関数（JevGetOpen）のイベントフィルター部分※2

拡張属性マッピング設定ファイルのイベントフィルター部分

注※1　JP1/IM - ViewからのJP1イベント検索時には，検索先ホストのJP1/Baseの正規表現の設定に準じます。

注※2　これらの設定方法については，マニュアル「JP1/Base 関数リファレンス」を参照してください。

07-00以降のJP1/Baseでは，初期設定の正規表現を拡張できます。正規表現を拡張すると，WindowsとUNIXで共通の正規表現を使えるようになります。使用できる正規表現を次の表に示します。

表3‒7　正規表現を拡張した場合に使用できる正規表現

OS

使用できる正規表現

Windows

XPG4の拡張正規表現の文法に準拠する。

UNIX

AIXの場合はXPG4の拡張正規表現の文法に準拠する。

Linuxの場合はPOSIX1003.2の拡張正規表現の文法に準拠する。

各OSによって文法が異なることがあるため，詳細については，各正規表現の文法（regexpまたはregex）を参照のこと。

正規表現のうち，使用頻度が高そうな正規表現の文法と使用例を「付録F　正規表現の文法」に記載しています。正規表現を使用する際の参考にしてください。

(1)　設定方法

正規表現を拡張するための設定手順を次に示します。クラスタシステムで運用している場合は，実行系・待機系の両方で設定してください。

定義ファイルを任意の名称で作成する。

定義ファイルに以下の内容を定義します。

[JP1_DEFAULT¥JP1BASE¥]
"REGEXP"="EXTENDED"

クラスタシステムで運用している場合は，[JP1_DEFAULT¥JP1BASE¥]のJP1_DEFAULTの部分に論理ホスト名を指定します。

jbssetcnfコマンドを実行する。

jbssetcnf 定義ファイル名

設定内容が共通定義情報に反映されます。

初期設定の正規表現に戻す場合も，上記と同じ手順で設定します。定義ファイルには次のように定義してください。

[JP1_DEFAULT¥JP1BASE¥]
"REGEXP"=""

(2)　設定の有効契機

正規表現の設定が，JP1/Baseの正規表現の設定に従う機能で有効となる契機を次の表に示します。

機能

設定の有効契機

JP1イベントの転送

イベントサービスの起動時。

jevexportコマンド

jevexportコマンド実行時。

ローカルアクション

ローカルアクション起動時。

JP1/IM - Viewからのイベント検索

接続先イベントサーバのイベントサービス起動時。

JP1/BaseのイベントサーバからJP1イベントを取得する関数（JevGetOpen）

接続先イベントサーバのイベントサービス起動時。

イベントログトラップ

イベントログトラップサービスのサービス起動時。物理ホストの設定に準じる。

ログファイルトラップ

ログファイルトラップ管理サービス（デーモン）のサービス（デーモン）起動時。物理ホストの設定に準じる。

3.4.6　パスワード保管形式の設定

パスワードの保管形式をハッシュレベル1モードからハッシュレベル2モードに変更すると，パスワードの保護を強化できます。なお，バージョンが12-00以降のJP1/Baseを新規インストールすると，パスワード保管形式はハッシュレベル2モードに設定されます。11-50以前のバージョンから12-00以降のバージョンにJP1/Baseを上書きインストールし，かつ共通定義情報にパスワード保管形式を設定していない場合，パスワードの保管形式はハッシュレベル1モードに設定されています。上書きインストール前に登録されたパスワードを継続して使用する場合は，引き継がれたパスワード保管形式の状態で使用してください。パスワードの保護を強化したい場合は，パスワード保管形式を変更する手順に従ってパスワード保管形式をハッシュレベル2モードに変更してください。認証サーバのホスト以外のホストでは，パスワード保管形式の設定は不要です。また，ディレクトリサーバとの連携ユーザーは，パスワード保管形式の設定の影響を受けません。

パスワードの保管形式を変更する場合は，次の点に注意してください。

認証サーバに登録していたJP1ユーザー（ディレクトリサーバとの連携ユーザーを除く）は，パスワード保管形式の変更後に，削除および再登録が必要です。再登録するまでは，ユーザー認証およびパスワードの変更ができません。

プライマリー認証サーバおよびセカンダリー認証サーバは，必ずパスワードの保管形式を合わせてください。

パスワードの保管形式がハッシュレベル2モードである場合に，認証サーバのホスト以外のホストからコマンドでJP1ユーザーを設定するには，コマンドを実行するホストのJP1/Baseのバージョンが09-50以降である必要があります。09-10以前のバージョンのホストから，jbsadduserコマンドを実行した場合はメッセージKAVA5023-Eを，jbschgpasswdコマンドを実行した場合はメッセージKAVA5223-Eを出力して，各コマンドが異常終了します。

パスワードの保管形式を変更する手順を次に示します。

プライマリー認証サーバに，次の内容の定義ファイルを作成する。

ファイル名は任意です。

[JP1_DEFAULT¥JP1BASE¥]
"HASH_LEVEL"=dword:{00000001|00000002}

1：ハッシュレベル1モードで動作する。

2：ハッシュレベル2モードで動作する。

論理ホストの場合，JP1_DEFAULTを論理ホスト名に置き換えてください。

jbssetcnfコマンドを実行する。

jbssetcnf 定義ファイル名

作成した定義ファイルの内容が，プライマリー認証サーバの共通定義情報に反映されます。

プライマリー認証サーバを起動する。

jbsrmuserコマンドを実行する。

認証サーバに登録されているJP1ユーザーのうち，ディレクトリサーバと連携しない全JP1ユーザーを削除します。アクセス権限の削除は不要です。

削除したJP1ユーザーを再登録する。

手順4で削除したJP1ユーザーをすべて再登録します。

プライマリー認証サーバの設定情報を，セカンダリー認証サーバにコピーする。

詳細については，「8.1.4　プライマリー認証サーバの設定情報をコピーする」または「8.3.4　プライマリー認証サーバの設定情報をコピーする」を参照してください。

セカンダリー認証サーバに，定義ファイルを作成する。

ファイル名は任意です。また，パラメーターの形式は手順1と同じです。

なお，プライマリー認証サーバとセカンダリー認証サーバがともに物理ホストの場合は，手順2で使用した定義ファイルをセカンダリー認証サーバにコピーして使用できます。それ以外の場合は，プライマリー認証サーバとセカンダリー認証サーバで個別に定義ファイルを作成してください。

jbssetcnfコマンドを実行する。

jbssetcnf 定義ファイル名

手順7で作成した定義ファイル，またはプライマリー認証サーバからコピーした定義ファイルの内容が，セカンダリー認証サーバの共通定義情報に反映されます。

セカンダリー認証サーバを起動する。

パスワードの保管形式が変更されます。

3.4.7　パスワードポリシーを設定する

JP1ユーザーの登録およびJP1ユーザーのパスワード変更時に，チェックするパスワードポリシーを設定します。パスワードポリシーの詳細については，「2.1.1(3)　パスワードポリシーによる管理」を参照してください。

パスワードポリシーを設定する手順を次に示します。

(1)　共通定義情報のバックアップ

パスワードポリシーの設定は共通定義情報を変更するため，パスワードポリシーの設定前に共通定義情報をバックアップします。

共通定義情報のバックアップは，次のコマンドを実行してJP1/Baseの共通定義情報だけを取得してください。

jbsgetcnf -c JP1BASE > 退避ファイル

クラスタ運用している場合は，次のコマンドを実行してJP1/Baseの共通定義情報だけを取得してください。

jbsgetcnf -h 論理ホスト名 -c JP1BASE > 退避ファイル

(2)　パスワードポリシーの設定

プライマリー認証サーバでパスワードポリシーの設定手順を次に示します。

パスワードポリシー定義ファイルを編集する。

jp1bs_passwdpolc.confファイルは，インストール時にjp1bs_passwdpolc.conf.modelファイルからコピーされます。

Windowsの場合

インストール先フォルダ¥conf¥passwdpolc¥jp1bs_passwdpolc.conf

共有フォルダ¥jp1base¥conf¥passwdpolc¥jp1bs_passwdpolc.conf（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/passwdpolc/jp1bs_passwdpolc.conf

共有ディレクトリ/jp1base/conf/passwdpolc/jp1bs_passwdpolc.conf（クラスタ運用時）

パスワードポリシー定義ファイルのパラメータの値を設定します。パスワードポリシー定義ファイルの詳細は，「16.　定義ファイル」の「パスワードポリシー定義ファイル」を参照してください。

jp1bs_passwdpolc.confファイルの指定例

[JP1_DEFAULT¥JP1BASE¥PASSWDPOLC]
"ENABLE"=dword:0000001
"PASSWD_LEN_MIN"=dword:00000010
"NUM_OF_CHAR_TYPE_MIN"=dword:00000003
"REQ_CHAR_TYPE"="NUM,UPPER,SYMBOL"

jbssetcnfコマンドを実行する。

jbssetcnf パスワードポリシー定義ファイル

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

JP1/Baseを起動または再起動する。

設定はJP1/Baseの起動時に有効になります。JP1/Baseが起動済みの場合は，再起動してください。

セカンダリー認証サーバでも，プライマリー認証サーバと同様にパスワードポリシー定義をセカンダリー認証サーバにコピーして設定してください。

注意事項

セカンダリー認証サーバを設置する場合，プライマリー認証サーバとセカンダリー認証サーバで設定するパスワードポリシー定義を同じにする必要があります。

パスワードポリシーの設定を変更した場合，変更前に登録したパスワードについては，次の手順で変更後のポリシーに則するパスワードに変更してください。

JP1ユーザーの一覧（JP1ユーザーごとの最終更新日付（yyyy/mm/dd△HH:MM:SS形式））を取得する。

認証サーバが起動していることを確認後，次に示すコマンドを実行する。

jbslistuser -ld

更新日付がパスワードポリシー設定前のJP1ユーザーを対象にパスワードを変更する。

3.4.8　SUSE Linux 15以降で運用する場合のsyslog出力について

このマニュアルでは，UNIXのOSのログ情報はsyslogに出力されることを前提としています。しかし，SUSE Linux 15以降の場合，デフォルトでは，syslog（テキストファイル）にはログが出力されず，ジャーナルと呼ばれるログファイルに出力されます。

従来と同様に，OSのログ情報をsyslogに出力して運用する必要がある場合は，次の手順でジャーナルに出力されるログをsyslogに転送するようにしてください。

次のrsyslogパッケージをインストールする。

rsyslog-8.33.1-x.xx.x86_64

syslogへの転送が有効化されていることを確認する。

/etc/systemd/journald.confファイルを開いて，次の設定になっていることを確認します。

ForwardToSyslog=yes※

注※　コメントアウトされている場合，デフォルトのyesが適用されます。

rsyslogを起動する。

systemctl start rsyslog

3.5　バックアップとリカバリー

システム全体のバックアップ計画の一環として，JP1/Baseのバックアップ・リカバリーを検討してください。

3.5.1　バックアップとリカバリーの検討

万一システムが壊れた場合，同じ環境のシステムを構築して運用再開するために，JP1/Baseの設定情報およびイベントDBをバックアップしてください。

JP1/Baseの設定情報のバックアップは，JP1/Baseをセットアップしたときなど，システムを変更したときに取得してください。

なお，JP1/Baseのバックアップ・リカバリーは，運用を停止しているときに実施するようにしてください。

上位プログラムがJP1/Baseの運用中にバックアップする場合は，イベントDBを障害レポートとしてバックアップを取得することをお勧めします。上位プログラムのバックアップ中にJP1イベントの発行タイミングによっては，上位プログラムがイベント情報を参照できず，正しくバックアップできない場合があります。イベントDBを障害レポートとしてバックアップすると，リカバリーをしたあとにバックアップ時の状態を確認することができます。

3.5.2　バックアップとリカバリー（Windowsの場合）

(1)　設定情報のバックアップ

JP1/Baseの設定情報には以下のものがあります。

定義ファイル

共通定義情報

jp1hosts2情報

クラスタ運用している場合は，物理ホスト，論理ホストの順番で，各環境をバックアップしてください。

(a)　定義ファイルのバックアップ

JP1/Baseでは，ユーザーが設定する定義ファイルとして以下のファイルがあります。ファイルをコピーするなど任意の方法で，これらのファイルをバックアップしてください。

表3‒8　JP1/Baseのバックアップ対象ファイル

ファイル名

内容

JP1/Baseフォルダ※1¥boot¥JP1SVPRM.DAT

起動順序定義ファイル

JP1/Baseフォルダ※1¥boot¥jp1svprm_wait.dat

サービス起動遅延時間／タイマー監視時間定義ファイル※2

JP1/Baseフォルダ※1¥jp1bs_env.conf

JP1/Base環境定義ファイル

JP1/Baseフォルダ※1¥jp1bs_param.conf

JP1/Baseフォルダ※1¥jp1bs_param_V7.conf

JP1/Baseパラメーター定義ファイル

JP1/Baseフォルダ※1¥jp1bs_spmd.conf

JP1/Baseプロセス管理定義ファイル

JP1/Baseフォルダ※1¥jp1bs_service_0700.conf

拡張起動プロセス定義ファイル

JP1/Baseフォルダ※1¥route¥以下のファイル

構成定義ファイル

（JP1/IMで使用）

JP1/Baseフォルダ※1¥user_acl¥JP1_Passwd

JP1ユーザー定義ファイル

JP1/Baseフォルダ※1¥user_acl¥JP1_Group

JP1グループ定義ファイル

JP1/Baseフォルダ※1¥user_acl¥JP1_UserLevel

ユーザー権限レベルファイル

JP1/Baseフォルダ※1¥user_acl¥JP1_AccessLevel

JP1資源グループ定義ファイル

JP1/Baseフォルダ※1¥user_acl¥JP1_Accountaccess

JP1アカウントアクセス情報ファイル

JP1/Baseフォルダ※1¥user_acl¥jp1BsUmap.conf

ユーザーマッピング定義ファイル

JP1/Baseフォルダ※1¥passwdpolc¥jp1bs_passwdpolc.conf

パスワードポリシー定義ファイル

JP1/Baseフォルダ※1¥ds¥jp1bs_ds_setup.conf

ディレクトリサーバ連携定義ファイル

インストール先フォルダ¥conf¥event¥index

イベントサーバインデックスファイル

Eventフォルダ※3¥conf

イベントサーバ設定ファイル

Eventフォルダ※3¥forward

転送設定ファイル

インストール先フォルダ¥suppress¥forward_suppress

イベント転送抑止用の転送設定ファイル

Eventフォルダ※3¥[recv_add_extattr | send_add_extattr]

属性付加設定ファイル

インストール先フォルダ¥conf¥event¥api

API設定ファイル

インストール先フォルダ¥conf¥event¥ntevent.conf

イベントログトラップ動作定義ファイル

任意のファイル※4または

インストール先フォルダ¥conf¥jevlog.conf※4

ログファイルトラップ動作定義ファイル

インストール先フォルダ¥conf¥event¥jevlog_start.conf

ログファイルトラップ起動定義ファイル

JP1/Baseフォルダ※1¥event¥jevlogd.conf

ログ情報定義ファイル

Eventフォルダ※3¥[jev_forward.conf | 任意のファイル]※5

配布定義ファイル（転送設定ファイル用）

インストール先フォルダ¥conf¥[jev_logtrap.conf | 任意のファイル]※5

配布定義ファイル（ログファイルトラップ動作定義ファイル用）

インストール先フォルダ¥conf¥event¥[jev_ntevent.conf | 任意のファイル]※5

配布定義ファイル（イベントログトラップ動作定義ファイル用）

インストール先フォルダ¥conf¥event¥[jev_logstart.conf | 任意のファイル]※5

配布定義ファイル（ログファイルトラップ起動定義ファイル用）

任意のファイル

パスワード定義ファイル（Windows限定）

任意のファイル

ディレクトリサーバ変更ファイル（Windows限定）

インストール先フォルダ¥plugin¥conf¥*.conf

アダプタコマンド設定ファイル

JP1/Baseフォルダ※1¥jbshc¥jbshc.conf

ヘルスチェック定義ファイル

任意のファイル

共通定義設定用ファイル（ヘルスチェック機能）

JP1/Baseフォルダ※1¥jp1hosts

jp1hosts定義ファイル

JP1/Baseフォルダ※1¥jp1hosts2.conf

jp1hosts2定義ファイル

JP1/Baseフォルダ※1¥jbsdfts¥*.conf

サービス管理制御定義ファイル

任意のファイル

ローカルアクション環境変数ファイル

JP1/Baseフォルダ※1¥lcact¥jbslcact.conf

ローカルアクション実行定義ファイル

任意のファイル

共通定義設定用ファイル（ローカルアクション機能）

JP1/Baseフォルダ※1¥physical_ipany.conf

通信方式設定ファイル

JP1/Baseフォルダ※1¥logical_ipany.conf

JP1/Baseフォルダ※1¥physical_recovery_0651.conf

JP1/Baseフォルダ※1¥logical_recovery_0651.conf

JP1/Baseフォルダ※1¥physical_anyany.conf

JP1/Baseフォルダ※1¥physical_ipip.conf

JP1/Baseフォルダ※1¥logical_ipip.conf

JP1/Baseフォルダ※1¥jp1bs_baselog_setup.conf

操作ログ定義ファイル

注※1　「JP1/Baseフォルダ」の部分は，次のフォルダに置き換えてください。

物理ホストの場合：インストール先フォルダ¥conf

論理ホストの場合：共有フォルダ¥jp1base¥conf

注※2　サービスの起動を待機させる設定，およびサービスの起動を監視する設定を有効にしている場合は，バックアップしてください。

注※3　「Eventフォルダ」の部分は，次のフォルダに置き換えてください。

物理ホストの場合：インストール先フォルダ¥conf¥event¥servers¥default

論理ホストの場合：共有フォルダ¥jp1base¥event

注※4　ログファイルトラップ動作定義ファイルは任意の名称に設定できます。使用しているファイルを，忘れずにバックアップしてください。なお，ログファイルトラップを使用していない場合には，ファイルは存在しません。

注※5　配布定義ファイルは標準のファイル名または任意の名称で作成できます。使用しているファイルを，忘れずにバックアップしてください。なお，定義情報の収集および配布機能を使用していない場合には存在しません。

注意事項

統合トレースログの設定は，バックアップとリカバリーの対象ではありません。設定を変更した場合は，JP1/Baseのセットアップをする際に，再度設定し直してください。

(b)　共通定義情報のバックアップ

JP1/Baseでは，定義ファイルだけでなく，共通定義情報もバックアップする必要があります。なお，この共通定義情報には，JP1/Baseのほかに，JP1/IM，JP1/AJSの定義情報も含まれています。

共通定義情報のバックアップは，次のコマンドを実行してJP1/Baseの共通定義情報だけを取得してください。

jbsgetcnf -c JP1BASE > 退避ファイル

クラスタ運用している場合は，次のコマンドを実行してJP1/Baseの共通定義情報だけを取得してください。

jbsgetcnf -h 論理ホスト名 -c JP1BASE > 退避ファイル

なお，論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。

重要

クラスタ運用している論理ホストの場合は，実行系で実行してください。バックアップした共通定義情報のリストアは，実行系サーバと待機系サーバの両方で実施してください。

(c)　jp1hosts2情報のバックアップ

jp1hosts2情報を設定している場合，次のコマンドを実行してjp1hosts2情報のバックアップを取得してください。

jbshosts2export > 退避ファイル

論理ホストにもjp1hosts2情報を設定している場合は，次のようにコマンドを実行してください。

jbshosts2export -h 論理ホスト名 > 退避ファイル

なお，クラスタ運用している論理ホストの場合は，実行系で実行してください。

(2)　イベントDBのバックアップ

イベントDBのバックアップは次の2種類あります。

リカバリーを目的としたバックアップ

参照を目的とした障害レポートでのバックアップ

(a)　リカバリーを目的としたバックアップ

イベントDBファイルのバックアップ手順を次に示します。

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

イベントDBファイルをコピーするなど任意の方法で，バックアップする。

バックアップの対象のファイルは次のとおりです。

インストール先フォルダ¥sys¥event¥servers¥default¥IMEvent*.*※

または，

共有フォルダ¥jp1base¥event¥IMEvent*.*※

注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するフォルダに別のパスを指定している場合は，指定したパス以下のファイルが対象となります。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

(b)　参照を目的とした障害レポートでのバックアップ

障害レポートとしてバックアップする場合は，jevexportコマンドを使用してイベントDBの内容をcsvファイルに出力します。

なお，イベントDBは，イベントサーバごとに二つ存在し，一つが上限値（初期設定では10メガバイト）を超えると，もう一方のイベントDBに切り替わります。この際，使用するイベントDBの内容は消去されます。イベントDBの容量を定期的に確認して，イベントDBが切り替わる前にjevexportコマンドを実行してください。

また，イベントDBのサイズが大きい（1面が1GB以上）場合，jevexportコマンドで全イベントを対象にすると実行に時間がかかります。また，出力されたcsvファイルが大きすぎると参照できない場合があります。

定期的にバックアップをする場合は，イベントフィルターを利用すると前回バックアップした以降のイベントだけを対象にできます。

次のイベントフィルターは，今日までの2日間に発生したJP1イベントをバックアップの対象にします。

B.TIME WITHIN D 2

上記のイベントフィルターを指定したイベントフィルターファイルを使用したjevexportコマンドの実行例を次に示します。-tオプションにONを指定すると，filter.txtで指定したイベントフィルターで，JP1イベント登録時刻，JP1イベント到着時刻などを西暦表示で出力します。

jevexport  -t ON  -f filter.txt  -o 退避ファイル名

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

(3)　設定情報のリカバリー

JP1/Baseのリカバリーについて説明します。クラスタ運用している場合は，物理ホスト，論理ホストの順番で，各環境をリカバリーしてください。

(a)　定義ファイルのリカバリー

下記の条件を確認した上で，バックアップファイルを，元の位置にリカバリーしてください。

JP1/Baseが正常にインストールされていること。

JP1/Baseが停止していること。

論理ホスト環境のJP1/Baseがセットアップされていること（論理ホストの場合）。

共有ディスクをオンラインにしていること（論理ホストの場合）。

(b)　共通定義情報のリカバリー

「(a)　定義ファイルのリカバリー」に加えて，共通定義情報をリカバリーする必要があります。

セットアップ済みのホストにリカバリーする場合，次のコマンドを実行していったんJP1/Baseの共通定義情報を削除してください。

物理ホストの場合

jbsunsetcnf -i -h JP1_DEFAULT -c JP1BASE

論理ホストの場合

jbsunsetcnf -i -h 論理ホスト名 -c JP1BASE

なお，論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。

次に示すコマンドを実行してください。

jbssetcnf (1)(b)でバックアップした退避ファイル名

重要

クラスタ運用している論理ホストの場合は，実行系と待機系で実行してください。バックアップした共通定義情報のリストアは，実行系サーバと待機系サーバの両方で実施してください。

(c)　jp1hosts2情報のリカバリー

「(1)(c)　jp1hosts2情報のバックアップ」の手順で，jp1hosts2情報のバックアップをした場合，次のコマンドを実行してjp1hosts2情報をリカバリーする必要があります。

jbshosts2import -r (1)(c)でバックアップした退避ファイル名

論理ホストにもjp1hosts2情報のバックアップをした場合は，次のようにコマンドを実行してください。

jbshosts2import -h 論理ホスト名 -r (1)(c)でバックアップした退避ファイル名

なお，クラスタ運用している論理ホストの場合は，実行系で実行してください。

(4)　イベントDBのリカバリー

バックアップしたイベントDBファイルをリカバリーすると，イベントDB内通し番号の最大値がバックアップ時の状態に戻ります。

JP1イベントの転送を受け付けるイベントサーバ側（主にJP1/IM - Managerがインストールされた環境）では，転送元のイベントDB内通し番号の最大値を記録しています。この情報は，重複登録チェックに使用されており，イベントDB内通し番号の最大値が大きくなっている場合には，重複がないためJP1イベントは無条件に登録されますが，イベントDB内通し番号小さくなった場合には，重複の可能性があるためイベント検索をして，同じJP1イベントが存在しないかを確認します。イベントDBのサイズが大きい場合には，検索件数が増えるためJP1イベントの転送遅延など，イベントサービスを利用する機能の遅延が発生します。

(a)　転送設定ファイルで他ホストにJP1イベントを転送していない場合のリカバリー手順

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

バックアップしたファイルをフォルダに配置する。

配置するフォルダは次のとおりです。

インストール先フォルダ¥sys¥event¥servers¥default¥※

または，

共有フォルダ¥jp1base¥event¥※

注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するフォルダに別のパスを指定している場合は，指定したパスの配下に配置してください。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

(b)　転送設定ファイルで他ホストにJP1イベントを転送している場合のリカバリー手順

転送先がJP1/Base 11-10以降で重複防止テーブルがファイル方式の場合，次の手順でイベントDBをリカバリーしてください。

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

バックアップしたファイルをフォルダに配置する。

配置するフォルダは次のとおりです。

インストール先フォルダ¥sys¥event¥servers¥default¥※

または，

共有フォルダ¥jp1base¥event¥※

注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するフォルダに別のパスを指定している場合は，指定したパスの配下に配置してください。

JP1/Baseを起動する。

転送先に対して重複防止テーブルクリア用JP1イベント（ユーザイベント）を送信して，転送先の重複防止テーブルから転送元の発行元イベントDB内通し番号の最大値をクリアする。

> jevsendd -i 7FFF8001 -m "DPT CLEAR EVENT" -d 転送先イベントサーバ名

転送先がJP1/IM - Managerのサブマネージャーの場合，その上位のマネージャーに対しても重複防止テーブルクリア用JP1イベント（ユーザイベント）を送信してください。

JP1/Baseを前提としている製品を起動する。

転送先がJP1/Base 11-10未満か重複防止テーブルがメモリ方式の場合，次のどちらかの手順でイベントDBをリカバリーしてください。

イベントDBを初期化してリカバリーする。

「10.2.2　イベントサービスの停止中に初期化する」を参照して，イベントDBを初期化してください。なお，バックアップしたイベントDBの内容は，jevexportコマンドでcsvファイルに出力して参照できます。

転送設定ファイルに指定された転送先のイベントサーバで重複登録チェックを無効化する。

転送先の作業

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

イベントサーバ設定ファイル（conf）に次の行を追加する。

repetition-noncheck-server リカバリーするイベントサーバ名

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

転送元の作業

「(a)　転送設定ファイルで他ホストにJP1イベントを転送していない場合のリカバリー手順」に従ってリカバリーしてください。

なお，転送先では転送元からJP1イベントの転送を受け付けた時点で，記録している転送元のイベントDB内通し番号の最大値をクリアします。したがって，転送元からJP1イベントの転送を受け付けたあとは，転送先のイベントサーバで重複登録チェックを有効化しても問題ありません。転送先のイベントサーバで重複登録チェックを有効化し，イベントサーバを起動する前にjevdbmkrepコマンドを実行して，重複防止テーブルを再作成してください。

3.5.3　バックアップとリカバリー（UNIXの場合）

(1)　設定情報のバックアップ

JP1/Baseの設定情報には以下のものがあります。

定義ファイル

共通定義情報

jp1hosts2情報

クラスタ運用している場合は，物理ホスト，論理ホストの順番で，各環境をバックアップしてください。

(a)　定義ファイルのバックアップ

JP1/Baseでは，ユーザーが設定する定義ファイルとして以下のファイルがあります。これらのファイルのバックアップをしてください。バックアップの手段には，tarやcpio，またはより高度なバックアップコマンドがあります。任意の方法でバックアップしてください。

表3‒9　JP1/Baseのバックアップ対象ファイル

ファイル名

内容

JP1/Baseディレクトリ※1/jp1bs_env.conf

JP1/Base環境定義ファイル

JP1/Baseディレクトリ※1/jp1bs_param.conf

JP1/Baseディレクトリ※1/jp1bs_param_V7.conf

JP1/Baseパラメーター定義ファイル

JP1/Baseディレクトリ※1/jp1bs_spmd.conf

JP1/Baseプロセス管理定義ファイル

JP1/Baseディレクトリ※1/jp1bs_service_0700.conf

拡張起動プロセス定義ファイル

JP1/Baseディレクトリ※1/route/以下のファイル

構成定義ファイル

（JP1/IMで使用）

JP1/Baseディレクトリ※1/user_acl/JP1_Passwd

JP1ユーザー定義ファイル

JP1/Baseディレクトリ※1/user_acl/JP1_Group

JP1グループ定義ファイル

JP1/Baseディレクトリ※1/user_acl/JP1_UserLevel

ユーザー権限レベルファイル

JP1/Baseディレクトリ※1/user_acl/JP1_AccessLevel

JP1資源グループ定義ファイル

JP1/Baseディレクトリ※1/user_acl/JP1_Accountaccess

JP1アカウントアクセス情報ファイル

JP1/Baseディレクトリ※1/user_acl/jp1BsUmap.conf

ユーザーマッピング定義ファイル

JP1/Baseディレクトリ※1/passwdpolc/jp1bs_passwdpolc.conf

パスワードポリシー定義ファイル

JP1/Baseディレクトリ※1/event/index

イベントサーバインデックスファイル

Eventディレクトリ※4/conf

イベントサーバ設定ファイル

Eventディレクトリ※4/forward

転送設定ファイル

/etc/opt/jp1base/conf/event/servers/default/suppress/forward_suppress

イベント転送抑止用の転送設定ファイル

Eventディレクトリ※4/[recv_add_extattr | send_add_extattr]

属性付加設定ファイル

/etc/opt/jp1base/conf/event/api

API設定ファイル

任意のファイル※2または

/etc/opt/jp1base/conf/jevlog.conf※2

ログファイルトラップ動作定義ファイル

/etc/opt/jp1base/conf/event/jevlog_start.conf

ログファイルトラップ起動定義ファイル

JP1/Baseディレクトリ※1/event/jevlogd.conf

ログ情報定義ファイル

Eventディレクトリ※4/[jev_forward.conf | 任意のファイル]※3

配布定義ファイル（転送設定ファイル用）

/etc/opt/jp1base/conf/[jev_logtrap.conf | 任意のファイル]※3

配布定義ファイル（ログファイルトラップ動作定義ファイル用）

/etc/opt/jp1base/conf/event/[jev_ntevent.conf | 任意のファイル]※3

配布定義ファイル（イベントログトラップ動作定義ファイル用）

/etc/opt/jp1base/conf/event/[jev_logstart.conf | 任意のファイル]※3

配布定義ファイル（ログファイルトラップ起動定義ファイル用）

/opt/jp1base/plugin/conf/*.conf

アダプタコマンド設定ファイル

JP1/Baseディレクトリ※1/jbshc/jbshc.conf

ヘルスチェック定義ファイル

任意のファイル

共通定義設定用ファイル（ヘルスチェック機能）

JP1/Baseディレクトリ※1/jp1hosts

jp1hosts定義ファイル

JP1/Baseディレクトリ※1/jp1hosts2.conf

jp1hosts2定義ファイル

JP1/Baseディレクトリ※1/jbsdfts/*.conf

サービス管理制御定義ファイル

任意のファイル

ローカルアクション環境変数ファイル

JP1/Baseディレクトリ※1/lcact/jbslcact.conf

ローカルアクション実行定義ファイル

任意のファイル

共通定義設定用ファイル（ローカルアクション機能）

JP1/Baseディレクトリ※1/physical_ipany.conf

通信方式設定ファイル

JP1/Baseディレクトリ※1/logical_ipany.conf

JP1/Baseディレクトリ※1/physical_recovery_0651.conf

JP1/Baseディレクトリ※1/logical_recovery_0651.conf

JP1/Baseディレクトリ※1/physical_anyany.conf

JP1/Baseディレクトリ※1/physical_ipip.conf

JP1/Baseディレクトリ※1/logical_ipip.conf

JP1/Baseディレクトリ※1/jp1bs_baselog_setup.conf

操作ログ定義ファイル

注※1　「JP1/Baseディレクトリ」の部分は，次のディレクトリに置き換えてください。

物理ホストの場合：/etc/opt/jp1base/conf

論理ホストの場合：共有ディレクトリ/jp1base/conf

注※2　ログファイルトラップ動作定義ファイルは任意の名称に設定できます。使用しているファイルを，忘れずにバックアップしてください。なお，ログファイルトラップを使用していない場合には，このファイルは存在しません。

注※3　配布定義ファイルは標準のファイル名または任意の名称で作成できます。使用しているファイルを，忘れずにバックアップしてください。なお，定義情報の収集および配布機能を使用していない場合には存在しません。

注※4　「Eventディレクトリ」の部分は，次のディレクトリに置き換えてください。

物理ホストの場合：/etc/opt/jp1base/conf/event/servers/default

論理ホストの場合：共有ディレクトリ/event

なお，クラスタ運用している場合は，クラスタシステム用の設定をした際に指定したディレクトリ内から上記表に該当する定義ファイルをバックアップしてください。

注意事項

統合トレースログの設定は，バックアップとリカバリーの対象ではありません。設定を変更した場合は，JP1/Baseのセットアップをする際に，再度設定し直してください。

(b)　共通定義情報のバックアップ

JP1/Baseでは，定義ファイルだけでなく，共通定義情報もバックアップする必要があります。なお，この共通定義情報には，JP1/Baseのほかに，JP1/IM，JP1/AJSの定義情報も含まれています。

共通定義情報のバックアップは，次のコマンドを実行してJP1/Baseの共通定義情報だけを取得してください。

jbsgetcnf -c JP1BASE > 退避ファイル

クラスタ運用している場合は，次のコマンドを実行してJP1/Baseの共通定義情報だけを取得してください。

jbsgetcnf -h 論理ホスト名 -c JP1BASE > 退避ファイル

なお，論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。

重要

クラスタ運用している論理ホストの場合は，実行系で実行してください。バックアップした共通定義情報のリストアは，実行系サーバと待機系サーバの両方で実施してください。

(c)　jp1hosts2情報のバックアップ

jp1hosts2情報を設定している場合，次のコマンドを実行してjp1hosts2情報のバックアップを取得してください。

jbshosts2export > 退避ファイル

論理ホストにもjp1hosts2情報を設定している場合は，次のようにコマンドを実行してください。

jbshosts2export -h 論理ホスト名 > 退避ファイル

なお，クラスタ運用している論理ホストの場合は，実行系で実行してください。

(2)　イベントDBのバックアップ

イベントDBのバックアップは次の2種類あります。

リカバリーを目的としたバックアップ

参照を目的とした障害レポートでのバックアップ

(a)　リカバリーを目的としたバックアップ

イベントDBファイルのバックアップ手順を次に示します。

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

イベントDBファイルをコピーするなど任意の方法で，バックアップする。

バックアップの対象のファイルは次のとおりです。

/var/opt/jp1base/sys/event/servers/default/IMEvent*.*※

または，

共有ディレクトリ/event/IMEvent*.*※

注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するディレクトリに別のパスを指定している場合は，指定したパス以下のファイルが対象となります。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

(b)　参照を目的とした障害レポートでのバックアップ

障害レポートとしてバックアップする場合は，jevexportコマンドを使用してイベントDBの内容をcsvファイルに出力します。

なお，イベントDBは，イベントサーバごとに二つ存在し，一つが上限値（初期設定では10メガバイト）を超えると，もう一方のイベントDBに切り替わります。この際，使用するイベントDBの内容は消去されます。イベントDBの容量を定期的に確認して，イベントDBが切り替わる前にjevexportコマンドを実行してください。

また，イベントDBのサイズが大きい（1面が1GB以上）場合，jevexportコマンドで全イベントを対象にすると実行に時間がかかります。また，出力されたcsvファイルが大きすぎると参照できない場合があります。

定期的にバックアップをする場合は，イベントフィルターを利用すると前回バックアップした以降のイベントだけを対象にできます。

次のイベントフィルターは，今日までの2日間に発生したJP1イベントをバックアップの対象にします。

B.TIME WITHIN D 2

上記のイベントフィルターを指定したイベントフィルターファイルを使用したjevexportコマンドの実行例を次に示します。-tオプションにONを指定すると，filter.txtで指定したイベントフィルターで，JP1イベント登録時刻，JP1イベント到着時刻などを西暦表示で出力します。

jevexport  -t ON  -f filter.txt  -o 退避ファイル名

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

(3)　設定情報のリカバリー

JP1/Baseのリカバリーについて説明します。クラスタ運用している場合は，物理ホスト，論理ホストの順番で，各環境をリカバリーしてください。

(a)　定義ファイルのリカバリー

下記の条件を確認した上で，バックアップファイルを，元の位置にリカバリーしてください。

JP1/Baseが正常にインストールされ，セットアップコマンドが実行済みであること。

JP1/Baseが停止していること。

論理ホスト環境のJP1/Baseがセットアップされていること（論理ホストの場合）。

共有ディスクをオンラインにしていること（論理ホストの場合）。

(b)　共通定義情報のリカバリー

「(a)　定義ファイルのリカバリー」に加えて，共通定義情報をリカバリーする必要があります。

セットアップ済みのホストにリカバリーする場合，次のコマンドを実行していったんJP1/Baseの共通定義情報を削除してください。

物理ホストの場合

jbsunsetcnf -i -h JP1_DEFAULT -c JP1BASE

論理ホストの場合

jbsunsetcnf -i -h 論理ホスト名 -c JP1BASE

なお，論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。

次に示すコマンドを実行してください。

jbssetcnf (1)(b)でバックアップした退避ファイル名

重要

クラスタ運用している論理ホストの場合は，実行系と待機系で実行してください。バックアップした共通定義情報のリストアは，実行系サーバと待機系サーバの両方で実施してください。

(c)　jp1hosts2情報のリカバリー

「(1)(c)　jp1hosts2情報のバックアップ」の手順で，jp1hosts2情報のバックアップをした場合，次のコマンドを実行してjp1hosts2情報をリカバリーする必要があります。

jbshosts2import -r (1)(c)でバックアップした退避ファイル名

論理ホストにもjp1hosts2情報のバックアップをした場合は，次のようにコマンドを実行してください。

jbshosts2import -h 論理ホスト名 -r (1)(c)でバックアップした退避ファイル名

なお，クラスタ運用している論理ホストの場合は，実行系で実行してください。

(4)　イベントDBのリカバリー

バックアップしたイベントDBファイルをリカバリーすると，イベントDB内通し番号の最大値がバックアップ時の状態に戻ります。

JP1イベントの転送を受け付けるイベントサーバ側（主にJP1/IM - Managerがインストールされた環境）では，転送元のイベントDB内通し番号の最大値を記録しています。この情報は，重複登録チェックに使用されており，イベントDB内通し番号の最大値が大きくなっている場合には，重複がないためJP1イベントは無条件に登録されますが，イベントDB内通し番号小さくなった場合には，重複の可能性があるためイベント検索をして，同じJP1イベントが存在しないかを確認します。イベントDBのサイズが大きい場合には，検索件数が増えるためJP1イベントの転送遅延など，イベントサービスを利用する機能の遅延が発生します。

(a)　転送設定ファイルで他ホストにJP1イベントを転送していない場合のリカバリー手順

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

バックアップしたファイルをディレクトリに配置する。

配置するディレクトリは次のとおりです。

/var/opt/jp1base/sys/event/servers/default/※

または，

共有ディレクトリ/event/※

注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するディレクトリに別のパスを指定している場合は，指定したパスの配下に配置してください。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

(b)　転送設定ファイルで他ホストにJP1イベントを転送している場合のリカバリー手順

転送先がJP1/Base 11-10以降で重複防止テーブルがファイル方式の場合，次の手順でイベントDBをリカバリーしてください。

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

バックアップしたファイルをフォルダに配置する。

配置するフォルダは次のとおりです。

/var/opt/jp1base/sys/event/servers/default/※

または，

共有ディレクトリ/event/※

注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するフォルダに別のパスを指定している場合は，指定したパスの配下に配置してください。

JP1/Baseを起動する。

転送先に対して重複防止テーブルクリア用JP1イベント（ユーザイベント）を送信して，転送先の重複防止テーブルから転送元の発行元イベントDB内通し番号の最大値をクリアする。

> jevsendd -i 7FFF8001 -m "DPT CLEAR EVENT" -d 転送先イベントサーバ名

転送先がJP1/IM - Managerのサブマネージャーの場合，その上位のマネージャーに対しても重複防止テーブルクリア用JP1イベント（ユーザイベント）を送信してください。

JP1/Baseを前提としている製品を起動する。

転送先がJP1/Base 11-10未満か重複防止テーブルがメモリ方式の場合，次のどちらかの手順でイベントDBをリカバリーしてください。

イベントDBを初期化してリカバリーする。

「10.2.2　イベントサービスの停止中に初期化する」を参照して，イベントDBを初期化してください。なお，バックアップしたイベントDBの内容は，jevexportコマンドでcsvファイルに出力して参照できます。

転送設定ファイルに指定された転送先のイベントサーバで重複登録チェックを無効化する。

転送先の作業

JP1/Baseを前提としている製品を停止する。

JP1/Baseを停止する。

イベントサーバ設定ファイル（conf）に次の行を追加する。

repetition-noncheck-server リカバリーするイベントサーバ名

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

転送元の作業

「(a)　転送設定ファイルで他ホストにJP1イベントを転送していない場合のリカバリー手順」に従ってリカバリーしてください。

なお，転送先では転送元からJP1イベントの転送を受け付けた時点で，記録している転送元のイベントDB内通し番号の最大値をクリアします。したがって，転送元からJP1イベントの転送を受け付けたあとは，転送先のイベントサーバで重複登録チェックを有効化しても問題ありません。転送先のイベントサーバで重複登録チェックを有効化し，イベントサーバを起動する前にjevdbmkrepコマンドを実行して，重複防止テーブルを再作成してください。

4　JP1/Baseの障害に備えた設定

この章では，JP1/Baseの障害に備えた設定について説明します。

4.1　JP1/Baseの障害に備えた設定とは

JP1/Baseでは，JP1/Base自体の障害がJP1/IMやJP1/AJSを利用したシステム運用に及ぼす影響をできるだけ防ぐために，次の機能を提供しています。

ヘルスチェック

プロセス管理機能，イベントサービス，イベント変換などのプロセスのハングアップ（無限ループやデッドロック），および異常終了（強制終了した場合を除く）を検知します。

プロセス管理機能による異常検知

プロセス管理機能が管理するプロセスの異常終了と，認証サーバの切り替えを検知します。

プロセス異常終了時の再起動

プロセス管理機能が管理するプロセスが異常終了した場合に，自動で再起動します。

イベントサービスのプロセス異常終了時の再起動（UNIX限定）

物理ホストのイベントサービスのプロセスが異常終了した場合に，自動で再起動します。

統合トレース機能（HNTRLib2）

統合トレース機能（HNTRLib2）を使って，JP1/Baseを前提とする製品を含めた動作処理の流れをトレースしたログファイルを出力しています。

トラブル発生時の資料採取

JP1/Baseでトラブルが発生したときに，トラブルシュートのための保守資料を採取できます。

しきい値によるイベント転送抑止

大量発生イベントを検知するためのしきい値を設定しておくことで，JP1イベントが大量に発生したときにイベント転送を自動的に抑止します。

4.1.1　ヘルスチェックとプロセス管理機能が検知できるプロセスの障害の範囲について

プロセスの異常終了には，プロセス自体が異常と判断して終了する場合と，OSのkillコマンドなどで強制的に終了する場合の2種類あります。ヘルスチェックでは，強制的にプロセスが終了した場合を異常終了として検知できず，プロセスの処理が停滞しているものとして検知します。そのため，プロセスの異常終了を確実に検知したい場合は，ヘルスチェックとプロセス管理機能による異常検知を併用してください。

ヘルスチェックが検知できるプロセスの障害の範囲と，プロセス管理機能が検知できるプロセスの障害の範囲を次の図で示します。

図4‒1　ヘルスチェックとプロセス管理機能が検知できるプロセスの障害の範囲

4.2　ヘルスチェック機能でプロセスの異常を検知する

ヘルスチェック機能を利用すると，プロセスの異常を早期に検知できます。また，メッセージによる異常通知によって異常が発生したプロセスを特定できるため，プロセス異常時の影響を最小限に抑えた対処ができます。なお，ヘルスチェック機能を使用するには，監視するホスト，および監視対象ホストにJP1/Base 07-11以降がインストールされている必要があります。

4.2.1　ヘルスチェック機能を有効にする

ヘルスチェック機能は，初期設定では無効になっています。有効にする手順を次に示します。クラスタシステムで運用する場合は，論理ホストのセットアップの完了後に，物理ホスト，論理ホストの両方でヘルスチェック機能を有効にしてください。

共通定義情報にヘルスチェック機能を有効にする情報を登録する。

1-1　共通定義設定用ファイル（ヘルスチェック機能）のモデルファイル（jbshc_setup.conf.model）を任意のファイル名でコピーする。

1-2　コピーしたファイルを編集する。

1-3　次のコマンドを実行する。

jbssetcnf 1-2で編集したファイル名

ヘルスチェック機能の設定情報が共通定義情報に登録されます。

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

共通定義設定用ファイル（ヘルスチェック機能）の詳細については，「16.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」を参照してください。

ヘルスチェック定義ファイル（jbshc.conf）を編集する。

監視対象ホストや監視間隔を定義します。ヘルスチェック定義ファイルの詳細については，「16.　定義ファイル」の「ヘルスチェック定義ファイル」を参照してください。

JP1イベントの転送設定を変更する。

ヘルスチェック機能が発行するJP1イベントを上位の管理サーバに転送するために，転送設定ファイル（forward）に次の条件を追加してください。

E.OBJECT_TYPE IN JBSHC

転送設定ファイル（forward）の詳細については，「16.　定義ファイル」の「転送設定ファイル」を参照してください。

JP1/Baseのすべてのサービスを再起動する。

ヘルスチェック機能が起動し，プロセスの監視を開始します。

ヘルスチェック動作定義ファイルに誤りがあった場合は，その設定行は無効になります。また，無効になった設定行に省略時の仮定値がある場合は，仮定値で動作します。

(1)　07-10以前のJP1/Baseをクラスタ運用している環境からバージョンアップした場合

07-10以前のJP1/Baseでクラスタシステムを使用している場合，07-11以降のJP1/Baseを上書きインストールしたあとに，論理ホスト環境の設定をアップグレードする必要があります。ヘルスチェック機能を有効にする設定も，論理ホスト環境の設定のアップグレードをしたあとに実施してください。

論理ホスト環境の設定をアップグレードする方法については，「3.2.3(5)　上書きインストールについて」（Windowsの場合），および「3.3.4(5)　上書きインストールについて」（UNIXの場合）を参照してください。

4.2.2　ヘルスチェックの設定状況を確認する

ヘルスチェックの設定，および異常検知時のフェールオーバーの有無を確認したい場合は，次のコマンドを実行して共通定義情報を参照してください。

jbsgetcnf

出力された共通定義情報から，ヘルスチェック機能のセクションを検索し，設定を確認してください。

jbsgetcnfコマンドの詳細については，「15.　コマンド」の「jbsgetcnf」を参照してください。共通定義情報の詳細については，「16.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」を参照してください。

4.2.3　ヘルスチェックの設定を変更する

監視対象ホストの追加や監視間隔を変更する場合の手順を次に示します。

ヘルスチェック定義ファイル（jbshc.conf）を編集する。

ヘルスチェック定義ファイルの詳細については，「16.　定義ファイル」の「ヘルスチェック定義ファイル」を参照してください。

ヘルスチェック定義ファイル（jbshc.conf）の設定内容を有効にする。

JP1/Baseを再起動，またはjbs_spmd_reloadコマンドを実行します。jbs_spmd_reloadコマンドの詳細については，「15.　コマンド」の「jbs_spmd_reload」を参照してください。

設定内容は，リロード後，次の監視タイミングが来た時に有効になります。

リロード時に，ヘルスチェック定義ファイル（jbshc.conf）に誤りがありエラーとなった場合は，その設定行は無効とし，リロード前の設定で動作します。

リロード時の注意事項

他ホストの監視中にエラーを検知している状態でリロードした場合，監視対象ホストの監視状態はリセットされます。このため，次回監視時に監視対象ホストが回復していないときには，再度エラーメッセージやJP1イベントが発行されます。また，すでに回復しているときには，回復メッセージやJP1イベントは発行されません。

4.2.4　ヘルスチェックの設定を無効にする

共通定義設定用ファイル（ヘルスチェック機能）を編集する。

1-1　共通定義設定用ファイル（ヘルスチェック機能）のモデルファイルを任意のファイル名でコピーする。

1-2　コピーしたファイルを編集する。

共通定義設定用ファイル（ヘルスチェック機能）の詳細については，「16.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」を参照してください。

次のコマンドを実行する。

jbssetcnf 1-2で編集したファイル名

ヘルスチェックが無効になります。

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

JP1/Baseのすべてのサービスを再起動する。

4.2.5　ヘルスチェック機能を使用する場合の注意事項

プロセスをkillコマンドなどで強制終了した場合，異常終了として検知されません。この場合は，プロセスの応答がない状態として異常を検知（KAVA7014-E）します。ただし，経過時間はkillコマンド実行からの時間ではありません。内部で使用している共有メモリーの更新時刻で判断しているため，プロセスの強制終了後，すぐに異常が検知される場合があります。

プロセスをkillコマンドなどで強制終了し正常に終了処理ができていない状態で，該当機能のプロセスを再起動した場合，先に強制終了したプロセスの異常検知メッセージが発行されることがあります。

拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）で再起動を設定しているプロセスが異常終了した場合，プロセスの再起動を通知するメッセージ（KAVB3605-I，KAVB3616-I）の発行のあとに異常終了を通知するメッセージ（KAVA7017-E）が発行されることがあります。プロセスの状態は，jbs_spmd_statusコマンドで確認してください。

4.3　プロセスの異常終了および認証サーバの切り替え発生を検知する

JP1/Baseでは，プロセスが異常終了したり，認証サーバを2台設置した運用で認証サーバが自動で切り替わったりした場合に，エラーメッセージを統合トレースログに出力します。これらのメッセージをJP1イベントとして発行できます。

発行されるJP1イベントの詳細については，「17.　JP1イベント」を参照してください。

4.3.1　監視対象プロセス

プロセス管理（jbs_spmd）が管理する次のプロセスの異常終了を検知します。

jbssessionmgr（認証サーバ）

jbsroute（構成管理）

jcocmd（コマンド実行）

jbsplugind（プラグインサービス）

jbshcd（ヘルスチェック：自ホスト監視用）

jbshchostd（ヘルスチェック：他ホスト監視用）

jbssrvmgr（サービス管理制御）

jbslcact（ローカルアクション）

jbscomd（プロセス間通信）

4.3.2　JP1イベントの発行契機

設定を有効にした場合，次に示す契機でJP1イベントが発行されます。

プロセス管理機能が管理するプロセスの状態

プロセスの起動時にタイムアウトした場合

プロセスが異常終了した場合

起動時に起動通知がなく，タイムアウトした場合

異常終了した管理対象プロセスの再起動が完了した場合※

注※　プロセスの再起動を設定した場合に発行されます。

認証サーバの状態（セカンダリー認証サーバを設置した場合）

認証サーバへの接続に失敗し，自動で閉塞状態になった場合

閉塞状態が自動で解除された場合

プライマリー認証サーバおよびセカンダリー認証サーバへの接続がともに閉塞状態になった場合

4.3.3　プロセスの異常終了および認証サーバの切り替え発生を検知するための設定手順

JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）を編集する。

JP1イベントを発行したいパラメーターについて，1（JP1イベントを発行する）を設定します。JP1/Baseパラメーター定義ファイルの詳細については，「16.　定義ファイル」の「JP1/Baseパラメーター定義ファイル」を参照してください。

jbssetcnfコマンドを実行する。

JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）の設定内容が共通定義情報に反映されます。

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

JP1/BaseおよびJP1/Baseを前提とする製品を再起動する。

設定が有効になります。

4.4　異常終了したプロセス管理機能が管理するプロセスを再起動させる

JP1/Baseを起動すると，複数のプロセスが生成されます。JP1/Baseでは，何らかの理由でプロセスが異常終了した場合に，自動でプロセスを再起動できます。

なお，ここで説明する再起動の設定は，クラスタ運用ではないJP1/Baseの再起動を目的としています。クラスタ運用の場合に再起動をしたい場合は，クラスタソフトの制御によって再起動するようにしてください。

4.4.1　再起動の対象のプロセス

再起動の対象は，プロセス管理機能（jbs_spmd）が管理する次のプロセスです。

jbssessionmgr（認証サーバ）

jbsroute（構成管理）

jcocmd（コマンド実行）

jbsplugind（プラグインサービス）

jbshcd（ヘルスチェック：自ホスト監視用）

jbshchostd（ヘルスチェック：他ホスト監視用）

jbssrvmgr（サービス管理制御）

jbslcact（ローカルアクション）

jbscomd（プロセス間通信）

4.4.2　プロセス管理機能が管理するプロセスの再起動の設定手順

拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）を編集する。

拡張起動プロセス定義ファイルの詳細については，「16.　定義ファイル」の「拡張起動プロセス定義ファイル」を参照してください。

設定を有効にする。

JP1/Baseを再起動するか，リロードコマンド（jbs_spmd_reload）を実行すると設定が有効になります。

4.5　異常終了したイベントサービスのプロセスを再起動させる（UNIX限定）

UNIX版のJP1/Baseでは，物理ホストのイベントサービスのプロセスが異常終了した場合，自動で再起動できます。この設定は，初期設定では無効です。

Windows版のJP1/Baseの場合は，WindowsのService Control Managerでサービスを再起動する設定をしてください。

なお，ここで説明する再起動の設定は，クラスタ運用ではないJP1/Baseの再起動を目的としています。クラスタ運用の場合に再起動を行いたい場合は，クラスタソフトの制御によって再起動するようにしてください。

4.5.1　再起動の対象のプロセス

再起動の対象のプロセスは，jevservice（イベントサービス）が管理する子プロセスjevservice（イベントサービス）です。

jevservice（イベントサービス）が管理する子プロセスjevservice（イベントサービス）とは，jevstatコマンドで確認できるプロセスIDを親プロセスとして持つjevservice（イベントサービス）プロセスです。

4.5.2　異常終了したイベントサービスのプロセスを再起動させるための設定手順

イベントサーバ設定ファイル（conf）にrestartパラメーターを定義する。

イベントサービスを起動する。

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

4.6　統合トレース機能（HNTRLib2）の設定

JP1/Baseでは，統合トレース機能（HNTRLib2）を使って，JP1/Baseを前提とする製品を含めた動作処理の流れをトレースしたログファイルを出力しています。このログファイルは，障害が発生したときなどの原因究明に役立ちます。

初期設定では，次のように設定されています。

ログファイルのサイズ：256キロバイト

ログファイルの数：4

ログファイルの出力先：

Windowsの場合

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

UNIXの場合

/var/opt/hitachi/HNTRLib2/spool/hntr2*.log

通常は初期設定値を変更する必要はありませんが，hntr2utl2コマンド，hntr2confコマンド，またはhntr2getconfコマンドを実行すると初期設定値を参照し，変更できます。コマンドの詳細については，「15.　コマンド」の「hntr2utl2（Windows限定）」，「hntr2utl2（UNIX限定）」，「hntr2conf」，「hntr2getconf」を参照してください。

なお，統合トレースログが複数のプロセスから同時に出力されるとメッセージが破損することがあるため，ログファイルトラップ動作定義ファイルで特定のメッセージを監視したい場合は，統合トレースログの排他機能を有効にしてください。排他機能の詳細については，「15.　コマンド」の「hntr2conf」を参照してください。

4.7　トラブル発生時の資料採取の準備（Windows限定）

JP1/Baseでは，トラブル発生時に一括して資料を採取するための「資料採取ツール」を用意しています。資料採取ツールは，OSのシステム情報やJP1/Baseの設定情報などを採取できます。ただし，ユーザーダンプは採取できません。トラブル発生時には，資料採取ツールで採取した資料と合わせてユーザーダンプを採取する必要があります。

ここでは，ユーザーダンプを出力する設定をします。

4.7.1　ユーザーダンプの出力設定

次に示す手順でレジストリにユーザーダンプを出力する設定をしてください。なお，レジストリの操作は，マシン全体に影響を与える可能性もあるため慎重に実施してください。

［スタート］−［プログラムとファイルの検索］欄にregeditと入力して，［Enter］キーを押す。

［ユーザー アカウント制御］画面が表示される場合，［はい］ボタンを押してください。

画面左のツリーから，次に示すキーを展開する。

キー：HKEY_LOCAL_MACHINE¥SOFTWARE¥Microsoft¥Windows¥Windows Error Reporting

Windows Error Reportingキーを右クリックして表示される，［新規］−［キー］を選択する。

新しいキーにLocalDumpsと入力する。

作成したLocalDumpsキーを選択して，次の表に示す三つのレジストリを作成する。

項番

値の名前

値の種類

データ

1

DumpFolder

展開可能な文字列値（REG_EXPAND_SZ）

任意のダンプ出力先パス

（例）c:¥dump

2

DumpCount

DWORD（32ビット）値（REG_DWORD）

a（16進数）

3

DumpType

DWORD（32ビット）値（REG_DWORD）

2（16進数）

4.8　大量発生イベントを検知するためのしきい値を設定する

大量発生イベントを検知するためのしきい値を設定しておくことで，JP1イベントが大量に発生した場合に，イベント転送を自動的に抑止できます。大量発生イベントの転送を未然に防ぐために，大量発生イベントを検知するためのしきい値を設定して，イベント転送を自動的に抑止することを検討してください。

大量発生イベントを検知するためのしきい値は，イベント転送抑止条件として，抑止対象となるエージェントの転送設定ファイル（forward）に設定します。イベント転送抑止条件の設定手順については，「10.1.9(1)　イベント転送抑止条件を設定する」を参照してください。

4.9　コマンド実行履歴ファイルの自動再編成機能について

JP1/Baseのコマンド実行機能で使用するコマンド実行履歴ファイルにコマンド実行履歴を書き込み中，予期しないシステムの強制終了，または電源断が起きた場合，ファイルが破損するおそれがあります。

コマンド実行履歴ファイルの自動再編成機能によって，予期しないシステムの強制終了後にJP1/Baseを再起動する際，コマンド実行履歴ファイルの修復，またはファイルの破損の検知が早期にできます。この機能は，初期設定で有効となっています。

なお，コマンド実行履歴ファイルのサイズによっては，JP1/Baseの起動時間が増加する可能性があります。運用上起動時間の長さが問題になる場合は，コマンド実行履歴ファイルのレコード数を少なくするか，自動再編成機能を無効にすることを検討してください。

コマンド実行履歴ファイルの自動再編成に掛かる時間は，次に示すコマンドの実行時間の合計が目安になります。ファイルサイズに応じて実行時間は長くなります。

コマンド実行例

次のコマンドを実行する前にJP1/Baseを停止してください。

Windowsの場合

Jiscond インストール先フォルダ¥log¥COMMAND¥ACTISAMLOGV8
Jiscond インストール先フォルダ¥log¥COMMAND¥CMDISAMLOGV8

UNIXの場合

/opt/jp1base/bin/Jiscond /var/opt/jp1base/log/COMMAND/actisamlogv8
/opt/jp1base/bin/Jiscond /var/opt/jp1base/log/COMMAND/cmdisamlogv8

この機能を無効にする手順は次のようになります。

jp1bs_spmd_pre.confをリネーム，または削除する。※

JP1/BaseおよびJP1/Baseを前提とする製品を再起動する。

設定が無効になります。

注※

jp1bs_spmd_pre.confは次のディレクトリに格納されています。

Windowsの場合

インストール先フォルダ¥conf¥
共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/
共有ディレクトリ/jp1base/conf/（クラスタ運用時）

注意事項

Windowsでは，サービスが異常終了した場合，ISAMデータベースのロックが残ることがありますので，Jislckfreeコマンドでロックを解除してください。

5　クラスタシステムで運用する場合の設定

JP1/Baseは，Microsoft Cluster Serverなどのクラスタソフトに対応しています。クラスタソフトと連携して運用すると，JP1/Baseの可用性を向上できます。この章では，JP1/Baseのクラスタ運用およびセットアップ方法について説明します。

なお，JP1/Baseをクラスタシステムで運用する場合には，ご使用になるクラスタソフトに，JP1/Baseが対応しているか確認してから運用してください。

5.1　クラスタ運用の概要

5.1.1　クラスタシステムの概要

クラスタシステムとは，複数のサーバシステムを連携して一つのシステムとして運用するシステムで，一つのサーバで障害が発生しても，別のサーバで業務を継続できるようにすることを目的としています。

クラスタシステムは，処理を実行するホストと，障害が発生した時に処理を引き継げるように待機しているホストで構成されています。業務を実行中のサーバを実行系サーバ，実行系の障害時に業務を引き継げるよう待機しているサーバを待機系サーバと呼びます。障害発生時は，実行系サーバから待機系サーバに処理を引き継いで業務の停止を防ぎます。この障害時に処理を引き継ぐことをフェールオーバーといいます。

フェールオーバーする単位となる論理的なサーバのことを論理ホストといいます。クラスタシステムで実行されるアプリケーションは，フェールオーバーして業務を継続するために，論理ホスト環境で動作させる必要があります。論理ホストで動作するアプリケーションは，物理的なサーバに依存しないで，任意のサーバで動作できます。

論理ホストは，サービスとして動作するアプリケーション，共有ディスク，および論理IPアドレスの三つの要素で構成されています。サービスとして動作するJP1などのアプリケーションは，共有ディスクにデータを格納し，論理IPアドレスで通信を行います。

論理ホストを構成する各要素について次の表で説明します。

表5‒1　論理ホストの構成要素

論理ホストの構成要素

説明

サービス

クラスタシステムで実行するJP1などのアプリケーションです。実行系の論理ホストで障害が発生すると，待機系の論理ホストで同じ名称のサービスを起動し，処理を引き継ぎます。

共有ディスク

実行系と待機系の両方に接続されたディスク装置です。フェールオーバー時に引き継ぐ情報（定義情報，実行状況など）を保存すると，実行系の論理ホストで障害が発生した場合，待機系のサーバが共有ディスクへの接続を引き継ぎます。

論理IPアドレス

論理ホストの動作中に割り当てられるIPアドレスです。実行系のサーバで障害が発生したときは，同じ論理IPアドレスの割り当てを待機系のサーバが引き継ぎます。そのため，クライアントからは同じIPアドレスでアクセスでき，一つのサーバが常に動作しているように見えます。

正常時，およびフェールオーバー後のアクセスを次の図に示します。

図5‒1　正常時，およびフェールオーバー後のアクセス

実行系サーバが稼働している場合は，実行系サーバで共有ディスクや論理IPアドレスが割り当てられ，サービスが動作します。実行系サーバで障害が発生すると，待機系サーバが共有ディスクと論理IPアドレスを引き継ぎ，実行系サーバと同じサービスを起動します。フェールオーバーによって物理的なサーバが変わっても，待機系サーバが共有ディスクと論理IPアドレスを引き継ぐため，クライアントには同じIPアドレスのサーバが動作しているように見えます。

5.1.2　JP1/Baseのクラスタ運用の概要

JP1/Baseを論理ホスト環境で動作させるためには，フェールオーバー時に引き継ぎが必要なデータを格納するための共有ディスク，および論理IPアドレスが必要となります。また，クラスタソフトがJP1/Baseの起動・動作監視・停止を制御できるように，クラスタソフトに登録する必要があります。論理ホストをセットアップすると，引き継ぎが必要なデータを共有ディスクに格納し，論理IPアドレスを使用して通信するように設定されます。論理ホスト環境で実行されるJP1/Baseは，共有ディスクに格納したデータを使用し，フェールオーバー時に実行系から待機系に引き継いで処理を続けられます。

次節以降では，クラスタシステムでJP1/Baseを運用するための前提条件，および環境設定の方法について説明します。

5.2　クラスタ運用の前提条件とサポート範囲

JP1は，クラスタシステムでは論理ホスト環境で動作し，フェールオーバーに対応します。論理ホスト環境で実行する場合のJP1の前提条件は，共有ディスクや論理IPアドレスの割り当て・削除・動作監視がクラスタソフトによって正常に制御されていることです。

注意事項

JP1がサポートしているクラスタソフトであっても，システム構成や環境設定によってはここで説明する前提条件を満たさない場合があります。前提条件を満たすよう，システム構成や環境設定を検討してください。

5.2.1　論理ホスト環境の前提条件

JP1を論理ホスト環境で実行する場合，論理IPアドレスと共有ディスクについて，次に示す前提条件があります。

表5‒2　論理ホスト環境の前提条件

論理ホストの

構成要素

前提条件

共有ディスク

実行系から待機系へ引き継ぎできる共有ディスクが使用できること。

JP1を起動する前に，共有ディスクが割り当てられること。

JP1を実行中に，共有ディスクの割り当てが解除されないこと。

JP1を停止した後に，共有ディスクの割り当てが解除されること。

共有ディスクが，不当に複数サーバから使用されないよう排他制御されていること。

システムダウンなどでファイルが消えないよう，ジャーナル機能を持つファイルシステムなどでファイルを保護すること。

フェールオーバーしてもファイルに書き込んだ内容が保証されて引き継がれること。

フェールオーバー時に共有ディスクを使用中のプロセスがあっても，強制的にフェールオーバーができること。

共有ディスクの障害を検知した場合の回復処置はクラスタソフトなどが制御し，回復処置をJP1が意識する必要がないこと。回復処置の延長でJP1の起動や停止が必要な場合は，クラスタソフトからJP1に起動や停止の実行要求をすること。

JP1が使用する共有ディスクには，SCSIまたはSAN（Fibre）で接続されたストレージを使用すること。ネットワーク接続のディスク（NFS，NASなど）を共有ディスクとして使用しないこと。なお，性能はディスクにより異なるため事前に検証をすること。

論理IPアドレス

引き継ぎできる論理IPアドレスを使って通信できること。

論理ホスト名から論理IPアドレスが一意に求まること。

JP1を起動する前に，論理IPアドレスが割り当てられること。

JP1を実行中に，論理IPアドレスが削除されないこと。

JP1を実行中に，論理ホスト名と論理IPアドレスの対応が変更されないこと。

JP1を停止した後に，論理IPアドレスが削除されること。

ネットワーク障害を検知した場合の回復処置はクラスタソフトなどが制御し，JP1が回復処理を意識する必要がないこと。また，回復処置の延長でJP1の起動や停止が必要な場合は，クラスタソフトからJP1に起動や停止の実行要求をすること。

上記の条件が満たされていない場合は，JP1の動作に問題が起きることがあります。例えば，次のような問題が発生します。

実行系で書き込んだデータが，フェールオーバーした時に壊れてしまう場合

JP1でエラー・データ消失・起動失敗などの問題が発生し，正常に動作できません。

LANボード障害が発生しても回復処理がされない場合

クラスタソフトなどの制御によってLANボードが切り替えられるか，または他サーバへフェールオーバーするまで，通信エラーが発生しJP1は正常に動作できません。

5.2.2　物理ホスト環境の前提条件

物理ホスト環境でJP1を実行する場合，次に示す前提条件があります。また，論理ホスト環境のJP1だけを実行する場合でも，システム環境として次に示す前提条件を満たしている必要があります。

表5‒3　物理ホスト環境の前提条件

物理ホストの

構成要素

前提条件

サーバ本体

2台以上のサーバ機によるクラスタ構成になっていること。

実行する処理に応じたCPU性能があること。

（例えば，論理ホストを多重起動する場合などに，対応できるCPU性能があること）

実行する処理に応じた実メモリー容量があること。

（例えば，論理ホストを多重起動する場合などに，対応できる実メモリー容量があること）

ディスク

システムダウンなどでファイルが消えないよう，ジャーナル機能を持つファイルシステムなどでファイルを保護すること。

ネットワーク

ホスト名（hostnameコマンドの結果）に対応するIPアドレスで通信できること。

（クラスタソフトなどによって通信ができない状態に変更されないこと）

JP1の動作中に，ホスト名とIPアドレスの対応が変更されないこと。

（クラスタソフトやネームサーバなどによって変更がされないこと）

OS，クラスタソフト

JP1がサポートするクラスタソフトおよびバージョンであること。

JP1およびクラスタソフトが前提とするパッチやサービスパックが適用済みであること。

フェールオーバーしても同じ処理ができるよう，各サーバの環境が同じになっていること。

5.2.3　論理ホストの指定

論理ホストでコマンドを実行させるための前提条件として，論理ホスト名を指定する必要があります。論理ホスト名を指定しないと，物理ホストでコマンドが実行されます。

(1)　論理ホストの指定方法

論理ホストの指定方法には，論理ホスト名をJP1_HOSTNAME環境変数に設定する方法と，コマンドオプションで指定する方法があります。それぞれについて次の表で説明します。

指定方法

説明

JP1_HOSTNAME環境変数

JP1_HOSTNAME環境変数で，論理ホスト名を指定します。論理ホスト名をコマンドオプションと環境変数の両方で指定した場合は，コマンドオプションの設定が優先されます。

コマンドオプション

「コマンド -h 論理ホスト名」の形式でコマンドのオプションに指定します。詳細については，各コマンドの説明を参照してください。

注意事項

Windowsの場合，JP1_HOSTNAME環境変数をシステム環境変数，ユーザー環境変数として設定しないでください。サービスの起動などができなくなるおそれがあります。JP1_HOSTNAME環境変数の設定は，コマンドプロンプト，またはバッチファイルで行ってください。

(2)　論理ホスト名の条件

論理ホスト名は次に示す条件で指定してください。

指定できる文字数：Windowsの場合1〜196バイト（推奨：63バイト以内）※1，UNIXの場合1〜255バイト（推奨：63バイト以内）※1※2

使用できる文字：英数字，-（ハイフン）

注※1　JP1/Baseで指定できる文字数は上記のとおりですが，クラスタソフトで上記文字数に対応していない場合があります。論理ホスト名を指定する場合は，クラスタソフトの制限文字数を超えないよう注意してください。実際の運用では，63バイト以内を推奨します。

注※2　UNIX限定の強制終了コマンド（jbs_killall.cluster）で指定できる論理ホスト名は，32バイトまでです。名称が33バイト以上の論理ホスト名は指定できません。

(3)　論理ホスト名の注意事項

論理ホスト名と物理ホスト名（hostnameコマンドの実行結果）を同じ名称にしてJP1を運用する場合，次のことに注意してください。なお，クラスタシステムで指定する論理ホスト名は，物理ホスト名とは異なる名称を使用することを強く推奨します。

論理ホストのJP1だけを起動する。

論理ホストのJP1だけを起動し，物理ホストのJP1は起動しないでください。

イベントサービス環境の設定を変更する。

イベントサーバインデックスファイル（index）に初期設定されている「server * default」の行をコメントにしてください。この行が残っている場合，論理ホストのイベントDBがローカルディスクに作成され，フェールオーバーで引き継ぎができません。実行系と待機系それぞれで設定を変更してください。

なお，イベントサーバインデックスファイル（index）を変更する場合は，物理ホストのイベントサーバを停止した状態で変更してください。

jevlogical_setup.confを共通定義に反映する。

物理ホスト名と同じ名称のイベントサービスを論理ホストとして認識させるため，jevlogical_setup.confを共通定義情報に反映してください。

Windowsの場合

jbssetcnf jevlogical_setup.conf※

UNIXの場合

/opt/jp1base/bin/jbssetcnf jevlogical_setup.conf※

注※　環境変数PATHにJP1/Baseのbinフォルダのパスが設定されていない場合は，フルパスで指定してください。

なお，反映した定義を元に戻す場合は，次の手順を実行してください。

Windowsの場合

1.　次の内容の定義ファイルを作成する。

ファイル名は任意です。

[JP1_DEFAULT¥JP1BASE¥]

"JEVSERVICE_LOGICAL"=dword:00000000

2.　次のコマンドを実行し，作成した定義ファイルの内容を共通定義情報に反映する。

jbssetcnf 定義ファイル名

UNIXの場合

1.　次の内容の定義ファイルを作成する。

ファイル名は任意です。

[JP1_DEFAULT¥JP1BASE¥]

"JEVSERVICE_LOGICAL"=dword:00000000

2.　次のコマンドを実行し，作成した定義ファイルの内容を共通定義情報に反映する。

/opt/jp1base/bin/jbssetcnf 定義ファイル名

統合トレース（HNTRLib2）を再起動する。

システムの動作中にホスト名を変更する場合は，統合トレース（HNTRLib2）の再起動が必要です。次の手順で再起動してください。

Windowsの場合

1.　［コントロールパネル］の［サービス］ダイアログボックスで手動停止する。

2.　ホスト名を変更する。

3.　［コントロールパネル］の［サービス］ダイアログボックスで手動起動する。

UNIXの場合

1.　hntr2killコマンドを使って統合トレース（HNTRLib2）を停止する。

2.　ホスト名を変更する。

3.　次のコマンドを実行し，統合トレース（HNTRLib2）を起動する。

hntr2mon -d &

統合トレース（HNTRLib2）を再起動するまでの間は，トレース情報が記録されません。統合トレースを使用しているすべてのアプリケーションを停止させてから統合トレースを停止し，起動する場合は，ほかのアプリケーションより先に起動させてください。なお，hntr2killコマンドの詳細については，「15.　コマンド」の「hntr2kill（UNIX限定）」を参照してください。

DNS運用の場合は，論理ホスト名にFQDN形式ではないホスト名を使用してください。例えば，「jp1v7.soft.hitachi.co.jp」の場合は，論理ホスト名を「jp1v7」と指定します。このホスト名で名前解決されるように設定してください。

Windowsの場合，JP1_HOSTNAME環境変数をシステム環境変数，ユーザー環境変数として設定しないでください。サービスの起動などができなくなることがあります。JP1_HOSTNAMEの設定は，コマンドプロンプト，またはバッチファイルで行ってください。

UNIXで強制終了コマンド（jbs_killall.cluster）を使用する場合は，論理ホスト名の先頭〜32バイトの範囲で一意になるような名称を指定してください。このコマンドは，論理ホスト名を先頭〜32バイトの範囲で判定して，対応するプロセスを強制終了します。名称が33バイト以上の論理ホストのプロセスは強制終了できません。

5.2.4　JP1がサポートする範囲

クラスタシステムでJP1を運用する場合，JP1がサポートする範囲は，JP1自体の動作だけです。論理ホスト環境（共有ディスクおよび論理IPアドレス）の制御はクラスタソフトの制御に依存します。

また，前述の論理ホスト環境および物理ホスト環境の前提条件が満たされていない，または論理ホスト環境の制御に問題がある場合は，JP1の動作に発生した問題もサポートの対象外となります。この場合は，論理ホスト環境を制御しているクラスタソフトやOSで問題に対処してください。

5.3　クラスタ運用でのJP1/Baseの機能

この節では，クラスタ運用する場合に注意する必要があるJP1/Baseの機能について説明します。

5.3.1　ログファイルトラップのクラスタ運用

ログファイルトラップは，物理ホスト単位で起動します。論理ホスト単位での起動はできません。JP1イベントの登録先を論理ホストのイベントサービスにすると，論理ホストでJP1イベントを管理できます。運用方法に応じてJP1イベントの登録先を変更してください。

JP1イベントを論理ホストのイベントサービスへ登録したい場合は，jevlogstartコマンドの-sオプションに論理ホストのイベントサーバ名を指定して実行してください。jevlogstartコマンドの-sオプションを省略すると，JP1イベントは物理ホストのイベントサービスへ登録されます。

共有ディスク上のログファイルを監視する場合と，ローカルディスク上のログファイルを監視する場合の運用方法について次に説明します。

(1)　共有ディスク上のログファイルを監視する

共有ディスク上のログファイルを監視する場合は，論理ホストの起動と停止に合わせて，ログファイルトラップを起動および停止する必要があります。フェールオーバー時には，切り替え前のサーバのログファイルトラップを停止して，新たに実行系となったサーバでログファイルトラップを起動してください。

ログファイルトラップ起動定義ファイルを使用すると，フェールオーバー時にログファイルトラップをまとめて停止・起動できます。ログファイルトラップをまとめて停止・起動する場合の動作を次に示します。

図5‒2　ログファイルトラップをまとめて停止・起動する場合の動作

ログファイルトラップをまとめて停止・起動する場合，停止・起動するログファイルトラップは，ログファイルトラップ起動定義ファイルに指定します。また，クラスタソフトに，フェールオーバー時に実行するコマンドとしてjevlogstopコマンドおよびjevlogstartコマンドを-clusterオプション指定で登録します。フェールオーバー時，jevlogstart -clusterコマンドが実行されると，新たに実行系となったサーバでログファイルトラップ起動定義ファイルが読み込まれ，起動定義ファイルに指定されたログファイルトラップがまとめて起動されます。また，jevlogstop -clusterコマンドが実行されると，切り替え前のサーバで，以前jevlogstart -clusterコマンドによって起動されたログファイルトラップがまとめて停止されます。

なお，ログファイルトラップ起動定義ファイルを使用した場合は，ログファイルトラップ起動実行結果ログに出力される起動開始情報（KAVA3661-I）および起動結果情報（KAVA3662-I）を参照して，対象のログファイルトラップが起動されたことを確認してください。

フェールオーバー時にログファイルトラップをまとめて停止・起動するための設定方法を次に示します。

ログファイルトラップ起動定義ファイルを編集する。

実行系と待機系のそれぞれで，ログファイルトラップ起動定義ファイルのSTART_OPT_CLSパラメーターに，フェールオーバー時に停止・起動するログファイルトラップを指定します。このとき，START_OPT_CLSパラメーターの指定は，実行系と待機系で一致させてください。なお，複数のクラスタシステムを運用している場合は，クラスタシステムごとに停止・起動するログファイルトラップを指定します。

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

クラスタソフトに，jevlogstop（クラスタ運用限定）コマンドおよびjevlogstart（クラスタ運用限定）コマンドを登録する。

コマンドの詳細については，「15.　コマンド」の「jevlogstop（クラスタ運用限定）」および「jevlogstart（クラスタ運用限定）」を参照してください。

なお，共有ディスク上のログファイルの監視中は，共有ディスクを常にアクセスできるように割り当てたままにしてください。ファイル監視中に共有ディスクの割り当て状態を変更すると，共有ディスクの割り当てや割り当て解除の制御に失敗したり，監視処理がエラーになったりするなどの問題が生じるおそれがあります。

共有ディスク上のログファイルを監視する場合の構成例を次の図に示します。

図5‒3　共有ディスク上のログファイルを監視する場合の構成例

(2)　ローカルディスク上のログファイルを監視する

実行系と待機系両方のローカルディスク上のログファイルを監視する場合は，変換したJP1イベントをいったん物理ホストのイベントサービスに登録してください。そして，必要に応じて転送設定ファイル（forward）で別ホストのイベントサービスに転送するよう設定してください。転送設定ファイルの詳細については，「16.　定義ファイル」の「転送設定ファイル」を参照してください。

ローカルディスクのログファイルを論理ホストで監視する場合の構成例を次の図に示します。

図5‒4　ローカルディスクのログファイルを論理ホストで監視する場合の構成例

5.3.2　イベントログトラップのクラスタ運用

イベントログトラップは，物理ホスト単位で起動します。論理ホスト単位での起動はできません。JP1イベントの登録先を論理ホストのイベントサービスにすると，論理ホストでJP1イベントを管理できます。運用方法に応じてJP1イベントの登録先を変更してください。

論理ホストのイベントサービスへ登録したい場合は，動作定義ファイルのserverパラメーターに論理ホストのイベントサーバ名を指定してください。ただし，変換したJP1イベントを直接論理ホストに登録する構成の場合，待機系のイベントログは監視できません。動作定義ファイルのserverパラメーターでイベントサーバ名を省略すると，JP1イベントは物理ホストのイベントサービスへ登録されます。

実行系と待機系の両方のイベントログを監視したい場合は，変換したJP1イベントをいったん物理ホストのイベントサービスに登録してください。そして，物理ホストのイベントサービスに登録されたJP1イベントを，転送設定ファイル（forward）で論理ホストのイベントサービスに転送してください。転送設定ファイルの詳細については，「16.　定義ファイル」の「転送設定ファイル」を参照してください。

実行系と待機系の両方のイベントログを監視する場合の構成例を次の図に示します。

図5‒5　実行系と待機系のイベントログを論理ホストで監視する場合の構成例

5.3.3　ヘルスチェックのクラスタ運用

ヘルスチェックは，物理ホスト，論理ホスト単位で動作し，各ホストで動作するプロセスを監視します。ヘルスチェックを使用すると，プロセスの停止だけではなくハングアップも異常と判定し，フェールオーバーさせる運用ができます。

プロセスの異常を検知した場合にフェールオーバーさせるためには，共通定義設定用ファイル（ヘルスチェック機能）でフェールオーバーを有効にします。共通定義設定用ファイル（ヘルスチェック機能）の詳細については，「16.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」を参照してください。

クラスタ環境でヘルスチェックを使用する場合の構成例を次の図に示します。

図5‒6　クラスタ環境でヘルスチェックを使用する場合の構成例

図の例は，実行系物理ホスト，待機系物理ホスト，および論理ホストでヘルスチェック機能を使用した場合を示します。自ホストを監視中に論理ホストのヘルスチェックがプロセスの異常を検知した場合は，WindowsではJP1/Baseサービスを停止して，UNIXではヘルスチェック機能のプロセス（jbshcd）を停止します。この停止を検知し，クラスタソフトでフェールオーバーするようにします。

注意事項

他ホストの監視中，エラーを検知している状態でフェールオーバーした場合，監視対象ホストの監視状態がリセットされます。次回監視時に監視対象ホストの状態が回復していないときには，再度エラーメッセージやJP1イベントが発行されます。すでに回復しているときには，回復メッセージやJP1イベントは発行されません。

5.4　クラスタ運用の環境設定（Windowsの場合）

この節では，クラスタ運用に対応するためのJP1/Baseの環境設定について説明します。

5.4.1　環境設定で設定する項目

ここでは，環境設定で設定する項目について説明します。実際の設定手順については，「5.4.3　セットアップ」を参照してください。

(1)　共有フォルダの指定

論理ホストのセットアップ時に，実行系・待機系の切り替え時に情報を共有するための共有フォルダを指定します。指定した共有フォルダの配下に次の表に示すフォルダ，およびファイルを作成します。

共有ファイルの種別

共有ファイルの格納先フォルダ

定義ファイル

共有フォルダ¥jp1base¥conf¥

ログファイル

共有フォルダ¥jp1base¥log¥

イベントサーバ設定ファイル

共有フォルダ¥jp1base¥event¥

共有フォルダは，論理ホストごとに割り当ててください。論理ホストが異なる場合は，必ず別の共有フォルダを割り当ててください。共有ディスクのフォルダ構成例を次に示します。

（例）論理ホストnode0の共有フォルダとして「¥shdsk¥node0」を指定する。

¥shdsk¥node0¥jp1base¥conf¥
¥shdsk¥node0¥jp1base¥log¥

なお，イベントサービスは，独自にクラスタの環境を設定できますが，「5.4.3　セットアップ」の手順どおりに環境設定をすると，イベントサーバインデックスファイル（index）に自動的に論理ホスト名と共有フォルダ下のイベントサーバ設定ファイル（conf）を作成します。

(2)　通信方式の設定

JP1/Baseでクラスタシステム用の設定をすると，TCP/IP通信で使うソケットのバインド方法を，自動的にIPアドレス指定方式に変更します。変更の対象は，作成する論理ホストおよび物理ホストの設定です。JP1/Baseの通信方式については，「2.10　JP1/Baseの通信方式」を参照してください。

なお，同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合は，ネットワーク制御の設定が必要です。詳細については，「5.4.5　同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定」を参照してください。

(3)　共通定義情報の設定

JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）は，論理ホストごとの情報を共通定義情報としてローカルディスク上に持っており，論理ホストごとにその情報を同じ内容にする必要があります。

共通定義情報は，次に示す操作をしたときに更新されます。

JP1/Base，およびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の共通定義情報を変更した場合

jbsmkumapコマンド，jbssetumapコマンド，jbsrmumapコマンド，または［JP1/Base環境設定］ダイアログボックスでユーザーマッピング情報を変更した場合

jbssetupsrvコマンドまたは［JP1/Base環境設定］ダイアログボックスで認証サーバを変更した場合

jbsunsetcnfコマンドまたはjp1bshasetupコマンドを実行して，論理ホストの共通定義情報を削除した場合

jbsmkpassコマンド，jbspassmgrコマンド，jbsumappassコマンド，jbsrmumappassコマンド，または［JP1/Base環境設定］ダイアログボックスでOSユーザーのパスワード管理情報を変更した場合

jbshostsimportコマンドを実行して，jp1hosts情報を変更した場合

jbschgdsコマンドを実行して，連携するディレクトリサーバを変更した場合

jcocmddefコマンドを実行して，コマンド実行環境を設定した場合

共通定義情報を変更した場合は，「5.6　クラスタ運用中の設定変更時の作業」を参照して，共通定義情報を各サーバ上で一致させる作業を行ってください。

(4)　クラスタソフトへの登録

クラスタソフトが論理ホストのJP1/Baseを制御できるようにするために，論理ホストに対応するJP1/Baseのサービスをクラスタソフトに登録します。論理ホストのサービスは，論理ホストをセットアップしたときに作成されます。

5.4.2　インストール

実行系と待機系それぞれのローカルディスク上にJP1/Baseをインストールしてください。Windowsの場合は，実行系・待機系とも，同じ名称のドライブおよびフォルダにインストールする必要があります。なお，共有ディスク上には，JP1/Baseをインストールしないでください。

07-10以前のJP1/Baseでクラスタシステムをご使用の場合，上書きインストールしたあとに，論理ホスト環境のアップグレードが必要です。論理ホスト環境のアップグレードの詳細設定については，「3.2.3(5)　上書きインストールについて」を参照してください。

5.4.3　セットアップ

JP1/Baseをクラスタシステムで実行するには，物理ホスト環境（実行系および待機系），論理ホスト環境（実行系および待機系）のセットアップが必要です。セットアップの流れを次に示します。

図5‒7　クラスタシステムでのセットアップの流れ（Windows）

(1)　実行系での作業

実行系の物理ホスト，および論理ホストをセットアップします。

物理ホストのユーザー管理機能を設定する。

物理ホストで認証サーバを運用する場合に設定します。ユーザー管理機能の設定については，「8.1　ユーザー管理の設定（Windowsの場合）」を参照してください。

論理ホストを設定する。

GUIで設定する場合

1.　インストール先フォルダ¥bin¥jp1bshasetup.exeを実行する。

図5‒8　［Baseクラスタ構成の設定］ダイアログボックス

2.　［Baseクラスタ構成の設定］ダイアログボックスの［実行系 論理ホストの設定］ボタンをクリックする。

図5‒9　［実行系 論理ホストの設定］ダイアログボックス

［実行系 論理ホストの設定］ダイアログボックスで，情報を作成する論理ホスト名，および共有フォルダ，共有ファイルを作成する共有ディスク上のフォルダを指定します。

「指定したフォルダ名¥jp1base¥」フォルダ下に，共有フォルダおよび共有ファイルが作成されます。なお，この指定をする前に，必ず共有ディスクをマウントしておいてください。

3.　［次へ］ボタンをクリックする。

図5‒10　［実行系 論理ホストの設定］ダイアログボックス（確認画面）

［実行系 論理ホストの設定］ダイアログボックス（確認画面）で，設定内容を確認できます。設定内容が正しければ，［完了］ボタンをクリックしてください。

以上で，イベントサービスの通信方式の設定以外の設定が完了します。

4.　論理ホストの認証サーバを設定する。

論理ホストには，物理ホストで設定されている認証サーバが設定されます。物理ホストと異なる認証サーバを設定する場合，GUIで設定してください。詳細については，「8.1.1　使用する認証サーバを指定する」を参照してください。

コマンドを使って設定する場合

次のコマンドを実行します。共有ディスク上に共有フォルダおよび共有ファイルを作成し，認証サーバを設定します。

jbs_setup_cluster -h node0 -d d:¥node0 -a node0

jbs_setup_clusterコマンドの詳細については，「15.　コマンド」の「jbs_setup_cluster（Windows限定）」を参照してください。

論理ホストのユーザー管理機能の設定をする。（論理ホストを認証サーバとして使用する場合だけ）

ユーザー管理機能の設定詳細については，「8.1 ユーザー管理の設定（Windowsの場合）」を参照してください。

GUIで設定する場合

1.　Windowsのスタートメニューから［プログラム］−［JP1_Base］−［JP1_Base Setup］を選択する。

2.　［論理ホスト名の選択］ダイアログボックスでユーザー管理機能の設定をしたい論理ホストを選択する。

3.　JP1ユーザーを登録する。

4.　JP1ユーザーの操作権限を設定する。

コマンドを使って設定する場合

1.　JP1ユーザーを登録する。

認証サーバが起動していることを確認したあと，次に示すコマンドを実行して登録します。

jbsadduser -h 論理ホスト名 JP1ユーザー名

登録したJP1ユーザーを確認したい場合は次のコマンドを実行します。

jbslistuser -h 論理ホスト名

2.　JP1ユーザーの操作権限を設定する。

ユーザー権限レベルファイル（JP1_UserLevel）の格納先を次に示します。

共有フォルダ¥jp1base¥conf¥user_acl¥JP1_UserLevel

ユーザー権限レベルファイル（JP1_UserLevel）の編集後，jbsaclreloadコマンドを実行して設定を反映します。

ユーザーマッピングの情報を共通定義情報に登録する。

ユーザーマッピングの情報の設定詳細については，「8.1 ユーザー管理の設定（Windowsの場合）」を参照してください。

GUIを使って設定する場合

1.　Windowsのスタートメニューから［プログラム］−［JP1_Base］−［JP1_Base Setup］を選択する。

2.　［論理ホスト名の選択］ダイアログボックスでユーザー管理機能の設定をしたい論理ホストを選択する。

3.　［JP1/Base環境設定］ダイアログボックスの［ﾕｰｻﾞｰﾏｯﾋﾟﾝｸﾞ］タブを選択する。

4.　ユーザーマッピング情報を設定する。

コマンドを使って設定する場合

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の格納先を次に示します。

共有フォルダ¥jp1base¥conf¥user_acl¥jp1BsUmap.conf

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の編集後，次のコマンドを実行して登録します。

jbsmkumap -h 論理ホスト名

登録したユーザーマッピング情報を確認したい場合は，次に示すコマンドを実行します。

jbsgetumap -h 論理ホスト名

JP1/Base本体の通信方式を変更する。

必要に応じて，物理ホストおよび論理ホストのJP1/Base本体の通信方式を変更します。

通信方式の変更が必要かどうか，および設定方法については，「6.　ネットワーク構成に応じたJP1/Baseの通信設定」を参照してください。

認証サーバをクラスタシステムで運用する場合の注意事項

認証サーバの設定ファイルは次のフォルダに格納されます。

共有フォルダ¥jp1base¥conf¥user_acl¥

セカンダリー認証サーバを設置する場合は，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバへコピーする必要があります。その際，セカンダリー認証サーバをクラスタ運用するかしないかで，設定ファイルのコピー先が異なるため注意が必要です。

クラスタ運用する場合のコピー先

共有フォルダ¥jp1base¥conf¥user_acl¥

クラスタ運用しない場合のコピー先

インストール先フォルダ¥conf¥user_acl¥

設定ファイルをコピーしたあとに，次のコマンドを実行して設定を反映させてください。セカンダリー認証サーバをクラスタ運用しない場合は，-hオプションの指定は不要です。

jbs_spmd_reload -h 論理ホスト名

同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定をする。

同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合は，ネットワーク制御の設定が必要です。詳細については，「5.4.5　同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定」を参照してください。

以上で，JP1/Baseの実行系での作業は完了です。

JP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）をインストールしている場合は，各製品のフェールオーバーの設定をしてください。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」，「JP1/Integrated Management 3 - Manager 運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，「JP1/Automatic Job Management System 3 運用ガイド」，および「JP1/Power Monitor」を参照してください。

(2)　待機系での作業

待機系の物理ホスト，および論理ホストをセットアップします。

なお，待機系での作業は，実行系でのJP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の作業を完了したあとで行います。

物理ホストのユーザー管理機能を設定する。

物理ホストで認証サーバを運用する場合に設定します。ユーザー管理機能の設定については，「8.1　ユーザー管理の設定（Windowsの場合）」を参照してください。

実行系でjbsgetcnfコマンドを実行する。

実行系で次に示すコマンドを実行してください。退避ファイル内に共通定義情報が格納されます。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

なお，論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。

退避ファイルを待機系にコピーする。

待機系でjbssetcnfコマンドを実行する。

待機系で次に示すコマンドを実行してください。なお，指定する退避ファイルは，jbsgetcnfコマンドで採取した退避ファイルです。

jbssetcnf 退避ファイル名

論理ホストを設定する。

GUIで設定する場合

1.　インストール先フォルダ¥bin¥jp1bshasetup.exeを実行する。

2.　［Baseクラスタ構成の設定］ダイアログボックスの［待機系 論理ホストの設定］ボタンをクリックする。

［待機系 論理ホストの設定］ダイアログボックスで，実行系で設定した論理ホスト名を選択します。

図5‒11　［待機系 論理ホストの設定］ダイアログボックス

3.　［次へ］ボタンをクリックする。

図5‒12　［待機系 論理ホストの設定］ダイアログボックス（確認画面）

［待機系 論理ホストの設定］ダイアログボックス（確認画面）で，選択した論理ホストの設定内容を確認できます。設定内容が正しければ，［完了］ボタンをクリックしてください。

コマンドを使って設定する場合

次のコマンドを実行します。

jbs_setup_cluster -h node0

jbs_setup_clusterコマンドの詳細については，「15.　コマンド」の「jbs_setup_cluster（Windows限定）」を参照してください。

JP1/Base本体の通信方式を変更する。

必要に応じて，物理ホストのJP1/Base本体の通信方式を変更します。論理ホストの設定は必要ありません。

通信方式の変更が必要かどうか，および設定方法については，「6.　ネットワーク構成に応じたJP1/Baseの通信設定」を参照してください。

同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定をする。

同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合は，ネットワーク制御の設定が必要です。詳細については，「5.4.5　同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定」を参照してください。

以上で，JP1/Baseの設定が完了します。

5.4.4　クラスタソフトへの登録

使用するクラスタソフトに，論理ホストのJP1/Baseのサービスを登録してください。Windowsの場合，クラスタソフトに登録するのは，環境設定で登録された次の名称のサービスです。

名前

サービス名

JP1/Base_論理ホスト名

JP1_Base_論理ホスト名

JP1/Base Event 論理ホスト名

JP1_Base_Event 論理ホスト名

注意事項

「JP1_Base_Event 論理ホスト名」の「論理ホスト名」は，このマニュアルのイベントサービスに関する記述の「イベントサーバ名」に対応しています。

登録方法の詳細については，各クラスタソフトのマニュアルを参照してください。また，指定の際は，次の点に注意してください。

サービスは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。また，アプリケーションプログラムのフェールオーバーに伴ってフェールオーバーする場合は，アプリケーションプログラムも一緒に引き継がれるようにしてください。

論理IPアドレスと共有ディスクが使用できるようになったあと，「JP1_Base_Event 論理ホスト名」を起動し，そのあとに「JP1_Base_論理ホスト名」を起動するように設定してください。JP1/IMやJP1/AJSについては，「JP1_Base_論理ホスト名」のあとに起動するように設定してください。また，停止する場合は，起動時と逆の順序で停止するように設定してください。

5.4.5　同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定

同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合，ネットワーク制御の設定が必要です。Windowsでこの設定をしない場合，論理ホストのIPアドレスが物理ホストに割り当たった状態で動作するため，論理ホストへの要求を物理ホストが受信することがあります。また，運用中に物理ホスト名から解決されるIPアドレスが予期しないIPアドレスに変更され，JP1の通信が正常に機能しないことがあります。これを回避するには，論理ホストのJP1/Baseを構築するときに，次に示す手順でネットワーク制御を設定してください。

テキストエディター（メモ帳など）で次に示すような定義ファイルを作成する。

物理ホスト名 物理IPアドレス #ノード1

物理ホスト名 物理IPアドレス #ノード2

定義ファイルのファイル名は任意です。物理ホスト名と物理IPアドレスは，そのホストの環境に合わせて定義してください。物理ホスト名には，hostnameコマンドを実行した結果，表示されるホスト名を指定してください。また，物理ホスト名と物理IPアドレスの間は，一つ以上の半角スペースかタブで区切ってください。#以降は改行されるまでコメント扱いとなります。なお，ファイルの最終行には改行を入れてください。

（例）jp1-node1（IPアドレスは100.100.100.1）とjp1-node2（IPアドレスは100.100.100.2）の2ノードクラスタ，論理ホストjp1-clusterの場合，次に示す定義ファイルを作成します。

jp1-node1 100.100.100.1

jp1-node2 100.100.100.2

jp1hosts情報またはjp1hosts2情報の設定を反映する。

jp1hosts情報の場合

jbshostsimportコマンドを実行して，定義ファイルの内容を物理ホスト，論理ホストの共通定義情報に反映します。jbshostsimportコマンドの詳細については，「15.　コマンド」の「jbshostsimport」を参照してください。

また，イベントサービスの通信設定も変更します。

（例）物理ホスト，論理ホストの共通定義情報に反映するために，次に示すようにjbshostsimportコマンドを実行します。

・物理ホスト，論理ホストのJP1/Baseのサービスを停止

・jbshostsimport -o 定義ファイル名

・jbshostsimport -o 定義ファイル名 -h jp1-cluster

・物理ホストのイベントサーバ設定ファイル（conf）のportsパラメーターを設定

（例）

jp1-node1：

ports 100.100.100.1 jp1imevt jp1evtapi

jp1-node2：

ports 100.100.100.2 jp1imevt jp1evtapi

・API設定ファイル（api）のserverパラメーターを追加

（例）

server jp1-node1 keep-alive 100.100.100.1

server jp1-node2 keep-alive 100.100.100.2

・物理ホスト，論理ホストのJP1/Baseのサービスを起動

jp1hosts2情報の場合

jbshosts2importコマンドを実行して，定義ファイルの内容を物理ホストに登録します。jbshosts2importコマンドの詳細については，「15.　コマンド」の「jbshosts2import」を参照してください。

なお，イベントサービスの通信設定を変更する必要はありません。

（例）次に示すようにjbshosts2importコマンドを実行します。

・物理ホスト，論理ホストのJP1/Baseのサービスを停止

・jbshosts2import -o 定義ファイル名

・物理ホスト，論理ホストのJP1/Baseのサービスを起動

なお，論理ホストのjp1hosts2情報で+PhysicalMergeパラメーターに0を設定している場合は，論理ホストのjp1hosts2情報にも定義ファイルの内容を登録してください。

jp1hosts情報またはjp1hosts2情報に反映した内容を確認する。

次に示すコマンドを実行して，反映した内容が正しいか確認します。

（例）

物理ホストjp1-node1の設定確認

c:¥>インストール先フォルダ¥bin¥jp1ping jp1-node1

LogicalHostnameKey : no define. use JP1_DEFAULT

jp1hosts : Use jp1hosts entry in JP1_DEFAULT

Search jp1hosts : jp1-node1 is found.

Resolved Host List : jp1-node1 -> jp1-node1(100.100.100.1)

：

物理ホストjp1-node2の設定確認

c:¥>インストール先フォルダ¥bin¥jp1ping jp1-node2

LogicalHostnameKey : no define. use JP1_DEFAULT

jp1hosts : Use jp1hosts entry in JP1_DEFAULT

Search jp1hosts : jp1-node2 is found.

Resolved Host List : jp1-node2 -> jp1-node2(100.100.100.2)

：

論理ホストjp1-clusterの設定確認

c:¥>インストール先フォルダ¥bin¥jp1ping -h jp1-cluster jp1-node1

LogicalHostnameKey : jp1-cluster

jp1hosts : Use jp1hosts entry in jp1-cluster

Search jp1hosts : jp1-node1 is found.

Resolved Host List : jp1-node1 -> 100.100.100.1(100.100.100.1)

：

c:¥>インストール先フォルダ¥bin¥jp1ping -h jp1-cluster jp1-node2

LogicalHostnameKey : jp1-cluster

jp1hosts : Use jp1hosts entry in jp1-cluster

Search jp1hosts : jp1-node2 is found.

Resolved Host List : jp1-node2 -> 100.100.100.2(100.100.100.2)

：

この例のように，Resolved Host Listの行に，設定したとおりに「物理IPアドレス」が表示されている場合は，正しく設定されています。もし，設定した内容と表示が異なる場合は，定義ファイルを見直してやり直してください。

5.5　クラスタ運用の環境設定（UNIXの場合）

この節では，クラスタ運用に対応するためのJP1/Baseの環境設定について説明します。

5.5.1　環境設定で設定する項目

ここでは，環境設定で設定する項目について説明します。実際の設定手順については，「5.5.3　セットアップ」を参照してください。

(1)　共有ディスク上への共有ファイルの作成

実行系・待機系の切り替え時に情報を共有するために，次の表に示すディレクトリ，およびファイルを共有ディスク上に作成します。

共有ファイルの種別

共有ファイルの格納先ディレクトリ

定義ファイル

共有ディレクトリ/jp1base/conf/

ログファイル

共有ディレクトリ/jp1base/log/

イベントサーバ設定ファイル

共有ディレクトリ/event/

ディレクトリは，論理ホストごとに割り当ててください。論理ホストが異なる場合は，必ず別のディレクトリを割り当ててください。論理ホストごとに割り当てたディレクトリの下位に，共有するディレクトリ，ファイルを作成します。

共有ディスクのディレクトリ構成例を次に示します。

（例）論理ホストnode0の共有ディレクトリとして「/shdsk/node0」を指定する。

/shdsk/node0/jp1base/conf/
/shdsk/node0/jp1base/log/

なお，イベントサービスは，独自にクラスタ運用の環境を設定できますが，「5.5.3　セットアップ」の手順どおりに環境設定をすると，イベントサーバインデックスファイル（index）に自動的に論理ホスト名と共有ディレクトリ下のイベントサーバ設定ファイル（conf）を作成します。

(2)　通信方式の設定

JP1/Baseでクラスタシステム用の設定をすると，TCP/IP通信で使うソケットのバインド方法を，自動的にIPアドレス指定方式に変更します。変更の対象は，作成する論理ホストおよび物理ホストの設定です。JP1/Baseの通信方式については，「2.10　JP1/Baseの通信方式」を参照してください。

(3)　共通定義情報の設定

JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）は，論理ホストごとの情報を共通定義情報としてローカルディスク上に持っており，論理ホストごとにその情報を同じ内容にする必要があります。

共通定義情報は，次に示す操作をしたときに更新されます。

JP1/Base，およびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の共通定義情報を変更した場合

jbsmkumapコマンド，jbssetumapコマンド，またはjbsrmumapコマンドを実行して，ユーザーマッピング情報を変更した場合

jbssetusrsrvコマンドを実行して，認証サーバを変更した場合

jbsunsetcnfコマンドを実行して，論理ホストの共通定義情報を削除した場合

jbshostsimportコマンドを実行して，jp1hosts情報を変更した場合

jcocmddefコマンドを実行して，コマンド実行環境を設定した場合

共通定義情報を変更した場合は，「5.6　クラスタ運用中の設定変更時の作業」を参照して，共通定義情報を各サーバ上で一致させる作業を行ってください。

(4)　クラスタソフトへの登録

論理ホストを起動，停止する場合，クラスタソフトは，サービス・共有ディスク・論理IPアドレスの起動や停止，割り当てや解放などを制御します。共有ディスクや論理IPアドレスの制御はクラスタソフトがあらかじめ機能として持っていますが，サービスを制御する機能は持っていないため，サービスを制御するための機能をクラスタソフトに登録する必要があります。

クラスタソフトに登録する機能と，各機能で使用するコマンドを次の表に示します。

登録する機能

説明

使用するコマンド

起動

JP1/Baseを起動します。

jbs_start.cluster 論理ホスト名

停止

JP1/Baseを停止します。

jbs_stop.cluster 論理ホスト名

動作監視

JP1/Baseが正常に動作していることを監視します。または，その時点で正常に動作しているかどうかを確認します。なお，この機能を提供していないクラスタソフトもあります。JP1/Baseの障害時にフェールオーバーする必要がない場合，この機能は登録しません。

jbs_spmd_status -h 論理ホスト名

強制停止

JP1/Baseを強制的に停止し，使用中のリソースを解放します。

jbs_killall.cluster 論理ホスト名

なお，jbs_start.clusterコマンドおよびjbs_stop.clusterコマンド内では，次に示すコマンドが実行されます。

jbs_start.clusterコマンド内で実行されるコマンド

jevstart 論理ホスト名（イベントサービスを起動するコマンド）

jbs_spmd -h 論理ホスト名（イベントサービス以外のJP1/Baseのプロセスを起動するコマンド）

jbs_stop.clusterコマンド内で実行されるコマンド

jevstop 論理ホスト名（イベントサービスを停止するコマンド）

jbs_spmd_stop -h 論理ホスト名（イベントサービス以外のJP1/Baseのプロセスを停止するコマンド）

注意事項

jevstartコマンドおよびjevstopコマンドに指定する論理ホスト名は，このマニュアルのイベントサービスに関する記述の「イベントサーバ名」に対応しています。

論理ホスト用の自動起動スクリプト（jbs_start.cluster）は，初期設定でLC_ALL，LC_COLLATE，LC_CTYPE，LC_MONETARY，LC_NUMERIC，LC_TIME，およびLC_MESSAGESのロケール設定を解除（unset）します。

5.5.2　インストール

実行系，待機系それぞれのローカルディスク上にJP1/Baseをインストールしてください。なお，共有ディスク上には，JP1/Baseをインストールしないでください。

07-10以前のJP1/Baseでクラスタシステムをご使用の場合，上書きインストールしたあとに，論理ホスト環境のアップグレードが必要です。論理ホスト環境のアップグレードの詳細設定については，「3.3.4(5)　上書きインストールについて」を参照してください。

5.5.3　セットアップ

JP1/Baseをクラスタシステムで実行するには，物理ホスト環境（実行系および待機系），論理ホスト環境（実行系および待機系）のセットアップが必要です。セットアップの流れを次に示します。なお，セットアップする前に，物理ホストで言語種別を設定する必要があります。物理ホストで設定した言語種別が，論理ホストへ引き継がれます。言語種別の設定方法については，「3.4.2　使用する言語種別を設定する（UNIXの場合）」を参照してください。

図5‒13　クラスタシステムでのセットアップの流れ（UNIX）

(1)　実行系での作業

実行系の物理ホスト，および論理ホストをセットアップします。

物理ホストのユーザー管理機能を設定する（物理ホストで認証サーバを運用する場合）。

物理ホストで認証サーバを運用する場合に設定します。ユーザー管理機能の設定については，「8.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

論理ホストを設定する。

次のコマンドを実行します。共有ディスク上に共有ディレクトリおよび共有ファイルを作成し，認証サーバを設定します。

jp1base_setup_cluster -h node0 -d /shdsk/node0 -a node0 -s

jp1base_setup_clusterコマンドの詳細については，「15.　コマンド」の「jp1base_setup_cluster（UNIX限定）」を参照してください。

論理ホストのユーザー管理機能を設定する。

論理ホストを認証サーバにしている場合のJP1ユーザーの登録，ユーザーマッピングの設定，JP1ユーザーの操作権限の設定を次に示します。

JP1ユーザーを登録する（論理ホストを認証サーバとして使用する場合だけ）

認証サーバが起動していることを確認したあと，次に示すコマンドを実行して登録します。

jbsadduser -h 論理ホスト名 JP1ユーザー名

登録したJP1ユーザーを確認したい場合は次のコマンドを実行します。

jbslistuser -h 論理ホスト名

ユーザーマッピングの情報を共通定義情報に登録する。

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の格納先を次に示します。

共有ディレクトリ/jp1base/conf/user_acl/jp1BsUmap.conf

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の編集後，次のコマンドを実行して登録します。

jbsmkumap -h 論理ホスト名

登録したユーザーマッピング情報を確認したい場合は，次に示すコマンドを実行します。

jbsgetumap -h 論理ホスト名

JP1ユーザーの操作権限を設定する（論理ホストを認証サーバとして使用する場合だけ）

ユーザー権限レベルファイル（JP1_UserLevel）の格納先を次に示します。

共有ディレクトリ/jp1base/conf/user_acl/JP1_UserLevel

ユーザー権限レベルファイル（JP1_UserLevel）の編集後，jbsaclreloadコマンドを実行して設定を反映します。

ユーザー管理機能の設定詳細については，「8.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

JP1/Base本体の通信方式を変更する。

必要に応じて，物理ホストおよび論理ホストのJP1/Base本体の通信方式を変更します。

通信方式の変更が必要かどうか，および設定方法については，「6.　ネットワーク構成に応じたJP1/Baseの通信設定」を参照してください。

認証サーバをクラスタシステムで運用する場合の注意事項

認証サーバの設定ファイルは次のディレクトリに格納されます。

共有ディレクトリ/jp1base/conf/user_acl/

セカンダリー認証サーバを設置する場合は，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバへコピーする必要があります。その際，セカンダリー認証サーバをクラスタ運用するかしないかで，設定ファイルのコピー先が異なるため注意が必要です。

クラスタ運用する場合のコピー先

共有ディレクトリ/jp1base/conf/user_acl/

クラスタ運用しない場合のコピー先

/etc/opt/jp1base/conf/user_acl/

設定ファイルをコピーしたあとに，次のコマンドを実行して設定を反映させてください。セカンダリー認証サーバをクラスタ運用しない場合は，-hオプションの指定は不要です。

jbs_spmd_reload -h 論理ホスト名

認証サーバをクラスタシステムで運用しない場合の注意事項

jp1base_setup_clusterコマンドで-sオプションを省略して実行すると，その論理ホストのJP1/Baseでは認証サーバのプロセスは起動しません。

jp1base_setup_clusterコマンド実行後に，構成変更をして論理ホストで認証サーバのプロセスを起動したい場合は以下の手順で設定変更をしてください。

1.　JP1/Baseを停止する。

構成変更をする論理ホストおよび論理ホストのJP1/Baseと依存関係を持つプログラムも停止してください。

2.　定義ファイルを変更する。

以下のコマンドを実行して，JP1/Baseのプロセス定義ファイルを変更してください。

cd /共有ディレクトリ/jp1base/conf

cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

3.　JP1/Baseを再起動する。

構成変更をする論理ホストおよび論理ホストのJP1/Baseと依存関係を持つプログラムも再起動してください。

上記定義の変更はJP1/Baseを再起動すれば反映されます。

以上で，実行系での作業は完了です。

JP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）をインストールしている場合，各製品のフェールオーバーの設定をしてください。詳細については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」，「JP1/Integrated Management 3 - Manager 運用ガイド」，「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，「JP1/Automatic Job Management System 3 運用ガイド」，および「JP1/Power Monitor」を参照してください。

(2)　待機系での作業

待機系の物理ホスト，および論理ホストをセットアップします。

待機系での作業は，実行系でのJP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の設定が完了したあとで行います。

物理ホストのユーザー管理機能を設定する（物理ホストで認証サーバを運用する場合）。

物理ホストで認証サーバを運用する場合に設定します。ユーザー管理機能の設定については，「8.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

実行系でjbsgetcnfコマンドを実行する。

実行系で次に示すコマンドを実行してください。退避ファイル内に共通定義情報が格納されます。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

なお，論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。

退避ファイルを待機系にコピーする。

待機系でjbssetcnfコマンドを実行する。

待機系で次に示すコマンドを実行してください。なお，指定する退避ファイルは，jbsgetcnfコマンドで採取した退避ファイルです。

jbssetcnf 退避ファイル名

論理ホストを設定する。

次のコマンドを実行します。

jp1base_setup_cluster -h node0

jp1base_setup_clusterコマンドの詳細については，「15.　コマンド」の「jp1base_setup_cluster（UNIX限定）」を参照してください。

JP1/Base本体の通信方式を変更する。

必要に応じて，物理ホストのJP1/Base本体の通信方式を変更します。論理ホストの設定は必要ありません。

通信方式の変更が必要かどうか，および設定方法については，「6.　ネットワーク構成に応じたJP1/Baseの通信設定」を参照してください。

以上で，JP1/Baseの設定が完了します。

5.5.4　クラスタソフトへの登録

使用するクラスタソフトに，JP1/Baseのデーモンを登録してください。登録方法の詳細については，各クラスタソフトのマニュアルを参照してください。また，指定の際は，次の点に注意してください。

デーモンは，使用するIPアドレスおよび共有ディスクと一緒に，実行系から待機系に引き継がれるようにしてください。また，アプリケーションプログラムのフェールオーバーに伴ってフェールオーバーする場合は，アプリケーションプログラムも一緒に引き継がれるようにしてください。

論理IPアドレスと共有ディスクが使用できるようになったあと，JP1/Baseを起動し，そのあとにJP1/IMやJP1/AJSを起動するように設定してください。また，停止する場合は，起動時と逆の順序で停止するように設定してください。

クラスタソフトへの登録をする前に，jbs_start.clusterの環境変数LANGの値を，論理ホストのjp1bs_env.confの言語種別に変更してください。

JP1/Baseをクラスタソフトへ登録する場合に必要な情報を次の表に示します。

登録する機能

説明

起動

JP1/Baseを起動します。

使用するコマンド

jbs_start.cluster 論理ホスト名

起動コマンドの終了タイミング

起動コマンドは，JP1/Baseが起動するのを待って終了します。ただし，何らかの問題によって，タイムアウト時間（標準60秒）を過ぎても起動処理が完了しない場合は，起動処理の途中でコマンドが終了します。この場合，起動処理は中断しないで，起動処理を続けている状態のままコマンドが終了します。

起動コマンドの結果判定

JP1/Baseを起動した結果は，この表の動作監視の項目を参照して判定してください。通常は，クラスタソフトの動作監視によって判定します。なお，起動コマンドの戻り値は，0（正常終了）と1（引数異常）のため，戻り値での結果判定はできません。

停止

JP1/Baseを停止します。

使用するコマンド

jbs_stop.cluster 論理ホスト名

停止コマンドの終了タイミング

停止コマンドは，JP1/Baseが停止するのを待って終了します。ただし，何らかの問題によって，タイムアウト時間（標準60秒）を過ぎても停止処理が完了しない場合は，停止処理の途中でコマンドが終了します。この場合，停止処理は中断しないで，停止処理を続けている状態のままコマンドが終了します。

停止コマンドの結果判定

JP1/Baseを停止した結果は，この表の動作監視の項目を参照して判定してください。なお，停止コマンドの戻り値は，0（正常終了）と1（引数異常）のため，戻り値での結果判定はできません。

〈備考〉

停止コマンドが終了したあと，jbs_spmd_statusコマンドおよびjevstatコマンドで，JP1/Baseが正常に停止したか確認してください。停止していない場合は，強制停止の項目で説明しているコマンドを実行してください。

動作監視

JP1/Baseが正常に動作していることを，jbs_spmd_statusコマンドおよびjevstatコマンドの戻り値によって監視します。なお，これらのコマンドでは，各プロセスが動作しているか，動作していないかで動作状態を判定しています。

この機能を提供していないクラスタソフトもあります。JP1/Baseの障害時にフェールオーバーする必要がない場合，この機能は登録しません。

使用するコマンド

jbs_spmd_status -h論理ホスト名

jevstat 論理ホスト名

動作監視の結果判定

各戻り値の判定方法を次に示します。

戻り値=0 (すべて動作)

JP1/Baseは正常に動作しています。

戻り値=1 (エラー)

回復不能なエラーが発生しました。異常と判定してください。

〈注意〉

共有ディスクがオフラインの待機系でjbs_spmd_statusコマンドを実行すると，共有ディスクがないため戻り値が1になります。

戻り値=4 (一部停止)

JP1/Baseの一部のプロセスが，何らかの問題によって停止しています。異常と判定してください（UNIXの場合）。※

戻り値=8 (すべて停止)

JP1/Baseのプロセスが何らかの問題によって停止しています。異常と判定してください。

戻り値=12 (リトライ可能エラー)

jbs_spmd_statusコマンドによる動作状態の確認中に，リトライによって復旧できるエラーが発生しました。一定回数を限度に，動作状態の確認をリトライしてください。なお，この戻り値は，jevstatコマンドではリトライ不可エラーとなります。

強制停止

JP1/Baseを強制的に停止し，使用中のリソースを解放します。

使用するコマンド

jbs_killall.cluster 論理ホスト名

jbs_killall.clusterコマンドを実行すると，JP1/Baseの終了処理を一切行わずに，各プロセスを強制的に停止します。

〈注意〉

強制停止をする前に，停止コマンドによってJP1/Baseを停止してください。強制停止のコマンドは，停止コマンドを実行しても処理が終了しないなど，問題が発生した場合に限り実行してください。

注※

Windowsの場合は，Windowsのサービス制御との関連によって，UNIXの場合とは動作が異なります。Windowsでは，プロセスの一部が停止すると，JP1のプロセス管理が自動的にすべての各プロセスを停止して，サービスを停止状態にします。サービスの停止によって異常と判定するか，jbs_spmd_statusコマンドの戻り値が8になるのを待ってから異常と判定してください。

〈備考〉JP1の再起動について

クラスタ運用のJP1の障害を検知した場合に，待機系サーバにフェールオーバーする前に，同じサーバでJP1を再起動して回復を試みる場合があります。

この場合は，JP1のプロセス管理による再起動ではなく，クラスタソフトの制御による再起動を推奨します。

クラスタソフトはJP1の障害検知後に再起動を試みるため，障害の内容によってはJP1の再起動機能が影響を受け，正常に動作できないおそれがあります。より確実に再起動するために，クラスタソフトからの制御でJP1を再起動してください。

5.6　クラスタ運用中の設定変更時の作業

JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）は，論理ホストごとの情報を共通定義情報としてローカルディスクに持っています。そのためクラスタ運用中に共通定義情報の設定を変更した場合，実行系と待機系の論理ホストの共通定義情報を一致させる必要があります。

5.6.1　共通定義情報が更新される実行系での操作と待機系への反映方法

共通定義情報が変更される実行系での操作と，待機系へ共通定義情報を反映する方法を次の表に示します。なお，この操作は，JP1/BaseおよびJP1/Baseを前提とするすべての製品に影響を与えるため注意してください。また，作業の前後で共通定義情報のバックアップを取得することをお勧めします。共通定義情報のバックアップ方法については，「3.5.2　バックアップとリカバリー（Windowsの場合）」または「3.5.3　バックアップとリカバリー（UNIXの場合）」を参照してください。

表5‒4　共通定義情報が更新される実行系での操作と待機系への反映方法

機能

実行系での操作

待機系への反映方法

JP1/Baseの設定全般

JP1/Base，およびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の共通定義情報を追加，変更した場合

(1) 共通定義情報を追加，変更した場合

ユーザーマッピング情報

jbsmkumapコマンド，jbssetumapコマンド，または［JP1/Base環境設定］ダイアログボックス（Windows限定）でユーザーマッピング情報を追加，変更した場合

(1) 共通定義情報を追加，変更した場合

jbsmkumapコマンド，jbsrmumapコマンド，または［JP1/Base環境設定］ダイアログボックス（Windows限定）でユーザーマッピング情報を削除，またはJP1ユーザーにマッピングされたOSユーザーを削除した場合

(2) ユーザーマッピング情報を削除した場合

jbsmkumapコマンド，jbssetumapコマンド，jbsrmumapコマンド，または［JP1/Base環境設定］ダイアログボックス（Windows限定）でユーザーマッピング情報を追加，変更および削除，またはJP1ユーザーにマッピングされたOSユーザーを削除した場合

(1) 共通定義情報を追加，変更した場合

(2) ユーザーマッピング情報を削除した場合

OSユーザーのパスワード情報

jbsmkpassコマンド，jbsumappassコマンド，jbspassmgrコマンド，または［JP1/Base環境設定］ダイアログボックスでOSユーザーのパスワード情報を追加，変更した場合

(1) 共通定義情報を追加，変更した場合

jbsmkpassコマンド，jbsrmumappassコマンド，jbspassmgrコマンド，または［JP1/Base環境設定］ダイアログボックスでOSユーザーのパスワード情報を削除した場合

(3) OSユーザーのパスワード情報を削除した場合

jbsmkpassコマンド，jbsumappassコマンド，jbsrmumappassコマンド，またはjbspassmgrコマンド，または［JP1/Base環境設定］ダイアログボックスでOSユーザーのパスワード情報を追加，変更および削除した場合

(1) 共通定義情報を追加，変更した場合

(3) OSユーザーのパスワード情報を削除した場合

jp1hosts情報

jbshostsimportコマンドでjp1hosts情報を追加，変更した場合

(1) 共通定義情報を追加，変更した場合

jbshostsimportコマンドでjp1hosts情報を削除した場合

(4) jp1hosts情報を削除した場合

jbshostsimportコマンドでjp1hosts情報を追加，変更および削除した場合

(1) 共通定義情報を追加，変更した場合

(4) jp1hosts情報を削除した場合

ディレクトリサーバ連携

jbschgdsコマンドで連携するディレクトリサーバを変更した場合

(1) 共通定義情報を追加，変更した場合

コマンド実行

jcocmddefコマンドでコマンド実行環境を設定した場合

(1) 共通定義情報を追加，変更した場合

jcocmddefコマンドでコマンド実行環境を設定した場合に，-groupオプションを指定し，ホストグループまたはホストを削除したとき

(5) コマンド実行環境のホストグループまたはホストを削除した場合

認証サーバ

jbssetusrsrv（UNIX限定）コマンド，jbssetupsrv（Windows限定）コマンド，または［JP1/Base環境設定］ダイアログボックス（Windows限定）で認証サーバを追加，変更した場合

(1) 共通定義情報を追加，変更した場合

jbssetusrsrv（UNIX限定）コマンド，jbssetupsrv（Windows限定）コマンド，または［JP1/Base環境設定］ダイアログボックス（Windows限定）で認証サーバを削除した場合

(6) 認証サーバを削除した場合

jbssetusrsrv（UNIX限定）コマンド，jbssetupsrv（Windows限定）コマンド，または［JP1/Base環境設定］ダイアログボックス（Windows限定）で認証サーバを追加，変更および削除した場合

(1) 共通定義情報を追加，変更した場合

(6) 認証サーバを削除した場合

(1)　共通定義情報を追加，変更した場合

表5-4で示した操作で，共通定義情報を追加，変更した場合は，次の手順で実行系と待機系の共通定義情報を一致させてください。なお，表5-4で示した実行系での操作を複数回続けて実施した場合でも，次の操作を一度実施すれば，共通定義情報が待機系に反映されます。

実行系でjbsgetcnfコマンドを実行し，共通定義情報を退避する。

実行するコマンドを次に示します。

jbsgetcnf -h 論理ホスト名 > 退避ファイル名

なお，論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。

退避ファイルを待機系にコピーする。

退避ファイルを引数に指定して，待機系でjbssetcnfコマンドを実行する。

実行するコマンドを次に示します。

jbssetcnf 退避ファイル名

(2)　ユーザーマッピング情報を削除した場合

jbsmkumapコマンド，jbsrmumapコマンド，または［JP1/Base環境設定］ダイアログボックス（Windows限定）でユーザーマッピング情報を削除した場合は，次の操作で実行系と待機系の共通定義情報を一致させてください。

実行系でjbsgetumapコマンドを実行し，ユーザーマッピング情報を退避する。

実行するコマンドを次に示します。

jbsgetumap -h 論理ホスト名 > 退避ファイル名

退避ファイルを待機系にコピーする。

退避ファイルを引数に指定して，待機系でjbsmkumapコマンドを実行する。

実行するコマンドを次に示します。

jbsmkumap -h 論理ホスト名 -f 退避ファイル名

(3)　OSユーザーのパスワード情報を削除した場合（Windows限定）

jbsmkpassコマンド，jbsrmumappassコマンド，jbspassmgrコマンド，または［JP1/Base環境設定］ダイアログボックスでOSユーザーのパスワード情報を削除した場合，次の操作で実行系と待機系の共通定義情報を一致させてください。なお，実行系で実行したコマンドごとに，待機系の共通定義情報に反映する方法が異なるため，注意してください。

(a)　jbspassmgrコマンドでOSユーザーを削除した場合

待機系でjbspassmgrコマンドを起動し，実行系で削除した登録ユーザーを削除してください。

(b)　jbsrmumappassコマンドでOSユーザーを削除した場合

待機系でjbsrmumappassコマンドを実行し，実行系で削除したOSユーザーを削除してください。

(c)　jbsmkpassコマンドでOSユーザーを削除した場合

次の操作で実行系と待機系の共通定義情報を一致させてください。

実行系で使用したパスワード定義ファイルを待機系にコピーする。

パスワード定義ファイルを引数に指定して，待機系でjbsmkpassコマンドを実行する。

実行するコマンドを次に示します。

jbsmkpass -h 論理ホスト名 -f パスワード定義ファイル

(d)　［JP1/Base環境設定］ダイアログボックスでOSユーザーを削除した場合

待機系で［JP1/Base環境設定］ダイアログボックスを起動し，実行系で削除した登録ユーザーを削除してください。

(4)　jp1hosts情報を削除した場合

jbshostsimportコマンドでjp1hosts情報を削除した場合，次に示す操作を実行し，実行系と待機系の共通定義情報を一致させてください。

実行系でjbshostsexportコマンドを実行し，jp1hosts情報を退避する。

実行するコマンドを次に示します。

jbshostsexport -h 論理ホスト名 > 退避ファイル名

退避ファイルを待機系にコピーする。

退避ファイルを引数に指定して，待機系でjbshostsimportコマンドを実行する。

実行するコマンドを次に示します。

jbshostsimport -h 論理ホスト名 -r 退避ファイル名

注意事項

jp1hosts2情報を登録した環境の場合，jbshostsimportコマンド実行時に，-fオプションも指定してください。jbshostsimportコマンドの詳細については，「15.　コマンド」の「jbshostsimport」を参照してください。

(5)　コマンド実行環境のホストグループまたはホストを削除した場合

jcocmddefコマンドでコマンド実行環境を設定した場合に，-groupオプションを指定し，ホストグループまたはホストを削除したときは，次の操作で実行系と待機系の共通定義情報を一致させてください。

実行系で使用したホストグループ定義ファイルを待機系にコピーする。

ホストグループ定義ファイルを引数に指定し，待機系でjcocmddefコマンドを実行する。

実行するコマンドを次に示します。

jcocmddef -host 論理ホスト名 -group ホストグループ定義ファイル

(6)　認証サーバを削除した場合

jbssetusrsrv（UNIX限定）コマンド，jbssetupsrv（Windows限定）コマンド，または［JP1/Base環境設定］ダイアログボックス（Windows限定）で認証サーバを削除した場合，次の操作で実行系と待機系の共通定義情報を一致させてください。

(a)　jbssetusrsrv（UNIX限定）コマンドで認証サーバを削除した場合

待機系でjbssetusrsrvコマンドを実行し，実行系で削除した認証サーバを削除してください。

(b)　jbssetupsrv（Windows限定）コマンドで認証サーバを削除した場合

待機系でjbssetupsrvコマンドを実行し，実行系で削除した認証サーバを削除してください。

(c)　［JP1/Base環境設定］ダイアログボックス（Windows限定）で認証サーバを削除した場合

待機系で［JP1/Base環境設定］ダイアログボックスを起動し，実行系で削除した認証サーバを削除してください。

5.7　論理ホストの削除

5.7.1　論理ホストの削除（Windowsの場合）

Windowsで論理ホストを削除する場合，GUIで削除する方法とコマンドを使って削除する方法があります。論理ホストの削除は実行系と待機系でそれぞれ実行する必要があります。

GUIで削除する場合

jp1bshasetup.exeコマンドを実行する。

［Baseクラスタ構成の設定］ダイアログボックスの［論理ホストの削除］ボタンをクリックする。

削除したい論理ホスト名を選択する。

コマンドを使って削除する場合

次のコマンドを実行します。

jbs_setup_cluster -h node0 -r

jbs_setup_clusterコマンドの詳細については，「15.　コマンド」の「jbs_setup_cluster（Windows限定）」を参照してください。

これによって，JP1/Base，JP1/IM，およびJP1/AJSの論理ホスト情報，およびサービスが削除されます。また，JP1/Power Monitorの論理ホスト情報も削除されます。なお，共有ディスク上の共有ファイル，共有フォルダは削除されません。手作業で削除してください。

注意事項

論理ホスト名と物理ホスト名（hostnameコマンドの実行結果）を同じ名称にしてJP1を運用していた場合，次の設定を行ってください。

イベントサービス環境の設定を変更する。

イベントサーバインデックスファイル（index）に初期設定されている「server * default」の行を有効にしてください。

jevlogical_setup.confの定義を元に戻す。

1.　次の内容の定義ファイルを作成する。

ファイル名は任意です。

[JP1_DEFAULT¥JP1BASE¥]

"JEVSERVICE_LOGICAL"=dword:00000000

2.　次のコマンドを実行し，作成した定義ファイルの内容を共通定義情報に反映する。

jbssetcnf 定義ファイル名

5.7.2　論理ホストの削除（UNIXの場合）

UNIXで論理ホストを削除する場合は，論理ホストの削除は実行系と待機系でそれぞれ実行する必要があります。

次のコマンドを実行してください。

jbsunsetcnf -i -h 論理ホスト名

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

イベントサービス環境の設定を変更する。

イベントサーバインデックスファイル（index）に設定されている削除する論理ホストの行を削除する。

これによって，JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）の論理ホスト情報が削除されます。ただし，共有ディスク上の共有ファイル，共有ディレクトリは削除されません。手作業で削除してください。

注意事項

論理ホスト名と物理ホスト名（hostnameコマンドの実行結果）を同じ名称にしてJP1を運用していた場合，次の設定を行ってください。

イベントサービス環境の設定を変更する。

イベントサーバインデックスファイル（index）に初期設定されている「server * default」の行を有効にしてください。

jevlogical_setup.confの定義を元に戻す。

1.　次の内容の定義ファイルを作成する。

ファイル名は任意です。

[JP1_DEFAULT¥JP1BASE¥]

"JEVSERVICE_LOGICAL"=dword:00000000

2.　次のコマンドを実行し，作成した定義ファイルの内容を共通定義情報に反映する。

/opt/jp1base/bin/jbssetcnf 定義ファイル名

5.8　クラスタ運用に関する注意事項

5.8.1　クラスタ運用に関するOS共通の注意事項

クラスタシステムでJP1/Baseのセットアップをする場合は，物理ホストおよび既存の論理ホストで動作しているJP1/Baseのサービスを必ず停止させてください。物理ホストおよび既存の論理ホストのJP1/Baseを停止しないままセットアップをした場合，論理ホストのサービスが正常に動作しなくなります。この場合は，サーバを再起動して，回復してください。

クラスタ運用をするシステムでユーザーアプリケーションなどからイベントを発行する場合は，jevsendコマンドを使用し，-sオプションでイベントサーバ名を指定してください。これによって，発行されたイベントがフェールオーバー時に実行系から待機系に引き継がれます。

JP1/BaseのイベントDBおよびコマンド実行履歴ファイル（ISAM）の二重化は支援していません。ミラーディスク，RAIDディスクなどを利用して，ディスクシステム自体で信頼性を確保してください。

クラスタ運用をする場合，イベントサーバ設定ファイル（conf）のoptionsパラメーターにsyncを指定してください。通常，プログラムからのディスク書き込みは，処理の性能を向上させるためにオペレーティングシステムがメモリー上でバッファリングを実行し，遅延書き込みしています。このため，電源異常やオペレーティングシステムの障害のためにシステムが急停止するような場合，ディスクに書き込んだはずのデータが消失することがあります。イベントサービスは，このバッファリングを抑止するとデータの消失を防止します。optionパラメーターにno-syncを指定したり，sync，no-syncのどちらも指定しなかったりした場合，データ消失のおそれがあります。ただし，JP1イベントが発行されるたびにディスクに書き込むため，JP1イベント発行の性能が劣化する場合があります。性能については環境により異なりますので事前に検証を行ってください。

クラスタシステムで多重起動をする場合，多重起動する論理ホストの数だけ，システムのリソースが必要となります。

クラスタシステムでJP1/Baseを物理ホストでも運用する場合，物理ホストのイベントサービスの設定をIPアドレス指定方式に変更する必要があります。実行系，待機系それぞれのイベントサーバ設定ファイル（conf）を編集して，portsパラメーターに指定するアドレスを，自ホスト名，自ホストのIPアドレス，または<jp1hosts2>に変更してください。物理ホストのイベントサービスでは，初期設定で<jp1host2>（新規インストールの場合）または0.0.0.0（バージョン09-50以前からの上書きインストールの場合）となっています。0.0.0.0が設定されている場合，物理ホストのイベントサービスと論理ホストのイベントサービスは同時に起動できません。イベントサーバ設定ファイルの詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

認証サーバをクラスタシステムで運用していて，認証サーバを設定したホストにJP1/IMやJP1/AJSがインストールされている場合，認証サーバがフェールオーバーによって切り替わったとき，各プログラムは次のように動作します。

JP1/IM

通信障害が発生し，フェールオーバー後に回復する。

JP1/AJS

通信障害が発生し，フェールオーバー後に再ログインが必要となる。

JP1/IMおよびJP1/AJSの動作に問題がある場合は，認証サーバをクラスタシステム以外の場所に設置しておくことで回避できます。

JP1/Baseのログファイルトラップを使って共有ディスク上のファイルを監視する場合，ファイル監視中は，その共有ディスクを常にアクセスできるように割り当てたままにしてください。ファイル監視中に共有ディスクの割り当て状態を変更すると，共有ディスクの割り当てや割り当て解除の制御に失敗したり，監視処理がエラーになったりするなどの問題が生じるおそれがあります。

コマンド実行履歴ファイル（ISAM）のデータ消失を防止するために，jcocmddefコマンドで-flushオプションにONを設定して，実行履歴を1行ごとに書き込みする処理を有効にしてください。jcocmddefコマンドの詳細については，「15.　コマンド」の「jcocmddef」を参照してください。

コマンド実行履歴ファイルの自動再編成機能が有効になっていると，ファイルサイズに応じてJP1/Baseの起動時間が増加します。その影響でフェールオーバーが正常に動作しない場合は，この機能を無効にしてください。コマンド実行履歴ファイルの自動再編成機能の詳細については，「4.9　コマンド実行履歴ファイルの自動再編成機能について」を参照してください。

論理ホストを作成した環境で，他ホストと通信する物理ホストのJP1/Baseを使用する場合，物理ホストに優先的に割り当てられるIPアドレスがループバックアドレス（127.0.0.1）とならないように名前解決の設定をすることを推奨します。もしも，物理ホストに優先的に割り当てられるIPアドレスをループバックアドレス（127.0.0.1）とする必要がある場合は，次のように設定してください。

jp1hostsで物理ホストに他ホストと通信できるIPアドレスを指定

イベントサーバ設定ファイル（conf）のportsパラメーターのアドレスに他ホストと通信できるIPアドレスを指定

API設定ファイル（api）に物理ホスト名のserverパラメーターを追加して，アドレスに他ホストと通信できるIPアドレスを指定

なお，ネットワークを分離した環境で運用する場合は，論理ホストを作成しない環境であっても，この設定が必要です。

5.8.2　クラスタ運用に関するWindows限定の注意事項

論理ホストの認証サーバの設定およびJP1ユーザーを登録する場合，必ず実行系のホストで操作をしてください。また，JP1ユーザーを登録する場合は，必ず論理ホストのサービスを起動してから行ってください。

クラスタ環境の実行系の定義を退避するときにjbsgetcnfコマンドに指定する論理ホスト名には，論理ホストを定義したときに指定した大文字・小文字が同じになるように指定してください。

誤って異なる指定をした場合は，論理ホストを削除してから再度設定をしてください。

論理ホストを削除する場合は，該当するホストのJP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS，およびJP1/Power Monitor）のサービスを停止してから，削除してください。サービスを停止しないまま削除した場合は，次のどちらかの方法でサービスを削除します。

同じ論理ホストを作成し，その後論理ホストを削除する。

JP1/Baseをアンインストールする。

自ホスト名と同じホスト名を指定して論理ホストを作成した場合，論理ホストを削除すると，物理ホストの「JP1/Base Event」サービスが削除されます。次に示すコマンドを実行して回復してください。

jevregsvc -r

JP1/Baseのサービスが起動，または停止できない場合，JP1/Baseのプロセスが残っていることがあります。このような場合には，システムを再起動してください。

JP1/Base LogTrapサービスはログファイルトラップを使用する場合に必要なサービスです。ログファイルトラップが変換したJP1イベントを物理や論理のイベントサービスへ登録します。物理ホストでJP1/Baseを使用しなくても，論理ホストのイベントサービスへ登録するログファイルトラップを起動する場合はJP1/Base LogTrapサービスの起動が必要です。JP1/Base Control Serviceサービスを起動しない場合は，JP1/Base LogTrapサービスの起動を「自動」に設定してください。

論理ホスト上で動作するサービスに対して起動管理機能は利用できません。起動管理機能は，物理ホスト上のサービスに対してだけ利用できます。論理ホスト上のサービスの起動管理には，クラスタソフトを利用してください。

物理ホストでイベントサービスを使用する場合，実行系，待機系両方の物理ホストのイベントサービスのイベントサーバ設定（conf）ファイルの編集が必要です。また，jp1bshasetupコマンドで定義した論理ホストのイベントサービスのイベントサーバ設定（conf）ファイルは，次の場所に作成されています。

共用ディスク上に指定したフォルダ名¥jp1base¥event¥conf

JP1/Baseのサービスが起動あるいは停止できない場合，JP1/Baseのプロセスが残っていることがあります。このような場合には，いったんコンピュータを再起動してください。

物理ホストでjp1hosts情報や通信方式を変更した場合には，jp1bshasetupコマンドで論理ホストを設定した際に，物理ホストのjp1hosts情報や通信方式の設定が論理ホストにコピーされます。論理ホストのjp1hosts情報や通信方式を，物理ホストと異なる設定にする場合には，再度論理ホストでjp1hosts情報や通信方式の設定をしてください。

JP1/Baseが使用する共有ディスクには，ネットワークドライブ先のディスクを使用しないでください。

5.8.3　クラスタ運用に関するUNIX限定の注意事項

クラスタシステムの環境設定をしたあとで，論理ホストで使用する言語種別を変更する場合，次の手順で設定を変更してください。なお，次の手順を実行する前にJP1/Baseおよび関連プログラムを終了する必要があります。

変更する論理ホストが使用する共有ディスク上に作成した共有ファイルjp1bs_env.confの言語種別を変更する。

変更手順については，「3.4.2　使用する言語種別を設定する（UNIXの場合）」を参照してください。

viなどのエディターでテキストファイルを作成する。

ここでは，日本語EUCコードに設定する例を示します。

[論理ホスト名¥JP1BASE¥]

"LANG"="EUCJIS"

最後の行にも改行を入れてください。

エディターで作成した上記テキストファイルを保存する。

任意の名前でかまいませんが，ここでは，"baselang.conf"にしておきます。

スーパーユーザー権限またはJP1/Base管理者権限で次に示すコマンドを実行する。

/opt/jp1base/bin/jbssetcnf baselang.conf

論理ホスト用の自動起動スクリプト（jbs_start.cluster）を編集する。

論理ホスト用の自動起動スクリプト（jbs_start.cluster）の環境変数LANGに，手順1で設定したjp1bs_env.confの言語種別と同じ値を設定してください。

論理ホストのイベントサービスを自動起動スクリプト（jbs_start.cluster）ではなく手動で起動する場合，イベントサービス起動時のロケール情報（環境変数LANGなど）を，jp1bs_env.confの言語種別と合わせてください。

例えば，jp1bs_env.confの言語種別にja_JP.UTF-8を設定した場合，論理ホスト用の自動起動スクリプト（jbs_start.cluster）の環境変数LANGを，次のように変更してください。

## Set Environment-variables

PATH=/sbin:/bin:/usr/bin:/opt/jp1base/bin

LANG=ja_JP.UTF-8

SHLIB_PATH=/opt/jp1base/lib:/opt/hitachi/common/lib

論理ホスト対応のJP1/Baseサービスを停止しても，JP1/Baseのプロセスが終了しないことがあります。このような場合に，強制的にプロセスを終了させたいときは，jbs_killall.clusterコマンドを使用してください。なお，このコマンドを使ったプロセスの強制終了は，正規の方法でJP1/Baseのプロセスを終了できない場合にだけ使用してください。jbs_killall.clusterコマンドの詳細については，「15.　コマンド」の「jbs_killall.cluster（UNIX限定）」を参照してください。

停止処理時にも監視するクラスタシステムでは，JP1/Base（イベントサービスやユーザー管理機能を含むプロセス管理機能）を終了するコマンドを下記の手順で変更してください。

cd /etc/opt/jp1base
cp -p jbs_stop.cluster.retry.model jbs_stop.cluster

動作状態を監視するようクラスタソフトにシェルスクリプトの登録をしている場合，シェルスクリプトで使用しているjbs_spmd_statusコマンドの監視間隔が10秒など短時間で監視を行っていると，jbs_spmd_statusコマンドの実行中に次のjbs_spmd_statusコマンドが実行され意図しないフェールオーバーが発生しやすくなります。そのため，監視間隔は60秒以上に設定してください。また，-tオプションで待ち時間を変更している場合は，-tオプションで設定した時間よりも長い時間を監視間隔に設定してください。

5.9　非クラスタ環境で論理ホストを運用する場合の設定

フェールオーバーしない論理ホストの構築および運用についての概要を説明します。フェールオーバーしない論理ホストも，通常のクラスタシステムで運用する場合の論理ホストと同じ手順でセットアップして運用します。

5.9.1　非クラスタ環境で論理ホストを運用する場合の構成の検討

複数の論理ホストでJP1を起動すると，それぞれのJP1がシステムリソース（メモリー，ディスク，プロセス，セマフォなど）を使用します。複数のJP1を同時に実行してリソースが不足すると，システムが正常に動作しません。同時に起動するJP1の数に合わせて，リソース量も見積もってください。または，システムの性能に合わせて，同時に起動するJP1の数を調整してください。

なお，メモリー所要量およびディスク占有量の見積もりについては，リリースノートを参照してください。

5.9.2　非クラスタ環境で論理ホストを運用する場合の構築

クラスタソフトと連携しなくてもフェールオーバーしない論理ホスト環境で，JP1を運用する手順を次に示します。

(1)　論理ホスト環境の準備

論理ホスト環境を作成するために，論理ホスト用のディスク領域およびIPアドレスを用意してください。

論理ホスト用のディスク領域

物理ホストやほかの論理ホストのJP1が使用しているものとは別に，論理ホストのJP1が専用で使用するファイルの格納先ディレクトリを，ローカルディスクに作成してください。

論理ホスト用のIPアドレス

論理ホストのJP1が使用するIPアドレスを，OSで割り当ててください。

IPアドレスの割り当ては，実IPでもエイリアスIPでもかまいません。ただし，論理ホスト名から一意に特定できるIPアドレスにしてください。

これらに対する前提条件は，クラスタシステムでの運用の場合と同じです。ただし，フェールオーバーしない運用方法のため「サーバ間で引き継がれる」などの条件は除きます。

なお，「5.　クラスタシステムで運用する場合の設定」で，共有ディスク・論理IPアドレスと説明している部分は，上記で割り当てた論理ホスト用のディスク領域・IPアドレスに読み替えてください。

性能の見積もり

性能を見積もる際は，以下のような観点でシステムとして動作できるか見積もってください。

システム内で複数のJP1が起動できるリソースを割り当てられるかどうかを見積もってください。リソースが十分に割り当てられないと，正しく動作しなかったり，十分な性能が確保できなかったりします。

同時に起動する論理ホストで発生するJP1イベント，JP1/AJSのジョブ数などの総量は，一つの物理ホスト上で動作できる業務トラフィック以内にしてください。JP1を複数起動しても，起動した論理ホストに比例して処理能力は向上しません。

(2)　論理ホスト環境のJP1のセットアップ

クラスタシステムの実行系サーバと同じ手順で，論理ホスト環境のJP1をセットアップしてください。なお，クラスタシステムではフェールオーバーする両側のサーバに対してセットアップする必要がありますが，フェールオーバーしない論理ホストでは，動作するサーバだけセットアップしてください。

(3)　論理ホスト環境の自動起動および自動停止の設定

論理ホスト環境のJP1のセットアップ時に，自動起動および自動停止の設定は行われません。論理ホスト環境の自動起動および自動停止をする場合は，「5.9.3(2)　自動起動および自動停止の設定例」を参照してください。

5.9.3　非クラスタ環境での論理ホスト運用

JP1の操作，バックアップやリカバリーなど，フェールオーバーしない論理ホストの運用方法は，クラスタシステムで運用する論理ホストと同じです。ただし，クラスタソフトと連動してフェールオーバーすることを除きます。

(1)　起動と停止

論理ホストのJP1は，次の順に起動してください。

JP1/Base

JP1/Baseを前提とするJP1製品

また，論理ホストのJP1は，次の順に停止してください。

JP1/Baseを前提とするJP1製品

JP1/Base

(2)　自動起動および自動停止の設定例

システム開始時および停止時に，論理ホスト用のJP1サービスを自動起動および自動停止する場合は，以下の手順で設定する必要があります。設定方法は，JP1/BaseがサポートするOSによって異なります。OSごとの設定方法を次に示します。

(a)　Windows環境の場合

起動順序定義ファイル（JP1SVPRM.DAT）に，次の記述をテキストエディターで追記する。

格納先：インストール先フォルダ¥conf¥boot¥JP1SVPRM.DAT

[Jp1BaseEvent_論理ホスト名]
Name=JP1/BaseEvent_論理ホスト名
ServiceName=JP1_Base_Event 論理ホスト名

[Jp1Base_論理ホスト名]
Name=JP1/Base_論理ホスト名
ServiceName=JP1_Base_論理ホスト名
StopCommand=jbs_spmd_stop.exe -h 論理ホスト名

[Jp1AJS2_論理ホスト名]
Name=JP1/AJS2_論理ホスト名
ServiceName=JP1_AJS2_論理ホスト名
StopCommand=jajs_spmd_stop.exe -h 論理ホスト名

StopCommandパラメーターで指定しているコマンドは，JP1/Power Monitorからのシャットダウン時に実行されます。

(b)　AIX環境の場合

mkitabコマンドで/etc/inittabファイルに以下の記述を追加する。

# mkitab -i hntr2mon
"ユニークな識別子:2:wait:/etc/opt/jp1base/jbs_start.cluster 論理ホスト名"
# mkitab -i ユニークな識別子
"ユニークな識別子:2:wait:/etc/opt/jp1ajs2/jajs_start.cluster 論理ホスト名"

注　「ユニークな識別子」の部分は14バイト以内で，該当するファイル内でユニークになるように設定してください。

（例）

# mkitab -i hntr2mon
"jp1base_ronri1:2:wait:/etc/opt/jp1base/jbs_start.cluster 論理ホスト名"
# mkitab -i jp1base_ronri1
"jp1ajs2_ronri1:2:wait:/etc/opt/jp1ajs2/jajs_start.cluster 論理ホスト名"

この記述を追加すると，システムの起動時にJP1サービスの起動処理が実行されます。

/etc/rc.shutdownのJP1/Baseを前提とする製品の記述のあとに，次の記述をテキストエディターで追記します。

test -x /etc/opt/jp1ajs2/jajs_stop.cluster && /etc/opt/jp1ajs2/jajs_stop.cluster 論理ホスト名
test -x /etc/opt/jp1base/jbs_stop.cluster && /etc/opt/jp1base/jbs_stop.cluster 論理ホスト名
test -x /opt/hitachi/HNTRLib2/etc/D002stop &&
/opt/hitachi/HNTRLib2/etc/D002stop

この記述を追加すると，システムの停止時にJP1サービスの停止処理が実行されます。

(c)　Linux環境の場合

論理ホストの自動起動および自動停止用にUnitファイルを作成する。

格納先：/etc/systemd/system/jp1_base_論理ホスト名.service

Unitファイル例

[Unit]
# Service name
Description=JP1/Base 論理ホスト名 Service
After=rsyslog.service network.target network.service HNTRLib2D002.service
ConditionFileIsExecutable=/etc/opt/jp1base/jbs_start.cluster
ConditionFileIsExecutable=/etc/opt/jp1base/jbs_stop.cluster

[Service]
# Service type
Type=forking

# Service operations
ExecStart=/etc/opt/jp1base/jbs_start.cluster 論理ホスト名
ExecStop=/etc/opt/jp1base/jbs_stop.cluster 論理ホスト名

KillMode=none

StandardOutput=null
StandardError=null

[Install]
WantedBy=multi-user.target graphical.target

Unitファイルを有効にします。

次のコマンドを実行してUnitファイルを有効にします。

systemctl --system enable jp1_base_論理ホスト名.service

なお，JP1サービスの自動停止をする場合は，必ず自動起動もするようにしてください。自動停止だけを設定している場合，停止スクリプトが起動されません。

(d)　物理ホストおよび論理ホストの両方で自動起動および自動停止をする場合の設定

物理ホストおよび論理ホストの両方で自動起動および自動停止をしたい場合は，論理ホストの自動起動および自動停止の設定に加えて，次に示す設定をする必要があります。なお，設定方法はOSごとに異なります。OSごとの設定方法を次に示します。

Windows環境の場合

起動管理機能では，起動順序定義ファイル（JP1SVPRM.DAT）に記載された順番どおりに上から起動・停止処理が実行されます。物理ホストおよび論理ホストの起動順序を変更したい場合は，起動順序定義ファイル（JP1SVPRM.DAT）で，起動または停止したい順に，物理ホストおよび論理ホストの起動・停止順序を定義してください。

Linux環境の場合

物理ホストおよび論理ホスト間で自動起動および自動停止の順序を調整したい場合の設定については，「(e)　物理ホストおよび論理ホスト間で起動順序を調整する場合の設定（Linux環境の場合）」を参照してください。

AIX環境の場合

物理ホストの自動起動および自動停止をする場合は，追加設定が必要です。追加設定については，「7.2.1　自動起動および自動終了の設定」を参照してください。

(e)　物理ホストおよび論理ホスト間で起動順序を調整する場合の設定（Linux環境の場合）

Linux環境の場合で，物理ホストおよび論理ホスト間で自動起動および自動停止の順序を調整したい場合は，論理ホストの自動起動および自動停止の設定に加えて，次に示す設定をする必要があります。

物理ホストを先に起動する場合

論理ホスト用のUnitファイルを編集します。

格納先：/etc/systemd/system/jp1_base_論理ホスト名.service

編集個所：「After=」行の末尾に「jp1_base.service」を追記します。

Unitファイル例

[Unit]
# Service name
Description=JP1/Base 論理ホスト名 Service
After=rsyslog.service network.target network.service HNTRLib2D002.service jp1_base.service
ConditionFileIsExecutable=/etc/opt/jp1base/jbs_start.cluster
ConditionFileIsExecutable=/etc/opt/jp1base/jbs_stop.cluster

論理ホストを先に起動する場合

論理ホスト用のUnitファイルを編集します。

格納先：/etc/systemd/system/jp1_base_論理ホスト名.service

編集箇所：「Before=」行を追記して，「jp1_base.service」を定義します。

Unitファイル例

[Unit]
# Service name
Description=JP1/Base 論理ホスト名 Service
Before=jp1_base.service
After=rsyslog.service network.target network.service HNTRLib2D002.service
ConditionFileIsExecutable=/etc/opt/jp1base/jbs_start.cluster
ConditionFileIsExecutable=/etc/opt/jp1base/jbs_stop.cluster

(3)　論理ホストのJP1に対する操作

論理ホストに作成したJP1に対してコマンドを実行する場合は，クラスタシステムで動作する論理ホストと同様に論理ホスト名を明示して実行してください。

(4)　論理ホストの引き継ぎ

非クラスタ環境の論理ホストでは共有ディスク上の管理情報が引き継がれないため，フェールオーバーに対応していません。複数のホストで論理ホストIPを引き継ぐ運用はしないでください。

6　ネットワーク構成に応じたJP1/Baseの通信設定

この章では，ネットワーク構成に応じたJP1/Baseの通信設定について説明します。なお，この章で説明しているJP1/Baseの通信設定をする際の考え方は，JP1/Baseを前提とする製品（JP1/IMやJP1/AJSなど）でも同様となります。JP1/Baseを前提とする製品の通信設定の詳細については，各製品のマニュアルを参照してください。

また，JP1/Baseの通信方式に関する概要については，「2.10　JP1/Baseの通信方式」を参照してください。

6.1　単一ネットワークでの運用

この節では，単一ネットワークでのJP1/Baseの運用および必要となる通信設定について説明します。

JP1/Baseは，物理ホストしか使用しない場合は，初期設定（ANYバインド方式）のまま使用できます。特に通信設定を変更する必要はありません。

また，クラスタ運用する場合でも，WindowsではGUI（jp1bshasetup.exe）またはコマンド（jbs_setup_clusterコマンド），UNIXではコマンド（jp1base_setup_clusterコマンド）を使ってクラスタシステム用の設定をすれば，自動的にIPバインド方式に設定されるため，特に通信設定を変更する必要はありません。クラスタシステム用の設定をすれば，物理ホストへの通信は物理ホストが，論理ホストへの通信は論理ホストが受け取るようになります。

注意事項

JP1/Base 09-50以前のバージョンで物理ホストしか使用しない環境から，上書きインストールした場合，クラスタ運用するにはイベントサーバ設定ファイル（conf）およびapi設定ファイル（api）の設定も必要になります。

単一ネットワークでクラスタ運用している場合のJP1/Baseの通信動作を次の図に示します。

図6‒1　単一ネットワークでクラスタ運用している場合のJP1/Baseの通信動作

6.2　複数ネットワークでの運用

この節では，複数ネットワークでのJP1/Baseの運用および必要となる通信設定について説明します。

NICを複数枚使用して複数ネットワークに接続されるホスト上で物理ホストしか使用しない場合は，初期設定（ANYバインド方式）のまま使用できます。通信設定の必要はありません。

物理ホストで認証サーバを起動する場合，認証サーバはデフォルトの状態ではホスト名に対応する最優先のIPアドレスを使用します。NICを複数枚使用して複数ネットワークに接続されるホスト上で，認証サーバが使用するIPアドレスをホスト名に対応する最優先のIPアドレス以外に変更して認証サーバを起動するには，JP1/Baseの受信をIPバインド方式にする必要があります。設定手順を次に示します。

注意

JP1/Base 12-00以降ではこの設定手順は不要です。なお，この設定をしたJP1/Base 09-10以前の環境からJP1/Base 12-00以降にバージョンアップする場合，すでに設定されている内容の修正は不要です。継続して使用しても問題ありません。

jp1hostsに認証サーバで使用したいIPアドレスを登録する。

jp1hosts定義ファイルを次のように編集します。

ホスト名 認証サーバで使用したいIPアドレス1(，認証サーバで使用したいIPアドレス2,認証サーバで使用したいIPアドレス3)，ホスト名に対応する最優先のIPアドレス

jbshostsimportコマンドを実行して共通定義情報に登録する。

次のようにコマンドを実行します。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

通信方式設定を変更する。

次のようにコマンドを実行し，通信方式設定ファイルを共通定義情報に反映して通信方式設定を変更してください。通信方式設定ファイルの格納場所は，インストール先フォルダ¥conf¥です。

・送信がANYバインド方式の場合

jbssetcnf physical_ipany.conf

・送信がIPバインド方式の場合

jbssetcnf physical_ipip.conf

この設定をすると，認証サーバはjp1hostsに定義したすべてのIPアドレスに対しIPバインド方式で受信します。JP1で使用したい単一のIPアドレスだけを認証サーバで受信したい場合は，当該IPアドレスをjp1hosts定義ファイルの先頭に記載し，この設定をした後で通信方式設定ファイルphysical_recovery_0651.confを次のようにjbssetcnfコマンドを実行して共通定義情報に反映してください。

jbssetcnf physical_recovery_0651.conf

なお，JP1/Baseの通信設定を変更した場合，必ずJP1/Baseを再起動する必要があります。

一方，NICを複数枚使用して複数ネットワークに接続されるホスト上で論理ホストを使用（クラスタ運用）している場合，通信設定が必要となります。

6.2.1　複数ネットワークで運用する場合の通信設定

NICを複数枚使用して複数ネットワークに接続されるホスト上で論理ホストを使用（クラスタ運用）している場合の通信設定について，次に示すシステム構成例を基に説明します。

図6‒2　複数ネットワークに接続されるホスト上のJP1/Baseをクラスタ運用する場合のシステム構成例

(1)　設定条件

次に示す条件を満たす場合，通信設定が必要となります。

hostAには2枚のNICがあり，それぞれ別のサブネットを構築している。

ホスト名hostA（物理ホスト）はIPアドレス10.0.0.10で解決され，ホスト名logicalA（論理ホスト）はIPアドレス20.0.0.10で解決される。

(2)　通信の考え方

物理ホストhostAはサブネット1側に存在するホストとして扱われ，論理ホストlogicalAはサブネット2だけに接続されたホストとして動作します。このままでは，サブネット1にあるhostXはhostAと通信できますが，logicalAとは通信できません。同様にサブネット2にあるhostYはlogicalAと通信できますが，hostAとは通信できません。このため，hostXとlogicalAが通信できるように，また，hostYとhostAが通信できるように設定する必要があります。

(3)　通信設定

すべてのホスト間で通信ができるように，サブネット間でルーティングを設定してください（JP1/Base自体の通信設定を変更する必要はありません）。JP1/Baseが使用するポート番号については，「付録C.1　JP1/Baseのポート番号」を参照してください。ルーティングを設定するとhostXとlogicalAが通信でき，また，hostYとhostAが通信できるようになります。

図6‒3　ルーティングを設定した場合のシステム構成例

なお，ルーティング機能がない，サブネット間での相互通信をさせたくないなどの理由で，ルーティングを設定しないでネットワークを分離した環境でJP1/Baseを運用する場合，JP1/Baseの通信設定を変更すればその環境に対応できます。この機能を複数LAN接続と呼びます。詳細については，「6.5　ネットワークを分離した環境での運用（jp1hosts情報の場合）」および「6.6　ネットワークを分離した環境での運用（jp1hosts2情報の場合）」を参照してください。

6.3　JP1/Baseの通信方式の設定

システムやほかのアプリケーションとは別に，JP1/Base独自に通信設定を変更すれば，多様なネットワーク構成や運用に柔軟に対応できます。多様なネットワーク構成や運用に柔軟に対応するための機能を，JP1では複数LAN接続と呼んでいます。

また，JP1/Base自体の通信方式を変更すると，ルーティング機能がない，サブネット間での相互通信をさせたくないなどの理由でネットワークを分離した環境でも，運用できるようになります。

6.3.1　JP1/Base本体の通信方式を変更する必要がある運用とは

JP1/Base本体の通信方式を変更する必要がある運用とは，次の場合です。

複数ネットワークに接続されるホストをクラスタ運用する場合

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して通信する場合

複数LAN接続の環境で，特定のLANだけを使用して通信する場合

単一LAN接続の環境で，複数のIPアドレスが割り当たっている場合

複数LAN接続の環境で，特定のIPアドレスを使用して通信する場合（ファイアウォールの設定で，特定のIPアドレスだけ通過させる設定にしている場合）

クラスタシステムから論理ホストを削除し，物理ホストだけの環境にする場合（ANYバインド方式に変更する場合）

複数ネットワークに接続されるホストを物理ホストとしてしか使用しない場合は，通信方式を変更する必要はありません。

6.3.2　JP1/Base本体の通信方式を変更する

JP1/Base本体の通信方式は，通信方式設定ファイルを共通定義情報に反映すると変更できます。

JP1/Baseの通信方式には，ANYバインド方式とIPバインド方式があります。

(1)　JP1/Base本体の通信方式を変更する手順

通信方式設定ファイルを共通定義情報に反映するには，次のようにjbssetcnfコマンドを実行します。

jbssetcnf 通信方式設定ファイル

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

(2)　通信方式設定ファイル

通信方式設定ファイルには，用途ごとに七つのファイルがあります。

格納場所

Windowsの場合：インストール先フォルダ¥conf¥

UNIXの場合：/etc/opt/jp1base/conf/

表6‒1　通信方式設定ファイル一覧

通信方式設定ファイル

用途

physical_ipany.conf

受信をIPバインド方式，送信をANYバインド方式にする場合に使用します。

主にクラスタ運用している物理ホストで，複数のLANと通信する場合に使用します。

logical_ipany.conf

受信をIPバインド方式，送信をANYバインド方式にする場合に使用します。

主にクラスタ運用している論理ホストで，複数のLANと通信する場合に使用します。

なお，このファイルは編集し直す必要があります。

physical_recovery_0651.conf

共通定義情報に反映した通信方式を06-51以前の通信方式に戻す場合に使用します。

主に物理ホストで設定した通信方式を06-51以前の通信方式に戻す場合に使用します。

06-51以前の通信方式では，IPバインド方式の場合，複数LAN接続に対応できません。

logical_recovery_0651.conf

共通定義情報に反映した通信方式を06-51以前の通信方式に戻す場合に使用します。

主に論理ホストで設定した通信方式を06-51以前の通信方式に戻す場合に使用します。

なお，このファイルは編集し直す必要があります。

06-51以前の通信方式では，IPバインド方式の場合，複数LAN接続に対応できません。

physical_anyany.conf

送受信共にANYバインド方式にする場合に使用します。

主にクラスタ運用していたホストを物理ホストだけでの運用に戻す場合に使用します。

このファイルを使用すると，物理ホストがANYバインド方式になります。ただし，この場合，同一ホスト上では，論理ホストと併用できなくなります。

physical_ipip.conf

送受信共にIPバインド方式にする場合に使用します。

主に物理ホストで，ファイアウォール通過用に，送信時のIPアドレスを明示的に特定する場合や，特定のLANだけを利用する場合に使用します。

この設定を複数のネットワークに接続されるホストですると，一つのネットワークだけしか使用できなくなります。

logical_ipip.conf

送受信共にIPバインド方式にする場合に使用します。

主に論理ホストで，ファイアウォール通過用に，送信時のIPアドレスを明示的に特定する場合や，特定のLANだけを利用する場合に使用します。

なお，このファイルは編集し直す必要があります。

この設定を複数のネットワークに接続されるホストですると，一つのネットワークだけしか使用できなくなります。

JP1/Baseが提供する各機能の通信方式設定ファイルへの対応状況については，「付録H.9　各機能の通信設定への対応状況」を参照してください。

通信方式設定ファイルに定義されたパラメーターの詳細については，「付録H.10　通信方式設定ファイルに定義されたパラメーター」を参照してください。

(3)　JP1/Base本体の通信方式の設定例

複数ネットワークに接続されるホスト上の物理ホストに対し，通信方式設定ファイルの内容を反映させる場合は，次のようにjbssetcnfコマンドを実行してください。

jbssetcnf physical_ipany.conf

また，複数ネットワークに接続されるホスト上の論理ホストに対し，通信方式設定ファイルの内容を反映させる場合は，logical_ipany.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]のLOGICALHOSTNAMEをクラスタシステム用の設定をした際に指定した論理ホスト名に修正してから，次のようにjbssetcnfコマンドを実行してください。

jbssetcnf logical_ipany.conf

6.3.3　ANYバインドアドレスの指定とは

共通定義情報のJP1_BIND_ADDRがANYに設定されているとき，サーバーバインドするIPアドレスのバージョンを指定できます。それによって，受信をANYバインド方式で設定している場合でも，IPv4アドレスだけ受信する，またはIPv6アドレスだけ受信するなどの運用ができます。

なお，ANYバインドアドレスの指定は，次に示すOSで動作するJP1/Baseでサポートしています。

Windows Server 2016

Windows Server 2019

Windows Server 2022

Linux

(1)　ANYバインドアドレスを指定する手順

ANYバインドアドレスの指定を共通定義情報に反映するには，次のようにjbssetcnfコマンドを実行します。

jbssetcnf ANYバインドアドレスの設定ファイル

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

(2)　ANYバインドアドレスの設定ファイル

サーバーバインドするIPアドレスのバージョンを設定するためのファイルです。

格納場所

Windows Server 2016，Windows Server2019，およびWindows Server2022の場合：インストール先フォルダ¥conf¥

Linuxの場合：/etc/opt/jp1base/conf/

表6‒2　ANYバインドアドレスの設定ファイル一覧

ANYバインドアドレスの設定ファイル

用途

anybind_ipv4.conf

IPv4アドレスだけをサーバーバインドする場合に使用します。

anybind_ipv6.conf

IPv6アドレスだけをサーバーバインドする場合に使用します。

anybind_all.conf

IPv4アドレスおよびIPv6アドレスをサーバーバインドする場合に使用します。

6.3.4　JP1/Baseの通信方式の設定を確認する

(1)　JP1/Baseの通信方式の設定を確認する手順（物理ホストの場合）

jbsgetcnfコマンドを実行する。

jbsgetcnf >config.txt

config.txtをテキストエディターで開く。

[JP1_DEFAULT¥JP1BASE]の定義内容から通信方式を判断する。

定義内容と通信方式の関係を次の表に示します。

JP1_COM_VERSION

JP1_BIND_ADDR

JP1_CLIENT_BIND_ADDR

通信方式

0

確認不要

確認不要

複数LAN接続の通信方式が設定されていない。

1

ANY

ANY

physical_anyany.confが適用されている。

1

IP

ANY

physical_ipany.confが適用されている。

1

IP

IP

physical_ipip.confが適用されている。

(2)　JP1/Baseの通信方式の設定を確認する手順（論理ホストの場合）

論理ホスト名を指定して，jbsgetcnfコマンドを実行する。

jbsgetcnf -h 論理ホスト名 >config.txt

なお，論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。

config.txtをテキストエディターで開く。

[論理ホスト名¥JP1BASE]の定義内容から通信方式を判断する。

定義内容と通信方式の関係を次の表に示します。

JP1_COM_VERSION

JP1_BIND_ADDR

JP1_CLIENT_BIND_ADDR

通信方式

0

確認不要

確認不要

複数LAN接続の通信方式が設定されていない。

1

IP

ANY

logical_ipany.confが適用されている。

1

IP

IP

logical_ipip.confが適用されている。

(3)　ANYバインドアドレスの設定を確認する手順

jbsgetcnfコマンドを実行して，共通定義情報の定義内容を確認します。手順の詳細は，「(1)　JP1/Baseの通信方式の設定を確認する手順（物理ホストの場合）」または「(2)　JP1/Baseの通信方式の設定を確認する手順（論理ホストの場合）」を参照してください。

定義内容とANYバインドアドレスの設定の関係を次の表に示します。

JP1_ANY_BIND

ANYバインドアドレスの設定

IPv4

anybind_ipv4.confが適用されている。

IPv6

anybind_ipv6.confが適用されている。

ALL

anybind_all.confが適用されている。

未定義※

IPv4アドレスだけをサーバーバインドする。

注※

新規インストールおよびバージョンアップインストール時は，未定義になります。

6.3.5　IM構成管理での張り返し通信方式の設定

(1)　IM構成管理での張り返し通信

JP1/IM - ManagerのIM構成管理機能を用いて他ホストと通信する場合，マネージャーとエージェントのJP1/Base間で，双方向のjp1bscomサービス（ポート番号=20600/tcp）のTCPコネクションを確立して通信します。エージェントがマネージャーへ接続する通信のことを張り返し通信といいます。

(2)　張り返し通信方式

張り返し通信には，次に示す二つの方式があります。

名前解決しないで求めたマネージャーのIPアドレスへ接続して，通信する方式（以降，名前解決をしない方式と呼びます）

名前解決して求めたマネージャーのIPアドレスへ接続して，通信する方式（以降，名前解決をする方式と呼びます）

名前解決をしない方式の場合，マネージャーがエージェントへ接続したときに，マネージャー側に割り当たった接続元IPアドレスを，張り返し通信時の接続先IPアドレスとします。JP1/Baseをインストールした既定の状態では，名前解決をしない方式になっています。

(3)　張り返し通信方式の選択

次に示す運用の場合，名前解決をする方式を設定してください。

ネットワークを分離した環境で，IPバインド方式で運用する場合（physical_ipany.confまたはlogical_ipany.confを適用する場合）

マネージャーとエージェントのホスト間でアドレス変換（NAT）をする場合

(4)　張り返し通信方式の設定方法

マネージャーホストで共通定義設定ファイル（jbscom_resultresolv_enable.conf）を設定することで，名前解決をする方式を適用できます。jbscom_resultresolv_enable.confは，次に示すディレクトリに格納されています。

Windowsの場合

インストール先パス¥conf¥または共有ディレクトリ¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/または共有ディレクトリ/jp1base/conf/

論理ホストで設定する場合，jbscom_resultresolv_enable.confをエディターなどで開き，JP1_DEFAULTと記載されている個所をクラスタシステム用の設定をした際に指定した論理ホスト名に修正してください。また，実行系と待機系の両方で設定をする必要があります。

設定手順を，次に示します。

マネージャーホストのJP1/BaseとJP1/Baseを前提とする製品を停止する。

マネージャーホストでjbssetcnfコマンドを実行する。

jbssetcnf jbscom_resultresolv_enable.conf

マネージャーホストのJP1/BaseとJP1/Baseを前提とする製品を起動する。

なお，名前解決をしない方式に戻す場合も，同様の手順でjbscom_resultresolv_disable.confを設定してください。

(5)　張り返し通信方式の注意事項

名前解決をする方式を適用した場合，エージェント側でマネージャーホスト名の名前解決ができるように設定する必要があります。また，エージェントで名前解決して求めたプライマリーIPアドレスを，マネージャー側のJP1/BaseがサーバーバインドしているIPアドレスに設定する必要があります。この設定をしなかった場合，IM構成管理機能でプロファイル情報の収集をしたときに通信エラーが発生し，プロファイル情報の収集が失敗します。

6.4　JP1独自のhosts情報の設定

JP1/Baseは，JP1独自のhosts情報を持つことで，OSに左右されずにIPアドレス解決ができます。このJP1独自のhosts情報をjp1hosts情報またはjp1hosts2情報と呼びます。

jp1hosts情報またはjp1hosts2情報を設定すると，接続先ホストの物理ホスト名や論理ホスト名に対応していないIPアドレスでも通信ができるようになります。例えば，一つのホスト名から複数のIPアドレス解決ができないOSであっても，JP1/Baseは一つのホスト名に対して複数のIPアドレス解決ができるようになります。

jp1hosts2情報を使用すると，イベントサービスのIPアドレス解決も一元的に管理できます。また，jp1hosts2情報は通信先の追加が発生しても，サービスの再起動を必要としません。そのため，新規に環境を構築する場合には，jp1hosts2情報を使用することを推奨します。

なお，jp1hosts情報はJP1/Base 06-71からの方式，jp1hosts2情報はJP1/Base 10-00からの方式になります。

6.4.1　JP1独自のhosts情報を設定する必要がある運用とは

JP1独自のhosts情報（jp1hosts情報またはjp1hosts2情報）は，JP1/Baseインストール時には存在しません。必要に応じて各ホストに設定する必要があります。設定する必要がある運用とは，次の場合です。

複数ネットワークに接続されるホストをクラスタ運用する場合

接続先ホストに接続する際に使用するIPアドレスで正しく通信できない場合

IPv6アドレスを使用して通信する場合

IPv6アドレスを使用して通信する場合は，jp1hosts2情報を設定する必要があります。jp1hosts情報は，IPv6アドレスを使用した通信には対応していません。

なお，JP1/Baseが提供する各機能のjp1hosts情報およびjp1hosts2情報への対応状況については，「付録H.9　各機能の通信設定への対応状況」を参照してください。

6.4.2　JP1独自のhosts情報を設定する

(1)　jp1hosts情報を設定する

jp1hosts情報は，jp1hosts定義ファイルを編集し，jbshostsimportコマンドを使って共通定義情報に登録すると反映できます。詳細については，「6.5.2　jp1hosts情報を定義する」を参照してください。

(2)　jp1hosts2情報を設定する

jp1hosts2情報は，jp1hosts2定義ファイルを編集し，jbshosts2importコマンドを使って反映できます。詳細については，「6.6.2　jp1hosts2情報を定義する」を参照してください。

6.4.3　jp1hosts情報とjp1hosts2情報の両方が設定された場合の動作

jp1hosts情報とjp1hosts2情報の両方が設定された環境で，JP1/IM - Manager，JP1/AJS3 - Manager，およびJP1/NETM/DMなどがどのように名前解決するのかを説明します。

JP1/Baseを前提とする製品が，jp1hosts情報とjp1hosts2情報の両方が設定された環境で名前解決する場合，どちらかの定義だけを参照します。jp1hosts2情報に名前解決するホストの定義がないときに，jp1hosts情報を参照したり，逆にjp1hosts情報に名前解決するホストの定義がないときに，jp1hosts2情報を参照したりすることはありません。

(1)　jp1hosts2情報を参照する製品（JP1/IM - ManagerおよびJP1/AJS3 - Managerなど）

JP1/IM - ManagerおよびJP1/AJS3 - Managerなど，jp1hosts2情報を参照する製品は，jp1hosts情報が設定された環境にjp1hosts2情報を設定すると，jp1hosts2情報を参照するようになります。jp1hosts情報は参照しなくなります。なお，jp1hosts2情報が削除された場合は，設定されていたjp1hosts情報を参照するようになります。

以降の説明では，jp1hosts情報の設定が無効になる環境は，JP1/IM - ManagerおよびJP1/AJS3 - Managerなどを想定しています。

(2)　jp1hosts2情報を参照しない製品（JP1/NETM/DMなど）

JP1/Baseのユーザー認証機能を使用するJP1/NETM/DMなどの製品は，jp1hosts2情報を参照しません。そのため，jp1hosts情報とjp1hosts2情報の両方が設定された環境では，jp1hosts情報を参照します。したがって，jp1hosts情報が設定された環境にjp1hosts2情報を設定した場合でも，JP1/NETM/DMではjp1hosts情報の設定が継続されます。

(3)　jp1hosts情報とjp1hosts2情報の両方が設定された場合の注意事項

jp1hosts情報とjp1hosts2情報の両方が設定されている環境で，どちらの定義を参照するのかは製品によって異なります。各製品で確認してください。

JP1独自のhosts情報を利用して名前解決する場合，JP1/NETM/DMなどはjp1hosts2情報を参照しないため，jp1hosts情報を設定します。jp1hosts2情報が設定されている環境にjp1hosts情報を設定するときは，jbshostsimportコマンド実行時に-fオプションを指定する必要があります。jbshostsimportコマンドの詳細については，「15.　コマンド」の「jbshostsimport」を参照してください。

6.4.4　jp1hosts情報とjp1hosts2情報の違い

jp1hosts情報を使用する場合とjp1hosts2情報を使用する場合の違いについて説明します。jp1hosts情報は，JP1/Baseのバージョン9までとの互換性のため定義です。新規に環境を構築する場合は，jp1hosts2情報を使用することを推奨します。

表6‒3　jp1hosts情報を使用する場合とjp1hosts2情報を使用する場合の違い

項番

項目

jp1hosts情報の場合

jp1hosts2情報の場合

1

インポートした定義を反映するためのJP1/Baseの再起動

常にJP1/Baseの再起動が必要。

他ホストのIPアドレスを追加した場合，JP1/Baseの再起動は不要。

2

物理ホストおよび論理ホストへの定義

物理ホストと論理ホストの両方にホスト定義が必要。

物理ホストに設定したホスト定義が論理ホストにマージされる。

3

クラスタ運用時の論理ホストへの定義

論理ホストへのインポートは，実行系と待機系の両方に必要。

論理ホストへのインポートは実行系だけに必要。

4

共通定義情報への登録

定義内容は共通定義情報へ登録される。

共通定義情報へは登録されない。定義内容はバイナリファイルで保持する。

5

定義できるホスト数

制限なし。

最大10,000台。

6

定義ファイルの1レコードの長さ

最大256バイト。

制限なし。

7

ホスト定義がない定義ファイルのインポート

エラーになる。

有効に定義される。

8

設定済みの定義内容と同じ設定の定義ファイルのインポート

有効に定義される。

エラーになる。

9

IPv6アドレス

設定できない。

設定できる。

10

イベントサービスの通信

一部使用できない。※

使用できる。

注※

API設定ファイル（api）のserverパラメーターでは，アドレスに<jp1hosts2>を設定してもjp1hosts情報は参照しません。jp1hosts情報を使用する場合は，イベントサービスの通信設定はJP1/Baseのバージョン9までの従来の設定をしてください。

(1)　インポートした定義を反映するためのJP1/Baseの再起動

jp1hosts情報の定義を変更した場合，その内容を反映するにはJP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムを常に再起動する必要があります。

jp1hosts2情報の場合，他ホストのIPアドレスを追加したときは，定義をインポートするだけで定義内容が反映されます。したがって，ネットワークにエージェントホストを追加したときに，マネージャーホストのJP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムの再起動が不要になります。なお，他ホストのIPアドレスの追加以外で定義を変更した場合は，再起動が必要です。

(2)　物理ホストおよび論理ホストへの定義

jp1hosts情報の場合，名前解決するためのホスト定義を，物理ホストと論理ホストそれぞれに設定する必要があります。

jp1hosts2情報の場合，物理ホストのjp1hosts2情報のホスト定義と論理ホストのjp1hosts2情報のホスト定義をマージして，論理ホストのjp1hosts2情報に反映できます。この機能を物理マージ機構といい，論理ホストのjp1hosts2情報の+PhysicalMergeパラメーターで指定します。

初期設定では，+PhysicalMergeパラメーターは有効になっているため，物理ホストのjp1hosts2情報にホスト定義を設定すれば，論理ホストのjp1hosts2情報にも物理ホストのjp1hosts2情報のホスト定義がマージされます。したがって，同一のホストに対して，物理ホストと論理ホストで異なるIPアドレスを解決する必要がある場合を除いて，論理ホストへのホスト定義は不要になります。

+PhysicalMergeパラメーターの詳細については，「16.　定義ファイル」の「jp1hosts2定義ファイル」を参照してください。

物理マージ機構の注意事項

物理ホストにjp1hosts2情報を設定している場合，次の点に注意してください。

論理ホストにjp1hosts情報が設定されている場合，その設定は無効になり，物理ホストのjp1hosts2情報を基に名前解決をします。ただし，jp1hosts2情報を参照しない製品は，この注意事項は該当しません。jp1hosts情報の設定が無効になることもありません。

論理ホストにjp1hosts情報とjp1hosts2情報のどちらも設定していない場合，物理ホストのjp1hosts2情報を基に名前解決をします。

(3)　クラスタ運用時の論理ホストへの定義

クラスタ運用時の論理ホストにjp1hosts情報を設定する場合，実行系および待機系の両系に定義情報をインポートする必要があります。

クラスタ運用時の論理ホストにjp1hosts2情報を設定する場合，実行系に定義情報をインポートすれば，待機系にはインポートする必要はありません。

(4)　共通定義情報への登録

jp1hosts情報は，共通定義情報に登録されます。

jp1hosts2情報は，共通定義情報には登録されません。バイナリファイル（hostdb{0|1}.bin）に登録されます。格納先については，「付録A　ファイルおよびディレクトリ一覧」を参照してください。

(5)　定義できるホスト数

jp1hosts情報に定義できるホスト数には，制限がありません。

jp1hosts2情報に定義できるホスト数は，10,000台までです。

(6)　定義ファイルの1レコードの長さ

jp1hosts情報は，定義ファイルの1レコード（1行）の長さは，256バイトまでです。

jp1hosts2情報は，定義ファイルの1レコード（1行）の長さには，制限がありません。

(7)　ホスト定義がない定義ファイルのインポート

jp1hosts情報の場合，一つもホストが定義されていない定義ファイルをインポートすると，エラーになりインポートが抑止されます。その際，メッセージKAVA0427-Eが出力されます。

jp1hosts2情報の場合，定義ファイルに一つもホストが定義されていなくても，正常にインポートされます。したがって，+DefaultResolveパラメーターまたは+PhysicalMergeパラメーターだけを定義した定義ファイルをインポートできます。また，何も定義のない定義ファイルもインポートできます。その場合，各パラメーターは省略したときと同じ設定になります。

(8)　設定済みの定義内容と同じ設定の定義ファイルのインポート

jp1hosts情報の場合，インポートをした結果，設定されているjp1hosts情報の定義内容に変更がなくても，常に更新されます。

jp1hosts2情報の場合，設定されているjp1hosts2情報の定義内容に変更がある場合だけインポートします。変更がないときは，インポートは抑止されます。その際，メッセージKAVA0456-Iが出力されます。なお，論理ホストにインポートするときは，物理マージ機構のマージ結果に対して変更の有無を確認します。

(9)　IPv6アドレス

jp1hosts情報の場合，IPv6アドレスを設定できません。

jp1hosts2情報の場合，IPv6アドレスを設定できます。IPv6アドレスを使用して通信する場合の設定については，「6.11　IPv6環境での運用」を参照してください。

(10)　イベントサービスの通信

jp1hosts情報で名前解決をする場合，イベントサービスの通信で使用する名前解決は，JP1/Baseのバージョン9までの従来の設定をしてください。具体的には，イベントサーバ設定ファイル（conf）のportsパラメーター，remote-serverパラメーター，およびAPI設定ファイル（api）のserverパラメーターに，明示的にIPアドレスを指定します。

jp1hosts2情報の場合，イベントサービスの通信でも名前解決に使用できます。なお，JP1/Baseを新規インストールした環境では，イベントサービスの通信にjp1hosts2情報を使用する設定になっています。上書きインストールした環境の場合，jp1hosts2情報を使用するには，イベントサーバ設定ファイル（conf）とapi設定ファイル（api）の変更が必要です。変更方法の詳細については，「6.4.5　jp1hosts情報からjp1hosts2情報への移行」を参照してください。

6.4.5　jp1hosts情報からjp1hosts2情報への移行

JP1/Baseを新規インストールした環境では，jbshosts2importコマンドを実行すれば，jp1hosts2情報を使用する環境になります。一方，上書きインストールした環境の場合，jp1hosts2情報を使用するには，jp1hosts情報を使用する環境からjp1hosts2情報を使用する環境への設定変更が必要です。

ここでは，jp1hosts情報を使用する環境からjp1hosts2情報を使用する環境への移行手順を次に示します。

(1)　JP1/BaseおよびJP1/Baseを前提とする製品を停止する

jp1hosts情報の変更およびイベントサービスの設定を変更するため，移行前にJP1/BaseおよびJP1/Baseを前提とする製品をすべて停止します。

(2)　jp1hosts情報の定義をjp1hosts2情報へ移行する（jp1hosts情報を使用している場合）

jp1hosts情報の定義をjp1hosts2情報へ移行します。

物理ホストの場合

jbshostsexportコマンドを実行して，jp1hosts情報の内容を取得する。

jbshostsexport > jp1hosts定義ファイル名

手順1で取得した内容（標準出力結果）をjp1hosts2定義ファイル（jp1hosts2.conf）に定義する。

jbshosts2importコマンドを実行して，jp1hosts2定義ファイル（jp1hosts2.conf）をインポートする。

jbshosts2import -o 手順2で定義したjp1hosts2定義ファイル

論理ホストの場合

jbshostsexportコマンドを実行して，jp1hosts情報の内容を取得する。

jbshostsexport -h 論理ホスト名 > jp1hosts定義ファイル名

手順1で取得した内容（標準出力結果）をjp1hosts2定義ファイル（jp1hosts2.conf）に定義する。

jbshosts2importコマンドを実行して，jp1hosts2定義ファイル（jp1hosts2.conf）をインポートする。

jbshosts2import -h 論理ホスト名 -o 手順2で定義したjp1hosts2定義ファイル

手順2と手順3は，実行系の論理ホストで実行してください。

なお，手順3でjbshosts2importコマンドを実行したとき，jp1hosts2情報の内容がインポート前後で変わらない場合，メッセージKAVA0456-Iを出力してインポートを抑止します。この場合，該当の論理ホストは，すでに移行後と同じ環境になっているため，移行手順を実施する必要はありません。

(3)　イベントサーバ設定ファイル（conf）を変更する

イベントサーバの通信設定にjp1hosts2情報を使用するように変更します。

イベントサーバ設定ファイル（conf）のportsおよびremote-serverパラメーターのアドレス部分に，<jp1hosts2>と設定します。

ports <jp1hosts2> jp1imevt jp1imevtapi
remote-server イベントサーバ名 通信タイプ <jp1hosts2>

また，client-bindパラメーターの定義を削除します。

(4)　api設定ファイル（api）を変更する

イベントサーバへ接続するアプリケーションプログラムの通信設定に，jp1hosts2情報を使用するように変更します。

API設定ファイル（api）のserverパラメーターのアドレス部分に，<jp1hosts2>と設定します。

server イベントサーバ名 通信タイプ <jp1hosts2>

(5)　JP1/Baseを起動する

JP1/Baseを起動することで，移行前のjp1hosts情報と同じ設定でjp1hosts2情報を使用する環境になります。

6.4.6　jp1hosts情報またはjp1hosts2情報の確認

ホストがjp1hosts情報とjp1hosts2情報のどちらの設定で動作しているかを確認するには，jbshosts2exportコマンドの実行結果で判断します。

物理ホストおよび論理ホストに対してjbshosts2exportコマンドを実行し，jp1hosts2情報が定義されているかどうかで判断します。jp1hosts2情報が定義されていない場合は，メッセージKAVA0470-Iが出力されます。

表6‒4　jbshosts2exportコマンドの実行結果から判断できる設定状況

項番

jbshosts2exportの結果

設定状況

物理ホスト

論理ホスト

1

定義あり

定義あり

すべてのホストがjp1hosts2情報の設定で動作している。

2

定義あり

定義なし

3

定義なし

定義あり

物理ホストはjp1hosts情報の設定で動作している。またはOSのhostsやDNSを使用して動作している。

論理ホストはjp1hosts2情報の設定で動作している。

4

定義なし

定義なし

すべてのホストがjp1hosts情報の設定で動作している。またはOSのhostsやDNSを使用して動作している。

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

注意事項

jbshosts2exportコマンドの実行結果は，jp1hosts2情報を参照するJP1/IM - ManagerやJP1/AJS3 - Managerなどが対象になります。jp1hosts2情報を参照しない製品は，jp1hosts情報を参照して動作します。

jp1hosts2情報を参照しないJP1/NETM/DMなどの製品は，jbshostsexportコマンドを実行し，jp1hosts情報の定義を確認してください。jbshostsexportコマンドの詳細については，「15.　コマンド」の「jbshostsexport」を参照してください。

物理ホストのjp1hosts2情報をマージする設定の場合，論理ホストで使用できるホスト定義は物理ホストのjp1hosts2情報を確認しマージしてください。物理ホストのjp1hosts2情報をマージする設定については，「6.4.4(2)　物理ホストおよび論理ホストへの定義」を参照してください。

6.5　ネットワークを分離した環境での運用（jp1hosts情報の場合）

この節では，複数LAN接続を使って，ネットワークを分離した環境でJP1/Baseを運用する際の考え方や通信設定について説明します。

なお，この節では，jp1hosts情報を使用することを前提に説明します。

6.5.1　ネットワークを分離した環境でJP1/Baseを運用する際の考え方（jp1hosts情報の場合）

ここでは，ネットワークを分離した環境でJP1/Baseを運用する際の考え方について，次の図に示すシステム構成例を基に説明します。この構成例では，物理ホストhostAおよび論理ホストlogicalAをマネージャーホストとし，hostXやhostYをエージェントホスト（またはクライアントホスト）として運用すると仮定して説明します。具体的には，hostXのJP1/IM - ViewからhostAのJP1/IM - Managerにログインし，hostYを監視したり，hostYで自動アクションを実行させたりしたい場合です。

図6‒4　分離されたネットワークでJP1/Baseを運用する場合のシステム構成例（jp1hosts情報の場合）

設定のポイントを次に示します。

JP1/Baseの通信方式を採用するかどうか

JP1/Base本体の通信設定をどうするか

JP1/Base本体の通信設定とは，ホスト間でJP1イベント以外のデータをやり取りするために必要な設定を意味します。ユーザー認証や構成定義の配布・リモートコマンド（JP1/IM用）などが該当します。JP1/Base本体の通信設定を考える上で重要になるのは，次に示す2点です。

jp1hosts情報の定義

送信時と受信時の通信方式の選択

イベントサービスの通信設定をどうするか

イベントサービスの通信設定とは，ホスト間でJP1イベントをやり取りするために必要な設定を意味します。

なお，通信設定を変更した場合は，JP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムを必ず再起動させる必要があります。

(1)　JP1/Baseの通信方式を採用するかどうか

インストール時には06-71以降の通信設定で動作します。JP1/Baseの通信方式を採用するかどうか，まず検討してください。

(2)　jp1hosts情報の定義（JP1/Base本体用）

OSによっては，一つのホスト名から複数のIPアドレスに解決できない場合があります。この場合，jp1hosts情報を定義すれば，IPアドレス解決ができます。

物理ホスト，論理ホスト共にサブネット1，サブネット2を使用するためには，それぞれが使用するIPアドレスを両NICに割り当てる必要があります（UNIXの場合ifconfigコマンドを使用します）。そして，その情報をjp1hosts情報として定義します。

また，hostXでping logicalAを実行したときに，サブネット2側の20.0.0.11を検索し，通信ができないことがあります。この場合も，hostXでjp1hosts情報を定義すれば解決できます。

注意事項

hostsやDNSの設定で対処できない場合だけ，必要な設定をjp1hosts情報に定義してください。

(3)　送信時と受信時の通信方式の選択（JP1/Base本体用）

複数ネットワークに接続されるホストをクラスタ運用している場合，通信方式を変更する必要があります。図6-4を基にして，以降で簡単に説明します。

複数ネットワークに接続されたホストは，物理ホスト，論理ホストを使用しているため，受信設定をANYバインド方式にすると，物理ホストあてのデータを論理ホストが受け取ったり，論理ホストあてのデータを物理ホストが受け取ったりするようになります。このため，受信設定は，IPバインド方式にする必要があります。

一方，送信設定をIPバインド方式にすると，送信データがサブネット1だけ，またはサブネット2だけしか流れなかったりするため，送信設定はANYバインド方式にする必要があります。

通常，クラスタシステム用の設定をすると，イベントサービス以外の通信方式は受信設定，送信設定共にIPバインド方式となります。このため，送信設定だけをANYバインド方式に変更する必要があります。JP1/Base本体の通信方式の変更は，jbssetcnfコマンドを使って，通信方式設定ファイルを共通定義情報に登録すると反映できます。

通信方式の詳細については，「6.3　JP1/Baseの通信方式の設定」を参照してください。また，クラスタセットアップ時の通信方式については，「付録H.12　クラスタセットアップ時の通信方式」を参照してください。

(4)　イベントサービスの通信設定

イベントサービスの場合，イベントサーバ設定ファイル（conf）を編集すると，JP1/Base本体の「(2)　jp1hosts情報の定義（JP1/Base本体用）」および「(3)　送信時と受信時の通信方式の選択（JP1/Base本体用）」に該当する通信設定が行えます。詳細については，「6.5.3　イベントサービスの通信設定を変更する」を参照してください。

注意事項

クラスタシステム用の設定をすると，論理ホストのイベントサーバ設定ファイル（conf）のportsパラメーターおよびremote-serverパラメーターには，<jp1hosts2>が設定されます。その設定の状態でjp1hosts情報を使用した場合，イベントサービスはjp1hosts情報を参照します。一方，ログファイルトラップ機能などJP1イベントを登録・取得するプログラムは，API設定ファイル（api）のserverパラメーターに<jp1hosts2>を設定しても，イベントサービスとの接続時にjp1hosts情報を参照しません。したがって，イベントサービスの通信設定とJP1イベントを登録・取得するプログラムの通信設定が不一致になるおそれがあります。jp1hosts2情報を使用する通信設定にするか，またはイベントサービスの通信設定をV9以前の通信設定にして運用してください。

(5)　JP1/Baseの再起動

JP1/Baseの通信設定を変更した場合，JP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムを必ず再起動する必要があります。

6.5.2　jp1hosts情報を定義する

JP1/Baseは，JP1/Base独自のhosts情報を持つことで，OSに左右されずにIPアドレス解決ができます。

注意事項

jp1hosts情報を設定した場合，jp1hosts情報に定義されたホスト名，およびIPアドレスに関しては，hostsファイルやDNSの定義は参照されません。

（例）

jp1hosts情報：

  hostA 100.0.0.10, 200.0.0.10

hostsファイル：

  100.0.0.10 hostA hostB
  200.0.0.10 hostC

上記設定の場合，hostAおよび100.0.0.10と200.0.0.10のIPアドレスに関しては，hostsファイルは参照されません。

jp1hosts情報を共通定義情報に登録する手順を次に示します。

jp1hosts定義ファイルを編集する。

jp1hosts定義ファイルは，初期設定で提供されています（jp1hostsファイルが該当します）。ただし，初期設定のままでは利用できません。このファイルを利用する場合は，運用に合わせて編集してください。なお，独自にjp1hosts定義ファイルを作成，編集することもできますが，この場合も格納場所は，初期設定で提供されているjp1hostsファイルと同じ場所にしてください。jp1hosts定義ファイルの形式については，「16.　定義ファイル」の「jp1hosts定義ファイル」を参照してください。

jbshostsimportコマンドを実行して共通定義情報に登録する。

次のようにコマンドを実行します。

jbshostsimport {-o|-r} jp1hosts定義ファイル名 [-h 論理ホスト名]

なお，共通定義情報に登録したjp1hosts情報を確認する場合は，jbshostsexportコマンドを利用してください。また，これらのコマンドの詳細については，「15.　コマンド」を参照してください。

6.5.3　イベントサービスの通信設定を変更する

イベントサービスの通信設定は，イベントサーバ設定ファイル（conf）で管理しています。イベントサーバ設定ファイル（conf）の内容を変えることで，イベントサービスの通信設定を変更できます。ネットワークが分離された環境で運用する場合に必要なパラメーターを次に示します。

portsパラメーター

client-bindパラメーター

portsパラメーターはJP1イベント受信用，client-bindパラメーターはJP1イベント送信用として使用します。これらのパラメーターの詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

イベントサーバ設定ファイル（conf）にこれらのパラメーターを設定する必要があるホストを次に示します。

接続先ホストに接続する際に使用するIPアドレスで正しく通信ができない場合

複数ネットワークに接続されるホストをクラスタ運用する場合

イベントサービスの通信設定を変更する手順を次に示します。

エディターなどを使って，イベントサーバ設定ファイル（conf）を開く。

論理ホスト用のイベントサーバ設定ファイル（conf）を編集する場合は，クラスタシステム用の設定をした際に作成されるイベントサーバ設定ファイル（conf）を編集してください。

portsパラメーターを探し，運用に合わせて編集する。

イベントサーバ設定ファイル（conf）内にportsパラメーターの記述がなかった場合は追記してください。なお，クラスタ運用していないホストでは，次のように初期設定でかまいません。

ports 0.0.0.0 jp1imevt jp1imevtapi

複数ネットワークに接続されるホストをクラスタ運用し，かつ，物理ホスト，論理ホストそれぞれに複数のIPアドレスを割り当てる場合は，次のように編集してください。

ports IPアドレス:IPアドレス jp1imevt jp1imevtapi

IPアドレスには，そのイベントサーバがJP1イベントを受信する際に使用するIPアドレスを指定します。複数指定する場合は，:（半角コロン）で区切ります。なお，指定できるIPアドレスの最大数は4です。

client-bindパラメーターを追記する。

追記内容は次のようになります。

client-bind 0.0.0.0

以上のように設定すると，ネットワークを分離した環境でもイベントサービスを運用できるようになります。

注意事項

上記設定（portsパラメーター，client-bindパラメーターでの設定）をしても，意図したとおりに通信ができない場合は，confファイルにremote-serverパラメーターを追記してください。remote-serverパラメーターは，他イベントサーバへの接続方法を指定するパラメーターです。このパラメーターでアドレスを明示的にIPアドレスで指定すれば，ネットワークを指定できます。追記内容は次のようになります。

remote-server イベントサーバ名 close IPアドレス

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

6.5.4　JP1/Baseを再起動する

JP1/Base本体およびイベントサービスの通信設定を変更した場合，JP1/Baseを再起動する必要があります。通信設定を変更したホストのJP1/Base，JP1/Baseを前提とする製品（JP1/IM，JP1/AJSなど），およびJP1/Baseと依存関係のあるプログラムをいったん停止し，再起動してください。

6.6　ネットワークを分離した環境での運用（jp1hosts2情報の場合）

この節では，複数LAN接続を使って，ネットワークを分離した環境でJP1/Baseを運用する際の考え方や通信設定について説明します。

なお，この節では，jp1hosts2情報を使用することを前提に説明します。

注意事項

jp1hosts2情報を使用するホストには，10-00以降のJP1/Baseがインストールされている必要があります。

6.6.1　ネットワークを分離した環境でJP1/Baseを運用する際の考え方（jp1hosts2情報の場合）

ここでは，ネットワークを分離した環境でJP1/Baseを運用する際の考え方について，次の図に示すシステム構成例を基に説明します。この構成例では，物理ホストhostAおよび論理ホストlogicalAをマネージャーホストとし，hostXやhostYをエージェントホスト（またはクライアントホスト）として運用すると仮定して説明します。具体的には，hostXのJP1/IM - ViewからhostAのJP1/IM - Managerにログインし，hostYを監視したり，hostYで自動アクションを実行させたりしたい場合です。

図6‒5　分離されたネットワークでJP1/Baseを運用する場合のシステム構成例（jp1hosts2情報の場合）

設定のポイントを次に示します。

JP1/Baseの通信方式を採用するかどうか

JP1/Base本体の通信設定をどうするか

JP1/Base本体の通信設定とは，ホスト間でJP1イベント以外のデータをやり取りするために必要な設定を意味します。ユーザー認証や構成定義の配布・リモートコマンド（JP1/IM用）などが該当します。JP1/Base本体の通信設定を考える上で重要になるのは，次に示す2点です。

jp1hosts2情報の定義

送信時と受信時の通信方式の選択

JP1/IM - ManagerやJP1/AJS3 - Managerなどのjp1hosts2情報を参照する製品では，jp1hosts2情報を定義すると，jp1hosts情報の定義は無効になります。jp1hosts情報を用いていた運用環境にjp1hosts2情報を設定する場合，jp1hosts2情報へ移行する必要があります。jp1hosts情報からjp1hosts2情報への移行方法については，「6.4.5　jp1hosts情報からjp1hosts2情報への移行」を参照してください。

なお，エージェントホストの追加などで，jp1hosts2情報に他ホストのIPアドレスを追加した場合であれば，JP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムを再起動する必要はありません。ただし，イベントサーバの通信設定の変更，またはjp1hosts2情報の定義で自ホストまたは他ホストのIPアドレスを変更した場合は，JP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムを再起動させる必要があります。

(1)　JP1/Baseの通信方式を採用するかどうか

インストール時には06-71以降の通信設定で動作します。JP1/Baseの通信方式を採用するかどうか，まず検討してください。

(2)　JP1/Base 09-50以前から上書きインストールするときに必要な設定

JP1/Base 09-50以前から上書きインストールした環境で，JP1/Baseの通信方式を採用するには，次の設定をする必要があります。

(a)　イベントサーバ設定ファイル（conf）の修正

イベントサーバをJP1/Baseの通信方式で通信できるようにするために，イベントサーバ設定ファイル（conf）のportsおよびremote-serverパラメーターのアドレス部分に<jp1hosts2>と設定します。また，client-bindパラメーターの定義は削除してください。

変更前

変更後

ports hostA jp1imevt jp1imevtapi

remote-server hostY close 20.0.0.20

client-bind 192.168.0.3

ports <jp1hosts2> jp1imevt jp1imevtapi

remote-server hostY close <jp1hosts2>

(b)　API設定ファイル（api）の修正

イベントサーバへ接続するアプリケーションプログラムをJP1/Baseの通信方式で通信できるようにするために，API設定ファイル（api）のserverパラメーターのアドレス部分に<jp1hosts2>と設定します。

変更前

変更後

server hostA keep-alive 10.0.0.10

server * keep-alive <jp1hosts2>

(3)　jp1hosts2情報の定義（JP1/Base本体用）

OSによっては，一つのホスト名から複数のIPアドレスに解決できない場合があります。この場合，jp1hosts2情報を定義すれば，IPアドレス解決ができます。

物理ホスト，論理ホスト共にサブネット1，サブネット2を使用するためには，それぞれが使用するIPアドレスを両NICに割り当てる必要があります（UNIXの場合ifconfigコマンドを使用します）。そして，その情報をjp1hosts2情報として定義します。

また，hostXでping logicalAを実行したときに，サブネット2側の20.0.0.11を検索し，通信ができないことがあります。この場合も，hostXでjp1hosts2情報を定義すれば解決できます。

jp1hosts2情報は物理ホストに定義を設定すれば，論理ホストにも定義がマージされて設定されます。物理ホストと論理ホストで同じホスト名に対して解決するIPアドレスを異なるものとする必要がある場合に限り，論理ホストのjp1hosts2情報にIPアドレスを設定してください。

(4)　送信時と受信時の通信方式の選択（JP1/Base本体用）

複数ネットワークに接続されるホストをクラスタ運用している場合，通信方式を変更する必要があります。図6-5を基にして，以降で簡単に説明します。

複数ネットワークに接続されたホストは，物理ホスト，論理ホストを使用しているため，受信設定をANYバインド方式にすると，物理ホストあてのデータを論理ホストが受け取ったり，論理ホストあてのデータを物理ホストが受け取ったりするようになります。このため，受信設定は，IPバインド方式にする必要があります。

一方，送信設定をIPバインド方式にすると，送信データがサブネット1だけ，またはサブネット2だけしか流れなかったりするため，送信設定はANYバインド方式にする必要があります。

通常，クラスタシステム用の設定をすると，イベントサービス以外の通信方式は受信設定，送信設定共にIPバインド方式となります。このため，送信設定だけをANYバインド方式に変更する必要があります。JP1/Base本体の通信方式の変更は，jbssetcnfコマンドを使って，通信方式設定ファイルを共通定義情報に登録すると反映できます。

通信方式の詳細については，「6.3　JP1/Baseの通信方式の設定」を参照してください。また，クラスタセットアップ時の通信方式については，「付録H.12　クラスタセットアップ時の通信方式」を参照してください。

(5)　JP1/Baseの再起動

JP1/Baseの通信設定を変更した場合，JP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムを必要に応じて再起動する必要があります。

6.6.2　jp1hosts2情報を定義する

JP1/Baseは，JP1/Base独自のhosts情報を持つことで，OSに左右されずにIPアドレス解決ができます。

注意事項

jp1hosts2情報を設定した場合，jp1hosts2情報に定義されたホスト名およびIPアドレスに関しては，hostsファイルやDNSの定義は参照されません。

（例）

jp1hosts2情報：

  hostA 100.0.0.10, 200.0.0.10

hostsファイル：

  100.0.0.10 hostA hostB
  200.0.0.10 hostC

上記設定の場合，hostAおよび100.0.0.10と200.0.0.10のIPアドレスに関しては，hostsファイルは参照されません。

jp1hosts2情報を登録する手順を次に示します。

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルは，初期設定で提供されています（jp1hosts2.confファイルが該当します）。独自にjp1hosts2定義ファイルを作成，編集することもできますが，格納場所は，初期設定で提供されているjp1hosts2.confファイルと同じ場所にしてください。jp1hosts2定義ファイルの形式については，「16.　定義ファイル」の「jp1hosts2定義ファイル」を参照してください。

jbshosts2importコマンドを実行して登録する。

次のようにコマンドを実行します。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名] [-h 論理ホスト名]

なお，登録したjp1hosts2情報を確認する場合は，jbshosts2exportコマンドを利用してください。また，これらのコマンドの詳細については，「15.　コマンド」を参照してください。

注意事項

JP1/IM - ManagerやJP1/AJS3 - Managerなどのjp1hosts2情報を参照する製品では，jp1hosts情報を定義している環境にjp1hosts2情報を定義すると，従来のjp1hosts情報は無効になります。また，jp1hosts2情報を削除（jbshosts2importコマンドの-dオプションを指定して実行）すると，従来のjp1hosts情報が有効になります。

ただし，jp1hosts2情報を参照しない製品は，この注意事項は該当しません。jp1hosts情報の設定が無効になることもありません。

6.6.3　イベントサービスの通信設定を変更する

JP1/Base 09-50以前は，イベントサービスは，イベントサーバ設定ファイル（conf）を使用した独自の通信設定しかできませんでした。しかし，JP1/Base 10-00以降では，JP1/Base本体の通信設定と同じ設定で通信できます。基本的には，「6.6.1　ネットワークを分離した環境でJP1/Baseを運用する際の考え方（jp1hosts2情報の場合）」で示している方法に従って，JP1/Base本体と同じ通信設定をしてください。

なお，JP1/Base 09-50以前と同様の設定で，イベントサーバ独自の通信設定をすることもできますが，この場合，IPv6での通信はできません。

注意事項

イベントサービスは，JP1/Base 06-51以前の通信方式には対応していません。JP1/Base 06-71以降の通信方式で動作します。JP1/Base 06-51以前の通信方式とJP1/Base 06-71以降の通信方式の違いについては，「付録H.11　JP1/Base 06-51以前の通信方式とJP1/Base 06-71以降の通信方式の違い」を参照してください。

6.6.4　必要に応じてJP1/Baseを再起動する

次の場合には，JP1/Baseを再起動する必要があります。通信設定を変更したホストのJP1/Base，JP1/Baseを前提とする製品（JP1/IM，JP1/AJSなど），およびJP1/Baseと依存関係のあるプログラムをいったん停止し，再起動してください。

JP1/Baseの通信方式を変更した場合

イベントサービスの通信設定を変更した場合

jp1hosts2情報の自ホストのIPアドレスの割り当てを変更した場合

jp1hosts2情報のすでに通信中の他ホストのIPアドレスを変更した場合

なお，jp1hosts2情報を変更した場合のJP1/Baseの再起動要否は，jbshosts2importコマンド実行時の標準出力で確認できます。

6.7　クラスタ運用していない場合の通信設定例（ネットワークを分離した環境での運用）

この節では，ネットワークを分離した環境で，クラスタ運用していない場合の通信設定について，次に示すシステム構成例を基に説明します。

図6‒6　JP1/Baseをクラスタ運用していない場合のシステム構成例（ネットワークを分離した環境での運用）

なお，上記構成図ではhost10だけ，ホスト名hostXに対してIPアドレス解決ができないIPアドレス20.0.0.11で接続すると仮定し，ほかのホストはIPアドレス解決ができるIPアドレス10.0.0.11で接続すると仮定します。

6.7.1　通信設定の変更（jp1hosts情報の場合）

ここでは，各ホストで必要となる通信設定の変更について説明します。

図6-6のシステム構成例の場合，各ホストで通信設定の変更が必要かどうかを次の表に示します。

ホスト名

JP1/Base本体の通信設定

イベントサービスの通信設定（confでの編集）

jp1hosts情報

通信方式設定情報

host10

変更が必要

変更不要

変更が必要

hostX

変更不要

変更不要

変更不要

hostA

変更不要

変更不要

変更不要

hostB

変更不要

変更不要

変更不要

hostC

変更不要

変更不要

変更不要

(1)　host10で必要となる設定

ほかのホストと異なり，host10は，hostXに対して物理ホスト名（ここではhostX）に対応していないIPアドレス20.0.0.11で接続するため，IPアドレス20.0.0.11がhostXに対応するIPアドレスだと認識させる必要があります。この設定は，jp1hosts定義ファイルおよびイベントサーバ設定ファイル（conf）でします。

jp1hosts定義ファイルを編集する。

jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11をhostXのIPアドレスとして対応付ける。
hostX 20.0.0.11

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

イベントサーバ設定ファイル（conf）を編集する。

イベントサーバ設定ファイル（conf）に次の行を追加してください。

remote-server hostX close 20.0.0.11

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhost10での通信設定は完了です。

(2)　hostXで必要な設定

hostXは，通信設定を変更する必要はありません。

(3)　hostA，hostB，hostCで必要な設定

hostA，hostB，hostCは，物理ホスト名（ここではhostX）に対応するIPアドレス10.0.0.11で接続するため，通信設定を変更する必要はありません。

6.7.2　通信設定の変更（jp1hosts2情報の場合）

ここでは，各ホストで必要となる通信設定の変更について説明します。

図6-6のシステム構成例の場合，各ホストで通信設定の変更が必要かどうかを次の表に示します。

ホスト名

JP1/Base本体の通信設定

イベントサービスの通信設定（confでの編集）

jp1hosts2情報

通信方式設定情報

host10

変更が必要

変更不要

変更不要

hostX

変更不要

変更不要

変更不要

hostA

変更不要

変更不要

変更不要

hostB

変更不要

変更不要

変更不要

hostC

変更不要

変更不要

変更不要

(1)　host10で必要となる設定

ほかのホストと異なり，host10は，hostXに対して物理ホスト名（ここではhostX）に対応していないIPアドレス20.0.0.11で接続するため，IPアドレス20.0.0.11がhostXに対応するIPアドレスだと認識させる必要があります。この設定は，jp1hosts2定義ファイルでします。

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11をhostXのIPアドレスとして対応付ける。
hostX 20.0.0.11

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

以上でhost10での通信設定は完了です。

(2)　hostXで必要な設定

hostXは，通信設定を変更する必要はありません。

(3)　hostA，hostB，hostCで必要な設定

hostA，hostB，hostCは，物理ホスト名（ここではhostX）に対応するIPアドレス10.0.0.11で接続するため，通信設定を変更する必要はありません。

6.8　クラスタ運用する場合の通信設定例（ネットワークを分離した環境での運用）

この節では，ネットワークを分離した環境で，複数のネットワークに接続されるホストがクラスタ運用である場合の通信設定について，次に示すシステム構成例を基に説明します。

図6‒7　JP1/Baseをクラスタ運用する場合のシステム構成例（ネットワークを分離した環境での運用）

なお，上記構成図ではhost10だけ，物理ホスト名hostX，論理ホスト名hostLに対してIPアドレス解決ができないIPアドレス20.0.0.11（物理ホスト用），20.0.0.15（論理ホスト用）で接続すると仮定し，ほかのホストは，物理ホスト名hostX，論理ホスト名hostLに対してIPアドレス解決ができるIPアドレス10.0.0.11（物理ホスト用），10.0.0.15（論理ホスト用）で接続すると仮定します。

6.8.1　通信設定の変更（jp1hosts情報の場合）

ここでは，各ホストで必要となる通信設定の変更について説明します。

図6-7のシステム構成例の場合，各ホストで通信設定の変更が必要かどうかを次の表に示します。

ホスト名

JP1/Base本体の通信設定

イベントサービスの通信設定（confでの編集）

jp1hosts情報

通信方式設定情報

host10

変更が必要

変更不要

変更が必要

hostX（物理ホスト）

変更が必要

変更が必要

変更が必要

hostL（論理ホスト）

変更が必要

変更が必要

変更が必要

hostA

変更不要

変更不要

変更不要

hostB

変更不要

変更不要

変更不要

(1)　host10で必要となる設定

host10は，hostXおよびhostLに対して物理ホスト名（hostX）および論理ホスト名（hostL）に対応していないIPアドレス20.0.0.11，20.0.0.15で接続するため，これらのIPアドレスがそれぞれhostXおよびhostLに対応するIPアドレスだと認識させる必要があります。この設定は，jp1hosts定義ファイルおよびイベントサーバ設定ファイル（conf）でします。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。

jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11，20.0.0.15をそれぞれ接続させたいホストの
# IPアドレスとして対応付ける。
hostX 20.0.0.11
hostL 20.0.0.15

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

イベントサーバ設定ファイル（conf）を編集する。

イベントサーバ設定ファイル（conf）に次の行を追加してください。

remote-server hostX close 20.0.0.11
remote-server hostL close 20.0.0.15

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhost10での通信設定は完了です。

(2)　hostX（物理ホスト）で必要な設定

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。

jp1hosts定義ファイルを次に示すように編集してください。

# ホスト名にIPアドレスを対応付ける。
hostX 10.0.0.11, 20.0.0.11

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipany.conf

イベントサーバ設定ファイル（conf）を編集する。

イベントサーバ設定ファイル（conf）のportsパラメーターおよびclient-bindパラメーターの値を次のように修正してください。

ports 10.0.0.11:20.0.0.11 jp1imevt jp1imevtapi
client-bind 0.0.0.0

API設定ファイル（api）を編集する。

server hostX keep-alive 10.0.0.11

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostXでの通信設定は完了です。

(3)　hostL（論理ホスト）で必要な設定

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。

jp1hosts定義ファイルを次に示すように編集してください。

# ホスト名にIPアドレスを対応付ける。
hostL 10.0.0.15, 20.0.0.15

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名 -h hostL

logical_ipany.confを編集する。

logical_ipany.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[hostL¥JP1BASE]に修正してください。

jbssetcnfコマンドを実行する。

jbssetcnf logical_ipany.conf

イベントサーバ設定ファイル（conf）を編集する。

イベントサーバ設定ファイル（conf）のportsパラメーターおよびclient-bindパラメーターの値を次のように修正してください。

ports 10.0.0.15:20.0.0.15 jp1imevt jp1imevtapi
client-bind 0.0.0.0

API設定ファイル（api）を編集する。

server hostL keep-alive 10.0.0.15

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

メモ

クラスタ運用の場合は，待機系の論理ホストでも，手順3〜手順6，および手順8を実施してください。

以上でhostLでの通信設定は完了です。

(4)　hostA，hostBで必要な設定

hostA，hostBは，物理ホスト名（ここではhostX）または論理ホスト名（ここではhostL）に対応するIPアドレスで接続するため，通信設定を変更する必要はありません。

6.8.2　通信設定の変更（jp1hosts2情報の場合）

ここでは，各ホストで必要となる通信設定の変更について説明します。

図6-7のシステム構成例の場合，各ホストで通信設定の変更が必要かどうかを次の表に示します。

ホスト名

JP1/Base本体の通信設定

イベントサービスの通信設定（confでの編集）

jp1hosts2情報

通信方式設定情報

host10

変更が必要

変更不要

変更不要

hostX（物理ホスト）

変更が必要

変更が必要

変更不要

hostL（論理ホスト）

変更不要

変更が必要

変更不要

hostA

変更不要

変更不要

変更不要

hostB

変更不要

変更不要

変更不要

(1)　host10で必要となる設定

host10は，hostXおよびhostLに対して物理ホスト名（hostX）および論理ホスト名（hostL）に対応していないIPアドレス20.0.0.11，20.0.0.15で接続するため，これらのIPアドレスがそれぞれhostXおよびhostLに対応するIPアドレスだと認識させる必要があります。この設定は，jp1hosts2定義ファイルでします。

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11，20.0.0.15をそれぞれ接続させたいホストの
# IPアドレスとして対応付ける。
hostX 20.0.0.11
hostL 20.0.0.15

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

以上でhost10での通信設定は完了です。

(2)　hostX（物理ホスト）で必要な設定

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

# ホスト名にIPアドレスを対応付ける。
hostX 10.0.0.11, 20.0.0.11
hostL 10.0.0.15, 20.0.0.15

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipany.conf

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostXでの通信設定は完了です。

(3)　hostL（論理ホスト）で必要な設定

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

logical_ipany.confを編集する。

logical_ipany.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[hostL¥JP1BASE]に修正してください。

jbssetcnfコマンドを実行する。

jbssetcnf logical_ipany.conf

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

メモ

クラスタ運用の場合は，論理ホストの共通定義を待機系に反映してください。

メモ

以上でhostLでの通信設定は完了です。

(4)　hostA，hostBで必要な設定

hostA，hostBは，物理ホスト名（ここではhostX）または論理ホスト名（ここではhostL）に対応するIPアドレスで接続するため，通信設定を変更する必要はありません。

6.9　ネットワークを分離した環境で，特定のネットワークで運用する場合の通信設定例

この節では，ネットワークを分離した環境で，JP1/Baseを特定のネットワークだけで運用する場合の通信設定について，次に示すシステム構成例を基に説明します。

図6‒8　JP1/Baseを運用する場合のシステム構成例（ネットワークを分離した環境で，特定のネットワークだけで運用する）

上記の図では，hostL（論理ホスト）がマネージャーホストとして動作し，各ホストのJP1/Baseは，ネットワーク2を使用して接続すると仮定します。

6.9.1　通信設定の変更（jp1hosts情報の場合）

ここでは，各ホストで必要となる通信設定の変更について説明します。

図6-8のシステム構成例の場合，各ホストで通信設定の変更が必要かどうかを次の表に示します。

ホスト名

JP1/Base本体の通信設定

イベントサービスの通信設定（confでの編集）

jp1hosts情報

通信方式設定情報

hostA（物理ホスト）

変更が必要

変更が必要

変更が必要

hostL（論理ホスト）

変更が必要

変更が必要

変更が必要

hostB

変更が必要

変更が必要

変更が必要

(1)　hostA（物理ホスト）で必要な設定

jp1hosts定義ファイルおよびイベントサーバ設定ファイル（conf）で，各ホストのJP1/Baseが使用するIPアドレスを認識させます。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。

jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.10をhostA，20.0.0.20をhostLとして対応付ける。
hostA 20.0.0.10
hostL 20.0.0.20

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipip.conf

イベントサーバ設定ファイル（conf）を編集する。

イベントサーバ設定ファイル（conf）のportsパラメーターおよびremote-serverパラメーターを次に示すように編集してください。

ports 20.0.0.10 jp1imevt jp1imevtapi
remote-server hostL close 20.0.0.20

API設定ファイル（api）を編集する。

API設定ファイル（api）のserverパラメーターを次に示すように追加してください。

server hostA keep-alive 20.0.0.10
server hostL keep-alive 20.0.0.20
server hostB keep-alive 20.0.0.11

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostAでの通信設定は完了です。

(2)　hostL（論理ホスト）で必要な設定

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。

jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.10をhostA，20.0.0.11をhostB，20.0.0.20をhostLとして対応付ける。
hostA 20.0.0.10
hostB 20.0.0.11
hostL 20.0.0.20

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名 -h hostL

logical_ipip.confを編集する。

logical_ipip.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[hostL¥JP1BASE]に修正してください。

jbssetcnfコマンドを実行する。

jbssetcnf logical_ipip.conf

イベントサーバ設定ファイル（conf）を編集する。

イベントサーバ設定ファイル（conf）のportsパラメーターおよびremote-serverパラメーターを次に示すように編集してください。

ports 20.0.0.20 jp1imevt jp1imevtapi
remote-server hostL close 20.0.0.20

API設定ファイル（api）を編集する。

API設定ファイル（api）のserverパラメーターを次に示すように追加してください。

server hostA keep-alive 20.0.0.10
server hostL keep-alive 20.0.0.20
server hostB keep-alive 20.0.0.11

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

メモ

クラスタ運用の場合は，待機系の論理ホストでも，手順3〜手順6，および手順8を実施してください。

以上でhostL（論理ホスト）での通信設定は完了です。

(3)　hostBで必要な設定

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts定義ファイルを編集する。

jp1hosts定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11をhostB，20.0.0.20をhostLとして対応付ける。
hostB 20.0.0.11
hostL 20.0.0.20

jbshostsimportコマンドを実行する。

jbshostsimport {-o|-r} jp1hosts定義ファイル名

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipip.conf

イベントサーバ設定ファイル（conf）を編集する。

イベントサーバ設定ファイル（conf）のportsパラメーターおよびremote-serverパラメーターを次に示すように追加してください。

ports 20.0.0.11 jp1imevt jp1imevtapi
remote-server hostL close 20.0.0.20

API設定ファイル（api）を編集する。

API設定ファイル（api）のserverパラメーターを次に示すように追加してください。

server hostA keep-alive 20.0.0.10
server hostL keep-alive 20.0.0.20
server hostB keep-alive 20.0.0.11

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostBでの通信設定は完了です。

6.9.2　通信設定の変更（jp1hosts2情報の場合）

ここでは，各ホストで必要となる通信設定の変更について説明します。

図6-8のシステム構成例の場合，各ホストで通信設定の変更が必要かどうかを次の表に示します。

ホスト名

JP1/Base本体の通信設定

イベントサービスの通信設定（confでの編集）

jp1hosts2情報

通信方式設定情報

hostA（物理ホスト）

変更が必要

変更が必要

変更不要

hostL（論理ホスト）

変更不要

変更が必要

変更不要

hostB

変更が必要

変更が必要

変更不要

(1)　hostA（物理ホスト）で必要な設定

jp1hosts2定義ファイルで，各ホストのJP1/Baseが使用するIPアドレスを認識させます。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.10をhostA，20.0.0.20をhostLとして対応付ける。
hostA 20.0.0.10
hostB 20.0.0.11
hostL 20.0.0.20

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipip.conf

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostAでの通信設定は完了です。

(2)　hostL（論理ホスト）で必要な設定

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

logical_ipip.confを編集する。

logical_ipip.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[hostL¥JP1BASE]に修正してください。

jbssetcnfコマンドを実行する。

jbssetcnf logical_ipip.conf

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

メモ

クラスタ運用の場合は，論理ホストの共通定義を待機系に反映してください。

以上でhostL（論理ホスト）での通信設定は完了です。

(3)　hostBで必要な設定

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを停止する。

JP1/Baseを停止する。

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

# IPアドレス20.0.0.11をhostB，20.0.0.20をhostLとして対応付ける。
hostB 20.0.0.11
hostL 20.0.0.20

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

jbssetcnfコマンドを実行する。

jbssetcnf physical_ipip.conf

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

以上でhostBでの通信設定は完了です。

6.10　複数ネットワークでの運用から単一ネットワークでの運用に戻す

ネットワークを分離した環境に対応させるためにした通信設定を解除し，単一ネットワークでの運用に戻す場合は，次に示す設定手順に従って戻してください。

6.10.1　単一ネットワークでの運用に戻す手順（jp1hosts情報の場合）

jp1hosts情報を共通定義情報から削除する。

共通定義情報にjp1hosts情報を登録した場合は，jbshostsimportコマンドを実行して削除してください。

jbshostsimport -d [-h 論理ホスト名]

通信方式設定ファイルを共通定義情報に反映する。

jbssetcnfコマンドを実行して共通定義情報に反映します。

物理ホストの場合は，次に示すようにjbssetcnfコマンドを実行してください。

同一ホスト上に論理ホスト環境がある場合

jbssetcnf physical_ipany.conf

jbssetcnf physical_recovery_0651.conf

物理ホスト環境だけの場合

jbssetcnf physical_anyany.conf

論理ホストの場合は，logical_ipany.confおよびlogical_recovery_0651.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，LOGICAHOSTNAMEをクラスタシステム用の設定をした際に指定した論理ホスト名に修正してください。その後，次に示すようにjbssetcnfコマンドを実行してください。

jbssetcnf logical_ipany.conf
jbssetcnf logical_recovery_0651.conf

イベントサーバ設定ファイル（conf）を編集する。

client-bindパラメーターを削除し，portsパラメーターのIPアドレスをクラスタ運用でない状態に戻すのであれば0.0.0.0に，クラスタ運用であれば物理ホスト名，論理ホスト名に対応するIPアドレスに変更してください。

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムも再起動してください。

6.10.2　単一ネットワークでの運用に戻す手順（jp1hosts2情報の場合）

jp1hosts2情報を削除する。

jp1hosts2情報を登録した場合は，jbshosts2importコマンドを実行して削除してください。

jbshosts2import -d [-h 論理ホスト名]

通信方式設定ファイルを共通定義情報に反映する。

jbssetcnfコマンドを実行して共通定義情報に反映します。

物理ホストの場合は，次に示すようにjbssetcnfコマンドを実行してください。

同一ホスト上に論理ホスト環境がある場合

jbssetcnf physical_ipany.conf

jbssetcnf physical_recovery_0651.conf

物理ホスト環境だけの場合

jbssetcnf physical_anyany.conf

論理ホストの場合は，logical_ipany.confおよびlogical_recovery_0651.confをエディターなどで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，LOGICAHOSTNAMEをクラスタシステム用の設定をした際に指定した論理ホスト名に修正してください。その後，次に示すようにjbssetcnfコマンドを実行してください。

jbssetcnf logical_ipany.conf
jbssetcnf logical_recovery_0651.conf

JP1/Baseを再起動する。

JP1/Baseを前提とする製品およびJP1/Baseと依存関係を持つプログラムを再起動してください。

6.11　IPv6環境での運用

この節では，IPv6環境でJP1/Baseを運用する場合の通信設定について説明します。

IPv6環境とは次の図のように，IPv4アドレスで通信するホストとIPv6アドレスで通信するホストが混在するネットワーク環境のことです。

図6‒9　IPv6環境でのシステム構成例

IPv4ホスト

IPv4アドレスだけを設定したホストです。

IPv6ホスト

IPv6アドレスだけを設定したホストです。

IPv4・IPv6ホスト

IPv4アドレスとIPv6アドレスの両方を設定したホストです。

6.11.1　IPv6環境のシステム構成の前提条件

マネージャーホスト

IPv4・IPv6ホストである。

OSがWindows Server 2016，Windows Server 2019，Windows Server 2022，またはLinuxである。

エージェントホスト

IPv4ホスト，IPv6ホスト，またはIPv4・IPv6ホストである

IPv6ホストまたはIPv4・IPv6ホストの場合，OSがWindows Server 2016，Windows Server 2019，Windows Server 2022，またはLinuxである。

IPv6環境で通信する場合，接続元（エージェントホスト）と接続先（マネージャホスト）で同じバージョン（種別）のIPアドレスを使用する必要があります。

なお，IPv6環境では次の機能は使用できません。

IPv4射影アドレスおよびIPv4互換アドレス

IPv4とIPv6のアドレスを変換する機器（プロトコル・トランスレータ）

6.11.2　IPv6環境で運用する場合の通信設定

図6-9のシステム構成例を基に，エージェントホスト3およびエージェントホスト4を追加する場合の通信設定について説明します。

IPv6環境でIPv6アドレスを用いた通信をする場合の通信設定は，ANYバインド方式とIPバインド方式の場合で違います。

(1)　ANYバインド方式の場合に必要な設定

(a)　ANYバインドアドレスの設定

ANYバインドアドレスの指定で，サーバーバインドするIPアドレスを次のどちらかに設定します。

IPv6アドレス（anybind_ipv6.conf）

IPv4アドレスおよびIPv6アドレス（anybind_all.conf）

設定例

マネージャーホストで必要な設定

anybind_all.confを指定して，jbssetcnfコマンドを実行する。

Windowsの場合

　jbssetcnf インストール先フォルダ¥conf¥anybind_all.conf

Linuxの場合

　jbssetcnf /etc/opt/jp1base/conf/anybind_all.conf

エージェントホスト3およびエージェントホスト4で必要な設定

anybind_ipv6.confを指定して，jbssetcnfコマンドを実行する。

Windowsの場合

　jbssetcnf インストール先フォルダ¥conf¥anybind_ipv6.conf

Linuxの場合

　jbssetcnf /etc/opt/jp1base/conf/anybind_ipv6.conf

(b)　jp1hosts2情報の設定

各ホストのjp1host2情報に，IPv6アドレスで通信する接続先ホストのIPv6アドレスを設定します。また，IPv6ホストのjp1host2情報には，自ホストのIPv6アドレスも設定します。

設定例

マネージャーホストで必要な設定

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

Agent3 2001:db8::28

Agent4 2001:db8::32

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

エージェントホスト3で必要な設定

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

Manager 2001:db8::1e

Agent3 2001:db8::28

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

エージェントホスト4で必要な設定

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

Manager 2001:db8::1e

Agent4 2001:db8::32

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

(2)　IPバインド方式の場合に必要な設定

(a)　jp1hosts2情報の設定

各ホストのjp1host2情報に，IPv6アドレスで通信する接続先ホストのIPv6アドレスと自ホストのIPアドレスを設定します。

設定例

マネージャーホストで必要な設定

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

Manager 10.0.0.30 2001:db8::1e

Agent3 2001:db8::28

Agent4 2001:db8::32

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

エージェントホスト3で必要な設定

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

Manager 2001:db8::1e

Agent3 2001:db8::28

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

エージェントホスト4で必要な設定

jp1hosts2定義ファイルを編集する。

jp1hosts2定義ファイルを次に示すように編集してください。

Manager 2001:db8::1e

Agent4 2001:db8::32

jbshosts2importコマンドを実行する。

jbshosts2import {-o|-r} [jp1hosts2定義ファイル名]

(3)　jp1hosts2情報の+DefaultResolveパラメーターの設定

jp1hosts2情報の+DefaultResolveパラメーターは，jp1hosts2情報に定義していないホスト名の名前解決方法を指定するパラメーターです。OSのhostsやDNSを使用してIPv6アドレスを求める場合は，+DefaultResolveパラメーターに1（IPv4アドレスおよびIPv6アドレスを求める）を設定します。

ただし，IPv4ホストとIPv6ホストが混在するネットワーク環境で，JP1/Baseを運用する場合は，IPv6ホストのIPアドレスを明示するために，jp1hosts2情報に定義することを推奨します。

なお，+DefaultResolveパラメーターの初期設定および省略時は，0（IPv4アドレスだけを求める）に設定されます。したがって，jp1hosts2情報にIPv6アドレスで通信するホストのIPアドレスを設定すれば，+DefaultResolveパラメーターの設定は不要です。

6.11.3　使用しているIPアドレスの確認方法

IPv6環境で通信する場合，接続元（エージェントホスト）と接続先（マネージャホスト）で同じバージョン（種別）のIPアドレスを使用する必要があります。

接続元および接続先で使用しているIPアドレスの種別が同じかどうかは，次に示すIPアドレスの種別が同じかどうかで判断できます。

接続元で解決できる接続先のプライマリーIPアドレスの種別

接続元で解決できる自ホストのIPアドレスの種別

接続先で解決できる自ホストのIPアドレスの種別

接続元で解決できる接続先のプライマリーIPアドレスと同じ種別のIPアドレスが，接続元で解決できる自ホストのIPアドレス，および接続先で解決できる自ホストのIPアドレスに含まれている必要があります。

各IPアドレスの確認方法を次に示します。

(1)　接続元で解決できる接続先のプライマリーIPアドレスの確認手順

接続元での確認

jp1pingコマンドに-vオプションおよび接続先ホスト名を指定して実行する。

接続先ホスト名から解決されたIPアドレスのうち，最初に表示されるIPアドレス（プライマリーIPアドレス）の種別を確認する。

(2)　接続元で解決できる自ホストのIPアドレスの確認手順

接続元での確認

jp1pingコマンドに自ホスト名を指定して実行する。

自ホスト名から解決されたIPアドレスを確認して，設定されているIPアドレスの種別を確認する。

(3)　接続先で解決できる自ホストのIPアドレスの確認手順

接続先での確認

jp1pingコマンドに自ホスト名を指定して実行する。

自ホスト名から解決されたIPアドレスを確認して，設定されているIPアドレスの種別を確認する。

6.12　通信設定が必要な場合

この節では，定義ファイルの通信設定が必要となる場合について説明します。

6.12.1　定義ファイルの通信設定が必要となる場合

(1)から(3)には，OSの名前解決で優先的に付与される任意のIPアドレスを使用しても，名前解決できない場合を含みます。

(1)　OSの名前解決で，接続先のホストが名前解決できない場合

jp1hosts定義ファイルまたはjp1hosts2定義ファイルに，接続先のホストでJP1/Baseが使用しているIPアドレスを設定します。jp1hosts定義ファイルおよびjp1hosts2定義ファイルの詳細については，「16.　定義ファイル」の「jp1hosts定義ファイル」および「jp1hosts2定義ファイル」を参照してください。

(2)　OSの名前解決で，イベント転送先イベントサーバ名が名前解決できない場合

jp1hosts2情報を使用する場合は，jp1hosts2定義ファイルに，転送先のイベントサーバが使用しているIPアドレスを設定します。

jp1hosts情報を使用する場合は，イベントサーバ設定ファイル（conf）のremote-serverパラメーターに，転送先のイベントサーバが使用しているIPアドレスを設定します。イベントサーバ設定ファイルの詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

(3)　OSの名前解決で，JP1/IM - Viewのイベント検索で指定したイベントサーバ名が名前解決できない場合

jp1hosts2情報を使用する場合は，jp1hosts2定義ファイルに，イベントサーバが使用しているIPアドレスを設定します。

jp1hosts情報を使用する場合は，API設定ファイル（api）のserverパラメーターに，イベントサーバが使用しているIPアドレスを設定します。API設定ファイルの詳細については，「16.　定義ファイル」の「API設定ファイル」を参照してください。

(4)　Windows環境で，同一ホスト上の物理ホストと論理ホストのサービスを起動する場合

jp1hosts定義ファイルまたはjp1hosts2定義ファイルに，JP1/Baseが使用する物理ホストのIPアドレスを設定します。

(5)　クラスタシステムのセットアップ時

jp1hosts情報を使用する場合だけ，イベントサーバ設定ファイル（conf）のportsパラメーターに，物理ホストおよび論理ホストが使用するIPアドレス，またはホスト名を設定します。物理ホストの設定時には，IPアドレスで指定することをお勧めします。

(6)　クラスタシステムおよび複数LAN接続の環境で，複数のLANを使用して通信したい場合

次のファイルを設定します。

jp1hosts定義ファイルまたはjp1hosts2定義ファイルに，自ホストのIPアドレスを設定します。

次の通信方式設定ファイルを共通定義情報に反映します。

物理ホスト環境の場合：physical_ipany.conf

論理ホスト環境の場合：logical_ipany.conf

ファイルをエディターで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[論理ホスト名¥JP1BASE]に修正します。

通信方式設定ファイルの詳細については，「6.3.2(2)　通信方式設定ファイル」を参照してください。

jp1hosts情報を使用する場合だけ，イベントサーバ設定ファイル（conf）のportsパラメーターに，自イベントサーバのIPアドレスを設定します。

jp1hosts情報を使用する場合だけ，イベントサーバ設定ファイル（conf）のclient-bindパラメーターに，0.0.0.0を指定します。

(7)　複数LAN接続の環境で，特定のLANを使用して通信したい場合

次のファイルを設定します。

jp1hosts定義ファイルまたはjp1hosts2定義ファイルに，自ホストのIPアドレスを設定します。

次の通信方式設定ファイルを共通定義情報に反映します。

物理ホスト環境の場合：physical_ipip.conf

論理ホスト環境の場合：logical_ipip.conf

ファイルをエディターで開き，[LOGICALHOSTNAME¥JP1BASE]を探し，[論理ホスト名¥JP1BASE]に修正します。

jp1hosts情報を使用する場合だけ，イベントサーバ設定ファイル（conf）のportsパラメーターに，自イベントサーバの使用するIPアドレスを設定します。

jp1hosts情報を使用する場合だけ，イベントサーバ設定ファイル（conf）のclient-bindパラメーターに，JP1イベントを送信するために使用するIPアドレスを設定します。

(8)　複数LAN接続の環境で，特定のLANを使用してイベントサーバへ接続したい場合

API設定ファイル（api）のclientパラメーターに，イベントサーバへ接続する際に使用するIPアドレスを設定します。

(9)　クラスタシステムから論理ホストを削除し，物理ホストだけの環境にする場合

次のファイルを設定します。

通信方式設定ファイル（physical_anyany.conf）を共通定義情報に反映すると，ANYバインド方式に戻ります。

jp1hosts情報を使用する場合だけ，イベントサーバ設定ファイル（conf）のportsパラメーターに，0.0.0.0を指定します。

jp1hosts情報を使用する場合だけ，イベントサーバ設定ファイル（conf）のclient-bindパラメーターを削除します。

jp1hosts定義ファイルまたはjp1hosts2定義ファイルを，必要に応じて削除します。

(10)　イベントサーバ設定ファイルのportsパラメーターに，OSの名前解決で優先的に付与される任意のIPアドレス以外のIPアドレスを指定している場合

API設定ファイル（api）のserverパラメーターに，イベントサーバ設定ファイルのportsパラメーターに設定しているIPアドレスを設定します。

6.13　JP1/Baseの通信暗号化について

JP1/Baseでは次に示す通信で，SSL通信を使用して通信を暗号化できます。

認証サーバ（ユーザー認証）に関連する通信

JP1/Baseのユーザー認証を利用する製品と認証サーバ間のユーザー認証の通信

JP1/Baseのユーザー認証関連のコマンド※の通信

注※　ユーザー認証関連のコマンドを次に示します。

jbsadduser，jbschgpasswd，jbsrmuser，jbslistuser，jbsaclreload，jbslistacl，jbssetacl，jbsrmacl

JP1/IMのコマンド実行に関連する通信

JP1/IM - ManagerとマネージャーホストのJP1/Base間の自動アクションの通信

JP1/IM - ViewとマネージャーホストのJP1/Base間のコマンド実行の通信

エージェントホスト監視に関連する通信

マネージャーホストのJP1/IM - Manager，JP1/BaseとエージェントホストのJP1/Base間のJP1イベント転送，JP1イベント検索，JP1イベント受信，自動アクション，コマンド実行，構成管理，およびヘルスチェック

SSL通信に対応するJP1/Baseの通信の概要を次に示します。

図6‒10　SSL通信に対応するJP1/Baseの通信

SSL通信を使用するには，接続先（サーバ側）ホストおよび接続元（クライアント側）ホストのJP1/Baseのバージョンが11-00以降（エージェントホスト監視に関する通信を暗号化する場合は12-10以降）である必要があります。

認証サーバ（ユーザー認証）でSSL通信を使用する場合の注意

認証サーバホストでSSL通信を有効にした場合，その認証サーバに接続するホストもSSL通信を有効にする必要があります。SSL通信を使用しないホストからユーザー認証をする必要がある場合は，SSL通信をしない認証サーバを設置してユーザー認証圏を分けてください。

また，エージェントホスト監視に関連する通信は，SSL通信をしないホストを非SSL通信ホスト設定ファイル（jp1bs_nosslhost.conf）に設定することで，エージェントホストのSSL通信設定に合わせた通信ができます。非SSL通信ホスト設定ファイルの詳細については，「16.　定義ファイル」の「非SSL通信ホスト設定ファイル」を参照してください。

SSL通信と非SSL通信が混在している場合のシステム構成例を次に示します。

図6‒11　SSL通信と非SSL通信が混在している場合のシステム構成例

この構成例の場合，統合マネージャーは，同じLAN内のJP1/Base間の通信は，非SSL通信です。また，統合マネージャーから拠点マネージャー，拠点マネージャーと同じLAN内のJP1/Baseに対しては，SSL通信です。

6.13.1　SSL通信に必要なファイル

SSL通信を使用するには，サーバ側になるホストとクライアント側になるホストで，SSL通信に必要なファイルを準備する必要があります。SSL通信に必要なファイルを次に示します。

SSL通信でサーバ側になるホストに必要なファイル

秘密鍵

CA（認証局）が発行したサーバ証明書

サーバ証明書に対応するルート証明書

SSL通信でクライアント側になるホストに必要なファイル

サーバ側のサーバ証明書に対応するルート証明書

SSL通信に必要な証明書の関係図を次に示します。

図6‒12　SSL通信で必要な証明書の関係図（認証サーバ（ユーザー認証）の場合）

図6‒13　SSL通信で必要な証明書の関係図（JP1/IMのコマンド実行の場合）

図6‒14　SSL通信で必要な証明書の関係図（エージェントホスト監視の場合）

なお，JP1/IMの通信暗号化機能（SSL通信）については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

(1)　秘密鍵，サーバ証明書，およびルート証明書の注意事項

パスフレーズ付きの秘密鍵は使用できません。パスフレーズを解除してから使用してください。

秘密鍵，サーバ証明書，およびルート証明書は，X509 PEM形式だけ使用できます。

サーバ証明書は，CNのホスト名にワイルドカードを使用した証明書（ワイルドカード証明書）も使用できます。

例：CN=*.example.com

中間CAが発行したサーバ証明書を使用する場合は，証明書の階層構造に従って証明書を結合する必要があります。

次に示す階層構造になるように，証明書を結合してください。

なお，クロスルート証明書を使用する場合は，次に示す順番で各証明書を結合してください。

サーバ証明書

中間CAが発行したサーバ証明書

クロスルート証明書

6.13.2　サーバ側のSSL通信環境のセットアップ

SSL通信を使用するためにサーバ側で必要となる秘密鍵の作成や，サーバ証明書およびルート証明書の発行について説明します。作業の流れは次のとおりです。

秘密鍵の作成

CSR（証明書署名要求）の作成

サーバ証明書およびルート証明書の発行

秘密鍵，サーバ証明書，およびルート証明書の配置

秘密鍵およびCSR（証明書署名要求）の作成には，OpenSSLのコマンドを使用します。OpenSSLのコマンドについては，「15.　コマンド」の「openssl」を参照してください。

(1)　秘密鍵を作成する

opensslコマンドで秘密鍵を作成する。

コマンド実行例を次に示します。

楕円曲線暗号（ECC）を利用する場合

openssl ecparam -genkey -noout -name 暗号名※ -out 秘密鍵ファイル名

注※

作成される秘密鍵の長さは暗号名によって異なります。詳細については，OpenSSLの公式サイトのopenssl-ecparamを参照してください。

RSA暗号を利用する場合

2,048ビットの秘密鍵を作成します。

openssl genrsa -out 秘密鍵ファイル名

(2)　秘密鍵を変換する（楕円曲線暗号を利用する場合だけ）

openssl pkcs8コマンドで秘密鍵を変換する。

楕円曲線暗号を利用する場合は，秘密鍵をPKCS#8形式に変換します。コマンド実行例を次に示します。

openssl pkcs8 -topk8 -in 秘密鍵ファイル名 -out PKCS#8形式秘密鍵ファイル名 -nocrypt

(3)　CSR（証明書署名要求）を作成する

openssl reqコマンドでCSR（証明書署名要求）を作成する。

作成した秘密鍵（楕円曲線暗号を利用する場合は，PKCS#8形式に変換する前の秘密鍵）を指定してCSR（証明書署名要求）を作成します。1年間有効な証明書のCSR（証明書署名要求）を作成する場合のコマンド実行例を次に示します。

openssl req -new -days 365 -key 秘密鍵ファイル名 -out CSRファイル名

証明書に登録するDN（識別名情報）を対話形式で入力する。

コマンドプロンプト画面の入力例：

C:¥Program Files (x86)¥Hitachi¥JP1Base¥ssl_¥32mt¥bin>openssl req -new -days 365 -key server.key -out server.csr
Loading 'screen' into random state - done
You are about to be asked to enter information that will be incorporated
into your certificate request.
What you are about to enter is what is called a Distinguished Name or a DN.
There are quite a few fields but you can leave some blank
For some fields there will be a default value,
If you enter '.', the field will be left blank.
-----
Country Name (2 letter code) [AU]:JP
State or Province Name (full name) [Some-State]:Kanagawa
Locality Name (eg, city) []:Yokohama
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Hitachi
Organizational Unit Name (eg, section) []:JP1
Common Name (e.g. server FQDN or YOUR name) []:hostjp1.example.com
Email Address []:

Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:

CSR（証明書署名要求）が作成されます。

(4)　サーバ証明書およびルート証明書の発行を申請する

作成したCSR（証明書署名要求）をCA（認証局）に送付して，サーバ証明書とルート証明書を発行してもらいます。

(5)　秘密鍵，サーバ証明書，およびルート証明書を配置する

秘密鍵，サーバ証明書，およびルート証明書をサーバ側の任意のフォルダに格納します。12-10以降のJP1/Baseの通信暗号化機能（SSL通信）を有効にしている環境でエージェントホストを監視する場合は，マネージャーホストだけではなく，エージェントホストにも秘密鍵，サーバ証明書，およびルート証明書が必要です。

なお，各ファイルのファイル名および格納先は，「6.13.4　JP1/Baseの通信暗号化機能の設定」で作成するSSL通信定義ファイルの定義内容と合わせてください。

6.13.3　クライアント側のSSL通信環境のセットアップ

「6.13.2(4)　サーバ証明書およびルート証明書の発行を申請する」で発行されたルート証明書をクライアント側の任意のフォルダに格納します。

なお，ファイル名および格納先は，「6.13.4　JP1/Baseの通信暗号化機能の設定」で作成するSSL通信定義ファイルの定義内容と合わせてください。

6.13.4　JP1/Baseの通信暗号化機能の設定

JP1/Baseの通信暗号化機能を設定します。通信暗号化機能では，SSL通信を有効にするかどうか，およびサーバ証明書やルート証明書のファイル名などを設定します。この設定は，サーバ側およびクライアント側のJP1/Baseで必要な作業です。

通信暗号化機能の設定手順を次に示します。

SSL通信定義ファイル（jp1bs_ssl.conf）を作成する。

SSL通信定義ファイルに，SSL通信を有効にするかどうか，およびサーバ証明書のファイル名やルート証明書の格納先などのSSL通信の設定情報を定義します。SSL通信定義ファイルの詳細については，「16.　定義ファイル」の「SSL通信定義ファイル」を参照してください。

jbssetcnfコマンドを実行する。

jbssetcnf jp1bs_ssl.conf

SSL通信定義ファイルの情報が共通定義情報に登録されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

JP1/Baseを再起動する。

共通定義情報の設定が有効になります。

注意事項

JP1/Baseの起動中は，通信暗号化機能の設定は変更できません。有効期限切れに伴うサーバ証明書やルート証明書の入れ替えなどで，通信暗号化機能の設定を変更する場合は，JP1/Baseを停止してから変更してください。

11-00以降のJP1/Baseの通信暗号化機能（SSL通信）を有効にしている環境からバージョンアップした場合，12-10で対応した通信暗号化機能（SSL通信）は有効になりません。SSL通信を有効にする場合は，SSL通信定義ファイルのBASESSLにjp1bsagentを追加したあと，JP1/Baseを再起動してください。

6.13.5　イベントサービス使用時の注意事項

JP1/Baseの通信暗号化が有効な環境で，JP1イベントを取得するローカルホストとJP1イベントの転送先ホストの間のイベントサービスがSSL通信をする場合，物理ホストまたは論理ホスト1台の起動が必要です。物理ホスト以外を起動している場合，イベントサービスのAPI設定ファイルにイベントサービスのホストを指定してください。

イベントサービスのホストの指定方法については，「16.　定義ファイル」の「API設定ファイル」を参照してください。

第4編　運用・操作編

7　起動と終了

この章では，JP1/Baseを起動および終了する方法を説明します。

7.1　JP1/Baseを起動および終了する（Windowsの場合）

Windowsの場合，次の表に示すサービスを提供しています。

表7‒1　JP1/Baseのサービス一覧（Windows）

サービス

［コントロールパネル］の［サービス］

ダイアログボックスに表示される名称

統合トレース（HNTRLib2）

Hitachi Network Objectplaza Trace Monitor 2

統合トレース（HNTRLib2）64bit

Hitachi Network Objectplaza Trace Monitor 2 (x64)

起動管理

JP1/Base Control Service

ユーザー管理を含むプロセス管理

JP1/Base※1

イベントサービス

JP1/Base Event※1

ログファイルトラップ管理サービス※2

JP1/Base LogTrap

イベントログトラップサービス

JP1/Base EventlogTrap

注※1　論理ホストのサービス名はそれぞれ次のように表示されます。

JP1_Base_論理ホスト名

JP1_Base_Event 論理ホスト名

注※2　ログファイルトラップ管理サービスは，ログファイルトラップを使用するために必要なサービスです。

注意事項

上記サービスの［ログオン］の設定は，初期設定の「システムアカウント」のまま変更しないでください。また，［デスクトップとの対話をサービスに許可］オプションにチェックを入れないでください。サービスが正常に動作しなくなるおそれがあります。

サービスの起動方法，および終了方法について次に説明します。

7.1.1　サービスの起動

Windowsの場合，次に示すサービスが，サービスに「自動」で登録され，システムの起動時に自動起動するように初期設定されています。

Hitachi Network Objectplaza Trace Monitor 2（統合トレース）

Hitachi Network Objectplaza Trace Monitor 2 (x64)（統合トレース 64bit版）

JP1/Base Control Service（起動管理）※

注※　JP1/Power Monitorをインストールしている環境では，JP1/Base Control Serviceの起動方法を「手動」に変更しないでください。JP1/Power Monitorが正常に動作しなくなります。

また，JP1/Base Control Service（起動管理）が起動すると，次に示すサービスが起動するように初期設定されています。

JP1/Base（ユーザー管理を含むプロセス管理）

JP1/Base Event（イベントサービス）

JP1/Base LogTrap（ログファイルトラップ管理サービス）

通常は，この設定を変更する必要はありません。なお，JP1/Base EventlogTrap（イベントログトラップサービス）やほかのアプリケーションプログラムについてもJP1/Base Control Service（起動管理）を使って順序性を持たせて自動起動するように設定できます。起動管理を利用する方法については，「9.　サービスの起動順序および終了順序の設定（Windows限定）」を参照してください。

JP1/Base Control Service（起動管理）を利用しない場合

JP1/Base Control Service（起動管理）を利用しないで各サービスを起動したい場合は，起動順序定義ファイル（JP1SVPRM.DAT）中に定義されている該当するサービスの定義を必ずコメントアウトしてください。また，依存関係にあるすべてのサービスの定義も必ずコメントアウトしてください。該当するサービスに関する定義部分すべての行頭に#（シャープ）を付けることによってコメントアウトできます。

起動順序定義ファイル（JP1SVPRM.DAT）を編集したあと，各サービスの操作を［コントロールパネル］の［サービス］ダイアログボックス上で行ってください。コメントアウトしないで各サービスを自動起動または手動起動した場合，KAVA4003-Eメッセージが出力され，正常に動作しなくなる場合があります。

2034年10月以降も使用する場合

JP1/Baseのコマンド実行のサービス（プロセス）は，2034年10月以降は使用できません。そのため，2034年9月末までに，次に示す手順を実施して，コマンド実行のサービス（プロセス）の起動を抑止するための設定を行う必要があります。

JP1/Baseの起動プロセスの状態を確認する。

認証サーバが起動している場合と起動していない場合で設定手順が異なるため，JP1/Baseを起動した状態で，jbs_spmd_statusコマンドを実行し，認証サーバが起動しているかどうかを確認します。コマンド実行後，表示される情報の中にjbssessionmgrがあれば，認証サーバが起動しています。

2038年対応起動プロセス定義ファイルのモデルファイルをコピーして，起動プロセス定義ファイルを作成する。

■認証サーバが起動していない場合

copy インストール先フォルダ¥conf¥jp1bs_spmd.conf.2038_model インストール先フォルダ¥conf¥jp1bs_spmd.conf

■認証サーバが起動している場合

copy インストール先フォルダ¥conf¥jp1bs_spmd.conf.session.2038_model インストール先フォルダ¥conf¥jp1bs_spmd.conf

JP1/Baseを起動または再起動する。

設定はJP1/Baseの起動時に有効となります。JP1/Baseが起動済みの場合は，再起動してください。

コマンド実行のサービス（プロセス）が起動していないことを確認する。

jbs_spmd_statusコマンドを実行し，コマンド実行のサービス（プロセス）が起動していないことを確認します。コマンド実行後，表示される情報の中にjcocmdがなければ，コマンド実行のサービス（プロセス）は起動していません。

注意事項

起動管理を使用する場合，起動順序定義ファイル（JP1SVPRM.DAT）中に定義されているサービスに対しては，［コントロールパネル］の［サービス］ダイアログボックス上で操作しないでください。KAVA4003-Eメッセージが出力され，起動管理によるサービスの自動起動および自動終了が正常に動作しなくなる場合があります。

ログファイルトラップ管理サービスおよびイベントログトラップサービスはイベントサービスの起動が前提です。ログファイルトラップ管理サービスおよびイベントログトラップサービスを起動する場合は，最初にイベントサービスを起動してください。

JP1/Baseがインストールされていて，イベントサービスが起動されていない場合，イベントサービスを利用するプログラムの性能に影響が出る場合があります。これを避けるため，イベントサービスを起動しない場合には，「16.　定義ファイル」の「API設定ファイル」を参照して，イベントの発行・取得を禁止する設定を行ってください。

JP1/Baseサービス開始中の状態で，jbs_spmd_status，jbs_spmd_reload，またはjbs_spmd_stopコマンドを実行すると，サービスが正しく起動されない場合があります。JP1/Baseサービス開始中は，これらのコマンドを実行しないでください。

認証サーバの起動時に，パスワードポリシーの定義内容をチェックします。定義内容に誤りがあった場合は，設定パラメーターの省略時の仮定値で起動します。

7.1.2　サービスの起動確認

JP1/Baseのサービスが起動しているかどうかは，［コントロールパネル］の［サービス］ダイアログボックスで確認してください。状態が「開始」になっていれば，サービスは起動しています。

なお，Hitachi Network Objectplaza Trace Monitor 2サービス（統合トレース）が起動していなかった場合は，［コントロールパネル］の［サービス］ダイアログボックスで手動起動させてください。

そのほかのJP1/Baseのサービスを起動する場合は，JP1/Base Control Serviceサービス（起動管理）を利用して起動することをお勧めします（初期設定では，Hitachi Network Objectplaza Trace Monitor 2サービス，JP1/Base EventlogTrapサービス以外のサービスが起動するように設定されています）。起動管理の詳細については「9.　サービスの起動順序および終了順序の設定（Windows限定）」を，起動管理を利用しないでサービスを起動する方法については「7.1.1　サービスの起動」を参照してください。

7.1.3　サービスの終了

JP1/Baseでは，JP1/Base Control Service（起動管理）を利用してシステムの終了時にサービスを自動終了できます。ただし，サービスの自動終了を行いたい場合は，JP1/Power Monitorが必要です。サービスの自動終了を行いたいマシンにJP1/Power Monitorをインストールしてください。

JP1/Base Control Service（起動管理）を利用する方法については，「9.　サービスの起動順序および終了順序の設定（Windows限定）」を参照してください。また，JP1/Power Monitorの詳細については，マニュアル「JP1/Power Monitor」を参照してください。

JP1/Base Control Service（起動管理）およびJP1/Power Monitorを利用しないで各サービスを終了したい場合は，各サービスの操作を［コントロールパネル］の［サービス］ダイアログボックス上で行ってください。

なお，イベントサービス（JP1/Base Event）を停止する場合，先にユーザー管理を含むプロセス管理（JP1/Base），ログファイルトラップ管理サービス（JP1/Base LogTrap），イベントログトラップサービス（JP1/Base EventlogTrap）を停止してください。

7.2　JP1/Baseを起動および終了する（UNIXの場合）

UNIXの場合，コマンドを使ってJP1/Baseの各機能を起動および終了します。

表7‒2　コマンドを使って起動および終了できるJP1/Baseの機能一覧（UNIX）

機能

起動コマンド

終了コマンド

統合トレース（HNTRLib2）※1

hntr2mon -d &

hntr2kill

イベントサービス

jevstart

jevstop

ユーザー管理を含むプロセス管理

jbs_spmd

jbs_spmd_stop

ログファイルトラップ管理デーモン※2

jevlogdstart

jevlogdstop

JP1/Base

jbs_start.model※3※5※6

jbs_stop.model※4※5※6

注※1　統合トレース（HNTRLib2）は，JP1/Baseのインストール時に自動起動および自動終了するように設定されています。

注※2　ログファイルトラップ管理デーモンは，ログファイルトラップを使用するために必要なデーモンです。なお，ログファイルトラップ管理デーモンは，起動した状態でシステムを停止してもかまいません。

注※3　jbs_start.modelは，/etc/opt/jp1baseディレクトリに格納されています。jbs_start.modelを使用すると，統合トレース（HNTRLib2）以外のすべての機能を起動できます。通常はこのスクリプトを使用してJP1/Baseを起動してください。

注※4　jbs_stop.modelは，/etc/opt/jp1baseディレクトリに格納されています。jbs_stop.modelを使用すると，統合トレース（HNTRLib2）とログファイルトラップ管理デーモン以外のすべての機能を終了できます。通常は，このスクリプトを使用してJP1/Baseを終了してください。なお，クラスタシステムでないシステムで運用し，論理ホストでJP1/Baseを稼働させないで，統合トレース（HNTRLib2）以外の機能を終了する場合は，jevlogdstopコマンドを実行後，jbs_stop.modelを実行してください。

注※5 jbs_start.model，jbs_stop.modelの設定は，インストール時の環境変数LANG に設定されている文字コードに合わせて設定されています。言語種別を変更してJP1/Baseの起動／停止に使用する場合は，モデルファイルを変更するのではなく，以下の手順で設定変更したファイルを使用してください。

　1.jbs_start.model，jbs_stop.modelを任意のファイル名でコピーする。

　2.コピーしたファイルの環境変数LANGの設定を変更する。

なお，環境変数LANGの設定はjp1bs_env.conf，jp1bs_param.confの言語種別と合わせてください。

注※6 jbs_start.model，jbs_stop.modelの環境変数LANGの設定を変更した場合，JP1/Baseの上書きインストール時に，変更が保持されません。そのため，環境変数LANGの設定変更は注※5の手順で行うようにしてください。

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

2034年10月以降も使用する場合

JP1/Baseのコマンド実行のサービス（プロセス）は，2034年10月以降は使用できません。そのため，2034年9月末までに，次に示す手順を実施して，コマンド実行のサービス（プロセス）の起動を抑止するための設定を行う必要があります。

JP1/Baseの起動プロセスの状態を確認する。

認証サーバが起動している場合と起動していない場合で設定手順が異なるため，JP1/Baseを起動した状態で，jbs_spmd_statusコマンドを実行し，認証サーバが起動しているかどうかを確認します。コマンド実行後，表示される情報の中にjbssessionmgrがあれば，認証サーバが起動しています。

2038年対応起動プロセス定義ファイルのモデルファイルをコピーして，起動プロセス定義ファイルを作成する。

■認証サーバが起動していない場合

cp -p /etc/jp1base/conf/jp1bs_spmd.conf.2038_model /etc/opt/jp1base/conf/jp1bs_spmd.conf

■認証サーバが起動している場合

cp -p /etc/jp1base/conf/jp1bs_spmd.conf.session.2038_model /etc/opt/jp1base/conf/jp1bs_spmd.conf

JP1/Baseを起動または再起動する。

設定はJP1/Baseの起動時に有効となります。JP1/Baseが起動済みの場合は，再起動してください。

コマンド実行のサービス（プロセス）が起動していないことを確認する。

jbs_spmd_statusコマンドを実行し，コマンド実行のサービス（プロセス）が起動していないことを確認します。コマンド実行後，表示される情報の中にjcocmdがなければ，コマンド実行のサービス（プロセス）は起動していません。

注意事項

jbs_start，jbs_start.cluster，またはjbs_spmdコマンドを同時に実行した場合，JP1/Baseを正しく起動できない場合があります。これらのコマンドを同時に実行しないでください。

UNIXの場合，ユーザー管理を含むプロセス管理，イベントサービスおよびログファイルトラップ管理デーモンを，システムの起動時に自動起動させられます。また，ユーザー管理を含むプロセス管理やイベントサービスをシステムの終了時に自動終了させられます。

自動起動および自動終了の設定については，次に説明します。

7.2.1　自動起動および自動終了の設定

システムの起動時にユーザー管理を含むプロセス管理，イベントサービス，およびログファイルトラップ管理デーモンを自動起動する場合，インストールとセットアップの完了後，次に示す操作をします。

cd /etc/opt/jp1base
cp -p jbs_start.model jbs_start

また，システムの終了時にユーザー管理を含むプロセス管理およびイベントサービスを自動終了する場合，インストールとセットアップの完了後，次に示す操作をします。

cd /etc/opt/jp1base
cp -p jbs_stop.model jbs_stop

注意事項

ログファイルトラップを自動起動する場合，ログファイルトラップ起動定義ファイルを設定してください。

ログファイルトラップをjbs_startを使用して自動起動する場合，jbs_startを必要に応じて編集してください。この場合，イベントサービスおよびログファイルトラップ管理デーモンの起動後，ログファイルトラップを起動するように設定してください。

自動起動および自動終了の設定は，インストール時の環境変数LANGに設定されている文字コードに合わせて設定されます。ただし，「3.4.2　使用する言語種別を設定する（UNIXの場合）」の表3-5で示した文字コード以外が設定されている場合は，環境変数LANGにCを設定します。

jp1bs_env.conf，jp1bs_param.confの言語種別を変更する場合は，自動起動スクリプトの環境変数LANGを合わせてください。

自動起動スクリプト（jbs_start）は，初期設定でLC_ALL，LC_COLLATE，LC_CTYPE，LC_MONETARY，LC_NUMERIC，LC_TIME，およびLC_MESSAGESのロケール設定を解除（unset）します。

AIX環境の場合

AIX環境で自動起動および自動終了する場合は，上記の操作に加え次に示す操作も必要です。

自動起動を設定する。

mkitabコマンドで，/etc/inittabファイルにJP1/Baseの記述を追加します。

mkitab -i hntr2mon "jp1base:2:wait:/etc/opt/jp1base/jbs_start"

設定内容を確認する。

lsitabコマンドで，/etc/inittabファイルの設定内容を確認します。

lsitab -a

プロセスを起動する順序のとおり，hntr2mon（統合トレース），jp1baseの順に記述されていることを確認してください。

init:2:initdefault:

brc::sysinit:/sbin/rc.boot 3 >/dev/console 2>&1 # Phase 3 of system boot

：

：

hntr2mon:2:once:/opt/hitachi/HNTRLib2/etc/D002start

jp1base:2:wait:/etc/opt/jp1base/jbs_start

注　hntr2mon:2:once:/opt/hitachi/HNTRLib2/etc/D002startのエントリは，JP1/Baseのアンインストール時に統合トレース機能を使っている製品が他になければ削除されます。

自動終了を設定する。

JP1/Baseを前提とする製品の記述のあとに，テキストエディターで，/etc/rc.shutdownファイルにJP1/Baseの記述を追加します。

test -x /etc/opt/jp1base/jbs_stop && /etc/opt/jp1base/jbs_stop

test -x /opt/hitachi/HNTRLib2/etc/D002stop && /opt/hitachi/HNTRLib2/etc/D002stop

終了時の処理を追加する。

/etc/rc.shutdownファイルの最後に，次に示す1行を追加してください。

exit 0

/etc/rc.shutdownスクリプトは，最後に実行したコマンドの終了コードが「0」以外の場合は，エラーと認識しシャットダウン処理を中断します。

注意事項

自動起動および自動終了の設定は，インストール時の環境変数LANGに設定されている文字コードに合わせて設定されます。ただし，「3.4.2　使用する言語種別を設定する（UNIXの場合）」の表3-5で示した文字コード以外が設定されている場合は，環境変数LANGにCを設定します。

jp1bs_env.conf，jp1bs_param.confの言語種別を変更する場合は，自動起動スクリプトの環境変数LANGを合わせてください。

自動起動スクリプト（jbs_start）は，初期設定でLC_ALL，LC_COLLATE，LC_CTYPE，LC_MONETARY，LC_NUMERIC，LC_TIME，およびLC_MESSAGESのロケール設定を解除（unset）します。

AIXでは，メモリー不足が発生するとOSがSIGKILLを発行し，JP1/Baseのプロセスが終了することがあります。この現象を回避するには，環境変数にPSALLOC=earlyを設定し，JP1/Baseを起動してください。

なお，環境変数PSALLOCにearlyを設定する場合には，同時に環境変数NODISCLAIM=trueを設定する必要があります。

自動起動スクリプト中に設定する例を次に示します。

1. 自動スクリプト中の次の部分を検索する。

　export PATH LANG SHLIB_PATH LD_LIBRARY_PATH LIBPATH HCCLIBCNF

2. 1.で検索した行の後に，次を追加する。

　PSALLOC=early

　NODISCLAIM=true

　export PSALLOC NODISCLAIM

Linux環境の場合

Linux環境で自動起動および自動終了の設定をする場合は，次をセットで作成してください。

/etc/opt/jp1base/jbs_start
/etc/opt/jp1base/jbs_stop

jbs_startおよびjbs_stopが存在しないときにシステムの起動，およびシステムの終了が行われると，syslogに次のメッセージが出力されます。メッセージは出力されますが，設定が行われていないため，自動起動，および自動停止は行われません。

起動時：systemd: Started JP1/Base Service.

JP1/Baseの自動起動・自動停止を有効にしたあと，JP1/Baseを手動で起動したり停止したりする場合は，次のコマンドを実行してください。コマンドを実行したあと，jbs_spmd_statusコマンド，およびjevstatコマンドでプロセスの状態を確認してください。

JP1/Baseの起動

物理ホスト

systemctl start jp1_base.service

論理ホスト

systemctl start jp1_base_論理ホスト名.service

JP1/Baseの停止

物理ホスト

systemctl stop jp1_base.service

論理ホスト

systemctl stop jp1_base_論理ホスト名.service

systemctlコマンド以外の，jbs_start/jbs_start.clusterコマンド，jbs_stop/jbs_stop.clusterコマンド，jbs_spmdコマンドおよびjbs_spmd_stopコマンドで起動したり停止したりすると，JP1/Baseの自動停止が行われません（システムの停止時に停止スクリプトは起動されませんが自動起動・自動停止の設定は有効なままです）。JP1/Baseをシステムの停止時に自動停止させる場合は，再度，systemctlコマンドによる起動の操作を行ってください。JP1/Baseが自動停止するかどうかは，次のコマンドを実行して，「active」が表示されることを確認してください。

物理ホスト

systemctl is-active jp1_base.service

論理ホスト

systemctl is-active jp1_base_論理ホスト名.service

Linux 8以降でSELinuxを有効にしている場合は，jbs_startおよびjbs_stopのコンテキストタイプをbin_tに設定してください。

設定例

# semanage fcontext -a -t bin_t '/etc/opt/jp1base/jbs_start'
# semanage fcontext -a -t bin_t '/etc/opt/jp1base/jbs_stop'
# restorecon -F /etc/opt/jp1base/jbs_start
# restorecon -F /etc/opt/jp1base/jbs_stop

Linux 9以降でSELinuxを有効にしている場合は，/opt/hitachi/HNTRLib2/etc 以下のファイルのコンテキストタイプをusr_tに設定してください。

設定例

# semanage fcontext -a -t usr_t '/opt/hitachi/HNTRLib2/etc(/.*)?'
# restorecon -R -F /opt/hitachi/HNTRLib2/etc

7.2.2　JP1/Baseの起動確認

JP1/Baseが起動しているかどうか確認する場合は，jbs_spmd_statusコマンド，およびjevstatコマンドを使ってJP1/Baseのプロセスの動作状態を確認してください。JP1/Baseのプロセスについては，「付録B.2　プロセス一覧（UNIXの場合）」を参照してください。また，ユーザーが意図するJP1/Baseの機能が起動していなかった場合は，コマンドを使って起動してください。コマンドの詳細については「15.　コマンド」を参照してください。

注意事項

JP1/Baseを上書きインストールした場合，統合トレースをhntr2monコマンドを使って起動してください。これは，上書きインストール時に統合トレースが停止し，JP1/Baseを起動しても統合トレースログで情報を採取できなくなるからです。hntr2monコマンドの詳細については，「15.　コマンド」の「hntr2mon（UNIX限定）」を参照してください。

8　ユーザー管理の設定

この章では，ユーザー管理の設定方法について，Windowsの場合とUNIXの場合に分けて説明します。

なお，この章ではJP1/IMおよびJP1/AJSの説明を中心に記載していますが，そのほかのJP1製品でも利用できる場合があります。各JP1製品のマニュアルでご確認ください。

8.1　ユーザー管理の設定（Windowsの場合）

JP1/Baseインストール時に自動セットアップ処理を実行した場合は，初期設定値が設定されています。自動セットアップ処理の初期設定値については，「3.2.1　インストール」を参照してください。

設定方法は，認証サーバとして使用するホストと認証サーバとして使用しないホストで異なります。

また，セカンダリー認証サーバを設置する場合，プライマリー認証サーバとセカンダリー認証サーバで設定する情報を同じにする必要があります。各ホストで必要な設定の流れと，マニュアルの参照先を次の図に示します。

図8‒1　ユーザー管理の設定の流れ（Windowsの場合）

Windowsの場合，GUIまたはコマンドを使ってユーザー管理を設定します。GUIを表示するには，Windowsのスタートメニューから［プログラム］−［JP1_Base］−［JP1_Base Setup］を選択してください。［JP1/Base環境設定］ダイアログボックスが表示されます。なお，GUIを操作するには，Administrators権限が必要です。［JP1/Base 環境設定］ダイアログボックスを次の図に示します。

図8‒2　［JP1/Base 環境設定］ダイアログボックス

8.1.1　使用する認証サーバを指定する

認証サーバにするJP1/Baseがインストールされているホストを指定します。認証サーバは，次に示すホスト上で指定する必要があります。

認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）

JP1/IM - ManagerやJP1/AJS - Managerなど，JP1/Baseのユーザー認証を利用する製品がインストールされたホスト

認証サーバに指定したホストが，JP1ユーザーや，JP1資源グループに対する操作権限を管理します。JP1/IMやJP1/AJSなど，JP1/Baseのユーザー認証を利用する製品が認証サーバとSSL通信をする場合は，JP1/BaseをインストールしたホストでSSL通信設定を有効にしてください。なお，SSL通信を使用する場合は，JP1/Baseのユーザー認証を利用するすべての製品でJP1/Baseの前提バージョンが11-00以降である必要があります。

なお，認証サーバホストで通信暗号化機能（SSL通信）を有効にした場合，その認証サーバに接続するホストもSSL通信を有効にする必要があります。SSL通信を使用しないホストからユーザー認証をする必要がある場合は，SSL通信をしない認証サーバを設置してユーザー認証圏を分けてください。また，SSL通信を使用するには，認証サーバホストおよびその認証サーバに接続するホストのJP1/Baseのバージョンが11-00以降である必要があります。

認証サーバは，GUIまたはコマンドを使用して設定できます。

(1)　GUIを使って認証サーバを設定する

認証サーバは，［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブの［認証サーバの検索順序］で指定します。［認証サーバの検索順序］では，認証サーバの追加，指定済み認証サーバの削除および変更ができます。それぞれの手順について次に説明します。なお，［認証サーバの検索順序］で自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定する場合は，「JP1/Base」サービスを停止してから，設定してください。

認証サーバの追加

自ホストが認証サーバとして利用できるホストは，2台までです。［認証サーバ名］の上方に表示される認証サーバがプライマリー認証サーバ，下方に表示される認証サーバがセカンダリー認証サーバです。

［認証サーバ名］に認証サーバが2台指定されていなければ，認証サーバを追加できます。

［追加］ボタンをクリックする。

［認証サーバ］ダイアログボックスで認証サーバ名を入力し，［OK］ボタンをクリックする。

［認証サーバ］タブに戻ります。［認証サーバ名］に，［認証サーバ］ダイアログボックスで指定した認証サーバ名が表示されます。なお，認証サーバに指定するホストは，自ホストでも他ホストでもかまいません。

注意事項

認証サーバ名には，ホスト名を入力してください。IPアドレスは指定できません。

指定済み認証サーバの削除

［認証サーバ名］から削除したい認証サーバを選択する。

［削除］ボタンをクリックする。

指定済み認証サーバの変更

［認証サーバ名］から変更したい認証サーバを選択する。

［変更］ボタンをクリックする。

［認証サーバ］ダイアログボックスで認証サーバを変更します。

［OK］ボタンをクリックする。

［認証サーバ］タブに戻ります。［認証サーバ名］に，［認証サーバ］ダイアログボックスで変更した認証サーバ名が表示されます。

なお，プライマリー認証サーバとセカンダリー認証サーバを入れ替えたい場合は，［認証サーバ名］に表示されている認証サーバを選択し，［上へ］ボタンまたは［下へ］ボタンをクリックしてください。

注意事項

2台目の認証サーバの追加や認証サーバを2台指定した状態で認証サーバを変更した場合，［認証サーバ］ダイアログボックスの［認証サーバを閉塞状態に設定する］が活性化されます。これをチェックすると，その認証サーバは，認証サーバとして利用できなくなるため，通常はチェックしないでください。

［認証サーバの検索順序］での設定が完了したら，［適用］ボタンをクリックしてください。［認証サーバの検索順序］での設定が反映されます。自ホストを認証サーバに指定した場合，［認証サーバ名］で認証サーバ（自ホスト）を選択する（反転表示させる）と，［JP1ユーザー］および［JP1資源グループ別権限レベル］が活性化します。

(2)　コマンドを使って認証サーバを設定する

jbssetupsrvコマンドを使って，認証サーバの登録および削除ができます。jbssetupsrvコマンドの詳細については，「15.　コマンド」の「jbssetupsrv（Windows限定）」を参照してください。

認証サーバの登録

認証サーバを登録する場合は，次に示すコマンドを実行します。

jbssetupsrv [-h 論理ホスト名]
            プライマリー認証サーバ名 [セカンダリー認証サーバ名]

認証サーバの削除

認証サーバを削除する場合は，次に示すコマンドを実行します。

jbssetupsrv [-h 論理ホスト名]
            -d [認証サーバ名]

-hオプションの論理ホスト名を省略した場合は，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合は，物理ホスト名が仮定されます。

セカンダリー認証サーバ名を省略した場合は，ユーザー認証圏内で稼働する認証サーバは1台だけとなります。

-dオプションだけを指定した場合は，指定した論理ホストの認証サーバをすべて削除します。

(3)　認証サーバ設定後の作業

認証サーバを確認したい場合は，次に示すコマンドを実行してください。

jbslistsrv [-h 論理ホスト名]

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

自ホストをプライマリー認証サーバに指定した場合は，「8.1.2　JP1ユーザー（標準ユーザー）を設定する」に進んでください。

自ホストをセカンダリー認証サーバに指定した場合は，プライマリー認証サーバに指定した認証サーバでの設定を済ませたあと，「8.1.4　プライマリー認証サーバの設定情報をコピーする」に進んでください。

自ホストを認証サーバに指定しなかった場合は，ユーザー認証の設定は終了です。

8.1.2　JP1ユーザー（標準ユーザー）を設定する

認証サーバでユーザー認証をするJP1ユーザー（標準ユーザー）を設定します。なお，ディレクトリサーバと連携してユーザー認証する場合（連携ユーザーまたはDSユーザーを使用する場合）は，「8.2　ディレクトリサーバと連携してユーザー認証する場合の設定（Windows限定）」を参照してください。特に断り書きがない場合，この項では「JP1ユーザー」とは「JP1ユーザー（標準ユーザー）」を示します。

JP1ユーザーは，プライマリー認証サーバに指定したホストで設定します。JP1ユーザーを設定する場合，「JP1/Base」サービスが起動している必要があります。「JP1/Base」サービスが起動していないときは，JP1ユーザーを設定する前に「JP1/Base」のサービスを起動してください。

なお，JP1ユーザーは，GUIまたはコマンドを使用して設定できます。

JP1ユーザー登録，およびパスワード変更時に，パスワードポリシー定義に従い，認証サーバは，指定されたパスワードのチェックをします。パスワードがパスワードポリシーに違反している場合，認証サーバは，警告メッセージを統合トレースログに出力します。この統合トレースログを参照することで，ポリシーに違反している要因を特定できます。

パスワードポリシー定義に設定したすべてのポリシーの条件を満たさない場合は，エラーとなります。

重要

パスワードポリシー定義によるパスワードのチェックをする設定の場合に，コマンドの実行時に入力したパスワードがパスワードポリシーに違反していると，KAVA5908-Eのメッセージが出力されます。

(1)　GUIを使ってJP1ユーザーを設定する

JP1ユーザーの設定は，［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブの［JP1ユーザー］で行います。

［JP1ユーザー］で設定する場合，［JP1ユーザー］を活性化する必要があります。［認証サーバの検索順序］の［認証サーバ名］で認証サーバを選び（反転表示させて），［JP1ユーザー］を活性化してください。なお，次に示す場合には，［JP1ユーザー］は活性化しないため，注意が必要です。

［認証サーバの検索順序］で認証サーバを変更し，［適用］ボタンが活性化していた場合

選んだ（反転表示させた）認証サーバの状態が「閉塞中」の場合

［適用］ボタンが活性化していた場合は，［適用］ボタンをクリックしてください。「閉塞中」だった場合は，「8.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）」を参照して，閉塞状態を解除してください。

［追加］ボタンをクリックすると，［JP1ユーザー］ダイアログボックスが表示されます。

図8‒3　［JP1ユーザー］ダイアログボックス

このダイアログボックスでJP1ユーザーおよびパスワードを設定します。［ディレクトリサーバに連携する］はチェックしないでください。チェックすると連携ユーザーの入力モードになり，パスワードが入力できなくなります。

JP1ユーザー名に使用できるのは，小文字だけです。大文字で入力した場合でも小文字のJP1ユーザー名として登録します。パスワードは，大文字と小文字を区別して入力してください。JP1ユーザー名およびパスワードに指定できる文字の制限を次の表に示します。

表8‒1　JP1ユーザー名およびパスワードの文字制限

対象

バイト数

使用禁止文字

JP1ユーザー名

1〜31バイト

* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < > およびスペース，タブ

パスワード※

6〜32バイト

パスワードポリシーを定義していない場合

¥ " : およびスペース，タブ

パスワードポリシーを定義している場合

パスワードポリシー定義ファイルの設定に従う

注※

パスワードポリシーによるパスワードのチェックをする設定の場合，「2.1.1(3)　パスワードポリシーによる管理」を参照してください。

［OK］ボタンまたは［キャンセル］ボタンをクリックすると，［認証サーバ］タブに戻ります。

登録されたJP1ユーザーは［ユーザー名］に表示されます。登録したJP1ユーザーのパスワードを変更したい場合は，［ユーザー名］に表示されたJP1ユーザーを選択し，［パスワード変更］ボタンをクリックしてください。

また，［ユーザー名］に表示されたJP1ユーザーを選択し，［削除］ボタンをクリックすると，選択したJP1ユーザーが削除されます。

(2)　コマンドを使ってJP1ユーザーを設定する

コマンドを使って，JP1ユーザーの登録，削除，およびJP1ユーザーのパスワードの変更ができます。また，登録したJP1ユーザーを一覧表示するコマンドも提供しています。各コマンドの詳細については，「15.　コマンド」を参照してください。

JP1ユーザーの登録

JP1ユーザーを認証サーバに登録する場合，次に示すコマンドを実行します。

jbsadduser JP1ユーザー名

JP1ユーザー名には，小文字だけを使用してください。

コマンド実行後にパスワードの入力を促されます。大文字と小文字を区別して入力してください。JP1ユーザー名およびパスワードに指定できる文字の制限については，表8-1を参照してください。

パスワードポリシー定義によるパスワードのチェックをする設定の場合，JP1ユーザーの登録時にパスワードポリシーに即しているかチェックをします。

JP1ユーザーのパスワードの変更

登録したJP1ユーザーのパスワードを変更する場合は，次に示すコマンドを実行します。

jbschgpasswd JP1ユーザー名

パスワードポリシー定義によるパスワードのチェックをする設定の場合，JP1ユーザーのパスワードを変更する時にパスワードポリシーに即しているかチェックをします。

JP1ユーザーの削除

登録したJP1ユーザーを削除する場合は，次に示すコマンドを実行します。

jbsrmuser JP1ユーザー名

JP1ユーザーの一覧表示

登録したJP1ユーザーの情報を確認する場合は，次に示すコマンドを実行します。

jbslistuser

8.1.3　JP1ユーザーの操作権限を設定する

認証サーバ（プライマリー認証サーバ）で必要な設定です。JP1ユーザーが，ジョブやジョブネットなどのJP1資源グループに対して，どのような操作ができるか（JP1権限レベル）を設定します。

注意事項

JP1/AJSで，JP1資源グループ名を指定していないジョブやジョブネットは，操作権限の設定の対象になりません。すべてのJP1ユーザーによるすべてのアクセスができるようになります。

JP1ユーザーの操作権限の設定はGUIまたはコマンドで設定します。GUIの場合は，個別にJP1ユーザーの操作権限を設定します。コマンドの場合は，個別設定だけではなく，複数のJP1ユーザーの操作権限を一括して設定することもできます。

(1)　GUIを使ってJP1ユーザーの操作権限を設定する

［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブの［JP1資源グループ別権限レベル］で設定します。

［JP1ユーザー］の［ユーザー名］から設定したいユーザーを選択します。選択すると，［JP1資源グループ別権限レベル］にそのユーザーがアクセスできるグループ（JP1資源グループ）とそのグループに対する権限レベル（JP1権限レベル）が表示されます。

［追加］ボタン，または［グループ名］に表示されるグループを選択し，［変更］ボタンをクリックすると，［JP1資源グループ詳細］ダイアログボックスが表示されます。

図8‒4　［JP1資源グループ詳細］ダイアログボックス

［JP1資源グループ詳細］ダイアログボックスでJP1資源グループとJP1権限レベルを設定します。JP1資源グループに「*」を指定すると，すべてのJP1資源グループにアクセスできるようになります。なお，JP1資源グループで「*」を指定したJP1ユーザーに，「*」以外のJP1資源グループは設定しないでください。

指定するJP1資源グループおよびJP1権限レベルの詳細については，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。

(2)　コマンドを使ってJP1ユーザーの操作権限を一括して設定する

コマンドを使ってJP1ユーザーの操作権限を一括して設定できます。JP1ユーザーの操作権限を一括して登録する場合，ユーザー権限レベルファイル（JP1_UserLevel）に操作権限を定義します。編集後，jbsaclreloadコマンドを実行すると設定が反映されます。jbsaclreloadコマンドの詳細については，「15.　コマンド」の「jbsaclreload」を参照してください。ユーザー権限レベルファイルの詳細については，「16.　定義ファイル」の「ユーザー権限レベルファイル」を参照してください。

注意事項

ユーザー権限レベルファイル（JP1_UserLevel）は，GUIでも利用しています。GUIで設定した内容は，このファイルに反映されます。また，このファイルをエディターで編集後，jbsaclreloadコマンドを実行すれば，設定した内容がGUIに反映されます。

(3)　コマンドを使ってJP1ユーザーの操作権限を個別に登録する

コマンドを使ってJP1ユーザーの操作権限を追加または変更する場合，登録したいJP1ユーザーの操作権限を記述したユーザー権限定義ファイルを作成する必要があります。

ユーザー権限定義ファイルは，ユーザーが任意の場所に格納できます。ユーザー権限定義ファイルの詳細については，「16.　定義ファイル」の「ユーザー権限定義ファイル」を参照してください。

ユーザー権限定義ファイルを設定したあと，次のコマンドを実行すると，定義ファイルの情報が認証サーバに登録されます。なお，DSユーザーに操作権限を登録する場合は-dオプションも合わせて指定してください。

jbssetacl -f ユーザー権限定義ファイル名

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

(4)　コマンドを使ってJP1ユーザーの操作権限を個別に削除する

登録したJP1ユーザーの操作権限を個別に削除したい場合は，次のコマンドを実行してください。

jbsrmacl -u JP1ユーザー名

このコマンドを実行すると，指定したJP1ユーザーに設定されている操作権限がすべて削除されるためご注意ください。

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

8.1.4　プライマリー認証サーバの設定情報をコピーする

セカンダリー認証サーバを設置する場合，プライマリー認証サーバと同じ設定で運用しなければなりません。そのため，プライマリー認証サーバの設定完了後，プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーする必要があります。プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーするための手順を次に示します。

プライマリー認証サーバで，JP1ユーザーおよび操作権限の設定を完了する。

JP1ユーザーの設定については，「8.1.2　JP1ユーザー（標準ユーザー）を設定する」または「8.2.1(2)　JP1ユーザー（連携ユーザー）を設定する」を参照してください。

JP1ユーザーの操作権限の設定については，「8.1.3　JP1ユーザーの操作権限を設定する」を参照してください。

セカンダリー認証サーバを起動する。

JP1/Baseのサービスを起動し，セカンダリー認証サーバを起動してください。認証サーバが起動しているかどうかは，jbs_spmd_statusコマンドで確認できます。コマンド実行後，表示される情報の中にjbssessionmgrがあれば，認証サーバが起動しています。

プライマリー認証サーバの設定ファイルをFTPやFDなどを使ってコピーする。

プライマリー認証サーバの設定ファイルをFTPやFDなどを使って，セカンダリー認証サーバにコピーします。コピーする設定ファイルは，JP1_AccessLevel，JP1_Group，JP1_Passwd，JP1_UserLevelです。これらのファイルは以下のフォルダに格納されています。

インストール先フォルダ¥conf¥user_acl¥

コピー先フォルダは，自ホスト上の同じフォルダになります。また，論理ホストの場合は，以下のフォルダに格納されています。

共有フォルダ名¥jp1base¥conf¥user_acl¥

コマンドを使って設定を反映させる。

最後に，コピーした設定情報のファイルの内容を反映させます。jbs_spmd_reloadコマンドを実行し，正常終了すれば設定が有効になります。

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

注意事項

プライマリー認証サーバとセカンダリー認証サーバのJP1/Baseは同じバージョンにしてください。

セカンダリー認証サーバが起動していない場合は，自ホストを認証サーバに指定しているか確認してください。［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブ内の［認証サーバの検索順序］で自ホストを指定していて，かつ，［JP1ユーザー］および［JP1資源グループ別権限レベル］が活性化されているか確認してください。活性化されていれば，JP1/Baseのサービスを起動すると同時に，認証サーバも起動されます。

設定ファイルはテキストファイルです。異なるプラットフォーム間で転送する場合，文字コードに注意してください。FTPで転送する場合は，必ずASCII転送をしてください。

プライマリー認証サーバおよびセカンダリー認証サーバのパスワード保管形式は，必ず一致させてください。JP1/Baseのバージョンが12-00以降では，JP1ユーザーのパスワード保管形式の初期設定をハッシュレベル1モードからハッシュレベル2モードに変更しているため，パスワード保管形式が不一致となる可能性があります。パスワード保管形式は，認証サーバホスト起動時のKAVA1692-Iメッセージで確認してください。パスワード保管形式の設定方法については，「3.4.6　パスワード保管形式の設定」を参照してください。

8.1.5　ユーザーマッピングを設定する前にOSユーザーにユーザー権利を与える

ユーザーマッピングは，JP1ユーザーとOSユーザーを対応づける機能です。Windowsの場合，ユーザーマッピングを設定する前に，ユーザーマッピングされるOSユーザーにWindows特有のユーザー権利を与える必要があります。

ユーザー権利は，OSの機能を使ってOSユーザーに与えます。なお，Active Directoryを使ったドメイン環境で運用している場合と，ドメイン環境で運用していない場合で設定手順が異なります。OSユーザーに必要な権利とOSユーザーにユーザー権利を与える方法について説明します。

(1)　ユーザーマッピングされるOSユーザーに必要なユーザー権利

JP1/IM - Managerでリモートコマンドや自動アクションを実行する場合

「ローカル ログオン」

「サービスとしてログオン」

JP1/AJSでジョブを実行する場合やJP1/Baseでローカルアクションを実行する場合

「ローカル ログオン」

(2)　OSユーザーにユーザー権利を与える方法

OSユーザーにユーザー権利を与える方法は，Active Directoryを使ったドメイン環境で運用している場合と，ドメイン環境で運用していない場合で設定手順が異なります。また，ドメインコントローラーのあるホストとドメイン内のローカルホストとで設定手順が異なります。なお，設定によってはドメインコントローラーのあるホストでOSユーザーにユーザー権利を与えることで，ドメイン内のローカルホストでの設定が不要になります。以降で，それぞれの設定手順を示します。

注意事項

Active Directory環境では「ローカル ログオン」の権利は，ドメインコントローラーの既定値で，Administratorsグループに属するすべてのOSユーザーに与えられています。Administratorsグループに属するOSユーザーを使用している場合は，改めて「ローカル ログオン」のユーザー権利を設定しないでください。

次に示す設定手順は，一つのドメインコントローラホストの直下に複数台のローカルホストを構成している場合の設定手順です。サイトや組織単位（OU）などを構成したり，ポリシーの継承を途中でやめるなど，複雑な設定をしている場合は，この設定手順でユーザー権利を与えられないことがあります。詳しくはActive Directoryの管理者に問い合わせてください。

Active Directoryを使ったドメイン環境でOSユーザーにユーザー権利を与える方法

Active Directoryを使ったドメイン環境でOSユーザーにユーザー権利を与える方法として，ドメインコントローラホストでユーザー権利を設定する手順，およびドメイン内のローカルホストでユーザー権利を設定する手順を次に示します。

ドメインコントローラホストでユーザー権利を設定する手順

ドメインコントローラホストでユーザー権利を設定し，ユーザー権利の設定範囲をドメイン全体にする手順を次に示します。

ドメインコントローラホストの［ドメイン セキュリティ ポリシー］ダイアログボックスで，与えたいユーザー権利を選択し，ドメインユーザーやドメイングループを追加する。

ドメインコントローラホストでコマンドを使って，ポリシーの更新を反映させる。

次に示すコマンドをローカルホストで実行してください。

　gpupdate /target:user

　gpupdate /target:computer

反映されたかどうかは，イベントビューアで確認できます。

ドメインコントローラホストで権限を設定するため，ローカルホストでユーザー権利を設定する必要はありません。

ドメインコントローラホストでユーザー権利を設定し，ユーザー権利の設定範囲をドメインコントローラホストだけにする手順を次に示します。

ドメインコントローラホストの［Default Domain Controllers Policy］または［ローカル セキュリティ ポリシー］ダイアログボックスで，与えたい権利を選択し，ドメインユーザーを追加する。

コマンドを使って，セキュリティポリシーの更新を反映させる。

次に示すコマンドをドメインコントローラホストで実行してください。

　gpupdate /target:user

　gpupdate /target:computer

反映されたかどうかは，イベントビューアで確認できます。

ドメイン内のローカルホストでユーザー権利を設定する手順

ドメイン内のローカルホストでユーザー権利を設定する手順を次に示します。

ローカルホストの［ローカル セキュリティ ポリシー］ダイアログボックスで，与えたいユーザー権利を選択し，ドメインユーザーを追加するコマンドを使って，セキュリティポリシーの更新を反映させる。

次に示すコマンドをローカルホストで実行してください。

　gpupdate /target:user

　gpupdate /target:computer

反映されたかどうかは，イベントビューアで確認できます。

Active Directoryを使わない環境でOSユーザーにユーザー権利を与える方法

ローカルホストでユーザー権利を設定する手順を次に示します。

ローカルホストの［ローカル セキュリティ ポリシー］ダイアログボックスで，与えたいユーザー権利を選択し，OSユーザーを追加する。

コマンドを使って，セキュリティポリシーの更新を反映させる。

次に示すコマンドをローカルホストで実行してください。

　gpupdate /target:user

　gpupdate /target:computer

反映されたかどうかは，イベントビューアで確認できます。

ここでは代表的な手順を示しています。ご使用の環境によっては，手順どおりに設定できないことがあります。その場合は，OSのヘルプやOS関連ドキュメントなどを参照してください。

8.1.6　GUIを使ってユーザーマッピングを設定する

GUIでユーザーマッピングを設定する場合，［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブを選択します。［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブを，次の図に示します。

図8‒5　［JP1/Base 環境設定］ダイアログボックス（［ユーザーマッピング］タブ）

［ユーザーマッピング］タブでは，認証サーバに登録されているJP1ユーザーと自ホストのOSに登録されているユーザー（OSユーザー）をマッピングします。なお，ユーザーマッピングを設定する前に，ユーザーマッピングされるOSユーザーにWindows特有のユーザー権利を与える必要があります。詳細については，「8.1.5　ユーザーマッピングを設定する前にOSユーザーにユーザー権利を与える」を参照してください。

(1)　［パスワード管理］での設定

Windowsの場合，ユーザーマッピングを設定する各ホストで，マッピングするOSユーザーとそのOSユーザーのパスワード情報を，JP1/Baseのパスワード管理情報に登録する必要があります。［パスワード管理］は，OSユーザーとそのOSユーザーのパスワード情報をパスワード管理情報に登録するための項目です。

なお，［パスワード管理］は，ディレクトリサーバと連携してユーザー認証をする際に使用する情報検索用ユーザーを登録するときにも使用しますが，情報検索用ユーザーをマッピングすることはできません。

パスワード管理情報を登録したあとにシステムのOSユーザーのパスワードを変更した場合は，パスワード管理情報に登録してあるOSユーザーのパスワードも変更してください。

注意事項

［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックした場合，次に示す条件であっても，OSユーザーの登録に成功します。

・システム（Windows）に登録されていないOSユーザーの登録

・パスワードが誤っているOSユーザーの登録

・OSユーザーに「ローカル ログオン」のユーザー権利がない状態でのOSユーザーの登録

［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックしなかった場合は，上記個条書きの条件でOSユーザーを登録しようとしても失敗します。

OSユーザーを削除する場合は，該当するOSユーザーがどのJP1ユーザーともマッピングしていない状態にしてから削除してください。ユーザーマッピングの情報は［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブの［マッピングOSユーザー一覧］，またはjbsgetumapコマンドで確認できます。

パスワード管理情報の設定手順を次に示します。

［パスワード管理］の［設定］ボタンをクリックする。

［パスワード管理］ダイアログボックスでOSユーザーおよびそのOSユーザーのパスワード情報を登録，変更，および削除する。

図8‒6　［パスワード管理］ダイアログボックス

OSユーザーとそのOSユーザーのパスワードを登録する場合は［新規登録］ボタン，登録したOSユーザーのパスワードが変更された場合は［パスワード変更］ボタン，登録されたOSユーザーのパスワード情報を削除する場合は［ユーザー削除］ボタンをクリックします。

なお，登録するOSユーザー名には，ユーザー名だけでなく，自ホストが所属するドメイン名やローカルホスト名も記述できます。その場合，「domain¥user1」，「server¥user1」のように，ドメイン名やローカルホスト名とユーザー名の区切り文字として「¥」を使用します。ドメイン名やローカルホスト名を記述した場合，登録するOSユーザーがドメイン上のユーザーまたはローカルユーザーであるかどうかチェックされます。ドメイン上のユーザーまたはローカルユーザーでなかった場合，そのOSユーザー名では登録できません。

ドメイン名やローカルホスト名を記述しなかった場合，登録するOSユーザー名がローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，信頼するドメインを含むドメイン上のユーザーであるかどうかチェックされます。ローカルユーザーまたはドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。

なお，Windowsのドメインコントローラー上で登録する場合は，「ドメイン名¥ユーザー名」の形式で記述してください。ドメインコントローラー上ではドメインユーザーとローカルユーザーの区別がないため，ドメインユーザーとして扱われるためです。

注意事項

［ユーザーマッピング］タブの［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックした場合，OSユーザー名やOSユーザーのパスワードが誤っていても，パスワード管理情報に登録できます。ただし，実際にジョブやリモートコマンドを実行するときに権限エラーとなってしまうので，注意が必要です。

［終了］ボタンをクリックする。

［パスワード管理］ダイアログボックスが閉じ，［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブに戻ります。

(2)　［JP1ユーザー］での設定

［JP1ユーザー］では，OSユーザーとマッピングしたいJP1ユーザー，および操作命令を出すサーバホストを設定します。

［追加］ボタンをクリックする。

［JP1ユーザー］ダイアログボックスで，OSユーザーとマッピングしたいJP1ユーザーとそのJP1ユーザーがジョブやリモートコマンド（自動アクション）などの操作命令を出すサーバホストを設定します。サーバホストに「*」を指定すると，すべてのサーバホストからの操作が有効になります。

図8‒7　［JP1ユーザー］ダイアログボックス

サーバホストが物理ホストの場合

サーバホスト名には，hostnameコマンドで表示されるホスト名を指定してください。ただし，DNS運用でドメイン名を使用している場合は，FQDN形式のホスト名の定義も追加してください。

サーバホストが論理ホストの場合

サーバホスト名には，論理ホスト名を指定してください。ただし，jp1hosts情報またはjp1hosts2情報に論理ホストを定義しないで，DNS運用でドメイン名を使用している場合は，FQDN形式の論理ホスト名の定義も追加してください。

なお，JP1/AJS - Viewからログインする場合，および自ホストに対してJP1/AJSのコマンドを実行する場合，自ホスト名をサーバホスト名として設定する必要があります。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

［OK］ボタンをクリックする。

［JP1ユーザー］ダイアログボックスが閉じ，［マッピングOSユーザー詳細］ダイアログボックスが表示されます。

図8‒8　［マッピングOSユーザー詳細］ダイアログボックス

［マッピングOSユーザー詳細］ダイアログボックスでJP1ユーザーとOSユーザーをマッピングする。

このダイアログボックスで，マッピングするOSユーザーとマッピングしないOSユーザーを設定します。なお，ここに表示されるOSユーザーは，［パスワード管理］ダイアログボックスで登録されたOSユーザーになります。ただし，情報検索用ユーザーをマッピングすることはできません。

また，プライマリーOSユーザーには，ジョブの実行やコマンド実行時などにOSユーザー名を指定しなかった場合に，マッピングしたいOSユーザーを指定します。

［OK］ボタンをクリックする。

JP1ユーザーとOSユーザーのマッピングが完了します。

(3)　［マッピングOSユーザー一覧］での設定

［マッピングOSユーザー一覧］には，マッピングしたOSユーザー名が表示されます。この［マッピングOSユーザー一覧］で，JP1ユーザーがどのOSユーザーとマッピングしているか確認できます。また，JP1ユーザーとOSユーザーのマッピング内容を変更する場合にも使用します。

マッピング内容の変更手順を次に示します。

［JP1ユーザー］の［JP1ユーザー名］からマッピングの内容を変更したいユーザーを選択する。

［マッピングOSユーザー一覧］に，そのユーザーがマッピングしているOSユーザー名が表示されます。

［変更］ボタンをクリックする。

［マッピングOSユーザー詳細］ダイアログボックスで，マッピングする，またはマッピングしないOSユーザーの変更，およびプライマリーOSユーザーを設定する。

図8‒9　ユーザーがマッピングしているOSユーザー名

［OK］ボタンをクリックする。

JP1ユーザーとOSユーザーのマッピングが完了します。

8.1.7　コマンドを使ってユーザーマッピングを設定する

ユーザーマッピングを設定する前に，ユーザーマッピングされるOSユーザーにWindows特有のユーザー権利を与える必要があります。詳細については，「8.1.5　ユーザーマッピングを設定する前にOSユーザーにユーザー権利を与える」を参照してください。

Windowsの場合，ユーザーマッピングを設定する各ホストで，マッピングするOSユーザーとそのOSユーザーのパスワード情報を，JP1/Baseのパスワード管理情報に登録する必要があります。

注意事項

JP1/BaseのGUI，［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブの［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックした場合，次に示す条件であっても，OSユーザーの登録に成功します。

システム（Windows）に登録されていないOSユーザーの登録

パスワードが誤っているOSユーザーの登録

OSユーザーに「ローカル ログオン」のユーザー権利がない状態でのOSユーザーの登録

［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックしなかった場合は，上記条件でコマンドを使ってOSユーザーを登録しようとしても失敗します。

JP1/Baseでは，パスワード管理情報を設定するためのコマンドを提供しています。提供しているコマンドとその用途を次の表に示します。

表8‒2　パスワード管理情報設定用コマンド

コマンド名

用途

参照先

jbspassmgr

［パスワード管理］ダイアログボックスを表示するコマンドです。

（1）

jbsmkpass

定義ファイルを利用して複数のOSユーザーのパスワード管理情報を一括して設定するコマンドです。

（2）

jbsumappass

OSユーザーを個別に追加したり，パスワード管理情報に登録されたOSユーザーのパスワードを個別に変更したりするコマンドです。

（3）

jbsrmumappass

パスワード管理情報に登録されたOSユーザーを個別に削除するコマンドです。

（4）

上記表の四つのコマンドのどれかを利用してJP1/Baseのパスワード管理情報の設定を済ませたら，ユーザーマッピング情報を登録します。

JP1/Baseでは，共通定義情報にユーザーマッピング情報を一括して設定するコマンドや，個別にユーザーマッピング情報を登録，変更，削除するコマンドを提供しています。提供しているコマンドとその用途を次の表に示します。

表8‒3　ユーザーマッピング情報設定用コマンド

コマンド名

用途

参照先

jbsmkumap

定義ファイルを利用して，共通定義情報にユーザーマッピング情報を一括して登録するコマンドです。

（5）

jbssetumap

定義ファイルを利用して，共通定義情報にユーザーマッピング情報を個別に追加したり，共通定義情報に登録されたユーザーマッピング情報を変更したりするコマンドです。

（6）

jbsrmumap

共通定義情報に登録されたユーザーマッピング情報を個別に削除するコマンドです。

（7）

(1)　［パスワード管理］を表示する

jbspassmgrコマンドを実行すると，［パスワード管理］ダイアログボックスが表示されます。このダイアログボックスで各ホストに登録されたOSユーザー，およびそのOSユーザーのパスワード情報を登録・管理します。パスワードは，OSのアカウントと同じものを入力してください。［パスワード管理］ダイアログボックスの操作については，「8.1.6(1)　［パスワード管理］での設定」を参照してください。

jbspassmgrコマンドの詳細については，「15.　コマンド」の「jbspassmgr（Windows限定）」を参照してください。

(2)　OSユーザーのパスワード管理情報を一括して設定する

jbsmkpassコマンドを実行すると，共通定義情報に登録したパスワード情報がいったんすべて削除され，パスワード定義ファイルに記述したパスワード管理情報が共通定義情報に一括して設定されます。jbsmkpassコマンドの詳細については，「15.　コマンド」の「jbsmkpass（Windows限定）」を参照してください。なお，jbsmkpassコマンドを使用する場合，パスワード定義ファイルにパスワード管理情報を設定する必要があります。定義ファイルは，ユーザーが任意の場所に格納できます。格納場所を忘れないようにしてください。パスワード定義ファイルの詳細については，「16.　定義ファイル」の「パスワード定義ファイル（Windows限定）」を参照してください。

(3)　OSユーザーを個別に登録する

jbsumappassコマンドを実行すると，JP1/Baseのパスワード管理情報に新規OSユーザーの個別登録，または登録済みOSユーザーのパスワード変更ができます。

このコマンドは，シェルスクリプトなどから実行することによってOSが管理するパスワード情報を変更するタイミングで，JP1/Baseが管理するパスワード管理情報を更新したい場合に利用できます。

次の形式でコマンドを実行します。

jbsumappass -u OSユーザー名 [-p パスワード]

jbsumappassコマンドの詳細については，「15.　コマンド」の「jbsumappass（Windows限定）」を参照してください。

(4)　OSユーザーを個別に削除する

jbsrmumappassコマンドを実行すると，JP1/Baseのパスワード管理情報に登録されたOSユーザーを個別に削除できます。

このコマンドは，シェルスクリプトなどから実行することによってOSが管理するユーザーを削除するタイミングでJP1/Baseが管理するパスワード管理情報からOSユーザーを削除したい場合に，利用できます。

次の形式でコマンドを実行します。

jbsrmumappass -u OSユーザー名

jbsrmumappassコマンドの詳細については，「15.　コマンド」の「jbsrmumappass（Windows限定）」を参照してください。

(5)　ユーザーマッピング情報を一括して設定する

コマンドを使ってユーザーマッピング情報を一括して設定する場合は，ユーザーマッピング定義ファイル（jp1BsUmap.conf）で設定します。ユーザーマッピング定義ファイルの詳細については，「16.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。

ユーザーマッピング定義ファイル（jp1BsUmap.conf）をエディターで編集したあと，jbsmkumapコマンドを実行すると，共通定義情報に登録されていたマッピング情報がいったんすべて削除され，ユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報が共通定義情報に登録されます。なお，設定されたマッピング情報を確認する場合は，jbsgetumapコマンドを実行します。

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

注意事項

ユーザーマッピング定義ファイル（jp1BsUmap.conf）は，GUIでも利用しています。GUIで設定した内容は，このファイルに反映されます。また，このファイルを編集後，jbsmkumapコマンドを実行すれば，設定した内容がGUIに反映されます。

(6)　ユーザーマッピング情報を個別に登録する

jbssetumapコマンドを実行すると，ユーザーマッピング情報を個別に追加したり変更したりできます。ユーザーマッピング情報を個別に追加または変更するには，jbssetumapコマンドのオプションにユーザーマッピング情報を直接指定して登録する方法と，ユーザーマッピング情報を記述した定義ファイルを使用して登録する方法があります。

ユーザーマッピング情報を指定して共通定義情報に登録する場合は，次のコマンドを実行してください。

jbssetumap {-u JP1ユーザー名| -ua}
           {-sh サーバホスト名| -sha}
            -o OSユーザー名[,OSユーザー名]
           [-no]

定義ファイルを作成して登録する場合は，次のコマンドを実行してください。

jbssetumap -f 定義ファイル名

定義ファイルは任意の場所に格納できますが，ファイルの形式はユーザーマッピング定義ファイル（jp1BsUmap.conf）と同じにしてください。ユーザーマッピング定義ファイルの形式については，「16.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。jbssetumapコマンドの詳細については，「15.　コマンド」の「jbssetumap」を参照してください。

(7)　ユーザーマッピング情報を個別に削除する

共通定義情報からユーザーマッピング情報を個別に削除する場合，jbsrmumapコマンドを実行してください。

次の形式でコマンドを実行します。

jbsrmumap -u JP1ユーザー名

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

8.1.8　ユーザー管理に関する注意事項

JP1/BaseのGUI，［JP1/Base環境設定］ダイアログボックスで，認証サーバの設定やJP1ユーザーの登録をする際に，JP1/Baseのサービスを起動および停止することがありますが，次のような場合には，JP1/Baseのサービスの起動や停止に失敗することがあります。

Windowsの［サービス］ダイアログボックスで［スタートアップ］が「自動」になっているすべてのサービスが起動を完了していない場合

JP1/Base，JP1/IM，またはJP1/AJSのサービスが起動処理中，または停止処理中の場合

JP1/Base，JP1/IM，またはJP1/AJSのサービスが起動，または停止できない状態の場合

JP1/Baseのサービスの起動や停止に失敗した場合，［JP1/Base環境設定］ダイアログボックスを一度閉じ，エラーダイアログボックスに表示されたサービスが［コントロールパネル］の［サービス］ダイアログボックスから起動および停止できることを確認してください。サービスを起動および停止できる場合は，再度［JP1/Base環境設定］ダイアログボックスを表示し，設定してください。サービスを起動および停止できなかった場合は，該当するサービスの資料を，資料採取ツールを使って採取し，システム管理者に連絡してください。

ユーザーマッピングの設定をしたあと，OSが管理するパスワード情報を変更した場合，JP1/Baseのユーザーマッピングで設定したOSユーザーのパスワード管理情報も，合わせて変更する必要があります。変更しなかった場合，JP1/AJSのジョブ実行やJP1/IM - Managerのリモートコマンド（自動アクション）実行が失敗するおそれがあります。

なお，JP1/Baseのパスワード管理情報を変更したい場合は，［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブで設定するか，またはjbsumappassコマンドやjbsrmumappassコマンドを使用して設定してください。

クラスタシステムでユーザー管理の設定をする場合は，まず，「5.　クラスタシステムで運用する場合の設定」を参照してクラスタ運用の環境設定をしてください。そのあと，次に示す手順を実行してください。

Windowsのスタートメニューから［プログラム］−［JP1_Base］−［JP1_Base Setup］を選択する。

［論理ホスト名の選択］ダイアログボックスでユーザー管理の設定をしたい論理ホストを選択する。

「8.1　ユーザー管理の設定（Windowsの場合）」を参照してユーザー管理の設定をする。

認証サーバをクラスタシステムで運用する場合，認証サーバの設定ファイルは次のフォルダに格納されています。

共有フォルダ名¥jp1base¥conf¥user_acl¥

セカンダリー認証サーバを設置する場合は，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバへコピーする必要があります。その際，セカンダリー認証サーバをクラスタ運用するかしないかで，設定ファイルのコピー先が異なってくるので注意が必要です。

クラスタ運用する場合のコピー先

共有フォルダ名¥jp1base¥conf¥user_acl¥

クラスタ運用しない場合のコピー先

インストール先フォルダ¥conf¥user_acl¥

設定ファイルをコピーしたあとに，次のコマンドを実行して設定を反映させてください。セカンダリー認証サーバをクラスタ運用しない場合は，-hオプションの指定は不要です。

jbs_spmd_reload -h 論理ホスト名

8.2　ディレクトリサーバと連携してユーザー認証する場合の設定（Windows限定）

ディレクトリサーバと連携したユーザー認証には，DSユーザーを使用する方法と連携ユーザーを使用する方法があります。JP1認証情報（JP1ユーザー認証情報およびJP1操作権限）をディレクトリサーバで管理する場合は，DSユーザーを使用します。JP1ユーザー認証情報だけをディレクトリサーバで管理する場合は，連携ユーザーを使用します。

ディレクトリサーバと連携してユーザー認証する場合，JP1管理者，ディレクトリサーバ管理者それぞれで設定作業が発生します。DSユーザーを使用する場合と連携ユーザーを使用する場合のそれぞれで発生する設定作業を次に示します。

表8‒4　JP1管理者とディレクトリサーバ管理者の設定作業

JP1ユーザー種別

JP1管理者の設定作業

ディレクトリサーバ管理者の設定作業

連携ユーザー

認証サーバでのディレクトリサーバ連携用の設定

ディレクトリサーバの指定

JP1ユーザー（連携ユーザー）の設定

ディレクトリサーバへのJP1ユーザー（連携ユーザー）の登録

DSユーザー

認証サーバでのディレクトリサーバ連携用の設定

ディレクトリサーバの指定

操作権限の設定（JP1/Baseで設定する場合）

Active Directoryでの事前設定

操作権限設定のためのスキーマの拡張

グループの作成と設定

操作権限の設定（Active Directoryで設定する場合）

ディレクトリサーバと連携してユーザー認証する場合の，各ホストで必要な設定の流れとマニュアルの参照先を次の図に示します。

図8‒10　ユーザー管理の設定の流れ（連携ユーザーを使用する運用の場合）

図8‒11　ユーザー管理の設定の流れ（DSユーザーを使用する運用の場合）

次の項以降では，ディレクトリサーバと連携してユーザー認証する場合だけに発生する設定について説明します。そのほかの設定については，図8-10または図8-11で示す参照先を確認してください。設定内容は認証サーバだけで運用する場合と同じです。

ディレクトリサーバと連携する場合の注意事項

ディレクトリサーバ連携機能を有効にしている場合でも，標準ユーザーは認証サーバでログインできます。

SSLを使用する場合，次に示すことを確認してください。

ディレクトリサーバ側

証明書サービスがインストールされているかどうか。

認証サーバ側

ディレクトリサーバでエクスポートした証明書がインストールされているかどうか。

連携するディレクトリサーバの名前解決は，jp1hosts情報およびjp1hosts2情報ではできません。そのため，連携するディレクトリサーバは，OSのhostsファイルなどで名前解決できるように設定してください。

8.2.1　連携ユーザーを使用する運用の場合の設定

連携ユーザーを使用する運用の場合，ディレクトリサーバ連携の設定のあとにJP1ユーザーの設定を実施します。

(1)　連携するディレクトリサーバを指定する

ディレクトリサーバと連携してユーザー認証するためには，認証サーバで共通定義情報を設定する必要があります。ディレクトリサーバ連携機能は初期設定で共通定義に設定されていないため，設定の変更が必要です。セカンダリー認証サーバを設置している場合は，プライマリー認証サーバおよびセカンダリー認証サーバの両方に設定してください。

10-10以降のJP1/Baseの場合，ディレクトリサーバと連携すると，次に示す拡張機能を使用できます。

指定したOU（組織単位）配下の階層の，すべてのOUをディレクトリサーバ連携の対象にできる。

JP1ユーザー名として使用する属性名にCN以外も指定できる。

JP1ユーザー名として使用する属性名をCN，sAMAccountName，およびUserPrincipalNameから指定できます。

これらの拡張機能を使用する場合は，ディレクトリサーバ連携の対象ユーザーをディレクトリサーバ内で検索するための情報検索用ユーザーの設定が必要です。詳細は，「(b)　ディレクトリサーバ連携の設定手順（ディレクトリサーバ連携拡張機能を使用する場合）」を参照してください。

(a)　ディレクトリサーバ連携の設定手順（ディレクトリサーバ連携拡張機能を使用しない場合）

ディレクトリサーバ管理者がディレクトリサーバを設定する際は，一つのコンテナオブジェクトにJP1ユーザーを登録してください。なお，ディレクトリサーバと連携するユーザーは，CN（共通名）属性の値をJP1ユーザー名と同じにする必要があります。

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）を編集する。

ディレクトリサーバ連携定義ファイルの詳細については，「16.　定義ファイル」の「ディレクトリサーバ連携定義ファイル（Windows限定）」を参照してください。

jbssetcnfコマンドを実行する。

設定内容が共通定義情報に反映されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

jbschkdsコマンドを実行する。

ディレクトリサーバ連携の設定を確認します。jbschkdsコマンドの詳細については，「15.　コマンド」の「jbschkds（Windows限定）」を参照してください。

(b)　ディレクトリサーバ連携の設定手順（ディレクトリサーバ連携拡張機能を使用する場合）

ディレクトリサーバ管理者がディレクトリサーバを設定する際は，ディレクトリサーバ連携定義ファイルのBASE_DNパラメーターで指定したコンテナオブジェクト配下に，JP1ユーザーを登録してください。なお，ディレクトリサーバと連携するユーザーは，ディレクトリサーバ連携定義ファイルのATTR_NAMEパラメーターで指定した属性の値をJP1ユーザー名と同じにする必要があります。

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）を編集する。

ディレクトリサーバ連携拡張機能を使用しない場合との編集内容の相違点を次に示します。

BASE_DN

JP1ユーザーが存在するコンテナオブジェクトの識別名を指定します。このパラメーターで指定したコンテナオブジェクト配下のJP1ユーザーと連携できるようになります。

SEARCH_USER_DN

ディレクトリサーバにアクセスする情報検索用ユーザーの識別名を指定します。情報検索用ユーザーは，検索起点となるコンテナオブジェクトおよびその配下のコンテナオブジェクトに対して，参照権限があるディレクトリサーバのユーザーになります。

ATTR_NAME

JP1ユーザー名として使用する属性名をCN，sAMAccountName，およびUserPrincipalNameから指定します。

ディレクトリサーバ連携定義ファイルの詳細については，「16.　定義ファイル」の「ディレクトリサーバ連携定義ファイル（Windows限定）」を参照してください。

jbssetcnfコマンドを実行する。

設定内容が共通定義情報に反映されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

情報検索用ユーザーとパスワードを認証サーバホストに登録する。

情報検索用ユーザーとディレクトリサーバにログインするときに使用するパスワードを，認証サーバホストのJP1/Baseのパスワード管理情報に登録します。情報検索用ユーザーのパスワードのバイト数は，1〜64バイトです。登録には，jbsmkpassコマンド，jbspassmgrコマンド，またはjbsumappassコマンドを使用します。なお，登録するユーザー（情報検索用ユーザー）の指定形式は，「aduser/情報検索用ユーザー名」で指定します。例えば，SEARCH_USER_DNに"CN=Groupcsearcher,OU=GroupC,DC=domain,DC=local"を指定した場合，「aduser/Groupcsearcher」と指定します。

各コマンドの詳細については，「15.　コマンド」の「jbsmkpass（Windows限定）」，「jbspassmgr（Windows限定）」，または「jbsumappass（Windows限定）」を参照してください。

jbschkdsコマンドを実行する。

ディレクトリサーバ連携の設定を確認します。jbschkdsコマンドの詳細については，「15.　コマンド」の「jbschkds（Windows限定）」を参照してください。

重要

ディレクトリサーバ連携拡張機能を使用している場合，OSが管理するパスワード情報を変更したときは，JP1/Baseで設定した情報検索用ユーザーのパスワード管理情報も変更する必要があります。

なお，JP1/Baseのパスワード管理情報を変更したい場合は，［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブで設定するか，またはjbsumappassコマンドやjbsrmumappassコマンドを使用して設定してください。

(c)　連携するディレクトリサーバを変更する

設定したディレクトリサーバが障害などで使用できなくなった場合，連携するディレクトリサーバを一時的に変更できます。一時的に変更するための情報を定義した定義ファイル作成してjbschgdsコマンドを実行してください。また，一時的な変更の解除も，jbschgdsコマンドを使用します。

jbschgdsコマンドの詳細については，「15.　コマンド」の「jbschgds（Windows限定）」を参照してください。

(2)　JP1ユーザー（連携ユーザー）を設定する

連携ユーザーを使用する場合のJP1ユーザー（連携ユーザー）の設定について説明します。JP1ユーザーの設定とは，JP1/IMやJP1/AJSなどを使用するJP1ユーザーの登録および削除をGUIまたはコマンドで実施することを示します。ここで登録したJP1ユーザーは，JP1/IM - ViewやJP1/AJS - Viewなどからのログイン時に使用します。特に断り書きがない場合，この項では「JP1ユーザー」とは「JP1ユーザー（連携ユーザー）」を示します。

JP1ユーザーは，プライマリー認証サーバおよびセカンダリー認証サーバの両方に設定してください。08-10以前のJP1/Baseは連携ユーザーを設定できません。JP1ユーザーは08-11以降のJP1/Baseで設定してください。

JP1ユーザーを設定する場合，「JP1/Base」サービスが起動している必要があります。「JP1/Base」サービスが起動していないとき，JP1ユーザーを設定する前に「JP1/Base」のサービスを起動してください。

JP1ユーザーの設定手順を，GUIを使う場合とコマンドを使う場合に分けて，次に示します。

(a)　GUIを使ってJP1ユーザーを設定する

JP1ユーザーの設定は，［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブの［JP1ユーザー］で行います。

［JP1ユーザー］で設定する場合，［JP1ユーザー］を活性化する必要があります。［認証サーバの検索順序］の［認証サーバ名］で認証サーバを選び（反転表示させて），［JP1ユーザー］を活性化してください。なお，次に示す場合には，［JP1ユーザー］は活性化しないため，注意が必要です。

［認証サーバの検索順序］で認証サーバを変更し，［適用］ボタンが活性化していた場合

選んだ（反転表示させた）認証サーバの状態が「閉塞中」の場合

［適用］ボタンが活性化していた場合は，［適用］ボタンをクリックしてください。「閉塞中」だった場合は，「8.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）」を参照して，閉塞状態を解除してください。

［追加］ボタンをクリックすると，［JP1ユーザー］ダイアログボックスが表示されます。

図8‒12　［JP1ユーザー］ダイアログボックス

このダイアログボックスでJP1ユーザーを設定します。登録するJP1ユーザー名を入力し，［ディレクトリサーバに連携する］をチェックしてください。パスワードの入力は必要ありません。なお，登録するJP1ユーザー名は標準ユーザーと重複しないようにしてください。JP1ユーザー名に使用できるのは，小文字だけです。大文字で入力した場合でも小文字のJP1ユーザー名として登録します。

JP1ユーザー名に指定できる文字の制限を次の表に示します。

表8‒5　JP1ユーザー名の文字制限

対象

バイト数

使用禁止文字

JP1ユーザー名

1〜31バイト

* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < > およびスペース，タブ

［OK］ボタンまたは［キャンセル］ボタンをクリックすると，［認証サーバ］タブに戻ります。

登録されたJP1ユーザーは［ユーザー名］に表示されます。連携ユーザーの場合，［連携］に「DS」と表示されます。

また，［ユーザー名］に表示されたJP1ユーザーを選択し，［削除］ボタンをクリックすると，選択したJP1ユーザーが削除されます。

(b)　コマンドを使ってJP1ユーザーを設定する

コマンドを使って，JP1ユーザーの登録および削除ができます。また，登録したJP1ユーザーを一覧表示するコマンドも提供しています。各コマンドの詳細については，「15.　コマンド」を参照してください。

JP1ユーザーの登録

JP1ユーザーを認証サーバに登録する場合，次に示すコマンドを実行します。

jbsadduser -ds JP1ユーザー名

JP1ユーザー名には，小文字だけを使用してください。JP1ユーザー名に指定できる文字の制限については，表8-5を参照してください。

JP1ユーザーのパスワードの変更

連携ユーザーのパスワードはJP1/Baseで変更できません。ディレクトリサーバで変更してください。

JP1ユーザーの削除

登録したJP1ユーザーを削除する場合は，次に示すコマンドを実行します。

jbsrmuser JP1ユーザー名

登録したJP1ユーザーの一覧表示

登録したJP1ユーザー（標準ユーザーおよび連携ユーザー）の情報を確認する場合は，次に示すコマンドを実行します。

jbslistuser

登録した連携ユーザーだけの情報を確認する場合は，次に示すコマンドを実行します。

jbslistuser -ds

(c)　連携ユーザーのパスワードについて

連携ユーザーのパスワードはディレクトリサーバで管理しますが，パスワードに指定できる文字の制限は標準ユーザーと同じです。大文字と小文字を区別して指定してください。パスワードの文字制限を次に示します。

バイト数：6〜32バイト

使用禁止文字：¥ " : およびスペース，タブ

ディレクトリサーバに登録したパスワードのバイト数が制限値から外れていた場合，または使用禁止文字があった場合，ユーザー認証に失敗します。

(3)　ディレクトリサーバ連携拡張機能を使用する運用への切り替え方法

ディレクトリサーバ連携拡張機能を使用しない運用から使用する運用に変更する手順を説明します。

ここでは，次に示すようなディレクトリサーバ構造に基づいて説明します。なお，プライマリー認証サーバおよびセカンダリー認証サーバを設置している運用とします。

変更前のディレクトリサーバ連携の設定内容

変更前のディレクトリサーバ連携の設定内容の抜粋を次に示します。

[JP1_DEFAULT¥JP1BASE¥DIRSRV]
"SERVER"="host-A.domain.local"
"BASE_DN"="OU=eigyo,OU=osaka,DC=domain,DC=local"
"ATTR_NAME"="CN"

変更内容

大阪支社の営業部だけとディレクトリサーバ連携していたのを，大阪支社の資材部とも連携する運用にする。

JP1ユーザー名として使用する属性名を，CNからsAMAccountNameに変更する。

手順を次に示します。

ディレクトリサーバ連携の設定内容を変更する。

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）の，次に示すパラメーターを追加・変更します。

表8‒6　ディレクトリサーバ連携定義ファイルの定義内容

パラメーター

変更前

変更後

SEARCH_USER_DN

設定なし

"CN=Osakaleader,OU=osaka,DC=domain,DC=local"

BASE_DN

"OU=eigyo,OU=osaka,DC=domain,DC=local"

"OU=osaka,DC=domain,DC=local"

ATTR_NAME

"CN"

"sAMAccountName"

ここでは，検索起点となるコンテナオブジェクト（OU=osaka）の参照権限を持つディレクトリサーバのユーザー名（Osakaleader）を情報検索用ユーザーとします。

なお，ディレクトリサーバ連携の設定変更は，プライマリー認証サーバホストおよびセカンダリー認証サーバホストで実施します。

jbssetcnfコマンドを実行する。

設定内容が共通定義情報に反映されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

情報検索用ユーザーとパスワードを認証サーバホストに登録する。

情報検索用ユーザーとディレクトリサーバにログインするときに使用するパスワードを，認証サーバホストのJP1/Baseのパスワード管理情報に登録します。登録には，jbsmkpassコマンド，jbspassmgrコマンド，またはjbsumappassコマンドを使用します。

登録する情報検索用ユーザーの指定形式は，「aduser/情報検索用ユーザー名」です。ここでは，ユーザー名「aduser/Osakaleader」とOsakaleaderのパスワードを登録します。

各コマンドの詳細については，「15.　コマンド」の「jbsmkpass（Windows限定）」，「jbspassmgr（Windows限定）」，または「jbsumappass（Windows限定）」を参照してください。

JP1ユーザーを追加する。

変更後は大阪支社の資材部もディレクトリサーバ連携の対象となるため，新たにディレクトリサーバと連携するJP1ユーザーを登録します。詳細は「8.2.1(2)　JP1ユーザー（連携ユーザー）を設定する」を参照してください。

ここでは，JP1ユーザー名をディレクトリサーバと連携するユーザーのsAMAccountNameと同名で登録します。したがって，営業部でディレクトリサーバと連携していたユーザーでも，CNとsAMAccountNameが異なる場合は，JP1ユーザーの追加登録が必要になります。登録後，それまでディレクトリサーバと連携していたJP1ユーザーは不用となるため削除します。

プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーする。

プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーします。詳細は「8.1.4　プライマリー認証サーバの設定情報をコピーする」を参照してください。

ログインを確認する。

プライマリー認証サーバホストおよびセカンダリー認証サーバホストで，jbschkdsコマンドを実行してディレクトリサーバ連携の設定内容と，ディレクトリサーバと連携するユーザーがユーザー認証できるかどうかを確認します。また，プライマリー認証サーバおよびセカンダリー認証サーバにログインできるかどうかを確認します。

jbschkdsコマンドの詳細については，「15.　コマンド」の「jbschkds（Windows限定）」を参照してください。

8.2.2　DSユーザーを使用する運用の場合の設定

DSユーザーを使用する運用の場合，Active Directoryでの事前準備のあとにディレクトリサーバ連携の設定をします。

(1)　Active Directoryでの事前準備

Active Directoryでの事前準備として，Active Directoryのスキーマ拡張を実施します。

JP1認証情報（JP1ユーザー認証情報およびJP1操作権限）をActive Directoryで一元管理するために，Active DirectoryにJP1操作権限を設定できる属性を追加します。次に示すスキーマ拡張の設定手順に従って，Active Directoryでユーザーやグループオブジェクトに属性（JP1操作権限）を追加します。

追加された属性（JP1操作権限）の属性値には，JP1資源グループとJP1権限レベルを設定します。

ここでは，LDIFファイルを利用したスキーマ拡張の設定手順を説明します。なお，次に示すスキーマ拡張の設定手順が失敗した場合に備えて，システム状態を元に戻すためにシステム状態のバックアップ（NTBACKUP）をしてください。

認証サーバからモデルファイル（JP1_UserLevel_schema.ldf.model）を任意のLDIFファイル名でコピーする。

認証サーバのモデルファイルの格納先ディレクトリを次に示します。

インストール先フォルダ¥tools¥schema¥JP1_UserLevel_schema.ldf.model

コピーしたLDIFファイルを編集する。

コピーしたファイル中の「dn：」に続くドメイン名の識別名（DC）を該当するドメイン名に変更します。

ファイル内容はエントリー数が[1]から[8]まであり，変更対象は[1]，[3]，[5]，および[7]の４個所になります。

編集例：ドメイン名がdomain.localの場合

変更前：

dn: CN=hitachiJP1UserLevel,CN=Schema,CN=Configuration,DC=DomainName

変更後：

dn: CN=hitachiJP1UserLevel,CN=Schema,CN=Configuration,DC=domain,DC=local

ldifdeコマンドを実行して，手順2で編集したLDIFファイルをインポートすることでスキーマを拡張する。

ldifde -i -f 入力ファイル名 -v -j ログファイル出力フォルダ名

ログファイルには，ldifdeコマンドの実行ログが出力されるためインポート情報を確認できます。

ldifdeコマンドが実行時エラーになった場合，次のことを確認して対処してください。

実行時エラーに「0000202B: RefErr」が出力されている場合

ドメイン名が誤っているため，ドメイン名の照会エラー（RefErr）になると考えられます。ドメイン名が正しいか確認してください。誤っている場合は，LDIFファイルでエラーとなったドメイン名を修正してください。また，エラーとなったエントリー以降だけを実行対象とするために，前のエントリー分まではコメントアウト（先頭カラムに「#」）に変更してからldifdeコマンドを再実行してください。例えば，エントリー[3]でこのエラーが発生した場合，エントリー[2]までのすべての行をコメントアウトにします。エントリー[1]でエラーの場合は，コメントアウトの変更は不要です。

実行時エラーに「00002071: UpdErr」が出力されている場合

スキーマが拡張済みで，すでにオブジェクトが存在するため更新エラー（UpdErr）になると考えられます。手順4に示す方法で，スキーマが拡張済みであるか確認してください。スキーマが拡張済みの場合，手順3（スキーマの拡張）は不要です。

そのほかの実行時エラーの場合

上記以外のケースについては，ldifdeコマンドのエラー内容に応じて対処してください。

ldifdeコマンドを実行して，スキーマ拡張によってJP1操作権限の属性が追加されたことを確認する。

既定クラス（User）の確認：

ldifdeコマンドを実行して，既定クラス（User）をLDIFファイルにエクスポートします。手順2と同様にドメイン名の識別子（DC）には，該当するドメイン名を指定します。

ldifde -f 出力ファイル名 -d CN=User,CN=Schema,CN=Configuration,DC=domain,DC=local

エクスポートしたLDIFファイルに，JP1操作権限クラス（hitachiJP1AccessLevel）が補助型クラス（auxiliaryClass）として設定されていることを確認します。

：
auxiliaryClass: hitachiJP1AccessLevel
：

既定クラス（Group）の確認：

ldifdeコマンドを実行して，既定クラス（Group）をLDIFファイルにエクスポートします。手順2と同様にドメイン名の識別子（DC）には，該当するドメイン名を指定します。

ldifde -f 出力ファイル名 -d CN=Group,CN=Schema,CN=Configuration,DC=domain,DC=local

エクスポートしたLDIFファイルに，JP1操作権限クラス（hitachiJP1AccessLevel）が補助型クラス（auxiliaryClass）として設定されていることを確認します。

：
auxiliaryClass: hitachiJP1AccessLevel
：

(2)　連携するディレクトリサーバを指定する

ディレクトリサーバと連携してユーザー認証するためには，認証サーバで共通定義情報を設定する必要があります。ディレクトリサーバ連携機能は初期設定で共通定義に設定されていないため，設定の変更が必要です。セカンダリー認証サーバを設置している場合は，プライマリー認証サーバおよびセカンダリー認証サーバの両方に設定してください。

(a)　ディレクトリサーバ連携の設定手順

DSユーザーを使用する場合，ディレクトリサーバ連携定義ファイルの設定と情報検索用ユーザーの登録が必要です。また，セットアップ後はディレクトリサーバとの接続をjbschkdsコマンドで確認してください。

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）を編集する。

連携ユーザーを使用する運用の場合との編集内容の相違点を次に示します。

ENABLE

ディレクトリサーバと連携するかどうかを指定します。DSユーザーを使用する運用の場合は，00000002を指定します。標準ユーザーとDSユーザーが使用できます。

BASE_DN

JP1ユーザーが存在するコンテナオブジェクトの識別名を指定するパラメーターですが，DSユーザーを使用する運用の場合は設定不要です。

SEARCH_USER_DN

ディレクトリサーバにアクセスする情報検索用ユーザーの識別名を指定します。DSユーザーを使用する運用の場合は，このパラメーターを必ず定義してください。

ディレクトリサーバ連携定義ファイルの詳細については，「16.　定義ファイル」の「ディレクトリサーバ連携定義ファイル（Windows限定）」を参照してください。

jbssetcnfコマンドを実行する。

設定内容が共通定義情報に反映されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

情報検索用ユーザーとパスワードを認証サーバホストに登録する。

情報検索用ユーザーとディレクトリサーバにログインするときに使用するパスワードを，認証サーバホストのJP1/Baseのパスワード管理情報に登録します。情報検索用ユーザーのパスワードのバイト数は，1〜64バイトです。登録には，jbsmkpassコマンド，jbspassmgrコマンド，またはjbsumappassコマンドを使用します。なお，登録するユーザー（情報検索用ユーザー）の指定形式は，「aduser/情報検索用ユーザー名」で指定します。例えば，SEARCH_USER_DNに"CN=Groupcsearcher,OU=GroupC,DC=domain,DC=local"を指定した場合，「aduser/Groupcsearcher」と指定します。

DSユーザーを使用する運用の場合は，情報検索用ユーザーはJP1認証情報の収集やJP1操作権限属性の操作ができる権限が必要なため，次の権限があるユーザーを登録する必要があります。

ユーザーまたはグループのJP1操作権限へ書き込み権限があるユーザー

各コマンドの詳細については，「15.　コマンド」の「jbsmkpass（Windows限定）」，「jbspassmgr（Windows限定）」，または「jbsumappass（Windows限定）」を参照してください。

jbschkdsコマンドを実行する。

ディレクトリサーバ連携の設定を確認します。jbschkdsコマンドの詳細については，「15.　コマンド」の「jbschkds（Windows限定）」を参照してください。

(b)　連携するディレクトリサーバを変更する

設定したディレクトリサーバが障害などで使用できなくなった場合，連携するディレクトリサーバを一時的に変更できます。一時的に変更するための情報を定義した定義ファイル作成してjbschgdsコマンドを実行してください。また，一時的な変更の解除も，jbschgdsコマンドを使用します。

jbschgdsコマンドの詳細については，「15.　コマンド」の「jbschgds（Windows限定）」を参照してください。

(3)　DSユーザーを使用する場合のユーザー管理（操作権限の設定）

DSユーザーを使用する場合のユーザー管理（操作権限の設定）の手順を次に示します。

ディレクトリサーバ（Active Directory）でユーザー（DSユーザー）またはセキュリティグループを作成する。

［Active Directory ユーザーとコンピュータ］管理ツールやPowerShellのActive Directoryコマンドレッドを使用して，操作権限を設定するJP1ユーザー（DSユーザー）またはセキュリティグループを作成します。

操作権限を設定する。

手順1で作成したJP1ユーザー（DSユーザー）またはセキュリティグループに操作権限を設定します。JP1操作権限の付与は，次のどちらかの方法で実施してください。

Active Directoryを使用して操作権限を設定する。

ディレクトリサーバ（Active Directory）で，［Active Directory ユーザーとコンピュータ］管理ツールの属性エディター※やPowerShellのActive Directoryコマンドレッドを使用して，JP1ユーザー（DSユーザー）またはセキュリティグループの属性「hitachiJP1UserLevel」に操作権限を設定します。

設定フォーマットは次のとおりです。

JP1資源グループ=JP1権限レベル:JP1資源グループ=JP1権限レベル:・・・

記述内容については，「16.　定義ファイル」の「ユーザー権限定義ファイル」を参照してください。

注※　［Active Directory ユーザーとコンピュータ］管理ツールで，［表示］−［拡張機能］をチェックして属性エディターを使用可能にしてください。

JP1/Baseのコマンドを使用して操作権限を設定する。

認証サーバ（プライマリー認証サーバ）で，JP1/Baseのjbssetaclコマンド（-dsオプションを指定）またはjbsrmaclコマンド（-dsオプションを指定）を使用して，JP1ユーザー（DSユーザー）またはセキュリティグループに操作権限を設定します。

操作権限の設定手順は「8.1.3(3)　コマンドを使ってJP1ユーザーの操作権限を個別に登録する」および「8.1.3(4)　コマンドを使ってJP1ユーザーの操作権限を個別に削除する」を参照してください。

ディレクトリサーバ（Active Directory）でセキュリティグループを割り当てる。

セキュリティグループにJP1操作権限を付与する場合，［Active Directory ユーザーとコンピュータ］管理ツールやPowerShellのActive Directoryコマンドレッドを使用して，JP1操作権限を付与したセキュリティグループのメンバーにJP1ユーザー（DSユーザー）を設定，またはJP1ユーザー（DSユーザー）の所属するグループにJP1操作権限を付与したセキュリティグループを設定します。

認証サーバ（プライマリー認証サーバ）でJP1操作権限を反映する。

JP1/Baseの再起動またはjbsaclreloadコマンド（-dsオプションを指定）を使用して，手順2で設定した操作権限を認証サーバに反映させます。

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

セカンダリー認証サーバを設置する場合，セカンダリー認証サーバでも同様に操作権限を反映してください。

(4)　DSユーザーを使用する運用への切り替え方法

標準ユーザーまたは連携ユーザーを使用する運用から，DSユーザーを使用する運用へ移行する場合の手順を次に示します。

ディレクトリサーバでActive Directoryの環境を設定する。

Active DirectoryにJP1操作権限属性のスキーマを拡張します。この手順はActive Directoryに対して1回だけ実行します。詳細は，「8.2.2(1)　Active Directoryでの事前準備」を参照してください。

認証サーバ（プライマリー認証サーバ）でJP1/Baseを停止する。

DSユーザーを使用する設定するため，JP1/Baseを停止します。

認証サーバ（プライマリー認証サーバ）でJP1/Baseの環境を設定する。

ディレクトリサーバ連携定義ファイルを変更し，DSユーザーを使用する設定にします。詳細は，「8.2.2(2)(a)　ディレクトリサーバ連携の設定手順」を参照してください。

認証サーバ（プライマリー認証サーバ）でJP1/Baseを起動する。

認証コマンドを使用してActive DirectoryにJP1操作権限の設定をするため，JP1/Baseを起動します。

認証サーバ（プライマリー認証サーバ）でJP1操作権限を設定します。

JP1操作権限をActive Directoryに設定します。

標準ユーザーを使用する運用から移行する場合

1.　認証サーバホストのJP1_UserLevelファイルを任意ファイルにコピーする。

2.　定義ファイルの標準ユーザーをDSユーザー名に書き換える。

3.　定義ファイルを指定してjbssetaclコマンド（-dsオプションを指定）を実行する。

4.　ユーザーマッピングに標準ユーザーを使用している場合，パスワードを含めて再登録する。

5.　認証サーバホストに登録していた移行前の標準ユーザーと操作権限を削除する。

標準ユーザーはjbsrmuserコマンドで削除します。操作権限はjbsrmaclコマンドで削除します。

連携ユーザーを使用する運用から移行する場合

1.　認証サーバホストのJP1_UserLevelファイルを任意のファイル名でコピーする。

2.　手順1の定義ファイルを指定してjbssetaclコマンド（-dsオプションを指定）を実行する。

3.　認証サーバホストに登録していた移行前の連携ユーザーと操作権限を削除する。

連携ユーザーはjbsrmuserコマンドで削除します。操作権限はjbsrmaclコマンドで削除します。

認証サーバ（プライマリー認証サーバおよびセカンダリ認証サーバ）でjbsaclreloadコマンドを実行する。

設定した操作権限でJP1認証情報を再読み込みするため，jbsaclreloadコマンド（-dsオプションを指定）を実行します。

認証サーバ（プライマリー認証サーバ）でJP1認証情報が正しいか確認する。

jbslistuserコマンドやjbslistaclコマンドでJP1認証情報を確認します。

(5)　DSユーザーを使用する運用の場合の注意事項

DSユーザーおよびDSグループは，次に示す条件を満たしている必要があります。

Active Directoryでユーザー名またはグループ名が一意である。

ディレクトリサーバ連携定義ファイルのATTR_NAMEパラメーターで指定された属性で一意である必要があります。

次の表に示す文字制限を満たしている。

表8‒7　DSユーザーおよびDSグループの文字制限

対象

バイト数

使用禁止文字

DSユーザー名※

1〜31バイト

* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < >

スペース，タブ，非ASCII文字

DSグループ名

1〜256バイト

* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < >

タブ，非ASCII文字

注※　DSユーザー名の文字制限は，JP1ユーザー名と同じです。

標準ユーザーとDSユーザーを併用した環境で，標準ユーザーと同名のDSユーザーが現れた場合は，標準ユーザーが優先されます。

ディレクトリサーバのパスワード制限に加えて，JP1製品で使用するための次の制限があります。

パスワード：バイト数：6〜32バイト，文字種の制限：なし

8.3　ユーザー管理の設定（UNIXの場合）

JP1/Baseのインストール時に自動セットアップ処理を実行した場合は，初期設定値が設定されています。自動セットアップ処理の初期設定値については，「3.3.1　インストール」を参照してください。

設定方法は，認証サーバとして使用するホストと認証サーバとして使用しないホストで異なります。

また，セカンダリー認証サーバを設置する場合，プライマリー認証サーバとセカンダリー認証サーバで設定する情報を同じにする必要があります。各ホストで必要な設定の流れとマニュアルの参照先を次の図に示します。

図8‒13　ユーザー管理の設定の流れ（UNIXの場合）

8.3.1　使用する認証サーバを指定する

認証サーバにするJP1/Baseがインストールされているホストを指定します。認証サーバは，次に示すホスト上で指定する必要があります。

認証サーバ（プライマリー認証サーバおよびセカンダリー認証サーバ）

JP1/IM - ManagerやJP1/AJS - Managerなど，JP1/Baseのユーザー認証を利用する製品がインストールされたホスト

認証サーバに指定したホストが，JP1ユーザーや，JP1資源グループに対する操作権限を管理します。JP1/IMやJP1/AJSなど，JP1/Baseのユーザー認証を利用する製品が混在するシステムで，ユーザー認証圏を一つだけにしたい場合は，各ホストで同じ認証サーバを指定します。

なお，認証サーバホストで通信暗号化機能（SSL通信）を有効にした場合，その認証サーバに接続するホストもSSL通信を有効にする必要があります。SSL通信を使用しないホストからユーザー認証をする必要がある場合は，SSL通信をしない認証サーバを設置してユーザー認証圏を分けてください。また，SSL通信を使用するには，認証サーバホストおよびその認証サーバに接続するホストのJP1/Baseのバージョンが11-00以降である必要があります。

(1)　認証サーバを指定する

次に示すコマンドを実行します。

jbssetusrsrv プライマリー認証サーバ [セカンダリー認証サーバ]

jbssetusrsrvコマンドの詳細については，「15.　コマンド」の「jbssetusrsrv（UNIX限定）」を参照してください。

注意事項

認証サーバ（プライマリー認証サーバおよびセカンダリー認証サーバ）として指定するホスト名は，JP1/Baseを起動する前にhostsファイル，またはDNSサーバに設定してください。認証サーバの指定（jbssetusrsrvコマンドの実行），hostsファイル，またはDNSサーバへの設定順序は任意ですが，JP1/Baseの起動時にはホスト名からIPアドレスを解決できる状態になっている必要があります。

プライマリー認証サーバおよびセカンダリー認証サーバには，ホスト名を指定してください。IPアドレスは認証サーバ名に指定できません。

(2)　指定した認証サーバを確認する

次に示すコマンドを実行してください。

jbslistsrv [-h 論理ホスト名]

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

(3)　自ホストの認証サーバを起動しないようにする

JP1/Baseの新規インストール時には，自動で認証サーバに自ホストが設定され，認証サーバが起動するようになっています。認証サーバの指定を自ホストから他ホストに変更した場合でも，自ホストの認証サーバのプロセスは起動したままです。認証サーバに自ホストを指定しない場合で，認証サーバを停止したいときの設定手順を次に示します。

認証サーバを停止して影響がないか確認する。

次のコマンドを実行する。

cd /etc/opt/jp1base/conf
cp -p jp1bs_spmd.conf.model jp1bs_spmd.conf

JP1/Baseを再起動する。

認証サーバを停止したあとに，再度自ホストを認証サーバ（プライマリー認証サーバまたはセカンダリー認証サーバ）に指定する場合は，次の操作で認証サーバを起動してください。

次のコマンドを実行する。

cd /etc/opt/jp1base/conf
cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

JP1/Baseを再起動する。

8.3.2　JP1ユーザーを設定する

認証サーバでユーザー認証をするJP1ユーザー（標準ユーザー）の設定について説明します。JP1ユーザーは，認証サーバ（プライマリー認証サーバ）に指定したホストでだけ設定します。

JP1ユーザー登録，およびパスワード変更時に，パスワードポリシー定義に従い，認証サーバは，指定されたパスワードのチェックをします。パスワードがパスワードポリシーに違反している場合，認証サーバは，警告メッセージを統合トレースログに出力します。この統合トレースログを参照することで，ポリシーに違反している要因を特定できます。

パスワードポリシー定義に設定したすべてのポリシーの条件を満たさない場合は，エラーとなります。

重要

パスワードポリシー定義によるパスワードのチェックをする設定の場合に，コマンドの実行時に入力したパスワードがパスワードポリシーに違反していると，KAVA5908-Eのメッセージが出力されます。

JP1/Baseで提供するコマンドを実行すると，JP1ユーザーの登録，削除およびJP1ユーザーのパスワードの変更ができます。また，登録したJP1ユーザーを一覧表示するコマンドも提供しています。各コマンドの詳細については，「15.　コマンド」を参照してください。

(1)　JP1ユーザーを登録する

JP1ユーザーを認証サーバに登録する場合，次に示すコマンドを実行します。

jbsadduser JP1ユーザー名

JP1ユーザー名には，小文字だけを使用してください。コマンド実行後にパスワードの入力を促されます。大文字と小文字を区別して入力してください。JP1ユーザー名およびパスワードに指定できる文字の制限を次の表に示します。

パスワードポリシー定義によるパスワードのチェックをする設定の場合，JP1ユーザーの登録時にパスワードポリシーに即しているかチェックをします。

表8‒8　JP1ユーザー名およびパスワードの文字制限

対象

バイト数

使用禁止文字

JP1ユーザー名

1〜31バイト

* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < > およびスペース，タブ

パスワード※

6〜32バイト

パスワードポリシーを定義していない場合

¥ " : およびスペース，タブ

パスワードポリシーを定義している場合

パスワードポリシー定義ファイルの設定に従う

注※

パスワードポリシーによるパスワードのチェックをする設定の場合，「2.1.1(3)　パスワードポリシーによる管理」を参照してください。

(2)　JP1ユーザーのパスワードを変更する

登録したJP1ユーザーのパスワードを変更する場合は，次に示すコマンドを実行します。

jbschgpasswd JP1ユーザー名

パスワードポリシー定義によるパスワードのチェックをする設定の場合，JP1ユーザーのパスワードを変更する時にパスワードポリシーに即しているかチェックをします。

(3)　JP1ユーザーの削除

登録したJP1ユーザーを削除する場合は，次に示すコマンドを実行します。

jbsrmuser JP1ユーザー名

(4)　JP1ユーザーの一覧表示

登録したJP1ユーザーの情報を確認する場合は，次に示すコマンドを実行します。

jbslistuser

8.3.3　JP1ユーザーの操作権限を設定する

認証サーバ（プライマリー認証サーバ）で必要な設定です。JP1ユーザーが，ジョブやジョブネットなどのJP1資源グループに対して，どのような操作ができるか（JP1権限レベル）を設定します。

注意事項

JP1/AJSで，JP1資源グループ名を指定していないジョブやジョブネットは，操作権限の設定の対象になりません。すべてのJP1ユーザーによるすべてのアクセスができるようになります。

JP1ユーザーの操作権限を設定する方法は，一括して設定する方法と，個別に登録，削除する方法があります。

JP1ユーザーの操作権限の設定について次に説明します。

(1)　JP1ユーザーの操作権限を一括して設定する

コマンドを使ってJP1ユーザーの操作権限を一括して設定できます。JP1ユーザーの操作権限を一括して登録する場合，ユーザー権限レベルファイル（JP1_UserLevel）に操作権限を定義します。編集後，jbsaclreloadコマンドを実行すると設定が反映されます。jbsaclreloadコマンドの詳細については，「15.　コマンド」の「jbsaclreload」を参照してください。ユーザー権限レベルファイルの詳細については，「16.　定義ファイル」の「ユーザー権限レベルファイル」を参照してください。

(2)　JP1ユーザーの操作権限を個別に登録する

JP1ユーザーの操作権限を個別に追加または変更する場合，登録したいJP1ユーザーの操作権限を記述した定義ファイルを作成する必要があります。

定義ファイルは，ユーザーが任意の場所に格納できます。ファイルの形式は，ユーザー権限レベルファイル（JP1_UserLevel）の形式と同じです。ユーザー権限レベルファイルの詳細については，「16.　定義ファイル」の「ユーザー権限レベルファイル」を参照してください。

定義ファイルを作成したあと，次のコマンドを実行すると，定義ファイルの情報が認証サーバに登録されます。

jbssetacl -f 定義ファイル名

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

(3)　JP1ユーザーの操作権限を個別に削除する

登録したJP1ユーザーの操作権限を個別に削除したい場合は，次のコマンドを実行してください。

jbsrmacl -u JP1ユーザー名

このコマンドを実行すると，指定したJP1ユーザーに設定されている操作権限がすべて削除されるためご注意ください。

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

8.3.4　プライマリー認証サーバの設定情報をコピーする

セカンダリー認証サーバを設置する場合，プライマリー認証サーバと同じ設定で運用しなければなりません。そのため，プライマリー認証サーバの設定完了後，プライマリー認証サーバの設定情報をセカンダリー認証サーバにコピーする必要があります。

プライマリー認証サーバで，JP1ユーザーおよび操作権限の設定を完了する。

JP1ユーザーの設定については，「8.3.2　JP1ユーザーを設定する」，JP1ユーザーの操作権限の設定については，「8.3.3　JP1ユーザーの操作権限を設定する」を参照してください。

セカンダリー認証サーバを起動する。

JP1/Baseを起動し，セカンダリー認証サーバを起動してください。認証サーバが起動しているかどうかは，jbs_spmd_statusコマンドで確認できます。コマンド実行後，表示される情報の中にjbssessionmgrがあれば，認証サーバが起動しています。

プライマリー認証サーバの設定ファイルを，FTPなどを使ってコピーする。

プライマリー認証サーバの設定ファイルを，FTPなどを使って，セカンダリー認証サーバにコピーします。コピーする設定ファイルは，JP1_AccessLevel，JP1_Group，JP1_Passwd，JP1_UserLevelです。これらのファイルは以下のディレクトリに格納されています。

/etc/opt/jp1base/conf/user_acl/

コピー先ディレクトリは，自ホスト上の同じディレクトリになります。また，論理ホストの場合は，以下のディレクトリに格納されています。

共有ディレクトリ名/jp1base/conf/user_acl/

コマンドを使って設定を反映させる。

最後に，コピーした設定情報のファイルの内容を反映させます。jbs_spmd_reloadコマンドを実行し，正常終了すれば設定が有効になります。

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

注意事項

プライマリー認証サーバとセカンダリー認証サーバのJP1/Baseは同じバージョンにしてください。

セカンダリー認証サーバが起動していない場合は，次のコマンドを実行してください。

cd /etc/opt/jp1base/conf

cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

JP1/Baseを再起動すると，認証サーバが起動します。

設定ファイルはテキストファイルです。異なるプラットフォーム間で転送する場合，文字コードに注意してください。また，FTPで転送する場合は，必ずASCII転送をしてください。

プライマリー認証サーバおよびセカンダリー認証サーバのパスワード保管形式は，必ず一致させてください。JP1/Baseのバージョンが12-00以降では，JP1ユーザーのパスワード保管形式の初期設定をハッシュレベル1モードからハッシュレベル2モードに変更しているため，パスワード保管形式が不一致となる可能性があります。パスワード保管形式は，認証サーバホスト起動時のKAVA1692-Iメッセージで確認してください。パスワード保管形式の設定方法については，「3.4.6　パスワード保管形式の設定」を参照してください。

8.3.5　ユーザーマッピングを設定する

コマンドを実行すると，定義ファイルに記述したユーザーマッピング情報を共通定義情報に一括して登録できます。また，ユーザーマッピング情報を個別に追加，変更および削除することもできます。

(1)　ユーザーマッピング情報を一括して設定する

ユーザーマッピング情報を一括して設定する場合は，ユーザーマッピング定義ファイル（jp1BsUmap.conf）で設定します。ユーザーマッピング定義ファイルの詳細については，「16.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。

ユーザーマッピング定義ファイル（jp1BsUmap.conf）をエディターで編集したあと，jbsmkumapコマンドを実行すると，共通定義情報に登録されていたマッピング情報がいったんすべて削除され，ユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報が共通定義情報に登録されます。なお，設定されたマッピング情報を確認する場合は，jbsgetumapコマンドを実行します。

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

(2)　ユーザーマッピング情報を個別に登録する

jbssetumapコマンドを実行すると，ユーザーマッピング情報を個別に追加したり変更したりできます。ユーザーマッピング情報を個別に追加または変更するには，jbssetumapコマンドのオプションにユーザーマッピング情報を直接指定して登録する方法と，ユーザーマッピング情報を記述した定義ファイルを使用して登録する方法があります。

ユーザーマッピング情報を指定して共通定義情報に登録する場合は，次のコマンドを実行してください。

jbssetumap {-u JP1ユーザー名 | -ua}
           {-sh サーバホスト名 | -sha}
           {-o OSユーザー名[,OSユーザー名]}
           [-no]

定義ファイルを作成して登録する場合は，次のコマンドを実行してください。

jbssetumap -f 定義ファイル名

定義ファイルは任意の場所に格納できますが，ファイルの形式はユーザーマッピング定義ファイル（jp1BsUmap.conf）と同じにしてください。ユーザーマッピング定義ファイルの形式については，「16.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。jbssetumapコマンドの詳細については，「15.　コマンド」の「jbssetumap」を参照してください。

(3)　ユーザーマッピング情報を個別に削除する

共通定義情報からユーザーマッピング情報を個別に削除する場合，jbsrmumapコマンドを実行してください。

次の形式でコマンドを実行します。

jbsrmumap -u JP1ユーザー名

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

8.3.6　ユーザー管理に関する注意事項

クラスタシステムでユーザー管理の設定をする場合は，まず，「5.　クラスタシステムで運用する場合の設定」を参照してクラスタ運用の環境設定をしてください。そのあと，「8.3　ユーザー管理の設定（UNIXの場合）」を参照してユーザー管理の設定をしてください。設定をする際，各コマンドで-hオプションに論理ホスト名を指定してください。

認証サーバをクラスタシステムで運用する場合，認証サーバの設定ファイルは次のディレクトリに格納されています。

共有ディレクトリ名/jp1base/conf/user_acl/

セカンダリー認証サーバを設置する場合は，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバへコピーする必要があります。その際，セカンダリー認証サーバをクラスタ運用するかしないかで，設定ファイルのコピー先が異なってくるので注意が必要です。

クラスタ運用する場合のコピー先

共有ディレクトリ名/jp1base/conf/user_acl/

クラスタ運用しない場合のコピー先

/etc/opt/jp1base/conf/user_acl/

設定ファイルをコピーしたあとに，次のコマンドを実行して設定を反映させてください。セカンダリー認証サーバをクラスタ運用しない場合は，-hオプションの指定は不要です。

jbs_spmd_reload -h 論理ホスト名

8.4　閉塞状態に関する設定（セカンダリー認証サーバを設置した場合）

セカンダリー認証サーバを設置した場合，プライマリー認証サーバへの接続に失敗すると，以降，接続先認証サーバをセカンダリー認証サーバに切り替え，プライマリー認証サーバへの接続を閉塞状態にします。この節では，閉塞状態の確認方法，閉塞状態の解除方法，および閉塞状態にする方法について説明します。

注意事項

一つのユーザー認証圏内に認証サーバを1台しか設置しない場合，閉塞状態の設定はできません。一つのユーザー認証圏内に認証サーバを2台設置した場合だけ，閉塞状態の設定ができます。

WindowsではGUIやコマンドを使って，UNIXではコマンドを使って閉塞状態に関する設定を行います。

8.4.1　GUIを使って設定する（Windows限定）

GUIを使って閉塞状態の設定をする場合の操作を次に示します。

Windowsのスタートメニューから［プログラム］−［JP1_Base］−［JP1_Base Setup］を選択する。

［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブを選択する。

［認証サーバ］タブの［認証サーバの検索順序］で閉塞状態の設定を行います。

(1)　閉塞状態を確認する

［認証サーバの検索順序］で閉塞状態かどうかを確認できます。認証サーバが閉塞状態であれば，［閉塞状態］に「閉塞中」と表示されます。何も表示されていない場合，閉塞状態ではありません。

(2)　閉塞状態を解除する

［認証サーバの検索順序］の［閉塞状態］で「閉塞中」となっている認証サーバ名を選択する。

［変更］ボタンをクリックする。

［認証サーバ］ダイアログボックスの［認証サーバを閉塞状態に設定する］のチェックを外してください。

［OK］ボタンまたは［適用］ボタンをクリックする。

［OK］ボタンをクリックすると，設定内容が反映され，GUIがすべて閉じます。

［適用］ボタンをクリックすると，設定内容が反映され，［認証サーバ］タブに戻ります。

閉塞状態が解除されたことを確認する場合は，［JP1/Base環境設定］ダイアログボックスの［閉塞状態］で確認してください。何も表示されていなければ，閉塞状態が解除されたことになります。

(3)　閉塞状態にする

［認証サーバの検索順序］の［閉塞状態］に何も表示されていない認証サーバ名を選択する。

［変更］ボタンをクリックする。

［認証サーバ］ダイアログボックスの［認証サーバを閉塞状態に設定する］をチェックしてください。

［OK］ボタンまたは［適用］ボタンをクリックする。

［OK］ボタンをクリックすると，設定内容が反映され，GUIがすべて閉じます。

［適用］ボタンをクリックすると，設定内容が反映され，［認証サーバ］タブに戻ります。

閉塞状態になったことを確認する場合は，［JP1/Base環境設定］ダイアログボックスの［閉塞状態］で確認してください。「閉塞中」と表示があれば閉塞状態になったことになります。

8.4.2　コマンドを使って設定する

ここでは，コマンドを使った閉塞状態の設定について説明します。なお，ここでは，プライマリー認証サーバをserver1，セカンダリー認証サーバをserver2と指定していることを仮定して説明します。

(1)　閉塞状態を確認する

次に示すコマンドを実行してください。

jbslistsrv

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

(2)　閉塞状態を解除する

次に示すコマンドを実行してください。

jbsunblockadesrv -s 認証サーバ

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

(3)　閉塞状態にする

次に示すコマンドを実行してください。

jbsblockadesrv -s 認証サーバ

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

9　サービスの起動順序および終了順序の設定（Windows限定）

サービスの起動順序および終了順序を定義できます。この章では，サービスの起動順序および終了順序の設定方法について説明します。

9.1　サービスの起動順序および終了順序の設定手順

JP1SVPRM.DATという名称で起動順序定義ファイル（JP1SVPRM.DAT）を作成する。

cpysvprmコマンドを実行します。cpysvprmコマンドの詳細については，「15.　コマンド」の「cpysvprm（Windows限定）」を参照してください。

cpysvprmコマンドを実行すると，JP1/Baseのデータフォルダ（インストール先フォルダ¥conf¥boot¥）※1にJP1SVPRM.DATファイルが作成されます。起動順序定義ファイル（JP1SVPRM.DAT）を変更したり※2，新規に作成したりした場合も，ファイル名はJP1SVPRM.DATとしてください。

必要に応じて，JP1SVPRM.DATファイルをテキストエディターなどで開き，編集する。

JP1SVPRM.DATファイルの編集方法については，「9.2　起動順序定義ファイルを編集する」を参照してください。

JP1SVPRM.DATファイルで設定したサービスの起動方法を「自動」から「手動」に変更する。※3

［コントロールパネル］の［サービス］ダイアログボックスで，該当するサービスの起動方法を変更してください。

サービスが起動するタイミングを設定する。

OSによるサービス起動のタイミングと，JP1/Baseによるサービス起動のタイミングが重なると，マシンに負荷が掛かりサービスの起動に失敗するおそれがあります。サービス起動の競合による起動の失敗を回避するために，JP1/Baseによるサービス起動のタイミングを設定してください。

また，指定した時間内にサービスが正常に起動したかどうかを確認できます。設定の詳細については，「9.3　サービスが起動するタイミングを設定する」を参照してください。

Windowsを再起動する。※4

注※1

JP1/Baseのデータフォルダ（インストール先フォルダ¥conf¥boot¥）にJP1SVPRM.DAT.MODELファイルがありますが，このファイルは，直接編集しないでください。

注※2

JP1SVPRM.DATファイルの内容を変更する場合は，変更前のファイルのバックアップをとってから，JP1SVPRM.DATファイルの内容を変更することをお勧めします。

注※3

JP1SVPRM.DATファイルで設定したサービスの起動方法を「自動」から「手動」に変更しないと，JP1SVPRM.DATファイルに記述したとおりにサービスが起動しません。また，JP1SVPRM.DATファイルに記述したとおりに起動しなかったサービスは，終了順序をJP1SVPRM.DATファイルで設定していても対象になりません。

注※4

起動管理の使用をやめる場合は，cpysvprm -dを実行します。実行すると，JP1SVPRM.DATファイルが削除されます。また，再度同じJP1SVPRM.DATファイルを登録する必要がある場合は，削除する前にJP1SVPRM.DATファイルのバックアップをとることをお勧めします。

9.2　起動順序定義ファイルを編集する

起動順序定義ファイル（JP1SVPRM.DAT）には，起動順序および終了順序を管理したいサービスの情報を記述します。

9.2.1　サービスの起動順序の制御

起動順序定義ファイル（JP1SVPRM.DAT）で起動順序を設定する場合，次の形式で設定します。

JP1製品の前に起動させるJP1以外のサービス

起動順序定義ファイル（JP1SVPRM.DAT）の[FrontOtherServiceXXX]（XXXは，サービスごとに異なる任意の文字列）セクションに記述します。

JP1製品のサービス

起動順序定義ファイル（JP1SVPRM.DAT）の[Jp1XXX]（XXXは，サービスごとに割り当てられた文字列）セクションに記述します。

JP1製品のあとに起動させるJP1以外のサービス

起動順序定義ファイル（JP1SVPRM.DAT）の[OtherServiceXXX]（XXXは，サービスごとに異なる任意の文字列）セクションに記述します。

セクションとは，サービスごとの処理方法，および起動管理機能（JP1/Base Control Service）としての処理方法を明確にするための単位です。

起動順序定義ファイル（JP1SVPRM.DAT）に記述したサービスの起動については，次の制御もできます。

直前のサービスの開始処理が完了してから次のサービスの開始処理を始める。

直前のサービスの開始処理が完了しないうちに次のサービスの開始処理を始める。

定義ファイルの詳細については，「16.　定義ファイル」の「起動順序定義ファイル（Windows限定）」を参照してください。

システム起動時のサービスの起動順序を次の図に示します。

図9‒1　起動管理を使用した場合のサービスの起動順序

なお，システム管理者は，サービスの起動が正しく完了したかどうか，次に示す二つのメッセージで確認してください。

メッセージID「KAVA4014-I」のメッセージ※

メッセージID「KAVA4036-I」のメッセージ

注※　起動順序定義ファイル（JP1SVPRM.DAT）で定義したすべてのサービスに関して出力されているか確認してください。

9.2.2　サービスの終了順序の制御

終了順序を制御する場合は，同じマシンにJP1/Power Monitorが必要です。終了順序を制御したいサービスには，起動順序定義ファイル（JP1SVPRM.DAT）で終了コマンドを指定しておきます。終了コマンドが記述されたサービスは，起動時と逆の順序で終了します。なお，サービスの終了が，複数のコマンドを組み合わせて実行されている場合には，一つのバッチファイルに記述してから指定してください。

起動順序定義ファイル（JP1SVPRM.DAT）に記述したサービスの終了については，次の制御ができます。

直前のサービスの終了処理が完了してから次のサービスの終了処理を始める。

システム終了時のサービスの終了順序を次の図に示します。

図9‒2　起動管理を使用した場合のサービスの終了順序

JP1/Power Monitorからの計画終了時には，起動順序定義ファイル（JP1SVPRM.DAT）に定義したとおりに，必ずサービスの終了処理が実行されます。この場合，終了処理の対象になるのは，起動管理機能（JP1/Base Control Service）で起動したサービスだけで，起動管理機能（JP1/Base Control Service）を使って起動できなかったサービスは，終了処理の対象になりません。また，JP1/Power Monitorからの強制終了時にサービスの終了順序を管理したい場合は，起動順序定義ファイル（JP1SVPRM.DAT）の[ControlValue]セクションで指定が必要になります。

なお，システム管理者は，サービスの終了が正しく完了したかどうか，次に示す二つのメッセージで確認してください。

メッセージID「KAVA4023-I」のメッセージ※

メッセージID「KAVA4035-I」のメッセージ

注※　起動順序定義ファイル（JP1SVPRM.DAT）で定義したすべてのサービスに関して出力されているか確認してください。

各サービスについて，起動コマンド，終了コマンド，起動時の待ち時間，および終了時の待ち時間を指定できます。なお，起動コマンドおよび終了コマンドに対してサービスのスタートアップパラメーターは指定できません。

9.3　サービスが起動するタイミングを設定する

起動順序定義ファイル（JP1SVPRM.DAT）に指定したサービスが起動するタイミングを，指定した時間待機させられます。これによって，OSによるサービス起動との競合による起動の失敗を回避できます。

また，指定した時間内にサービスが正常に起動したかどうかを確認できます。指定した時間内に正常に起動しなかった場合は，Windowsのイベントログおよび統合トレースログにメッセージKAVA4107-Wが出力されます。このメッセージが出力されている場合は，起動していないサービスがないか確認し，該当するサービスを手動で起動してください。

設定する手順について説明します。

サービス起動遅延時間／タイマー監視時間定義ファイル（Jp1svprm_wait.dat）を編集する。

サービス起動遅延時間／タイマー監視時間定義ファイルのサンプル（Jp1svprm_wait.dat.sample）をJp1svprm_wait.datのファイル名でコピーして編集してください。

サービス起動遅延時間／タイマー監視時間定義ファイルの詳細については，「16.　定義ファイル」の「サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）」を参照してください。

定義を反映する。

OSを再起動してください。

または，起動順序定義ファイル（JP1SVPRM.DAT）に指定しているすべてのサービスを停止したあと，JP1/Base Control Serviceサービスを再起動してください。

設定を無効にする手順について説明します。

サービス起動遅延時間／タイマー監視時間定義ファイル（Jp1svprm_wait.dat）を削除するか，ファイル名を別の名称に変更する。

設定を無効にする。

OSを再起動してください。

または，起動順序定義ファイル（JP1SVPRM.DAT）に指定しているすべてのサービスを停止したあと，JP1/Base Control Serviceサービスを再起動してください。

9.4　起動管理機能を使用する場合の注意事項

Windowsの起動中に，［コントロールパネル］のサービスに対して操作をしないでください。サービスの起動が正しく実行されないことがあります。

起動順序定義ファイル（JP1SVPRM.DAT）内に定義されているサービスに対しては，［コントロールパネル］の［サービス］ダイアログボックス上で操作しないでください。KAVA4003-Eメッセージが出力され，正常に動作しなくなる場合があります。

論理ホスト上で動作するサービスに対しては，起動を制御できません。物理ホスト上のサービスに対してだけ利用できます。論理ホスト上のサービスの起動管理には，クラスタソフトを利用してください。

10　イベントサービス環境の設定

この章では，JP1/Baseのイベントサービスを使うための設定方法について説明します。

10.1　イベントサービス環境の設定手順

イベントサービス環境の設定では，次の二つの設定をします。

イベントサービスの動作環境の設定

JP1イベントの転送設定

初期設定では次のように設定されています。

自ホストでイベントサーバを動作させる。

イベントDBを作成する。

イベントDBを初期設定で作成する場所を次に示します。

Windowsの場合：

インストール先フォルダ¥sys¥event¥servers¥

UNIXの場合：

/var/opt/jp1base/sys/event/servers/

なお，イベントDBの上限サイズは，初期設定で10,000,000バイトとなっています。

JP1イベントをすべて取得する。

JP1イベントを上位サーバに転送する。※

注※　上位サーバとは，JP1/IMの構成定義ファイルで設定したサーバです。また，転送されるJP1イベントは，拡張属性「SEVERITY」の値が「Warning」「Error」「Critical」「Alert」「Emergency」「Emergence」のどれかと一致するJP1イベントとなっています。JP1/IMの構成定義ファイルで上位サーバを設定しなかった場合，JP1イベントは転送されません。構成定義ファイルで設定したサーバ以外の他ホストにJP1イベントを転送したい場合は，転送設定ファイルを編集してください。

10.1.1　転送するJP1イベントの検討

まず，どのようなJP1イベントを転送するか検討します。検討する際には，次の点について考慮してください。

システムの障害監視を目的とする場合は，重要なJP1イベントだけを転送する

初期設定では，重要なJP1イベントだけをJP1/IM - Managerで定義されたシステム構成に従って上位のサーバへ転送する設定になっています。システムの障害監視を目的とする場合は，初期設定を推奨します。初期設定から設定を変更する場合でも，運用に不要なJP1イベントは上位ホストに転送しないようにしてください。

初期設定で転送されるJP1イベントを考慮する

次に示すイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されるJP1イベントです。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

JP1/Baseの起動通知イベント（00004724）

JP1/Baseの停止通知イベント（00004725）

しきい値による抑止通知イベント（00003D0B）

しきい値による抑止解除通知イベント（00003D0C）

しきい値による抑止全解除通知イベント（00003D0D）

しきい値による抑止継続通知イベント（00003D0E）

転送するJP1イベントの単一時間当たりの件数を考慮する

転送するJP1イベントが多いと，転送処理に遅延が発生するおそれがあります。

転送するJP1イベント数が短い時間内に集中して発生しないように，また，短い時間内に集中して発生しても，それが長時間にわたって発生しないようにしてください。例えば，重大度が「警告」以上のJP1イベントだけ転送する，というように転送設定ファイル（forward）でイベントフィルターを指定してください。

上位ホスト（マネージャー，またはサブマネージャー）に集まるJP1イベントの総数を考慮する

上位ホストに転送されてくるJP1イベントが多いと，イベントDBにJP1イベントを登録する処理に遅延が発生するおそれがあります。

マネージャーホストが管理するホスト数と各ホストから転送されてくるJP1イベント数，そして自ホスト上で発生するJP1イベント数について検討してください。例えば，エージェントからサブマネージャーへ転送するJP1イベントは，重大度が「警告」以上，サブマネージャーからマネージャーへ転送するJP1イベントは，重大度が「エラー」以上，というように各ホストの転送設定ファイル（forward）でイベントフィルターを指定してください。

ネットワーク上を流れるデータ量を考慮する

JP1イベント1件当たりの転送データ量の見積もり式を次に示します。

60※1 + 600※2（単位：バイト）

注※1　イベントサーバ設定ファイル（conf）のremote-serverパラメーターに指定した接続先イベントサーバ名が16バイトで，通信タイプがcloseのとき，イベント転送1件ごとに発生します。また，通信タイプがkeep-aliveのときは，最初の1件目だけ発生します。

注※2　ログファイルトラップで約100バイトの文字列をトラップして発生したJP1イベントの場合です。

10.1.2　大量発生イベントの転送抑止の検討

大量発生イベントの転送を未然に防ぐために，大量発生イベントを検知するためのしきい値を設定して，イベント転送を自動的に抑止することを検討してください。イベント転送を自動的に抑止するには，大量発生イベントを検知するためのしきい値に相当する，イベント転送抑止条件について検討が必要です。

イベント転送抑止条件は，転送設定ファイル（forward）に設定します。

イベント転送抑止条件には，単位時間（しきい値を判定する期間），しきい値（単位時間当たりのJP1イベントの件数），確認回数（大量発生イベントの発生と収束を判定する単位時間の回数）などを設定します。

イベント転送抑止条件の詳細については，「16.　定義ファイル」の「転送設定ファイル」を参照してください。

10.1.3　イベントサービス環境を設定する

イベントサービスの動作環境を設定する。

イベントサービスの動作環境は，次に示すファイルで設定します。

イベントサーバインデックスファイル（index）

イベントサーバが使用するディレクトリを指定するファイルです。

イベントサーバ設定ファイル（conf）

イベントサービスの各種動作環境を指定するファイルです。

API設定ファイル（api）

アプリケーションプログラムからイベントサーバへの接続方法や使用するポートを指定するファイルです。

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

JP1イベントの転送設定をする。

転送設定ファイル（forward）で，どのイベントサーバへどのようなJP1イベントを転送するか設定します。初期設定では，重要なJP1イベントだけをJP1/IM - Managerで定義されたシステム構成に従って上位のサーバへ転送する設定になっています。システムの障害監視を目的とする場合は，初期設定を推奨します。

転送設定ファイルの詳細については，「16.　定義ファイル」の「転送設定ファイル」を参照してください。

設定を有効にする。

イベントサービスを起動すると，設定が有効になります。

Windowsの場合

システム起動時にイベントサービスが自動起動するように初期設定されています。起動管理については，「9.　サービスの起動順序および終了順序の設定（Windows限定）」を参照してください。

UNIXの場合

jevstartコマンドを実行します。

10.1.4　イベントサービスの動作環境を変更する

イベントサーバ設定ファイル（conf），またはAPI設定ファイル（api）を編集する。

イベントサーバ設定ファイル（conf），またはAPI設定ファイル（api）を編集します。

イベントサーバインデックスファイル（index）を編集する。

イベントサービスを停止してからイベントサーバインデックスファイル（index）を編集します。

各設定ファイルの変更内容を有効にする。

イベントサービスを再起動すると，変更内容が有効になります。

Windowsの場合

［コントロールパネル］の［サービス］ダイアログボックスで，「JP1/Base Event」の名称のサービスを終了したあと，再起動してください。

UNIXの場合

jevstopコマンドでイベントサービスを終了したあと，jevstartコマンドで再起動してください。

(1)　上書きインストールした場合の注意事項

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

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

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

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

jevdbmkrepコマンドを実行する。

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

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

10.1.5　JP1イベントの転送設定を変更する

転送設定ファイル（forward）を編集する。

転送設定ファイル（forward）の変更内容を有効にする。

転送設定ファイル（forward）をリロードするか，イベントサービスを再起動すると，変更内容が有効になります。

転送設定ファイル（forward）をリロードする

システムの運用中に設定を有効にできます。次のコマンドを実行してください。

jevreload

イベントサービスを再起動する

Windowsの場合：［コントロールパネル］の［サービス］ダイアログボックスで，「JP1/Base Event」の名称のサービスを終了したあと，再起動してください。

UNIXの場合：jevstopコマンドでイベントサービスを終了したあと，jevstartコマンドで再起動してください。

(1)　マネージャーホストから定義情報を収集・配布する

転送設定ファイル（forward）の情報は，JP1/IM - Managerのシステム構成で定義された上位ホストから下位ホストに一括して配布できます。配布に成功した時点で各ホストの転送設定がリロードされ，更新された情報を基にイベント転送が開始されます。

定義収集・配布の詳細については，「12.　イベントサービスの定義情報の収集と配布（JP1/IM限定）」を参照してください。

(2)　転送設定ファイル（forward）のリロード時の注意事項

転送設定ファイル（forward）のリロード時にJP1イベントが転送中だった場合，その転送は中断され，転送に失敗したと見なされます。このため，リロード後に転送に失敗したJP1イベントから転送を再開するように，イベントサーバ設定ファイル（conf）のforward-limitパラメーターでリトライ時間を設定しておく必要があります。

(3)　JP1/IM - Manager使用時の転送設定ファイルのリロードについて

転送設定ファイル（forward）の転送設定ブロックにto-upper形式を指定している場合は，JP1/IM - Managerのシステム構成に従ってJP1イベントを転送します。JP1/IM - Managerのシステム構成が変更になった場合でも，JP1/IM - Managerでシステム構成を定義するjbsrt_distribコマンド実行時に，転送設定ファイル（forward）もリロードされます。そのため，JP1/IM - Managerのシステム構成が変更になっても，各ホスト上でjevreloadコマンドを実行する必要はありません。

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

10.1.6　イベントサービスの動作状況を確認する

イベントサービスが稼働しているかどうかを確認したい場合は，次のコマンドを実行してください。戻り値が0の場合は，イベントサービスが稼働しています。

jevstat

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

10.1.7　JP1イベントの転送設定の設定内容を確認する

稼働しているイベントサービスでイベント転送の設定内容を確認したい場合は，次のコマンドを実行してください。画面に転送設定ファイル（forward）の形式で出力されます。

jbsgetopinfo -o forward

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

10.1.8　大量発生イベントの転送抑止をマネージャーから設定する

jevagtfwコマンドによるイベント転送抑止の方法，イベント転送抑止の解除の方法，およびイベント転送状態の確認方法について説明します。また，特定のログファイルトラップをマネージャーから停止する方法について説明します。

なお，jevagtfwコマンドによるイベント転送抑止の方法，および特定のログファイルトラップをマネージャーから停止する方法の詳細な手順については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」の大量発生イベントの転送を抑止する手順の説明を参照してださい。

(1)　JP1イベントが大量発生しているエージェントからのイベント転送をマネージャーから抑止する

エージェントでJP1イベントが大量に発生した場合の対処として，エージェントからのイベント転送を抑止するには，マネージャーから次のコマンドを実行してください。

jevagtfw -s ホスト名

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

(2)　大量発生イベントの転送を抑止したエージェントホストを確認する

jevagtfwコマンドでイベント転送を抑止したエージェントホストの一覧を確認したい場合は，マネージャーから次のコマンドを実行してください。

jevagtfw -l

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

(3)　大量発生イベントの転送抑止をマネージャーから解除する

jevagtfwコマンドによるイベント転送抑止を解除したい場合は，マネージャーから次のコマンドを実行してください。

jevagtfw -r ホスト名

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

(4)　JP1イベントを大量に発行しているログファイルトラップをマネージャーから停止する

JP1イベントを大量に発行しているログファイルトラップをマネージャーから個別に停止する方法としては，IM構成管理を使用する方法があります。IM構成管理・ビューアーの［プロファイル表示/編集］画面から，抑止対象のログファイルトラップのプロセスを停止します。

10.1.9　しきい値による大量発生イベントの転送抑止を設定する

しきい値によるイベント転送抑止の設定，およびイベント転送抑止条件ごとの転送状態の確認方法について説明します。

(1)　イベント転送抑止条件を設定する

イベント転送を自動的に抑止したいエージェントの転送設定ファイル（forward）を編集する。

イベント転送抑止条件を，エージェントのJP1/Baseの転送設定ファイル（forward）に設定します。

イベント転送抑止条件の形式

suppress 識別子 単位時間 しきい値 確認回数 [あて先（省略可能）]
イベントフィルター
end-suppress

イベント転送抑止条件の詳細については，「16.　定義ファイル」の「転送設定ファイル」を参照してください。

転送設定ファイル（forward）の変更内容を有効にする。

転送設定ファイル（forward）をリロードするか，イベントサービスを再起動すると，変更内容が有効になります。

JP1イベントの発生状況が設定したイベント転送抑止条件に一致した場合，イベント転送が自動的に抑止されます。問題が解決し，JP1イベントの発生状況が転送抑止の解除条件に一致した場合，イベント転送が自動的に再開されます。

(2)　イベント転送抑止条件ごとの転送状態を確認する

イベント転送抑止条件ごとの転送状態を確認したい場合は，マネージャーから次のコマンドを実行してください。

jevfwstat

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

10.1.10　DNSを使ったシステムでのイベントサーバの設定

複数のドメインで構成されたシステムで，初期設定のイベントサーバを利用すると，さまざまな問題が発生するおそれがあります。ここでは，DNSを使ったシステムでのイベントサーバの設定方法について，一例を挙げて説明します。なお，DNSが自ホスト名としてFQDN名を返すことを前提とします。

d1.hitachi.co.jpとd2.hitachi.co.jpの二つのドメインで構成されたシステムを次の図に示します。

図10‒1　二つのドメインで構成されたシステム例

hostX.d1.hitachi.co.jpで発生した「ディスク容量不足」というJP1イベントがhost3.d2.hitachi.co.jpに転送され，JP1/IM - View上にこのJP1イベントが表示された場合，「登録ホスト名」は「hostX」と表示されます。上記図の場合では，d2.hitachi.co.jpにもhostXが存在するため，システム管理者はhostX.d1.hitachi.co.jpとhostX.d2.hitachi.co.jpのどちらで発生したJP1イベントなのかを区別できません。また，JP1/IM - Viewは，受信したJP1イベントに関連するプログラムのモニター画面を表示する機能を持ちますが，ドメインd2.hitachi.co.jpに所属するホストの場合，「hostX」を「hostX.d2.hitachi.co.jp」と解釈するため，これらの機能が誤動作することがあります。

このような問題を避けるために，複数のドメインで構成されたシステムでは，初期設定のイベントサーバの代わりに，FQDN形式のイベントサーバ名を持つイベントサーバ（FQDN形式のイベントサーバ）に設定を変更してください。

次に，FQDN形式のイベントサーバの設定手順について説明します。設定手順は，Windowsの場合とUNIXの場合で異なります。それぞれの場合の，FQDN形式のイベントサーバの設定手順を次に示します。

(1)　FQDN形式のイベントサーバを設定する（Windowsの場合）

ここでは，イベントサーバとしてhostX.d1.hitachi.co.jpを指定すると仮定して説明しています。

jevregsvcコマンドを使って，FQDN形式のイベントサーバをサービスに登録する。

jevregsvcコマンドの形式は，次のようになります。

jevregsvc -r hostX.d1.hitachi.co.jp

注意事項

JP1/IM - ManagerまたはJP1/AJSをインストールしている場合，初期設定のサービスと依存関係があります。Windowsで，FQDN形式のイベントサーバを設定するときは，JP1/IM - ManagerおよびJP1/AJSと初期設定のイベントサービスの依存関係を解除してください。

イベントサーバインデックスファイル（index）をエディターで開き，serverパラメーターのイベントサーバ名を初期設定の「*」から「@」または「hostX.d1.hitachi.co.jp」に変更する。

「@」に変更した場合，イベントサービスの定義情報の収集と配布が利用できます。「hostX.d1.hitachi.co.jp」に変更した場合，イベントサービスの定義情報の収集と配布が利用できなくなります。運用に合わせてどちらかに変更してください。

起動順序定義ファイル（JP1SVPRM.DAT）をエディターで開き，初期設定のイベントサーバの代わりにFQDN形式のイベントサーバを起動するように起動順序定義ファイル（JP1SVPRM.DAT）を編集する。

編集後の起動順序定義ファイル（JP1SVPRM.DAT）の内容（イベントサーバに関する個所だけ）を次に示します。

(2)　FQDN形式のイベントサーバを設定する（UNIXの場合）

ここでは，イベントサーバとしてhostX.d1.hitachi.co.jpを指定すると仮定して説明しています。

イベントサーバインデックスファイル（index）をエディターで開き，serverパラメーターのイベントサーバ名を初期設定の「*」から「@」または「hostX.d1.hitachi.co.jp」に変更する。

「@」に変更した場合，イベントサービスの定義情報の収集と配布が利用できます。「hostX.d1.hitachi.co.jp」に変更した場合，イベントサービスの定義情報の収集と配布が利用できなくなります。運用に合わせてどちらかに変更してください。イベントサーバ名を「@」に変更した場合のイベントサーバインデックスファイル（index）の内容を次に示します。

jbs_startスクリプトおよびjbs_stopスクリプトをエディターで開き，初期設定のイベントサーバの代わりにFQDN形式のイベントサーバが起動および停止するように編集する。

編集後のjbs_startスクリプトおよびjbs_stopスクリプトの内容（イベントサーバに関する個所だけ）を次に示します。

jbs_startスクリプトの内容

jbs_stopスクリプトの内容

10.2　イベントDBの初期化

イベントサービスの稼働中でも，jevdbswitchコマンドを使用して，イベントDBを初期化できます。ただし，次の場合にはイベントサービスを停止し，jevdbinitコマンドでイベントDBを初期化してください。

OSのリソース不足。

イベントサービスに接続できない。

ほかのイベントサーバにJP1イベントを転送している。

イベントDBを初期化する手順について説明します。

10.2.1　イベントサービスの稼働中に初期化する

ほかのイベントサーバにJP1イベントを転送している場合には，次の「10.2.2　イベントサービスの停止中に初期化する」を参照して，イベントDBを初期化してください。

OSのコマンドなどで，イベントDBをバックアップする。

イベントDBの内容を確認したい場合にバックアップします。バックアップしたデータベースの内容は，jevexportコマンドでcsvファイルに出力して確認できます。

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

jevdbswitchコマンドを2回実行する。

jevdbswitchコマンドを2回実行してイベントDBを2回切り替えてください。

jevdbswitchコマンドを1回実行すると，イベントDBのアクティブ面（現在使用されているイベントDB）からスタンバイ面（待機しているイベントDB）へと切り替わります。このとき，スタンバイ面に登録されていたデータは削除されます。jevdbswitchコマンドを2回実行すると，スタンバイ面とアクティブ面の両方のデータが削除されます。

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

注意事項

上記の操作では，メモリー上のイベントはクリアできません。メモリー上には最大2,000件の転送リトライ中のイベントが格納されます。メモリー上のイベントをクリアする場合は，「10.2.2　イベントサービスの停止中に初期化する」の手順でイベントDBを初期化してください。

10.2.2　イベントサービスの停止中に初期化する

イベントサービスの停止中に初期化する手順は，該当するマシンでイベント転送を実施しているかどうかで異なります。

(1)　初期化対象のイベントサーバからJP1イベントを転送している場合

転送先イベントサーバに転送されたJP1イベントから，イベントDB内通し番号の開始番号を求め，それを基に初期化を実施します。

転送先イベントサーバで，初期化対象のイベントサーバから最後に転送されたJP1イベントのイベントDB内通し番号を確認する。

次のどちらかの方法で，初期化対象のイベントサーバから最後に転送されたJP1イベントを検索してください。なお，転送先イベントサーバが複数ある場合は，すべての転送先イベントサーバを検索対象にしてください。

JP1/IM - Viewのイベント検索

JP1/IM - Viewのイベント検索で，転送先イベントサーバに登録されているJP1イベントを検索してください。

JP1イベントの検索方法については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」を参照してください。

イベントDBのcsvファイル出力

転送先イベントサーバのイベントDBをjevexportコマンドでcsvファイルに出力して確認してください。

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

jevdbinitコマンドの-sオプションに，イベントDB内通し番号の開始番号を指定して実行する。

次のコマンドを実行してください。

jevdbinit -s 手順1で求めたイベントDB内通し番号＋1 {-b | -n}

-sオプションに指定した開始番号でイベントDBが再作成されます。

(2)　初期化対象のイベントサーバからJP1イベントを転送していない場合

次のコマンドを実行して，イベントDBを初期化します。

jevdbinit {-b | -n}

jevdbinitコマンドを実行すると，イベントDBが削除されたあと，再作成されます。イベントDB内通し番号は，削除前のイベントDB内通し番号を引き継ぎます。

破壊されたデータベースをバックアップしたい場合は，-bオプションを指定してください。バックアップしない場合は-nオプションを指定してください。バックアップしたデータベースの内容は，jevexportコマンドでcsvファイルに出力して確認できます。

jevdbinitコマンド，およびバックアップしたデータベースの詳細については，「15.　コマンド」の「jevdbinit」を参照してください。

なお，jevdbinitコマンド実行時に，イベントDB内通し番号が引き継げない場合は初期化に失敗します。KAJP1789-Eのメッセージが出力された場合は，次のように，-sオプションで指定する開始番号を0に指定してイベントDBを再作成してください。

jevdbinit -s 0 {-b | -n}

10.3　イベントDBの内容をcsvファイルに出力する

この節では，イベントDBの内容をcsv形式に変換し，csvファイルに出力する方法について説明します。イベントDBの履歴をcsvファイルとして残したい場合や，バックアップしたイベントDBの内容を確認したい場合に使用します。csvファイルに出力するには，次のコマンドを実行します。

jevexport [-h イベントサーバ名]
          [-i イベントDBファイル名]
          [-o 出力ファイル名]
          [-f フィルターファイル名]
          [-t ON | OFF]
          [-l コードセット名]
          [-k 項目ファイル名]
          [-a]

jevexportコマンドの詳細については，「15.　コマンド」の「jevexport」を参照してください。次にcsvファイルの出力形式について説明します。

10.3.1　csvファイルの出力形式

文字列を出力する場合は，"（ダブルクォーテーションマーク）で囲んで出力します。

データをコンマで区切ります。

レコードを改行によって区切ります。

文字列データが空の場合でも"（ダブルクォーテーションマーク）で囲んで出力します。

数字型のデータを出力する場合は，半角数字を使用します。

拡張属性のうち，共通情報12種類は，拡張属性値だけを表示し，そのほかの固有情報は，拡張属性名と拡張属性値を出力します。

固有情報の出力順序は，固有情報属性名のアルファベット順に並びます。

csvファイルに出力される項目のうち列番号28番目以降は，項目ファイルによって変更できます。

出力される項目の詳細については，次に説明します。

10.3.2　csvファイルに出力される項目

csvファイルに出力される項目は，jevexportコマンド実行時に-kオプションを指定した場合と，指定しなかった場合によって異なります。

jevexportコマンド実行時に，-kオプションを指定した場合，-kオプションを指定しなかった場合，それぞれの場合に出力される項目を次に示します。

(1)　jevexportコマンド実行時に-kオプションを指定した場合

jevexportコマンド実行時に-kオプションを指定した場合，項目ファイルで指定した拡張属性（固有情報）が，指定された順番で列番号28以降に拡張属性名と拡張属性値のペアの形式で出力されます。なお，項目ファイルで指定した拡張属性が存在しなかった場合は，その列番号は空白となります。

jevexportコマンド実行時に-kオプションを指定した場合に出力される項目を次の表に示します。タイトル名は，-aオプションを指定した場合に出力されます。日本語で出力する場合は，-lオプションのコードセット名に文字コードを指定してください。-lオプションを指定しない場合は，タイトル名は英語で出力されます。

表10‒1　jevexportコマンドに-kオプションを指定した場合のcsvファイルに出力される項目

列番号

属性名

日本語タイトル名

英語タイトル名

詳細

形式

備考

1

イベントDB内の通し番号

イベントDB内通し番号

Serial number

発行元によらないで，このイベントサーバに到達した順番（ローカルイベントも含む）。この属性はJP1イベントのイベントサーバ間の転送時に保存されない。主にJP1イベントをユーザーアプリケーションが取得したときやほかのイベントサーバへ転送した時の漏れ・重複の防止に用いる。

数値

−

2

ID(基本部)

イベントID(基本部)

Event ID(basic code)

イベントIDの基本部。イベントIDは8バイトの値で表されるが，基本部は上位4バイトを表す。

数値

1〜8桁の16進数

3

ID(拡張部)

イベントID(拡張部)

Event ID(extended code)

イベントIDの拡張部。イベントIDは8バイトの値で表されるが，拡張部は下位4バイトを表す。

数値

1〜8桁の16進数

4

PROCESSID

発行元プロセスID

Source process ID

発行元アプリケーションプログラムのプロセスID。

数値

数値

5

TIME

登録時刻

Registered time

発行元イベントサーバでの登録時刻（発行元ホストの時計に基づく）。

数値

UTC 1970-01-01 00:00:00からの秒数

6

ARRIVEDTIME

到着時刻

Arrived time

自イベントサーバでの登録時刻。この属性はJP1イベントのイベントサーバ間転送時には保存されない。

数値

UTC 1970-01-01 00:00:00からの秒数

7

REASON

登録要因

Registered reason

JP1イベントがこのイベントサーバに登録された要因。この属性はJP1イベントのイベントサーバ間転送時に保存されない。登録要因を次に示す。

1の場合：

自イベントサーバから自イベントサーバあての発行

3の場合：

他イベントサーバから自イベントサーバあての発行

4の場合：

環境設定の指定による他イベントサーバから自イベントサーバへの転送。

数値

−

8

USERID

発行元ユーザーID

Source user ID

発行元プロセスのユーザーID。

数値

WindowsとJavaでは環境設定による固定値(-1〜65,535)

9

GROUPID

発行元グループID

Source group ID

発行元プロセスのグループID。

数値

WindowsとJavaでは環境設定による固定値(-1〜65,535)

10

USERNAME

発行元ユーザー名

Source user name

発行元プロセスのユーザー名。

文字列

−

11

GROUPNAME

発行元グループ名

Source group name

発行元プロセスのグループ名。

文字列

WindowsとJavaではヌル文字列

12

SOURCESERVER

発行元イベントサーバ名

Source event server name

発行元のイベントサーバ名。JP1イベントが転送された場合でもこのJP1イベントが発生したホストのイベントサーバ名が入る。

文字列

−

13

SOURCESEQNO

発行元イベントDB内通し番号

Source specific serial number

発行元ホストでのイベントDB内通し番号。

数値

転送によって値は変化しない

14

CODESET

コードセット

Code set

メッセージ・詳細情報・拡張属性が記述されている文字コードセット名。

文字列

−

15

MESSAGE

メッセージ

Message

JP1イベントの内容を表した文字列。

文字列

−

16

SEVERITY

重大度

Event level

JP1イベントの緊急性（「重大度」）を表す。緊急性の高い順に次の値がある。

"Emergency"（緊急）

"Alert"（警戒）

"Critical"（致命的）

"Error"（エラー）

"Warning"（警告）

"Notice"（通知）

"Information"（情報）

"Debug"（デバッグ）

文字列

拡張属性値1

17

USER_NAME

ユーザー名

User name

業務を実行しているユーザー名。

文字列

拡張属性値2

18

PRODUCT_NAME

プロダクト名

Product name

JP1イベントを発行したプログラム名。次に示すプログラム名などがある。

"/HITACHI/JP1/AJS"

"/HITACHI/JP1/AOM"

"/HITACHI/JP1/IM"

"/HITACHI/JP1/NBQ"

"/HITACHI/JP1/NQSEXEC"

文字列

拡張属性値3

19

OBJECT_TYPE

オブジェクトタイプ

Object type

オブジェクトの種類を表す。次に示すオブジェクトの種類などがある。

"JOB"

"JOBNET"

"ACTION"

"ACTIONFLOW"

"PRINTJOB"

"PRINTQUEUE"

"PRINTER"

"BATCHQUEUE"

"PIPEQUEUE"

文字列

拡張属性値4

20

OBJECT_NAME

オブジェクト名

Object name

ジョブ，ジョブネットなどのオブジェクトの名称。

ジョブネットなど階層のあるオブジェクトの場合，最下層の要素となる。

文字列

拡張属性値5

21

ROOT_OBJECT_TYPE

登録名タイプ

Root object type

オブジェクトの種別。

通常はOBJECT_TYPEの種別と同じだが，ジョブネットなど階層のあるオブジェクトの場合ROOT_OBJECT_NAMEの種別と同じになる。値の範囲はOBJECT_TYPEと同じ。

文字列

拡張属性値6

22

ROOT_OBJECT_NAME

登録名

Root object name

ユーザーの操作時に実行を指示する単位になる名称。通常はオブジェクト名と同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの名称になる。

文字列

拡張属性値7

23

OBJECT_ID

オブジェクトID

Object ID

オブジェクトID。

PRODUCT_NAMEとの組み合わせによってオブジェクトのインスタンスを統合システム内で一意に意識できる文字列（形式は他製品に依存する。この情報はJP1/IM - Viewの［統合機能メニュー］画面から各製品のモニターを呼び出すときに使用する）。

文字列

拡張属性値8

24

OCCURRENCE

事象種別

Occurrence

OBJECT_NAMEに対して起こった事象。次に示す事象種別などがある。

"END"

"LATEEND"

"LATESTART"

"NOTICE"

"PAUSE"

"START"

"SWITCH"

文字列

拡張属性値9

25

START_TIME

開始時刻

Start time

実行開始または再実行開始の時刻(UTC 1970-01-01 00:00:00からの秒数)。この項目は設定されない場合もある。

文字列

拡張属性値10

26

END_TIME

終了時刻

End time

実行終了または再実行終了の時刻(UTC 1970-01-01 00:00:00からの秒数)。この項目は設定されない場合もある。

文字列

拡張属性値11

27

RESULT_CODE

終了コード

Result Code

終了コード(10進数文字列)。この項目は設定されない場合もある。

文字列

拡張属性値12

28

個別拡張属性名1

個別拡張属性

Program-specific extended attribute

個別拡張属性名

文字列

−

29

個別拡張属性値1

出力なし

個別拡張属性値

文字列

−

：

：

：

：

：

：

：

：

：

：

：

：

m-1

個別拡張属性名n

出力なし

個別拡張属性名

文字列

−

m

個別拡張属性値n

出力なし

個別拡張属性値

文字列

−

（凡例）

m：csvファイルに出力される項目数

n：個別拡張属性名と個別拡張属性値の組数

(2)　jevexportコマンド実行時に-kオプションを指定しなかった場合

jevexportコマンド実行時に-kオプションを指定しなかった場合は，列番号28以降の内容が-kオプションを指定した場合と異なります。列番号28以降の項目を次の表に示します。なお，csvファイルに出力される列番号1〜27の項目については，「表10-1　jevexportコマンドに-kオプションを指定した場合のcsvファイルに出力される項目」を参照してください。タイトル名は，-aオプションを指定した場合に出力されます。日本語で出力する場合は，-lオプションのコードセット名に文字コードを指定してください。-lオプションを指定しない場合は，タイトル名は英語で出力されます。

表10‒2　jevexportコマンドに-kオプションを指定しなかった場合のcsvファイルに出力される項目

列番号

属性名

日本語タイトル名

英語タイトル名

詳細

形式

備考

28

個別拡張属性数

個別拡張属性数

Program-specific extended attributes count

個別拡張属性の数

数値

数値(0〜n)

29

個別拡張属性名1

個別拡張属性

Program-specific extended attribute

個別拡張属性名

文字列

−

30

個別拡張属性値1

出力なし

個別拡張属性値

文字列

−

：

：

：

：

：

：

：

：

：

：

：

：

m-1

個別拡張属性名n

出力なし

個別拡張属性名

文字列

−

m

個別拡張属性値n

出力なし

個別拡張属性値

文字列

−

（凡例）

m：csvファイルに出力される項目数

n：個別拡張属性名と個別拡張属性値の組数

10.4　イベントサービスの注意事項

Windows上で，JP1/Baseをインストールして，イベントサービスを起動しない設定に変更した場合，イベントサービスを利用するプログラムの性能に影響が出る場合があります。イベントサービスを起動しない場合には，イベントサービス環境設定のAPI設定ファイル（api）に次の指定を追加してください。

server 自ホスト名 close  0.0.0.0  jp1imevtapi

自ホスト名は，hostnameコマンドで表示されるとおりに設定してください。この指定によって，性能への影響を避けられます。なお，イベントサービスを起動する場合はこの指定はしないでください。

自ホスト名からIPアドレスへの変換，および自IPアドレスから自ホスト名への変換ができない環境では，イベントサービスを起動できません。これらの変換ができるようにhostsファイル，またはDNSサーバの設定をしてください。

インストール時に標準で設定されたイベントサーバ設定ファイル（conf）のportsパラメーターにIPアドレスを指定する場合，hostnameコマンドで返されるホスト名に対応していないIPアドレスを指定すると，JP1イベントを登録および取得するプログラムが，イベントサービスに接続できなくなることがあります。このような場合には，API設定（api）設定ファイルを修正してください。

例

confファイルの設定（portsパラメーター部分抜粋）

ports 192.168.1.2 jp1imevt jp1imevtapi

apiファイルの設定

server * keep-alive

server ホスト名 keep-alive 192.168.1.2

注　ホスト名にはhostnameコマンドで返されるホスト名を指定してください。

イベントサービスでは，JP1イベントの基本属性および拡張属性の文字列属性での外字の使用をサポートしていません。文字列属性に外字が含まれている場合，JP1/IM - Viewなどで正しく表示されない場合があります。また，転送設定ファイル（forward），ログファイルトラップ動作定義ファイル，イベントログトラップ動作定義ファイルでの外字の使用もサポートしていません。外字を指定した場合，JP1イベントが正しく転送されなかったり，正しくトラップされなかったりする場合があります。

11　イベント変換の設定

JP1/Baseでは，ログファイルへ出力されたメッセージやWindowsのイベントログをJP1イベントに変換して，イベントサービスで利用できます。

この章では，JP1/Baseが提供するイベント変換の設定方法について説明します。

11.1　アプリケーションプログラムのログファイルを変換する

ログファイルトラップを使ってアプリケーションログをJP1イベントに変換します。ログファイルトラップの場合，JP1イベントに変換したいアプリケーションプログラムのログメッセージが各ユーザーによって異なると考えられるため，定義情報は初期値を設定していません。ログファイルトラップを利用したい場合は，各ユーザーで設定してください。

11.1.1　アプリケーションプログラムのログファイルの形式を確認する

監視対象のログファイルの形式を確認して，ログファイルトラップ動作定義ファイルにログファイルの形式を指定します。ここでは，ログファイルの形式を確認する流れについて説明します。

ログファイルには出力形式によって，大きく分けてシーケンシャルファイルとラップアラウンドファイルがあります。

シーケンシャルファイルとは，常にログが追加される形式で出力され，ファイルサイズが小さくなることがないファイルです。ログファイルトラップでは，シーケンシャルファイルのうち，SEQ，SEQ2，SEQ3，およびUPDの形式のログファイルを監視できます。

ラップアラウンドファイルとは，特定の期間やファイルサイズによって，ログの出力位置が先頭に戻るファイルです。ログファイルトラップでは，ラップアラウンドファイルのうち，WRAP1，WRAP2，およびHTRACEの形式のログファイルを監視できます。

なお，SEQやWRAP1など，監視できるログファイルの形式の詳細については，「2.4.4　監視できるログファイル」を参照してください。

(1)　ログファイルの形式を確認する流れ（シーケンシャルファイルの場合）

監視対象のログファイルがシーケンシャルファイルの場合は，次の図に示す流れに従ってログファイルの形式を確認してください。なお，図中の対象外に該当するログファイルは，ログファイルトラップで監視できないログファイルとなります。

図11‒1　ログファイルの形式を確認する流れ（シーケンシャルファイルの場合）

(2)　ログファイルの形式を確認する流れ（ラップアラウンドファイルの場合）

監視対象のログファイルがラップアラウンドファイルの場合は，次の図に示す流れに従ってログファイルの形式を確認してください。なお，図中の対象外に該当するログファイルは，ログファイルトラップで監視できないログファイルとなります。

図11‒2　ログファイルの形式を確認する流れ（ラップアラウンドファイルの場合）

11.1.2　ログファイルトラップを設定する

ログファイルトラップの起動，設定の変更，動作状況の確認，設定内容の確認，および終了の手順について説明します。ログファイルトラップは次に示すファイルで設定します。

ログファイルトラップ動作定義ファイル

監視するログファイルの形式や，監視失敗時のリトライなどを設定します。詳細については，「16.　定義ファイル」の「ログファイルトラップ動作定義ファイル」を参照してください。

ログ情報定義ファイル（jevlogd.conf）

ログファイルトラップ用ログファイルの保存ファイル数や最大容量を指定します。通常は設定を変更しない（設定を省略した値）で運用できます。

詳細については，「16.　定義ファイル」の「ログ情報定義ファイル」を参照してください。

(1)　起動する

ログファイルトラップを起動する手順を説明します。

ログファイルトラップ動作定義ファイルを作成する。

jevlogstartコマンドを実行する。

ログファイルトラップが起動し，ID番号が標準出力，またはsyslogに出力されます。ID番号は，ログファイルトラップを停止したり，定義ファイルを更新したりする際に利用するため，控えておいてください。

また，jevlogstartコマンドでは，監視名を設定できます。監視名を設定すると，jevlogstop，jevlogreload，jevlogstatコマンドで監視名を指定して操作できます。

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

(2)　設定変更する

ログファイルトラップ動作定義ファイルとログ情報定義ファイル（jevlogd.conf）の設定を変更します。

(a)　ログファイルトラップ動作定義ファイルの設定を変更する

ログファイルトラップ動作定義ファイルを編集する。

変更を反映する。

MARKSTRまたはACTDEFパラメーター以外を変更した場合

ログファイルトラップを再起動します。jevlogstop { ID番号 | -a 監視名 }を実行したあと，jevlogstartコマンドを実行してください。

MARKSTRまたはACTDEFパラメーターを変更した場合

ログファイルトラップを停止しないで，jevlogreload { ID番号 | -a 監視名 }を実行して設定を反映してください。

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

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

(b)　ログ情報定義ファイルの設定を変更する

ログ情報定義ファイル（jevlogd.conf）を編集する。

ログファイルトラップ管理サービス（デーモン）を起動する。

(3)　動作状況を確認する

ログファイルトラップの動作状況を確認したい場合は，次のコマンドを実行してください。引数に指定したID番号または監視名のログファイルトラップの動作状況を戻り値によって確認できます。

jevlogstat { ID番号 | -a 監視名 }

また，次のように指定すると，動作中のログファイルトラップID番号および監視名の一覧を表示できます。

jevlogstat ALL

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

(4)　設定内容を確認する

稼働しているログファイルトラップの動作定義情報を確認したい場合は，次のコマンドを実行してください。画面にログファイルトラップ動作定義ファイルの形式で出力されます。

jbsgetopinfo -o logtrap [-i ID番号 | -a 監視名]

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

(5)　終了する

ログファイルトラップを終了する場合は，次のコマンドを実行します。

jevlogstop { ID番号 | -a 監視名 }

起動しているすべてのログファイルトラップを終了したい場合は，次のコマンドを実行します。

jevlogstop ALL

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

(6)　自動で起動する

ログファイルトラップは，システムを再起動すると停止し，自動で起動しません。システムの再起動時に，ログファイルトラップを自動で起動させたい場合は，次に示すどれかの方法を行ってください。

ログファイルトラップ起動定義ファイル（jevlog_start.conf）を使用する。

ログファイルトラップ起動定義ファイルに起動するログファイルトラップおよび起動オプションを指定します。指定したログファイルトラップは，ログファイルトラップ管理サービス（デーモン）起動時に自動的に起動されます。

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

なお，ログファイルトラップ起動定義ファイルを使用した場合は，ログファイルトラップ起動実行結果ログに出力される起動開始情報（KAVA3661-I）および起動結果情報（KAVA3662-I）を参照して，対象のログファイルトラップが起動されたことを確認してください。

Windowsの場合は，バッチファイルを作成し，JP1/Baseの起動管理で設定する。

jevlogstartコマンドを記述したバッチファイルを作成し，起動順序定義ファイル（JP1SVPRM.DAT）の「ReadyCommand=」に各バッチファイルのフルパスを記入してください。

起動順序定義ファイルの詳細については，「16.　定義ファイル」の「起動順序定義ファイル（Windows限定）」を参照してください。

UNIXの場合は，jbs_startを編集する。

イベントサービスおよびログファイルトラップ管理デーモンの起動後，ログファイルトラップを起動するように設定してください。

JP1/AJSのジョブとしてjevlogstartコマンドを実行する。

(7)　ログファイルトラップの言語種別を設定する（UNIXの場合）

ログファイルトラップの言語種別を設定するには，ログファイルトラップを起動する際に，環境変数LANGを指定します。指定できる環境変数LANGについては，「3.4.2　使用する言語種別を設定する（UNIXの場合）」を参照してください。

ここでは，ログファイルトラップの言語種別をUTF-8に指定する方法を説明します。

(a)　jevlogstartコマンド実行時に指定する場合

環境変数LANGにUTF-8を指定し，jevlogstartコマンドでログファイルトラップを起動することで，UTF-8で出力されたログを監視できるようになります。

スクリプトでログファイルトラップを起動する例

#!/bin/sh
LANG=ja_JP.utf8
export LANG
jevlogstart -a abc /home/hitachi/abc.log

(b)　ログファイルトラップ起動定義ファイルで指定する場合

ログファイルトラップ起動定義ファイルのSTART_OPTパラメーター（ログファイルトラップ管理デーモン用），およびSTART_OPT_CLSパラメーター（論理ホスト用）に起動LANGとしてUTF-8を指定します。

ログファイルトラップ起動定義ファイルの書式

START_OPT=[<起動LANG>]監視名:jevlogstartコマンドオプション
START_OPT_CLS=[クラスタID][<起動LANG>]監視名:jevlogstartコマンドオプション

11.1.3　ログファイルトラップの注意事項

ログファイルトラップで監視中のログファイルを編集，または削除する場合は，ログファイルトラップを停止してください。ログファイルトラップの動作中にログファイルを編集，または削除すると，ログファイルの監視位置がずれて，正しく変換できなくなることがあります。

ログファイルにデータを書き込んでも，ディスク中にそのデータが出力されていないと，ログファイルトラップはデータを取り出せません。つまり，即時にデータを取り出したい場合でも，ディスク中にデータが出力されていないため，データを取り出せないことがあります。

ログの書き込み位置がログファイルの最後の方にあると，最初のJP1イベントが発生するまでに時間が掛かります。

(1)　統合トレースログやsyslogファイルを監視する場合の注意事項

JP1/Base V12を新規でインストールすると，イベントサーバ設定ファイル(conf)のoptionsパラメーターに「KAJP1037-syslogoff」と「KAJP1037-hntroff」が初期設定されています。このフラグが設定されていない定義ファイルを別のバージョンからリストアした場合や，このフラグを設定していない状態で別のバージョンから上書きインストールした場合，またはこのフラグを削除した場合にはこのオプションが設定されておりません。「KAJP1037-syslogoff」と「KAJP1037-hntroff」が設定されていない状態でログファイルトラップを使用して統合トレースログやsyslogファイルを監視する場合，転送の失敗が繰り返されることがあります。JP1イベントの転送に失敗した場合，統合トレースログやsyslogファイルに転送失敗のKAJP1037-Eのメッセージが出力されます。統合トレースログやsyslogファイルを監視するために，ログファイルトラップ動作定義ファイルに次のような設定があると，転送失敗のKAJP1037-EのメッセージもJP1イベントに変換されます。

設定例

統合トレースログやsyslogファイルを監視する場合

ACTDEF=<Error>11 "KAJP....-E"
ACTDEF=<Error>11 "-E"

syslogファイルを監視する場合

ACTDEF=<Error>11 "error"

この場合に，JP1/IMのIM構成管理と連携，またはJP1/Baseが提供する構成管理機能を使用していて，転送設定ファイル（forward）を初期設定のまま使用していると，転送失敗のJP1イベントも転送されるため，転送の失敗が繰り返されてしまいます。

この転送の繰り返しを回避するためには，KAJP1037-Eのメッセージをログファイルトラップ機能でトラップしないようにログファイルトラップ動作定義ファイルの設定を変更してください。設定例を次に示します。

設定例1

MARKSTR="KAJP1037-E"

設定例2

ACTDEF=<Error>11 "KAJP....-E"
       !"KAJP1037-E"

(2)　JP1/AJSのログファイル監視ジョブを使用する場合の注意事項

JP1/AJSのログファイル監視ジョブを使用する場合は，JP1/Baseのログファイルトラップ管理サービス（デーモン）とイベントサービスを事前に起動してください。JP1/AJSのログファイル監視ジョブは，JP1/Baseのログファイルトラップ機能を使って実行されます。

ログファイル監視ジョブの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

(3)　WindowsでUnicodeファイルを監視する場合の注意事項

ログファイルトラップを使用してWindowsでUnicodeファイルを監視する場合，動作定義の設定や監視対象ファイルの誤りによって，ログファイルトラップの起動は成功しても，ログファイルを正しく監視できないおそれがあります。

WindowsでUnicodeファイルを監視する場合，次の表に示す正しく監視できないケースではエラーが通知されません。そのため，事前にログファイルトラップの動作（条件どおりにフィルタリングできるか）を確認してください。

表11‒1　WindowsでUnicodeファイルを正しく監視できないケースと事前確認の内容

正しく監視できないケース

事前確認の内容

ログファイルトラップ動作定義ファイルのMARKSTRパラメーターおよびACTDEFパラメーターに，基本正規表現を指定している。

ログファイルトラップ動作定義ファイルのACTDEFパラメーターに，運用で使用する拡張正規表現を指定して，条件どおりにフィルタリングできるか確認する。

ログファイルトラップ動作定義ファイルに，Unicodeファイルを指定している。

ログファイルトラップ動作定義ファイルのACTDEFパラメーターに，マルチバイト文字を指定して，条件どおりにフィルタリングできるか確認する。

監視対象ファイルがUnicodeファイルで，jevlogstartコマンド実行時に-gオプションを指定していない。

jevlogstartコマンドに-gオプションを指定してUnicodeファイルを監視しようとしたが，誤ってUnicodeファイルではないログファイルを指定している。

(4)　SUSE Linux 15以降でsyslogファイルを監視する場合の注意事項

SUSE Linux 15以降でsyslogファイルを監視する場合，デフォルトの設定ではsyslogへのログ出力が行われず，ジャーナルにだけログ出力されます。

ログファイルトラップで，syslogファイルを監視するためには，syslog出力が有効である必要があります。syslog出力を有効化する手順については，「3.4.8　SUSE Linux 15以降で運用する場合のsyslog出力について」を参照してください。

11.2　Windowsのイベントログを変換する

イベントログトラップを使って，WindowsのイベントログをJP1イベントに変換します。初期設定では，Windowsの「イベント ビューア」に表示される「システム ログ」と「アプリケーション ログ」の「エラーログ」および「警告ログ」をJP1イベントに変換する設定になっています。

次にイベントログトラップの設定について説明します。

11.2.1　イベントログトラップを設定する

イベントログトラップの起動，および終了を設定します。イベントログトラップは次に示すファイルで設定します。

イベントログトラップ動作定義ファイル

JP1イベントに変換するイベントログの条件や監視失敗時のリトライなどを設定します。詳細については，「16.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」を参照してください。

(1)　起動する

イベントログトラップを起動する手順を説明します。

イベントログトラップ動作定義ファイル（ntevent.conf）を編集する。

イベントログトラップサービスを起動する。

［コントロールパネル］の［サービス］ダイアログボックスから，「JP1/Base EventlogTrap」の名称のサービスを起動します。

注意事項

登録先イベントサーバが起動していない場合，接続のリトライを設定していなければサービスの起動に失敗します。

イベントログトラップ動作定義ファイル（ntevent.conf）が存在しない，または内容が誤っている場合，サービスの起動に失敗し，イベントログおよび統合トレースログにその情報が出力されます。

イベントログトラップ動作定義ファイル（ntevent.conf）のフィルターに不正なログの種別の指定，または不正な正規表現の指定があった場合，初期設定ではそのフィルターだけを無効として，サービスの起動およびリロードに成功します。フィルターに不正があった場合にサービスの起動およびリロードを失敗とすることもできます。設定の詳細については，「16.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」のfilter-check-levelパラメーターを参照してください。

監視対象はサービスの起動以降に発生したイベントログからになります。サービスの起動以前に発生したイベントログは監視対象にはできません。

Windowsのイベントログサービスを再起動する場合は，イベントログトラップサービスも合わせて再起動してください。

(2)　設定を変更する

イベントログトラップ動作定義ファイル（ntevent.conf）を編集する。

変更を反映する。

serverパラメーターを変更した場合

イベントログトラップサービスを再起動してください。

serverパラメーター以外を変更した場合

イベントログトラップサービスを停止しないで，jeveltreloadコマンドを実行して設定を反映してください。

(3)　設定内容を確認する

稼働しているイベントログトラップの動作定義情報を確認したい場合は，次のコマンドを実行してください。画面にイベントログトラップ動作定義ファイル（ntevent.conf）の形式で出力されます。

jbsgetopinfo -o evttrap

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

(4)　終了する

イベントログトラップを停止する場合は，イベントログトラップサービスを停止します。［コントロールパネル］の［サービス］ダイアログボックスから，「JP1/Base EventlogTrap」の名称のサービスを停止してください。

注意事項

OSのシャットダウン時にJP1/Baseイベントログトラップ機能より先にWindowsイベントログサービスが停止することがあります。この場合，イベントログトラップ機能で受信したデータの変換に失敗し，JP1イベント登録対象のものが登録されないか，またはJP1イベント登録対象外のものが登録されることがあります。この現象は，OSシャットダウンより先にイベントログトラップサービスを停止すると発生しません。

(5)　自動で起動する

イベントログトラップは，システムを再起動すると停止し，自動で起動しません。システムの再起動時にイベントログトラップを自動で起動させたい場合は，JP1/Baseの起動管理でイベントログトラップサービスが自動起動するように設定します。

起動順序定義ファイル（JP1SVPRM.DAT）で，下記パラメーターの行頭の「#」を削除してください。

#[Jp1BaseEventlogTrap]
#Name=JP1/BaseEventlogTrap
#ServiceName=JP1_Base_EventlogTrap

起動順序定義ファイルの設定の詳細については，「16.　定義ファイル」の「起動順序定義ファイル（Windows限定）」を参照してください。

11.2.2　イベントログトラップの注意事項

(1)　運用時の注意事項

JP1/Base V12を新規でインストールすると，イベントサーバ設定ファイル(conf)のoptionsパラメーターに「KAJP1037-syslogoff」と「KAJP1037-hntroff」が初期設定されています。このフラグが設定されていない定義ファイルを別のバージョンからリストアした場合や，このフラグを設定していない状態で別のバージョンから上書きインストールした場合，またはこのフラグを削除した場合にはこのオプションが設定されておりません。「KAJP1037-syslogoff」と「KAJP1037-hntroff」が設定されていない場合にイベントログトラップ動作定義ファイル（ntevent.conf）と転送設定ファイル（forward）を使用する場合の注意事項および対策について説明します。

JP1/IMのIM構成管理と連携，またはJP1/Baseが提供する構成管理機能を使用していて，イベントログトラップ動作定義ファイル（ntevent.conf）と転送設定ファイル（forward）を初期設定のまま使用した場合，JP1イベントの転送に失敗するとKAJP1037-Eのメッセージがイベントログに出力され，JP1イベントに変換されます。変換されたJP1イベントは再度転送され，転送の失敗が繰り返されます。この転送の繰り返しを回避するためには，KAJP1037-Eのメッセージをトラップしないように，イベントログトラップ動作定義ファイル（ntevent.conf）の設定を変更してください。イベントログトラップ動作定義ファイルの設定例については，「16.定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」を参照してください。

(2)　JP1/AJSのWindowsイベントログ監視ジョブを使用する場合の注意事項

JP1/AJSのWindowsイベントログ監視ジョブを使用する場合，イベントログトラップサービスを起動してください。JP1/AJSのWindowsイベントログ監視ジョブは，JP1/Baseのイベントログトラップが前提となっています。

また，JP1/AJSで監視するイベントの条件を含むように，イベントログトラップ動作定義ファイル（ntevent.conf）を設定してください。JP1/AJSで監視するイベントの条件は，JP1/AJSで定義した設定とイベントログトラップ動作定義ファイル（ntevent.conf）で定義した設定の論理積となります。Windowsイベントログ監視ジョブの詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

(3)　リモートから転送されてきたイベントログについての注意事項

イベントログトラップでは，リモートマシンで発生したイベントログをJP1イベントへ正常に変換できません。リモートマシンで発生したイベントログは，発生元のマシン上のイベントログトラップで変換してください。

(4)　その他の注意事項

JIS第3，第4水準の文字があるイベントログデータをイベントログトラップ機能が読み込んだ場合，イベントログトラップ機能は，該当文字を「?」に置換えてJP1イベントを登録します。

イベントログトラップ機能で変換したJP1イベントの属性には，基本的にイベントビューアの全般タブで確認できる内容と同等の値が設定されますが，オペコード（拡張属性A9）についてはイベントビューアの全般タブで確認できる内容と異なる場合があります。

12　イベントサービスの定義情報の収集と配布（JP1/IM限定）

この章では，JP1/BaseとJP1/IMで構成されたシステム内のイベントサービスの定義情報をマネージャーホストで一括収集する方法と，各管理ホストに配布する方法について説明します。

12.1　定義情報・稼働情報の通信を設定する（IM構成管理連携）

JP1/IMのIM構成管理と連携すると，JP1/Baseの定義情報や稼働情報をIM構成管理・ビューアーから管理できます。IM構成管理との連携については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

IM構成管理と連携する場合は，ホストアクセス制限定義ファイルにアクセスできるホストを設定しておく必要があります。ホストアクセス制限定義ファイルで設定されたホストからのアクセスは許可されますが，設定されていないホストからのアクセスはすべて拒否されます。ホストアクセス制限定義ファイルについては，「16.　定義ファイル」の「ホストアクセス制限定義ファイル」を参照してください。

12.2　システムの階層構成の設定

JP1/BaseおよびJP1/IMで構成されたシステムの階層構成を管理するための設定については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」のIM構成管理を使用する場合のシステムの階層構成の設定，およびIM構成管理を使用しない場合のシステムの階層構成の設定について説明している個所を参照してください。

ここでは，システムの階層構成を設定する際の構成定義情報の配布方式を指定する手順について説明します。

12.2.1　構成定義情報の配布方式を指定する

構成定義情報の配布方式を指定する手順を次に示します。なお，構成定義情報の配布方式は，jbsrt_distribコマンドのオプションで明示的に配布方式を指定することもできます。jbsrt_distribコマンドの詳細については，「15.　コマンド」の「jbsrt_distrib」を参照してください。

共通定義設定用ファイル（構成管理機能）のモデルファイル（jbsrt_setup.conf.model）を任意のファイル名でコピーする。

コピーした共通定義設定用ファイル（構成管理機能）を編集する。

配布方式を差分配布方式にする場合は，JBSRT_DISTRIB_VERSIONパラメーターに1を指定します。配布方式を一括配布方式にする場合は，JBSRT_DISTRIB_VERSIONパラメーターに0を指定します。

ここでは，差分配布方式にする場合の定義を次に示します。

[JP1_DEFAULT¥JP1BASE¥JBS_ROUTE]
"JBSRT_DISTRIB_VERSION"=dword:00000001

共通定義設定用ファイル（構成管理機能）の詳細については，「16.　定義ファイル」の「共通定義設定用ファイル（構成管理機能）」を参照してください。

jbssetcnfコマンドを実行する。

手順2で編集した共通定義設定用ファイル（構成管理機能）を指定して，jbssetcnfコマンドを実行します。

jbssetcnf 手順2で編集したファイル名

共通定義設定用ファイル（構成管理機能）の設定内容が共通定義情報に反映されます。

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

jbs_spmd_reloadコマンドを実行するか，JP1/Baseを再起動して，共通定義情報の設定を有効にする。

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

これ以降，構成定義情報の更新は手順2で指定した設定で処理されます。

12.3　イベントサービスの定義情報を収集する

マネージャーホストで収集コマンド（jevdef_get）を実行すると，JP1/IMのシステム構成で定義したすべての管理対象ホストから，指定した定義ファイルの定義情報を収集し標準出力します。jevdef_getコマンドの詳細については，「15.　コマンド」の「jevdef_get」を参照してください。

注意事項

jevdef_getコマンド実行時に，収集先ホストで何らかのエラーが発生し定義情報が収集できなかった場合は，エラーメッセージが標準エラー出力され，エラーが発生したホストの定義情報は標準出力されません。

jevdef_getコマンド実行時に収集先ホストから返されるメッセージは，各ホストで設定されている言語種別で出力されます。言語種別設定の手順については，「3.4.2　使用する言語種別を設定する（UNIXの場合）」を参照してください。

12.3.1　出力形式

収集した定義情報は次のように出力されます。

# JP1/Base - Event Server ファイルの種類-information by jevdef_get
# Time which acquired the following definitions : 日時

[収集先ホスト1]
定義情報
[収集先ホスト2]
定義情報
　　　：

「ファイルの種類」には，収集対象の定義ファイル名が表示されます。転送設定ファイルの場合はforward，イベントログトラップ動作定義ファイルの場合はevent log trap，ログファイルトラップ動作定義ファイルの場合はlog file trapが表示されます。

「定義情報」には，#や空行を含めた定義ファイル内のすべての情報が表示されます。

12.3.2　収集例

転送設定ファイル（forward）の定義情報を収集した場合の収集例を次に示します。

# JP1/Base - Event Server forward-information by jevdef_get
# Time which acquired the following definitions : 2003/07/21 15:23:22

[SubHost_A]
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
end-to

[SubHost_B]
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
end-to

[SubHost_C]
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
end-to

[JP1host_1]
to SubHost_A
E.SEVERITY IN Error Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
end-to

[JP1host_2]
to SubHost_A
E.SEVERITY IN Error Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
end-to

12.4　イベントサービスの定義情報を配布する

マネージャーホストで定義した情報を管理対象ホストへ配布する方法について説明します。配布対象のホストは，マネージャーホストのJP1/IM - Managerのシステム構成で定義した管理対象ホストです。すべての管理対象ホストや特定の管理対象ホストに配布できます。

管理対象ホストへ定義情報を配布する手順を次に示します。

配布定義ファイルを編集する。

配布定義ファイルには，配布先ホストと，配布したい定義情報を定義します。配布定義ファイルは，配布対象の定義ファイルごとに作成する必要があります。

配布定義ファイルについては，「16.　定義ファイル」の「配布定義ファイル」を参照してください。

jevdef_distribコマンドを実行する。

定義情報が配布され，設定が反映されます。jevdef_distribコマンドの詳細については，「15.　コマンド」の「jevdef_distrib」を参照してください。

注意事項

jevdef_distribコマンド実行時に，配布先のホストですでに定義情報が設定されていた場合は，いったん定義ファイルの情報を削除してから定義情報を配布します。

jevdef_distribコマンド実行時に配布先ホストから返されるメッセージは，各ホストで設定されている言語種別で出力されます。言語種別設定の手順については，「3.4.2　使用する言語種別を設定する（UNIXの場合）」を参照してください。なお，日本語のマネージャーから日本語のエージェントに配布する場合で設定されている文字コードが異なるとき，配布定義ファイルの文字コードは自動的に変換されます。

13　ローカルアクションの設定

JP1/Baseでは，障害発生時など特定のJP1イベントを契機に，あらかじめ登録したコマンドを自動的に実行するローカルアクションを利用できます。

この章では，JP1/Baseのローカルアクションを使うための設定方法について説明します。

13.1　ローカルアクションを設定する

13.1.1　ローカルアクションを定義する

ローカルアクションを定義する手順を次に示します。

共通定義情報にローカルアクションを定義する情報を登録する。

1-1　共通定義設定用ファイル（ローカルアクション機能）のモデルファイル（jp1bs_lcact_setup.conf.model）を任意のファイル名でコピーする。

1-2　コピーしたファイルを編集する。

1-3　次のコマンドを実行する。

jbssetcnf 1-2で編集したファイル名

ローカルアクションの定義情報が共通定義情報に登録されます。

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

共通定義設定用ファイル（ローカルアクション機能）の詳細については，「16.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。共通定義設定用ファイル（ローカルアクション機能）に誤りがあった場合は，設定項目は無効とし，共通定義情報に設定していないときの値で動作します。

ローカルアクション実行定義ファイル（jbslcact.conf）を作成・編集する。

ローカルアクション実行定義ファイルでは，次の項目を必ず定義してください。

ローカルアクションの実行条件

JP1ユーザー名

実行するコマンド

これ以外の項目については，必要に応じて定義してください。ローカルアクション実行定義ファイルの詳細については，「16.　定義ファイル」の「ローカルアクション実行定義ファイル」を参照してください。ローカルアクション実行定義ファイルに誤りがあった場合，コマンドは実行されません。

JP1ユーザーのユーザーマッピングを設定する。

各アクションを実行するために必要なJP1ユーザーのユーザーマッピングを設定します。ユーザーマッピングの設定方法については，「8.1　ユーザー管理の設定（Windowsの場合）」または「8.3　ユーザー管理の設定（UNIXの場合）」を参照してください。

ローカルアクション環境変数ファイルを編集する。

ローカルアクションの実行コマンドを実行するために必要な環境変数を定義します。ローカルアクション環境変数ファイルの詳細については，「16.　定義ファイル」の「ローカルアクション環境変数ファイル」を参照してください。ローカルアクション環境変数ファイルに誤りがあった場合，コマンドは実行されません。

ローカルアクションの定義を有効にする。

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

13.1.2　ローカルアクションの設定を変更する

ローカルアクションの実行条件や実行コマンドを変更する場合に設定を変更します。

ローカルアクション実行定義ファイル（jbslcact.conf）を編集する。

ローカルアクション実行定義ファイルの詳細については，「16.　定義ファイル」の「ローカルアクション実行定義ファイル」を参照してください。

ローカルアクション実行定義ファイル（jbslcact.conf）の設定内容を有効にする。

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

設定内容は，再起動後に発生したローカルアクションから有効になります。

ローカルアクション実行定義ファイル（jbslcact.conf）に誤りがありエラーとなった場合，ローカルアクションは休止になります。

13.1.3　ローカルアクションの動作状況を確認する

ローカルアクションによって実行されたアクションの動作状況を確認したい場合は，次のコマンドを実行して確認してください。

jbslistlcact

実行中または実行待ち状態にあるアクションの情報が出力されます。

実行中または実行待ち状態にあるアクションをキャンセルしたい場合は，次のコマンドを実行してキャンセルしてください。

jbscancellcact

コマンドで指定したアクションがキャンセルされます。実行中のアクションをキャンセルした場合，生成された子プロセスもキャンセルされます。

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

13.1.4　ローカルアクションを休止する

マシンメンテナンスなどの作業をする場合，ローカルアクションを一時的に休止します。

ローカルアクションを定義したときに使用した共通定義設定用ファイル（ローカルアクション機能）を編集する。

PAUSEパラメーターに00000001（休止する）を設定します。共通定義設定用ファイル（ローカルアクション機能）の詳細については，「16.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。

次のコマンドを実行する。

jbssetcnf 1で編集したファイル名

ローカルアクションを休止するように設定された情報が共通定義情報に登録されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

設定した共通定義情報の内容を有効にする。

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

ローカルアクションを休止した場合，ローカルアクションのプロセスは起動したままで，イベントの取得を中止します。実行中または実行待ち状態にあるアクションはキャンセルされません。

ローカルアクションの休止を解除して起動した場合，解除以降に登録されたイベントからアクションの対象となります。ローカルアクションの休止を解除する設定については，「16.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。

13.2　ローカルアクションの運用例

この節は，次の図に示すようなシステム構成で，ログファイルのオーバーフローを示すJP1イベント（イベントID：999）が発生した場合に，ログファイルを退避させたり，資料採取ツールを起動させたりするなどの処理コマンドをまとめて記述したバッチファイル（ID999_operation.bat）を実行するローカルアクションを想定しています。

図13‒1　ローカルアクションの運用例

13.2.1　ローカルアクション実行定義ファイルを設定する

まず，ローカルアクション実行定義ファイルを設定します。

ローカルアクション実行定義ファイルに設定する内容

ログファイルのオーバーフローを通知するJP1イベント（イベントID：999）が発生したら，ログファイルのオーバーフローに対処する処理を記述したバッチファイル（ID999_operation.bat）を実行するように設定する。

バッチファイルの実行権限を持つOSユーザーで実行するため，OSユーザーがマッピングされているJP1ユーザー名（jp1user01）を設定する。

このアクションが動作したことをマネージャーホストへ通知するため，ローカルアクションの開始と完了を知らせるJP1イベントの発行を設定し，マネージャーホストへ転送する。

ローカルアクション実行定義ファイルの設定例

# JP1イベントID:999の対処
act ID999_action
  cnd
    B.ID IN 999
  end-cnd
  usr jp1user01
  cmd "D:¥EventOperation¥ID999_operation.bat"
  evt yes/yes
end-act

設定したローカルアクション実行定義ファイルを有効にする手順については，「13.1.1　ローカルアクションを定義する」を参照してください。

13.2.2　転送設定ファイルを設定する

アクション開始イベントおよびアクション完了イベントを上位のマネージャーホストへ転送するために，イベントサービスの転送設定ファイルを設定します。

転送設定ファイルに設定する内容

アクション開始イベント（00004780），アクション完了イベント（00004781），アクション完了イベント（実行不可）（00004782），アクション完了イベント（キャンセル）（00004783）をエージェントホストから上位のサブマネージャーホストへ転送するように設定する。

さらに，サブマネージャーホストから上位のマネージャーホストへ転送するように設定する。

転送設定ファイルの設定例

# ローカルアクションのイベント転送
to-upper
  B.ID RANGE 4780 4783
end-to

設定した転送設定ファイルを有効にする手順については，「10.1.3　イベントサービス環境を設定する」を参照してください。

13.3　ローカルアクションの注意事項

ローカルアクションによるコマンド実行から直接OSをシャットダウンするコマンド（shutdownやhaltなど）は使用しないでください。

ローカルアクションでは次のようなコマンドは実行できません。

対話操作を必要とするコマンド

画面を表示するコマンド

エスケープシーケンスや制御コードを伴うコマンド

デーモンなどの終了しないコマンド

Windowsメッセージ機構やDDEなど，デスクトップとの対話が必要なコマンド（Windowsの場合）

標準入力からデータ入力されるコマンド

KNAM3208-Iのメッセージに出力されるコマンド出力結果は，メッセージテキストを含め最大4095バイトまでです。また，出力結果に制御文字がある場合は半角スペースに置換されます。

Windowsで実行中のアクションをキャンセルした場合，強制終了されるのはJP1/Baseが起動したプロセスだけです。

CPU使用率が高い場合やユーザーポート枯渇時など，システム負荷が高い状態でJP1/Baseを停止した場合に，アクションで実行されたコマンドが一部残ってしまう場合があります。このような状態を回避するために，ローカルアクションを利用する際は，次のような運用をしてください。

ローカルアクションの負荷を減らすため，同時実行数を少なくする。

アクションによってさらにアクション条件が成立するような運用は避ける。

1つのアクションで，多数のコマンドが実行されるようなバッチファイルの運用は避ける。

ローカルアクションのサービス（jbslcactプロセス）は起動時にイベントサービスに接続します。接続できない場合は休止状態となりますので，クラスタシステムで運用する場合はJP1/Baseのサービスよりイベントサービスが先に起動するようにしてください。

ローカルアクションのアクションの対象となるイベントはローカルアクション機能が開始された後に登録されたイベントです。ローカルアクション開始処理中，ローカルアクション休止中，およびフェールオーバー中に登録されたイベントは対象となりません。

ローカルアクションは，次の処理によりコマンドを実行します。

Windowsの場合

「cmd.exe /c 実行コマンド」をローカルアクションにより実行します。

UNIXの場合

OSユーザーのログインシェルを使って，例えば「/bin/sh -c 実行コマンド」（ログインシェルが/bin/shの場合）をローカルアクションから実行します。

なお，ログインシェルとして「/sbin/false」，「/bin/false」，「/bin/true」，「/sbin/nologin」などが設定されている場合は正常に実行できません。

また，OSユーザーのパスワードは意識していませんので,アカウントロックなどは意識しません。

14　JP1/Base運用中の設定変更

この章では，JP1/Base運用中にJP1/Baseの設定を変更した場合に，変更内容が反映される契機と，JP1/Baseの運用中にIPアドレスやホスト名などのシステム環境を変更した場合に必要な作業について説明します。

14.1　JP1/Baseの設定を変更する

運用中にJP1/Baseの設定を変更した場合に，変更内容が反映される契機を表に示します。設定方法の詳細については，参照先に記載しています。

14.1.1　変更内容が反映される契機

(1)　JP1/Baseの障害対処の設定が反映される契機

項番

設定が反映される契機

参照先

1

異常終了したプロセスの再起動の設定を変更した場合，JP1/Baseを再起動するか，リロードコマンドを実行すると設定が反映されます。

4.

2

プロセス管理機能が制御するプロセスの異常終了時，および認証サーバ切り替え発生時にJP1イベントを発行させる設定を変更した場合，コマンドの実行後，JP1/BaseおよびJP1/Baseを前提とする製品（JP1/IM，JP1/AJS）を再起動します。

4.

(2)　ユーザー管理の設定が反映される契機

項番

設定が反映される契機

参照先

1

認証サーバは，JP1製品がJP1/Baseのユーザー認証を利用する機能を実行中でなければ，JP1/Baseが起動している状態で変更できます。

GUIの［OK］ボタンをクリックした時点，またはコマンドを実行した時点で設定が反映されます。

Windowsの場合

8.1.1

UNIXの場合

8.3.1

2

JP1ユーザーの設定は，認証サーバが起動していれば，いつでも変更できます。

GUIの［OK］ボタンをクリックした時点，またはコマンドを実行した時点で設定が反映されます。ただし，設定を変更したJP1ユーザーがログイン中の場合は，次にログインした時点で設定が反映されます。

JP1/Baseを再起動する必要はありません。

Windowsの場合

8.1.2，8.2.1(2)

UNIXの場合

8.3.2

3

JP1資源グループ別権限レベルの設定は，認証サーバが起動していれば，いつでも変更できます。

GUIの［OK］ボタンをクリックした時点，またはコマンドを実行した時点で設定が反映されます。

JP1/Baseを再起動する必要はありません。

Windowsの場合

8.1.3

UNIXの場合

8.3.3

4

セカンダリー認証サーバを設置する場合，プライマリー認証サーバの設定ファイルをセカンダリー認証サーバにコピーすると設定が有効になります。

Windowsの場合

8.1.4

UNIXの場合

8.3.4

5

ディレクトリサーバと連携したユーザー認証の設定は，認証サーバが起動していれば，いつでも変更できます。

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）を変更し，コマンドを実行した時点で設定が反映されます。

8.2.1(1)

6

ユーザーマッピングを設定する場合，JP1/Baseを停止する必要はありません。

GUIの［OK］ボタンをクリックした時点，またはコマンドを実行した時点で設定が反映されます。

Windowsの場合

8.1.6，8.1.7

UNIXの場合

8.3.5

(3)　サービスの起動順序および終了順序の設定（Windows限定）が反映される契機

項番

設定が反映される契機

参照先

1

起動順序定義ファイル（JP1SVPRM.DAT）を変更した場合，Windowsの再起動後に設定が反映されます。

起動順序定義ファイル（Windows限定）

(4)　イベントサービス環境の設定が反映される契機

項番

設定が反映される契機

参照先

1

イベントサーバインデックスファイル（index）はイベントサービスの停止中に設定を変更します。その後,イベントサービスを起動する時に設定が反映されます。

イベントサーバインデックスファイル

2

イベントサーバ設定ファイル（conf）の設定を変更した場合，イベントサービスを再起動すると設定が反映されます。

イベントサーバ設定ファイル

3

転送設定ファイル（forward）の設定を変更した場合，リロードコマンドを実行すると設定が反映されます。

転送設定ファイル

4

API設定ファイル（api）の設定を変更した場合，JP1/Baseのイベント変換機能や，イベントサービスと連携するJP1/IMやJP1/AJSなどのプログラムを起動または再起動すると，設定が反映されます。

API設定ファイル

(5)　イベント変換の設定が反映される契機

項番

設定が反映される契機

参照先

1

ログファイルトラップ動作定義ファイルの設定を変更した場合，リロードコマンドを実行すると一部のパラメーターの定義が反映されます。

ログファイルトラップ動作定義ファイル

2

イベントログトラップ動作定義ファイル（ntevent.conf）の設定を変更した場合，リロードコマンドを実行すると定義が反映されます。

イベントログトラップ動作定義ファイル（Windows限定）

(6)　ヘルスチェック機能の設定が反映される契機

項番

設定が反映される契機

参照先

1

ヘルスチェック定義ファイル（jbshc.conf）の設定内容を変更した場合，JP1/Baseを再起動するか，jbs_spmd_reloadコマンドを実行すると設定が反映されます。

ヘルスチェック定義ファイル

(7)　統合トレース機能の設定が反映される契機

項番

設定が反映される契機

参照先

1

統合トレース機能を再起動すると設定が反映されます。

hntr2util（Windows限定），

hntr2util（UNIX限定），

hntr2utl2（Windows限定），

hntr2utl2（UNIX限定），

hntr2conf，

hntr2getconf

(8)　通信設定が反映される契機

項番

設定が反映される契機

参照先

1

jp1hosts情報を変更した場合は，コマンドを実行したあとJP1/Baseを再起動すると設定が反映されます。

6.5.2

2

jp1hosts2情報を変更した場合は，コマンドを実行したあと設定が反映されます。

ただし，次の場合はコマンドを実行したあとJP1/Baseを再起動すると設定が反映されます。

jp1hosts2情報の自ホストのIPアドレスの割り当てを変更した場合

jp1hosts2情報のすでに通信中の他ホストのIPアドレスを変更した場合

6.6.2

3

JP1/Baseの通信方式を変更した場合は，コマンドを実行したあとに，JP1/Base，JP1/Baseを前提とする製品（JP1/IM，JP1/AJS），およびJP1/Baseと依存関係のあるプログラムを再起動すると設定が反映されます。

6.3

4

イベントサービスの通信方式を変更した場合は，JP1/Base，JP1/Baseを前提とする製品（JP1/IM，JP1/AJS），およびJP1/Baseと依存関係のあるプログラムを再起動すると設定が反映されます。

6.5.3，6.6.3

(9)　ローカルアクション機能の設定が反映される契機

項番

設定が反映される契機

参照先

1

ローカルアクション実行定義ファイルの設定を変更した場合，JP1/Baseを起動またはリロードすると，設定が反映されます。

ローカルアクション実行定義ファイル

(10)　通信暗号化機能の設定が反映される契機

項番

設定が反映される契機

参照先

1

通信暗号化機能の設定を変更した場合，jbssetcnfコマンドを実行したあとに，JP1/Base，JP1/Baseを前提とする製品（JP1/IM，JP1/AJS），およびJP1/Baseと依存関係のあるプログラムを再起動すると設定が反映されます。

6.13.4

14.2　JP1/Baseが動作するホストの設定を変更する

この節では，JP1/Baseが動作しているマシンのホスト名，IPアドレス，およびシステムの日時を変更した場合の影響と，変更時に必要となる作業について説明します。

14.2.1　ホスト名の変更による影響および必要な作業

(1)　ユーザー認証

認証サーバのホスト名を変更した場合は，Windowsの場合［JP1/Base環境設定］ダイアログボックスの［認証サーバ］タブで，UNIXの場合jbssetusrsrvコマンドで，ホスト名を変更してください。認証サーバのホスト名を変更していなければ，ユーザー認証関係に影響はありません。

(2)　ユーザーマッピング

ユーザーマッピングの場合，変更漏れが発生するおそれがあるため，十分注意して次に示す作業をしてください。

(a)　マネージャー側のホスト名を変更した場合

マネージャーからリモートコマンド実行を出すすべてのエージェントホストで，エージェントホスト上のマッピング定義ファイルの確認をしてください。

マッピング定義ファイルに記述されている"JP1ユーザー名 : サーバホスト名 : ユーザーリスト"の二つ目のフィールドである"サーバホスト名"をマネージャー側のホスト名の変更に伴って変更する必要があります。変更手順を次に示します。

jbsgetumapコマンドを実行して，テキストベースのファイルを取得する。

該当するサーバホスト名を変更後のサーバホスト名に変更する。

変更前の"サーバホスト名"が「*」の場合は，変更する必要はありません。

サーバホスト名を変更した後，jbsmkumapコマンドを実行して，新しい定義情報を登録する。

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

注意事項

サーバホスト名には，hostnameコマンドで表示されるホスト名を指定してください。ただし，DNS運用でドメイン名を使用している場合は，FQDN形式のホスト名の定義も追加してください。

(b)　エージェント側のホスト名を変更した場合

エージェント側のホスト名を変更した場合は，特に影響はありません。

(3)　イベントサービス

イベントサーバ環境設定ファイル（conf）およびAPI設定ファイル（api）に，ホスト名を指定している場合は，漏れがないように修正してください。なお，修正する必要があるのは，ユーザーが設定した部分だけです。初期設定されていた個所については，修正する必要はありません。イベントサービスが自動的にどこかに記憶し，それを修正しないと動作しなくなる，ということはありません。

なお，UNIXでhostnameコマンドを使用してホスト名を変更する際は，イベントサービスを停止してからホスト名を変更してください。イベントサービス稼働中にホスト名を変更するとイベントサービスが停止できなくなります。

電源断などでイベントサービスの停止処理が行われなかった場合，次のファイルが残存している場合があります。次のファイルが残存している場合には，このホストで起動しているイベントサービスをすべて停止した状態で削除してください。ファイルが残存している場合にはJP1/Baseのパッチ適用時にKAJP1028-E，KAJP1049-Eが出力されます。KAJP1028-E，KAJP1049-Eが出力されてもパッチの適用には影響ありません。

Windowsの場合

インストール先フォルダ¥sys¥tmp¥event¥プロセスID.svr

インストール先フォルダ¥sys¥tmp¥event¥プロセスID.lck

UNIXの場合

/var/opt/jp1base/sys/tmp/event/プロセスID.svr

/var/opt/jp1base/sys/tmp/event/プロセスID.lck

(4)　JP1/IM - Managerを利用している場合

イベント検索で「選択イベント条件入力」を使用する場合は，JP1/IM - Managerを使用するマシンから変更前のホスト名も参照できる（例："ping 変更前ホスト名"が成功する）ようにhostsなどが設定されている必要があります。このような操作の必要がなければ，イベントサービスに関する設定を変更する必要は特にありません。

JP1/IM - Managerの場合，システムの構成を構成定義ファイルで設定しています。このため，ホスト名が変更されるたびに，システム構成の再配布（jbsrt_distribコマンドの実行）が必要となります。システム構成の再配布をしないと，JP1イベントが正しく転送されなくなるおそれがあります。システム構成の再配布の方法については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」を参照してください。

注意事項

旧ホスト名のときに発行されたJP1イベントは，ホスト名変更後もJP1/IM - Viewの登録ホスト名には，旧ホスト名が表示されます。検索する場合でも，登録ホスト名の指定は，旧ホスト名がマッチします。また，このようなJP1イベントからJP1/AJSのモニター表示はできません。

(5)　クラスタシステムを運用している場合

クラスタシステムを運用している環境で論理ホスト名を変更した場合は，変更前の論理ホスト名を削除してください。その後，変更後の論理ホスト名に対して，クラスタ運用ができるよう再セットアップしてください。

Windowsの場合

論理ホスト名の削除方法については，「5.7.1　論理ホストの削除（Windowsの場合）」を参照してください。クラスタシステムのセットアップ方法については，「5.4.3　セットアップ」を参照してください。

UNIXの場合

論理ホスト名の削除方法については，「5.7.2　論理ホストの削除（UNIXの場合）」を参照してください。クラスタシステムのセットアップ方法については，「5.5.3　セットアップ」を参照してください。

(6)　統合トレース(HNTRLib2)

ホスト名の変更をした場合，統合トレース(HNTRLib2)の再起動は必須ではありませんが，再起動を行わなかった場合，統合トレースログのヘッダー情報に変更前のホスト名が出力されます。

(7)　jp1hosts定義ファイルまたはjp1hosts2定義ファイル

jp1hosts定義ファイルまたはjp1hosts2定義ファイルを設定している場合は，ホスト名を再設定してください。

14.2.2　IPアドレスの変更による影響および必要な作業

IPアドレスだけを変更した場合は，次に示す作業をしてください。

JP1/Baseを前提としているすべてのプログラムを停止する。

JP1/Baseを停止する。

IPアドレスを変更する。

jp1hosts定義ファイル，jp1hosts2定義ファイル，イベントサーバ設定ファイル，およびAPI設定ファイルなど，それぞれのファイルで設定しているIPアドレスを変更します。IPアドレスの設定が必要な場合と，設定するファイルについては，「6.12　通信設定が必要な場合」を参照してください。

JP1/Baseを起動する。

JP1/Baseを前提としている製品を起動する。

14.2.3　システムの日時変更時に必要な作業

NTP（Network Time Protocol）サーバなどを利用した時刻が過去に戻ることがない方式で，サーバのシステム時刻の時刻合わせる場合は，次の手順に従わないで変更できます。その場合，JP1/Baseを停止する必要はありません。

(1)　変更したシステムの日時を過去に戻す場合

システムの日時を変更する際，過去の日時に変更することは避けてください。

システム時刻の進みや遅れを補正する際でも，システム時刻を過去に戻すと到着時刻を指定したイベント検索が正しくできない場合があります。

テストなどでシステムの時刻を意図的に未来の日時へ変更したような場合に，システム日時を元に戻すときは，次に示す手順で戻してください。なお，JP1/AJSが起動している場合は，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照して変更手順を確認してください。

JP1/IM - Managerを停止する。

JP1/Baseを停止する。

起動管理機能を使用しているすべてのサービスを停止する。

システムの日時を現在日時に戻す。

jevdbinitコマンドでイベントDBを削除する。

JP1/Baseを起動する。

JP1/IM - Managerを起動する。

(2)　システムの時刻が遅れているため，時刻を進める場合

システムの時刻を進める場合，JP1/Baseではサービスを停止する必要はありませんが，JP1/AJSが起動している場合は，JP1/AJSのサービスを停止する必要があります。手順の詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

第5編　リファレンス編

15　コマンド

この章では，JP1/Baseで使用できるコマンドの文法を説明します。

コマンド一覧

JP1/Baseで使用できるコマンドの一覧を次に示します。なお，表中では，Windows，UNIXでの対応を凡例のように表記しています。

（凡例）

○：対応している。

−：対応していない。

スーパーユーザー：Windowsの場合，Administratorsを意味する。

起動管理機能で使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

JP1SVPRM.DATファイルの作成

cpysvprm（Windows限定）

○

−

なし

ネットワーク設定の確認で使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

ネットワーク設定の確認

jp1ping

○

○

なし

JP1/Baseのプロセスの起動・終了およびセットアップなどで使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

統合トレース（HNTRLib2）の起動

hntr2mon（UNIX限定）

−

○

スーパーユーザー

統合トレース（HNTRLib2）の終了

hntr2kill（UNIX限定）

−

○

スーパーユーザー

統合トレース（HNTRLib2）の設定変更

hntr2util（Windows限定）

○

−

スーパーユーザー

hntr2util（UNIX限定）

−

○

スーパーユーザー

hntr2utl2（Windows限定）

○

−

スーパーユーザー

hntr2utl2（UNIX限定）

−

○

スーパーユーザー

hntr2conf

○

○

スーパーユーザー

統合トレース（HNTRLib2）の設定表示

hntr2getconf

○

○

なし

統合トレース（HNTRLib2）を利用するPP名称の出力

hntr2getname（Windows限定）

○

−

スーパーユーザー

JP1/Baseのセットアップ

jp1base_setup（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスを含めたJP1/Baseの起動

jbs_start（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスを含めたJP1/Baseの終了

jbs_stop（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスを除くJP1/Baseのプロセスの起動

jbs_spmd（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスを除くJP1/Baseのプロセスの終了

jbs_spmd_stop

○

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスを除くJP1/Baseのプロセスの状態確認

jbs_spmd_status

○

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスを除くJP1/Baseのプロセスの再読み込み処理

jbs_spmd_reload

○

○

スーパーユーザーまたはJP1/Base管理者

クラスタシステムで運用するための設定

jp1bshasetup（Windows限定）

○

−

スーパーユーザー

jp1base_setup_cluster（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

jbs_setup_cluster（Windows限定）

○

−

スーパーユーザー

クラスタシステムでの起動

jbs_start.cluster（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

クラスタシステムでの終了

jbs_stop.cluster（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

クラスタシステムで運用中のJP1/Baseプロセスの強制終了

jbs_killall.cluster（UNIX限定）

−

○

スーパーユーザー

JP1/Base管理者コンソールの起動

jbsadmin（Windows限定）

○

−

スーパーユーザー

バージョンアップに関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

バージョン7以前のJP1/Baseのコマンド実行履歴をバージョン8以降用のコマンド実行履歴ファイルに移行する

jcocmdconv

○

○

スーパーユーザー

ユーザー管理機能で使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

認証サーバの設定

jbssetusrsrv（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

jbssetupsrv（Windows限定）

○

−

スーパーユーザー

認証サーバの確認

jbslistsrv

○

○

スーパーユーザーまたはJP1/Base管理者

認証サーバの閉塞

jbsblockadesrv

○

○

スーパーユーザーまたはJP1/Base管理者

認証サーバの閉塞解除

jbsunblockadesrv

○

○

スーパーユーザーまたはJP1/Base管理者

JP1ユーザーの登録

jbsadduser

○

○

スーパーユーザーまたはJP1/Base管理者

JP1ユーザーの削除

jbsrmuser

○

○

スーパーユーザーまたはJP1/Base管理者

登録したJP1ユーザーの表示

jbslistuser

○

○

スーパーユーザーまたはJP1/Base管理者

登録済みJP1ユーザーのパスワードの変更

jbschgpasswd

○

○

スーパーユーザーまたはJP1/Base管理者

JP1ユーザーおよびDSグループの操作権限の登録

jbssetacl

○

○

スーパーユーザーまたはJP1/Base管理者

JP1ユーザーまたはDSグループの操作権限の削除

jbsrmacl

○

○

スーパーユーザーまたはJP1/Base管理者

登録したJP1ユーザーまたはDSグループの操作権限の表示

jbslistacl

○

○

スーパーユーザーまたはJP1/Base管理者

JP1/Base管理者の設定

jbssetadmingrp（UNIX限定）

−

○

スーパーユーザー

マッピング情報の生成，共通定義への登録

jbsmkumap

○

○

スーパーユーザーまたはJP1/Base管理者※

マッピング情報の個別登録

jbssetumap

○

○

スーパーユーザーまたはJP1/Base管理者※

マッピング情報の個別削除

jbsrmumap

○

○

スーパーユーザーまたはJP1/Base管理者

登録済みマッピング情報の一覧表示

jbsgetumap

○

○

スーパーユーザーまたはJP1/Base管理者

OSユーザーまたは情報検索用ユーザーのパスワード管理情報のメンテナンス用プログラム

jbspassmgr（Windows限定）

○

−

スーパーユーザー

OSユーザーまたは情報検索用ユーザーの個別登録，個別パスワード情報変更

jbsumappass（Windows限定）

○

−

スーパーユーザー

OSユーザーまたは情報検索用ユーザーの個別削除

jbsrmumappass（Windows限定）

○

−

スーパーユーザー

OSユーザーまたは情報検索用ユーザーのパスワード情報の共通定義への一括登録

jbsmkpass（Windows限定）

○

−

スーパーユーザー

認証サーバの操作権限に関する定義情報の表示

jbsacllint

○

○

スーパーユーザーまたはJP1/Base管理者

認証サーバの操作権限に関する定義情報の再読み込み

jbsaclreload

○

○

スーパーユーザーまたはJP1/Base管理者

連携するディレクトリサーバの変更

jbschgds（Windows限定）

○

−

スーパーユーザー

連携するディレクトリサーバの設定確認

jbschkds（Windows限定）

○

−

スーパーユーザー

注※　マッピング情報にスーパーユーザーを設定する場合は，スーパーユーザー権限が必要です。JP1/Base管理者権限だとエラーになります。

イベントサービスで使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

転送設定ファイルのリロード

jevreload

○

○

スーパーユーザーまたはJP1/Base管理者

イベントDBの初期化

jevdbinit

○

○

スーパーユーザーまたはJP1/Base管理者

重複防止テーブルの再構築

jevdbmkrep

○

○

スーパーユーザーまたはJP1/Base管理者

イベントDBの切り替え

jevdbswitch

○

○

スーパーユーザーまたはJP1/Base管理者

イベントDBのcsvファイルへの出力

jevexport

○

○

なし

イベントサーバのサービスの追加登録

jevregsvc（Windows限定）

○

−

スーパーユーザー

手動でのイベントサービスの起動

jevstart（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

手動でのイベントサービスの終了

jevstop（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスの状態確認

jevstat

○

○

スーパーユーザーまたはJP1/Base管理者

イベントサーバへのJP1イベントの登録

jevsend

○

○

なし

イベントサーバへのJP1イベントの登録および到達確認

jevsendd

○

○

なし

イベントログトラップ動作定義ファイルのリロード

jeveltreload（Windows限定）

○

−

スーパーユーザー

ログファイルトラップ管理デーモンの起動

jevlogdstart（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

ログファイルトラップ管理デーモンの終了

jevlogdstop（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

ログファイルトラップ管理サービス（デーモン）の状態確認

jevlogdstat

○

○

スーパーユーザーまたはJP1/Base管理者

ログファイルトラップの起動

jevlogstart

○

○

スーパーユーザーまたはJP1/Base管理者

ログファイルトラップの終了

jevlogstop

○

○

スーパーユーザーまたはJP1/Base管理者

ログファイルトラップの起動（クラスタ運用限定）

jevlogstart（クラスタ運用限定）

○

○

スーパーユーザーまたはJP1/Base管理者

ログファイルトラップの終了（クラスタ運用限定）

jevlogstop（クラスタ運用限定）

○

○

スーパーユーザーまたはJP1/Base管理者

ログファイルトラップ動作定義ファイルのリロード

jevlogreload

○

○

スーパーユーザーまたはJP1/Base管理者

ログファイルトラップの状態確認

jevlogstat

○

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスの定義情報の収集

jevdef_get

○

○

スーパーユーザーまたはJP1/Base管理者

イベントサービスの定義情報の配布

jevdef_distrib

○

○

スーパーユーザーまたはJP1/Base管理者

イベント転送抑止，イベント転送抑止の解除，イベント転送抑止状態の表示

jevagtfw

○

○

スーパーユーザーまたはJP1/Base管理者

イベント転送抑止条件ごとのイベント転送抑止状態の表示

jevfwstat

○

○

スーパーユーザーまたはJP1/Base管理者

属性付加設定ファイルのリロード

jevextreload

○

○

スーパーユーザーまたはJP1/Base管理者

Windowsイベントログに出力するメッセージIDの変更

jevmessageid.bat（Windows限定）

○

−

スーパーユーザー

ISAMファイル（索引順編成ファイル）の操作および保守に関するユーティリティコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

キーの追加，削除，再構築

Jiskeymnt

○

○

スーパーユーザーまたはJP1/Base管理者

ファイルの変換

Jisconv

○

○

スーパーユーザーまたはJP1/Base管理者

ファイルの検証

Jischk

○

○

スーパーユーザーまたはJP1/Base管理者

ファイルの抽出

Jisext

○

○

スーパーユーザーまたはJP1/Base管理者

リソースの設定支援

Jislckreg（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

レコード内容の表示

Jisprt

○

○

スーパーユーザーまたはJP1/Base管理者

リソースの削除

Jisrsdel（UNIX限定）

−

○

スーパーユーザー

キー定義情報の表示

Jisinfo

○

○

スーパーユーザーまたはJP1/Base管理者

ファイルの圧縮

Jiscond

○

○

スーパーユーザーまたはJP1/Base管理者

ロックテーブルの拡張

Jislckext

○

○

スーパーユーザー

ロックテーブル情報の表示

Jismlcktr（Windows限定）

○

−

スーパーユーザー

ロックエントリー情報の削除

Jislckfree（Windows限定）

○

−

スーパーユーザー

ファイル・レコード占有状態の確認，解除

Jislckclear（Windows限定）

○

−

スーパーユーザー

ファイルのコピー

Jiscpy

○

○

スーパーユーザーまたはJP1/Base管理者

レコードの抽出

Jisktod

○

○

スーパーユーザーまたはJP1/Base管理者

稼働情報および共通定義情報の採取，登録，および削除コマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

稼働情報の採取

jbsgetopinfo

○

○

スーパーユーザーまたはJP1/Base管理者

共通定義情報の採取

jbsgetcnf

○

○

スーパーユーザーまたはJP1/Base管理者

共通定義情報の登録

jbssetcnf

○

○

スーパーユーザーまたはJP1/Base管理者

共通定義情報の削除

jbsunsetcnf

○

○

スーパーユーザーまたはJP1/Base管理者

JP1独自のhosts情報に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

jp1hosts情報の登録

jbshostsimport

○

○

スーパーユーザーまたはJP1/Base管理者

jp1hosts2情報の登録

jbshosts2import

○

○

スーパーユーザーまたはJP1/Base管理者

jp1hosts情報の確認

jbshostsexport

○

○

スーパーユーザーまたはJP1/Base管理者

jp1hosts2情報の確認

jbshosts2export

○

○

スーパーユーザーまたはJP1/Base管理者

JP1/Baseの設定情報の一括収集およびトラブルシューティングで使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

JP1/Baseの設定情報の一括収集

jbsparamdump

○

○

スーパーユーザーまたはJP1/Base管理者

障害発生時の資料の採取

jbs_log.bat（Windows限定）

○

−

スーパーユーザー

jbs_log.sh（UNIX限定）

−

○

スーパーユーザーまたはJP1/Base管理者

構成定義に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

JP1/IMの構成定義情報の下位ホストへの配布

jbsrt_distrib

○

○

スーパーユーザーまたはJP1/Base管理者

JP1/IMの下位ホストからの構成定義情報の収集，および更新

jbsrt_sync

○

○

スーパーユーザーまたはJP1/Base管理者

JP1/IMの構成定義情報の削除

jbsrt_del

○

○

スーパーユーザーまたはJP1/Base管理者

JP1/IMの構成定義情報の表示

jbsrt_get

○

○

スーパーユーザーまたはJP1/Base管理者

ローカルアクション，自動アクション，およびコマンド実行に関するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

実行待ちおよび実行中のローカルアクションの一覧出力

jbslistlcact

○

○

スーパーユーザーまたはJP1/Base管理者

実行待ちおよび実行中のローカルアクションのキャンセル

jbscancellcact

○

○

スーパーユーザーまたはJP1/Base管理者

JP1/IMのコマンド実行環境の設定

jcocmddef

○

○

スーパーユーザーまたはJP1/Base管理者

JP1/IMから実行したコマンドの履歴の出力

jcocmdlog

○

○

なし

JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドの削除

jcocmddel

○

○

スーパーユーザーまたはJP1/Base管理者

JP1/IM - Viewから実行したコマンド，自動アクションで実行したコマンドの状態確認

jcocmdshow

○

○

スーパーユーザーまたはJP1/Base管理者

通信暗号化で使用するコマンド

機能概要

コマンド名

Windows

UNIX

必要な実行権限

OpenSSLが提供しているコマンド

openssl

○

○

OpenSSLの公式サイトを参照してください。

なお，以降のコマンドの説明では，コマンドはアルファベット順に記載されています。

JP1/Base管理者コンソール（Windowsの場合）

JP1/Base管理者コンソールの概要

JP1/Baseでは実行権限に管理者権限が必要なコマンド（管理者用コマンド）を提供しています。JP1/Base管理者コンソールは管理者用コマンドを実行するためのコマンドプロンプトです。Windowsのユーザーアカウント制御（UAC）が有効な場合は，管理者コンソールからコマンドを実行してください。

起動方法

スタートメニューから［プログラム］−［JP1_Base］−［JP1_Base Console］を選択すると起動します。

停止方法

プロンプト上でexitコマンドを入力，またはCloseボタン（×）をクリックすると停止します。

動作のカスタマイズ

JP1/Base管理者コンソールを起動したときに任意の環境変数の設定やカレントパスの変更などのカスタマイズ情報を，JP1/Base管理者コンソールが提供するプロファイルバッチプログラムを編集すると定義できます。

プロファイルバッチプログラムは，インストール先フォルダ¥conf¥jbsadmin¥profile.batです。

［プロファイルバッチプログラムの初期設定］

@echo off

rem #------------------------------------------------------------------
rem # ここにJP1/Base管理者コンソールのプロファイル情報（環境変数など）
rem # を設定できます.
rem #------------------------------------------------------------------

echo JP1/Base 管理者コンソール

@echo on

例えば環境変数JP1_HOSTNAMEにlogicalと設定したい場合，次のように定義します。

@echo off

rem #------------------------------------------------------------------
rem # ここにJP1/Base管理者コンソールのプロファイル情報（環境変数など）
rem # を設定できます.
rem #------------------------------------------------------------------

echo JP1/Base 管理者コンソール
set JP1_HOSTNAME=logical

@echo on

cpysvprm（Windows限定）

機能

起動順序定義ファイル（JP1SVPRM.DAT）を作成します。

形式

cpysvprm [-n ファイル名]
cpysvprm -d

実行権限

なし（ただし，WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-n ファイル名

指定したファイルをコピーして，JP1/Baseのデータフォルダ（インストール先フォルダ¥conf¥boot¥）にJP1SVPRM.DATファイルを作成します。指定するファイル名は，フルパスで指定してください。このオプションを省略した場合，JP1/BaseのデータフォルダにあるJP1SVPRM.DAT.MODELファイルをサンプルにして，JP1/BaseのデータフォルダにJP1SVPRM.DATファイルを作成します。

-d

JP1/BaseのデータフォルダにあるJP1SVPRM.DATファイルを削除します。このコマンドを実行すると，起動管理機能は使用できなくなります。

注意事項

-nオプションで指定したファイル，またはJP1SVPRM.DAT.MODELファイルは必ずバックアップしてください。

JP1/Baseのデータフォルダ（インストール先フォルダ¥conf¥boot¥）にあるJP1SVPRM.DAT.MODELファイルを直接編集しないでください。

hntr2conf

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，および出力先を変更します。

このコマンドは，GUIで統合トレースログのサイズ，数，および出力先を設定するhntr2utl2コマンドと同じ機能を，コマンドの設定で実現します。

形式

hntr2conf [-f ログファイル名]
          [-b ログファイルサイズ]
          [-n ログファイル数]
          [-s バッファーファイルサイズ]
          [-w 監視周期時間]
          [-i 監視間隔時間]
          [-m メッセージ数]
          [-t 排他制御種別]
          [-l コマンドログファイル名]
          [-h]

実行権限

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

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

32bit版HNTRLib2（32bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥bin¥

64bit版HNTRLib2（64bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥bin¥

UNIXの場合

/opt/hitachi/HNTRLib2/bin/

引数

-f ログファイル名

統合トレースログの出力先およびログファイル名のプリフィックスを指定します。ここで指定したプリフィックスに，"[1-16].log"を追加した名称が統合トレースログのファイル名になります。初期設定では，次のように設定されています。

Windowsの場合

32bit版HNTRLib2（32bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

64bit版HNTRLib2（64bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

UNIXの場合

/var/opt/hitachi/HNTRLib2/spool/hntr2*.log

-b ログファイルサイズ

統合トレースログのサイズ（8〜8,192キロバイト）を指定します。初期設定では，256キロバイトが設定されています。

-n ログファイル数

統合トレースログの数（1〜16）を指定します。-fオプションで指定した出力先に，ここで指定した値分の統合トレースログを作成します。初期設定では，4が設定されています。

-s バッファーファイルサイズ

バッファーファイルのサイズ（8〜2,048キロバイト）を指定します。初期設定では，64キロバイトが設定されています。

-w 監視周期時間

監視周期時間（1〜300秒）を指定します。初期設定では，10秒が設定されています。

-i 監視間隔時間

監視間隔時間（0〜3,600秒）を指定します。初期設定から変更しないでください。

-m メッセージ数

コマンドが出力するメッセージの数の範囲（0〜500）を指定します。初期設定から変更しないでください。

-t 排他制御種別

統合トレース出力の排他制御の種別を指定します。排他制御しない場合は0を指定します。排他制御する場合は2を指定します。このパラメーターを省略した場合は，0が仮定されます。

-l コマンドログファイル名

コマンドの出力をログファイルへ出力するときに指定します。

-h

ヘルプを表示します。

注意事項

統合トレースログファイルのサイズの適正値については，hntr2utl2コマンドの注意事項を参照してください。

統合トレース（HNTRLib2）の設定を変更した場合は，統合トレース機能を再起動する必要があります。統合トレース機能を再起動する方法については，hntr2utl2コマンドの注意事項を参照してください。

バッファーファイルサイズまたは排他制御種別を変更する場合は，以下の手順で設定を変更してください。

Windowsの場合

統合トレースログを出力するすべてのサービスを停止する。

統合トレース機能を停止する。

統合トレースログの設定を変更する。

統合トレース機能を起動する。

手順1で停止した統合トレースログを出力するサービスを起動する。

UNIXの場合

統合トレースログを出力するすべてのサービスを停止する。

統合トレース機能を停止する。

統合トレースログの設定を変更する。

メモリマップドファイル(/opt/hitachi/HNTRLib2/mmap/hntr2mmap.mm)を削除する。

統合トレース機能を起動する。

手順1で停止した統合トレースログを出力するサービスを起動する。

戻り値

0

正常終了

1

引数不正

2

Administrators権限を持たないユーザーがコマンドを実行した（Windowsの場合）

10

-fオプションで指定したログファイルの出力先が存在しない

11

-bオプションで指定したログファイルのサイズが小さ過ぎる

12

-sオプションで指定したバッファーファイルのサイズがログファイルのサイズより大きい

13〜17

内部エラー

99

システムエラー

hntr2getconf

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，出力先などの設定情報を出力します。

形式

hntr2getconf [-f]
             [-b]
             [-n]
             [-s]
             [-w]
             [-i]
             [-m]
             [-t]
             [-l コマンドログファイル名]
             [-h]

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

32bit版HNTRLib2（32bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥bin¥

64bit版HNTRLib2（64bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥bin¥

UNIXの場合

/opt/hitachi/HNTRLib2/bin/

引数

-f

統合トレースログの出力先およびログファイル名を出力します。

-b

統合トレースログのサイズを出力します。

-n

統合トレースログの数を出力します。

-s

バッファーファイルのサイズを出力します。

-w

監視周期時間を出力します。

-i

監視間隔時間を出力します。

-m

メッセージ数を出力します。

-t

排他制御種別を出力します。

-l コマンドログファイル名

各オプションの読み込み結果をログファイルへ出力するときに指定します。

-h

ヘルプを出力します。

戻り値

0

正常終了

1

引数不正

13〜17

内部エラー

99

システムエラー

使用例

出力例を次に示します。

オプションを単数で指定したとき（Windowsの場合）

> hntr2getconf.exe -b
8
>

オプションを複数で指定したとき（UNIXの場合）

$ hntr2getconf -b -n
LogSize=8
LogFNum=4
$

オプションを複数指定した場合，オプションの指定順にキー名称を付けて出力します。オプション名とキー名称の対応を次の表に示します。

キー名称

オプション名

LogFile

-f

LogSize

-b

LogFNum

-n

MapSize

-s

WatchDog

-w

IntervalSec

-i

MaxMsgNum

-m

ShmLockType

-t

hntr2getname（Windows限定）

機能

統合トレース（HNTRLib2）を使用するPP名称を標準出力に出力します。

形式

hntr2getname

実行権限

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

格納先ディレクトリ

32bit版HNTRLib2（32bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥bin¥

64bit版HNTRLib2（64bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥bin¥

戻り値

-1

異常終了

0〜126

HNTRLib2を使用するPP数

127

HNTRLib2を使用するPP数が127個以上

hntr2kill（UNIX限定）

機能

統合トレース（HNTRLib2）を終了します。

形式

hntr2kill

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/hitachi/HNTRLib2/bin/

hntr2mon（UNIX限定）

機能

統合トレース（HNTRLib2）を起動します。

形式

hntr2mon -d &

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/hitachi/HNTRLib2/bin/

hntr2util（UNIX限定）

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，および出力先を変更します。

このコマンドは，互換用です。hntr2utl2コマンドを使用してください。

このコマンドを実行すると次に示すメニューが表示されます。

次に，このメニューの各項目について説明します。

1：Size of a log file.

ログファイルのサイズ（8〜4,096キロバイト）を指定します。初期設定では，256キロバイトが設定されています。

2：Number of log files.

ログファイル数（1〜16）を指定します。初期設定では，4が設定されています。

3：Size of buffer.

バッファーファイルのサイズ（8〜1,024キロバイト）を指定します。初期設定では，64キロバイトが設定されています。

4：Watch dog time.

監視周期時間（1〜300秒）を指定します。初期設定では，10秒が設定されています。

5：Name of log files.

ログファイルの出力先を指定します。初期設定では，/var/opt/hitachi/HNTRLib2/spool/hntr2*.logが設定されています。

形式

hntr2util

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/hitachi/HNTRLib2/bin/

注意事項

各プログラムが1日当たりに出力するログの量を次に示します。この値を参考にしてログファイルのサイズを設定してください。なお，次に示す計算式の値は，正常に運用した場合のログの量です。エラー時に対処するためには，これ以上のサイズを設定してください。

JP1 サービス

7.5 × 1日当たりの起動回数および停止回数（キロバイト）

上記の計算式の値は，1製品当たりのログの量です。JP1/Base，JP1/IM，JP1/AJSそれぞれでログの量を見積もってください。

認証サーバ

0.2 × JP1/AJS - Viewからのログイン回数 + 0.2 × コマンド実行回数※（キロバイト）

注※　次のコマンドの実行回数を示します。

jbsadduser，jbsrmuser，jbschgpasswd，jbsacllint，jbsaclreload，jbslistuser，jbschkds，jbschgds，jbssetacl，jbsrmacl

ログトラップ

（0.5 + ログファイルトラップ動作定義ファイル名長 + ログファイル名長） × 1日当たりの起動回数 + 0.2 × 1日当たりの停止回数（キロバイト）

JP1/IM

（0.16 + 自動アクションのコマンド長） × 1日当たりの自動アクション実行回数 + 0.4 × JP1/IM - Viewからの自動アクション定義の変更回数 + 0.16 × JP1/IM - ViewからJP1/IM - Managerへのログイン回数 + （0.16 + コマンド実行画面のコマンド長） × 1日当たりのコマンド実行回数（キロバイト）

JP1/AJS

起動条件が成立した数 × 0.2（キロバイト）

統合トレース（HNTRLib2）の設定を変更した場合は，次に示す手順で，統合トレース機能を再起動してください。

次に示すコマンドを実行して，統合トレース採取プロセスを停止します。

/opt/hitachi/HNTRLib2/bin/hntr2kill

次に示すコマンドを実行して，統合トレース採取プロセスを起動します。

/opt/hitachi/HNTRLib2/bin/hntr2mon -d &

バッファーファイルサイズを変更する場合は，以下の手順で設定を変更してください。

統合トレースログを出力するすべてのサービスを停止する。

統合トレース機能を停止する。

統合トレースログの設定を変更する。

メモリマップドファイル(/opt/hitachi/HNTRLib2/mmap/hntr2mmap.mm)を削除する。

統合トレース機能を起動する。

手順1で停止した統合トレースログを出力するサービスを起動する。

ログファイルサイズやバッファーファイルサイズがこのコマンドで設定できる上限値を超えている場合，設定変更できません。hntr2utl2コマンドを使用してください。

hntr2util（Windows限定）

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，および出力先を変更します。

このコマンドは，互換用です。hntr2utl2コマンドを使用してください。

このコマンドを実行すると，次に示すダイアログボックスが表示されます。

このダイアログボックスで統合トレースログの出力先，数，およびサイズを設定できます。次にこのダイアログボックスの各項目について説明します。

Output (directory and prefix):

ログファイルの出力先およびログファイル名のプリフィックスを指定します。初期設定では，次の出力先が設定されています。

32bit版HNTRLib2（32bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

64bit版HNTRLib2（64bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

Number of Files:

ログファイル数（1〜16）を指定します。初期設定では，4が設定されています。Outputで指定した出力先に，ここで指定した値分のログファイルを作成します。

File Size (KB):

ログファイルのサイズ（8〜4,096キロバイト）を指定します。初期設定では，256キロバイトが設定されています。

Buffer (KB):

バッファーファイルのサイズ（8〜1,024キロバイト）を指定します。初期設定では，64キロバイトが設定されています。

Watch Dog (sec):

監視周期時間（1〜300秒）を指定します。初期設定では，10秒が設定されています。

［OK］ボタン

ダイアログボックスで指定した値を反映して，ダイアログボックスを閉じます。

［Cancel］ボタン

ダイアログボックスで指定した値を反映しないで，ダイアログボックスを閉じます。

［Kill］ボタン

実行中のモニタープロセスを終了します。統合トレースサービス（サービス名：Hitachi Network Objectplaza Trace Monitor 2）を停止できますが，通常は，このボタンを利用しないで，Windowsの［コントロールパネル］の［サービス］ダイアログボックス上で操作してください。

形式

hntr2util

実行権限

Administrators権限

格納先ディレクトリ

32bit版HNTRLib2（32bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥bin¥

64bit版HNTRLib2（64bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥bin¥

注意事項

各プログラムが1日当たりに出力するログの量を次に示します。この値を参考にしてログファイルのサイズを設定してください。なお，次に示す計算式の値は，正常に運用した場合のログの量です。エラー時に対処するためには，これ以上のサイズを設定してください。

JP1 サービス

7.5 × 1日当たりの起動回数および停止回数（キロバイト）

上記の計算式の値は，1製品当たりのログの量です。JP1/Base，JP1/IM，JP1/AJSそれぞれでログの量を見積もってください。

認証サーバ

0.2 × JP1/AJS - Viewからのログイン回数 + 0.2 × コマンド実行回数※（キロバイト）

注※　次のコマンドの実行回数を示します。

jbsadduser，jbsrmuser，jbschgpasswd，jbsacllint，jbsaclreload，jbslistuser，jbschkds，jbschgds，jbssetacl，jbsrmacl

ログトラップ

（0.5 + ログファイルトラップ動作定義ファイル名長 + ログファイル名長） × 1日当たりの起動回数 + 0.2 × 1日当たりの停止回数（キロバイト）

JP1/IM

（0.16 + 自動アクションのコマンド長） × 1日当たりの自動アクション実行回数 + 0.4 × JP1/IM - Viewからの自動アクション定義の変更回数 + 0.16 × JP1/IM - ViewからJP1/IM - Managerへのログイン回数 + （0.16 + コマンド実行画面のコマンド長） × 1日当たりのコマンド実行回数（キロバイト）

JP1/AJS

起動条件が成立した数 × 0.2（キロバイト）

統合トレース（HNTRLib2）の設定を変更した場合は，統合トレース機能を再起動する必要があります。［コントロールパネル］の［サービス］ダイアログボックスで，［Hitachi Network Objectplaza Trace Monitor 2］の名称のサービスを再起動してください。

バッファーファイルサイズを変更する場合は，以下の手順で設定を変更してください。

統合トレースログを出力するすべてのサービスを停止する。

統合トレース機能を停止する。

統合トレースログの設定を変更する。

統合トレース機能を起動する。

手順1で停止した統合トレースログを出力するサービスを起動する。

ログファイルサイズやバッファーファイルサイズがこのコマンドで設定できる上限値を超えている場合，設定変更できません。hntr2utl2コマンドを使用してください。

hntr2utl2（UNIX限定）

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，および出力先を変更します。

このコマンドを実行すると次に示すメニューが表示されます。

次に，このメニューの各項目について説明します。

1：Size of a log file.

ログファイルのサイズ（8〜8,192キロバイト）を指定します。初期設定では，256キロバイトが設定されています。

2：Number of log files.

ログファイル数（1〜16）を指定します。初期設定では，4が設定されています。

3：Name of log files.

ログファイルの出力先を指定します。初期設定では，/var/opt/hitachi/HNTRLib2/spool/hntr2*.logが設定されています。

4：Size of buffer.

バッファーファイルのサイズ（8〜2,048キロバイト）を指定します。初期設定では，64キロバイトが設定されています。

5：Interval timer.

監視周期時間（1〜300秒）を指定します。初期設定では，10秒が設定されています。

6：Lookout span.

監視間隔時間（0〜3,600秒）を指定します。初期設定から変更しないでください。

7：Max message per span.

コマンドが出力するメッセージの数の範囲（0〜500）を指定します。初期設定から変更しないでください。

形式

hntr2utl2

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/hitachi/HNTRLib2/bin/

注意事項

各プログラムが1日当たりに出力するログの量を次に示します。この値を参考にしてログファイルのサイズを設定してください。なお，次に示す計算式の値は，正常に運用した場合のログの量です。エラー時に対処するためには，これ以上のサイズを設定してください。

JP1 サービス

7.5 × 1日当たりの起動回数および停止回数（キロバイト）

上記の計算式の値は，1製品当たりのログの量です。JP1/Base，JP1/IM，JP1/AJSそれぞれでログの量を見積もってください。

認証サーバ

0.2 × JP1/AJS - Viewからのログイン回数 + 0.2 × コマンド実行回数※（キロバイト）

注※　次のコマンドの実行回数を示します。

jbsadduser，jbsrmuser，jbschgpasswd，jbsacllint，jbsaclreload，jbslistuser，jbschkds，jbschgds，jbssetacl，jbsrmacl

ログトラップ

（0.5 + ログファイルトラップ動作定義ファイル名長 + ログファイル名長） × 1日当たりの起動回数 + 0.2 × 1日当たりの停止回数（キロバイト）

JP1/IM

（0.16 + 自動アクションのコマンド長） × 1日当たりの自動アクション実行回数 + 0.4 × JP1/IM - Viewからの自動アクション定義の変更回数 + 0.16 × JP1/IM - ViewからJP1/IM - Managerへのログイン回数 + （0.16 + コマンド実行画面のコマンド長） × 1日当たりのコマンド実行回数（キロバイト）

JP1/AJS

起動条件が成立した数 × 0.2（キロバイト）

統合トレース（HNTRLib2）の設定を変更した場合は，次に示す手順で，統合トレース機能を再起動してください。

次に示すコマンドを実行して，統合トレース採取プロセスを停止します。

/opt/hitachi/HNTRLib2/bin/hntr2kill

次に示すコマンドを実行して，統合トレース採取プロセスを起動します。

/opt/hitachi/HNTRLib2/bin/hntr2mon -d &

バッファーファイルサイズを変更する場合は，以下の手順で設定を変更してください。

統合トレースログを出力するすべてのサービスを停止する。

統合トレース機能を停止する。

統合トレースログの設定を変更する。

メモリマップドファイル(/opt/hitachi/HNTRLib2/mmap/hntr2mmap.mm)を削除する。

統合トレース機能を起動する。

1.で停止した統合トレースログを出力するサービスを起動する。

hntr2utl2（Windows限定）

機能

統合トレース（HNTRLib2）が出力する統合トレースログのサイズ，数，および出力先を変更します。

このコマンドを実行すると，次に示すダイアログボックスが表示されます。

このダイアログボックスで統合トレースログの出力先，数，およびサイズなどを設定できます。次にこのダイアログボックスの各項目について説明します。

Output (directory and prefix):

ログファイルの出力先およびログファイル名のプリフィックスを指定します。初期設定では，次の出力先が設定されています。

32bit版HNTRLib2（32bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

64bit版HNTRLib2（64bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

Number of Files:

ログファイル数（1〜16）を指定します。初期設定では，4が設定されています。Outputで指定した出力先に，ここで指定した値分のログファイルを作成します。

File Size (KB):

ログファイルのサイズ（8〜8,192キロバイト）を指定します。初期設定では，256キロバイトが設定されています。

Buffer (KB):

バッファーファイルのサイズ（8〜2,048キロバイト）を指定します。初期設定では，64キロバイトが設定されています。

Interval Timer (Sec):

監視周期時間（1〜300秒）を指定します。初期設定では，10秒が設定されています。

Lookout Span(Sec):

監視間隔時間（0〜3,600秒）を指定します。初期設定から変更しないでください。

Max Messages / Span:

コマンドが出力するメッセージの数の範囲（0〜500）を指定します。初期設定から変更しないでください。

［OK］ボタン

ダイアログボックスで指定した値を反映して，ダイアログボックスを閉じます。

［Cancel］ボタン

ダイアログボックスで指定した値を反映しないで，ダイアログボックスを閉じます。

［Stop Monitor］ボタン

実行中のモニタープロセスを終了します。統合トレースサービス（サービス名：Hitachi Network Objectplaza Trace Monitor 2）を停止できますが，通常は，このボタンを利用しないで，Windowsの［コントロールパネル］の［サービス］ダイアログボックス上で操作してください。

形式

hntr2utl2

実行権限

Administrators権限

格納先ディレクトリ

32bit版HNTRLib2（32bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥bin¥

64bit版HNTRLib2（64bitプロセス用統合トレースを設定する場合）

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥bin¥

注意事項

各プログラムが1日当たりに出力するログの量を次に示します。この値を参考にしてログファイルのサイズを設定してください。なお，次に示す計算式の値は，正常に運用した場合のログの量です。エラー時に対処するためには，これ以上のサイズを設定してください。

JP1 サービス

7.5 × 1日当たりの起動回数および停止回数（キロバイト）

上記の計算式の値は，1製品当たりのログの量です。JP1/Base，JP1/IM，JP1/AJSそれぞれでログの量を見積もってください。

認証サーバ

0.2 × JP1/AJS - Viewからのログイン回数 + 0.2 × コマンド実行回数※（キロバイト）

注※　次のコマンドの実行回数を示します。

jbsadduser，jbsrmuser，jbschgpasswd，jbsacllint，jbsaclreload，jbslistuser，jbschkds，jbschgds，jbssetacl，jbsrmacl

ログトラップ

（0.5 + ログファイルトラップ動作定義ファイル名長 + ログファイル名長） × 1日当たりの起動回数 + 0.2 × 1日当たりの停止回数（キロバイト）

JP1/IM

（0.16 + 自動アクションのコマンド長） × 1日当たりの自動アクション実行回数 + 0.4 × JP1/IM - Viewからの自動アクション定義の変更回数 + 0.16 × JP1/IM - ViewからJP1/IM - Managerへのログイン回数 + （0.16 + コマンド実行画面のコマンド長） × 1日当たりのコマンド実行回数（キロバイト）

JP1/AJS

起動条件が成立した数 × 0.2（キロバイト）

統合トレース（HNTRLib2）の設定を変更した場合は，統合トレース機能を再起動する必要があります。［コントロールパネル］の［サービス］ダイアログボックスで，［Hitachi Network Objectplaza Trace Monitor 2］の名称のサービスを再起動してください。

バッファーファイルサイズを変更する場合は，以下の手順で設定を変更してください。

統合トレースログを出力するすべてのサービスを停止する。

統合トレース機能を停止する。

統合トレースログの設定を変更する。

統合トレース機能を起動する。

1.で停止した統合トレースログを出力するサービスを起動する。

jbs_killall.cluster（UNIX限定）

機能

論理ホスト上で動作しているJP1/Baseのプロセスを強制終了します。終了させるプロセスを次に示します。

メインプロセス

構成管理プロセス

リモートコマンド実行プロセス

認証サーバプロセス（認証サーバを起動している場合）

イベントサービス

形式

jbs_killall.cluster [論理ホスト名]

実行権限

スーパーユーザー権限

格納先ディレクトリ

/etc/opt/jp1base/

引数

論理ホスト名

JP1/Baseで設定した論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに設定されているホスト名を仮定します。このオプションを省略し，環境変数JP1_HOSTNAMEに何も設定されていない場合は，異常終了します。

注意事項

このコマンドは，論理ホスト名を先頭〜32バイトの範囲で判定して，対応するプロセスを強制終了します。名称が33バイト以上の論理ホストのプロセスは強制終了できません。その場合は，psコマンドでプロセスを確認後，killコマンドで強制終了してください。

フェールオーバー時には，jbs_stop.clusterコマンドを実行しても，プロセスが終了しないでフェールオーバーが失敗することがあります。終了しないプロセスを強制終了させるために，このコマンドを実行してください。

戻り値

0

正常終了

1以上

異常終了

jbs_log.bat（Windows限定）

機能

JP1/Baseで障害が発生したときに資料を採取するためのツールです。JP1/Baseの保守資料，OSのシステム情報，統合トレースログなどを採取します。

このツールは，バッチファイルです。ユーザーによるカスタマイズはできません。

このツールを実行すると，資料格納フォルダに指定したフォルダの下にjp1_defaultフォルダが作成されます。-hオプションを指定した場合は，jp1_defaultフォルダと論理ホスト名のフォルダが作成されます。各フォルダの下に，base_1stとbase_2ndのフォルダが作成され，そのフォルダの中に採取した資料がコピーされます。必要に応じて採取した資料を圧縮ツールなどで圧縮してください。フォルダ構成および資料内容を次に示します。

格納先フォルダ

採取した資料

資料格納フォルダ¥jp1_default¥base_1st¥conf¥

設定および定義ファイル

資料格納フォルダ¥jp1_default¥base_1st¥log¥

ログファイル

資料格納フォルダ¥jp1_default¥base_1st¥allusers¥jp1_default¥JP1Base¥log

ログファイル

資料格納フォルダ¥jp1_default¥base_1st¥allusers¥論理ホスト名¥JP1Base¥log

ログファイル

資料格納フォルダ¥jp1_default¥base_1st¥sys¥

OSのシステム情報

資料格納フォルダ¥jp1_default¥base_1st¥sys¥tmp¥event¥

イベントサーバ設定

資料格納フォルダ¥jp1_default¥base_1st¥sys¥OPI

サービス稼働情報

資料格納フォルダ¥jp1_default¥base_1st¥default¥

共通定義情報

資料格納フォルダ¥jp1_default¥base_1st¥plugin¥conf¥

プラグインサービスの設定ファイル

資料格納フォルダ¥jp1_default¥base_1st¥spool¥

統合トレースログ（32bit）

資料格納フォルダ¥jp1_default¥base_1st¥spoolx64¥

統合トレースログ（64bit）

資料格納フォルダ¥jp1_default¥base_2nd¥log¥Command¥

コマンド実行履歴ファイル

資料格納フォルダ¥jp1_default¥base_2nd¥sys¥

イベントDB

資料格納フォルダ¥論理ホスト名¥base_1st¥conf¥

論理ホストの設定および定義ファイル（論理ホスト指定時）

資料格納フォルダ¥論理ホスト名¥base_1st¥log¥

論理ホストのログ情報

（論理ホスト指定時）

資料格納フォルダ¥論理ホスト名¥base_1st¥event¥

論理ホストのイベントサーバ設定（論理ホスト指定時）

資料格納フォルダ¥論理ホスト名¥base_1st¥sys¥OPI

論理ホストのサービス稼働情報

資料格納フォルダ¥論理ホスト名¥base_2nd¥sys¥

論理ホストのコマンド実行履歴ファイル（論理ホスト指定時）

資料格納フォルダ¥論理ホスト名¥base_2nd¥event¥

論理ホストのイベントDB

（論理ホスト指定時）

なお，このツールを使って採取できる資料の詳細については，「18.3　トラブル発生時に採取が必要な資料」を参照してください。

形式

jbs_log.bat [-h 論理ホスト名]
            [資料格納フォルダ]
            [-r]
            [-t]
            [-u]
            [-p]
            [-q]

実行権限

なし（ただし，WindowsのUAC機能が有効な場合は管理者コンソールから実行）

格納先ディレクトリ

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

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。省略した場合，物理ホストの資料だけを採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，クラスタシステムで使用する場合には，論理ホスト名を必ず指定してください。環境変数JP1_HOSTNAMEは使用できません。

資料格納フォルダ

採取した資料を出力するフォルダ名を，フルパスまたはコマンドを実行するカレントディレクトリからの相対パスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

存在しないフォルダを指定した場合は，その名称でフォルダが新規作成されます。

すでに存在するフォルダを指定した場合は，いったんフォルダを削除してから再度作成します。削除したくないファイルが格納されているフォルダと同じフォルダ名は指定しないでください。また，ネットワークドライブ上のフォルダは指定しないでください。

このオプションを省略した場合，環境変数TEMPで指定されているフォルダ下のjp1logフォルダを仮定します。環境変数TEMPは，使用しているOSおよびユーザーによって異なりますので，Windowsの［コントロールパネル］の［システム］から確認してください。

-r

コマンド実行履歴ファイル（ISAM）を採取しない場合に指定します。

-t

hostsファイル，およびservicesファイルを採取しない場合に指定します。

-u

クラッシュダンプを採取しない場合に指定します。

-p

イベントDBを採取しない場合に指定します。

-q

資料採取処理の続行確認の応答待ちが必要ない場合に指定します。

-qオプションを指定しない場合は，続行確認のメッセージとともに応答待ちになります。

注意事項

イベントサーバの資料を採取するとき，イベントサーバインデックスでイベントサーバが使用するフォルダをフルパス名に変更した場合，変更したイベントサーバの資料を採取しません。障害発生時には資料採取ツールによる採取と合わせて，イベントサーバインデックスで指定したフォルダを資料としてすべて採取してください。

資料採取ツールは多重実行しないでください。

資料採取ツールの実行が終了するまでに10分以上かかる場合があります。資料採取ツールがすぐに終了しなくても，強制的に終了させないでください。

資料採取ツールを実行した場合，資料採取ツールの実行が終了してもマシンのシステム情報が採取されていない場合があります。これは，資料採取ツールの実行が終了しても，内部的にOSの情報を採取するためのプロセスが終了していないためです。

タスクマネージャを起動し，［プロセス］タブで「msinfo32.exe」が終了しているのを確認したあとで，採取した資料を圧縮ツールなどで圧縮したり，移動，削除などの操作をしたりしてください。

統合トレースログの出力先を変更した場合，変更した統合トレースログの資料を採取しません。障害発生時には資料採取ツールによる採取と合わせて，統合トレースログの出力先を変更したフォルダを資料としてすべて採取してください。

戻り値

0

正常終了

8

異常終了

引数エラー

採取する保守資料が格納されているフォルダが見つからない

jbs_log.sh（UNIX限定）

機能

JP1/Baseで障害が発生したときに資料を採取するためのツールです。JP1/Baseの保守資料，OSのシステム情報，統合トレース情報などを採取します。

このツールは，シェルスクリプトです。ユーザーによるカスタマイズはできません。

このツールを実行すると，ルートディレクトリの直下で，tarコマンドを使用して資料を採取する対象ディレクトリまたはファイルをアーカイブしたあと，compressコマンドを使用して圧縮します（Linuxでは，gzipコマンドを使用します）。圧縮されたファイルは，-fオプションを指定した場合は資料格納ディレクトリ名に，省略した場合は/tmp/jp1base/に格納されます。圧縮されたファイルのディレクトリ構成を次に示します。

格納先ディレクトリ

採取した資料

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/conf/

設定および定義ファイル

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/log/

ログファイル

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/log/sys/

OSのシステム情報

jbs_spmd_statusコマンドの実行結果

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/sys/tmp/event/

イベントサーバ設定

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/sys/OPI

サービス稼働情報

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/jp1base/plugin/conf/

プラグインサービスの設定ファイル

資料格納ディレクトリ名/jp1_default_base_1st/var/opt/hitachi/HNTRLib2/spool/

統合トレースログ

資料格納ディレクトリ名/jp1_default_base_1st/opt/jp1/hcclibcnf/

共通定義情報

資料格納ディレクトリ名/jp1_default_base_2nd/var/opt/jp1base/Command/

コマンド実行履歴ファイル

資料格納ディレクトリ名/jp1_default_base_2nd/var/opt/jp1base/sys/event/

イベントDB

資料格納ディレクトリ名/jp1_default_base_2nd/usr/tmp/jp1_ses/

互換用設定ファイル

資料格納ディレクトリ名/jp1_default_base_2nd/usr/lib/jp1_ses/

資料格納ディレクトリ名/jp1_default_base_2nd/usr/bin/jp1_ses/

資料格納ディレクトリ名/jp1_default_base_2nd/tmp/

資料格納ディレクトリ名/jp1_default_base_2nd/var/opt/jp1_ses/

資料格納ディレクトリ名/論理ホスト名_base_1st/etc/opt/jp1base/log/

論理ホストのログファイル

資料格納ディレクトリ名/論理ホスト名_base_1st/etc/opt/jp1base/conf/

論理ホストの設定および定義ファイル

（論理ホスト指定時）

資料格納ディレクトリ名/論理ホスト名_base_1st/共有ディレクトリ/event/

論理ホストのイベントサーバ設定

（論理ホスト指定時）

資料格納ディレクトリ名/論理ホスト名_base_1st/共有ディレクトリ/jp1base/sys/OPI

論理ホストのサービス稼働情報

資料格納ディレクトリ名/論理ホスト名_base_2nd/共有ディレクトリ/event/

論理ホストのイベントDB

（論理ホスト指定時）

資料格納ディレクトリ名/論理ホスト名_base_2nd/var/opt/jp1base/COMMAND/

論理ホストのコマンド実行履歴ファイル

（論理ホスト指定時）

なお，このツールを使って採取できる資料の詳細については，「18.3　トラブル発生時に採取が必要な資料」を参照してください。

形式

jbs_log.sh [-f 資料格納ディレクトリ名]
           [-k]
           [-p]
           [-r]
           [-t]
           [-u]
           [-q]
           [-h 論理ホスト名]
           [ディレクトリ名またはファイル名 ...]

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/tools/

引数

-f 資料格納ディレクトリ名

採取した情報の格納ディレクトリ名を，空白文字を含まない絶対パスで指定します。なお，指定されたディレクトリ名に空白文字を含んでいる場合，空白文字以前までの文字列を格納ディレクトリ名とし，空白文字以降の文字列は別の引数と見なされます。

-fオプションを省略した場合，次のファイルが作成されます。

物理ホストの場合

Linux以外

/tmp/jp1base/jp1_default_base_1st.tar.Z

/tmp/jp1base/jp1_default_base_2nd.tar.Z

Linux

/tmp/jp1base/jp1_default_base_1st.tar.gz

/tmp/jp1base/jp1_default_base_2nd.tar.gz

論理ホストの場合

Linux以外

/tmp/jp1base/論理ホスト名_base_1st.tar.Z

/tmp/jp1base/論理ホスト名_base_2nd.tar.Z

Linux

/tmp/jp1base/論理ホスト名_base_1st.tar.gz

/tmp/jp1base/論理ホスト名_base_2nd.tar.gz

-k

互換用設定ファイルに関するログを採取しない場合に指定します。

-p

イベントDBを採取しない場合に指定します。

-r

コマンド実行履歴ファイル（ISAM）を採取しない場合に指定します。

-t

/etc/hosts，/etc/services，/etc/passwdファイルを採取しない場合に指定します。

-u

coreの解析情報を採取しない場合に指定します。

-q

資料採取処理の続行確認の応答待ちが必要ない場合に指定します。

-qオプションを指定しない場合は，続行確認のメッセージとともに応答待ちになります。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを指定した場合，物理ホストと論理ホストの両方の資料を採取します。省略した場合，物理ホストの資料だけを採取します。クラスタシステムを使用していない場合には指定は不要です。

なお，クラスタシステムで使用する場合には，論理ホスト名を必ず指定してください。環境変数JP1_HOSTNAMEは使用できません。

ディレクトリ名またはファイル名

資料採取ツールで任意のファイルまたはディレクトリを採取したいときに指定します。フルパス名で指定してください。複数指定する場合は，スペースで区切ってください。

注意事項

イベントサーバインデックスファイル（index）でイベントサーバが使用するディレクトリをフルパス名に変更した場合，変更したイベントサーバの資料を採取しません。障害発生時には資料採取ツールに次のオプションを指定して変更したディレクトリの情報を採取してください。

jbs_log.sh (任意のオプション) [indexファイルで指定したディレクトリ]

coreファイル名を変更している環境で運用している場合，資料採取ツールで採取することができません。このため，資料採取時には別途採取する必要があります。

統合トレースログの出力先を変更した場合，変更した統合トレースログの資料を採取しません。障害発生時には資料採取ツールに次のオプションを指定して変更したディレクトリの情報を採取してください。

jbs_log.sh (任意のオプション) [統合トレースログの出力先ディレクトリ]

SUSE Linux Enterprise Server 12 SP2以降ではコアダンプに関する仕様が変更され，資料採取ツールで採取することができません。このため，coreファイルが出力された場合は別途採取してください。coreファイルの出力先を次に示します。

/var/lib/systemd/coredump/

戻り値

0

正常終了

8

引数エラー

指定された論理ホスト名が存在しない

指定された論理ホストの共有ディレクトリがマウントされていない

インストールされていない製品があったため，ファイルのコピー処理ができなかった

デバイスファイルが準備されているかどうかの質問にユーザーがNOで答えた

出力ファイルを上書きしてよいかの質問にユーザーがNOで答えた

指定された追加ファイルが読み取れない

指定された追加ファイルが存在しない

出力先ディレクトリが書き込めない

出力先ディレクトリが作成できなかった

jbs_setup_cluster（Windows限定）

機能

JP1/Baseの論理ホストの動作環境を設定します。クラスタシステムの運用環境のセットアップをする場合には，実行系および待機系で実行してください。

実行系の環境設定

論理ホスト名と共有フォルダ名の指定が必要です。ほかのオプションについては，必要に応じて指定してください。このコマンドを実行すると，指定した共有フォルダに定義ファイルやログファイルなどがコピーされるため，必ず共有ディスクをマウントしておいてください。

待機系の環境設定

論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。なお，待機系の環境設定をする前に，実行系で設定した共通定義情報を待機系にコピーする必要があります。共通定義情報をコピーする方法については，jbsgetcnfコマンドおよびjbssetcnfコマンドを参照してください。

形式

jbs_setup_cluster -h 論理ホスト名
                [[-d 共有フォルダ名 [-a 認証サーバ]] | -r]
                [-v]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

セットアップまたは削除する論理ホスト名を指定します。指定できる文字数は，1〜196（バイト）です。

-d 共有フォルダ名

実行系の環境設定時に使用します。フェールオーバー時に引き継ぐ情報を格納する共有フォルダを指定します。共有ディスク上のフォルダを指定してください。指定した共有フォルダで，JP1/Baseの動作に必要な環境設定が行われます。このオプションを指定してコマンドを実行すると，共有ディスク上に次の表に示すフォルダを作成し，定義ファイルをインストール先フォルダ¥conf¥からコピーします。

フォルダ

格納するファイル

共有フォルダ¥jp1base¥conf¥

定義ファイル

共有フォルダ¥jp1base¥log¥

ログファイル

共有フォルダ¥jp1base¥event¥

イベントサーバ設定ファイル

-a 認証サーバ

論理ホストが接続する認証サーバのホスト名を指定します。このオプションを省略した場合，認証サーバの設定は物理ホストの環境設定と同じ認証サーバが指定されます。

-v

このオプションを指定すると，論理ホストの動作環境を設定するときのすべてのメッセージを画面上に表示します。

-r

このオプションを指定すると，論理ホストを削除します。このオプションは，実行系および待機系で実行してください。これによって，JP1/Base，JP1/IM，JP1/Power Monitor，およびJP1/AJSの論理ホストの共通定義情報およびサービスが削除されます。なお，共有ディスク上の共有ファイル，共有フォルダは削除されません。手作業で削除してください。

注意事項

設定は，ノードごとに実施してください。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法をIPアドレス指定方式に変更します。変更の対象は，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信のソケットのバインド方法の詳細については，OSのマニュアルを参照してください。

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

このコマンドを実行すると，ローカルディスク上にあるイベントサービスのイベントサーバインデックスファイル（インストール先フォルダ¥conf¥event¥index）に「論理ホスト名」と「共有ディスク上のフォルダ名¥event」が自動設定されます。また，「共有ディスク上のフォルダ名¥event」下にイベントサーバ設定ファイル（conf）および転送設定ファイル（forward）が作成されます。

戻り値

0

正常終了

1

異常終了

jbs_spmd（UNIX限定）

機能

イベントサービス以外のJP1/Baseのプロセスを起動します。イベントサービス以外で障害が発生した場合，イベントサービスを終了する必要はありません。jbs_spmd_stopコマンドを使って，イベントサービス以外のJP1/Baseのプロセスを終了し，このコマンドで再起動します。イベントサービス以外のJP1/Baseプロセスの終了については，jbs_spmd_stopコマンドを参照してください。

形式

jbs_spmd [-h 論理ホスト名]
         [-HA]

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，起動する論理ホスト名を指定します。指定できる文字数は，1〜255（バイト）です。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-HA

クラスタシステムで，プロセス管理の対象プロセスが一つでも異常終了した場合に，プロセス管理を終了させたいときに指定します。

注意事項

このコマンドによって，JP1/Baseのプロセスが起動したかどうか確認する場合は，jbs_spmd_statusコマンドを実行してください。

同一ホスト上で，jbs_spmdコマンドを同時に複数実行することはできません。

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/Baseのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

戻り値

0

正常終了

0以外の値

異常終了

jbs_spmd_reload

機能

イベントサービス以外のJP1/Baseのプロセスを再読み込みします。

形式

jbs_spmd_reload [-h 論理ホスト名]
                [-t 時間（秒）]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，再読み込みしたい論理ホスト名を指定します。指定できる文字数は，1〜255（バイト）です。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-t 時間（秒）

jbs_spmd_reloadコマンドの実行終了を待つ時間を指定します。指定できる値は，0〜32,767（秒）です。指定した時間内にjbs_spmd_reloadコマンドの実行が終わらない場合，jbs_spmd_reloadコマンドの実行が失敗したと見なします。省略した場合は，60秒が設定されます。

注意事項

イベントサービスの環境設定は再読み込みされません。イベントサービスの環境設定の変更を反映するには，イベントサービスの再起動が必要です。

同一ホスト上で，jbs_spmd_reloadコマンド，jbs_spmd_statusコマンド，jbs_spmd_stopコマンドを同時に複数実行することはできません。

JP1/IM - Viewなどのビューアーからログイン中に，認証サーバホストでjbs_spmd_reloadコマンドを実行すると，ログイン認証が無効になる場合があります。このような場合には，再度ログインしてください。

DSユーザーのJP1認証情報をディレクトリサーバから再読み込みするとき，ユーザー名が標準ユーザーと重複した場合やJP1ユーザー名の文字制限などでJP1ユーザーとしては対象外となることがあります。jbslistuserコマンドおよびjbslistaclコマンドで有効なユーザー名を確認してください。なお，対象外となったユーザーについては，認証サーバの統合トレースログの警告メッセージで確認できます。

戻り値

0

正常終了

0以外の値

異常終了

jbs_spmd_status

機能

イベントサービス以外のJP1/Baseの管理するプロセス群が起動または終了しているかどうかを確認します。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合

jbssessionmgr

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

認証サーバが設定されていない場合

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

JP1/Baseの管理するプロセスについては，「付録B　プロセス一覧」を参照してください。

形式

jbs_spmd_status [-h 論理ホスト名]
                [-t 時間（秒）]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，JP1/Baseの管理するプロセス群が起動または終了しているかどうか確認したい論理ホスト名を指定します。指定できる文字数は，1〜255（バイト）です。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-t 時間（秒）

jbs_spmd_statusコマンドの実行終了を待つ時間を指定します。指定できる値は，0〜32,767（秒）です。指定した時間内にjbs_spmd_statusコマンドの実行が終わらない場合，jbs_spmd_statusコマンドの実行が失敗したと見なします。省略した場合は，60秒が設定されます。

注意事項

同一ホスト上で，jbs_spmd_statusコマンド，jbs_spmd_reloadコマンド，jbs_spmd_stopコマンドを同時に複数実行することはできません。

戻り値

0

すべてのプロセスが起動している

1

プロセス管理との通信などでエラーが発生した，またはクラスタシステムで運用している場合に共有フォルダ（共有ディレクトリ）がマウントされていない

4

一部のプロセスが起動している

8

すべて停止している

12

要求処理中，またはタイムアウトした（リトライできます）

jbs_spmd_stop

機能

イベントサービス以外のJP1/Baseのプロセスを終了します。イベントサービス以外で障害が発生した場合，イベントサービスを終了しないでJP1/Baseのプロセスを終了したい場合に便利です。再起動についてはjbs_spmdコマンドを参照してください。

形式

jbs_spmd_stop [-h 論理ホスト名]
              [-kill]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，プロセスを終了する論理ホスト名を指定します。指定できる文字数は，1〜255（バイト）です。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-kill

このオプションを指定すると，強制終了を実行します。

注意事項

JP1/Baseのプロセスが終了したかどうか確認する場合は，jbs_spmd_statusコマンドを実行してください。

このコマンドでは，ログファイルトラップ管理デーモンは終了しません。ログファイルトラップ管理デーモンを終了する場合は，このコマンドとは別途jevlogdstopコマンドを実行してください。

同一ホスト上で，jbs_spmd_stopコマンド，jbs_spmd_reloadコマンド，jbs_spmd_statusコマンドを同時に複数実行することはできません。

戻り値

0

正常終了

0以外の値

異常終了

jbs_start（UNIX限定）

機能

JP1/Base（イベントサービス，ユーザー管理機能を含むプロセス管理機能，およびログファイルトラップ管理デーモン）を起動します。

このコマンドを使って，JP1/Baseを自動起動させるには，JP1/Baseのインストールとセットアップの完了後，次に示す操作が必要です。

cd /etc/opt/jp1base
cp -p jbs_start.model jbs_start

形式

jbs_start

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/etc/opt/jp1base/

注意事項

JP1/Baseのプロセス群に起動要求を出したあと，戻り値0で終了します。プロセス群が正しく起動したかどうかは，jbs_startコマンドの終了後，jbs_spmd_statusコマンドで確認してください。

Linuxの場合，標準設定でコアファイル出力時の最大サイズが「0」となっていることがあります。この場合，コアダンプは出力されません。このため，コアダンプが出力できるように，jbs_startスクリプトおよびjbs_start.clusterスクリプトは，標準で次のように設定されています。

if [ 'uname' = Linux ]; then
ulimit -c unlimited
fi

この設定がご使用マシンのセキュリティポリシーに反する場合は，次のように行の先頭に「#」を付けてコメント行に変更してください。

#if [ 'uname' = Linux ]; then
#ulimit -c unlimited
#fi

コメント行に変更すると，ファイルの設定は無効になります。ただし，JP1/Baseのプロセスのセグメンテーション障害やバス障害などのコアダンプ出力契機にコアダンプが出力されないため，調査ができないことがあります。

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/Baseのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

次に示すような場合，自動起動スクリプトの環境変数LANGの言語種別を日本語にする必要があります。

転送設定ファイル（forward）のイベントフィルターに日本語を指定する場合

ユーザープログラム内でJP1イベント取得関数（JevGetOpen）のlpszFilterパラメーターに日本語を指定する場合

JP1/IMを使用してJP1/IMの各種フィルターに日本語を指定する場合※

注※　言語種別の設定が必要なサーバの条件については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

自動起動スクリプト（jbs_start）は，初期設定でLC_ALL，LC_COLLATE，LC_CTYPE，LC_MONETARY，LC_NUMERIC，LC_TIME，およびLC_MESSAGESのロケール設定を解除（unset）します。

戻り値

0

正常終了

1

引数が二つ以上指定されている

jbs_start.cluster（UNIX限定）

機能

クラスタシステムでJP1/Base（イベントサービス，ユーザー管理機能を含むプロセス管理機能，およびログファイルトラップ管理デーモン）を起動します。このコマンドを実行する場合は，クラスタソフトにこのコマンドを登録する必要があります。

このコマンド内では，次に示すコマンドを実行しています。

jevstart 論理ホスト名

jbs_spmd -h 論理ホスト名

形式

jbs_start.cluster 論理ホスト名

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/etc/opt/jp1base/

引数

論理ホスト名

このコマンドを実行させたい論理ホスト名を指定します。

注意事項

JP1/Baseのプロセス群に起動要求を出したあと，戻り値0で終了します。プロセス群が正しく起動したかどうかは，jbs_start.clusterコマンドの終了後，jbs_spmd_statusコマンドで確認してください。

Linuxの場合，標準設定でコアファイル出力時の最大サイズが「0」となっていることがあります。この場合，コアダンプは出力されません。このため，コアダンプが出力できるように，jbs_startスクリプトおよびjbs_start.clusterスクリプトは，標準で次のように設定されています。

if [ 'uname' = Linux ]; then
ulimit -c unlimited
fi

この設定がご使用マシンのセキュリティポリシーに反する場合は，次のように行の先頭に「#」を付けてコメント行に変更してください。

#if [ 'uname' = Linux ]; then
#ulimit -c unlimited
#fi

コメント行に変更すると，ファイルの設定は無効になります。ただし，JP1/Baseのプロセスのセグメンテーション障害やバス障害などのコアダンプ出力契機にコアダンプが出力されないため，調査ができないことがあります。

jbs_start.clusterコマンドを実行すると，ログファイルトラップ管理デーモンがすでに起動しているというメッセージが出力されることがあります。このメッセージを出力させたくない場合は，jbs_start.clusterスクリプトを変更してください。なお，09-50以降のJP1/Baseを新規インストールした場合は，変更する必要はありません。

jbs_start.clusterスクリプトは，標準で次のように設定されています。

## Start services
echo "Please wait a minutes, now starting JP1/Base..."
if [ "$LHHOST" ]; then
        /opt/jp1base/bin/jevstart ${LHHOST}
        /opt/jp1base/bin/jevlogdstart
else
        /opt/jp1base/bin/jevstart
        /opt/jp1base/bin/jevlogdstart
fi

次のように変更してください。

## Start services
echo "Please wait a minutes, now starting JP1/Base..."
if [ "$LHHOST" ]; then
        /opt/jp1base/bin/jevstart ${LHHOST}
        /opt/jp1base/bin/jevlogdstat >/dev/null 2>/dev/null
        if [ $? -ne 0 ]; then
            /opt/jp1base/bin/jevlogdstart
        fi
else
        /opt/jp1base/bin/jevstart
        /opt/jp1base/bin/jevlogdstart
fi

このコマンドをリモートシェルコマンドで実行する場合，標準入力，標準出力，および標準エラー出力を切断（標準入力，標準出力，標準エラー出力に/dev/nullを割り当てる）しておいてください。JP1/Baseのプロセスの起動が完了しても，リモートシェルコマンドが終了しないおそれがあります。

次に示すような場合，自動起動スクリプトの環境変数LANGの言語種別を日本語にする必要があります。

転送設定ファイル（forward）のイベントフィルターに日本語を指定する場合

ユーザープログラム内でJP1イベント取得関数（JevGetOpen）のlpszFilterパラメーターに日本語を指定する場合

JP1/IMを使用してJP1/IMの各種フィルターに日本語を指定する場合※

注※　言語種別の設定が必要なサーバの条件については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

論理ホスト用の自動起動スクリプト（jbs_start.cluster）は，初期設定でLC_ALL，LC_COLLATE，LC_CTYPE，LC_MONETARY，LC_NUMERIC，LC_TIME，およびLC_MESSAGESのロケール設定を解除（unset）します。

戻り値

0

正常終了

1

引数が二つ以上指定されている

jbs_stop（UNIX限定）

機能

JP1/Base（イベントサービスやユーザー管理を含むプロセス管理機能）を終了します。

このコマンドを使って，JP1/Baseを自動終了させるには，JP1/Baseのインストールとセットアップの完了後，次に示す操作が必要です。

cd /etc/opt/jp1base
cp -p jbs_stop.model jbs_stop

形式

jbs_stop

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/etc/opt/jp1base/

注意事項

ログファイルトラップ管理デーモンは，物理ホスト，論理ホスト共通のデーモンのため，jbs_stopコマンドでは，ログファイルトラップ管理デーモンを終了できません。jbs_stopコマンドと合わせてjevlogdstopコマンドを実行すれば，ログファイルトラップ管理デーモンを終了できますが，論理ホストでログファイルトラップ管理デーモンを利用していた場合，論理ホスト用のログファイルトラップが使用できなくなります。jevlogdstopコマンドを実行する場合は，論理ホストでログファイルトラップを使用していないか十分に確認してください。

JP1/Baseのプロセス群に停止要求を出したあと，戻り値0で終了します。プロセス群が正しく停止したかどうかは，jbs_stopコマンドの終了後，jbs_spmd_statusコマンドで確認してください。

戻り値

0

正常終了

1

引数が二つ以上指定されている

jbs_stop.cluster（UNIX限定）

機能

クラスタシステムでJP1/Base（イベントサービスやユーザー管理機能を含むプロセス管理機能）を終了します。このコマンドを実行する場合は，クラスタソフトにこのコマンドを登録する必要があります。

なお，このコマンド内では，次に示すコマンドを実行しています。

jevstop 論理ホスト名

jbs_spmd_stop -h 論理ホスト名

形式

jbs_stop.cluster 論理ホスト名

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/etc/opt/jp1base/

引数

論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。

注意事項

ログファイルトラップ管理デーモンは，物理ホスト，論理ホスト共通のデーモンのため，jbs_stop.clusterコマンドでは，ログファイルトラップ管理デーモンを終了できません。jbs_stop.clusterコマンドの実行後，jevlogdstopコマンドを実行すれば，ログファイルトラップ管理デーモンを終了できますが，物理ホストでログファイルトラップ管理デーモンを利用していた場合，物理ホスト用のログファイルトラップが使用できなくなります。jevlogdstopコマンドを実行する場合は，物理ホストでログファイルトラップを使用していないか十分に確認してください。

JP1/Baseのプロセス群に停止要求を出したあと，戻り値0で終了します。プロセス群が正しく停止したかどうかは，jbs_stop.clusterコマンドの終了後，jbs_spmd_statusコマンドで確認してください。

リソースの停止と並行してリソースの動作監視が要求されるクラスタシステムでは，停止コマンドが失敗し，正常に停止しないおそれがあります。そのため，リトライを実施することで，JP1/Baseを正常に停止できる停止コマンドを提供しています。次に示す手順で，コマンド内容を変更して使用してください。

cd /etc/opt/jp1base
cp -p jbs_stop.cluster.retry.model jbs_stop.cluster

戻り値

0

正常終了

1

引数が二つ以上指定されている

jbsacllint

機能

JP1ユーザーの操作権限に関する定義情報を整理して，標準出力で出力します。定義情報とは，アクセス権限レベルファイル（JP1_AccessLevel）およびユーザー権限レベルファイル（JP1_UserLevel）を表します。

形式

jbsacllint [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

定義情報を表示させたい認証サーバ上でこのコマンドを実行してください。

戻り値

0

正常終了

2

引数誤り

4

メモリーなどシステムリソースが不足した

128

内部処理で矛盾を生じた（C++の例外）

255

そのほかのエラー

jbsaclreload

機能

JP1ユーザーの操作権限に関する定義情報を認証サーバに再読み込みさせ，反映させます。-dsオプションを指定しない場合，定義情報はアクセス権限レベルファイル（JP1_AccessLevel）およびユーザー権限レベルファイル（JP1_UserLevel）を表します。-dsオプションを指定した場合，定義情報はアクセス権限レベルファイル（JP1_AccessLevel）およびJP1認証情報（ディレクトリサーバで管理）を表します。

形式

jbsaclreload [-h 論理ホスト名]
             [-s 認証サーバ名]
             [-ds※]

注※

-dsオプションは，Windowsだけで使用できます。

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている，JP1ユーザーの操作権限に関する定義情報を再読み込みします。

-s 認証サーバ名

JP1ユーザーの操作権限に関する定義情報を再読み込みしたい認証サーバを指定します。このオプションを指定した場合，-hオプションは無視されます。

-ds

このオプションは，Windowsの場合だけ使用できます。

DSユーザーのJP1認証情報をディレクトリサーバから再読み込みする場合に指定します。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して指定された認証サーバの操作権限に関する定義情報を再読み込みします。

DSユーザーのJP1認証情報をディレクトリサーバから再読み込みするとき，ユーザー名が標準ユーザーと重複した場合やJP1ユーザー名の文字制限などでJP1ユーザーとしては対象外となることがあります。jbslistuserコマンドおよびjbslistaclコマンドで有効なユーザー名を確認してください。なお，対象外となったユーザーについては，認証サーバの統合トレースログの警告メッセージで確認できます。

このコマンドの実行結果が異常終了した場合は，認証サーバの統合トレースログのエラーメッセージを確認して，要因を取り除いてください。

戻り値

0

正常終了

2

引数誤り

4

メモリーなどシステムリソースが不足した

8

認証サーバが未起動または応答しない

12

DSユーザー使用時に認証サーバ側でエラーが生じた

16

認証サーバ側の処理でエラーが発生した

32

通信機能の初期化中にエラーが発生した

128

内部処理で矛盾を生じた（C++の例外）

255

そのほかのエラー

jbsadduser

機能

JP1ユーザーを登録します。このコマンドを実行すると，登録するJP1ユーザーに対するパスワードの入力が促されます。-pオプションを指定した場合は，パスワードの入力は促されずに指定したパスワードが登録されます。-dsオプションを指定した場合は，パスワードを入力しないで連携ユーザーを登録できます。

形式

jbsadduser [-h 論理ホスト名]
           [-s 認証サーバ名]
           [-p パスワード | -ds※]
            JP1ユーザー名

注※

-dsオプションは，Windowsだけで使用できます。

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバにJP1ユーザーを登録します。

-s 認証サーバ名

JP1ユーザーを登録したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-p パスワード

標準ユーザーのパスワードを指定します。大文字と小文字は区別されます。パスワードに指定できる文字数は，6〜32（バイト）です。また，パスワードに使用できる文字は，¥ " :とタブ・スペースを除くASCII文字だけです。このオプションを指定した場合，パスワードの入力は促されずに指定したパスワードが登録されます。

-ds

このオプションは，Windowsだけで使用できます。

連携ユーザーを登録する場合に指定します。このオプションを指定して登録したJP1ユーザーがログインするときは，ディレクトリサーバが管理しているパスワードを入力してください。

JP1ユーザー名

JP1ユーザーとして登録したいユーザー名を指定します。JP1ユーザー名には，小文字しか使用できません。指定できる文字数は，1〜31（バイト）です。また，JP1ユーザー名に使用できる文字は，* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < >とタブ・スペースを除くASCII文字だけです。

注意事項

-hオプションによる論理ホスト名の指定，-sオプションによる認証サーバ名の指定，-pオプションによるパスワードの指定，および-dsオプションによる連携ユーザーの指定は，JP1ユーザー名の前に指定してください。

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して指定された認証サーバにJP1ユーザーを登録します。

DSユーザーにはこのコマンドは使用できません。ディレクトリサーバでユーザーの作成をしてください。

コマンドプロンプト上では¥ * & ? ＾ %（任意の文字）%は，特殊文字として扱われます。パスワードで入力した文字として認識されない場合がありますのでご注意ください。

戻り値

0

正常終了

1

ユーザーは登録済み

2

引数誤り

4

メモリーなどシステムリソースが不足した

8

認証サーバが未起動または応答しない

16

認証サーバ側の処理でエラーが発生した

24

不正なパスワード

32

通信機能の初期化中にエラーが発生した

128

内部処理で矛盾を生じた（C++の例外）

255

そのほかのエラー

jbsadmin（Windows限定）

機能

JP1/Base管理者コンソールを起動します。JP1/Base管理者コンソールでは，JP1/Baseが提供する管理者権限が必要なコマンドを実行できます。

形式

jbsadmin

実行権限

Administrators権限

格納先ディレクトリ

インストール先フォルダ¥bin¥

jbsblockadesrv

機能

指定した認証サーバへの接続を閉塞状態にします。

形式

jbsblockadesrv [-h 論理ホスト名]
                -s 認証サーバ名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，接続先認証サーバを設定している論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-s 認証サーバ名

閉塞状態にしたい認証サーバ名を指定します。

戻り値

0

認証サーバを閉塞状態にした

1

認証サーバはすでに閉塞状態になっている

17

指定された認証サーバは閉塞状態にできない

0，1，17以外

異常終了

使用例

プライマリー認証サーバがserver1，セカンダリー認証サーバがserver2で，jbsblockadesrvコマンドを実行してserver2を閉塞状態にすると，次のように表示されます。

jbsblockadesrv -s server2
プライマリー:server1
セカンダリー:server2:閉塞中

jbscancellcact

機能

実行待ちおよび実行中のローカルアクションをキャンセルします。実行中のコマンドをキャンセルした場合，実行プロセスと子プロセスもキャンセルします。

形式

jbscancellcact [-h 論理ホスト名]
              アクション番号

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していないときは，物理ホスト名が仮定されます。

アクション番号

キャンセルしたいローカルアクションのアクション番号を指定します。jbslistlcactコマンドで表示される一覧からアクション番号がわかります。

戻り値

0

正常終了

1

指定されたアクションは実行待ちまたは実行中として存在しない

255

そのほかのエラー

jbschgds（Windows限定）

機能

連携するディレクトリサーバを一時的に変更します。このコマンドは，ディレクトリサーバ連携機能を設定した認証サーバ上で実行してください。

形式

jbschgds [-h 論理ホスト名]
         {-f 定義ファイル | -d}

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-f 定義ファイル

ディレクトリサーバ変更ファイルを指定します。定義ファイルの格納場所および名称は任意です。ディレクトリサーバ変更ファイルについては，「16.　定義ファイル」の「ディレクトリサーバ変更ファイル（Windows限定）」を参照してください。

-d

連携するディレクトリサーバの一時的な変更を解除するときに指定します。

注意事項

DSユーザーを使用する運用の場合，認証サーバが起動中に連携するディレクトリサーバを変更したときは，JP1/Base（認証サーバ）の再起動またはリロードコマンド（jbs_spmd_reload）の実行が必要です。

戻り値

0

正常終了

2

引数誤り

4

メモリーなどシステムリソースが不足した

64

実行権限がない

128

内部処理で矛盾を生じた（C++の例外）

255

その他のエラー

jbschgpasswd

機能

登録済みのJP1ユーザーのパスワードを変更します。このコマンドを実行すると，以前設定したパスワードと新しく設定するパスワードの入力が促されます。パスワードに指定できる文字数は，6〜32（バイト）で，新旧のパスワードが同一であってもかまいません。

形式

jbschgpasswd [-h 論理ホスト名]
             [-s 認証サーバ名]
             [-op 旧パスワード -np 新パスワード]
              JP1ユーザー名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバに登録されたJP1ユーザーのパスワードを変更します。

-s 認証サーバ名

JP1ユーザーのパスワードを変更したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-op 旧パスワード

変更したい旧パスワードを指定します。-npオプションと同時に指定してください。-opオプションと-npオプションを指定すると，パスワードの入力が促されずに，-npオプションで指定したパスワードが登録されます。

-np 新パスワード

新しいパスワードを指定します。-opオプションと同時に指定してください。

JP1ユーザー名

パスワードを変更したいJP1ユーザー名を指定します。

注意事項

-hオプションによる論理ホスト名の指定，-sオプションによる認証サーバ名の指定，-opオプションによる旧パスワードの指定，および-npオプションによる新パスワードの指定は，JP1ユーザー名の前に指定してください。

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストの認証サーバに登録されたJP1ユーザーのパスワードを変更します。

コマンドプロンプト上では¥ * & ? ＾ %（任意の文字）%は，特殊文字として扱われます。パスワードで入力した文字として認識されない場合がありますのでご注意ください。

戻り値

0

正常終了

1

ユーザーが存在しない，旧パスワード誤りまたは連携ユーザーのパスワードを変更しようとした

2

引数誤り

4

メモリーなどシステムリソースが不足した

8

認証サーバが未起動または応答しない

16

認証サーバ側の処理でエラーが発生した

24

不正なパスワード

32

通信機能の初期化中にエラーが発生した

128

内部処理で矛盾を生じた（C++の例外）

255

そのほかのエラー

jbschkds（Windows限定）

機能

ディレクトリサーバ連携機能を使用しているときに，ディレクトリサーバ連携機能の設定内容，ディレクトリサーバへの接続結果およびユーザー認証結果を表示します。表示する内容を次に示します。

ディレクトリサーバ連携機能が有効かどうか

ディレクトリサーバ名

ポート番号

SSLを使用するかどうか

情報検索用ユーザー識別名

識別名（JP1ユーザー）

ディレクトリサーバへの接続結果

情報検索用ユーザー認証結果

ユーザー認証結果（JP1ユーザー）

このコマンドは，ディレクトリサーバ連携機能を設定した認証サーバ上で実行してください。

形式

jbschkds [-h 論理ホスト名]
         [-u JP1ユーザー名 -p パスワード]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-u JP1ユーザー名

ディレクトリサーバで認証するJP1ユーザー名を指定します。

-p パスワード

-uオプションで指定したユーザーのパスワードを指定します。

注意事項

コマンドプロンプト上では¥ * & ? ＾ %（任意の文字）%は，特殊文字として扱われます。パスワードで入力した文字として認識されない場合がありますのでご注意ください。

戻り値

0

正常終了

2

引数誤り

4

メモリーなどシステムリソースが不足した

64

実行権限がない

128

内部処理で矛盾を生じた（C++の例外）

255

その他のエラー

使用例

出力例を次に示します。

ディレクトリサーバ連携機能が無効のとき

>jbschkds
ディレクトリサーバ連携機能は無効です

ディレクトリサーバ連携機能が有効でJP1ユーザー認証に成功したとき（SEARCH_USER_DNパラメーターを設定している場合）

>jbschkds -u jp1user -p password
ディレクトリサーバの設定内容を表示します
  ディレクトリサーバ名 host-A
  ポート番号 636
  SSL 使用する
  情報検索用ユーザー識別名 CN=Groupcsearcher,OU=GroupC,DC=netmanage,DC=local
  検索起点コンテナオブジェクト OU=GroupC,DC=netmanage,DC=local
  認証属性 sAMAccountName
ディレクトリサーバに接続できました
情報検索用ユーザー認証に成功しました
ユーザー認証に成功しました

ディレクトリサーバ連携機能が有効でJP1ユーザー認証に成功したとき（SEARCH_USER_DNパラメーターを無効に設定している場合）

>jbschkds -u jp1user -p password
ディレクトリサーバの設定内容を表示します
  ディレクトリサーバ名 host-A
  ポート番号 636
  SSL 使用する
  識別名 CN=jp1user,CN=Users,DC=netmanage,DC=local
ディレクトリサーバに接続できました
ユーザー認証に成功しました

ディレクトリサーバ連携機能が有効でディレクトリサーバに接続できないとき

>jbschkds
ディレクトリサーバの設定内容を表示します
  ディレクトリサーバ名 host-A
  ポート番号 636
  SSL 使用する
KAVA5810-E ディレクトリサーバに接続できませんでした
サーバがダウンしています

jbsgetcnf

機能

共通定義情報の内容をすべて採取します。このコマンドを実行すると，共通定義情報を読み出し，標準出力に出力します。

形式

jbsgetcnf [-h 論理ホスト名] [-c コンポーネント名] > 退避ファイル名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，定義情報を採取したい論理ホスト名を指定します。論理ホスト名は，論理ホストのセットアップ時に指定したとおりに大文字・小文字を正しく指定してください。このオプションを省略した場合，物理ホスト名が仮定されます。

なお，クラスタシステムで使用する場合には，論理ホスト名を必ず指定してください。環境変数JP1_HOSTNAMEは使用できません。

このオプション以外の誤った引数を指定した場合は，誤った引数以降はすべて無視します。

-c コンポーネント名

定義情報を採取したいコンポーネント名を指定します。

退避ファイル名

共通定義情報を退避するファイル名を指定します。

注意事項

共通定義情報の出力時の改行コードは，Windowsの場合は「CR，CR，LF」（0x0D，0x0D，0x0A），UNIXの場合は「LF」（0x0A）となります。

出力した内容をエディター等で編集・保存する場合は，上記の点に注意してください。

戻り値

0

正常終了

-1

異常終了

使用例

物理ホストのJP1/Baseの共通定義情報を取得します。

jbsgetcnf -c JP1BASE > config.txt

論理ホストlogicalのJP1/Baseの共通定義情報を取得します。

jbsgetcnf -h logical -c JP1BASE > config.txt

jbsgetopinfo

機能

稼働情報を採取し，定義ファイルの記述形式に変換して標準出力に出力します。稼働情報として採取できるのは，イベント転送の定義情報，ログファイルトラップの定義情報，SSL通信の設定情報，およびイベントログトラップの定義情報です。

形式

jbsgetopinfo [-h 論理ホスト名 | イベントサービス名]
             [-o 稼働情報名,...]
             [-i ID番号 | -a 監視名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

稼働情報を採取したい論理ホスト名またはイベントサービス名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-o 稼働情報名,...

採取したい稼働情報名を指定します。このオプションを省略した場合，すべての稼働情報名を指定したと仮定されます。複数の稼働情報名を指定する場合，「,」で区切って指定します。

指定できる稼働情報名を次に示します。

forward

稼働している転送設定ファイルの定義情報を出力します。転送設定ファイルの記述形式については，「16.　定義ファイル」の「転送設定ファイル」を参照してください。

logtrap

jevlogstartコマンドおよびJP1/AJSのログファイル監視ジョブで起動したすべてのログファイルトラップのうち，稼働しているログファイルトラップ動作定義ファイルの定義情報を出力します。-hオプションで論理ホストまたはイベントサービスを指定した場合，物理ホストの稼働情報を採取します。ログファイルトラップ動作定義ファイルの記述形式については，「16.　定義ファイル」の「ログファイルトラップ動作定義ファイル」を参照してください。

evttrap

稼働しているイベントログトラップ動作定義ファイルの定義情報を出力します。-hオプションで論理ホストまたはイベントサービスを指定した場合，物理ホストの稼働情報を採取します。この稼働情報名は，Windowsの場合にだけ指定できます。イベントログトラップ動作定義ファイルの記述形式については，「16.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」を参照してください。

SSL

稼働しているSSL通信定義ファイルの定義情報を出力します。SSL通信定義ファイルの記述形式については，「16.　定義ファイル」の「SSL通信定義ファイル」を参照してください。

-i ID番号 | -a 監視名

このオプションは，稼働情報名にlogtrapを指定した場合にだけ指定できます。ID番号には，稼働情報を採取したいログファイルトラップのID番号を指定します。監視名には，稼働情報を採取したいログファイルトラップの監視名を指定します。ID番号と監視名のどちらか一方を指定します。稼働情報名にlogtrapを指定して，このオプションを省略した場合は，稼働しているすべてのログファイルトラップの定義情報が採取されます。

注意事項

指定した稼働情報名の定義情報が存在しない場合，エラーになります。複数の稼働情報名を指定した場合は，存在する定義情報を出力します。

指定したID番号または監視名のログファイルトラップが存在しない場合，ログファイルトラップの定義情報は出力されません。

SSL定義が未設定の場合，稼働情報名にSSLを指定するとイベントサービスまたはプロセスの稼働情報を出力します。

戻り値

0

正常終了

1

引数エラー

2

稼働情報なし

248

稼働情報ファイルが壊れている

249

指定した論理ホスト名が存在しない

250

リロード未反映

251

他でアクセス中

252

実行権限なし

253

UACエラー

254

メモリー不足

255

そのほかのエラー

出力形式

設定情報の出力形式を次に示します。定義内容の出力順序はSSL通信定義モデルファイルの記載順序に合わせています。

物理ホスト名，論理ホスト名またはイベントサービス名の稼働情報（SSL）を表示します。

<プロセス名※1>
"ENABLE"※2="ENABLEラベルの指定値"
"SSLPROTOCOL"※3="SSLPROTOCOLラベルの指定値"
"CACERTIFICATEFILE"※3="CACERTIFICATEFILEラベルの指定値"
"CERTIFICATEFILE"※3="CERTIFICATEFILEラベルの指定値"
"PRIVATEKEYFILE"※3="PRIVATEKEYFILEラベルの指定値"
"SSLCIPHERS"※3="SSLCIPHERSラベルの指定値"
"BASESSL"※4="0"または"1"

注※1

制御するプロセス名を出力します。表示順序は次の通りです。

<jbssessionmgr>：認証サーバ

<jbsroute>：構成管理

<jcocmd>：コマンド実行

<jbsplugind>：プラグインサービス

<jbscomd>：プロセス間通信

<jevservice>：イベントサービス

注※2

常に出力されます。

注※3

ENABLEおよびBASESSLが1の場合だけ出力されます。パラメーター名が未定義の場合は，空文字が出力されます。

注※4

ENABLEが1の場合だけ出力されます。SSLが有効な場合は，dword:00000001，SSLが無効な場合は，dword:00000000が出力されます。

使用例

出力例を次に示します。

jbsgetumap

機能

登録済みのユーザーマッピング情報の一覧を表示します。

このコマンドを実行すると，登録済みのユーザーマッピング情報を読み込み，jbsmkumapコマンドで登録したユーザーマッピング定義ファイル（jp1BsUmap.conf）の形式で標準出力に出力します。

形式

jbsgetumap [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，ユーザーマッピング情報の一覧を表示したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

戻り値

1

正常終了

0

異常終了

jbshostsexport

機能

共通定義情報に登録されたjp1hosts情報を採取し，標準出力に出力します。

形式

jbshostsexport [-h 論理ホスト名] > jp1hosts定義ファイル名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，jp1hosts情報を採取したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

jp1hosts定義ファイル名

jp1hosts情報を採取するファイル名を指定します。

戻り値

0

正常終了

1

メッセージ処理エラー

2

コマンド引数エラー

3

権限チェックエラー

4

共通定義エラー

jbshosts2export

機能

ホストに登録されたjp1hosts2情報を採取し，標準出力に出力します。

形式

jbshosts2export [-h 論理ホスト名] > jp1hosts2定義ファイル名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

jp1hosts2情報を採取したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

クラスタシステムで運用している論理ホストで，このコマンドを実行する場合は，実行系で実行してください。

jp1hosts2定義ファイル名

jp1hosts2情報を採取するファイル名を指定します。

戻り値

0

正常終了

1

メッセージ処理エラー

2

コマンド引数エラー

3

権限チェックエラー

4

共通定義エラー

5

ファイルI/Oエラー

jbshostsimport

機能

jp1hosts情報を共通定義情報に登録します。

形式

jbshostsimport { {-o|-r} jp1hosts定義ファイル名 [-f] | -d }
               [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

{-o|-r} jp1hosts定義ファイル名

共通定義情報に登録したいjp1hosts情報を定義したファイル名を指定します。-oオプションを指定した場合は，共通定義情報に登録済みのjp1hosts情報を削除しないで新規にjp1hosts情報を登録します（同一ホストが存在した場合は上書きします）。-oオプションを指定した場合のjp1hosts情報について，次の図に示します。

-rオプションを指定した場合は，共通定義情報に登録済みのjp1hosts情報をすべて削除してからjp1hosts情報を登録します。-rオプションを指定した場合のjp1hosts情報について，次の図に示します。

jp1hosts定義ファイルの記述形式については，「16.　定義ファイル」の「jp1hosts定義ファイル」を参照してください。

-f

このオプションを指定した場合は，jp1hosts2情報が設定されている環境に対してjp1hosts情報を強制的に登録します。

-d

共通定義情報に登録されたjp1hosts情報を削除したい場合に指定します。

-h 論理ホスト名

クラスタシステムで運用している場合に，jp1hosts情報を登録または削除したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

注意事項

JP1/Baseを起動しているときは，このコマンドを使用しないでください。

jp1hosts2情報が設定されている環境で，-oオプションまたは-rオプションを指定してこのコマンドを実行すると，KAVA0443-Eメッセージが出力され，戻り値8のエラーとなります。ただし，-oオプションまたは-rオプションと同時に-fオプションを指定した場合は，jp1hosts情報を強制的に登録するため，エラーになりません（KAVA0443-Eメッセージも出力されません）。

戻り値

0

正常終了

1

メッセージ処理エラー

2

コマンド引数エラー

3

権限チェックエラー

4

共通定義エラー

5

文法エラー

6

ファイルI/Oエラー

8

jp1hosts2情報がインポート済みのためjp1hosts情報をインポートできない

使用例

jp1hosts2情報が設定されている環境に，jp1hosts情報を設定する場合の使用例を次に示します。

jp1hosts2情報が設定された環境に対して，-fオプションを指定してコマンドを実行します。

>jbshostsimport -o jp1hosts情報定義ファイル -f
KAVA0436-I  処理が成功しました。

jp1hosts2情報が設定された環境に対して，-fオプションを指定しないでコマンドを実行した場合，エラーになります。

>jbshostsimport -o jp1hosts情報定義ファイル
KAVA0443-E  jp1hosts2が適用されているため実行できません

jbshosts2import

機能

jp1hosts2情報をホストに登録します。

形式

jbshosts2import { {-o|-r} [jp1hosts2定義ファイル名] | -d }
                [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

{-o|-r} jp1hosts2定義ファイル名

ホストに登録したいjp1hosts2情報を定義したファイル名を指定します。-oオプションを指定した場合は，登録済みのjp1hosts2情報を削除しないで新規にjp1hosts2情報を登録します（同一ホストが存在した場合は上書きします）。-oオプションを指定した場合のjp1hosts2情報について，次の図に示します。

-rオプションを指定した場合は，登録済みのjp1hosts2情報をすべて削除してからjp1hosts2情報を登録します。-rオプションを指定した場合のjp1hosts2情報について，次の図に示します。

なお，jp1hosts2定義ファイル名の指定を相対パスで指定した場合，このコマンドを実行するカレントディレクトリからの相対パスになります。また，jp1hosts2定義ファイル名の指定を省略した場合は，次に示す格納先ディレクトリのjp1hosts2定義ファイルをインポートします。

Windowsの場合

インストール先フォルダ¥conf¥jp1hosts2.conf

共有フォルダ¥jp1base¥conf¥jp1hosts2.conf（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/jp1hosts2.conf

共有ディレクトリ/jp1base/conf/jp1hosts2.conf（クラスタ運用時）

jp1hosts2定義ファイルの記述形式については，「16.　定義ファイル」の「jp1hosts2定義ファイル」を参照してください。

-d

ホストに登録されたjp1hosts2情報を削除したい場合に指定します。

-h 論理ホスト名

jp1hosts2情報を登録または削除したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

クラスタシステムで運用している論理ホストで，このコマンドを実行する場合は，実行系で実行してください。

注意事項

このコマンドを実行して次に示す設定をした場合，JP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムを再起動する必要があります。

jp1hosts2情報の自ホストのIPアドレスの割り当てを変更した。

jp1hosts2情報のすでに通信中の他ホストのIPアドレスを変更した。

jp1hosts情報が設定されている，かつjp1hosts2情報が設定されていない環境でこのコマンドを実行すると，KAVA0455-Iの確認メッセージが出力されます。

jp1hosts情報を使用している環境にjp1hosts2情報を登録する場合，事前にjp1hosts情報に定義している内容をjp1hosts2情報へ移行してください。移行方法については，「6.4.5　jp1hosts情報からjp1hosts2情報への移行」を参照してください。

クラスタシステムで論理ホストにjp1hosts情報を適用している環境で，物理ホストにjp1hosts2情報をインポートした場合，物理ホストにインポートしたjp1hosts2情報の内容が論理ホストでも有効になって，論理ホストに定義していたjp1hosts情報の内容は無効になります。

戻り値

0

正常終了

1

メッセージ処理エラー

2

コマンド引数エラー

3

権限チェックエラー

4

共通定義エラー

5

文法エラー

6

ファイルI/Oエラー

7

ほかのjbshosts2importコマンドが実行中

jbslistacl

機能

登録済みのJP1ユーザーまたはDSグループの操作権限を表示します。JP1ユーザーは標準ユーザー，連携ユーザー，およびDSユーザーが該当します。

形式

jbslistacl [-h 論理ホスト名]
           [-s 認証サーバ名]
           [-ds※]

注※

-dsオプションは，Windowsだけで使用できます。

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバに登録されているJP1ユーザーまたはDSグループの操作権限が表示されます。

-s 認証サーバ名

登録済みJP1ユーザーまたはDSグループの操作権限を表示したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-ds

このオプションは，Windowsの場合だけ使用できます。

DSユーザーの操作権限を表示する場合に指定します。また，DSグループにも操作権限の登録がある場合は，DSユーザーの前にDSグループに設定されている操作権限も表示します。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストの認証サーバの登録済みJP1ユーザーまたはDSグループが表示されます。

戻り値

0

正常終了

1

認証サーバにユーザーが登録されていない

2

引数誤り

4

メモリーなどシステムリソースが不足した

8

認証サーバが未起動または応答しない

12

DSユーザー使用時に認証サーバ側でエラーが生じた

16

認証サーバ側の処理でエラーが生じた

32

通信機能の初期化中にエラーが生じた

128

内部処理で矛盾を生じた（C++の例外）

255

そのほかのエラー

使用例

jbslistaclコマンドの出力例を次に示します。

オプションを指定しない場合

>jbslistacl
UserLevel No.0
  Name         :user-001
   GroupName:*
    AccessLevel:JP1_AJS_Editor
UserLevel No.1
  Name         :user-admin
   GroupName:*
    AccessLevel:JP1_AJS_Admin
    AccessLevel:JP1_Console_Admin

-dsオプションを指定した場合

>jbslistacl -ds
DSGroupLevel No.0
  DSGroupName:GRP-AJS
   GroupName:*
    AccessLevel:JP1_AJS_Editor
DSGroupLevel No.1
  DSGroupName:GRP-Adm
   GroupName:*
    AccessLevel:JP1_AJS_Admin
    AccessLevel:JP1_Console_Admin

UserLevel No.0
  Name         :user-001
   GroupName:*
    AccessLevel:JP1_AJS_Editor[GRP-AJS]
UserLevel No.1
  Name         :user-admin
   GroupName:*
    AccessLevel:JP1_AJS_Admin[GRP-Adm]
    AccessLevel:JP1_Console_Admin[GRP-Adm]

jbslistlcact

機能

実行待ちおよび実行中のローカルアクションの一覧を表示します。

形式

jbslistlcact [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

戻り値

0

正常終了

1

実行待ちおよび実行中のアクションがない

255

そのほかのエラー

出力例

jbslistlcactコマンドを実行して出力される例を次に示します。

act-No      act-Name      Status      Command
1122        JOB10         実行中      abc.exe
1334        JOB22         実行待ち    xyz.bat

act-Noにはアクション番号，act-Nameにはアクション名，Statusにはアクションの実行状態，Commandにはコマンドの先頭文字列が出力されます。コマンドに属性変数名が指定されている場合，展開して出力されます。

jbslistsrv

機能

共通定義情報に設定されている接続先認証サーバを画面に表示します。

形式

jbslistsrv [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，接続先認証サーバを設定している論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

戻り値

0

正常終了

0以外

異常終了

使用例

使用例を次に示します。

（例1）

プライマリー認証サーバがserver1，セカンダリー認証サーバがserver2の場合に，jbslistsrvコマンドを実行すると，次のように表示されます。

jbslistsrv
プライマリー:server1
セカンダリー:server2

（例2）

プライマリー認証サーバがserver1，セカンダリー認証サーバがserver2でserver1が閉塞状態であった場合に，jbslistsrvコマンドを実行すると，次のように表示されます。

jbslistsrv
プライマリー:server1:閉塞中
セカンダリー:server2

（例3）

接続先認証サーバ（認証サーバ名：server1）を1台しか設定していなかった場合に，jbslistsrvコマンドを実行すると，次のように表示されます。

jbslistsrv
プライマリー:server1

jbslistuser

機能

登録済みJP1ユーザーの一覧を表示します。

形式

jbslistuser [-h 論理ホスト名]
            [-s 認証サーバ名]
            [-ld]
            [-ds※]

注※

-dsオプションは，Windowsだけで使用できます。

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバの登録済みJP1ユーザーが表示されます。

-s 認証サーバ名

登録済みJP1ユーザーを表示したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-ld

JP1ユーザーごとに最終更新日付（yyyy/mm/dd△HH:MM:SS形式）を出力します。最終更新日付は，JP1ユーザーを登録した日付またはパスワードを変更した日付です。なお，08-10へバージョンアップする前に登録されたJP1ユーザー，新規インストールで初期設定されるJP1ユーザー，連携ユーザー，およびDSユーザーの最終更新日付はハイフン（----/--/-- --:--:--）で表示されます。［JP1/Base環境設定］ダイアログボックス，またはパスワード変更コマンド（jbschgpasswd）でパスワードを変更したあと，最終更新日付が表示されます。

-dsオプションを指定した場合は，このオプションの指定は無視されます。

-ds

このオプションは，Windowsだけで使用できます。

このオプションを指定した場合，連携ユーザーまたはDSユーザーだけを表示します。表示されるJP1ユーザーはディレクトリサーバ連携定義ファイルのENABLEパラメーターの設定によって変わります。

"ENABLE"=dword:00000001の場合

登録済みのJP1ユーザーのうち，連携ユーザーだけを表示します。

"ENABLE"=dword:00000002の場合

登録済みのJP1ユーザーのうち，DSユーザーだけを表示します。

なお，"ENABLE"=dword:00000000の場合は，JP1ユーザーは表示されません。

このオプションを省略した場合，登録済みのすべてのJP1ユーザーを表示します。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストの認証サーバの登録済みJP1ユーザーが表示されます。

-ldオプションと-dsオプションを同時に指定した場合は，-dsオプションだけが有効になります。

戻り値

0

正常終了

1

認証サーバにユーザーが登録されていない

2

引数誤り

4

メモリーなどシステムリソースが不足した

8

認証サーバが未起動または応答しない

16

認証サーバ側の処理でエラーが発生した

32

通信機能の初期化中にエラーが発生した

128

内部処理で矛盾を生じた（C++の例外）

255

そのほかのエラー

使用例

標準ユーザーとしてjp1adminおよびjp1admin2，連携ユーザーまたはDSユーザーとしてtestuser1を認証サーバに登録している場合の出力例を次に示します。

オプションを何も指定しないとき

>jbslistuser
jp1user account[0]:jp1admin
jp1user account[1]:jp1admin2
jp1user account[2]:testuser1
正常終了しました

-ldオプションを指定したとき

-dsオプションを指定したとき

>jbslistuser -ds
Collected Time:2017/05/31 11:20:00※
jp1user account[0]:testuser1
正常終了しました

注※　DSユーザーを出力する場合，先頭行にActive DirectoryからJP1認証情報を収集したタイムスタンプを出力します。

標準ユーザーとしてjp1adminおよびjp1admin2を認証サーバに登録し，連携ユーザーまたはDSユーザーとして何も登録していない場合の出力例を次に示します。

-dsオプションを指定したとき

>jbslistuser -ds
Collected Time:2017/05/31 11:20:00
JP1ユーザーアカウントがありません
異常終了しました

jbsmkpass（Windows限定）

機能

パスワード管理情報を一括して登録します。このコマンドを実行すると，共通定義情報に登録されていたパスワード管理情報がいったんすべて削除され，パスワード定義ファイルに記述したパスワード管理情報が共通定義情報に一括登録されます。

形式

jbsmkpass [-h 論理ホスト名]
           -f パスワード定義ファイル

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，パスワード管理情報を登録する論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-f パスワード定義ファイル

パスワード管理情報を読み込みたいパスワード定義ファイルを指定します。パスワード定義ファイルに記述された文法をチェックし，書式に誤りがあった場合はエラーを返します。パスワード管理情報が正しい場合，共通定義情報にパスワード定義ファイルの内容を一括登録します。パスワード定義ファイルの記述形式については，「16.　定義ファイル」の「パスワード定義ファイル（Windows限定）」を参照してください。

注意事項

このコマンドを実行すると，共通定義情報に登録したパスワード管理情報がいったんすべて削除され，パスワード定義ファイルに記述したパスワード管理情報が共通定義情報に一括登録されます。登録済みパスワード管理情報を残したい場合は，パスワード定義ファイルに登録済みパスワード情報を記述してください。

Windowsでは，このコマンドを実行するOSユーザーおよびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。詳細については，「8.1.5　ユーザーマッピングを設定する前にOSユーザーにユーザー権利を与える」を参照してください。

戻り値

1

正常終了

0

異常終了

jbsmkumap

機能

ユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報を，共通定義情報に登録します。このコマンドを実行すると，共通定義情報に登録されていたマッピング情報がいったんすべて削除され，ユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報が共通定義情報に登録されます。ユーザーマッピング定義ファイル（jp1BsUmap.conf）の書式に誤りがあった場合，エラーを返します。

形式

jbsmkumap [-h 論理ホスト名]
          [-f ユーザーマッピング定義ファイル名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，ユーザーマッピング情報を登録する論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-f ユーザーマッピング定義ファイル名

マッピング情報を記述した定義ファイルのファイル名を指定します。このオプションを省略した場合は，初期設定のユーザーマッピング定義ファイル（jp1BsUmap.conf）の情報を，共通定義情報に登録します。ユーザーマッピング定義ファイルの形式については，「16.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。

注意事項

このコマンドを実行すると，共通定義情報に登録されていたマッピング情報がいったんすべて削除され，マッピング定義ファイルの情報が共通定義情報に登録されます。登録済みのマッピング情報を残したい場合は，マッピング定義ファイルに登録済みマッピング情報を記述してください。

このコマンドで設定した内容を確認する場合は，jbsgetumapコマンドを使用してください。

定義数の多い定義ファイルを使用してユーザーマッピング情報を登録する場合，定義内容を共通定義情報へ反映するのに時間が掛かることがあります。また，ユーザーマッピング情報の更新中はユーザー偽装ができなくなるため，ユーザー偽装の必要な処理（JP1/AJSのジョブ実行やJP1/IM - Managerでのリモートコマンドなど）の実行ができません。

そのため，一度に多くのユーザーマッピング情報を更新する場合は，運用中ではなくメンテナンスの期間を設けて実行してください。もし，運用中に多くのユーザーマッピング情報を更新する場合は，定義の内容を分割した上でjbssetumapコマンドを実行し，jbssetumapコマンド実行時の共通定義情報への反映時間を短くする運用を検討してください。jbssetumapコマンドの詳細については，「jbssetumap」を参照してください。

戻り値

1

正常終了

0

異常終了

jbsparamdump

機能

JP1/Baseの設定情報を一括で収集して，出力先に指定したディレクトリの配下に出力します。

収集対象のホストが論理ホスト運用の場合，物理ホストおよびすべての論理ホストの設定情報を出力します。

コマンドを実行すると，指定したディレクトリの下にJP1Baseという名称のディレクトリが作成されます。そのディレクトリの下に，次に示す単位で各設定情報を出力します。なお，出力ファイルと同名のファイルがすでに存在する場合，そのファイルを上書きします。

物理ホストの設定情報（物理ホスト名.prm）※1

論理ホストの設定情報（論理ホスト名.prm）※1

イベントサーバの設定情報（イベントサーバ名.prm）※1※2

収集情報ファイルに指定したファイルの内容（userconf.prm）

注※1　出力ファイル名（物理ホスト名，論理ホスト名，またはイベントサーバ名）が129バイト以上の場合，128バイト目までがファイル名となります。

注※2　物理ホストのイベントサーバの設定情報は，物理ホスト名.prmファイルに出力されます。論理ホストのイベントサーバの設定情報は，論理ホスト名.prmファイルに出力されます。物理ホストおよび論理ホスト以外にイベントサーバを設定している場合，イベントサーバの設定情報はイベントサーバ名.prmファイルに出力されます。

収集対象となる設定情報を次の表に示します。

表15‒1　jbsparamdumpコマンドの収集対象となる設定情報一覧

設定情報の種別

収集対象の設定情報

ホスト種別ごとの収集可否

物理ホスト

論理ホスト

論理ホスト（待機系）

イベントサーバ

ホスト情報

ホスト種別（物理，論理，またはイベントサーバ）

○

○

○

○

物理ホスト名，論理ホスト名，またはイベントサーバ名

○

○

○

○

製品情報

会社名※1

○

−

−

−

登録ユーザー名※1

○

−

−

−

バージョンID

○

−

−

−

製品ID

○

−

−

−

製品名

○

−

−

−

OS情報

JP1/Baseの各サービスが使用するポート番号の一覧

○

−

−

−

JP1/Base各サービスのスタートアップ設定（Windowsの場合）

OS起動時の自動起動設定の有無およびOS終了時の自動終了設定の有無（UNIXの場合）

○

−

−

−

JP1/Baseの設定情報

起動スクリプトファイル（物理ホスト）※2

○

−

−

−

停止スクリプトファイル（物理ホスト）※2

○

−

−

−

起動スクリプトファイル（論理ホスト）※2

○

−

−

−

停止スクリプトファイル（論理ホスト）※2

○

−

−

−

起動順序定義ファイル※1

○

−

−

−

サービス起動遅延時間／タイマー監視時間定義ファイル※1

○

−

−

−

イベントサーバインデックスファイル

○

−

−

−

イベントサーバ設定ファイル

○

○

×

○

転送設定ファイル

○

○

×

○

イベント転送抑止用の転送設定ファイル※3

○

○

×

−

API設定ファイル

○

−

−

−

転送受信用の属性付加設定ファイル

○

○

×

○

イベント登録用の属性付加設定ファイル

○

○

×

○

ログファイルトラップ動作定義ファイル※3

○

−

−

−

ログファイルトラップ起動定義ファイル

○

−

−

−

ログ情報定義ファイル

○

−

−

−

イベントログトラップ動作定義ファイル※1

○

−

−

−

配布定義ファイル（転送設定ファイル）※3

○

○

×

−

配布定義ファイル（ログトラップ動作定義ファイル）※3

○

−

−

−

配布定義ファイル（ログトラップ起動定義ファイル）※3

○

−

−

−

配布定義ファイル（イベントログトラップ動作定義ファイル）※1※3

○

−

−

−

認証サーバ名

○

○

×

−

認証情報（JP1ユーザー名）※⁴

○

○

×

−

認証情報（JP1ユーザー権限）※⁴

○

○

×

−

パスワード保管形式

○

○

○

−

ディレクトリサーバ連携定義※1

○

○

○

−

ユーザーマッピング情報

○

○

×

−

ヘルスチェックセットアップ情報

○

○

○

−

ヘルスチェック定義ファイル

○

○

×

−

JP1/Base環境定義ファイル（起動言語種別）※2

○

○

×

−

JP1/Baseパラメーター定義ファイル

○

○

○

−

拡張起動プロセス定義ファイル

○

○

×

−

jp1hosts定義情報

○

○

×

−

jp1hosts2定義情報

○

○

×

−

構成管理機能セットアップ情報

○

○

○

−

構成定義ファイル

○

○

×

−

構成定義情報

○

○

×

−

ホストアクセス制限定義ファイル

○

○

×

−

SSL通信定義情報

○

○

○

−

ローカルアクションセットアップ情報

○

○

○

−

ローカルアクション実行定義ファイル

○

○

×

−

拡張正規表現

○

○

○

−

操作ログ定義

○

○

○

−

通信接続制限（構成管理・コマンド実行）

○

○

○

−

通信接続制限（連携製品からの操作要求）

○

○

○

−

コマンド実行環境

○

○

×

−

JP1/Base管理者設定※2※⁵

○

−

−

−

通信方式

○

○

○

−

動作言語種別

○

○

○

−

文字コード互換モード※2

○

○

○

−

ユーザー任意情報

収集情報ファイル（jbsparamdump.conf）に指定したファイル

−

−

−

−

（凡例）

○：収集する

×：収集しない

−：収集しない（設定情報が存在しない）

注※1

Windowsの場合だけ取得します。

注※2

UNIXの場合だけ取得します。

注※3

初期設定の格納先およびファイル名の場合だけ取得します。

注※4

-sオプションを指定してコマンドを実行した場合だけ取得します。

注※5

root権限を持ったユーザーがコマンドを実行した場合だけ取得します。

なお，次に示す設定情報は，収集対象外です。

パスワード定義ファイル

JP1ユーザーパスワード情報

ローカルアクション環境変数ファイル

形式

jbsparamdump [-s] -d 出力先ディレクトリ

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-s

プライマリー認証サーバに設定されているJP1ユーザー名およびJP1ユーザーの操作権限の情報を収集する場合に指定します。このオプションを指定する場合は，認証サーバと通信できる環境が必要です。

-d 出力先ディレクトリ

収集した設定情報の出力先となるディレクトリ名を，フルパスまたはコマンドを実行するカレントディレクトリからの相対パスで指定します。パスに空白を含む場合は，「"」で囲んで指定します。

注意事項

このコマンドは，JP1/Baseが起動中および停止中のどちらの状態でも実行できます。

このコマンドを実行する環境の文字コードとJP1/Baseを起動している文字コードを同じにしてください。文字コードが異なる場合，複数の文字コードがファイル内で混在するおそれがあります。

クラスタシステムで運用している場合，実行系でコマンドを実行してください。待機系でコマンドを実行すると，論理ホストの一部の設定情報が収集できません。

戻り値

0

正常終了

1

収集に失敗した設定情報が存在する

4

出力に失敗したファイルが存在する

10

引数誤り

11

実行権限不足

12

出力先ディレクトリに対するアクセスエラー

13

収集情報ファイルの読み込みに失敗，または収集情報ファイルのフォーマットエラー

20

メモリー不足

255

そのほかのエラー

出力形式

設定情報の出力形式を次に示します。

*****情報識別子<情報タイプ>パス情報※
設定情報
***End 情報識別子(取得結果)

注※　情報タイプおよびパス情報は，表15-1の設定種別が「JP1/Baseの設定情報」または「ユーザー任意情報」の設定情報で出力されます。

各項目の意味を次の表に示します。

項目

説明

情報識別子

設定情報の識別用文字列です。

情報タイプ

設定情報の種別を，次の形式で表します。

FILE

定義ファイルの内容

CMD

コマンド実行結果

CNF

共通定義情報

パス情報

設定情報のパス情報を，次の形式で表します。

情報タイプがFILEの場合

定義ファイルのフルパス

情報タイプがCMDの場合

コマンドのフルパスおよび指定オプション

情報タイプがCNFの場合

共通定義情報のサブキー

取得結果

設定情報の取得結果を，次の形式で表します。

情報タイプがFILEまたはCNFの場合

SUCCESS（取得成功），FAILURE（取得失敗），またはNONE（存在しない）

情報タイプがCMDの場合

コマンドの戻り値またはFAILURE（実行失敗）

物理ホストの設定情報（物理ホスト名.prm）の出力例を次に示します。

出力される情報識別子と設定情報の対応を次の表に示します。なお，表中のパラメーターの欄については，共通定義情報など特定のパラメーターを出力する項目は，パラメーター名を表記しています。定義ファイルの内容やコマンド実行結果をそのまま出力する項目は，該当なしを意味する「−」を表記しています。

情報識別子

パラメーター

内容

Host Information

hosttype

ホスト種別

Physical（物理ホスト），Logical（論理ホスト），またはEvent（イベントサーバ）

hostname

物理ホスト名，論理ホスト名，またはイベントサーバ名

Product Information

RegisteredOrganization

会社名

RegisteredOwner

登録ユーザー名

ExCurrentVersion

バージョンID

ProductID

製品ID

ProgramName

製品名

Service Port Number List

jp1imevt

jp1imevtapi

jp1imrt

jp1imcmda

jp1imcmdc

jp1bsuser

jp1bsplugin

jp1bscom

JP1AutoJob

jesrd

JP1/Baseの各サービスが使用するポート番号一覧

Base Services Startup Information

−

JP1/Base各サービスのスタートアップ設定（Windowsの場合）

OS起動時の自動起動設定の有無およびOS終了時の自動終了設定の有無（UNIXの場合）

Starting and stopping:jbs_start

−

起動スクリプトファイル（物理ホスト）

Starting and stopping:jbs_stop

−

停止スクリプトファイル（物理ホスト）

Starting and stopping:jbs_start.cluster

−

起動スクリプトファイル（論理ホスト）

Starting and stopping:jbs_stop.cluster

−

停止スクリプトファイル（論理ホスト）

Startup control:JP1SVPRM.DAT

−

起動順序定義ファイル

Startup control:Jp1svprm_wait.dat

−

サービス起動遅延時間／タイマー監視時間定義ファイル

Event service:index

−

イベントサーバインデックスファイル

Event service:conf

−

イベントサーバ設定ファイル

Event service:forward

−

転送設定ファイル

Event service:forward_suppress

−

イベント転送抑止用の転送設定ファイル

Event service:api

−

API設定ファイル

Event service:recv_add_extattr

−

転送受信用の属性付加設定ファイル

Event service:send_add_extattr

−

イベント登録用の属性付加設定ファイル

Event conversion:jevlog.conf

−

ログファイルトラップ動作定義ファイル

Event conversion:jevlog_start.conf

−

ログファイルトラップ起動定義ファイル

Event conversion:jevlogd.conf

−

ログ情報定義ファイル

Event conversion:ntevent.conf

−

イベントログトラップ動作定義ファイル

Distribution definition file:jev_forward.conf

−

配布定義ファイル（転送設定ファイル）

Distribution definition file:jev_logtrap.conf

−

配布定義ファイル（ログトラップ動作定義ファイル）

Distribution definition file:jev_logstart.conf

−

配布定義ファイル（ログトラップ起動定義ファイル）

Distribution definition file:jev_ntevent.conf

−

配布定義ファイル（イベントログトラップ動作定義ファイル）

User management:jbslistsrv

−

認証サーバ名

User management:jbslistuser

−

認証情報（JP1ユーザー名）

User management:jbslistacl

−

認証情報（JP1ユーザー権限）

User management:HASH_LEVEL

HASH_LEVEL

パスワード保管形式

User management:ds_setup

ENABLE

SERVER

PORT

SEARCH_USER_DN

BASE_DN

ATTR_NAME

SSL

ディレクトリサーバ連携定義

User management:jbsgetumap

−

ユーザーマッピング情報

Health check:setup

ENABLE

FAILOVER

ヘルスチェックセットアップ情報

Health check:jbshc.conf

−

ヘルスチェック定義ファイル

Process management:jp1bs_env.conf

−

JP1/Base環境定義ファイル（起動言語種別）

Process management:jp1bs_param_V7.conf

SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT

SEND_PROCESS_RESTART_EVENT

SEND_AUTHSRV_EVENT

JP1/Baseパラメーター定義ファイル

Process management:jp1bs_service_0700.conf

−

拡張起動プロセス定義ファイル

jp1hosts:jbshostsexport

−

jp1hosts定義情報

jp1hosts:jbshosts2export

−

jp1hosts2定義情報

SSL communication definition:setup

ENABLE

CERTIFICATEFILE

CACERTIFICATEFILE

PRIVATEKEYFILE

SSLPROTOCOL

SSLCIPHERS

BASESSL

SSL通信定義情報

Configuration definition:setup

JBSRT_DISTRIB_VERSION

JBSROUTE_COM_TIMEOUT

構成管理機能セットアップ情報

Configuration definition:jbs_route.conf

−

構成定義ファイル

Configuration definition:jbsrt_get

−

構成定義情報

Configuration definition:jbsdfts_srv.conf

−

ホストアクセス制限定義ファイル

Local action:setup

LOGSIZE

LOGFILENUM

PAUSE

CODECONV

ローカルアクションセットアップ情報

Local action:jbslcact.conf

−

ローカルアクション実行定義ファイル

Extending regular expressions

REGEXP

拡張正規表現

Operation log:setup

ENABLE

LOGFILEDIR

LOGSIZE

LOGFILENUM

LOGCHANGEOPT

操作ログ定義

unintended hosts:ROUTE

UPPER_ONLY

ALT_CLIENT_HOSTS

通信接続制限（構成管理・コマンド実行）

unintended hosts:RECEIVE

CLIENT_HOSTS

通信接続制限（連携製品からの操作要求）

Command execution:jcocmddef

−

コマンド実行環境

JP1Base administrator:jbssetadmingrp

−

JP1/Base管理者設定

Base common definition:setup

JP1_COM_VERSION

JP1_BIND_ADDR

JP1_CLIENT_BIND_ADDR

JP1_ANY_BIND

通信方式

LANG

動作言語種別

LANG_MODE

文字コード互換モード

（凡例）

−：該当なし

収集情報ファイル（jbsparamdump.conf）に指定したファイルの出力形式については，「16.　定義ファイル」の「収集情報ファイル」を参照してください。

jbspassmgr（Windows限定）

機能

［パスワード管理］ダイアログボックスを表示します。［パスワード管理］ダイアログボックスでは，次の操作ができます。

新規ユーザーの登録

パスワードの変更

登録ユーザーの削除

なお，登録または削除するユーザーは，OSユーザーまたは情報検索用ユーザーです。

形式

jbspassmgr

実行権限

Administrators権限

格納先ディレクトリ

インストール先フォルダ¥bin¥

注意事項

Windowsでは，このコマンドを実行するOSユーザーおよびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。詳細については，「8.1.5　ユーザーマッピングを設定する前にOSユーザーにユーザー権利を与える」を参照してください。

OSユーザーを削除する場合は，該当するOSユーザーがどのJP1ユーザーともマッピングしていない状態にしてから削除してください。ユーザーマッピングの情報は［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブの［マッピングOSユーザー一覧］，またはjbsgetumapコマンドで確認できます。

jbsrmacl

機能

指定したJP1ユーザーまたはDSグループに設定されている操作権限をすべて削除します。JP1ユーザーは標準ユーザー，連携ユーザー，およびDSユーザーが該当します。

形式

jbsrmacl [-h 論理ホスト名]
         [-s 認証サーバ名]
         {-u JP1ユーザー名 | -g DSグループ名}
         [-i]
         [-ds※]

注※

-dsオプションは，Windowsだけで使用できます。

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，JP1ユーザーまたはDSグループの操作権限を削除したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-s 認証サーバ名

操作権限を削除したい認証サーバ名を指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-u JP1ユーザー名 | -g DSグループ名

-u JP1ユーザー名

操作権限を削除したいJP1ユーザー名を指定します。

-g DSグループ名

操作権限を削除したいディレクトリサーバのセキュリティグループ名を指定します。-dsオプションも同時に指定します。

スペースを含むグループ名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

指定できる文字数は，1〜256（バイト）です。また，DSグループ名に使用できる文字は，* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < >とタブを除くASCII文字だけです。

-i

このオプションを指定すると，指定したJP1ユーザーまたはDSグループの操作権限を削除する前に確認メッセージを表示します。メッセージに対して「y」または「Y」を指定した場合だけ削除処理を実行します。

-ds

このオプションは，Windowsだけで使用できます。

DSユーザーまたはDSグループから操作権限を削除する場合に指定します。このオプションを指定した場合，ディレクトリサーバに登録されているDSユーザー名またはDSグループのJP1操作権限属性の属性値が空文字になります。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して操作権限を登録します。

-dsオプションを指定した場合は，リロードコマンド（jbsaclreload）の実行が必要です。

戻り値

0

正常終了

1

認証サーバにユーザーが登録されていない

2

引数誤り

4

メモリーなどシステムリソースが不足した

8

認証サーバが未起動または応答しない

12

DSユーザー使用時に認証サーバ側でエラーが生じた

16

認証サーバ側の処理でエラーが生じた

32

通信機能の初期化中にエラーが生じた

128

内部処理で矛盾を生じた（C++例外の場合）

255

そのほかのエラー

jbsrmumap

機能

共通定義情報からユーザーマッピング情報を個別に削除します。

形式

jbsrmumap [-h 論理ホスト名]
          {-u JP1ユーザー名 | -ua}
          [-sh サーバホスト名 | -sha]
          [-i]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，ユーザーマッピング情報を削除したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-u JP1ユーザー名

ユーザーマッピング情報を削除したいJP1ユーザー名を指定します。

-ua

JP1ユーザー名に「*」を指定したマッピング情報を削除する場合に指定します。

-sh サーバホスト名

-uオプションに指定するJP1ユーザーに設定されているサーバホスト名を指定します。このオプションを省略した場合，-uオプションに指定したJP1ユーザーのマッピング情報がすべて削除されます。-shaオプションと同時に指定しないでください。

-sha

-uオプションに指定するJP1ユーザーのサーバホスト名に，「*」が指定されているマッピング情報を削除します。-shオプションと同時に指定しないでください。

-i

このオプションを指定すると，ユーザーマッピング情報を削除する前に確認メッセージを表示します。メッセージに対して「y」または「Y」を指定した場合だけ削除処理を実行します。

戻り値

0

正常終了

1

引数誤り

2

コマンド実行ユーザーに権限がない

5

共通定義アクセスエラー

6

メモリーなどシステムリソースが不足した

10

共通定義ロック取得エラー

255

そのほかのエラー

jbsrmumappass（Windows限定）

機能

JP1/Baseのパスワード管理情報に登録されているOSユーザーまたは情報検索用ユーザーを個別に削除します。

形式

jbsrmumappass [-h 論理ホスト名]
               -u { OSユーザー名 | 情報検索用ユーザー名 }

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，OSユーザーを削除したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-u { OSユーザー名 | 情報検索用ユーザー名 }

パスワード管理情報から削除したいOSユーザー名または情報検索用ユーザー名を指定します。

注意事項

OSユーザーを削除する場合は，該当するOSユーザーがどのJP1ユーザーともマッピングしていない状態にしてから削除してください。ユーザーマッピングの情報は［JP1/Base 環境設定］ダイアログボックスの［ユーザーマッピング］タブの［マッピングOSユーザー一覧］，またはjbsgetumapコマンドで確認できます。

戻り値

0

正常終了

0以外

異常終了

jbsrmuser

機能

JP1ユーザーを削除します。

形式

jbsrmuser [-i]
          [-h 論理ホスト名]
          [-s 認証サーバ名]
           JP1ユーザー名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-i

このオプションを指定すると，指定したJP1ユーザー名を削除する前に確認メッセージを表示します。メッセージに対して「y」または「Y」を指定した場合だけ削除処理を実行します。

-h 論理ホスト名

クラスタシステムで運用している場合に，このコマンドを実行させたい論理ホスト名を指定します。指定した論理ホストに設定されている認証サーバのJP1ユーザーを削除します。

-s 認証サーバ名

JP1ユーザーを削除したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

JP1ユーザー名

削除したいJP1ユーザー名を指定します。

注意事項

-hオプションによる論理ホスト名の指定，および-sオプションによる認証サーバ名の指定は，JP1ユーザー名の前に指定してください。

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して指定された認証サーバのJP1ユーザーを削除します。

DSユーザーにはこのコマンドは使用できません。ディレクトリサーバでユーザーの削除をしてください。

戻り値

0

正常終了

1

ユーザーは削除済み

2

引数誤り

4

メモリーなどシステムリソースが不足した

8

認証サーバが未起動または応答しない

16

認証サーバ側の処理でエラーが発生した

32

通信機能の初期化中にエラーが発生した

128

内部処理で矛盾を生じた（C++の例外）

255

そのほかのエラー

jbsrt_del

機能

このコマンドを実行したホストの構成定義情報を削除します。

形式

jbsrt_del [-f]
          [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f

コマンドの実行確認（YまたはNの入力要求メッセージ）を省略する場合に指定します。このオプションを指定した場合は，コマンドの実行確認が省略され「Y」が入力されたと仮定して処理が継続します。このオプションを省略した場合は，コマンドの実行確認が表示されます。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

環境変数

JBSRT_CMDRCD_EXTEND

コマンドの戻り値を拡張する環境変数です。拡張後の戻り値を返す場合は，1を指定します。拡張前の戻り値を返す場合は，0を指定します。この環境変数を省略した場合は，拡張前の戻り値を返します。

注意事項

JP1/IM - Managerのバージョンが11-01以前の場合，環境変数JBSRT_CMDRCD_EXTENDをシステム環境変数およびユーザー環境変数として設定しないでください。IM構成管理を使用したシステムの階層構成の設定ができなくなるおそれがあります。環境変数JBSRT_CMDRCD_EXTENDの設定は，コマンドプロンプトまたはバッチファイルでしてください。

戻り値（拡張前）

0

正常終了

1

異常終了

戻り値（拡張後）

0

正常終了

10

引数エラー

11

実行権限エラー

12

構成定義情報が存在しない

13

構成定義情報へのアクセスエラー

20

メモリー不足

128

そのほかのエラー

使用例

-fオプションを指定した場合と省略した場合の実行例を次に示します。

-fオプションを指定した場合

# jbsrt_del -f
KAVB3115-I 定義情報を消去しました

-fオプションを省略した場合

# jbsrt_del
定義情報を消去してもよろしいですか？[Y/N] y
KAVB3115-I 定義情報を消去しました

コマンドの戻り値を拡張する場合の指定例を次に示します。

# set JBSRT_CMDRCD_EXTEND=1
# jbsrt_del

jbsrt_distrib

機能

マネージャーホスト（JP1/IM - Managerインストールホスト）で実行するコマンドです。

構成定義ファイルに定義した情報を，コマンドを実行したホストの下位にあるホストに配布し，定義を有効にします。

構成定義情報の配布には，一括配布方式と差分配布方式があります。

このコマンドを実行するときには，構成定義を配布する全ホスト（差分配布方式の場合は，構成定義に変更があるホストとその上位ホスト）で，JP1/Baseが起動している必要があります。配布先のホストで，JP1/Baseが起動していなかった場合，そのホストへは構成定義が配布されません。この場合，コマンドの実行時に，構成情報を設定できないというメッセージが出力されます。そのまま処理を続行すると，残りのホストには定義が配布されます。定義を配布できなかったホストへ構成情報を配布するには，そのホストのJP1/Baseを起動してから，再度jbsrt_distribコマンドを実行して定義を配布します。なお，一括配布方式の場合は，構成情報を削除しますか，というメッセージが出力されるので「N」を入力してください。これで，システム全体への定義配布が完了します。

このコマンドが参照する構成定義ファイルは，次のファイルです。

Windowsの場合

インストール先フォルダ¥conf¥route¥jbs_route.conf

共有フォルダ¥jp1base¥conf¥route¥jbs_route.conf（-hオプション指定時）

UNIXの場合

/etc/opt/jp1base/conf/route/jbs_route.conf

共有ディレクトリ/jp1base/conf/route/jbs_route.conf（-hオプション指定時）

構成定義ファイルの形式については，「16.　定義ファイル」の「構成定義ファイル」を参照してください。

形式

共通定義（JBSRT_DISTRIB_VERSION=0）の場合

jbsrt_distrib [{-D [-f] | -L}]
              [-h 論理ホスト名]

共通定義（JBSRT_DISTRIB_VERSION=1）の場合

jbsrt_distrib [{-D [-f] | -L | -f}]
              [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-D

差分配布方式で構成定義情報を配布する場合に指定します。構成定義上で変更が生じたホストだけに構成定義情報の削除または配布を実施します。このオプションを省略した場合は，共通定義（JBSRT_DISTRIB_VERSION）の設定値に従います。

-L

一括配布方式で構成定義情報を配布する場合に指定します。構成定義上のすべてのホストに構成定義情報の削除または配布を実施します。このオプションを省略した場合は，共通定義（JBSRT_DISTRIB_VERSION）の設定値に従います。

-f

コマンドの実行確認（YまたはNの入力要求メッセージ）を省略する場合に指定します。このオプションを指定した場合は，コマンドの実行確認が省略され「Y」が入力されたと仮定して処理が継続します。このオプションを省略した場合は，コマンドの実行確認が表示されます。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

環境変数

JBSRT_CMDRCD_EXTEND

コマンドの戻り値を拡張する環境変数です。拡張後の戻り値を返す場合は，1を指定します。拡張前の戻り値を返す場合は，0を指定します。この環境変数を省略した場合は，拡張前の戻り値を返します。

注意事項

このコマンドで構成定義情報を削除する際，構成定義ファイル内に「*」の付いたホストがあると，そのホスト以下の構成定義情報は削除されません。既存の構成定義情報を削除する場合は，構成定義ファイルに「*」の記述がないことを確認してください。

IM構成管理を使用している場合，このコマンドを実行すると，IM構成管理が保持する構成定義情報とJP1/Baseが保持する構成定義情報が不一致となります。そのため，IM構成管理を使用している場合は，このコマンドを実行しないで，IM構成管理で構成を一元管理することを推奨します。詳細は，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」のIM構成管理によるシステムの階層構成の管理について説明している章を参照してください。

一括配布方式で構成定義情報を配布する場合，システムの運用中に構成情報を削除すると，削除してから配布完了するまでの間に，次の問題が発生するおそれがあります。

イベントの転送に失敗する

コマンドの実行に失敗する

自動アクションの実行に失敗する

システムの運用中に管理対象ホストを追加する場合，削除するホストがないときは，次の手順で，構成情報を削除しないで構成定義を配布してください。既存の構成情報に影響を与えないで，システム構成を変更できます。

構成情報を削除しますか，というメッセージが出力されたら，「N」を入力します。

構成定義を配布してもよろしいですか，というメッセージが出力されたら，「Y」を入力します。

JP1/IM - Managerのバージョンが11-01以前の場合，環境変数JBSRT_CMDRCD_EXTENDをシステム環境変数およびユーザー環境変数として設定しないでください。IM構成管理を使用したシステムの階層構成の設定ができなくなるおそれがあります。環境変数JBSRT_CMDRCD_EXTENDの設定は，コマンドプロンプトまたはバッチファイルでしてください。

一度に多くのホスト（目安として，約1,000台以上のホスト）に構成定義を配布すると，配布処理中にエラーが多発した場合にコマンドの実行完了まで時間が掛かる可能性があります。そのため，差分配布方式を使用して数百台から500台程度に分割して配布することを推奨します。

3階層以上のシステム階層構成で運用する場合，サブマネージャーの配下のホストの処理に時間が掛かり，応答が返らないことでjbsrt_distribコマンドがタイムアウトする場合があります。詳細については「2.6.3(5)　通信タイムアウト時間の見直し」を参照してください。

戻り値（拡張前）

0

正常終了

1

異常終了

戻り値（拡張後）

0

正常終了

1

構成配布または構成削除に失敗したホストが存在する

2

構成管理サーバ処理中

3

コマンドがタイムアウトした

10

引数エラー

11

実行権限エラー

13

構成定義情報へのアクセスエラーまたは構成定義情報が破損している

14

定義ファイルアクセスエラー

15

定義ファイル形式エラー

16

構成管理サーバとの通信中のエラー

20

メモリー不足

128

そのほかのエラー

使用例

-fオプションを指定した場合と省略した場合の実行例を次に示します。

-fオプションを指定した場合

# jbsrt_distrib -D -f
構成定義送信中です・・・
KAVB3109-I 定義配布コマンドが正常終了しました

-fオプションを省略した場合

# jbsrt_distrib -D
構成定義を配布するホストが全て起動している必要があります
構成定義を配布してもよろしいですか？[Y/N] y
構成定義送信中です・・・
KAVB3109-I 定義配布コマンドが正常終了しました

コマンドの戻り値を拡張する場合の指定例を次に示します。

# set JBSRT_CMDRCD_EXTEND=1
# jbsrt_distrib

jbsrt_get

機能

このコマンドを実行したホストの構成定義情報を表示します。

なお，クラスタシステムの待機系ホストで-hオプションを指定してこのコマンドを実行すると，定義情報が表示されません。この場合は，実行系ホストでコマンドを再実行してください。

形式

jbsrt_get [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

戻り値

0

正常終了

1

異常終了

出力例

このコマンドの出力例を次に示します。

 ** 構成定義情報 **

 上位ホスト : parent_host
 自ホスト　 : myhost
 下位ホスト : child_host1
 　　　　　 : child_host2
 　　　　　 : [child_host1]
 　　　　　 : child_host3

jbsrt_sync

機能

マネージャーホスト（JP1/IM - Managerインストールホスト）で実行するコマンドです。

下位のホストから構成定義情報を収集し，システム内の構成定義を更新します。システム構成定義を分割して定義したあとに，このコマンドを実行します。

形式

jbsrt_sync [-f]
           [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f

コマンドの実行確認（YまたはNの入力要求メッセージ）を省略する場合に指定します。このオプションを指定した場合は，コマンドの実行確認が省略され「Y」が入力されたと仮定して処理が継続します。このオプションを省略した場合は，コマンドの実行確認が表示されます。

-h 論理ホスト名

クラスタシステムで運用している場合に，コマンドを実行するホストの論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

環境変数

JBSRT_CMDRCD_EXTEND

コマンドの戻り値を拡張する環境変数です。拡張後の戻り値を返す場合は，1を指定します。拡張前の戻り値を返す場合は，0を指定します。この環境変数を省略した場合は，拡張前の戻り値を返します。

注意事項

JP1/IM - Managerのバージョンが11-01以前の場合，環境変数JBSRT_CMDRCD_EXTENDをシステム環境変数およびユーザー環境変数として設定しないでください。IM構成管理を使用したシステムの階層構成の設定ができなくなるおそれがあります。環境変数JBSRT_CMDRCD_EXTENDの設定は，コマンドプロンプトまたはバッチファイルでしてください。

3階層以上のシステム階層構成で運用する場合，サブマネージャーの配下のホストの処理に時間が掛かり，応答が返らないことでjbsrt_syncコマンドがタイムアウトする場合があります。詳細については「2.6.3(5)　通信タイムアウト時間の見直し」を参照してください。

戻り値（拡張前）

0

正常終了

1

異常終了

戻り値（拡張後）

0

正常終了

1

構成同期に失敗したホストが存在する

2

構成管理サーバ処理中

3

コマンドがタイムアウトした

10

引数エラー

11

実行権限エラー

12

構成定義情報が存在しない

13

構成定義情報へのアクセスエラーまたは構成定義情報が破損している

16

構成管理サーバとの通信中のエラー

20

メモリー不足

128

そのほかのエラー

使用例

-fオプションを指定した場合と省略した場合の実行例を次に示します。

-fオプションを指定した場合

# jbsrt_sync -f
同期要求送信中です・・・
KAVB3112-I 同期コマンドが正常終了しました

-fオプションを省略した場合

# jbsrt_sync
同期コマンドを実行してもよろしいですか？[Y/N] y
同期要求送信中です・・・
KAVB3112-I 同期コマンドが正常終了しました

コマンドの戻り値を拡張する場合の指定例を次に示します。

# set JBSRT_CMDRCD_EXTEND=1
# jbsrt_sync

jbssetacl

機能

JP1ユーザーおよびDSグループの操作権限を個別に登録します。JP1ユーザーは標準ユーザー，連携ユーザー，およびDSユーザーが該当します。

形式

jbssetacl [-h 論理ホスト名]
          [-s 認証サーバ名]
           -f 定義ファイル名
          [-no]
          [-ds※]

注※

-dsオプションは，Windowsだけで使用できます。

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合，指定した論理ホストに設定されているプライマリー認証サーバに登録します。

-s 認証サーバ名

JP1ユーザーおよびDSグループの操作権限を登録したい認証サーバを指定します。このオプションを指定した場合は，-hオプションの指定は無視されます。

-f 定義ファイル

JP1ユーザーおよびDSグループの操作権限を記述したユーザー権限定義ファイルのファイル名を指定します。ユーザー権限定義ファイルは任意の名称および任意の場所に格納できます。ユーザー権限定義ファイルの詳細については，「16.　定義ファイル」の「ユーザー権限定義ファイル」を参照してください。

-no

このオプションを指定すると，指定したJP1ユーザーおよびDSグループに対してすでに操作権限が設定されていた場合，エラーを返し，そのJP1ユーザーおよびDSグループの操作権限は登録されません。

-ds

このオプションは，Windowsだけで使用できます。

DSユーザーまたはDSグループに操作権限を登録する場合に指定します。このオプションを指定した場合，ディレクトリサーバに登録されているDSユーザーまたはDSグループのJP1操作権限の属性値に定義された操作権限を設定します。

注意事項

-hオプションと-sオプションを同時に指定した場合は，-sオプションの指定が優先されます。どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されているときは，論理ホスト名として環境変数JP1_HOSTNAMEで指定されているホスト名が仮定されます。また，どちらのオプションも省略した場合で，環境変数JP1_HOSTNAMEが設定されていないときは，物理ホストに対して操作権限を登録します。

-dsオプションを指定した場合は，リロードコマンド（jbsaclreload）の実行が必要です。

操作権限の登録は多重実行しないでください。

戻り値

0

正常終了

2

引数誤り

4

メモリーなどシステムリソースが不足した

8

認証サーバが未起動または応答しない

12

DSユーザー使用時に認証サーバ側でエラーが生じた

16

認証サーバ側の処理でエラーが生じた

32

通信機能の初期化中にエラーが生じた

64

ファイルフォーマットエラー

128

内部処理で矛盾を生じた（C++例外）

255

そのほかのエラー

jbssetadmingrp（UNIX限定）

機能

JP1/BaseをJP1/Base管理者権限で運用できる環境に設定します。また，JP1/Base管理者での運用が設定されているかどうかを確認します。

形式

jbssetadmingrp {-s JP1管理者グループ [-f] | -v}

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

-s JP1管理者グループ

JP1/Base管理者での運用を有効にします。このオプションを指定すると，JP1/Baseが提供するファイルおよびディレクトリにJP1管理者グループでのアクセス権限が与えられ，JP1/BaseをJP1/Base管理者で運用できるようになります。JP1/Base管理者での運用が有効な環境で，このオプションを指定した場合は，JP1管理者グループを，指定したJP1管理者グループに変更します。

なお，JP1管理者グループに指定できる文字列は，256バイトまでです。

JP1/Base管理者での運用を中断し，一時的にシステム管理者だけでJP1/Baseを運用する場合は，JP1管理者グループに次の値を指定してください。なお，JP1/Base管理者での運用を再開する場合は，任意のJP1管理者グループを再度指定してください。

SUSE Linux 15以降の場合：root

上記以外のLinuxの場合：sys

AIXの場合：system

-f

JP1/Base管理者での運用を有効にする際に，確認メッセージを表示させたくない場合に指定します。このオプションを省略すると，JP1/Base管理者での運用を有効にする際に，確認メッセージを表示します。

-v

JP1/Base管理者の設定状態に関するメッセージを出力します。

注意事項

-v以外のオプションを指定してこのコマンドを使用する場合は，JP1/Baseを停止してください。

JP1/Base管理者での運用を有効にしたあとは，JP1管理者グループのIDを変更しないでください。

戻り値

0

正常終了

1

アクセス権限変更エラー

2

オプションエラー

3

JP1/Base起動中にコマンドを実行した

4

メモリーなどシステムリソースが不足した

5

設定内容エラー

6

実行権限エラー

127

リソース不足以外の内部エラー

jbssetcnf

機能

指定した定義ファイル内の情報を共通定義情報に登録します。

形式

jbssetcnf 定義ファイル名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

定義ファイル名

共通定義情報に登録したい定義ファイルを指定します。定義ファイル名はフルパスで指定してください。

注意事項

JP1/AJSの共通定義情報を変更する場合は，jajs_configコマンドを使用することを推奨します。jajs_configコマンドを使用すると，環境設定パラメーター名や定義内容がチェックされます。そのため，誤った内容が設定されるのを防げます。jajs_configコマンドの詳細については，マニュアル「JP1/Automatic Job Management System 3 コマンドリファレンス」を参照してください。

定義ファイルの各行の最後には，必ず改行（Windowsの場合は「CR，LF」（0x0D，0x0A），UNIXの場合は「LF」（0x0A））を入れてください。

戻り値

0

正常終了（引数にファイル名を指定しなかった場合もこの値が返される）

-1

異常終了

jbssetumap

機能

共通定義情報にユーザーマッピング情報を個別に登録します。

形式

定義ファイルを使用する場合

jbssetumap [-h 論理ホスト名]
            -f 定義ファイル名
           [-no]

定義ファイルを使用しない場合

jbssetumap [-h 論理ホスト名]
           {-u JP1ユーザー名 | -ua}
           {-sh サーバホスト名 | -sha}
            -o OSユーザー名[,OSユーザー名...]
           [-no]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，ユーザーマッピング情報を登録したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-f 定義ファイル名

登録または変更したいマッピング情報を記述した定義ファイルのファイル名を指定します。定義ファイルの格納場所および名称は任意ですが，形式はユーザーマッピング定義ファイル（jp1BsUmap.conf）と同じにしてください。ユーザーマッピング定義ファイルの形式については，「16.　定義ファイル」の「ユーザーマッピング定義ファイル」を参照してください。

このオプションを指定した場合，-uオプション，-uaオプション，-shオプション，-shaオプションは指定できません。

-u JP1ユーザー名

マッピング情報を登録または変更したいJP1ユーザー名を指定します。-uaオプションと同時に指定できません。

-ua

JP1ユーザー名に「*」を指定します。認証サーバに登録されたすべてのJP1ユーザーにユーザーリストで指定した権限が与えられます。-uオプションと同時に指定できません。

-sh サーバホスト名

JP1ユーザーが操作命令を出すサーバホスト名を指定します。-shaオプションと同時に指定できません。

-sha

サーバホスト名に「*」を指定します。JP1ユーザーはすべてのサーバホストからの操作が有効になります。-shオプションと同時に指定できません。

-o OSユーザー名

JP1ユーザーにマッピングしたいOSユーザー名を指定します。「,」で区切ると複数のOSユーザーを指定できます。

-no

指定したJP1ユーザーに対してすでにマッピング情報が登録されていた場合，エラーとなり，そのJP1ユーザーのマッピング情報は登録されません。

注意事項

このコマンドで設定した内容を確認する場合は，jbsgetumapコマンドを実行してください。

定義数の多い定義ファイルを使用してユーザーマッピング情報を登録する場合，定義内容を共通定義情報へ反映するのに時間が掛かることがあります。また，ユーザーマッピング情報の更新中はユーザー偽装ができなくなるため，ユーザー偽装の必要な処理（JP1/AJSのジョブ実行やJP1/IM - Managerでのリモートコマンドなど）の実行ができません。

そのため，一度に多くのユーザーマッピング情報を更新する場合は，運用中ではなくメンテナンスの期間を設けて実行してください。もし，運用中に多くのユーザーマッピング情報を更新する場合は，定義の内容を分割した上でjbssetumapコマンドを実行し，jbssetumapコマンド実行時の共通定義情報への反映時間を短くする運用を検討してください。

戻り値

0

正常終了

1

引数誤り

2

コマンド実行ユーザーに権限がない

3

ユーザーマッピング定義ファイル読み込みエラー

4

ユーザーマッピング定義ファイルの文法エラー

5

共通定義アクセスエラー

6

メモリーなどシステムリソースが不足した

10

共通定義ロック取得エラー

255

そのほかのエラー

jbssetupsrv（Windows限定）

機能

認証サーバ（プライマリー認証サーバおよびセカンダリー認証サーバ）を登録または削除するコマンドです。認証サーバを自ホストから他ホスト，またはその逆に設定を変更する場合には，認証サーバの起動設定の変更を行います。

形式

jbssetupsrv [-h 論理ホスト名]
            {プライマリー認証サーバ [セカンダリー認証サーバ] |
             -d [認証サーバ]}
            [-f]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，認証サーバを登録したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。指定できる文字数は，1〜196（バイト）です。

プライマリー認証サーバ

通常時に利用する認証サーバ（プライマリー認証サーバ）を指定します。

セカンダリー認証サーバ

予備として稼働する認証サーバ（セカンダリー認証サーバ）を指定します。一つのユーザー認証圏内に認証サーバを2台設置する場合に指定してください。このオプションを省略した場合は，ユーザー認証圏内で稼働する認証サーバは1台だけとなります。

-d 認証サーバ名

認証サーバの登録を削除する場合に指定します。-dオプションだけを指定したときは，認証サーバをすべて削除します。

-f

認証サーバの起動設定を変更するために，JP1/Baseを強制的に再起動させるオプションです。JP1/Baseの起動中に，認証サーバを自ホストから他ホスト，またはその逆に変更する場合に指定します。

注意事項

セカンダリー認証サーバの登録時に，プライマリー認証サーバだけを削除した場合は，セカンダリー認証サーバがプライマリー認証サーバになります。

戻り値

0

正常終了

1

異常終了

jbssetusrsrv（UNIX限定）

機能

認証サーバ（プライマリー認証サーバおよびセカンダリー認証サーバ）を指定します。

このコマンドは，次に示すホスト上で実行してください。

認証サーバとして使用するホスト

JP1/IM - ManagerやJP1/AJS - Managerなど，JP1/Baseのユーザー認証を利用する製品がインストールされたホスト

形式

jbssetusrsrv [-h 論理ホスト名]
              プライマリー認証サーバ
             [セカンダリー認証サーバ]

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，認証サーバを登録したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

プライマリー認証サーバ

通常時に利用する認証サーバ（プライマリー認証サーバ）を指定します。

セカンダリー認証サーバ

予備として稼働する認証サーバ（セカンダリー認証サーバ）を指定します。一つのユーザー認証圏内に認証サーバを2台設置する場合に指定してください。このオプションを省略した場合は，ユーザー認証圏内で稼働する認証サーバは1台だけとなります。

戻り値

0

正常終了

1

異常終了

jbsumappass（Windows限定）

機能

JP1/Baseのパスワード管理情報へ新規OSユーザーまたは情報検索用ユーザーを登録します。また，登録されたOSユーザーまたは情報検索用ユーザーのパスワードを変更することもできます。

形式

jbsumappass [-h 論理ホスト名]
             -u { OSユーザー名 | 情報検索用ユーザー名 }
            [-p パスワード]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，新規OSユーザーを登録したい，または登録されたOSユーザーのパスワードを変更したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-u { OSユーザー名 | 情報検索用ユーザー名 }

パスワード管理情報に登録したいOSユーザー名または情報検索用ユーザー名を指定します。または，パスワードを変更したい登録済みOSユーザー名または情報検索用ユーザー名を指定します。

OSユーザー名には，ユーザー名だけでなく，自ホストが所属するドメイン名やローカルホスト名も記述できます。ドメイン名やローカルホスト名を記述する場合，「domain¥user1」，「server¥user1」のように，ドメイン名やローカルホスト名とユーザー名の区切り文字として「¥」を使用します。ドメイン名を記述した場合，登録するOSユーザーがドメイン上のユーザーであるかどうかチェックされます。ドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。ローカルホスト名を記述した場合，登録するOSユーザーがローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，そのOSユーザー名では登録できません。

ドメイン名やローカルホスト名を記述しなかった場合，登録するOSユーザー名がローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，信頼するドメインを含むドメイン上のユーザーであるかどうかチェックされます。ローカルユーザーおよびドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。

なお，Windowsのドメインコントローラー上で登録する場合は，「ドメイン名¥ユーザー名」の形式で記述してください。ドメインコントローラー上ではドメインユーザーとローカルユーザーの区別がないため，ドメインユーザーとして扱われるためです。

また，情報検索用ユーザーを登録する場合は，「aduser/情報検索用ユーザーとして使用するOSユーザー名」の形式で記述してください。

-p パスワード

OSユーザーのパスワードを指定します。OSユーザーにパスワードがない場合は，このオプションを省略してください。

注意事項

Windowsでは，このコマンドを実行するOSユーザーおよびユーザーマッピングされるOSユーザーそれぞれにWindows特有のユーザー権利を与える必要があります。詳細については，「8.1.5　ユーザーマッピングを設定する前にOSユーザーにユーザー権利を与える」を参照してください。

戻り値

0

OSユーザーのパスワードを変更した

1

OSユーザーを登録した

0，1以外

異常終了

jbsunblockadesrv

機能

接続先認証サーバの閉塞状態を解除します。

形式

jbsunblockadesrv [-h 論理ホスト名]
                  -s 認証サーバ名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，接続先認証サーバを設定している論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-s 認証サーバ名

閉塞状態を解除したい認証サーバ名を指定します。

戻り値

0

認証サーバの閉塞状態を解除した

1

認証サーバはすでに閉塞状態ではない

0，1以外

異常終了

使用例

プライマリー認証サーバがserver1，セカンダリー認証サーバがserver2で，server1が閉塞中になっていた場合に，jbsunblockadesrvコマンドを実行してserver1の閉塞状態を解除すると，次のように表示されます。

jbsunblockadesrv -s server1
プライマリー:server1
セカンダリー:server2

jbsunsetcnf

機能

指定した論理ホストを共通定義情報から削除します。

形式

jbsunsetcnf [-i]
             -h 論理ホスト名
            [-c コンポーネント名]
            [-n サブキー]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-i

このオプションを指定すると，指定した論理ホストの共通定義情報を削除する前に確認メッセージを表示します。メッセージに対して「y」または「Y」を指定した場合だけ削除処理を実行します。

-h 論理ホスト名

共通定義情報に登録した論理ホストから削除したい論理ホスト名を指定します。

-c コンポーネント名

共通定義情報に登録した論理ホストの削除したいコンポーネント名を指定します。

-n サブキー

共通定義情報に登録した論理ホストの削除したいコンポーネントのサブキーを指定します。このオプションは，-cオプションを指定している場合だけ有効となります。

注意事項

通常は，-iオプションを指定してこのコマンドを実行してください。

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

戻り値

0

正常終了（削除対象の論理ホストが存在しなかった場合もこの値が返される）

-1

削除処理に失敗

jcocmdconv

機能

バージョン7以前のJP1/Baseのコマンド実行の履歴を，バージョン8以降用のコマンド実行履歴ファイル（ISAM）に移行します。jcocmdconvコマンドを実行しないと，バージョン7以前に蓄積されたコマンド実行履歴が参照できません。

バージョン7以前のJP1/Baseから，バージョン8以降のJP1/Baseにバージョンアップしたあと，コマンド実行履歴のあるマネージャーホスト上で一度だけ実行してください。クラスタ運用している場合は，物理ホスト，論理ホストのそれぞれで実行してください。jcocmdconvコマンドは物理ホスト，論理ホストで同時実行できますが，物理ホストで複数のjcocmdconvコマンドを同時に実行することはできません。

形式

jcocmdconv [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

注意事項

バージョン8以降のJP1/Base，JP1/IM - Managerのインストールのあと，JP1/IM - Managerを起動する前に実行してください。JP1/IM - Managerを起動すると，自動アクションなどでバージョン8以降用のコマンド実行履歴が更新されてしまうおそれがあります。jcocmdconvコマンドの実行前に，コマンド実行履歴ファイル（ISAM）が更新されると，バージョン7以前で蓄積した履歴が移行できなくなります。

戻り値

0

正常終了

2

パラメーターが不正

3

論理ホストがない

4

メモリーエラー

5

ディスクファイルエラー

6

保存先ファイルがすでにある

7

コマンドがシグナルに中断された

8

実行権限エラー

32

共通定義アクセスエラー

41

ファイルアクセスエラー

42

ほかのjcocmdconvコマンドが実行中

255

そのほかのエラー

jcocmddef

機能

コマンド実行環境を設定，参照します。引数には，マネージャーホスト（JP1/IM - Managerインストールホスト）でだけ指定すればよいもの，コマンド実行先ホストでだけ指定すればよいものがあります。これらについては以降の引数の説明で説明します。

形式

jcocmddef [ [-show] |
          [-default]
          [-rsptime 応答監視時間]
          [-record レコード数]
          [-group ホストグループ定義ファイル名]
          [-loaduserprofile {ON|OFF}]
          [-queuenum コマンド先行入力数]
          [-execnum コマンド同時実行数]
          [-open {ON|OFF}]
          [-flush {ON|OFF}]
          [-cmdevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}]
          [-actevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}]
          [-actresult {ON|OFF}]
          [-host 論理ホスト名]
          [-runevinterval 経過時間イベント発行間隔]
          [-actlimit {ON [転送データ量（行数）] | OFF}]
          [-cmdlimit {ON [転送データ量（行数）] | OFF}]
          [-queuethreshold コマンド先行入力数のしきい値] ]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-show

現在の定義内容を表示します。このオプションはほかのオプションと併用はできません。なお，このオプションを省略し，かつ，ほかのオプションも省略した場合は，このオプション指定時と同じく，現在の定義内容を表示します。

-default

-rsptime，-record，-loaduserprofile，-queuenum，-execnum，-open，-flush，-cmdevent，-actevent，-actresult，-runevinterval，-actlimit，-cmdlimit，および-queuethresholdの設定を初期設定に戻します。ほかのオプションを同時に指定した場合は，-defaultオプションが有効になります。

-rsptime 応答監視時間

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

実行コマンドの応答監視時間を指定します。指定できる値は0〜600（秒）です。0を指定した場合は監視しません。初期設定では，60秒が設定されています。

実行したコマンドが応答監視時間以内に応答がない場合は，KAVB2002-Iメッセージが出力されます。

このオプションで指定した値は，JP1/Baseを再起動したあとに有効になります。

-record レコード数

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

JP1/IM - Viewの［コマンド実行］画面，および自動アクションで実行したコマンドの実行履歴を保存するファイルの上限値をレコード数で指定します。

指定できる値は，1〜196,600です。初期設定では，196,600レコードが設定されています。

1回のコマンド実行で使用するレコード数は，(実行コマンドの出力行数+3)レコードです。1レコードは6,520バイトです。レコードサイズは変更できません。

レコード数が少ないと，自動アクションのアクション結果が正しく表示されないことがあります。

変更したレコード数は，コマンド実行履歴ファイル（ISAM）を削除したあとに有効になります。コマンド実行履歴ファイル（ISAM）を削除すると，過去の自動アクション，コマンド実行による履歴はすべて失われますので，注意してください。コマンド実行履歴ファイル（ISAM）の削除手順，および削除する際の注意事項については，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」（トラブルシューティングの章，トラブルへの対処方法にある「レコード数の上限値を変更する」）を参照してください。

-group ホストグループ定義ファイル名

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

コマンド実行先ホストを定義したホストグループ定義ファイルを指定します。ホストグループ定義ファイルの形式は，「16.　定義ファイル」の「ホストグループ定義ファイル」を参照してください。

ホストグループ定義ファイルで，ホストグループを定義していない場合は，そのホストグループが削除されます。

-loaduserprofile {ON|OFF}

このオプションはコマンド実行先ホストで設定します。

コマンド実行時にOSユーザーのプロファイルを読み込むかどうかを指定します。プロファイルを読み込む場合はON，読み込まない場合はOFFを指定します。ONまたはOFFの大文字・小文字は，区別されません。初期設定では，OFFが設定されています。

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

このオプションは，Windowsの場合にだけ使用できます。

-queuenum コマンド先行入力数

このオプションはコマンド実行先ホストで設定します。

自動アクション機能を使用してコマンドを実行する場合に，コマンド実行先ホストで実行待ちにできるコマンドの最大値を指定します。指定できる値は，0〜65,535です。初期設定では，1,024が設定されています。0を指定した場合は，コマンド実行先ホストに複数のコマンドを同時に投入できません。

実行待ちの自動アクションがコマンド先行入力数を超えた場合は，KAVB2058-Eメッセージが出力されます。

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

-execnum コマンド同時実行数

このオプションはコマンド実行先ホストで設定します。

自動アクション機能を使用してコマンドを実行する場合に，コマンド実行先ホストで同時に実行できるコマンド数の最大値を指定します。指定できる値は，1〜48です。初期設定では，1が設定されています。コマンドを実行するホストごとに異なる値を指定できます。

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

このオプションは，実行終了までに長時間掛かるコマンドを実行した場合に後続のコマンドの実行開始を早めたいときや，同時に大量の自動アクションが発生した場合に処理性能を向上させたいときなどに指定してください。

なお，このオプションで2以上の値を指定した場合は，複数のコマンドが同時に実行されるため，先に実行されたコマンドが必ずしも先に終了するとは限りません。したがって，自動アクションの終了順序を考慮した運用をしている場合は，このオプションを指定しないでください。

-open {ON|OFF}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

コマンド実行履歴ファイル（ISAM）を常時オープンした状態で実行履歴を出力するかどうかを設定します。ONの場合，常時オープンした状態で出力します。OFFの場合，常時オープンしないで出力します。初期設定では，OFFが設定されています。自動アクション用コマンド実行履歴にだけ有効な設定で，JP1/IM - Viewの［コマンド実行］画面用コマンド実行履歴では有効になりません。

-openの設定を有効にするには，JP1/Baseの再起動が必要です。

-flush {ON|OFF}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

コマンド実行履歴1行ごとにディスクへ書き込みをするかどうかを設定します。この設定を有効にすると，突然のシャットダウンが発生した場合でも1行ごとにディスクへ実行履歴が書き込まれているため，再起動後に実行履歴データを参照できます。ONの場合，1行ごとにディスク中のファイルへ書き込みます。OFFの場合，システムでバッファリングを行うため，1行ごとにディスク中のファイルへ書き込みません。初期設定では，OFFが設定されています。

なお，-flushを有効にした場合，1行ごとにディスク中のファイルへ書き込むため，自動アクションおよびコマンド実行の性能が劣化する場合があります。

-flushの設定を有効にするには，JP1/Baseの再起動が必要です。

-cmdevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

コマンド実行操作をした際にコマンド実行操作に関係するイベントを発行したい場合に，どのイベントを発行するかを指定します。次に示す発行レベルのどれかを指定します。初期設定では，0が設定されています。

表15‒2　イベント発行レベル（コマンド実行操作）

発行レベル

発行するイベントのイベントID

説明

0

なし

コマンド実行操作に関係するイベントを発行しない

1

00003FA0

コマンド実行開始イベントを発行する

2

00003FA1

コマンド実行終了イベントを発行する

3

00003FA0，00003FA1

コマンド実行開始イベント，コマンド実行終了イベントを発行する

4

00003FA2

コマンド実行異常終了イベントを発行する

5

00003FA0，00003FA2

コマンド実行開始イベント，コマンド実行異常終了イベントを発行する

6

00003FA1，00003FA2

コマンド実行終了イベント，コマンド実行異常終了イベントを発行する

7

00003FA0，00003FA1，00003FA2

コマンド実行開始イベント，コマンド実行終了イベント，コマンド実行異常終了イベントを発行する

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

-actevent {0 | 1 | 2 | 3 | 4 | 5 | 6 | 7}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

アクションの状態が変化した際にアクション状態通知に関係するイベントを発行したい場合に，どのイベントを発行するかを指定します。次に示す発行レベルのどれかを指定します。初期設定では，0が設定されています。

表15‒3　イベント発行レベル（自動アクション状態通知）

発行レベル

発行するイベントのイベントID

説明

0

なし

アクション状態通知に関係するイベントを発行しない

1

000020E0，000020E3

アクション状態が送信中・キューイング・実行中になった際にイベントを発行する

2

000020E1，000020E4

アクション状態が終了・キャンセル・強制終了になった際にイベントを発行する

3

000020E0，000020E1，000020E3，000020E4

アクション状態が送信中・キューイング・実行中または終了になった際にイベントを発行する

4

000020E2，000020E5

アクション状態が実行不可・実行失敗になった際にイベントを発行する

5

000020E0，000020E2，000020E3，000020E5

アクション状態が送信中・キューイング・実行中または実行不可・実行失敗になった際にイベントを発行する

6

000020E1，000020E2，000020E4，000020E5

アクション状態が終了・キャンセル・強制終了または実行不可・実行失敗になった際にイベントを発行する

7

000020E0，000020E1，000020E2，000020E3，000020E4，000020E5

アクション状態が送信中・キューイング・実行中，終了・キャンセル・強制終了，または実行不可・実行失敗になった際にイベントを発行する

このオプションで指定した値は，JP1/IM - Managerを再起動したあとから，またはjco_spmd_reloadコマンドでリロードしたあとから有効になります。

なお，アクション状態通知に関係するイベントは，アクション情報ファイルを参照して発行されます。アクション情報ファイルの上限値に達して，上書きされた場合には，上書きされる以前のアクション情報を参照できなくなるため，アクション状態通知に関係するイベントを発行できません。このような場合には，警告イベント（000020E6または000020E7）またはエラーイベント（000020E8）が発行されます。

-actresult {ON|OFF}

このオプションはマネージャーホスト（JP1/IM - Managerインストールホスト）で設定します。

自動アクションによるコマンド実行の実行結果をコマンド実行履歴に保存するかどうか指定します。保存する場合はON，保存しない場合はOFFを指定します。

ONまたはOFFの大文字・小文字は，区別されません。初期設定では，ONが設定されています。コマンドの実行結果の詳細を知りたい場合は，必ずONを指定してください。

OFFを指定すると，コマンド実行履歴ファイル（ISAM）への出力を抑止するため，JP1/Base制御部の処理速度を向上できます。ただし，自動アクションによるコマンドの戻り値以外の情報をすべて破棄するため，コマンドの実行結果の詳細は出力されません（JP1/IM - Viewの［アクション結果詳細］画面の［メッセージ］に出力される情報がすべて「KAVB2401-I」のメッセージ情報になります）。

このオプションで指定した値は，JP1/IM - Managerを再起動したあとから有効になります。

-host 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

このオプションを指定して，実行系サーバまたは待機系サーバの設定を変更した場合は，必ずもう一方のサーバでも同様の設定をしてください。

-runevinterval 経過時間イベント発行間隔

このオプションはコマンド実行先ホストで設定します。

JP1/IM - Viewの［コマンド実行］画面，および自動アクションで実行したコマンドの経過時間を通知する，イベント発行間隔を指定します。指定できる値は，0〜86,400（秒）です。初期設定では，600秒（10分）が設定されています。

指定した時間が経過するたびにイベントID 00003FA3（実行経過時間通知イベント）が発行され，KAVB2402-Wメッセージが出力されます。0を指定した場合，イベントは発行されません。

このオプションで指定した値は，JP1/Baseを再起動したあとから有効になります。

-actlimit {ON [転送データ量（行数）] | OFF}

このオプションはコマンド実行先ホストで設定します。

自動アクションで実行したコマンドの実行結果をマネージャーに転送する場合に，転送するデータ量を抑止するかどうか，また，抑止する場合はその上限値を指定します。指定できる値は0〜196,600です。初期設定では，ON（抑止する）で値は1,000が設定されています。なお，コマンド実行先ホストのJP1/Baseのバージョンが07-51以前の場合，初期設定はOFF（抑止しない）が設定されています。

コマンド実行結果のデータ量を抑止する場合には，ONを指定し，転送するデータ量の上限値を行数（1行256バイト）で指定します。行数の指定を省略した場合は，1,000行が設定されます。

コマンド実行結果のデータ量の転送を抑止しない場合には，OFFを指定します。

自動アクションの実行結果として大量の出力データを必要としない場合，実行したコマンドが動作不正で無限ループした場合など，大量のデータの出力を抑止する目的で使用してください。

コマンド実行結果が上限値を超えた場合は，KAVB2070-Wメッセージが出力されます。

-actlimitの設定を有効にするには，JP1/Baseの再起動が必要です。

-cmdlimit {ON [転送データ量（行数）] | OFF}

このオプションはコマンド実行先ホストで設定します。

JP1/IM - Viewの［コマンド実行］画面から実行したコマンドの実行結果をマネージャーに転送する場合に，転送するデータ量を抑止するかどうか，また，抑止する場合はその上限値を指定します。指定できる値は0〜196,600です。初期設定では，ON（抑止する）で値は1,000が設定されています。なお，コマンド実行先ホストのJP1/Baseのバージョンが07-51以前の場合，初期設定はOFF（抑止しない）が設定されています。

コマンド実行結果のデータ量を抑止する場合には，ONを指定し，転送するデータ量の上限値を行数（1行256バイト）で指定します。行数の指定を省略した場合は，1,000行が設定されます。

コマンド実行結果のデータ量を抑止しない場合には，OFFを指定します。

JP1/IM - Viewの［コマンド実行］画面から実行したコマンドの実行結果として，大量の出力データを必要としない場合，実行したコマンドが動作不正で無限ループした場合など，大量のデータの出力を抑止する目的で使用してください。

コマンド実行結果が上限値を超えた場合は，KAVB2070-Wメッセージが出力されます。

-cmdlimitの設定を有効にするには，JP1/Baseの再起動が必要です。

-queuethreshold コマンド先行入力数のしきい値

このオプションはコマンド実行先ホストで設定します。

自動アクション機能を使用してコマンドを実行し，コマンド実行先ホストで実行待ちになるコマンド数（キューイング数）を監視したい場合に，コマンドの先行入力数のしきい値を指定します。指定できる値は，0〜65,535です。初期設定では，10が設定されています。

0を指定するとしきい値監視をしません。

0以外を指定すると，その値に達した時点で警告のJP1イベントが発行され，KAVB2071-Wメッセージが出力されます。また，先行入力数が0に戻った時点で回復のJP1イベントが発行され，KAVB2072-Iメッセージが出力されます。

しきい値監視をすると，JP1/Baseのキューにアクションが蓄積しているのを検知できます。そのため，実行遅延に対して事前に対処ができます。

-queuethresholdの設定を有効にするには，JP1/Baseの再起動が必要です。

出力形式

jcocmddefコマンドを実行すると，設定変更したパラメーターだけでなく，ほかのパラメーターも表示されます。出力形式を次に示します。

図15‒1　jcocmddefコマンドの出力形式

戻り値

0

正常終了

-1

異常終了

jcocmddel

機能

JP1/IM（JP1/IM - Viewの［コマンド実行］画面または自動アクション）から実行指示を受けてJP1/Base側で実行またはキューイングしているコマンドを終了させ，削除します。

システムの運用中に誤ったコマンドを実行してしまった，処理に時間が掛かり過ぎるコマンドを実行したために後続のコマンドが実行されない状態になった，など，コマンド実行でトラブルが発生したときに使用します。なお，このコマンドを実行する前にjcocmdshowコマンドを実行してコマンドの状態を確認し，不要な（削除してもよい）コマンドかどうかを判断してください。

形式

jcocmddel [-h 論理ホスト名]
          [-s 接続ホスト名]
          [-f]
          [コマンドID | ALL]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-s 接続ホスト名

削除したいコマンドが存在している接続先ホストのホスト名を指定します。指定できる文字数は，1〜255バイトです。このオプションを省略した場合は，自ホストを仮定します。

-f

コマンドを削除する際に，確認メッセージを表示させたくない場合に指定します。このオプションを指定すると，指定したコマンドを強制的に削除します。

コマンドID | ALL

削除するコマンドを指定します。コマンドIDで指定する場合はjcocmdshowコマンドの実行結果で得たIDを，「実行中」および「キューイング中」のすべてのコマンドを削除したい場合はALLを指定します。

コマンドIDを複数指定する場合は，スペースで区切ってください。

戻り値

0

正常終了

1

コマンドIDがない，またはJP1/Baseのコマンド実行管理内のコマンドが部分的に削除されている

2

引数エラー

4

システムリソース不足

8

コマンドを実行する権限がない

16

JP1/Baseのコマンド実行管理との通信でエラーが発生した

32

共通定義アクセスエラー

64

接続先ホストからの応答がない

65

接続先ホストとバージョンの互換性がない

128

内部エラー

129

最大接続数エラー

255

その他のエラー

使用例

接続ホストhost01で実行されているコマンド1234を削除する。

jcocmddel -s host01 1234

出力例

jcocmddel -s host01 1234
KAVB2291-Q このコマンドIDを削除してよろしいですか？[Y/y or N/n] -> y
KAVB2293-I コマンド実行制御内のコマンド削除に成功しました。

jcocmdlog

機能

マネージャーホスト（JP1/IM - Managerインストールホスト）で実行するコマンドです。

JP1/IM - Viewの［コマンド実行］画面および自動アクションで実行したコマンドの履歴を，CSV形式で標準出力に出力します。

形式

jcocmdlog [-window]
          [-act]
          [-dir 実行履歴保存ディレクトリ]
          [-h 論理ホスト名]
          [-ext]
          [-date {日時 | [開始日時],[終了日時]}]

実行権限

Windowsの場合：なし（ただし，WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-window

JP1/IM - Viewの［コマンド実行］画面から実行したコマンドの履歴を出力します。

-act

自動アクションで実行したコマンドの履歴を出力します。

-windowオプションと-actオプションのどちらも省略した場合は，JP1/IM - Viewの［コマンド実行］画面および自動アクションで実行したコマンドの履歴を出力します。

なお，jcocmddefコマンドで出力抑止（-actresult OFF）を設定している間は，出力結果には詳細情報が含まれません（出力される情報はすべて「KAVB2401-I」のメッセージ情報になります）。初期設定またはjcocmddefコマンドで出力抑止を解除した場合は（-actresult ON），詳細情報が出力されます。

-dir 実行履歴保存ディレクトリ

指定したディレクトリの実行履歴を出力します。省略した場合は，運用中の実行履歴を出力します。

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。-dirオプションが指定されている場合，このオプションは，無視されます。

-ext

JP1/IM - Viewの［コマンド実行］画面および自動アクションで実行したコマンドの受け取り時刻をYYYY/MM/DD,hh:mm:ssの形式で出力します。また，実行コマンド名とメッセージをダブルクォーテーションで囲んで出力します。なお，実行コマンド名またはメッセージにダブルクォーテーションが含まれる場合，ダブルクォーテーションを連続して一つ付加します。-extオプションを指定しない場合は，受け取り時刻はMM/DD/YY hh:mm:ssの形式で，実行コマンド名とメッセージをダブルクォーテーションで囲まずに出力します。

（例）

-extオプションを指定した場合

Window,2005/04/01,14:16:23,hostA,"jcochstat -k HELD -n 1003",2420,0,"KAVB2013-I ""jcochstat -k HELD -n 1003""のコマンドが実行終了しました。 pid=2420 terminate code=0"

-extオプションを指定しない場合

Window,04/01/05 14:16:23,hostA,jcochstat -k HELD -n 1003,2420,0,KAVB2013-I "jcochstat -k HELD -n 1003"のコマンドが実行終了しました。 pid=2420 terminate code=0

-date {日時 | [開始日時],[終了日時]}

履歴を出力する日時を指定します。このオプションを省略した場合は，すべての履歴を出力します。

日時，開始日時および終了日時の指定形式は，日付（YYYYMMDD：年月日）と時刻（hhmmss：時分秒）を次のように指定します。時刻は省略できます。

-date 日時

日付または指定した時間帯の履歴を出力します。

（例）-date 2005030317

2005年3月3日の17時台（17時00分00秒〜17時59分59秒）の履歴を出力します。

-date [開始日時],[終了日時]

開始日時と終了日時で範囲指定した場合，範囲内の履歴を出力します。

時刻を省略した場合には以下のように仮定します。

開始：000000（0時0分0秒）

終了：235959（23時59分59秒）

-date 開始日時,終了日時

指定した開始日時から終了日時までの範囲内の履歴を出力します。

（例）-date 2005030317,2005030416

　2005年3月3日の17時00分00秒から2005年3月4日の16時59分59秒までの履歴を出力します。

-date 開始日時,

指定した開始日時以降の履歴を出力します。

（例）-date 200503031724,

　2005年3月3日の17時24分00秒以降の履歴を出力します。

-date ,終了日時

指定した終了日時以前の履歴を出力します。

（例）-date ,200503031724

　2005年3月3日の17時24分59秒以前の履歴を出力します。

-date ,

-dateオプション省略時と同様で，すべての履歴を出力します。

戻り値

0

正常終了

4

コマンド実行履歴ファイルが使用中のため，処理が中断された

-1

異常終了

出力形式

コマンドの実行結果は，コンマ区切り（CSV形式）で出力されます。出力形式は次のとおりです。

実行種別,メッセージ受け取り時刻,コマンド実行先ホスト名,実行コマンド,プロセスID,終了コード,メッセージ

実行種別は，「Window」（JP1/IM - Viewの［コマンド実行］画面から実行したコマンド）または「Action」（自動アクションで実行したコマンド）のどちらかの値を取ります。

コマンドの実行結果は1行256バイトで出力されるため，257バイト以上の実行結果は複数行に分割されて出力されます。

出力する内容のない項目は，コンマだけが出力されます。

jcocmdshow

機能

JP1/IM（JP1/IM - Viewの［コマンド実行］画面または自動アクション）から実行指示を受けてJP1/Base側で実行またはキューイングしているコマンドの状態を確認するコマンドです。

システムの運用中に誤ったコマンドを実行してしまった，処理に時間が掛かり過ぎるコマンドを実行したために後続のコマンドが実行されない状態になった，など，コマンド実行でトラブルが発生したときに使用します。このコマンドを実行して得られる情報は，次のとおりです。

ID：コマンド実行管理内で実行中，キューイング中のコマンドに付けられるユニークなID

STATUS：コマンド実行管理内でのコマンドの実行状態（実行中は「R」，キューイング中は「Q」）

TYPE：コマンド実行指示をした機能名（JP1/IM - Viewからの実行指示の場合は「WIN」，自動アクションからの実行指示の場合は「ACT」）

USER：コマンド実行指示をしたJP1ユーザー名

STIME：コマンド実行管理がJP1/IMからコマンドを受け付けた時間

ETIME：コマンド実行開始からの経過時間

COMMAND：実行中またはキューイング中のコマンド名

なお，このコマンドで確認したのち，不要（削除してもよい）と判断したコマンドはjcocmddelコマンドを実行して削除してください。

形式

jcocmdshow [-h 論理ホスト名]
           [-s 接続ホスト名]
           [-window]
           [-act]
           [-state {r|q}]
           [-ph コマンド投入元ホスト名]
           [-v]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。クラスタシステムを使用していない場合には指定は不要です。

-s 接続ホスト名

実行状態を確認したいコマンドが存在している接続先ホストのホスト名を指定します。指定できる文字数は，1〜255バイトです。このオプションを省略した場合は，自ホストを仮定します。

-window

JP1/IM - Viewの［コマンド実行］画面から実行指示を受けたコマンドの実行状態だけを確認したいときに指定します。-actオプションと同時に指定，または両方とも指定しなかった場合は，JP1/IM - Viewの［コマンド実行］画面または自動アクションから実行指示を受けたコマンドの実行状態が表示されるようになります。

-act

自動アクションから実行指示を受けたコマンドの実行状態だけを確認したいときに指定します。-windowオプションと同時に指定，または両方（-window，-act）とも指定しなかった場合は，JP1/IM - Viewの［コマンド実行］画面または自動アクションから実行指示を受けたコマンドの実行状態が表示されるようになります。

-state {r|q}

コマンドの実行状況を指定します。「実行中」のコマンドを取得する場合はrを，「キューイング中」のコマンドを取得する場合はqを指定します。

このオプションを省略した場合は，「実行中」および「キューイング中」のコマンドを取得します。

-ph コマンド投入元ホスト名

特定のホストから投入されたコマンドだけを確認したいときに指定します。

-v

jcocmdshowコマンドを実行して出力される情報を縦表示したいときに指定します。

このオプションを省略した場合は，jcocmdshowコマンドを実行して出力される情報は横表示されます。

戻り値

0

正常終了

1

JP1/Baseのコマンド実行管理にコマンドが存在しない

2

引数エラー

4

システムリソース不足

8

コマンドを実行する権限がない

16

JP1/Baseのコマンド実行管理との通信でエラーが発生した

32

共通定義アクセスエラー

64

接続先ホストからの応答がない

65

接続先ホストとバージョンの互換性がない

128

内部エラー

129

最大接続数エラー

255

その他のエラー

使用例

接続ホストhost01で実行されているコマンドの実行状況を確認する。

jcocmdshow -s host01

出力例

-vオプション省略時

jcocmdshow -s host01
ID   STATUS TYPE USER     STIME           ETIME     COMMAND
1234 R      WIN  jp1admin Feb 13 18:55:29 000:01:05 "C:¥WINNT¥system32¥notepad.exe"

-vオプション指定時

jcocmdshow -s host01 -v
ID       :1234
STATUS   :R
TYPE     :WIN
USER     :jp1admin
STIME    :Feb 13 18:55:29
ETIME    :000:01:05
COMMAND  :"C:¥WINNT¥system32¥notepad.exe"

jevagtfw

機能

マネージャーホスト（JP1/IM - Managerインストールホスト）で実行するコマンドです。

エージェントからのイベント転送を抑止，およびイベント転送抑止を解除します。また，イベント転送抑止状態の一覧を表示します。イベント転送を抑止できるエージェントの上限数は，10,000台です。

なお，抑止対象のエージェントホストのJP1/Baseのバージョンは，08-00以降である必要があります。

形式

jevagtfw {-s [転送抑止定義ファイル名] [-o {dispose | suppress | all}] [-n] ホスト名 |
          -r [-f | -m] ホスト名 |
          -l}
         [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-s [転送抑止定義ファイル名] [-o {dispose | suppress | all}] [-n] ホスト名

イベント転送を抑止するエージェントのホスト名を指定します。ホスト名には，構成定義の管理対象外ホストも指定できます。ホスト名は，128バイト以内の文字列で指定します。大文字と小文字は区別しません。ホスト名に自ホストを指定する場合は，-nオプションを指定してください。

転送抑止定義ファイル名

ユーザーが任意に設定したイベント転送抑止定義ファイル名を指定します。ファイル名にパスは指定できません。省略した場合は，forward_suppressファイルが仮定されます。

なお，イベント転送抑止定義ファイルの形式は，転送設定ファイルの形式と同じです。

-o {dispose | suppress | all}

マネージャー側で受信イベントを破棄するかどうか，エージェント側でイベント転送を抑止するかどうかを指定します。省略した場合は，allが仮定されます。

dispose

マネージャー側だけ抑止設定（受信イベント破棄）をします。

suppress

エージェント側だけ抑止設定（イベント転送抑止）をします。

all

マネージャー側で抑止設定（受信イベント破棄）をしたあと，エージェント側でも抑止設定（イベント転送抑止）をします。

-n

自ホストに対してイベント転送を抑止する場合に指定します。

-r [-f | -m] ホスト名

イベント転送抑止を解除するエージェントのホスト名を指定します。ホスト名は，128バイト以内の文字列で指定します。大文字と小文字は区別しません。

-f

イベント転送抑止中にエージェントの転送設定ファイル（forward）の内容が変更されていても，強制的にイベント転送抑止を解除します（イベント転送抑止前の転送設定に戻します）。

-m

マネージャー側だけ抑止設定（受信イベント破棄）を解除します。

-l

イベント転送抑止中のエージェントの抑止状態を出力します。

-h 論理ホスト名

自ホストのコマンド実行元のイベントサーバ名を指定します。イベントサーバ名は，128バイト以内の文字列で指定してください。

このオプションを省略した場合，次に示すホスト名の順番でイベントサーバ名を仮定します。

環境変数JP1_HOSTNAMEに指定した論理ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「*」または自ホスト名（hostnameコマンドで返される物理ホスト名）が優先的に記述されている場合，自ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「@」またはFQDN名が優先的に記述されている場合，FQDN名。

自ホスト名（hostnameコマンドで返される物理ホスト名）。

注意事項

-sオプションを指定してjevagtfwコマンドを実行した際に，受信イベント破棄の設定が成功したあとの動作でエラーが発生した場合，エージェント側のイベント転送抑止は設定されていない状態で，マネージャー側の受信イベント破棄だけ設定されている状態になります。この状態を解除するには，-r -mオプションを指定してjevagtfwコマンドを実行し，マネージャー側の抑止状態だけ変更してください。

イベント転送抑止用の転送設定ファイルに日本語のフィルター条件を設定する場合にはjevagtfwコマンド実行環境の言語種別に対応する文字コードで定義してください。言語種別が日本語のエージェントに設定されている言語種別が異なるとき，イベント転送抑止用の転送設定ファイルの文字コードは自動的に変換されます。言語種別設定の手順については，「3.4.2　使用する言語種別を設定する（UNIX の場合）」を参照してください。

戻り値

0

正常終了

1

引数エラー

2

エージェント（プラグインサービス）に接続できない

10

エージェントの転送設定ファイル（forward）が変更されたためイベント転送抑止の解除ができない

255

そのほかのエラー

使用例

-sオプションを指定した場合の出力例を次に示します。

# jevagtfw -s Agent01
KAJP1422-I AGENT01から受信したイベントを破棄する状態にします
KAJP1430-I AGENT01から受信したイベントを破棄する状態にしました
KAJP1419-I AGENT01からのイベント転送を抑止します
KAJP1401-I AGENT01のforwardファイルをバックアップしています
KAJP1404-I AGENT01のforwardファイルをバックアップしました (file=/etc/opt/jp1base/conf/event/servers/default/suppress/Agent01/forward_backup)
KAJP1405-I AGENT01へ転送抑止用forwardファイルを送信しています
KAJP1408-I AGENT01への転送抑止用forwardファイルの適用が完了しました
KAJP1410-I AGENT01のイベント転送を抑止しました
#

-rオプションを指定した場合の出力例を次に示します。

# jevagtfw -r Agent01
KAJP1427-I AGENT01からのイベント受信破棄を解除します
KAJP1424-I AGENT01のイベント受信破棄状態を解除しました
KAJP1420-I AGENT01のイベント転送抑止を解除します
KAJP1414-I AGENT01のforwardファイルの内容を確認します
KAJP1416-I AGENT01には適切なイベント転送抑止用のforwardファイルが設定されています
KAJP1417-I AGENT01へバックアップしたforwardファイルを送信します
KAJP1418-I AGENT01でバックアップしたforwardファイルの適用が完了しました
KAJP1421-I AGENT01のイベント転送抑止を解除しました
#

-lオプションを指定した場合の出力例を次に示します。

# jevagtfw -l
KAJP1413-I Managerは次のホストからのイベント転送を抑止中です
Host             Suppressed-date     Dispose   Suppress
---------------- ------------------- --------- ----------
AGENT01          2013/12/31 10:15:36 Yes       Yes
AGENT05          2013/11/29 05:21:03 Yes       Yes
AGENT11          2014/01/07 03:11:45 Yes       Yes
#

ヘッダーの意味を次に示します。

ヘッダー

意味

Host

イベント転送抑止中のイベントサーバが稼働するホスト名です。

Suppressed-date

イベント転送の抑止を開始した時刻です。

Dispose

受信イベントを破棄する設定かどうかを表示します。

Yes

受信イベントを破棄する設定です。

No

受信イベントを破棄しない設定です。

Suppress

イベント転送を抑止する設定かどうかを表示します。

Yes

イベント転送を抑止する設定です。

No

イベント転送を抑止しない設定です。

jevdbinit

機能

イベントDBを初期化します。このコマンドを実行すると，イベントDBの内容が削除され，イベントDBが再作成されます。

新しいイベントDBの通し番号の開始番号は，削除される前のイベントDBから引き継いだ通し番号，または指定された通し番号になります。

初期化する前のイベントDBのバックアップを残せます。バックアップファイルは，jevexportコマンドでcsvファイルに出力できます。バックアップファイルをリストアすることはできません。

イベントDBの初期化の詳細については，「10.2　イベントDBの初期化」を参照してください。

形式

jevdbinit [-h イベントサーバ名]
          [-s イベントDB内通し番号の開始番号]
          [-f]
          {-b | -n}

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

イベントDBを初期化したいイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

-s イベントDB内通し番号の開始番号

初期化後に作成されるイベントDBの開始番号を指定します。-sオプションに指定した通し番号でイベントDBが作成されます。指定できる値は，0〜2,147,483,647です。

このオプションを省略した場合，削除する前のイベントDB内通し番号を引き継ぎます。

-f

このオプションを省略すると，このコマンドを実行してよいかどうかを確認するための入力が要求されます（「よろしいですか？[Y/N]」，または「Is This OK?[Y/N]」が表示されます）。この確認入力を不要にしたい場合に，このオプションを指定します。

-b

初期化前のイベントDBをバックアップする場合に指定します。-bまたは-nの指定は，省略できません。

バックアップファイルは，イベントDBが格納されているディレクトリと同じディレクトリに格納されます。バックアップファイル名は，次のようになります。

イベントDBファイル名

バックアップファイル名

IMEvent{0|1}.idx

0IMEvent{0|1}.idx

IMEvent{0|1}.dat

0IMEvent{0|1}.dat

IMEvent{0|1}.fwd

0IMEvent{0|1}.fwd

バックアップする場合，イベントDBが使用するディスク占有量が2倍になるためご注意ください。前回のバックアップファイルが残っている状態で-bオプションを指定すると，前回のバックアップファイルは削除されます。

-n

初期化前のイベントDBをバックアップしない場合に指定します。-bまたは-nの指定は，省略できません。前回のバックアップファイルが残っている状態で-nオプションを指定すると，前回のバックアップファイルは残ったままとなります。

注意事項

イベントサービスが稼働しているときは，このコマンドは実行できません。

このコマンドの実行中は，イベントサービスは起動できません。

イベントDBが空の状態でこのコマンドを実行すると，戻り値が7（イベントDBが壊れている）となりますが，問題ありません。

JP1/IM - Managerと同一ホスト上でjevdbinitコマンドの-sオプションを指定してイベントDB内通し番号を変更した場合は，JP1/IM - Managerの統合監視DBの再セットアップ，およびコマンド実行履歴の再作成が必要です。詳細は，マニュアル「JP1/Integrated Management 3 - Manager 運用ガイド」のJP1/IMシステムのメンテナンスについて説明している章を参照してください。

戻り値

0

正常終了

1

引数エラー

2

実行権限不足

3

入出力エラー

4

メモリー不足

5

イベントサーバ名が未定義

6

イベントDBが存在しない

7

イベントDBが壊れている

8

イベントサービスが稼働中のため，イベントDBを初期化できない

255

そのほかのエラー

jevdbmkrep

機能

イベントDBの重複防止テーブルファイルを再構築します。

重複防止テーブルについては，「2.3.2　イベントDBとは」を参照してください。

形式

jevdbmkrep [-h イベントサーバ名]
           [-f]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

重複防止テーブルファイルを再構築したいイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

-f

このオプションを省略すると，このコマンドを実行してよいかどうかを確認するための入力が要求されます（「よろしいですか？[Y/N]」，または「Is This OK?[Y/N]」が表示されます）。この確認入力を不要にしたい場合に，このオプションを指定します。

注意事項

イベントDBの容量が大きい場合，このコマンドの実行には時間が掛かります。

イベントサービスが稼働している場合は，このコマンドは実行できません。また，このコマンドの実行中は，イベントサービスは起動できません。

イベントDBが空の状態でこのコマンドを実行すると，戻り値が6（イベントDBが存在しない）で失敗します。

転送先イベントサーバで重複防止テーブルクリア用JP1イベント発行後に，転送元イベントサーバから一度もJP1イベントを受信していない状態で，jevdbmkrepコマンドを使用して重複防止テーブルを再作成すると，発行元イベントDB内通し番号の最大通番クリアは無効となります。jevdbmkrepコマンド実行後に再度重複防止テーブルクリア用JP1イベントを発行してください。

戻り値

0

正常終了

1

引数エラー

2

実行権限不足

3

入出力エラー

4

メモリー不足

5

イベントサーバ名が未定義

6

イベントDBが存在しない

7

イベントDBが壊れている

8

イベントサービスが稼働中のため，重複防止テーブルファイルを再構築できない

255

そのほかのエラー

jevdbswitch

機能

イベントサービスが稼働しているイベントサーバのイベントDB内で，イベントが実際に登録される面を，現在使用されている側のイベントDB（アクティブ面）から，待機している側のイベントDB（スタンバイ面）に強制的に切り替えます。

イベントDBがスタンバイ面に切り替わる際，スタンバイ面に登録されていたデータは削除されます。このコマンドを2回続けて実行すると，イベントDBは初期化されます。なお，イベントDBに登録されているJP1イベントを保存しておきたい場合は，あらかじめjevexportコマンドでイベントDBをcsvファイルに出力してください。

jevdbswitchコマンドを使用したイベントDBの初期化方法については，「10.2　イベントDBの初期化」を参照してください。

形式

jevdbswitch [-h イベントサーバ名]
            [-f]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

イベントが実際に登録されるイベントDBをアクティブ面からスタンバイ面に切り替えるイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

-f

このオプションを省略すると，このコマンドを実行してよいかどうかを確認するための入力が要求されます（「よろしいですか？[Y/N]」，または「Is This OK?[Y/N]」が表示されます）。この確認入力を不要にしたい場合に，このオプションを指定します。

戻り値

0

正常終了

1

引数エラー

2

実行権限不足

3

入出力エラー

4

メモリー不足

5

イベントサーバ名が未定義

8

イベントサービスに接続できない

9

イベントDBが切り替えられたかどうかを検知できない

255

そのほかのエラー

jevdef_distrib

機能

イベントサービスの定義情報を配布し，配布先に定義情報を反映させます。

形式

jevdef_distrib {-f [配布定義ファイル名1] |
                -e [配布定義ファイル名2] |
                -l [配布定義ファイル名3] |
                -s [配布定義ファイル名4]}
               [-h 論理ホスト名]
               [-n]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f [配布定義ファイル名1]

転送設定ファイル（forward）の定義情報を配布するときに指定します。あらかじめ，配布定義ファイル（jev_forward.conf）を作成しておいた場合，配布定義ファイル名の指定は省略できます。任意の名称で配布定義ファイルを作成した場合は，配布定義ファイル名を指定します。指定するファイル名にディレクトリ名は指定できません。また，指定するファイル名に，¥ / : , ; * ? " < > | とタブ・スペースは使用できません。配布定義ファイルは，「16.　定義ファイル」の「配布定義ファイル」を参照し，各配布定義ファイルの格納先に作成してください。

このオプションを指定すると，配布元で定義ファイル中の正規表現の構文チェックが実施されます。また，配布先でjevreloadコマンドが実行されるため，配布先でも正規表現の構文チェックが実施されます。配布元での構文チェックは基本正規表現（Windowsの場合はJP1独自の正規表現）で実施されるため，配布先で拡張正規表現を使用する設定にしている場合などには，-nオプションを指定して，配布元での構文チェックを実施しないようにしてください。

-e [配布定義ファイル名2]

イベントログトラップ動作定義ファイル（ntevent.conf）の定義情報を配布する場合に指定します。あらかじめ，配布定義ファイル（jev_ntevent.conf）を作成しておいた場合，配布定義ファイル名の指定は省略できます。任意の名称で配布定義ファイルを作成した場合は，配布定義ファイル名を指定します。指定するファイル名にディレクトリ名は指定できません。また，指定するファイル名に，¥ / : , ; * ? " < > | とタブ・スペースは使用できません。配布定義ファイルは，「16.　定義ファイル」の「配布定義ファイル」を参照し，各配布定義ファイルの格納先に作成してください。なお，配布先ホストがWindowsの場合に対してだけ配布処理をします。

配布先エージェントが論理ホストの場合，配布先エージェントホストの物理ホスト（実行系）へ，イベントログトラップ動作定義ファイルが配布およびリロードされます。

-l [配布定義ファイル名3]

ログファイルトラップ動作定義ファイルの定義情報を配布する場合に指定します。あらかじめ，配布定義ファイル（jev_logtrap.conf）を作成しておいた場合，配布定義ファイル名の指定は省略できます。任意の名称で配布定義ファイルを作成した場合は，配布定義ファイル名を指定します。指定するファイル名にディレクトリ名は指定できません。また，指定するファイル名に，¥ / : , ; * ? " < > | とタブ・スペースは使用できません。配布定義ファイルは，「16.　定義ファイル」の「配布定義ファイル」を参照し，各配布定義ファイルの格納先に作成してください。

配布先エージェントが論理ホストの場合，配布先エージェントホストの物理ホスト（実行系）へ，ログファイルトラップ動作定義ファイルが配布およびリロードされます。

-s [配布定義ファイル名4]

ログファイルトラップ起動定義ファイル（jevlog_start.conf）の定義情報を配布する場合に指定します。ログファイルトラップ起動定義ファイルの定義情報は，ログファイルトラップ管理サービス（デーモン）に再読み込みされません。ログファイルトラップ管理サービスの次回起動時から有効になります。

あらかじめ，配布定義ファイル（jev_logstart.conf）を作成しておいた場合，配布定義ファイル名の指定は省略できます。配布定義ファイルを任意の名称で作成した場合は，配布定義ファイル名を指定します。指定するファイル名にディレクトリ名は指定できません。また，指定するファイル名に，¥ / : , ; * ? " < > | とタブ・スペースは使用できません。配布定義ファイルは，「16.　定義ファイル」の「配布定義ファイル」を参照し，各配布定義ファイルの格納先に作成してください。ログファイルトラップ起動定義ファイルを配布するには，配布元および配布先のホストにインストールされているJP1/Baseのバージョンを09-50以降にする必要があります。

-h 論理ホスト名

論理ホスト上でこのコマンドを実行する場合に指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じホスト名が仮定されます。

-eオプションを指定した場合，コマンドを実行したホスト（実行系）の物理ホストに設定しているイベントログトラップ動作定義ファイルが配布されます。

-lオプションを指定した場合，コマンドを実行したホスト（実行系）の物理ホストに設定しているログファイルトラップ動作定義ファイルが配布されます。

-n（-fオプション指定時に有効）

配布元での構文チェックを実施しない場合に指定します。正規表現の仕様は，プラットフォームおよび正規表現の種類（基本正規表現，拡張正規表現）によって異なるため，次に示すような場合は，このオプションを指定してください。

転送設定ファイル（forward）の配布定義ファイル中に正規表現が含まれていて，配布元と配布先のプラットフォームが異なる場合

配布先で拡張正規表現を使用する設定にしている場合

-eオプションまたは-lオプションを指定した場合，配布元での構文チェックは実施されませんが，-nオプションと同時に指定してもエラーにはなりません。

このオプションを指定すると，配布元での構文チェックは実施されませんが，配布先のイベントサーバが稼働中の場合，リロード結果がこのコマンドの実行結果として出力されます。配布先のイベントサーバが停止している場合には，フィルター条件の誤りを検出できません。配布先のイベントサーバ起動時にフィルター条件の誤りを検出できます。イベントサーバが停止しているかどうかは，jevdef_distribコマンドの戻り値で判断できます。

注意事項

jevdef_distribコマンドを実行できるホストは，バージョン7のJP1/IM - Central Consoleまたはバージョン8以降のJP1/IM - Managerがインストールされているホストだけです。

マネージャーホストの下位に，バージョン7のJP1/IM - Central Consoleまたはバージョン8以降のJP1/IM - Managerがインストールされたサブマネージャーが存在する場合，サブマネージャーからもjevdef_distribコマンドが実行できます。マネージャーホストおよびサブマネージャーから同時にjevdef_distribコマンドを実行した場合は，最後に配布した定義情報が有効となります。

定義情報は，配布定義ファイルに指定した配布先に配布されます。

jevdef_distribコマンド実行時，配布先ホストのjbspluginプロセス（Windowsの場合），jbspluginデーモン（UNIXの場合）が起動している必要があります。

jevdef_distribコマンド実行時，起動していないホストがある場合，そのホストの定義情報を変更できなかったメッセージが表示されます。この場合，エラーとなったホストが起動していることを確認したあとに，再度定義情報を配布してください。

jevdef_distribコマンド実行時に，配布先のホストですでに定義情報が設定されている場合は，各ホストに設定されている定義情報を削除してから定義情報を配布します。

配布定義ファイルに，JP1/IMの構成定義ファイルで定義されていないホストを指定すると，jevdef_distribコマンド実行時にエラーとなり，定義情報はどこにも配布されません。

配布定義ファイルに配布先ホストを重複して指定すると，jevdef_distribコマンド実行時にエラーとなり，定義情報はどこにも配布されません。

jevdef_distribコマンド実行時に，配布先ホストにインストールされたJP1/Baseのバージョンが06-71以前の場合，そのホストでの処理を中断し，次の配布先への処理を続行します。

配布先ホストでリロードの失敗によるエラーが発生した場合，配布前の定義を有効としたまま機能を続行しますが，定義情報は配布した定義情報に書き換えられます。リロードに失敗したホストには，再度jevdef_distribコマンドを実行してください。

エラーになった配布先ホストのホスト名およびエラーメッセージは標準エラー出力されます。

ログファイルトラップまたはイベントログトラップの定義情報を配布すると，配布先でjevlogreloadコマンドまたはjeveltreloadコマンドが実行されます。このとき，トラップ処理中の場合は，トラップ処理完了後にリロードコマンドが実行されます。jevlogreloadコマンドまたはjeveltreloadコマンドが実行中にイベントが発生した場合は，リロードコマンドを実行後，新たに読み込まれた定義情報に従ってイベントが変換されます。

定義情報を配布する場合，ログファイルトラップのファイル属性に関するパラメーター（FILETYPE，HEADLINE，HEADSIZE，およびRECTYPE）の値は，起動時に指定した値のまま変更しないでください。これらのパラメーターを変更して定義情報を配布すると，配布先の定義情報は変更されますが，jevlogreloadコマンドの実行時エラーとなります。

戻り値

0

正常終了

1

引数エラー

2

サービスまたは管理デーモンが起動していない

3

構成定義情報取得エラー

4

メモリーなどシステムリソースが不足した

10

配布定義ファイルに誤りあり

11

配布定義ファイルオープンエラー

12

配布先でエラー

255

そのほかのエラー

jevdef_get

機能

イベントサービスの定義情報を収集します。

形式

jevdef_get {-f | -e | -l [ログファイルトラップ動作定義ファイル名] | -s}
           [-r ホスト名[,ホスト名...]]
           [-h 論理ホスト名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f

転送設定ファイル（forward）の定義情報を収集します。

-e

イベントログトラップ動作定義ファイル（ntevent.conf）の定義情報を収集します。収集先ホストがWindowsの場合に対してだけ収集処理を行います。

収集先エージェントが論理ホストの場合，収集先エージェントホストの物理ホスト（実行系）のイベントログトラップ動作定義ファイルが収集されます。

-l [ログファイルトラップ動作定義ファイル名]

ログファイルトラップ動作定義ファイルの情報を収集します。ログファイルトラップ動作定義ファイル名は，任意のファイル名または相対パスで指定します。定義情報は，収集先ホストの次に示すフォルダの配下に指定されたファイル名または相対パスで収集されます。

Windowsの場合：インストール先フォルダ¥conf¥

UNIXの場合：/etc/opt/jp1base/conf/

上記のフォルダを含むフルパス名が256バイト以内になるように指定してください。

なお，指定する動作定義ファイル名には，: , ; * ? " < > | とタブ・スペースは使用できません。また，上位階層を示す「..¥」は使用できません。

ログファイルトラップ動作定義ファイル名の指定がない場合は，jevlog.confが仮定されます。

収集先エージェントが論理ホストの場合，収集先エージェントホストの物理ホスト（実行系）のログファイルトラップ動作定義ファイルが収集されます。

-s

ログファイルトラップ起動定義ファイル（jevlog_start.conf）の情報を収集します。ログファイルトラップ起動定義ファイルを収集するには，収集元および収集先のホストにインストールされているJP1/Baseのバージョンを09-50以降にする必要があります。

-r ホスト名[,ホスト名...]

特定のホストから個別に定義情報を収集する場合に指定します。このオプションを省略すると，定義情報は一括で収集されます。複数のホスト名を指定する場合は「,」で区切ります。

-h 論理ホスト名

論理ホスト上でこのコマンドを実行する場合に指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じホスト名が仮定されます。

注意事項

jevdef_getコマンド実行時，収集先ホストのjbspluginプロセス（Windowsの場合），jbspluginデーモン（UNIXの場合）が起動している必要があります。

jevdef_getコマンド実行時に，収集先ホストにインストールされたJP1/Baseのバージョンが06-71以前の場合，そのホストでの処理を中断し，次の収集先への処理を続行します。

定義情報の収集先ホストでエラーが発生した場合は，そのホストでの処理を中断し，次の収集先への処理を続行します。

エラーになった収集先ホストのホスト名およびエラーメッセージは標準エラー出力されます。

収集した定義情報は，1行につき1,023バイトまで出力されます。1,024バイト以降は出力されません。

戻り値

0

正常終了

1

引数エラー

2

サービスまたは管理デーモンが起動していない

3

構成定義情報取得エラー

4

メモリーなどシステムリソースが不足した

10

収集先でエラー

255

そのほかのエラー

jeveltreload（Windows限定）

機能

イベントログトラップ動作定義ファイル（ntevent.conf）をリロードします。

形式

jeveltreload

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

注意事項

リロードコマンド実行時にトラップ処理をしていた場合，そのトラップ処理の完了後，リロード処理をします。

serverパラメーターまたはunicode-trapパラメーターを変更した場合は，イベントログトラップサービスを再起動してください。再起動しないでコマンドを実行するとエラー（KAVA3009-Eメッセージを出力）となり，リロードできません。

戻り値

0

正常終了

1

引数誤り

2

サービスが起動していない

3

動作定義ファイルの文法エラー

4

動作定義ファイルのオープンエラー

5

メモリーなどシステムリソースが不足した

6

権限チェックエラー

255

そのほかのエラー

jevexport

機能

イベントDBの内容をcsvファイルに出力します。

形式

jevexport [-h イベントサーバ名]
          [-i イベントDBファイル名]
          [-o 出力ファイル名]
          [-f フィルターファイル名]
          [-t {ON | OFF}]
          [-l コードセット名]
          [-k 項目ファイル名]
          [-a]

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

csvファイルに出力するイベントサーバ名を指定します。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションは，-iオプションと同時に指定できません。

-i イベントDBファイル名

csvファイルに出力するイベントDBファイル名（拡張子：dat）を指定します。OSのバックアップ用コマンドやjevdbinitコマンドでバックアップされたイベントDBのファイル名などを指定できます。パス名を省略した場合は，カレントディレクトリが仮定されます。

このオプションは，-hオプションと同時に指定できません。

-o 出力ファイル名

csvファイル名を255バイト以内で指定します。指定した出力ファイルがすでに存在する場合，そのファイルを上書きします。このオプションを省略した場合は，カレントディレクトリにimevexport.csvファイルを出力します。なお，JP1イベントは古い順に出力されます。

-f フィルターファイル名

イベントDBに登録されたJP1イベントの中から，csvファイルに出力したいJP1イベントの条件を記述したテキストファイルを255バイト以内で指定します。フィルターファイルの記述形式は，イベントフィルターの形式と同じです。詳細については，「16.　定義ファイル」の「イベントフィルターの文法」を参照してください。このオプションを省略した場合，イベントDBに登録されたすべてのJP1イベントがcsvファイルへの出力対象となります。

注意事項

csvファイルに出力するJP1イベントの条件として，フィルターファイルに日本語文字列を指定する場合，その文字コードは，jevexportコマンド実行時のロケール情報（環境変数LANGなど）と合致させてください。

JP1イベントの条件として指定した文字列の文字コードとjevexportコマンド実行時のロケール情報（環境変数LANGなど）が異なる場合，JP1イベントはcsvファイルに出力されません。

-t {ON | OFF}

JP1イベント登録時刻，JP1イベント到着時刻，および拡張属性の共通情報のSTART_TIMEやEND_TIMEを1970年1月1日からの通算秒の表記からYYYYMMDDhhmmssの西暦表示に変換したい場合は，ONを指定してください。西暦表示に変換しない場合は，OFFを指定してください。なお，このオプションを省略した場合は，OFFを指定した場合と同じ動作になります。

-l コードセット名

csv形式に変換するときに，イベントDB中の文字列を指定された文字コードに変換します。このオプションを省略した場合は，文字コードを変換しないで，イベントDBに登録されたコードセットの状態で出力します。指定できる文字コードを次に示します。

SJIS

EUCJIS

ISO2022JP

UTF-8

-k 項目ファイル名

csvファイルに出力したい拡張属性（固有情報）名を記述したテキストファイルを，255バイト以内で指定します。このオプションを指定した場合，イベントDBに記録された固有情報のうち，項目ファイルに記述された拡張属性の固有情報だけが出力されます。このオプションを省略した場合は，すべての固有情報がcsvファイルに出力されます。なお，基本属性と拡張属性の共通情報についてはすべて出力されます。

項目ファイルの記述形式を次に示します。

csvファイルに出力したい固有情報名を先頭（1バイト）から記述する。

csvファイルに出力したくない固有情報は，記述しないまたはコメント行（#を行頭に付ける）にする。

固有情報で，1970年1月1日からの通算秒で表記されているものについては固有情報名の前に@を付ける。

@を付けることによってYYYYMMDDhhmmssの西暦表示に変換できます。

ただし，名称の前に@を付けた固有情報に値が設定されていない場合は，0を仮定して西暦表示に変換します。TZ=JST-9の場合，「19700101090000」に変換します。

以上の条件をファイルに記述した例を次に示します。

AAA     ←   時間変更なし
@BBB    ←   YYYYMMDDhhmmssの西暦表示に変換する
#CCC    ←   コメント行

-a

csvファイルの先頭行に基本属性および拡張属性のタイトル名を，見出し行として出力します。拡張属性の固有情報は，属性名称と属性値がペアで出力されるため，最初の個別拡張属性名だけがタイトルとして出力され，以降は省略されます。

日本語で出力する場合は，-lオプションのコードセット名に文字コードを指定してください。-lオプションを指定しない場合は，タイトル名は英語で出力されます。

注意事項

出力ファイル名，フィルターファイル名，および項目ファイル名の途中にスペースが入る場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。

このコマンドの実行中にイベントDBが切り替わった場合，その時点でcsv出力を中断し，メッセージを出力します。その際のcsvファイルの出力情報は保証できません。コマンドを再実行すると，正常な情報を出力できます。

このコマンドでは，イベントサーバ設定ファイル（conf）で指定したイベントDBのサイズ分のcsv出力を保証します。イベント情報をすべて保存したい場合は，イベントDBが切り替わる前に，比較キーワードWITHINなどを指定したフィルターファイルを-fオプションで指定して定期的に実行することを推奨します。イベントDBサイズの詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」のdb-sizeオプションの説明を参照してください。

-lオプションで文字コードを変換する場合，機種依存文字は正しく変換できません。

このコマンドでJP1/SES形式のイベントをcsvファイルに出力する場合，JP1/SES形式のイベントはコードセットを持たないため，文字列にダブルクォーテーションマークを含むイベントを正しくcsv形式に変換できないことがあります。

イベントIDは16進数でcsv出力されます。表計算ソフトで表示する場合，指数表示形式に合致したイベントID（例:000020E0）は指数形式で表示されることがあります。テキストファイルで表示すれば，文字列表示で確認できます。

破壊されたイベントDBをcsvファイルに出力した場合，破損していないデータは正常に出力されますが，破損しているデータ部分には，KAJP1765-Wのメッセージが出力されます。

このコマンドで出力できるcsvファイルのサイズは2ギガバイトまでです。イベントサーバ環境設定ファイル（conf）のdb-sizeパラメーターを1ギガバイト以上の値に設定している場合，フィルターを指定しないでコマンドを実行すると，csvファイルが2ギガバイトに達してコマンドがエラーになるおそれがあります。このコマンドをエラーにしないためには，-fオプションで出力するイベントを絞り込むか，-iオプションで1面ずつ出力してください。

戻り値

0

正常終了

1

引数エラー

2

コマンド処理中にイベントDBの切り替わりが発生したためcsv出力を中断した

3

イベントDBに破損レコードを検出した

255

そのほかのエラー

使用例

使用例を次に示します。

イベントサーバ名がServiceのイベントDBからfilter.txtに記述されたフィルター条件に合致したJP1イベントだけを取り出し，conf.txtファイルで指定された固有情報だけをcsv形式に変換して，csvconv.csvファイルに出力します。

jevexport -h Service -o csvconv.csv -f filter.txt -k conf.txt

jevextreload

機能

属性付加設定ファイル（recv_add_extattr，send_add_extattr）をリロードします。

形式

jevextreload [-h イベントサーバ名] { -recv | -send }

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

属性付加設定ファイルをリロードしたいイベントサーバ名を指定します。イベントサーバ名は，255バイト以内の文字列で指定してください。

このオプションを省略した場合，次に示すホスト名の順番でイベントサーバ名を仮定します。

環境変数JP1_HOSTNAMEに指定した論理ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「*」または自ホスト名（hostnameコマンドで返される物理ホスト名）が優先的に記述されている場合，自ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「@」またはFQDN名が優先的に記述されている場合，FQDN名。

自ホスト名（hostnameコマンドで返される物理ホスト名）。

{ -recv | -send }

転送受信用またはイベント登録用のどちらの属性付加設定ファイルをリロードするか指定します。

-recv

転送受信用の属性付加設定ファイル（recv_add_extattr）をリロードする場合に指定します。転送受信用の属性付加設定ファイル（recv_add_extattr）が格納先ディレクトリに存在しない場合は，拡張属性の付加設定が無効の状態になってコマンドは正常終了します。

-send

イベント登録用の属性付加設定ファイル（send_add_extattr）をリロードする場合に指定します。イベント登録用の属性付加設定ファイル（send_add_extattr）が格納先ディレクトリに存在しない場合は，拡張属性の付加設定が無効の状態になってコマンドは正常終了します。

戻り値

0

正常終了

1

引数エラー

2

指定されたイベントサーバが未起動

3

属性付加設定ファイルに誤りがある

255

そのほかのエラー

使用例

使用例を次に示します。

イベントサーバevserver1の転送受信用の属性付加設定ファイル（recv_add_extattr）をリロードします。

jevextreload -h evserver1 -recv

jevlogdstart（UNIX限定）

機能

ログファイルトラップ管理デーモンを起動します。JP1/AJSのログファイル監視ジョブを使用する場合は，事前にこのコマンドを実行してログファイルトラップ管理デーモンを起動してください。

形式

jevlogdstart

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/bin/

戻り値

0

正常終了

255

異常終了

jevfwstat

機能

イベント転送抑止条件（suppress）ごとに，JP1イベントの転送抑止状態を表示します。

形式

jevfwstat [-h イベントサーバ名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

JP1イベントの転送状態を確認したいイベントサーバ名を指定します。イベントサーバ名は，128バイト以内の文字列で指定してください。

このオプションを省略した場合，次に示すホスト名の順番でイベントサーバ名を仮定します。

環境変数JP1_HOSTNAMEに指定した論理ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「*」または自ホスト名（hostnameコマンドで返される物理ホスト名）が優先的に記述されている場合，自ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「@」またはFQDN名が優先的に記述されている場合，FQDN名。

自ホスト名（hostnameコマンドで返される物理ホスト名）。

注意事項

jevfwstatコマンドを，同時に複数実行することはできません。別のユーザーがjevfwstatコマンドを実行中に同じコマンドを実行した場合，メッセージKAJP1352-Eを出力してコマンド実行が失敗します。

戻り値

0

正常終了

1

引数エラー

2

イベントサーバが起動していない

3

別のユーザーがコマンドを実行している

255

そのほかのエラー

使用例

出力例を次に示します。

KAJP1350-I agent01のしきい値によるイベント転送抑止状態を確認します
ID          C  Forwarded Suppressed LastModified        BaseTime Detection
----------- - ---------- ---------- ------------------- -------- ---------
log1        F          8          0 None                11:37:10       0/1
log2        S        136       1274 2014/05/22 11:33:42 11:37:02       1/2
log3        F        309        520 2014/05/22 11:33:12 11:37:12       2/3

ヘッダーの意味を次に示します。

ヘッダー

意味

ID

イベント転送抑止条件（suppress）に設定した識別子です。

C

イベント転送が抑止状態の場合は「S」，転送状態（非抑止状態）の場合は「F」を出力します。

Forwarded※

JP1イベントを転送した件数です。

Suppressed※

JP1イベントの転送を抑止した件数です。

LastModified

最後に抑止状態が変化した時刻です。

BaseTime

現在の単位時間の基点となる時刻です。

Detection

イベント転送が抑止状態（Cの値がS）と転送状態（Cの値がF）で出力内容が異なります。

抑止状態（Cの値がS）の場合：n/m

n：しきい値を超えなかった単位時間の回数

m：大量発生イベントが収束したと判定する単位時間の回数

転送状態（Cの値がF）の場合：n/m

n：しきい値を超えた単位時間の回数

m：大量発生イベントが発生したと判定する単位時間の回数

注※

イベントサービスをリロード（jevreloadコマンドを実行）または再起動した場合，各数値は0に初期化されます。

jevlogdstat

機能

ログファイルトラップ管理サービス（デーモン）の動作状況を表示します。このコマンドを実行すると，ログファイルトラップ管理サービス（デーモン）の動作状況をメッセージや戻り値で確認できます。

形式

jevlogdstat

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

戻り値

0

ログファイルトラップ管理サービス（デーモン）が起動している

1

引数エラー

2

ログファイルトラップ管理サービス（デーモン）が起動していない

4

ログファイルトラップ管理サービス（デーモン）が起動処理中

7

メモリー不足

8

実行権限エラー

9

通信エラー

255

そのほかのエラー

jevlogdstop（UNIX限定）

機能

ログファイルトラップ管理デーモンを終了します。

形式

jevlogdstop

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/bin/

注意事項

ログファイルトラップ管理デーモンは，物理ホスト，論理ホスト共通のデーモンです。また，jevlogdstopコマンドを実行すると，JP1/AJSのログファイル監視ジョブを含め，起動しているすべてのログファイルトラップを停止するため，ログファイルトラップおよびJP1/AJSのログファイル監視ジョブが使用できなくなります。jevlogdstopコマンドを実行する場合は，物理ホストおよび論理ホストでログファイルトラップおよびJP1/AJSのログファイル監視ジョブを使用していないか十分に確認してください。

戻り値

0

正常終了

1

引数エラー

2

管理デーモンが起動していない

255

そのほかのエラー

jevlogreload

機能

ログファイルトラップ動作定義ファイルをリロードします。リロードできる定義情報は，jevlogstartコマンドで起動時に指定した動作定義ファイルのMARKSTR，ACTDEFパラメーターの値だけです。

形式

jevlogreload { ID番号 | -a 監視名 | ALL }

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

ID番号

リロードしたいログファイルトラップのID番号を指定します。なお，ID番号は，jevlogstartコマンドの実行時に，標準出力に出力されます。

-a 監視名

リロードしたいログファイルトラップの監視名を指定します。なお，監視名は，jevlogstartコマンドの-aオプションで指定した名称です。

ALL

jevlogstartコマンドおよびJP1/AJSのログファイル監視ジョブで起動したすべてのログファイルトラップをリロードします。ただし，JP1/AJSのログファイル監視ジョブで起動したログファイルトラップの動作定義ファイルの内容は，変更しないでください。変更してリロードを実行した場合，正しく監視できなくなることがあります。

注意事項

MARKSTR，ACTDEF以外のパラメーターを，起動時に設定した値と異なる値で設定すると，コマンド実行時エラーとなりリロードできません。MARKSTR，ACTDEF以外のパラメーターを変更したい場合は，該当するログファイルトラップを再起動してください。また，リロードコマンド実行時にトラップ処理を行っていた場合，そのトラップ処理の完了後，リロード処理を行います。

戻り値

0

正常終了

1

引数エラー

2

サービスまたは管理デーモンが起動していない

3

指定IDまたは監視名のログファイルトラップは存在しない（すでに終了している）

ALL指定の場合は，ログファイルトラップが一つも存在しない

4

動作定義ファイルに誤りあり

5

動作定義ファイルオープンエラー

6

イベントサーバが起動していない

7

メモリーなどシステムリソース不足

8

権限チェックエラー

10

一部リロード失敗

255

そのほかのエラー

jevlogstart

機能

ログファイルトラップを起動します。このコマンドを実行すると，オプションに指定したログファイルを検索し，ログファイルトラップ動作定義ファイルで指定した条件に合うログの1行をJP1イベント化して，イベントサーバに登録します。このコマンドの起動前に，ログファイルトラップ動作定義ファイルを作成しておく必要があります。

このコマンドを実行した環境のロケール情報（LANGなどの言語種別）でログを監視してJP1イベントに登録するため，ログファイルトラップ動作定義ファイルと監視対象のログファイルの言語を統一する必要があります。

UNIXの場合，監視できるログファイルの言語については，「3.4.2　使用する言語種別を設定する（UNIXの場合）」を参照してください。

Windowsの場合，監視できるログファイルの言語は，MS932，Unicode（UTF-8，UTF-16），およびCです。Unicodeのファイルを監視する場合，ログファイルトラップ動作定義ファイルは，UnicodeではなくOSの起動している言語で作成してください。

ログファイルに出力されるデータの形式が異なるファイルは同時に扱えません。この場合は，新たに別のログファイルトラップを起動してください。

このコマンドを実行して正常にログファイルトラップが起動すると，標準出力にログファイルトラップのID番号を出力します。このID番号は，Windowsの場合はスレッドID，UNIXの場合はプロセスIDです。ID番号は，次に示すコマンドで使用します。

jbsgetopinfoコマンド（稼働情報取得）

jevlogstatコマンド（状態確認）

jevlogstopコマンド（ログファイルトラップの停止）

jevlogreloadコマンド（リロード）

なお，クラスタ運用でのフェールオーバー時に，ログファイルトラップ起動定義ファイルに指定されているログファイルトラップをまとめて起動するためのコマンドについては，「jevlogstart（クラスタ運用限定）」を参照してください。

形式

jevlogstart [-f ログファイルトラップ動作定義ファイル名]
            [-t ファイル監視間隔（秒）]
            [-m イベント化するデータの最大長（バイト）]
            [-h]
            [-n 表示コマンド名]（UNIX限定）
            [-p ログデータ出力元プログラム名]
            [-r]
            [-s 登録先イベントサーバ名]
            [-a 監視名]
            [{-g UTF-8 | -g [UTF-16] [-b { LE | BE }]}]（Windows限定）
            [-x]
            {ログファイル名1[ログファイル名32(100)] |
             ログファイル名（UPDタイプのログファイル監視用）}

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f 動作定義ファイル名

ログファイルトラップ動作定義ファイルの名称を256バイト以内で指定します。相対パス名を指定する場合，ディレクトリ名を補ったフルパス名が256バイト以内になるように指定してください。相対パスはこのコマンドを実行するカレントディレクトリからの相対パスです。

なお，次のようなログファイルトラップ動作定義ファイルは，指定できません。

フォルダ名，ディレクトリ名，またはファイル名に環境依存文字を含むファイル

UNIXの場合，ディレクトリ名やファイル名にスペースを含むファイル

Windowsの場合，Unicodeファイル

あらかじめconfフォルダにjevlog.confを作成し，そこに動作定義内容を指定しておいた場合，このオプションは省略できます。

jevlog.confの格納先ディレクトリは次のとおりです。

Windowsの場合

インストール先フォルダ¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/

-t ファイル監視間隔（秒）

ログファイルの監視間隔（1〜86,400秒）を指定します。このオプションを省略すると，10が仮定されます。

WRAP1，WRAP2またはHTRACEの形式のログファイルを監視する場合

ラップアラウンドする頻度が高い場合や監視間隔を長く指定した場合に，ログファイルトラップがデータを読み込む前に上書きされてしまい，データの読み込み漏れが発生するおそれがあります。データの読み込み漏れの予防策として，次の監視間隔の見積もり式を参考にしてください。

ログファイルサイズ（バイト） × ログファイル数 > 1秒当たりの出力サイズ（バイト） × 監視間隔（秒）

-m イベント化するデータの最大長（バイト）

指定したログファイルを読み込むとき，ログファイルの1行を，先頭から何バイト（1〜1,024）までJP1イベントにするのかを指定します。行の終了文字は終了記号「¥0」に変更されます。先頭からのバイトの指定には，「¥0」が含まれます。読み込んだログファイルの1行がこのオプションで指定されたバイト数を超えた場合，イベント化するデータは「-mで指定したバイト数 - 1バイト」になります。

このオプションで指定した値は，入力したログファイルの1行の有効範囲を示します。したがって，ログファイルトラップ動作定義ファイルのMARKSTRパラメーターの正規表現とACTDEFパラメーターの正規表現をチェックするのは，ここで指定した範囲内です。つまり，有効範囲を超えたカラムに対応する正規表現があっても，それらはチェックの対象にはなりません。このオプションを省略すると，512が仮定されます。行終了文字は「¥0」に変更されます。

-h

ログを先頭から読み込みたい場合に指定します。ログを出力するプログラムを起動したあとに，このオプションを省略してコマンドを実行すると，コマンド実行時点ですでに出力されているログは読み込まれません。しかし，このオプションを指定すれば，ファイルの先頭データから読み込みができるようになります。

ラップアラウンドファイルの場合，ファイルの先頭からEOF（End Of File）までデータを読み込んだ後，カレント入力ポインターを見つけて，最新データを読み込んでいきます。

-n 表示コマンド名

このオプションはUNIXだけで使用できます。

ログファイルトラップの表示コマンド名を指定します。この表示コマンド名は，psコマンドで表示できます。なお，コマンド名は256バイト以内で指定してください。表示コマンド名にはスペースは使用できません。このオプションを省略した場合，「ログファイル名1」が表示コマンド名に仮定されます。

-p ログデータ出力元プログラム名

ログデータを出力するプログラム名を指定します。プログラム名は256バイト以内で指定してください。スペースを含むプログラム名は指定できません。

指定した名称はJP1/IM - Viewの［イベントコンソール］画面に表示されます。表示される名称は次のとおりです。

Windowsの場合

/HITACHI/JP1/NT_LOGTRAP/ログデータ出力元プログラム名

UNIXの場合

/HITACHI/JP1/UX_LOGTRAP/ログデータ出力元プログラム名

このオプションを省略すると，Windowsの場合，「/HITACHI/JP1/NT_LOGTRAP」，UNIXの場合，「/HITACHI/JP1/UX_LOGTRAP」と表示されます。

-r

-rオプションを指定しておくと，ログファイルトラップ起動時に指定したログファイルが存在しなかった場合，そのファイルが作成されるまで，-tオプションで指定した間隔でオープンを試みます。オープンに成功すると検索を開始します。

UPDタイプのログファイルを監視する場合，ログファイルトラップ起動時に指定したログファイル名（ワイルドカード含む）に該当するファイルが作成されるまで，-tオプションで指定した間隔で監視対象となるファイルの検出を試みます。

共有ディスクのログファイルを監視する場合は，論理ホストの起動と停止に合わせてログファイルトラップを起動および停止してください。なお，-rオプションは，ログファイルトラップの起動後に作成されるログファイルを監視する場合に指定してください。

このオプションを省略した場合，ログファイルトラップを起動した時点で，指定したログファイルが存在していない場合，ログファイルトラップはログファイルのオープンを中止し，処理を終了します。

-s 登録先イベントサーバ名

JP1イベント登録先のサーバ名を，このオプションで指定されたサーバ名に変更します。指定できるイベントサーバは，自ホストで稼働しているイベントサーバに限ります。このオプションを省略すると，自ホストと同じイベントサーバ名（hostnameコマンドが返すホスト名）が仮定されます。イベントサーバ名は255バイト以内で指定してください。大文字，小文字は区別されます。

このオプションは，主にクラスタシステムで使用します。

また，自ホスト名がショート名の環境で物理ホストのイベントサービスをFQDN形式で起動している場合は，このオプションで明示的にFQDN形式のイベントサーバ名を指定してください。

-a 監視名

ID番号に代わる別名として監視名を指定します。監視名は30バイト以内で指定してください。使用できる文字は，英数字，ハイフン，およびアンダーラインです。監視名の先頭の文字は，必ず英数字を指定してください。大文字，小文字は区別されます。

-g UTF-8 | -g [UTF-16] [-b { LE | BE }]

このオプションはWindowsだけで使用できます。

このオプションを指定すると，ログファイルトラップはUnicodeファイルとして監視します。また，JP1イベントを登録する際のコードセットが，UTF-8になります。動作定義ファイルの条件文の正規表現には，拡張正規表現を適用します。

このオプションを省略した場合は，ログファイルトラップは非Unicodeファイルとして監視します。

-g UTF-8

ログファイルトラップはUTF-8のUnicodeファイルとして監視します。

-g [UTF-16]

ログファイルトラップはUTF-16のUnicodeファイルとして監視します。指定値のUTF-16は省略できます。なお，ログファイルトラップ動作定義ファイルのFILETYPEパラメーターにHTRACEを指定している場合は指定できません。

監視できるUTF-16のUnicodeの形式を次に示します。

UTF-16：BOM（Byte Order Mark）があるUTF-16。

UTF-16LE：BOMがない，リトルエンディアン形式のUTF-16。

UTF-16BE：BOMがない，ビッグエンディアン形式のUTF-16。

BOMがあるUnicodeファイルを監視する場合

BOMの値によってバイトオーダー（リトルエンディアン形式またはビッグエンディアン形式）を判別して監視します。

BOMがないUnicodeファイルを監視する場合

-b {LE | BE}オプションでUnicodeファイルのバイトオーダーを指定できます。-b {LE | BE}オプションを省略した場合は，プロセッサのアーキテクチャによって，バイトオーダーを判別して監視します。なお，Windowsの場合は，リトルエンディアン形式のUnicodeファイル（UTF-16LE形式）として監視します。

-b { LE | BE }

このオプションを指定すると，明示的にUnicodeファイルのバイトオーダーを指定できます。このオプションを指定するときは，-g [UTF-16]オプションに続いて指定する必要があります。

BOMがあるUnicodeファイルを監視する場合

このオプションの指定は無視されて，BOMの値よってバイトオーダーを判別して監視します。

BOMがないUnicodeファイルを監視する場合

指定された形式のUnicodeファイルとして監視します。指定値を次に示します。

LE

リトルエンディアン形式のUnicodeファイル（UTF-16LE形式）として監視します。

BE

ビッグエンディアン形式のUnicodeファイル（UTF-16BE形式）として監視します。

-x

ログファイルをJP1イベント化したときの拡張属性JP1_SOURCEHOSTに，ログデータの出力元ホスト名を設定する場合に指定します。

ログファイル名1[ ...ログファイル名32(100)]

監視するログファイル名を256バイト以内で指定します。なお，相対パス名を指定する場合，ディレクトリ名を補った完全名が256バイト以内になるように指定してください。相対パスはこのコマンドを実行するカレントディレクトリからの相対パスです。ログファイル名はオプションの最後に指定してください。

ログファイル名には，次のようなログファイルは指定しないでください。

ファイル名の先頭が「-（ハイフン）」のログファイル

フォルダ名，ディレクトリ名，またはファイル名に環境依存文字を含むファイル

UNIXの場合，ディレクトリ名やファイル名にスペースを含むファイル

指定できるファイル名の数はWindowsでは32個，UNIXでは100個までです。ただし，オープンできるファイル数が各システムによって異なるため，実際に指定できる個数の最大値は，Windowsでは32以下，UNIXでは100以下になる場合があります。また，UNIXの場合，1ログファイルの監視につき，1プロセスを使用します。

なお，1回のjevlogstartコマンドの実行でログファイルを一つ指定した場合，ログデータの出力順とJP1イベントの登録順は一致します。それに対して，1回のjevlogstartコマンドの実行で複数のログファイルを指定した場合，それぞれのログファイルを独立して監視します。その際，監視間隔中にログデータが複数のログファイルにわたって出力されると，それぞれのログファイルを並行して監視するため，ログデータの出力順とJP1イベントの登録順が一致しないことがあります。

psコマンドで表示されるコマンド名は「ログファイル名.child」です。

ログファイル名（UPDタイプのログファイル監視用）

UPDタイプのログファイルを監視するときのログファイル名を256バイト以内で指定します。ログファイルトラップ動作定義ファイルのFILETYPEパラメーターに，UPDを指定した場合に使用します。

ログファイル名は，ワイルドカード（*または?）を含めて指定します。使用できるワイルドカードは，「*（任意の0文字以上の文字列）」と「?（任意の1文字）」です。ワイルドカードは，ファイル名の個所だけに指定できます。相対パスの個所には指定できません。UNIXの場合，シェルがワイルドカードを展開しないように次に示す例を参考に指定してください。

（例）

ファイル名をダブルクオート「""」で囲む

"/home/log*.log"

ワイルドカードを「¥」でエスケープする

/home/log¥*.log

指定できるファイル名の個数はWindows，UNIX ともに1個です。

なお，相対パス名を指定する場合，ディレクトリ名を補った完全名が256バイト以内になるように指定してください。相対パスはこのコマンドを実行するカレントディレクトリからの相対パスです。ログファイル名はオプションの最後に指定してください。大文字，小文字は区別されます。

ログファイル名には，次のようなログファイルは指定しないでください。

ファイル名の先頭が「-（ハイフン）」のログファイル

フォルダ名，ディレクトリ名，またはファイル名に環境依存文字を含むファイル

UNIXの場合，ディレクトリ名やファイル名にスペースを含むファイル

注意事項

ログファイルの形式によっては監視できない場合があります。監視できるログファイルおよび監視できないログファイルの形式については，「2.4.4　監視できるログファイル」および「2.4.5　監視できないログファイル」を参照してください。

ログファイルトラップは，ログを出力するプログラムを起動する前に起動してください。ログ出力中のファイルに対してログファイルトラップを起動すると，正しくトラップできません。まだ，存在していないログファイルを指定する場合は，-rオプションでログファイルトラップを待機させてください。

Windowsの場合はログファイルトラップ管理サービス，UNIXの場合はログファイルトラップ管理デーモンが起動しているのを確認してから，jevlogstartコマンドを実行してください。

UPDタイプのログファイルを監視する場合，ログファイル名にワイルドカード「*」を多数指定してログファイルトラップを起動すると，監視対象ファイルの検索に時間が掛かるおそれがあります。ワイルドカード「*」を使用するときは，必要な個所にだけ使用してください。

UPDタイプのログファイルを監視する場合，ワイルドカードの条件に該当するファイルでも，ファイル名の長さが完全名で257バイト以上のときは監視対象にはなりません。

UPDタイプのログファイルを監視する場合，監視対象になるディレクトリにログファイル以外のファイルが作成されると，ワイルドカードの条件に該当して監視の対象になるおそれがあります。監視対象になるディレクトリには，バックアップファイルなどをコピーしないでください。

UPDタイプのログファイルを監視する場合，KAVA3667-EメッセージまたはKAVA3672-Eメッセージが出力されるときは，最新の更新日時のログファイルが複数存在しているおそれがあります。同じ更新日時（1秒以内）のログファイルがワイルドカードの条件に該当しないように，ファイル名を変更してからログファイルトラップを再起動してください。

-gオプションを指定してUnicodeファイルを監視する場合，コードセットがUTF-8のJP1イベントを登録します。そのJP1イベントの転送先ホストのJP1/Baseは，バージョン8以降にしてください。

-hオプションを指定してファイルサイズが大きいログファイルを監視する場合，ログファイルトラップ起動後に出力されたログの読み込みが遅延したり，イベントが大量に発生したりするおそれがあります。運用に支障がある場合は，いったんログファイルトラップを停止して，-hオプションを指定しないでログファイルトラップを再起動してください。

戻り値

0

正常終了

1

引数エラー

2

サービスまたは管理デーモンが起動していない

3

イベントサービスが起動していない

4

同一の監視名で起動済み（-aオプション指定時だけ）

255

そのほかのエラー

また，jevlogstartコマンドを実行すると，標準出力にID番号を出力します。このID番号はログファイルトラップを終了するときに必要になります。

使用例

この使用例は，Windowsの場合です。なお，（例6）はUPDタイプのログファイルが監視対象の場合です。

（例1）

ログファイルc:¥log¥logfile1.logから検索し，読み込みます。ここでの引数はログファイル名以外すべて省略しています。ログファイルトラップ動作定義ファイルはJP1/Baseのconfフォルダ内のjevlog.conf，ファイル監視間隔は10秒，イベント化するデータの最大長は512バイトが仮定されます。

jevlogstart c:¥log¥logfile1.log

（例2）

ログファイルトラップ動作定義ファイルをc:¥conf¥configfile.confにして，ログファイルc:¥log¥logfile1.logから検索し，読み込みます。

jevlogstart -f c:¥conf¥configfile.conf c:¥log¥logfile1.log

（例3）

ログファイルトラップ動作定義ファイルをc:¥conf¥configfile.confにして，c:¥log配下のUTF-8形式のUnicodeファイルlogfile_uni.logから検索し，読み込みます。

jevlogstart -f c:¥conf¥configfile.conf -g UTF-8 c:¥log¥logfile_uni.log

（例4）

ログファイルトラップ動作定義ファイルをc:¥conf¥configfile.confにして，c:¥log配下のUTF-16BE形式のUnicodeファイルlogfile_uni_be.logから検索し，読み込みます。

jevlogstart -f c:¥conf¥configfile.conf -g UTF-16 -b BE c:¥log¥logfile_uni_be.log

（例5）

ファイル監視間隔を5秒にして，ログファイルc:¥log¥logfile1.logとc:¥log¥logfile2.logから検索し，読み込みます。

jevlogstart -t 5 c:¥log¥logfile1.log c:¥log¥logfile2.log

（例6）

ログファイルトラップ動作定義ファイルをc:¥conf¥configfile.confにして，c:¥log配下の「logfile.」から始まるファイルから検索し，読み込みます。

jevlogstart -f c:¥conf¥configfile.conf c:¥log¥logfile.*

jevlogstart（クラスタ運用限定）

機能

ログファイルトラップ起動定義ファイルのSTART_OPT_CLSパラメーターに指定されているログファイルトラップを起動します。このコマンドをクラスタソフトに登録することで，クラスタ運用でのフェールオーバー時に，新たに実行系となったサーバでログファイルトラップをまとめて起動できます。

形式

jevlogstart -cluster [クラスタID]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-cluster [クラスタID]

ログファイルトラップ起動定義ファイルのSTART_OPT_CLSパラメーターに指定されているログファイルトラップのうち，指定したクラスタIDに対応するログファイルトラップが起動されます。クラスタIDに指定できる値は0〜99です。クラスタIDの指定を省略すると，クラスタIDの値に0が仮定されます。

注意事項

起動の対象となるログファイルトラップが複数ある場合，KAVA3652-Iのメッセージが出力された直後では，すべてのログファイルトラップが起動していないときがあります。コマンドを実行したあと，しばらくしてからログファイルトラップが起動したかどうか確認してください。

戻り値

0

正常終了

1

引数エラー

2

サービスまたは管理デーモンが起動していない

255

そのほかのエラー

jevlogstat

機能

ログファイルトラップの動作状況を表示します。このコマンドを実行すると，引数に指定したID番号または監視名を持つログファイルトラップの動作状況を戻り値で返します。

形式

jevlogstat { ID番号 | -a 監視名 | ALL }

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

ID番号

動作状態を確認したいログファイルトラップのID番号を指定します。なお，ID番号は，jevlogstartコマンドの実行時に，標準出力に出力されます。

-a 監視名

動作状態を確認したいログファイルトラップの監視名を指定します。なお，監視名は，jevlogstartコマンドの-aオプションで指定した名称です。

ALL

jevlogstartコマンドおよびJP1/AJSのログファイル監視ジョブで起動したすべてのログファイルトラップのID番号を表示します。なお，監視名が設定されている場合は，監視名を付加して表示します。

戻り値

0

指定IDのログファイルトラップは動作中

ALL指定の場合は，動作中のログファイルトラップが最低一つは存在する

1

引数エラー

2

サービスまたは管理デーモンが起動していない

3

指定IDのログファイルトラップが存在しない（すでに終了している）

255

そのほかのエラー

jevlogstop

機能

ログファイルトラップを終了するコマンドです。

なお，クラスタ運用でのフェールオーバー時に，以前jevlogstart（クラスタ運用限定）コマンドによって起動されたログファイルトラップをまとめて終了するためのコマンドについては，「jevlogstop（クラスタ運用限定）」を参照してください。

形式

jevlogstop [-w] { ID番号 | -a 監視名 | ALL }

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-w

ログファイルトラップの停止前に，監視間隔に関係なく一度ログを読み込むため，jevlogstopコマンドを実行した時点まで監視されます。このオプションを指定しなかった場合は，前回の監視タイミングからjevlogstopコマンド実行時までの間に発生したログは監視されません。ログファイルの監視が終了するタイミングの違いを，次の図に示します。

図15‒2　ログファイルの監視が終了するタイミングの違い

監視対象のログデータ量，およびリトライ中に保留されたJP1イベントの件数によっては，コマンドを実行してから終了するまでの時間が長くなる場合があります。クラスタシステム運用時で，フェールオーバー発生時の終了処理にこのオプションを使用する際は注意が必要です。

ID番号

終了したいログファイルトラップのID番号を指定します。なお，ID番号は，jevlogstartコマンドの実行時に，標準出力に出力されます。

-a 監視名

終了したいログファイルトラップの監視名を指定します。なお，監視名は，jevlogstartコマンドの-aオプションで指定した名称です。

ALL

jevlogstartコマンドおよびJP1/AJSのログファイル監視ジョブで起動したすべてのログファイルトラップが終了します。

戻り値

0

正常終了

1

引数エラー

2

サービスまたは管理デーモンが起動していない

3

指定IDまたは監視名のログファイルトラップが存在しない（すでに終了している）

ALL指定の場合は，ログファイルトラップが一つも存在しない

255

そのほかのエラー

jevlogstop（クラスタ運用限定）

機能

このコマンドが実行される以前にjevlogstart（クラスタ運用限定）コマンドによって起動されたログファイルトラップを終了します。このコマンドをクラスタソフトに登録することで，クラスタ運用でのフェールオーバー時に，切り替え前のサーバでログファイルトラップをまとめて終了できます。

形式

jevlogstop -cluster [クラスタID]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-cluster [クラスタID]

このコマンドが実行される以前に，同じクラスタIDが指定されたjevlogstart（クラスタ運用限定）コマンドによって起動されたログファイルトラップを終了します。クラスタIDに指定できる値は0〜99です。クラスタIDの指定を省略すると，クラスタIDの値に0が仮定されます。

戻り値

0

正常終了

1

引数エラー

2

サービスまたは管理デーモンが起動していない

3

対象のログファイルトラップが存在しない（すでに終了している）

255

そのほかのエラー

jevmessageid.bat（Windows限定）

機能

イベントログに出力されるイベントサービスのメッセージに，メッセージIDを付与するかしないかを切り替えます。

このコマンドは，バッチファイルです。ユーザーによるカスタマイズはできません。

形式

jevmessageid.bat { -r | -u }

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-r

イベントサービスがイベントログに出力するメッセージに，メッセージIDを付与する設定に切り替えます。

-u

イベントサービスがイベントログに出力するメッセージに，メッセージIDを付与しない設定に切り替えます。

注意事項

イベントビューアーで表示する場合，切り替え前に出力されたイベントログのメッセージにも変更が適用されます。イベントビューアーを起動している場合には，イベントビューアーの再起動後に変更が適用されます。

イベントログトラップでJP1イベントに変換する場合，切り替え後に出力されたイベントログが変更の対象となります。

物理ホストと論理ホストのメッセージに異なる設定を行うことはできません。

戻り値

0

正常終了

1

引数エラー

255

そのほかのエラー

jevregsvc（Windows限定）

機能

Windowsで，次の場合にイベントサーバのサービスを追加・削除するコマンドです。

クラスタシステムで運用する場合※

非クラスタ環境で論理ホストを運用する場合※

DNSを使ったシステムでイベントサーバを設定する場合

JP1/Auditで監査ログ専用イベントサーバを設定する場合

注※

jp1bshasetupコマンドで自動的に実行されるため，手動での実行は必要ありません。

形式

jevregsvc -r [イベントサーバ名]
jevregsvc -u [イベントサーバ名]

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-r イベントサーバ名

イベントサーバのサービスを追加します。イベントサーバ名を省略すると，自ホスト名が仮定されます。

-u イベントサーバ名

イベントサーバのサービスを削除します。イベントサーバ名を省略すると，自ホスト名が仮定されます。

注意事項

イベントサーバ名は，イベントサーバインデックスに指定したものと大文字小文字を含めて完全に一致させてください。

戻り値

0

正常終了

1

引数エラー

255

そのほかのエラー

jevreload

機能

転送設定ファイル（forward）をリロードします。

形式

jevreload [-h イベントサーバ名]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h イベントサーバ名

転送設定ファイル（forward）をリロードしたいイベントサーバ名を指定します。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションを省略した場合，次に示すホスト名の順番でイベントサーバ名を仮定します。

環境変数JP1_HOSTNAMEに指定した論理ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「*」または自ホスト名（hostnameコマンドで返される物理ホスト名）が優先的に記述されている場合，自ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「@」またはFQDN名が優先的に記述されている場合，FQDN名。

自ホスト名（hostnameコマンドで返される物理ホスト名）。

注意事項

このコマンドを実行すると，しきい値によるイベント転送抑止のイベント転送抑止条件（suppress）もリロードされます。イベント転送抑止条件（suppress）がリロードされた場合のイベント転送抑止状態への影響を次に示します。

イベント転送の抑止状態が解除されます。

イベント転送抑止条件ごとに該当するJP1イベントの集計件数がクリアされます。

イベント転送抑止条件ごとの単位時間および確認回数がクリアされます。

戻り値

0

正常終了

1

引数エラー

2

指定されたイベントサーバが未起動

3

転送設定ファイルに誤りがある

255

そのほかのエラー

使用例

使用例を次に示します。

イベントサーバevserver1の転送設定ファイル（forward）をリロードします。

jevreload -h evserver1

jevsend

機能

イベントサーバにJP1イベントを登録します。

形式

jevsend [-i イベントID]
        [-m メッセージ]
        [[-e 拡張属性名=拡張属性値] ...]
        [-d 送信先イベントサーバ名]
        [-s 送信元イベントサーバ名]

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-i イベントID

登録するJP1イベントのイベントIDを指定します。指定できる範囲は，0〜1FFF，7FFF8000〜7FFFFFFFです。このオプションを省略すると，0が仮定されます。

-m メッセージ

登録するJP1イベントのメッセージテキストを指定します。メッセージテキストは，1,023バイト以下の文字列で指定してください。

-e 拡張属性名=拡張属性値 ...

登録するJP1イベントの拡張属性を指定します。登録する拡張属性の設定は「-e 拡張属性名=拡張属性値」を1組として複数記述できます。「=」と拡張属性値の間には空白（スペースやタブなど）を入れないでください。拡張属性とは次に示す内容の100個までの集まりのことです。なお，すべての属性値の長さの合計が，10,000バイトに制限されます。

拡張属性

内容

形式

拡張属性名

属性の意味を表す名称

英数字またはアンダーライン（英字は大文字，先頭は英字）から成る32バイトまでの文字列

拡張属性値

属性の内容

文字列（0〜10,000バイト）

なお，拡張属性名にSEVERITYを指定したJP1イベントは，JP1/IM - Viewの［イベントコンソール］画面の一覧に表示されます。SEVERITYの拡張属性値は，「17.1.2　拡張属性」の項目「重大度」の内容の中から指定し，必ず先頭を大文字にしてください。

-d 送信先イベントサーバ名

JP1イベントを転送設定ファイル（forward）で指定されたイベントサーバに送信しないで，任意のイベントサーバに送信したい場合，送信先のイベントサーバ名を指定します。イベントサーバ名は255バイト以内の文字列で指定してください。

注意事項

定義されていないイベントサーバ，起動されていないイベントサーバ，およびネットワークの障害などでイベントが届かないイベントサーバなどを指定してもエラーにはなりません。

このオプションを指定して送信したJP1イベントは，自ホストのイベントサーバからは取得できません。

このオプションを指定して，JP1イベントを他ホストのイベントサーバに送信する場合，イベントサーバ設定ファイル（conf）で設定したforward-limitパラメーターで指定したリトライの対象にはなりません。

-sに指定したイベントサーバ名（省略時に仮定されるイベントサーバ名を含みます）を指定しないでください。-sに指定したイベントサーバ名を指定すると無駄なイベント転送が発生するため，転送エラーでJP1イベントが登録されないリスクが高くなります。

-s 送信元イベントサーバ名

-dオプションを併用する場合は，転送のために使用するイベントサーバ名を指定します。-dオプションを指定しない場合は，イベントを登録するイベントサーバ名を指定します。指定できるイベントサーバは自ホストで稼働しているイベントサーバに限ります。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションは，主にクラスタシステムで使用します。

注意事項

オプションと値の間には1個以上の半角のスペースを入れてください。

メッセージテキスト，拡張属性値の途中にスペースを入れる場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。

コマンドのオプションで指定できるバイト数は，OSの制限に依存しますので，各OSの制限内で設定してください。

UNIXシステムで，メッセージまたは拡張属性に日本語の非ASCII文字を含める場合，LANG環境変数に，使用する文字コードを表す正しい値を設定しておいてください。

戻り値

0

正常終了

1

引数エラー

255

そのほかのエラー

使用例

（例1）

イベントIDが111，メッセージが"BaseEvent_Sample"のJP1イベントを登録します。

jevsend -m BaseEvent_Sample -i 111

（例2）

イベントIDが111，拡張属性名が"EXTATTR"，拡張属性値が"Extend Value"を登録します。

jevsend -i 111 -e EXTATTR="Extend Value"

（例3）

次に示す拡張属性のJP1イベントを登録します。

拡張属性名が"EXTATTR"，拡張属性値が"extattr"

拡張属性名が"INCLUDESPACE"，拡張属性値が"include space"

jevsend -e EXTATTR=extattr -e INCLUDESPACE="include space"

（例4）

イベントIDが111，拡張属性名が"SEVERITY"，拡張属性値が"Information"のJP1イベントを登録します。

jevsend -i 111 -e SEVERITY=Information

jevsendd

機能

イベントサーバにJP1イベントを登録し，登録に成功したかどうかを確認できます。イベントサービスが起動しているのにJP1イベントが登録されない場合などに実行して，登録を確認できます。

形式

jevsendd [-i イベントID]
         [-m メッセージ]
         [[-e 拡張属性名=拡張属性値] ...]
         -d 送信先イベントサーバ名
         [-s 送信元イベントサーバ名]
         [-f 初期ポーリング間隔(秒)]
         [-p ポーリング間隔(秒)]
         [-t 確認回数]

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-i イベントID

登録するJP1イベントのイベントIDを指定します。指定できる範囲は，0〜1FFF，7FFF8000〜7FFFFFFFです。このオプションを省略すると，0が仮定されます。

-m メッセージ

登録するJP1イベントのメッセージテキストを指定します。メッセージテキストは，1,023バイト以下の文字列で指定してください。

-e 拡張属性名=拡張属性値 ...

登録するJP1イベントの拡張属性を指定します。登録する拡張属性の設定は「-e 拡張属性名=拡張属性値」を1組として複数記述できます。「=」と拡張属性値の間には空白（スペースやタブなど）を入れないでください。拡張属性とは次に示す内容の100個までの集まりのことです。なお，すべての属性値の長さの合計が，10,000バイトに制限されます。

拡張属性

内容

形式

拡張属性名

属性の意味を表す名称

英数字またはアンダーライン（英字は大文字，先頭は英字）から成る32バイトまでの文字列

拡張属性値

属性の内容

文字列（0〜10,000バイト）

なお，拡張属性名にSEVERITYを指定したJP1イベントは，JP1/IM - Viewの［イベントコンソール］画面の一覧に表示されます。SEVERITYの拡張属性値は，「17.1.2　拡張属性」の項目「重大度」の内容の中から指定し，必ず先頭を大文字にしてください。

-d 送信先イベントサーバ名

送信先のイベントサーバ名を指定します。イベントサーバ名は255バイト以内の文字列で指定してください。

注意事項

このオプションを指定して送信したJP1イベントは，自ホストのイベントサーバからは取得できません。

このオプションを指定して，JP1イベントを他ホストのイベントサーバに送信する場合，イベントサーバ設定ファイル（conf）で設定したforward-limitパラメーターの指定によるリトライの対象にはなりません。

-sに指定したイベントサーバ名（省略時に仮定されるイベントサーバ名を含みます）を指定しないでください。-sに指定したイベントサーバ名を指定すると無駄なイベント転送が発生するため，転送エラーでJP1イベントが登録されないリスクが高くなります。

-s 送信元イベントサーバ名

転送のために使用するイベントサーバ名を指定します。指定できるイベントサーバは自ホストで稼働しているイベントサーバに限ります。このオプションを省略すると，環境変数JP1_HOSTNAMEに指定した論理ホスト名がイベントサーバ名として仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，自ホスト名と同じイベントサーバ名が仮定されます。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションは，主にクラスタシステムで使用します。

-f 初期ポーリング間隔(秒)

JP1イベントを送信先イベントサーバへ送信してから最初の到達確認までの待ち時間を1〜10秒で指定します。このオプションを省略すると，3秒が仮定されます。

-p ポーリング間隔(秒)

初回の到達確認でJP1イベントが到達していなかった場合，2回目以降の到達確認をする間隔を3〜600秒で指定します。このオプションを省略すると，10秒が仮定されます。

-t 確認回数

2回目以降の到達確認の確認回数を0〜999で指定します。このオプションを省略すると，6が仮定されます。

注意事項

オプションと値の間には1個以上の半角のスペースを入れてください。

メッセージテキスト，拡張属性値の途中にスペースを入れる場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。

ダブルクォーテーションマーク（"）の前に円記号を付けた場合（¥"），ダブルクォーテーションマークとして解釈されます。

次に示す特殊文字を含む場合，ダブルクォーテーションマーク（"）で囲む必要があります。

# ; | & ( ) ^ < > スペース タブ

コマンドのオプションで指定できるバイト数は，OSの制限に依存しますので，各OSの制限内で設定してください。

UNIXシステムで，メッセージまたは拡張属性に日本語の非ASCII文字を含める場合，LANG環境変数に，使用する文字コードを表す正しい値を設定しておいてください。

このコマンドは，到達確認がされるか，エラーを検知するまで制御を返しません。

戻り値

0

正常終了

1

引数エラー

2

処理は続行中（最大到達待ち時間内に到達確認ができなかった場合）

3

転送に失敗した

255

そのほかのエラー

補足事項

-f，-p，-tオプションを指定した場合の動作を次の図に示します。

図15‒3　-f，-p，-tオプションを指定した場合の動作

最大到達待ち時間は，次の式で求まります。

最大到達待ち時間 = -fで指定した秒数 + -pで指定した秒数 × -tで指定した回数

最大到達待ち時間内に到達確認ができなかった場合，エラーメッセージを出力して終了します。

jevstart（UNIX限定）

機能

手動でイベントサーバを起動します。

形式

jevstart [イベントサーバ名]

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

イベントサーバ名

起動するイベントサーバを指定します。イベントサーバ名を省略すると，自ホストと同じイベントサーバ名が仮定されます。

注意事項

イベントサービスを自動起動ではなく手動で起動する場合，イベントサービス起動時のロケール情報（環境変数LANGなど）を，jp1bs_env.confの言語種別と合わせてください。

戻り値

0

正常終了

255

異常終了

jevstat

機能

イベントサービスのプロセス群（jevservice）の動作状況を確認できます。イベントサービスのプロセスについては，「付録B　プロセス一覧」を参照してください。

形式

jevstat [イベントサーバ名]
        [-t 時間（秒）]

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

イベントサーバ名

クラスタシステムなどで運用している場合に，イベントサービスのプロセス群が起動または終了しているか確認したいイベントサーバ名を指定します。大文字，小文字は区別されます。イベントサーバ名は255バイト以内の文字列で指定してください。

このオプションを省略した場合，次に示すホスト名の順番でイベントサーバ名を仮定します。

環境変数JP1_HOSTNAMEに指定した論理ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「*」または自ホスト名（hostnameコマンドで返される物理ホスト名）が優先的に記述されている場合，自ホスト名。

イベントサーバインデックスファイル（index）のserverパラメーターに，「@」またはFQDN名が優先的に記述されている場合，FQDN名。

自ホスト名（hostnameコマンドで返される物理ホスト名）。

-t 時間（秒）

jevstatコマンドの実行終了を待つ時間を指定します。指定できる値は，1〜32,767（秒）です。指定した時間内にjevstatコマンドの実行が終わらない場合，jevstatコマンドの実行が失敗したと見なします。省略した場合は，60が設定されます。

注意事項

イベントサービス起動直後にjevstatコマンドを実行すると，メッセージKAJP1706-Eが出力される場合があります。このようなときは，イベントサービスの起動から数秒あけてjevstatコマンドを実行してください。

jevstatコマンドを実行し，統合トレースログにメッセージKAJP1775-Eが出力された場合には，コマンドの実行がタイムアウトしているおそれがあります。-tオプションにコマンドの実行終了を待つ時間を指定して，jevstatコマンドを再実行してください。

戻り値

0

すべてのプロセスが起動している

1

異常終了（コマンドの処理でエラーが発生）

4

一部のプロセスが起動している

8

すべて停止している

12

異常終了（イベントサーバがエラーを返した）

補足事項

UNIX上のクラスタシステムで運用している場合，論理ホストの異常検知スクリプトにjevstatコマンドを組み込んで利用できます。この場合，論理ホスト上で動作させるイベントサーバ名の大文字小文字を意識して正しく指定してください。論理ホスト用イベントサーバ名は，イベントサーバインデックスファイル（index）に定義されているので，これを参考にして指定してください。

イベントサーバインデックスファイル（index）の定義例と，それを基にjevstatコマンドを実行した場合の実行結果を次に示します。

イベントサーバインデックスファイル（index）内の定義例

server * default
server HOSTZZ /jp1/share/

jevstatコマンド実行例と実行結果

jevstatコマンド実行例

実行結果

jevstat

物理ホスト上のイベントサーバの状態を表示します。

jevstat hostzz

指定されたイベントサーバ名が見つからない旨のエラーメッセージを表示します。

jevstat HOSTZZ

論理ホスト上のイベントサーバの状態を表示します。

使用例

jevstatコマンドの実行例をWindows，UNIXに分けて次に示します。

Windowsの場合

E:¥>jevstat
KAJP1771-I HOST1の状態通知処理を開始します
稼働中のプロセスを表示します
プロセス名称  プロセスID
  jevservice        1234
KAJP1772-I プロセスは全て起動しています

UNIXの場合

$ /opt/jp1base/bin/jevstat
KAJP1771-I HOST1の状態通知処理を開始します
稼働中のプロセスを表示します
プロセス名称  プロセスID
  jevservice        2098
KAJP1772-I プロセスは全て起動しています

KAJP1772-Iは，イベントサーバとして必要なプロセスがすべて起動しているときに表示されるメッセージです。

jevstop（UNIX限定）

機能

手動でイベントサーバを停止します。

形式

jevstop [イベントサーバ名]

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

イベントサーバ名

起動するイベントサーバを指定します。イベントサーバ名を省略すると，自ホストと同じイベントサーバ名が仮定されます。

戻り値

0

正常終了

255

異常終了

Jischk

機能

ISAMファイルの論理構造を検証し，不正がある場合にメッセージを表示します。指定された検証レベルに応じて，ISAMファイルを構成する各ファイルの内容や，ファイルの関連などを検証します。

また，UNIXでは，キーファイルが不正な場合，キーの情報を表すキー定義パラメーターを出力できます。このパラメーターを使用すると，Jiskeymnt（キーの追加，削除，および再構築）コマンドでキーファイルを再構築できます。

形式

Jischk [-l レベル] ファイル名 ...（Windowsの場合）
Jischk [-l レベル] [-p] ファイル名 ...（UNIXの場合）

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-l レベル

ファイルを検証するレベルを指定します。レベルの数字が大きいほど，検証の内容が厳密になり，処理時間が長くなります。

1

Windowsの場合，キーファイルだけを検証します。

UNIXの場合，キー定義ファイル，およびキーファイルを検証します。

2

Windowsの場合，キーファイル，およびキーファイルとデータファイルの関連を検証します。

UNIXの場合，キー定義ファイル，キーファイル，およびキーファイルとデータファイルの関連を検証します。

3

次の項目を検証します。

キー定義ファイル（UNIX限定）

キーファイル

キーファイルとデータファイルの関連

データファイルの構造

レコード件数

省略時は，1が仮定されます。

-p

キーファイルの不正が検出されたとき，Jiskeymnt（キーの追加，削除，および再構築）コマンド用のキー定義パラメーターを標準出力する場合に指定します。なお，このオプションはUNIXだけで使用できます。

ファイル名

検証するファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。複数のファイルを指定する場合は，ファイル名を1文字以上のスペースで区切ります。また，ワイルドカード（*）を使用してファイルを指定できます。なお，Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

（例）

Windowsの場合の指定例を次に示します。

ディレクトリ"c:¥data"にあるすべてのファイルを指定します。

Jischk -l3 c:¥data¥*

ディレクトリ"c:¥data"にある，ファイル名が"SAMPLE"で始まるファイルを指定します。

Jischk -l3 c:¥data¥SAMPLE*

注意事項

複数のファイルを指定したときに，処理の途中で入出力エラーが発生した場合や，ファイルがなかった場合は，その時点でコマンドの実行は終了します。

Windowsで，検証結果をテキストファイルなどに出力したい場合は，>のあとに出力先のファイル名を指定します。指定例を次に示します。

（例）

Jischk -l3 sample > chk.txt

戻り値

0

正常終了

1

異常終了

2

異常終了（ファイルの不整合があった場合に返される）

Jiscond

機能

データファイルの無効領域を圧縮します。同時に，キーファイルを再構築します。

レコードを更新したり，レコードを削除したりすると，データファイルに無効領域が発生します。このコマンドでは，データファイルの無効データを除去して，データファイルを圧縮します。また，キー定義ファイルのキー情報に従って，キーを抽出しながらキーファイルを再構築します。ただし，ファイルにキーが定義されていない場合，キーファイルは再構築しません。

形式

Jiscond [-r] [-d dir ワークフォルダ名] [-k | -q] ファイル名（Windowsの場合）
Jiscond [-T dir ワークディレクトリ名] [-k | -q] ファイル名（UNIXの場合）

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-r

データファイルおよびキーファイルの圧縮率を表示する場合に指定します。指定すると，ファイル圧縮ユーティリティの実行結果に，圧縮前のファイルサイズに対する圧縮後のファイルサイズの割合が表示されます。

-d dir ワークフォルダ名

ファイルの圧縮では，キーファイルをソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。省略時は，環境変数のtemp，またはtmpで指定されたディレクトリ，またはカレントディレクトリを使用します。なお，このオプションはWindowsだけで使用できます。

-T dir ワークディレクトリ名

ファイルの圧縮では，キーファイルをソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。省略時は，/tmp，または/usr/tmpを使用します。なお，このオプションはUNIXだけで使用できます。

-k

ISAMファイルの再編成と同時に，肥大化抑止を設定する場合に指定します。JP1の運用を長期間継続すると，ISAMデータベースのインデックスであるキーファイルのサイズが際限なく増加するため，定期的にISAMファイルを再編成する必要があります。この引数を指定すれば，キーファイルの肥大化を抑止できます。

-q

ISAMファイルの再編成と同時に，肥大化抑止の設定を解除する場合に指定します。JP1を以前のバージョンに戻すためには，以前のバージョンで対応していない機能を解除する必要があります。この引数を指定すれば，以前のバージョンのJP1でもISAMファイルをアクセスできます。

ファイル名

検証するファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。Windowsで，複数のファイルを指定する場合は，ファイル名を1文字以上のスペースで区切ります。スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。また，ワイルドカード（*）を使用してファイルを指定できます。

（例）

Windowsの場合の指定例を次に示します。

ディレクトリc:¥dataにあるすべてのファイルを指定します。

Jiscond c:¥data¥*

ディレクトリc:¥dataにある，ファイル名がSAMPLEで始まるファイルを指定します。

Jiscond c:¥data¥SAMPLE*

注意事項

ファイルを圧縮するときにワークファイルを使用します。また，ファイルの圧縮では，データファイルの複製を作成してからキーファイルを構築するので，容量の大きいファイルを圧縮する場合には注意が必要です。

Windowsで，複数のファイルを指定したときに，処理の途中で入出力エラーが発生した場合，またはファイルがなかった場合は，その時点でコマンドの実行は終了します。

Windowsで，圧縮率を表示する指定にすると，結果が表示されるまでに多少時間が掛かります。

戻り値

0

正常終了

1

異常終了

Jisconv

機能

順編成ファイルをISAMファイルに変換します。また，ISAMファイルを順編成ファイルに変換します。

このコマンドは，障害が発生したISAMファイルから順編成ファイルに抽出したデータレコードを，ISAMファイルのデータファイルに回復する場合などに使用します。

ISAMファイルに変換する

キー定義ファイルの内容に従って，順編成ファイルをISAMファイルのデータファイルに変換します。このとき，同時にキーファイルを作成します。ただし，ISAMファイルにキーが定義されていない場合，キーファイルは作成しません。

変換元の順編成ファイルと変換先のISAMファイルは，レコード種別が同じでなければなりません。レコード種別の関係を，次の表に示します。

表15‒4　レコード種別の関係（ISAMファイルに変換する場合）

順編成ファイル（変換元）

ISAMファイル（変換先）

固定長

可変長

固定長

○

×

可変長

×

○

（凡例）

○：変換する

×：変換しない

レコード長の扱いは，次のようになります。

固定長の順編成ファイルを固定長のISAMファイルに変換する場合

変換先のキー定義ファイルに定義されているレコード長を，変換元のレコード長と見なして変換します。

可変長の順編成ファイルを可変長のISAMファイルに変換する場合

変換元の各レコードのレコード長に従って変換します。

変換元のレコード長が，変換先のキー定義ファイルに定義されているレコード長の範囲に含まれていない場合は，変換元のレコード長を不正と見なし，変換を中止します。

注意事項

順編成ファイルをISAMファイルに変換する際の注意事項を次に示します。

変換先のISAMファイルを，あらかじめ作成しておく必要があります。

ISAMファイルに変換する際，ワークファイルを使用します。

順編成ファイルに変換する

ISAMファイルのデータファイルを，順編成ファイルに変換します。変換元のレコードは，データファイル中での物理的な並び順に従って出力されます。データファイル中の削除レコードは，出力されません。

変換元のISAMファイルと変換先の順編成ファイルは，レコード種別が同じでなければなりません。レコード種別の関係を，次の表に示します。

表15‒5　レコード種別の関係（順編成ファイルに変換する場合）

ISAMファイル（変換元）

順編成ファイル（変換先）

固定長

可変長

固定長

○

×

可変長

×

○

（凡例）

○：変換する

×：変換しない

レコード長の扱いは，次のようになります。

固定長のISAMファイルを固定長の順編成ファイルに変換する場合

変換元のキー定義ファイルに定義されているレコード長を，変換先のレコード長と見なして変換します。

可変長のISAMファイルを可変長の順編成ファイルに変換する場合

変換元のキー定義ファイルに定義されている最小レコード長，および最大レコード長を，変換先の最小レコード長，および最大レコード長と見なして変換します。

形式

Jisconv [-f] -t タイプ [-d dir ワークフォルダ名] ファイル名1 ファイル名2（Windowsの場合）
Jisconv -t タイプ [-T dir ワークディレクトリ名] ファイル名1 ファイル名2（UNIXの場合）

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-f

ファイル名2で指定したものと同じファイル名のファイルが存在するとき，上書き確認メッセージを表示しない場合に指定します。なお，このオプションはWindowsだけで使用できます。

-t タイプ

ファイルの変換タイプを，次に示すどちらかで指定します。

SI

順編成ファイルをISAMファイルに変換します。

IS

ISAMファイルを順編成ファイルに変換します。

-d dir ワークフォルダ名

順編成ファイルをISAMファイルに変換する場合，キーファイルをソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。省略時は，環境変数のtemp，またはtmpで指定されたディレクトリ，またはカレントディレクトリを使用します。なお，このオプションはWindowsだけで使用できます。

-T dir ワークディレクトリ名

順編成ファイルをISAMファイルに変換する場合，キーファイルをソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。省略時は，/tmp，または/usr/tmpを使用します。なお，このオプションは，UNIXだけで使用できます。

ファイル名1

変換元ファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

UNIXの場合，順編成ファイルからISAMファイルへの変換で，ハイフン（-）を指定した場合は，標準入力を仮定します。

ファイル名2

変換先ファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。同じファイル名のファイルが存在する場合，上書きします。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

UNIXの場合，ISAMファイルから順編成ファイルへの変換で，ハイフン（-）を指定した場合は，標準出力を仮定します。

戻り値

0

正常終了

1

異常終了

Jiscpy

機能

指定したISAMファイルをコピーします。複数のISAMファイルを，指定したディレクトリにコピーすることもできます。

形式

Jiscpy コピー元ファイル名 コピー先ファイル名
Jiscpy コピー元ファイル名1 [コピー元ファイル名2 ...] コピー先ディレクトリ名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

コピー元ファイル名

コピーするISAMファイルを指定します。

コピー先ファイル名

コピー先のファイル名を指定します。

コピー元ファイル名1 [コピー元ファイル名2 ...]

ISAMファイルを複数コピーする場合に指定します。なお，ISAMファイルを複数指定する場合は，コピー先ディレクトリ名を指定する必要があります。

コピー先ディレクトリ名

コピーするISAMファイルを格納するディレクトリ名を指定します。

注意事項

ISAMファイルを安全にコピーするには，JP1/Baseを停止する必要があります。

戻り値

0

正常終了

1

異常終了

Jisext

機能

障害が発生したISAMファイルのデータファイルから，有効なレコードをできる限り抽出し，順編成ファイルに回復します。また，UNIXの場合，ISAMファイルのキー定義情報を出力します。

このコマンドでは，データファイルの先頭からレコードを検証し，不正を検出するまで，レコードを順編成ファイルへ出力します。次に，末尾からレコードを検証し，不正を検出するまで，レコードを順編成ファイルへ出力します。

レコードを抽出するとき，レコード種別，およびレコード長は，キー定義ファイルに基づいて決定されます。そのため，キー定義ファイルが破壊されている場合は，これらの属性をオプションで指定する必要があります。ファイルを検証したときに，定義ファイルの不正を検出したというメッセージが表示された場合，キー定義ファイルは破壊されています。なお，キー定義ファイルが正常な場合でも，これらの属性を指定できます。この場合，指定した属性でレコードが抽出されます。

形式

Jisext [-f レコード種別:レコード長] ファイル名1 ファイル名2（Windowsの場合）
Jisext {-p | -f レコード種別:レコード長} ファイル名1 [ファイル名2]（UNIXの場合）

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-p

キー定義パラメーターを標準出力したい場合に指定します。-fオプションと同時に指定できません。なお，このオプションは，UNIXだけで使用できます。

-f レコード種別:レコード長

ISAMファイルのレコード種別，およびレコード長を指定します。ここでの指定は，キー定義ファイルでの指定より優先されます。UNIXの場合，-pオプションと同時に指定できません。

レコード種別

レコード種別を，次のどちらかで指定します。

f：固定長

v：可変長

レコード長

レコード長を，1〜65,503の範囲で指定します。

レコード種別が可変長の場合，最大レコード長を指定します。この場合，最小レコード長は1を仮定します。

ファイル名1

レコードを抽出するISAMファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

ファイル名2

抽出したレコードを出力する順編成ファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。同じファイル名のファイルが存在する場合，上書きします。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

戻り値

0

正常終了

1

異常終了

Jisinfo

機能

ISAMファイルを構成するファイルに関する情報，およびキーに関する情報を表示します。

次に示す，キー定義ファイルの内容を表示します。

データファイルに関する情報

レコード形式，レコード長，フラグ類

キーファイルに関する情報

キーファイルページ長，キー項目名，キー項目数，キーファイル名，フラグ類，キーの要素数，キーの位置，キーの長さ，キーの属性

形式

Jisinfo [-u] [-e] ファイル名（-eオプションはUNIX限定）

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-u

レコードの削除や更新によってデータファイルおよびキーファイルに未使用領域ができます。このファイルの未使用領域サイズの割合を表示する場合に指定します。なお，未使用領域率が高い場合は，ファイル圧縮ユーティリティで未使用領域率を0にできます。

-e

このオプションはUNIXだけで使用できます。

ISAMファイルの肥大化抑止機能の設定を確認する場合に指定します。設定が有効のときは，「キーファイル再利用」の項目に「再利用する」と表示されます。なお，Windowsの場合で肥大化抑止が設定されているとき，ISAMファイルの肥大化抑止の状態は常に表示されます。

ファイル名

キー定義情報を表示するファイルのファイル名を指定します。ドライブ，およびディレクトリを省略した場合は，カレントドライブ，およびカレントディレクトリが仮定されます。複数のファイルを指定する場合は，ファイル名を1文字以上のスペースで区切ります。また，ワイルドカード（*）を使用してファイルを指定できます。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

（例）

Windowsの場合の指定例を次に示します。

ディレクトリc:¥dataにあるすべてのファイルを指定します。

Jisinfo c:¥data¥*

ディレクトリc:¥dataにある，ファイル名がSAMPLEで始まるファイルを指定します。

Jisinfo c:¥data¥SAMPLE*

注意事項

複数のファイルを指定したときに，処理の途中で入出力エラーが発生した場合や，ファイルがなかった場合は，その時点でコマンドの実行は終了します。

検証結果をテキストファイルなどに出力したい場合は，>のあとに出力先のファイル名を指定します。指定例を次に示します。

（例）

Jisinfo sample > info.txt

未使用領域を表示する指定にすると，キー定義情報が表示されるまでに多少時間が掛かります。

未使用領域を表示する指定にすると，指定したISAMファイルがほかの処理でアクセス中の場合，占有エラーとなります。

戻り値

0

正常終了

1

異常終了

Jiskeymnt

機能

キーを追加，または削除したり，キーファイルを再構築したりします。追加，削除，および再構築するキーの情報は，テキストエディターやUNIXのviなどのエディターを使用して，キー定義パラメーターファイルに定義しておきます。

キーの追加

キー項目名やキーの定義情報を，キー定義ファイルへ追加します。また，追加するキーに対応するキーファイルを作成します。

キーの削除

キー項目名やキーの定義情報を，キー定義ファイルから削除します。また，削除するキーに対応するキーファイルを削除します。

キーの再構築

指定されたキーに対応するキーファイルを，現在のキー定義内容で再作成します。

形式

Jiskeymnt ファイル名（Windowsの場合）
Jiskeymnt [ファイル名 ...]（UNIXの場合）

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

ファイル名

キーを編集するISAMファイルの情報を記述した，キー定義パラメーターファイルのファイル名を指定します。

Windowsの場合，スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

UNIXの場合，省略時は，ISAMファイルのキー定義情報を標準入力から読み込みます。複数のファイルを指定する場合は，ファイル名を1文字以上のスペースで区切ります。また，ワイルドカード（*）を使用してファイルを指定できます。

（例）

Windowsの場合の指定例を次に示します。

ディレクトリc:¥dataにあるすべてのファイルを指定します。

Jiskeymnt c:¥data¥*

ディレクトリc:¥dataにある，ファイル名がSAMPLEで始まるすべてのファイルを指定します。

Jiskeymnt c:¥data¥SAMPLE*

キー定義パラメーターファイルの定義方法

キーの追加，削除，および再構築で使用するキー定義パラメーターファイルの定義方法を説明します。

パラメーターファイルの指定内容

キー定義パラメーターファイルに指定する内容を，次の表に示します。

表15‒6　キー定義パラメーターファイルの指定内容（キーの追加，削除，および再構築）

キーワード

形式

内容

fi-

ファイル名※1

ISAMファイルのファイル名を指定する。パス名を含めて指定できる。OSのファイル名の規則に従うこと。

Windowsの場合，スペースを含むファイル名は，ダブルクォーテーションマーク（"）で囲む。

UNIXの場合，指定できるファイル名の最大長は，ファイル名の長さに関するOSの制限値よりも4文字短い。

an-

キー項目名※2

キーを追加するとき，キー項目名を指定する。

dn-

キー項目名※2

キーを削除するとき，キー項目名を指定する。

rn-

キー項目名※2

キーを再構築するとき，キー項目名を指定する。すべてのキーを再構築する場合は，キー項目名を省略する。

ke-

t=キー属性

,p=キー位置

,l=キー長

[,ISDESC]

キーを追加するとき，キーの詳細を指定する。キー追加時は，必ず指定する。合成キーの場合，構成項目ごとに指定する。※3

キー属性

次のどれかを指定する。

c：文字型（CHARTYPE）

i：2バイト整数型（INTTYPE）

l：4バイト整数型（LONGTYPE）

f：計算機浮動型（FLOATTYPE）

d：計算機倍長型（DOUBLETYPE）

キー位置

レコード種別に応じて，次のように指定する。

固定長の場合：0〜（レコード長−1）の範囲

可変長の場合：0〜（最小レコード長−1）の範囲

キー長

キー属性に応じて，次のように指定する。

c（文字型）の場合：1〜255の範囲

i（2バイト整数型）の場合：2

l（4バイト整数型）の場合：4

f（計算機浮動型）の場合：4

d（計算機倍長型）の場合：8

ISDESC

キーの要素が降順型であることを示す。省略時は昇順型とする。

cp-

重複情報，圧縮情報

キーを追加するとき，キーの重複および圧縮の情報を16進4桁で指定する。

ビット位置15：重複キー順序保証

キー値が重複した場合のキー作成順を保証するかを指定する。

0：保証する

1：保証しない

ビット位置14：スパースキーの有無

0：なし

1：あり

ビット位置1〜13：予備（Windowsの場合）

(0000000000)₂固定

ビット位置4〜13：予備（UNIXの場合）

(0000000000)₂固定

ビット位置1〜3：圧縮レベル※4（UNIXの場合）

(111)₂：完全圧縮

(000)₂：圧縮なし

ビット位置0：重複キーの許可

0：認めない

1：認める

sp-

スパース文字

キーを追加するとき，スパース文字の内部値を16進2桁で指定する。cpパラメーターでスパースキーありを指定した場合に指定する。

注※1　末尾に".KDF"，".DRF"，および".K01"〜".K99"を付けたファイル名は指定できない。

注※2　各キー項目名は半角で31バイトまで指定できる。また，an-パラメーターのキー項目名に"K01"〜"K99"は指定できない。

注※3　キー属性，キー位置，キー長，および順序（ISDESC）がすべて同じ構成項目を，複数指定できない。

注※4　このISAMファイル管理では，圧縮レベルの指定内容に関係なく，キーは圧縮される。

キー定義パラメーターファイルには，追加するキー，削除するキー，および再構築するキーを，同時に指定できます。また，それぞれ複数のキーを指定できます。

パラメーターの記述方法

キー定義パラメーターファイルのパラメーターの記述方法を，次に示します。

パラメーターファイル定義時の注意事項

キー定義パラメーターファイルを定義するときの注意事項を，次に示します。

各パラメーターの間には，1個以上のスペースを指定してください。

（例）

fi-isamfile△rn-subkey1△...

（凡例）△：スペース

パラメーター内にスペースは指定できません。

（例）

ke-t=c△,p=10...

（凡例）△：スペース

注意事項

主キーの追加，および削除はできません。

キーの追加，および再構築では，ワークファイルを使用します。

UNIXで，複数のファイルを指定したときに，処理の途中で入出力エラーが発生した場合や，ファイルがなかった場合は，その時点でコマンドの実行は終了します。

戻り値

0

正常終了

1

異常終了

Jisktod

機能

障害が発生したISAMファイルのキーファイルから，有効なレコードをできる限り抽出し，順編成ファイルに回復します。また，このコマンドは，回復するISAMファイルに排他モードでロックをかけます。回復するISAMファイルにアクセスしている場合は，このコマンドを実行する前に必ずアクセスしていない状態にしてください。

ISAMファイルの以下に示す論理構造を検証し，キーファイルで管理している有効レコードを順編成ファイルへ出力します。

定義ファイルの論理構造

データファイルのサイズとレコードの論理構造

キーファイルの論理構造とデータファイルとの整合性

論理構造を検証した結果，不正を検出した場合は，指定されたメッセージ出力レベルに応じて，詳細なメッセージを出力します。致命的な不正を検出した場合は，コマンドは異常終了し，順編成ファイルは作成されません。ただし，不正の内容によっては，できる限り有効レコードを抽出します。

レコードを抽出するとき，レコード種別，およびレコード長は，キー定義ファイルに基づいて決定されます。そのため，キー定義ファイルが破壊されている場合は，レコードを抽出できません。

出力された順編成ファイルは，既存のファイルの変換コマンド（Jisconv）で，ISAMファイルに変換できます。変換先のレコード種別，およびレコード長は，順編成ファイルと同じにしてください。

形式

Windowsの場合

Jisktod [-k キー項目名]
        [-l メッセージの出力レベル]
        [-b バッファサイズ]
        [-d ワークフォルダ名]
        抽出対象のISAMファイル名 順編成ファイル名
Jisktod -c
        [-k キー項目名]
        [-l メッセージの出力レベル]
        [-b バッファサイズ]
        [-d ワークフォルダ名]
        検証対象のISAMファイル名

UNIXの場合

Jisktod [-k キー項目名]
        [-l メッセージの出力レベル]
        [-b バッファサイズ]
        [-T ワークディレクトリ名]
        抽出対象のISAMファイル名 順編成ファイル名
Jisktod -c
        [-k キー項目名]
        [-l メッセージの出力レベル]
        [-b バッファサイズ]
        [-T ワークディレクトリ名]
        検証対象のISAMファイル名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-c

ISAMファイルの論理構造の検証だけを実行したい場合に指定します。指定したISAMファイルの各キーファイルからレコードが抽出できるかどうかを検証します。ISAMファイルの論理構造を検証した結果，各キーファイルから抽出できるレコード件数やエラーの内容を標準エラー出力にメッセージを出力します。

このオプションを指定する場合は，検証したいISAMファイル名を指定してください。

このオプションを省略した場合は，ISAMファイルの論理構造の検証を実行したあとに有効なレコードをできる限り抽出し，順編成ファイルに回復します。このオプションを省略する場合は，有効レコードを抽出するISAMファイル名と，抽出した有効レコードを出力する順編成ファイル名を指定してください。

-kオプションを指定した場合は，検証したいキーファイルを特定できます。

-kオプションを省略した場合は，キー定義ファイルに定義されているすべてのキーファイルを検証します。対象のキーファイルが存在しない場合は，検証処理をスキップし，次のキーファイルの検証処理を実行します。

-k キー項目名

キー項目名は，キー定義情報の表示コマンド（Jisinfo）で表示されるキーファイル情報のキー項目名を指定します。

-cオプションを指定する場合（ISAMファイルの論理構造を検証したい場合）は，検証したいキーファイルのキー項目名を指定します。-cオプションを指定し，-kオプションを省略した場合，キー定義ファイルに定義されているすべてのキーファイルを検証します。

-cオプションを省略する場合（ISAMファイルから有効レコードを抽出したい場合）は，有効レコードを抽出するキーファイルのキー項目名を指定します。-cおよび-kオプションを省略した場合は，キー定義情報の表示コマンド（Jisinfo）で表示されるキーファイル情報の最初のキー項目名のキーファイルに対して，有効レコードが抽出されます。

-l メッセージの出力レベル

エラーの内容を示す詳細メッセージを標準エラー出力に出力するかどうかを指定します。指定できる値は0または1です。1を指定した場合は，詳細メッセージを含めすべてのメッセージを標準エラー出力に出力します。省略した場合は，0が設定されます。

-b バッファサイズ（MB）

ファイル入出力に使用するバッファサイズを指定します。指定できる値は0〜256（メガバイト）です。0を指定した場合はバッファを確保しません。省略した場合は，16が設定されます。

-d ワークフォルダ名

キーファイルから有効レコードを取り出しソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するフォルダを指定します。このオプションを省略した場合は，環境変数のtemp，tmpで指定されたフォルダ，またはカレントフォルダを使用します。なお，このオプションはWindowsだけで使用できます。

-T ワークディレクトリ名

キーファイルから有効レコードを取り出しソートするために，ワークファイルを使用します。そのため，ワークファイルを作成するディレクトリを指定します。このオプションを省略した場合は，/tmpまたは/usr/tmpを使用します。なお，このオプションはUNIXだけで使用できます。

抽出対象のISAMファイル名

-cオプションを省略した場合に指定できます。キーファイルから有効レコードを抽出するISAMファイル名を指定します。ドライブ名およびディレクトリ名を省略した場合は，カレントドライブおよびカレントディレクトリが仮定されます。スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

また，ファイル名の後ろに定義ファイルの拡張子※を指定した場合，指定した拡張子を取り除いた名前をISAMファイル名と仮定します。定義ファイルの拡張子※以外を指定した場合は，拡張子を含めた名前をISAMファイル名と仮定します。

注※

Windowsの場合：半角大小文字の「.KDF」

UNIXの場合：半角大文字の「.DEF」

順編成ファイル名

-cオプションを省略した場合に指定できます。抽出対象のISAMファイルで指定したISAMファイルから抽出した有効レコードを出力する順編成ファイル名を指定します。すでに存在するファイル名を指定した場合は，上書きされます。

ドライブ名およびディレクトリ名を省略した場合は，カレントドライブおよびカレントディレクトリが仮定されます。スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

また，ISAMファイルの拡張子※は指定できません。

注※

Windowsの場合：半角の大文字または小文字の「.KDF」「.DRF」「.K01〜.K99」

UNIXの場合：半角大文字の「.DEF」「.DAT」「.K01〜.K99」

検証対象のISAMファイル名

-cオプションを指定した場合に指定できます。論理構造を検証するISAMファイル名を指定します。ドライブ名およびディレクトリ名を省略した場合は，カレントドライブおよびカレントディレクトリが仮定されます。スペースを含むファイル名を指定する場合は，ダブルクォーテーションマーク（"）で囲みます。

また，ファイル名の後ろに定義ファイルの拡張子※を指定した場合，指定した拡張子を取り除いた名前をISAMファイル名と仮定します。定義ファイルの拡張子※以外を指定した場合は，拡張子を含めた名前をISAMファイル名と仮定します。

注※

Windowsの場合：半角の大文字または小文字の「.KDF」

UNIXの場合：半角大文字の「.DEF」

注意事項

-cオプションを省略した場合，ファイル入出力に使用するバッファは2面使用されます。したがって，-bオプションに指定した値の2倍のバッファサイズが確保されます。

複数のキーファイルを持つISAMファイルのうち，どれか1個でも論理構造が確保されていないキーファイルが存在すると，ファイルの変換コマンド（Jisconv）でISAMファイルに変換できないことがあります。

戻り値

0

正常終了

1

抽出できないレコードが存在する

2

一部整合性が確保されていないが，抽出できるレコードが存在する

3

引数誤り，ファイル不正，システムエラー，内部矛盾，排他エラー

使用例

ISAMファイル（ISAMFILE）から順編成ファイル（SAMFILE）に有効レコードを抽出する例を次に示します。

1個のISAMファイルから順編成ファイルに抽出する例

>Jisktod ISAMFILE SAMFILE
KAIU347-I 索引順編成ファイルのデータファイル検証を開始します。
            ISAMファイル名　: ISAMFILE
KAIU348-I 索引順編成ファイルのデータファイル検証を終了します。
            ISAMファイル名　: ISAMFILE
KAIU321-I 索引順編成ファイルの抽出を開始します。
            キー項目名　　　: K01
            ISAMファイル名　: ISAMFILE
            出力ファイル　　: SAMFILE
KAIU323-I 正常にキーファイルからレコードを抽出しました。
            キー項目名　　　: K01
            抽出件数　　　　: 101
            登録件数　　　　: 101
            ISAMファイル名　: ISAMFILE
            出力ファイル　　: SAMFILE

2個のキーファイル（キー項目名：K01とK02）を持つISAMファイルから順編成ファイルに抽出する例

1.　各キーファイルに対してキーファイルの論理構造を検証します。

>Jisktod -c -l 1 ISAMFILE
KAIU347-I 索引順編成ファイルのデータファイル検証を開始します。
ISAMファイル名　: ISAMFILE
KAIU348-I 索引順編成ファイルのデータファイル検証を終了します。
      ISAMファイル名　: ISAMFILE
KAIU322-I 索引順編成ファイルのキーファイル検証を開始します。
      キー項目名　　　: K01
      ISAMファイル名　: ISAMFILE
KAIU333-W リーフページとレコードのキーが一致していません。
キー項目名: K01 ISAMファイル名: ISAMFILE オフセット: 0x00000000
KAIU342-W 定義ファイルとキーファイルのレコード件数が一致しません。
      キー項目名　　　: K01
      有効レコード件数: 100
      登録件数　　　　: 101
      ISAMファイル名　: ISAMFILE
KAIU340-W キーファイルから管理されていないレコードが存在します。
      キー項目名　　　: K01
      ISAMファイル名　: ISAMFILE
      オフセット　　　: 0x00000000
KAIU328-W キーファイルは一部整合性が確保できていません。
      キー項目名　　　: K01
      抽出可能件数　　: 100
      登録件数　　　　: 101
      ISAMファイル名　: ISAMFILE
KAIU322-I 索引順編成ファイルのキーファイル検証を開始します。
      キー項目名　　　: K02
      ISAMファイル名　: ISAMFILE
KAIU324-I キーファイルは正常な状態です。
      キー項目名　　　: K02
      抽出可能件数　　: 101
      登録件数　　　　: 101
      ISAMファイル名　: ISAMFILE

2.　手順1で検証した結果，正常なキーファイル（キー項目名：K02）を使用して，レコードを抽出します。

>Jisktod -k K02 ISAMFILE SAMFILE
KAIU347-I 索引順編成ファイルのデータファイル検証を開始します。
      ISAMファイル名　: ISAMFILE
KAIU348-I 索引順編成ファイルのデータファイル検証を終了します。
      ISAMファイル名　: ISAMFILE
KAIU321-I 索引順編成ファイルの抽出を開始します。
      キー項目名　　　: K02
      ISAMファイル名　: ISAMFILE
      出力ファイル　　: SAMFILE
KAIU323-I 正常にキーファイルからレコードを抽出しました。
      キー項目名　　　: K02
      抽出件数　　　　: 101
      登録件数　　　　: 101
      ISAMファイル名　: ISAMFILE
      出力ファイル　　: SAMFILE

Jislckclear（Windows限定）

機能

ISAMファイルにアクセスしているJP1製品のプロセスを強制終了した場合などで，消滅したプロセスによってファイルやレコードが占有されたままとなっている状態を確認および解除します。

形式

Jislckclear {-c | -d}

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-c

消滅したプロセスによってファイルやレコードが占有されているかどうかを確認します。消滅したプロセスのファイルやレコードの占有情報が残っている場合は，KAIU315-Iのメッセージが標準エラー出力に出力されます。

-d

消滅したプロセスによってファイルやレコードが占有されている状態をすべて解除します。

注意事項

このコマンドの実行中，ISAMファイルにアクセスしているJP1製品のプロセスは待機状態となることがあります。

-cオプションで占有情報を確認したあと，-dオプションで解除する間に，ISAMファイルをアクセスしているほかのプロセスによって，占有状態が解除される場合があります。このため，-cオプションで表示される占有情報の個数と，-dオプションで表示される解除した数は一致しない場合があります。

戻り値

0

正常終了

1

正常終了（占有情報の通知または解除）

2

正常終了（占有情報がないため処理を終了）

3

異常終了（実行権限がない）

4

異常終了（引数の誤り）

5

異常終了（システムコールエラー）

99

異常終了（プログラム論理エラー）

Jislckext

機能

ロックテーブルのエントリー数を拡張，または縮小します。なお，Jislckextコマンド実行前や実行後にロックテーブルの状態を表示する手順は，次のようになります。

Windowsの場合

Jislckextコマンドの-tオプションを使用して現在のロックエントリー数を取得する。

コマンドは次のように指定して実行してください。

Jislckext -t

エントリー数を変更する。

コマンドは次のように指定して実行してください。

Jislckext エントリー数

Jislckextコマンドの-tオプションを使用してロックエントリー数が変更されたことを確認する。

コマンドは次のように指定して実行してください。

Jislckext -t

UNIXの場合

ipcsコマンドで共有メモリーのセグメントサイズを調べる。

コマンドは次のように指定して実行してください。

ipcs -ma | grep 0x88

エントリー数を求める。

次に示す計算式でエントリー数が求まります。

（ipcsコマンド実行結果 - 36972） / 104

エントリー数を変更する。

コマンドは次のように指定して実行してください。

Jislckext エントリー数

ipcsコマンドで共有メモリーのセグメントサイズが変更されたことを確認します。

ipcs -ma | grep 0x88

形式

Jislckext エントリー数

実行権限

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

UNIXの場合：スーパーユーザー権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

エントリー数

指定したエントリー数で，ロックテーブルを再作成します。

注意事項

ロックテーブルがほかのプロセスで使用中の場合は，使用中のエントリー数だけを返します。

ロックテーブルのエントリー数を変更する場合は，JP1/Baseのサービス，およびJP1/AJSのサービスを停止する必要があります。また，ISAMファイルの操作，保守に関するユーティリティコマンド，およびJP1/AJSのジョブネットを操作するコマンドを終了する必要があります。

ロックテーブルのエントリー数の最大は，32,767です。

戻り値

0

正常終了

1

異常終了

Jislckfree（Windows限定）

機能

システム共有メモリーに持つISAMのロックテーブルから，PIDで指定されたロックエントリー情報を削除します。これによって，ファイル・レコード占有が解除されます。指定されたPIDがISAMのロックテーブル中になくても正常終了します。ISAMのロックテーブルがない（ISAMを使用しているJP1製品が起動していない）状態でコマンドを実行した場合，"SetSecurity DescriptorDacl Error"のエラーメッセージで異常終了します。

形式

Jislckfree -p PID

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

引数

-p PID

PIDには，ISAMファイル・レコード占有中のプロセスIDを指定します。

注意事項

ISAMのロックテーブルから指定されたPIDで示されるロックエントリー情報をすべて削除するため，PIDで示されるJP1製品の起動中にコマンドは実行しないようにしてください。

ロックエントリー情報を削除したいPIDは，Jismlcktrコマンドでわかります。

戻り値

0

正常終了

1

異常終了

Jislckreg（UNIX限定）

機能

ISAMで使用するリソースの設定を支援します。

JP1製品に組み込まれているISAMデータベースはシステムで共通のリソースを使用しているため，ある製品でISAMデータベースへのアクセスが集中した場合，ほかのJP1製品のISAMデータベースへのアクセスと動作が干渉して性能が低下することがあります。ISAMで使用するリソースを分割するとアクセス性能を向上できます。設定方法については，各JP1製品のマニュアルを参照してください。

形式

Jislckreg {-r | -c | -i | -s}

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/bin/

引数

-r

現在の設定ファイル（/etc/opt/jp1base/conf/Jismdef.ini）の内容に従ってISAMで使用するリソース（共有メモリーとセマフォ）を設定します。ISAMリソースの設定は，JP1/Baseの起動時に自動的に行われるため，この引数を使用して本コマンドを実行する必要はありません。

-c

設定ファイル（/etc/opt/jp1base/conf/Jismdef.ini）の文法をチェックします。

-i

現在のシステム上のリソース設定情報を表示します。

-s

設定ファイル（/etc/opt/jp1base/conf/Jismdef.ini）でのシステムリソース使用量を表示します。

注意事項

設定を変更する場合，すべてのJP1サービスを停止してからファイル内容の変更をしてください。

設定ファイルの変更後，すべてのJP1サービスを再起動する前にJisrsdelコマンドを実行してください。

戻り値

0

正常終了

1

異常終了

Jismlcktr（Windows限定）

機能

ISAMロックテーブルの情報を表示します。表示内容を次に示します。

形式

Jismlcktr

実行権限

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

格納先ディレクトリ

インストール先フォルダ¥bin¥

Jisprt

機能

データファイルのレコードの内容を，指定した形式に編集して表示します。表示形式には，ダンプ形式，文字形式，および16進形式があります。

レコード内容の表示は，次に示すときに終了します。

データファイルのすべてのレコードの内容を，表示し終わったとき。

オプションで指定した範囲内のレコードの内容を，表示し終わったとき。

オプションで指定した件数分のレコードの内容を，表示し終わったとき。

形式

Jisprt [-t タイプ]
       {[-k キー項目名][-s 開始キー値[:x]][-e 終了キー値[:x]] | -d}
       [-c レコード件数]
        ファイル名

実行権限

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

UNIXの場合：スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-t タイプ

レコード内容の表示形式を，次のどれかで指定します。

d（ダンプ形式）

c（文字形式）

h（16進形式）

省略時は，dを仮定します。

-k キー項目名

レコードの表示順序の基準にするキーの，キー項目名を指定します。省略時は，主キー順にレコードを表示します。

-s 開始キー値[:x]

表示を開始するキーの値を指定します。省略時は，いちばん小さい値を持つキーから表示します。キーの値を16進数で指定する場合，値のあとに:xを指定します。

-e 終了キー値[:x]

表示を終了するキーの値を指定します。省略時は，いちばん大きい値を持つキーまで表示します。キーの値を16進数で指定する場合，値のあとに:xを指定します。

-d

レコードを物理順に表示する場合に指定します。-k キー項目名，-s 開始キー値[:x]，およびe 終了キー値[:x]と同時には指定できません。

-c レコード件数

表示するレコードの件数を指定します。

ファイル名

レコード内容を表示するファイルのファイル名を指定します。

注意事項

レコード内容をテキストファイルなどに出力したい場合は，>のあとに出力先のファイル名を指定します。

（例）

Jisprt sample > prt.txt

UJIS環境の場合，半角のカタカナをピリオドに置き換えて表示します。

戻り値

0

正常終了

1

異常終了

Jisrsdel（UNIX限定）

機能

ISAMで使用するリソースを削除します。

形式

Jisrsdel

実行権限

スーパーユーザー権限

格納先ディレクトリ

/opt/jp1base/bin/

注意事項

このコマンドを実行する場合は，すべてのJP1サービスが停止していることを確認してください。JP1サービス実行中に実行すると，ISAMファイルを破壊するおそれがあります。

戻り値

0

正常終了

1

異常終了

jp1base_setup（UNIX限定）

機能

JP1/Baseの動作環境を設定します。このコマンドは，クラスタシステムやクラスタシステムでない場合も含めて，JP1/Baseを使用する場合に実行します。

形式

jp1base_setup

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

格納先ディレクトリ

/opt/jp1base/bin

注意事項

論理ホスト設定後にjp1base_setupコマンドを実行した場合，物理ホストの通信方式がANYバインド方式に設定されます。この場合は，以下の手順で物理ホストの通信方式をIPバインド方式に変更してください。

以下の内容のファイルを作成する。

[JP1_DEFAULT¥JP1BASE]

"JP1_BIND_ADDR"="IP"

手順1で作成したファイルをjbssetcnfコマンドを使って共通定義に設定する。

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

戻り値

0

正常終了

1

異常終了

jp1base_setup_cluster（UNIX限定）

機能

JP1/Baseの論理ホストの動作環境を設定します。クラスタシステムでの環境設定で使用します。環境設定は，実行系，待機系の順に行います。

形式

jp1base_setup_cluster  -h 論理ホスト名
                      [-d 共有ディレクトリ [-a 認証サーバ] [-s] [-v]]

実行権限

スーパーユーザー権限またはJP1/Base管理者権限

実行系の環境設定

論理ホスト名と共有ディレクトリ名の指定が必要です。ほかのオプションについては，必要に応じて指定してください。このコマンドを実行すると，指定した共有ディレクトリに定義ファイルなどがコピーされるため，必ず共有ディスクをマウントしておいてください。

待機系の環境設定

論理ホスト名だけを指定します。実行系で設定した情報を基に動作環境を設定します。なお，待機系の環境設定をする前に，実行系で設定した共通定義情報を待機系にコピーする必要があります。コピーする場合，jbsgetcnfコマンド，およびjbssetcnfコマンドを利用します。

格納先ディレクトリ

/opt/jp1base/bin/

引数

-h 論理ホスト名

環境を設定する論理ホスト名を指定します。

注意事項

論理ホスト名は，hostsファイルやネームサーバに設定し，TCP/IP通信ができるようにしてください。

DNS運用の場合は，FQDN（Fully Qualified Domain Name）形式ではないホスト名を指定してください。例えば，jp1v6.soft.hitachi.co.jpの場合は，jp1v6を指定します。

-d 共有ディレクトリ

実行系の環境設定時に使用します。フェールオーバー時に引き継ぐ情報を格納する共有ディレクトリ（パスの末尾に「/」を付けないでください）を指定します。共有ディスク上のディレクトリを指定してください。指定した共有ディレクトリで，JP1/Baseの動作に必要な環境設定が行われます。このオプションを指定してコマンドを実行すると，共有ディスク上に次の表に示すディレクトリを作成し，定義ファイルを/etc/opt/jp1base/conf/からコピーします。

ディレクトリ

格納するファイル

共有ディレクトリ/jp1base/conf/

定義ファイル

共有ディレクトリ/jp1base/log/

ログファイル

共有ディレクトリ/event/

イベントサーバ設定ファイル

なお，定義ファイルの内容は，必要に応じて変更してください。

-a 認証サーバ

論理ホストが接続する認証サーバのホスト名を指定します。このオプションを省略した場合，認証サーバの設定は物理ホストの環境設定と同じ認証サーバが指定されます。

-s

論理ホストで認証サーバを実行する場合に指定します。このオプションを指定すると，JP1/Baseの起動時に認証サーバが起動するように設定されます。このオプションを省略した場合，認証サーバを起動しないように設定されます。

-v

このオプションを指定すると，論理ホストの動作環境を設定するときのすべてのメッセージを画面上に表示します。

注意事項

設定は，ノードごとに実施してください。

このコマンドを実行すると，ローカルディスク上にあるイベントサービスのイベントサーバインデックスファイル（/etc/opt/jp1base/conf/event/index）に「論理ホスト名」と「共用ディスク上のディレクトリ名/event」が自動設定されます。また，「共用ディスク上のディレクトリ名/event」配下に，イベントサーバ設定ファイル（conf）および転送設定ファイル（forward）が作成されます。

このコマンドを実行すると，TCP/IP通信で使うソケットのバインド方法をIPアドレス指定方式に変更します。変更の対象は，作成する論理ホストおよび物理ホストの設定です。TCP/IP通信のソケットのバインド方法の詳細については，OSのマニュアルを参照してください。

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

使用例

論理ホスト名をlnode0に，共有ディスク上のディレクトリ名を/shdsk/lnode0に設定した場合の使用例を次に示します。

実行系での環境設定

jp1base_setup_cluster -h lnode0 -d /shdsk/lnode0 -a lnode0 -s

このコマンドを実行すると，論理ホストの環境設定，共有ディスク上に共有ディレクトリと共有ファイルの作成，および認証サーバの設定が行われます。

待機系での環境設定

jp1base_setup_cluster -h lnode0

戻り値

0

正常終了

1

異常終了

jp1bshasetup（Windows限定）

機能

JP1/Baseの論理ホストの動作環境を設定する［Baseクラスタ構成の設定］ダイアログボックスを表示します。クラスタシステムでの環境設定で使用します。

形式

jp1bshasetup

実行権限

Administrators権限

格納先ディレクトリ

インストール先フォルダ¥bin¥

注意事項

JP1/Baseを起動しているときは，このコマンドを実行しないでください。

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

jp1ping

機能

JP1/Baseの通信設定に基づいて，指定したホスト名に対応するIPアドレスとそのIPアドレスに対する通信結果（pingコマンドの実行結果）を表示します。

ネットワークインターフェースを複数備えているホスト（一つのホスト名に対して複数のIPアドレスを割り当てているようなホスト）に対するネットワークの設定が有効かを確認する場合に使用します。

形式

jp1ping [-h 論理ホスト名] [-v] [-s]
         ホスト名

実行権限

Windowsの場合：なし

UNIXの場合：なし

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥bin¥

UNIXの場合

/opt/jp1base/bin/

引数

-h 論理ホスト名

クラスタシステムで運用している場合に，jp1pingを実行したい論理ホスト名を指定します。このオプションを省略した場合，環境変数JP1_HOSTNAMEに指定した論理ホスト名が仮定されます。環境変数JP1_HOSTNAMEを指定していない場合，物理ホスト名が仮定されます。

-v

ホスト名から解決したIPアドレスの一覧（Resolved Host List）を，IPアドレスごとに縦に並べて表示する場合に指定します。このオプションを省略した場合，Resolved Host ListはIPアドレスごとにコンマ区切りで横に並んで表示されます。

-s

ホスト名からIPアドレスを解決するのにかかった時間（Time Required）を，秒単位で表示します。

ホスト名

ネットワーク上のホスト名を指定します。

注意事項

存在しない論理ホスト名が指定された場合，次のメッセージを出力して処理が終了します。

The specified logical host does not exist.

-hオプションを複数指定した場合，最後に指定した-hオプションの論理ホスト名が対象になります。

ホスト名を複数指定した場合，最初に指定したホスト名が対象になります。

戻り値

0

正常終了

-1

不正なオプションを指定（Windowsの場合）

255

不正なオプションを指定（UNIXの場合）

0以外

異常終了（ただし，引数を指定しないでコマンドを実行し，使用方法が表示される場合は正常終了）

使用例

server1上で自分自身（server1）がどのIPアドレスを使用しているのかを確認するために，jp1pingコマンドを実行した場合の結果（出力例）を次に示します。

C:¥>jp1ping server1
LogicalHostnameKey : no define. use JP1_DEFAULT
jp1hosts           : no entry. extract hostlist is disabled.
Search jp1hosts    : server1 is not found.
Resolved Host List : server1 -> server1.hitachi.co.jp(172.16.0.10, 172.16.0.20),
Check with ping command ---

Pinging 172.16.0.10 with 32bytes of data:

Reply from 172.16.0.10: bytes=32 time<10ms TTL=128
Reply from 172.16.0.10: bytes=32 time<10ms TTL=128
Reply from 172.16.0.10: bytes=32 time<10ms TTL=128
Reply from 172.16.0.10: bytes=32 time<10ms TTL=128

Pinging 172.16.0.20 with 32bytes of data:

Reply from 172.16.0.20: bytes=32 time<10ms TTL=128
Reply from 172.16.0.20: bytes=32 time<10ms TTL=128
Reply from 172.16.0.20: bytes=32 time<10ms TTL=128
Reply from 172.16.0.20: bytes=32 time<10ms TTL=128
C:¥>

出力内容から，server1というホスト名が，172.16.0.10と172.16.0.20の二つのIPアドレスに解決され，実際にNICへのpingが有効になっていることが判断できます。

この例で，-vオプションおよび-sオプションを指定した場合，次のように出力されます。

C:¥>jp1ping -v -s server1
　　：
Time Required      : 0.005sec
Resolved Host List : server1 -> server1.hitachi.co.jp
(1) 172.16.0.10
(2) 172.16.0.20

Check with ping command ---
　　：

openssl

機能

OpenSSLが提供しているコマンドです。

形式

opensslコマンドの形式（オプション）については，OpenSSLの公式サイトを参照してください。

実行権限

opensslコマンドの実行権限については，OpenSSLの公式サイトを参照してください。

格納先ディレクトリ

OS

格納先ディレクトリ

Windows

32ビット

インストール先フォルダ¥ssl¥32mt¥bin

AIX

Linux

32ビット，マルチスレッド（互換用）

/opt/jp1base/ssl/32mt/bin

32ビット，シングルスレッド（互換用）

/opt/jp1base/ssl/32st/bin

64ビット，マルチスレッド

/opt/jp1base/ssl/64mt/bin

64ビット，シングルスレッド

/opt/jp1base/ssl/64st/bin

注意事項

このコマンドの最新の情報は，OpenSSLの公式サイトを参照してください。

このコマンドをWindowsで使用する場合は，コマンドを実行するコンソール上で環境変数OPENSSL_CONFを設定する必要があります。環境変数OPENSSL_CONFには，OpenSSLの定義ファイル名をフルパスで指定してください。JP1/Baseでは，OpenSSLの定義ファイルを次に示すフォルダで提供しています。

32ビット版のWindowsの場合

インストール先フォルダ¥ssl¥32mt¥ssl¥openssl.cnf

64ビット版のWindowsの場合

インストール先フォルダ¥ssl¥64mt¥ssl¥openssl.cnf

ただし，ユーザー環境変数およびシステム環境変数には，環境変数OPENSSL_CONFを設定しないでください。環境変数OPENSSL_CONFは，次に示すどちらかの方法で設定してください。なお，次に示す二つ方法は，32ビット版のWindowsを前提としています。64ビット版のWindowsでは，OpenSSLの定義ファイルの格納先などを適宜置き換えてください。

バッチファイルを作成して設定する方法

環境変数OPENSSL_CONFの設定およびopenssl.exeを実行するバッチファイルを作成して，そのバッチファイルをコンソール上で実行します。

バッチファイルの内容を次に示します。

--------------------------------------

@echo off

set OPENSSL_CONF=インストール先フォルダ¥ssl¥32mt¥ssl¥openssl.cnf

"インストール先フォルダ¥ssl¥32mt¥bin¥openssl.exe" %*

exit /b %ERRORLEVEL%

--------------------------------------

なお，環境変数OPENSSL_CONFに設定するフルパスをダブルクォーテーションマーク（"）で囲まないでください。

バッチファイルの名称を「sslexe.bat」にした場合の実行例を次に示します。

sslexe.bat x509 -text -noout -in jp1basessl.pem

setコマンドをコンソール上で実行して設定する方法

環境変数OPENSSL_CONFを設定するsetコマンドをコンソール上で実行します。setコマンドの実行例を次に示します。

set OPENSSL_CONF=C:¥Program Files (x86)¥Hitachi¥JP1Base¥ssl¥32mt¥ssl¥openssl.cnf

なお，環境変数OPENSSL_CONFに設定するフルパスをダブルクォーテーションマーク（"）で囲まないでください。

setコマンドを実行後，openssl.exeを実行します。

使用例

opensslコマンド使用例を次に示します。

秘密鍵「jp1basesslecckey.pem」を楕円曲線名prime256v1のECC形式で作成する場合

openssl ecparam -genkey -noout -name prime256v1 -out jp1basesslecckey.pem

秘密鍵「jp1basesslecckey.pem」をPKCS#8形式の秘密鍵「jp1basessleccpkcs8key.pem」に変換する場合

openssl pkcs8 -topk8 jp1basesslecckey.pem -out jp1basessleccpkcs8key.pem

秘密鍵「jp1basesslkey.pem」をRSA形式で作成する場合

openssl genrsa 2048 -out jp1basesslkey.pem

CSR「jp1base.csr」を作成する場合

openssl req -key jp1basesslkey.pem -out jp1base.csr

サーバ証明書「jp1basessl.pem」の有効期限を確認する場合

openssl x509 -text -noout -in jp1basessl.pem

実行結果（抜粋）：

Validity
Not Before: Jul 21 01:31:49 2015 GMT
Not After : Jul 18 01:31:49 2025 GMT

「Not Before」は，サーバ証明書の発行日時です。

「Not After」は，サーバ証明書の有効期限です。

16　定義ファイル

この章では，JP1/Baseの定義ファイルとイベントフィルターの形式および文法について説明します。

定義ファイル一覧

表16‒1　定義ファイル一覧

機能

定義ファイル名・説明

起動管理機能

起動順序定義ファイル（Windows限定）（JP1SVPRM.DAT）

サービスの起動順序および終了順序を設定するファイル。

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）（Jp1svprm_wait.dat）

サービスの起動を待機させる時間と，サービスの起動を監視する時間を設定するファイル。

イベントサービス

イベントサーバインデックスファイル（index）

イベントサーバが使用するディレクトリを設定するファイル。

イベントサーバ設定ファイル（conf）

イベントサービスの各種動作環境を設定するファイル。

転送設定ファイル（forward）

どのイベントサーバにどのJP1イベントを転送するかを設定するファイル。

API設定ファイル（api）

アプリケーションプログラムからイベントサーバへの接続方法や使用するポートを設定するファイル。

属性付加設定ファイル（recv_add_extattr，send_add_extattr）

任意の拡張属性を付加するJP1イベントの条件，および付加する拡張属性名と拡張属性値を設定するファイル。

イベント変換機能

ログファイルトラップ動作定義ファイル

JP1イベントに変換するログデータの条件や，監視失敗時のリトライなどを設定するファイル。

ログファイルトラップ起動定義ファイル（jevlog_start.conf）

ログファイルトラップ管理サービス（デーモン）起動時，jevlogstart（クラスタ運用限定）コマンド実行時，およびjevlogstop（クラスタ運用限定）コマンド実行時に，起動または終了するログファイルトラップを設定するファイル。

ログ情報定義ファイル（jevlogd.conf）

ログファイルトラップ用ログファイルの保存ファイル数や最大容量を設定するファイル。

イベントログトラップ動作定義ファイル（Windows限定）（ntevent.conf）

JP1イベントに変換するイベントログの条件や，監視失敗時のリトライなどを設定するファイル。

イベントサービスの定義情報の収集・配布機能

配布定義ファイル

配布したい定義情報と，配布先ホストを設定するファイル。

ユーザー管理機能

パスワード定義ファイル（Windows限定）

複数のOSユーザーまたは情報検索用ユーザーのパスワード情報を設定するファイル。

ユーザー権限レベルファイル（JP1_UserLevel）

JP1ユーザーのJP1資源グループに対する操作権限を設定するファイル。

ユーザー権限定義ファイル

JP1ユーザーまたはDSグループのJP1資源グループに対する操作権限を定義するファイル。

ディレクトリサーバ変更ファイル（Windows限定）

連携したディレクトリサーバが障害などで使用できなくなった場合，一時的にディレクトリサーバを変更するための共通定義情報を設定するファイル。

ディレクトリサーバ連携定義ファイル（Windows限定）（jp1bs_ds_setup.conf）

ディレクトリサーバと連携してユーザー認証をする場合に，ディレクトリサーバ名などを設定するための共通定義情報を設定するファイル。

ユーザーマッピング定義ファイル（jp1BsUmap.conf）

複数のJP1ユーザーのマッピング情報を設定するファイル。

パスワードポリシー定義ファイル（jp1bs_passwdpolc.conf）

パスワードポリシーを設定するファイル。

ヘルスチェック機能

ヘルスチェック定義ファイル（jbshc.conf）

ヘルスチェックで異常を検知した場合の通知方法や，ヘルスチェックで監視する他ホストなどを設定するファイル。

共通定義設定用ファイル（ヘルスチェック機能）

ヘルスチェック機能を有効にするための共通定義情報を設定するファイル。

プロセス管理機能

JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）

共通定義情報を設定するファイル。プロセスが異常終了した場合や，認証サーバの切り替えが発生した場合に，JP1イベントを発行するかどうかを設定します。

拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）

プロセスが異常終了した場合，自動で再起動するために設定するファイル。

通信設定

jp1hosts定義ファイル（jp1hosts）

JP1独自のhosts情報（jp1hosts情報）を変更するための共通定義情報を設定するファイル。

jp1hosts2定義ファイル（jp1hosts2.conf）

JP1独自のhosts情報（jp1hosts2情報）を変更するためのファイル。

ホストアクセス制限定義ファイル（jbsdfts_srv.conf）

JP1/IMのIM構成管理機能へ情報提供する場合のように，ほかのホストからのアクセス制限を設定するファイル。

SSL通信定義ファイル

通信暗号化機能を有効にするかどうか，およびSSL通信の設定情報を共通定義情報に設定するためのファイル。

非SSL通信ホスト設定ファイル

通信暗号化機能を有効にしている場合に，非SSL通信したいホストを定義するためのファイル。

ローカルアクション機能

ローカルアクション環境変数ファイル

ローカルアクション機能で指定されたコマンドを実行するときの環境変数を設定するファイル。

ローカルアクション実行定義ファイル（jbslcact.conf）

ローカルアクション機能の実行条件と実行コマンドを設定するファイル。

共通定義設定用ファイル（ローカルアクション機能）

ローカルアクション機能を有効にするかどうか，およびログ情報を共通定義情報に設定するためのファイル。

JP1/Baseの設定情報の一括収集

収集情報ファイル

jbsparamdumpコマンドでJP1/Baseの設定情報を収集する際，ユーザーが任意に格納先やファイル名を設定したファイルを収集するために，その格納先とファイル名を指定するファイルです。

構成管理機能

共通定義設定用ファイル（構成管理機能）

構成管理機能の設定情報を共通定義情報に設定するためのファイル。

JP1/IMの自動アクション，コマンド実行機能

環境変数ファイル

JP1/IMの管理対象ホストでコマンドを実行するときの環境変数を定義するファイルです。

ホストグループ定義ファイル

JP1/IMの管理対象ホストのグループを定義するファイルです。

運用ごとに設定が必要となる定義ファイル

JP1/Baseを起動する場合，JP1/IMやJP1/AJSを使用する場合など，運用ごとに設定が必要となる定義ファイルについて説明します。また，クラスタシステムでJP1/Baseを運用する場合に，論理ホストの運用に合わせて設定を変更できる定義ファイルについて説明します。

JP1/Baseを起動する場合

JP1/Baseの起動に必須となる定義ファイル，およびJP1/Baseを起動させる上で検討が必要となる定義ファイルを次の表に示します。

表16‒2　JP1/Baseを起動する場合に設定が必要となる定義ファイル

機能

定義ファイル名

参照先

セットアップ

JP1/Base用の言語種別設定ファイル（jp1bs_env.conf）

「3.4.2(1)　言語種別の設定手順」

イベントサービス

イベントサーバインデックスファイル（index）

「16.　定義ファイル」の「イベントサーバインデックスファイル」

イベントサーバ設定ファイル（conf）

「16.　定義ファイル」の「イベントサーバ設定ファイル」

API設定ファイル（api）

「16.　定義ファイル」の「API設定ファイル」

プロセス管理機能

JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）

「16.　定義ファイル」の「JP1/Baseパラメーター定義ファイル」

拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）

「16.　定義ファイル」の「拡張起動プロセス定義ファイル」

なお，JP1/Baseの起動管理で自動起動および自動終了を使用する場合は，次に示すコマンドの設定も必要になります。

自動起動コマンド（jbs_start）

参照先「15.　コマンド」の「jbs_start（UNIX限定）」

自動停止コマンド（jbs_stop）

参照先「15.　コマンド」の「jbs_stop（UNIX限定）」

JP1/IMを使用する場合

JP1/IMを使用してシステムの管理および監視をする場合に，マネージャーで設定が必要となる定義ファイルを次に示します。

表16‒3　JP1/IMを使用する場合にマネージャーで設定が必要となる定義ファイル

機能

定義ファイル名

参照先

セットアップ

JP1/IMおよびJP1/AJS用の言語種別設定ファイル（jp1bs_param.conf）

「3.4.2(1)　言語種別の設定手順」

起動管理

起動順序定義ファイル（JP1SVPRM.DAT）

「16.　定義ファイル」の「起動順序定義ファイル（Windows限定）」

イベントサービス

属性付加設定ファイル（recv_add_extattr，send_add_extattr）

「16.　定義ファイル」の「属性付加設定ファイル」

イベント変換機能

イベントログトラップ動作定義ファイル（ntevent.conf）

「16.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」

イベントサービスの定義情報の収集・配布機能

配布定義ファイル

「16.　定義ファイル」の「配布定義ファイル」

ユーザー管理機能

ユーザーマッピング定義ファイル（jp1BsUmap.conf）

「16.　定義ファイル」の「ユーザーマッピング定義ファイル」

ヘルスチェック機能

ヘルスチェック定義ファイル（jbshc.conf）

「16.　定義ファイル」の「ヘルスチェック定義ファイル」

共通定義設定用ファイル（ヘルスチェック機能）

「16.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」

通信設定

jp1hosts定義ファイル（jp1hosts）

「16.　定義ファイル」の「jp1hosts定義ファイル」

jp1hosts2定義ファイル（jp1hosts2.conf）

「16.　定義ファイル」の「jp1hosts2定義ファイル」

構成管理機能

共通定義設定用ファイル（構成管理機能）

「16.　定義ファイル」の「共通定義設定用ファイル（構成管理機能）」

構成定義ファイル（jbs_route.conf）

「16.　定義ファイル」の「構成定義ファイル」

JP1/IMの自動アクション，コマンド実行

環境変数ファイル

「16.　定義ファイル」の「環境変数ファイル」

ホストグループ定義ファイル

「16.　定義ファイル」の「ホストグループ定義ファイル」

JP1/IMを使用してシステムの管理および監視をする場合に，エージェントで設定が必要となる定義ファイルを次に示します。

表16‒4　JP1/IMを使用する場合にエージェントで設定が必要となる定義ファイル

機能

定義ファイル名

参照先

セットアップ

JP1/IMおよびJP1/AJS用の言語種別設定ファイル（jp1bs_param.conf）

「3.4.2(1)　言語種別の設定手順」

イベントサービス

転送設定ファイル（forward）

「16.　定義ファイル」の「転送設定ファイル」

イベント変換機能

ログファイルトラップ動作定義ファイル

「16.　定義ファイル」の「ログファイルトラップ動作定義ファイル」

ログファイルトラップ起動定義ファイル（jevlog_start.conf）

「16.　定義ファイル」の「ログファイルトラップ起動定義ファイル」

ユーザー管理機能

ユーザーマッピング定義ファイル（jp1BsUmap.conf）

「16.　定義ファイル」の「ユーザーマッピング定義ファイル」

ヘルスチェック機能

共通定義設定用ファイル（ヘルスチェック機能）

「16.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」

通信設定

jp1hosts定義ファイル（jp1hosts）

「16.　定義ファイル」の「jp1hosts定義ファイル」

jp1hosts2定義ファイル（jp1hosts2.conf）

「16.　定義ファイル」の「jp1hosts2定義ファイル」

JP1/IMの自動アクション，コマンド実行

環境変数ファイル

「16.　定義ファイル」の「環境変数ファイル」

JP1/AJSを使用する場合

JP1/AJSを使用してジョブの管理をする場合に必要な定義ファイルを次に示します。

表16‒5　JP1/AJSを使用する場合に設定が必要となる定義ファイル

機能

定義ファイル名

参照先

セットアップ

JP1/IMおよびJP1/AJS用の言語種別設定ファイル（jp1bs_param.conf）

「3.4.2(1)　言語種別の設定手順」

起動管理

起動順序定義ファイル（JP1SVPRM.DAT）

「16.　定義ファイル」の「起動順序定義ファイル（Windows限定）」

イベントサービス

転送設定ファイル（forward）

「16.　定義ファイル」の「転送設定ファイル」

属性付加設定ファイル（recv_add_extattr，send_add_extattr）

「16.　定義ファイル」の「属性付加設定ファイル」

イベント変換機能

ログファイルトラップ動作定義ファイル

「16.　定義ファイル」の「ログファイルトラップ動作定義ファイル」

イベントログトラップ動作定義ファイル（ntevent.conf）

「16.　定義ファイル」の「イベントログトラップ動作定義ファイル（Windows限定）」

ユーザー管理機能

ユーザーマッピング定義ファイル（jp1BsUmap.conf）

「16.　定義ファイル」の「ユーザーマッピング定義ファイル」

通信設定

jp1hosts定義ファイル（jp1hosts）

「16.　定義ファイル」の「jp1hosts定義ファイル」

jp1hosts2定義ファイル（jp1hosts2.conf）

「16.　定義ファイル」の「jp1hosts2定義ファイル」

認証サーバを使用する場合

認証サーバを使用してユーザーの管理をする場合に必要な定義ファイルを次に示します。

表16‒6　認証サーバを使用する場合に設定が必要となる定義ファイル

機能

定義ファイル名

参照先

ユーザー管理機能

パスワード定義ファイル

「16.　定義ファイル」の「パスワード定義ファイル（Windows限定）」

ユーザー権限レベルファイル（JP1_UserLevel）

「16.　定義ファイル」の「ユーザー権限レベルファイル」

ディレクトリサーバ変更ファイル

「16.　定義ファイル」の「ディレクトリサーバ変更ファイル（Windows限定）」

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）

「16.　定義ファイル」の「ディレクトリサーバ連携定義ファイル（Windows限定）」

共通定義設定用ファイル（パスワード保管形式定義）

「3.4.6　パスワード保管形式の設定」

パスワードポリシー定義ファイル（jp1bs_passwdpolc.conf）

「16.　定義ファイル」の「パスワードポリシー定義ファイル」

クラスタシステムを使用する場合

クラスタシステムでJP1/Baseを運用する場合に，論理ホストの運用に合わせて設定を変更できる定義ファイルを次に示します。

表16‒7　クラスタシステムを使用する場合に論理ホストの運用に合わせて設定を変更できる定義ファイル

機能

定義ファイル名

参照先

セットアップ

JP1/IMおよびJP1/AJS用の言語種別設定ファイル（jp1bs_param.conf）

「3.4.2(1)　言語種別の設定手順」

イベントサービス

イベントサーバ設定ファイル（conf）

「16.　定義ファイル」の「イベントサーバ設定ファイル」

転送設定ファイル（forward）

「16.　定義ファイル」の「転送設定ファイル」

属性付加設定ファイル（recv_add_extattr，send_add_extattr）

「16.　定義ファイル」の「属性付加設定ファイル」

イベント変換

共通定義設定用ファイル（正規表現拡張定義）

「3.4.5　使用する正規表現を拡張する」

イベントサービスの定義情報の収集・配布機能

配布定義ファイル（転送設定ファイル（jev_forward.conf））

「16.　定義ファイル」の「配布定義ファイル」

ユーザー管理機能

パスワード定義ファイル

「16.　定義ファイル」の「パスワード定義ファイル（Windows限定）」

ユーザー権限レベルファイル（JP1_UserLevel）

「16.　定義ファイル」の「ユーザー権限レベルファイル」

ディレクトリサーバ変更ファイル

「16.　定義ファイル」の「ディレクトリサーバ変更ファイル（Windows限定）」

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）

「16.　定義ファイル」の「ディレクトリサーバ連携定義ファイル（Windows限定）」

ユーザーマッピング定義ファイル（jp1BsUmap.conf）

「16.　定義ファイル」の「ユーザーマッピング定義ファイル」

共通定義設定用ファイル（パスワード保管形式定義）

「3.4.6　パスワード保管形式の設定」

パスワードポリシー定義ファイル（jp1bs_passwdpolc.conf）

「16.　定義ファイル」の「パスワードポリシー定義ファイル」

ヘルスチェック機能

ヘルスチェック定義ファイル（jbshc.conf）

「16.　定義ファイル」の「ヘルスチェック定義ファイル」

共通定義設定用ファイル（ヘルスチェック機能）

「16.　定義ファイル」の「共通定義設定用ファイル（ヘルスチェック機能）」

プロセス管理機能

JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）

「16.　定義ファイル」の「JP1/Baseパラメーター定義ファイル」

拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）

「16.　定義ファイル」の「拡張起動プロセス定義ファイル」

通信設定

jp1hosts定義ファイル（jp1hosts）

「16.　定義ファイル」の「jp1hosts定義ファイル」

jp1hosts2定義ファイル（jp1hosts2.conf）

「16.　定義ファイル」の「jp1hosts2定義ファイル」

ホストアクセス制限定義ファイル（jbsdfts_srv.conf）

「16.　定義ファイル」の「ホストアクセス制限定義ファイル」

SSL通信定義ファイル

「16.　定義ファイル」の「SSL通信定義ファイル」

非SSL通信ホスト設定ファイル

「16.　定義ファイル」の「非SSL通信ホスト設定ファイル」

構成定義ファイル（jbs_route.conf）

「16.　定義ファイル」の「構成定義ファイル」

共通定義設定用ファイル（通信接続制限定義）

「付録K.3　意図しないホストからの通信接続を制限するための定義」

ローカルアクション機能

ローカルアクション環境変数ファイル

「16.　定義ファイル」の「ローカルアクション環境変数ファイル」

ローカルアクション実行定義ファイル（jbslcact.conf）

「16.　定義ファイル」の「ローカルアクション実行定義ファイル」

共通定義設定用ファイル（ローカルアクション機能）

「16.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」

操作ログ出力機能

操作ログ定義ファイル（jp1bs_baselog_setup.conf）

「付録I.5　操作ログを出力するための設定」

構成管理機能

共通定義設定用ファイル（構成管理機能）

「16.　定義ファイル」の「共通定義設定用ファイル（構成管理機能）」

パラメーターの分類について

各定義ファイルのパラメーターは，設定の必要性に応じて，次に示すパラメーターに分類されます。定義ファイルを設定する際の参考にしてください。

必須パラメーター

JP1/Baseを使用する上で検討が必要なパラメーターで，各定義ファイルを設定する際に省略できないパラメーターです。

選択パラメーター

特定の機能を使用する場合に，検討および設定が必要なパラメーターです。JP1/Baseの運用に合わせて設定値を検討する必要があります。

上記以外に分類されるパラメーターは，基本的に初期設定値から変更する必要のないパラメーターです。特別な指定をする場合に限り，必要に応じて設定してください。

イベントフィルターの文法

イベントフィルターは，イベントIDや発行元ユーザー名などをキーにして，JP1イベントをフィルタリングします。イベントフィルターを設定する個所を次に示します。

転送設定ファイル（forward）

属性付加設定ファイル（recv_add_extattr，send_add_extattr）

ローカルアクション実行定義ファイル（jbslcact.conf）

jevexportコマンド

JP1イベント取得関数（JevGetOpen）

イベントフィルターの書式

イベントフィルターは一つ以上の「条件文群」の集まりです。条件文群は一つ以上の「条件文」の集まりです。条件文は1行で表され，条件文を並べることで条件文群が構成されます。条件文群同士の間には「OR」とだけ記述した行を挿入します。なお，1行の最大長は1,024バイトです。一つのイベントフィルター全体の最大長は，64キロバイトです。

条件文群は条件文群を構成する条件文がすべて成立すると成立します。イベントフィルターは，イベントフィルターを構成する条件文群のどれか一つが成立すると成立します。

イベントフィルターの書式の概念を次の図に示します。

図16‒1　イベントフィルターの書式の概念

JP1/Base 08-50以降では，イベントフィルターに除外条件を記述できます。

抽出条件が成立するJP1イベントのうち，特定のJP1イベントを除外したい場合に記述します。

抽出条件と除外条件の間には「EXCLUDE」とだけ記述した行を挿入します。「EXCLUDE」は，一つのフィルターに一つだけ記述でき，「EXCLUDE」より前に記述された条件文群は抽出条件，「EXCLUDE」より後ろに記述された条件文群は除外条件となります。除外条件に記述する条件文の書式は，抽出条件と同じです。

除外条件は省略できるため，以前のバージョンで作成したフィルターをJP1/Base 08-50以降でもそのまま使用できます。

条件文群が未定義の場合は無条件に条件が成立します。ただし，EXCLUDE以下の除外条件が未定義の場合にはEXCLUDEは無視されます。

転送設定ファイルについては，抽出条件の未定義は許可しておらず，抽出条件が未定義の場合はエラーとなります。

除外条件や転送設定ファイルの抽出条件にORだけを定義した場合やORの前後の条件文群のいずれかを未定義した場合には書式誤りとはならず，無条件に条件が成立しますので注意してください。

条件文の書式

条件文の書式は次の形式で記述します。

属性名△比較キーワード△オペランド1△オペランド2△…

△は区切りで，一つ以上の連続した半角のスペースまたはタブを示します。オペランドを複数指定した場合は，どれか一つに当てはまるときに条件文が成立します。オペランドとして，半角スペース，タブ，CR，LFおよび%は通常の方法では使用できませんが，次に示すように2桁の16進数で表現できます。

半角スペース：%20

タブ：%09

CR：%0d

LF：%0a

%：%25

また，半角スペース，タブ，CR，LFおよび%以外の文字も16進数で表現できます。

注意事項

条件文に機種依存文字が含まれる場合，正しく比較できません。

Windowsで比較キーワードにREGEXを使用していて，正規表現を拡張していない場合，LFには"%0a"ではなく，"¥n"を指定してください。

属性名

表16‒8　条件文の属性名

属性名

内容

型および形式

B.SEQNO

イベントDB内通し番号

数値(0〜2,147,483,647)

B.ID

イベントID

イベントID※1

B.PROCESSID

発行元プロセスID

数値(0〜2,147,483,647)

B.TIME

登録時刻

数値

(0〜4,294,967,295 =UTC1970年1月1日00:00:00からの秒数)

B.ARRIVEDTIME

到着時刻

数値

(0〜4,294,967,295 =UTC1970年1月1日00:00:00からの秒数)

B.REASON

イベントDBへの登録要因

数値(1〜4)

B.USERID

発行元ユーザーID

数値(-1〜2,147,483,647)

B.GROUPID

発行元グループID

数値(-1〜2,147,483,647)

B.USERNAME

発行元ユーザー名

文字列※3

B.GROUPNAME

発行元グループ名

文字列※3

B.SOURCESERVER

発行元イベントサーバ名

文字列※3

B.DESTSERVER

送信先イベントサーバ名

文字列※3

B.SOURCESEQNO

発行元別通し番号

数値(0〜2,147,483,647)

B.CODESET

コードセット

文字列※3

B.MESSAGE

メッセージ

文字列※3

E.拡張属性名※2

拡張属性

文字列※3

注※1　イベントIDは，文字列型，数値型と異なります。詳細については，「表16-9　条件文の比較キーワード」の条件内の属性値がイベントIDの場合を参照してください。

注※2　拡張属性名の形式については，「17.1.2　拡張属性」を参照してください。

注※3　文字列は，英字の大小文字を区別します。

比較キーワード

表16‒9　条件文の比較キーワード

比較キーワード

オペランドの数

条件

IN

1以上

属性値がオペランドのどれかと一致する。

属性値が文字列型の場合

オペランドは任意の文字列。

例：B.MESSAGE IN KAJP KAVA

属性値が数値型の場合

オペランドは10進数（符号可）と見なせる文字列。そうでないオペランドは常に不一致。

例：B.REASON IN 1

属性値がイベントIDの場合

オペランドはx:yまたはx（xとyは1〜8桁の16進数）の形式の文字列。xがイベントID基本部に，yがイベントID拡張部に対応。そうでないものは常に不一致。

例：B.ID IN 111:0

NOTIN

1以上

比較キーワードINの否定。

例：B.USERNAME NOTIN hitachi

例：B.SEQNO NOTIN 1004959

例：B.ID NOTIN 00003A71

BEGIN

1以上

属性値が文字列型であり，オペランドに指定した文字列のどれかで始まると成立。属性値が数値型またはイベントIDの場合は常に不成立。

例：B.MESSAGE BEGIN KAVA

RANGE

2

属性名がB.TIMEまたはB.ARRIVEDTIMEの場合

次の条件を満たすと成立。

属性値が数値，または10進数(0〜4,294,967,295)と見なせる文字列。

オペランド1およびオペランド2が14桁の数字列。

属性値をUTC1970年1月1日00:00:00からの秒数と見なし，イベントサーバの稼働環境のタイムゾーンに基づくyyyymmddHHMMSSの形式の数字列にしたときに，オペランド1 ≦ 属性値 ≦ オペランド2であるとき。

例：B.TIME RANGE 20140715000000 20140716000000

そのほかの属性名で属性値が数値型の場合

オペランド1およびオペランド2を10進数と見なしたときに，オペランド1 ≦ 属性値 ≦ オペランド2であると成立。

例：B.SEQNO RANGE 1004000 1005000

属性値が文字列型の場合

文字コード順の比較で，オペランド1 ≦ 属性値 ≦ オペランド2であると成立。

例：B.MESSAGE RANGE KAJP1001 KAJP1070

属性値がイベントIDの場合

オペランド1およびオペランド2がx:y（xとyは1〜8桁の16進数）の形式の文字列で，y（拡張部）を上8桁，x（基本部）を下8桁の計16桁の16進数と見なしたときにオペランド1 ≦ 属性値 ≦ オペランド2であると成立。

例：B.ID RANGE 4780 4790

以上のどれでもない場合は不成立。

TRANGE

2

次の条件を満たすと成立する。

属性値が数値，または10進数(0〜4,294,967,295)と見なせる文字列。

オペランド1およびオペランド2が14桁の数字列。

属性値をUTC1970年1月1日00:00:00からの秒数と見なし，イベントサーバの稼働環境のタイムゾーンに基づくyyyymmddHHMMSSの形式の数字列にした場合に，オペランド1 ≦ 属性値 ≦ オペランド2であるとき。

例：B.TIME TRANGE 20140716010000 20140716013000

以上の場合でないときは不成立。

DEFINED

0

属性名が拡張属性名を表し，指定の拡張属性が定義されていると成立。定義されていないと不成立。属性名が基本属性を表す場合は常に成立。

例：E.PRODUCT_NAME DEFINED

NOTDEFINED

0

比較キーワードDEFINEDの否定。

例：E.PRODUCT_NAME NOTDEFINED

SUBSTR

1以上

属性値が文字列型であり，オペランドに指定した文字列のどれかが含まれていると成立。属性値が数値型，またはイベントIDの場合は常に不成立。

例：B.MESSAGE SUBSTR エラー

NOTSUBSTR

1以上

比較キーワードSUBSTRの否定。

例：B.MESSAGE SUBSTR 警告

REGEX

1以上

正規表現記述用比較キーワード。

属性値が文字列型であり，オペランドに指定した正規表現のどれかと一致すると成立。

例：B.MESSAGE REGEX KAV.[0-9][0-9][0-9][0-9]-E

正規表現については「付録F　正規表現の文法」を参照のこと。

WITHIN※

2

属性名がB.TIMEまたはB.ARRIVEDTIMEの場合

次の条件を満たすと成立。

属性値が数値，または10進数(1〜4,294,967,295)と見なせる文字列。

オペランド1がM（分），H（時間），D（日）のどれかの文字列。

オペランド2が10進数（符号不可）と見なせる文字列。

オペランド1がM（分）およびH（時間）の場合

属性値をUTC1970年1月1日00:00:00からの秒数と見なし，イベントサーバの稼働環境のタイムゾーンに基づくyyyymmddHHMMSSの形式の数字列にしたときに，（現在時刻−オペランド2） ≦ 属性値 ≦ 現在時刻であるとき。

例：B.TIME WITHIN M 30

例：B.TIME WITHIN H 12

オペランド1がD(日)の場合

属性値をUTC1970年1月1日00:00:00からの秒数と見なし，イベントサーバの稼働環境のタイムゾーンに基づくyyyymmddHHMMSSの形式の数字列にしたときに，「今日の日付−（オペランド2−1）」の00:00:00 ≦ 属性値 ≦ 今日の日付の24:59:59であるとき。

例：B.TIME WITHIN D 7

注※　jevexportコマンドで指定するフィルターファイルでだけ指定できます。

イベントフィルターの記述例

比較キーワード「IN」の記述例

イベントIDが基本部111，拡張部0のJP1イベントを選択します。

B.ID IN 111:0
または
B.ID IN 111
または
B.ID IN 00000111:00000000

発行元ユーザーIDが103のJP1イベントを選択します。

B.USERID IN 103
または
B.USERID RANGE 103 103

発行元イベントサーバ名がreysolのJP1イベントを選択します。

B.SOURCESERVER IN reysol

比較キーワード「BEGIN」の記述例

メッセージがKAJPまたはKAVAで始まるJP1イベントを選択します。

B.MESSAGE BEGIN KAJP KAVA

メッセージがHello, worldで始まるJP1イベントを選択します。なお，「，」と「w」の間の%20はスペースを示します。

B.MESSAGE BEGIN Hello,%20world

拡張属性に関する記述例

拡張属性の属性名がTASK_NAMEで，その値が「在庫管理」のJP1イベントを選択します。

E.TASK_NAME IN 在庫管理

属性名がTASK_NAMEの拡張属性が設定（値は問わない）されているJP1イベントを選択します。

E.TASK_NAME DEFINED

複数の条件文（AND条件）の記述例

イベントIDが222:0以外で，かつ発行元ユーザー名がhanakoのJP1イベントを選択します。

B.ID NOTIN 222
B.USERNAME IN hanako

複数の条件文群（OR条件）の記述例

次に示すJP1イベントを選択します。

拡張属性SEVERITYがWarningまたはErrorかつ拡張属性PRODUCT_NAMEが定義されているJP1イベント

発生元イベントサーバがwww.hitachi.co.jpでかつ拡張属性PRODUCT_NAMEが /HITACHI/JP1/AJSであるJP1イベント

E.SEVERITY IN Warning Error
E.PRODUCT_NAME DEFINED
OR
B.SOURCESERVER IN www.hitachi.co.jp
E.PRODUCT_NAME IN /HITACHI/JP1/AJS

除外条件（EXCLUDE）の記述例

イベントIDが101，102または重大度がエラーのJP1イベントを選択します。ただし，登録元イベントサーバ名がhost3のJP1イベントは除外します。

B.ID IN 101 102
OR
E.SEVERITY IN Error
EXCLUDE
B.SOURCESERVER IN host3

比較キーワード「TRANGE」の記述例

2002年6月16日※以降に発生したJP1イベントを選択します。

B.TIME TRANGE 20020616000000 99999999999999

比較キーワード「WITHIN」の記述例

現在時刻（2003年7月16日01:30:00）※の30分前から現在までに発生したJP1イベントを選択します。

B.TIME WITHIN M 30
（B.TIME TRANGE 20030716010000 20030716013000と同意）

現在時刻（2003年7月16日01:21:21）※の24時間前から現在までに発生したJP1イベントを選択します。

B.TIME WITHIN H 24
（B.TIME TRANGE 20030715012121 20030716012121と同意）

今日（2003年7月16日）※を含めた二日間に発生したJP1イベントを選択します。

B.TIME WITHIN D 2
（B.TIME TRANGE 20030715000000 20030716235959と同意）

注※　イベントサーバ環境での時刻を基にしています。

起動順序定義ファイル（Windows限定）

形式

# コメント

[ControlValue]

ForcedTerminateExec=YES

[FrontOtherServiceXXX]

Name=任意の名称

ServiceName=起動および終了するサービスの名称

StartCommand=サービスの起動に使用するコマンド

StopCommand=サービスの終了に使用するコマンド

Parallel=YES

Wait=サービス開始処理が完了するまでの最大待ち時間（秒）

StopWait=サービス終了処理が完了するまでの最大待ち時間（秒）

[Jp1XXX]

Name=任意の名称

ServiceName=起動および終了するサービスの名称

StartCommand=サービスの起動に使用するコマンド

StopCommand=サービスの終了に使用するコマンド

Parallel=YES

Wait=サービス開始処理が完了するまでの最大待ち時間（秒）

StopWait=サービス終了処理が完了するまでの最大待ち時間（秒）

[OtherServiceXXX]

Name=任意の名称

ServiceName=起動および終了するサービスの名称

StartCommand=サービスの起動に使用するコマンド

StopCommand=サービスの終了に使用するコマンド

Parallel=YES

Wait=サービス開始処理が完了するまでの最大待ち時間（秒）

StopWait=サービス終了処理が完了するまでの最大待ち時間（秒）

[Command]

ReadyCommand=すべてのサービス開始処理が完了したあとに実行するコマンド

StopReadyCommand=すべてのサービス終了処理が完了したあとに実行するコマンド

パラメーターの分類

必須パラメーター

なし

選択パラメーター

[ControlValue]セクション

ForcedTerminateExec

[FrontOtherServiceXXX]および[Jp1XXX]セクション

Name

ServiceName

StartCommand

StopCommand

Parallel

Wait

StopWait

[Command]セクション

ReadyCommand

StopReadyCommand

ファイル名

JP1SVPRM.DAT（起動順序定義ファイル）

JP1SVPRM.DAT.MODEL（起動順序定義ファイルのモデルファイル）

格納先ディレクトリ

インストール先フォルダ¥conf¥boot¥

説明

JP1シリーズの製品のサービス，JP1以外の製品のサービスの起動順序および終了順序，サービスの起動または終了したあとに実行するコマンドやバッチファイルを設定しておくファイルです。

定義の反映時期

cpysvprmコマンドを実行すると，起動順序定義ファイル（JP1SVPRM.DAT）が作成されます。Windowsを再起動すると，設定が有効になります。cpysvprmコマンドの詳細については，「15.　コマンド」の「cpysvprm（Windows限定）」を参照してください。

記述内容

起動順序定義ファイル（JP1SVPRM.DAT）の各パラメーターの説明を次に示します。起動順序定義ファイル（JP1SVPRM.DAT）には8文字を超えるファイル名や，スペースを含むファイル名も指定できます。コメント文を挿入したい場合は，行頭に#を付けてください。改行されるまでコメント文になります。

[ControlValue]

JP1/Power Monitorからの強制終了時に，サービスを順序どおりに終了したい場合に記述するセクションです。このセクションでは，ForcedTerminateExec=だけを指定できます。

なお，JP1/Power Monitorからの計画終了時には，このセクションを省略した場合でも，起動順序定義ファイル（JP1SVPRM.DAT）に定義したとおりに，必ずサービスの終了処理が実行されます。

ForcedTerminateExec=

JP1/Power Monitorからの強制終了時にサービスの終了処理を実行する場合，「YES」を指定します。「YES」以外を指定した場合，およびこのパラメーターを省略した場合，JP1/Power Monitorからの強制終了時にサービスの終了処理は実行されません。

[FrontOtherServiceXXX]

JP1製品のサービスより前に起動する，JP1以外のサービスについて記述するセクションです。XXXには，60バイト以内の半角英数文字で，任意の名称を指定します。英字の大文字小文字の区別はしません。

[Jp1XXX]

JP1製品のサービスについて記述するセクションです。XXXは，各製品によって異なった文字列を割り当てられています。なお，JP1シリーズのサービスについては，あらかじめモデルファイルで提供されています。モデルファイルに記述されていないサービスを追加する場合には，各ユーザーで任意の名称を指定してください。XXXには，60バイト以内の半角英数文字を指定してください。英字の大文字小文字の区別はしません。

[OtherServiceXXX]

JP1製品のサービスよりあとに起動する，JP1以外のサービスについて記述するセクションです。XXXには，60バイト以内の半角英数文字で，任意の名称を指定します。英字の大文字小文字の区別はしません。

Name=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。識別用として，ユーザーが任意の名称を指定します。

ServiceName=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。起動および終了するサービスの名称を指定します。このパラメーターを省略した場合，サービスの起動および終了は管理されません。

なお，定義ファイルに指定するサービス名は，［コントロールパネル］の［サービス］ダイアログボックスで表示されるサービス名と異なる場合があります。詳細については，各プログラムの発売元にご確認ください。

StartCommand=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。サービスの起動に使用するコマンドがある場合に，コマンド名を指定します。コマンド名は一つだけ指定できます。

StopCommand=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。サービスの終了に使用するコマンドがある場合に，コマンド名を指定します。このパラメーターを省略した場合は，終了の処理をしません。コマンド名は一つだけ指定できます。

Parallel=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。他サービスの開始処理中に，並行して開始処理を実行する場合に，「YES」を指定します。「YES」以外を指定した場合，およびこのパラメーターを省略した場合は，直前のサービス開始処理が完了してから，このサービスの開始処理を実行します。

Parallel=パラメーターは，サービスの起動順序を制御するときに有効となります。サービスの終了順序を制御するときはParallel=パラメーターの設定内容に関係なく，直前に定義したサービスの終了処理が完了してから，このサービスの終了処理を実行します。

Wait=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。サービス開始処理が完了するまでの最大待ち時間（秒）を指定します。このパラメーターで指定した時間を過ぎても，サービスの開始処理が完了しない場合は，次のサービスの起動処理を始めます。指定できる値は，1〜86,400（秒）です。このパラメーターを省略した場合は，60秒が設定されます。

StopWait=

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定します。サービス終了処理が完了するまでの最大待ち時間（秒）を指定します。このパラメーターで指定した時間を過ぎても，サービスの終了処理が完了しない場合は，次のサービスの終了処理を始めます。このパラメーターを省略した場合は，60秒が設定されます。指定できる値は，1〜86,400（24時間）です。

[Command]

すべてのサービスが起動または終了したあとに実行するコマンドまたはバッチファイルを記述するセクションです。このセクションでは，ReadyCommand=およびStopReadyCommand=だけを指定できます。

ReadyCommand=

［Command］セクションで指定します。すべてのサービス開始処理が完了したあとに実行するコマンド名を指定します。複数のコマンドを実行したい場合は，バッチファイルを作成し，ReadyCommandには，バッチファイルを指定してください。

StopReadyCommand=

［Command］セクションで指定します。すべてのサービス終了処理が完了したあとに実行するコマンド名を指定します。複数のコマンドを実行したい場合は，バッチファイルを作成し，StopReadyCommandには，バッチファイルを指定してください。

注意事項

セクションを囲む「[　]」は省略できません。セクションを起動順序定義ファイル（JP1SVPRM.DAT）に記述する場合，必ず「[　]」で囲んでください。

各セクション名は，起動順序定義ファイル（JP1SVPRM.DAT）内に一つだけ記述してください。同名のセクションがある場合，起動順序定義ファイル（JP1SVPRM.DAT）内で先に指定してあるセクションが有効になります。

各セクションのパラメーターに指定する名称およびコマンド名は，各セクション内で重複しないようにしてください。セクション内に同名の名称およびコマンド名がある場合，セクション内で先に指定してある名称およびコマンド名が有効になります。

起動順序定義ファイル（JP1SVPRM.DAT）内のセクション名の記述は順序を問いません。ただし，[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクション単位では，起動順序定義ファイル（JP1SVPRM.DAT）の先頭から記述している順序に従って処理が実行されます。

依存関係が結ばれているサービスを起動順序定義ファイル（JP1SVPRM.DAT）に記述する場合は，主となるサービスを先に，従属的なサービスをあとに記述してください。従属的サービスを先に記述すると，従属的なサービスの起動時に，主サービスが自動的に起動してしまいます。このような場合，JP1/Baseは，主サービスの終了処理をしません。

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクションで指定したサービスは，ServiceName=に指定したサービスだけを対象とします。複数のサービスの起動順序を制御することはできません。

StopCommand=に指定したコマンドは，起動管理機能を使って起動したサービス（StartCommand=を使って起動したサービス）にだけ有効です。起動管理機能の実行時にすでに起動していたサービスは，StopCommand=にコマンドの指定があっても，終了処理をしません。

StartCommand=，StopCommand=，ReadyCommand=，およびStopReadyCommand=に指定するコマンドには，対話操作が必要なコマンドおよびGUI画面を表示するコマンドは指定できません。

対話操作が必要なコマンドおよびGUI画面を表示するコマンドを指定すると，正常に動作しないで機能が停止してしまいます。

StartCommand=，StopCommand=，ReadyCommand=，およびStopReadyCommand=に指定するコマンドには，ネットワーク上のほかのマシンに対するアクセス権を与えることができません。ネットワーク上のほかのマシンに対して操作するコマンドを指定すると，実行時にエラーとなります。

コマンド名をフルパスで指定した場合に，スペースが含まれるときは，指定したコマンド名を「"　"」で囲んで指定してください。スペースを含まないときは，「"　"」で囲まなくてもかまいません。また，コマンドには，引数を指定できます。

Windowsのスタートメニューから［シャットダウン］を選択して，シャットダウンを実行した場合，サービスの終了順序は制御されません。サービスの終了順序を制御したい場合，JP1/Power Monitorからのシャットダウンを実行する必要があります。

JP1/Base Control Serviceサービスを手動で停止した場合，起動順序定義ファイル（JP1SVPRM.DAT）で設定をしていても，サービスの終了順序は制御されません。

JP1/Base Control Serviceサービスを利用しないで各サービスを自動起動または手動起動したい場合，起動順序定義ファイル（JP1SVPRM.DAT）内に定義されている該当するサービスの定義を必ずコメントアウトしてください。また，依存関係にあるすべてのサービスの定義も必ずコメントアウトしてください。該当するサービスの定義部分すべての行頭に#（シャープ）を付けることによって，コメントアウトできます。

このように起動順序定義ファイル（JP1SVPRM.DAT）を編集したあと，各サービスの操作を［コントロールパネル］上の［サービス］ダイアログボックス上で行ってください。コメントアウトしないで各サービスを自動起動または手動起動した場合，KAVA4003-Eメッセージが出力され，正常に動作しなくなる場合があります。

次に示すセクションのパラメーターにスペースを含むバッチファイル名を指定する場合，「cmd /c "バッチファイル名"」と指定してください。スペースを含むバッチファイル名をそのまま指定するとコマンドが正常に実行されません。

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクション

StartCommandパラメーター

StopCommandパラメーター

[Command]セクション

ReadyCommandパラメーター

StopReadyCommandパラメーター

（例）StopCommand="cmd /c "D:¥Program Files¥HITACHI¥JP1Base¥conf¥boot¥

stop_baseev.bat""

次に示すセクションのパラメーターにコマンド名と引数を指定した場合，両端を「"　"」で囲んで指定してください。

[FrontOtherServiceXXX]，[JP1XXX]，および[OtherServiceXXX]セクション

StartCommandパラメーター

StopCommandパラメーター

[Command]セクション

ReadyCommandパラメーター

StopReadyCommandパラメーター

（例）ReadyCommand=""D:¥Program Files¥ABC¥start.exe" -start D:¥temp¥ABC¥conf¥start.conf"

定義例

# JP1/Power Monitorからの強制終了時にサービスを順序どおりに終了する場合，
# 記述します。
[ControlValue]
ForcedTerminateExec=YES

# JP1製品のサービスより前に起動するサービスを記述します。
[FrontOtherService1]
Name=ABC
ServiceName=ABC
StartCommand="c:¥Program Files¥ABC¥start.exe" -start
StopCommand="c:¥Program Files¥ABC¥start.exe" -stop
[FrontOtherService2]
Name=DEF
ServiceName=def_serv

# JP1製品のサービスを記述します。
[Jp1BaseStart]
Name=JP1/Base
ServiceName=JP1Base
StopCommand="jbs_spmd_stop.exe"
[Jp1BaseEvent]
Name=JP1/Base Event
ServiceName=JP1_Base_Event
   :
[Jp1Nps]
Name=JP1/Nps
ServiceName=JP1_NPS
Wait=60
Parallel=YES

#JP1製品のサービスより後に起動するサービスを記述します。
[OtherService1]
Name=XYZ
ServiceName=XYZ

# 全サービス終了後に実行するコマンドを記述します。
[Command]
StopReadyCommand=c:¥sfiles¥stop.exe

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）

形式

[StartTimeControl]

DelayTime=サービス起動処理の遅延時間（秒）

SurveillanceTime=タイマー監視時間（秒）

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

Jp1svprm_wait.dat（サービス起動遅延時間／タイマー監視時間定義ファイル）

Jp1svprm_wait.dat.sample（サービス起動遅延時間／タイマー監視時間定義ファイルのサンプル）

格納先ディレクトリ

インストール先フォルダ¥conf¥boot¥

説明

起動順序定義ファイル（JP1SVPRM.DAT）に指定したサービスの起動を待機させる時間と，指定したサービスが正常に起動したかどうかを監視する時間を設定しておくファイルです。

定義の反映時期

Windowsまたは起動順序定義ファイル（JP1SVPRM.DAT）に指定しているすべてのサービスを停止したあと，JP1/Base Control Serviceサービスを再起動すると，設定が有効になります。

記述内容

サービス起動処理の遅延時間

起動順序定義ファイル（JP1SVPRM.DAT）に指定したサービスの起動を待機させる時間を1〜900（秒）の範囲で指定します。

タイマー監視時間

サービスの起動を監視する時間を60〜900（秒）の範囲で指定します。タイマー監視時間に指定した時間内にサービスが正常に起動しなかった場合，Windowsのイベントログおよび統合トレースログにメッセージが出力されます。

注意事項

サービスの起動タイミングを設定すると，起動順序定義ファイル（JP1SVPRM.DAT）のParallel=YES（サービスの並行起動の許可）の設定は無効になります。

起動管理機能で起動しているサービスをJP1/SSOで監視またはJP1/Power Monitorで制御しているシステムでは，サービスの起動を待機する時間分，監視または制御が遅れるため注意してください。

サービス起動処理の待機中に，ローカルマシンのJP1/Power Monitorから計画終了または強制終了しても，サービスの起動を待機する時間が経過するまで，システムの停止処理は待たされます。

定義例

[StartTimeControl]
DelayTime=60
SurveillanceTime=600

イベントサーバインデックスファイル

形式

server　イベントサーバ名　ディレクトリ名

パラメーターの分類

必須パラメーター

server

選択パラメーター

なし

ファイル名

index

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥event¥

UNIXの場合

/etc/opt/jp1base/conf/event/

説明

イベントサーバ設定，転送設定，イベントDB，ワークファイルの格納場所としてイベントサーバが使用するディレクトリを設定しておくファイルです。通常は初期設定から変更する必要はありません。

JP1/Baseをインストールしたディレクトリ以外の大容量ディスクや高速なディスクなどを指定したい場合や，自ホストで複数のイベントサーバを起動したい場合に，イベントサーバを複数定義します。

定義の反映時期

イベントサービスを起動すると，設定が有効になります。

記述内容

イベントサーバインデックスファイル（index）には，次に示す規則があります。

1行1,024バイト以内，ファイルサイズ2ギガバイト以内のテキストファイルにしてください。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。コメントと空行は，ファイル中の任意の場所に記述できます。

英字の大文字小文字は区別されます。

イベントサーバを定義し，使用するディレクトリを指定します。なお，イベントサーバを自ホスト上で複数起動する場合，イベントサーバと使用するディレクトリは，1対1で対応させてください。

server　イベントサーバ名　ディレクトリ名

イベントサーバ名

定義するイベントサーバ名を指定します。イベントサーバ名には，次に示すどれかを指定します。初期設定では，「*」が設定されています。

*

自ホスト名（hostnameコマンドで返される値）が仮定されます。通常は，初期設定の「*」で問題ありませんが，DNSに対応させる場合は，「*」をイベントサーバ名または「@」に変更してください。

イベントサーバ名

DNSに対応させる場合，またはクラスタシステムで使用する場合に指定します。DNSを使ったシステムでのイベントサーバの設定例については，「10.1.10　DNSを使ったシステムでのイベントサーバの設定」を参照してください。

イベントサーバ名は，イベントサーバを起動するホスト名を255バイト以内の文字列で指定してください。英字の大文字小文字は区別されます。なお，DNSに対応させた環境でイベントサービスの定義情報の配布と収集を利用する場合は，「@」を指定してください。

@

「@」を指定すると，DNSに対応します。また，DNSに対応させた環境でイベントサービスの定義情報の配布と収集を利用できるイベントサーバとなります。

ディレクトリ名

イベントサーバが使用するディレクトリを変更できます。変更した場合は，イベントサーバ設定，転送設定ファイルを配置してください。

フルパスで指定した場合

指定したディレクトリにイベントDBおよびワークファイルをすべて格納します。

部分パスで指定した場合

次に示すディレクトリのサブディレクトリと見なし，イベントDBおよびワークファイルをすべて格納します。

表16‒10　部分パスで指定した場合に基準となるディレクトリ（Windowsの場合）

ファイル名

ディレクトリ

イベントサーバ設定・転送設定

インストール先フォルダ¥conf¥event¥servers¥

イベントDB

インストール先フォルダ¥sys¥event¥servers¥

一時的ワークファイル

インストール先フォルダ¥sys¥tmp¥event¥servers¥

表16‒11　部分パスで指定した場合に基準となるディレクトリ（UNIXの場合）

ファイル名

ディレクトリ

イベントサーバ設定・転送設定

/etc/opt/jp1base/conf/event/servers/

イベントDB

/var/opt/jp1base/sys/event/servers/

一時的ワークファイル

/var/opt/jp1base/sys/tmp/event/servers/

注意事項

DNSに対応させる場合は，DNSが自ホスト名としてFQDN名を返す必要があります。DNSが自ホスト名としてFQDN名を返さない場合，FQDN名のイベントサーバは物理ホストのイベントサーバとして認識されません。

稼働中のイベントサービスのserverパラメーターを変更すると，イベントサービスを停止できなくなります。

物理ホストのイベントサーバ定義がFQDN名のイベントサービス名だけの場合に，JP1イベント取得関数を使用するときは，イベントサーバ名「*」（自ホスト名のイベントサーバ名）の定義を追加してください。下線部の追加する定義のディレクトリ名の記述は一致させてください。一致していない場合は動作を保証できません。また定義がない場合は，JP1イベントの取得に失敗します。

イベントサーバインデックスファイルの定義例

#-----------------------------------------------------------------------
# JP1/Base - Event Server Index
#-----------------------------------------------------------------------
server hostX.d1.hitachi.co.jp default
server * default

イベントサーバ設定ファイル

形式

# コメント

ports　アドレス　転送用ポート指定　AP用ポート指定

client-bind　アドレス

users　{　*　|　ユーザー名　}　…

eventids　{　*　|　基本コード　|　基本コード:拡張コード　}　…

alt-userid　代用ユーザーID　代用グループID

forward-limit　リトライ期限

after-error　エラー後の転送抑止時間

retry-interval　転送リトライ間隔

buffnum　SESイベント数

include　ses-conf　ファイル名

include　ajs-conf

expire　イベント保管期限

db-size　イベントDBの容量

remote-server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]

forward-timeout　待ち時間

options　[no-sync | sync]　[remote-receive]　[conv-off]　[v5-unused]　[KAJP1037-hntroff]　[KAJP1037-syslogoff]　[save-rep]　[auto-forward-off]　[suppress-notification-on]　[threshold-suppress-notification-on]　[rep-restore]

error-size　ファイルサイズ

trace-size　ファイルサイズ

evtlog-size　ファイルサイズ

fwderr-size　ファイルサイズ

log-keep　ログファイルの個数

repetition-noncheck-server　{　*　|　イベントサーバ名　}　…

restart　再起動回数　リトライ間隔　リセット時間

undisposedids　{　基本コード　|　基本コード-基本コード　}　…

suppress-notification-interval　通知間隔

threshold-suppress-notification-interval　通知間隔

パラメーターの分類

必須パラメーター

ports

forward-limit

db-size

remote-server（イベントサーバ名，通信タイプ，アドレス）

options（remote-receive，KAJP1037-hntroff，KAJP1037-syslogoff，save-rep，suppress-notification-on，threshold-suppress-notification-on）

undisposedids

選択パラメーター

client-bind

users

eventids

alt-userid

buffnum

include

remote-server（ポート指定）

options（no-sync | sync，v5-unused，conv-off，auto-forward-off）

repetition-noncheck-server

restart

suppress-notification-interval

threshold-suppress-notification-interval

ファイル名

conf

格納先ディレクトリ

Windowsの場合

イベントサーバインデックスファイルで指定したフォルダ¥

共有フォルダ¥jp1base¥event¥（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，インストール先フォルダ¥conf¥event¥servers¥default¥となっています。

UNIXの場合

イベントサーバインデックスファイルで指定したディレクトリ/

共有ディレクトリ/event/（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，/etc/opt/jp1base/conf/event/servers/default/となっています。

説明

イベントサービスの各種動作環境を設定するファイルです。主に次の項目を設定します。

JP1イベント送受信用のIPアドレスやポート番号

取得できるJP1イベントおよびJP1イベントを取得できるJP1ユーザーの指定

イベント転送失敗時のリトライ

イベントDB内のJP1イベントの保管期限およびイベントDBの容量

他ホストのイベントサーバにJP1イベントを転送するときの接続方法および転送時のエラーへの対処方法

定義の反映時期

イベントサービスを起動または再起動すると，設定が有効になります。なお，イベントサービスを再起動する場合は，イベントサービスを前提とするサービスの再起動も必要です。

記述内容

イベントサーバ設定ファイル（conf）には，次に示す規則があります。

1行1,024バイト以内，ファイルサイズ2ギガバイト以内のテキストファイルにしてください。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。コメントと空行は，ファイル中の任意の場所に記述できます。

英字の大文字小文字は区別されます。

ports　アドレス　転送用ポート指定　AP用ポート指定

このイベントサーバが，他プログラムからの接続を受け入れるために使用するIPアドレスとポート番号を指定します。

アドレス

使用するIPアドレスを次に示すどれかの形式で指定します。特別な事情がないかぎり，<jp1hosts2>での運用を推奨します。

portsパラメーターを省略すると，アドレスとして，イベントサーバ名が指定されたものと仮定します。

0.0.0.0

IPアドレスを特に限定しないで，システムに任せることを指定します。

システムを物理ホストだけで運用する場合は，この値を指定してください。

IPv4アドレス

ピリオドで区切った10進数（例：172.16.50.50）で指定します。IPアドレスを指定する場合は，複数指定できます。IPアドレスの複数指定は，主にネットワークを分離した環境でイベントサービスを運用するときに利用します。

IPアドレスを複数指定する場合は，IPアドレスを:（半角コロン）で区切って指定します（例：172.16.50.50:172.16.50.51:172.16.50.52）。IPアドレスは，最大で四つ指定できます。

注意事項

OSの名前解決でプライマリーに返されるIPアドレス以外のIPアドレスを指定した場合は，API設定ファイル（api）のserverパラメーターに，明示的にIPアドレスを指定してください。

<jp1hosts2>

イベントサーバをJP1/Baseの通信方式で通信する場合，<jp1hosts2>と指定します。また，IPv6アドレスを使用して通信する場合は，<jp1hosts2>と指定して，client-bindパラメーターを削除してください。

注意事項

通信方式をIPバインド方式に設定すると，jp1hosts情報またはjp1hosts2情報を参照します。jp1hosts情報を使用する場合は，API設定ファイル（api）のserverパラメーターに，明示的にIPアドレスを指定してください。

ホスト名

システムのhostsファイル，ネームサーバなどでIPアドレスに変換できる255バイト以内の名称を指定します。

Windowsで物理ホスト名を指定した場合，意図したIPアドレスにならない場合があります。

転送用ポート指定

他サーバからのJP1イベント転送を受け付けるためのポート番号を次に示すどちらかの形式で指定します。

ポート番号

ポート番号を，10進数で指定します。

サービス名

システムのservicesファイルで定義されている，tcpのサービス名を指定します。通常は，サービス名として「jp1imevt」を指定してください。portsパラメーターを省略すると，この値を仮定します。

AP用ポート指定

JP1イベントを発行または取得するアプリケーションからの要求を受け付けるためのポート番号を次に示すどちらかの形式で指定します。

ポート番号

ポート番号を，10進数で指定します。

サービス名

システムのservicesファイルで定義されている，tcpのサービス名を指定します。通常は，サービス名として「jp1imevtapi」を指定してください。portsパラメーターを省略すると，この値を仮定します。

client-bind　アドレス

このイベントサーバが，他プログラムにJP1イベントを送信するために使用するIPアドレスを指定します。このパラメーターは，ネットワークを分離した環境でイベントサービスを運用するときに利用します。通常は，このパラメーターを指定する必要はありません。このパラメーターを省略すると，portsパラメーターに指定されたアドレスでJP1イベントを送信します。複数のアドレスが指定されている場合は，先頭のアドレスが設定されます。

なお，IPv6アドレスを使用して通信する場合は，portsパラメーターに<jp1hosts2>を指定して，このパラメーターを削除してください。

アドレス

使用するIPアドレスを次に示すどちらかの形式で指定します。

0.0.0.0

IPアドレスを特に限定しないで，システムに任せてイベント送信します。複数LAN対応の通信設定をする場合，通常はこの値を指定してください。

IPアドレス

ピリオドで区切った10進数で指定します。指定したIPアドレスを利用してイベント送信します。

users　{　*　|　ユーザー名　}　…

JP1イベントを取得できるユーザー名を指定します。

このパラメーターは複数指定でき，すべての指定の和が，JP1イベントを取得できるユーザーとなります。このパラメーターを一つも指定しないと，どのユーザーもJP1イベントを取得できません。

*

すべてのユーザーがJP1イベントを取得できるようになります。

ユーザー名

ユーザー名を指定します。指定されたユーザー名を持つユーザーが，JP1イベントを取得できます。

eventids　{　*　|　基本コード　|　基本コード:拡張コード　}　…

プログラムで取得できるイベントIDを指定します。ここで指定されないイベントIDのJP1イベントは，発行されてもエラーにはなりませんが，取得できません。

このパラメーターは複数指定でき，すべての指定の和が，取得できるJP1イベントとなります。このパラメーターを一つも指定しないと，JP1イベントを取得できません。

*

すべてのJP1イベントを取得できるようになります。

基本コード

イベントIDの基本コードを，1〜8桁の16進数で指定します。拡張コードには，0が仮定されます。

基本コード:拡張コード

イベントIDの基本コードと拡張コードを，それぞれ1〜8桁の16進数で，コロンで区切って指定します。

alt-userid　代用ユーザーID　代用グループID

WindowsおよびJavaの実行環境は，数値形式のユーザーID・グループIDの概念を持たないため，代わりにイベントデータ中に設定する値を指定します。

代用ユーザーIDおよび代用グループIDは，-1〜65,535の10進数で指定します。省略すると，どちらも-1を仮定します。

forward-limit　リトライ期限

JP1イベントの転送に失敗した場合の，リトライを繰り返す期限を指定します。転送設定ファイル（forward）で指定したJP1イベントの転送は，転送に成功するか，ここで指定した時間が過ぎるまで，retry-intervalパラメーターで指定した間隔で繰り返されます。値は，0〜86,400（秒）の10進数で指定します。このパラメーターを省略した場合は，0（リトライしない）を仮定します。なお，このパラメーターを設定する場合は，retry-intervalパラメーターで指定するリトライ間隔よりも大きい値を指定してください。

after-error　エラー後の転送抑止時間

ある他サーバへのJP1イベント転送が失敗したあと，そのサーバへのJP1イベント転送を抑止する時間を指定します。したがって，指定された時間内は，JP1イベントはそのサーバへ転送されず，エラーとして扱われます。値は0〜2,147,483,647（秒）の10進数で指定します。retry-intervalパラメーターよりも小さい値を指定してください。このパラメーターを省略すると，30秒を仮定します。

retry-interval　転送リトライ間隔

JP1イベントの転送失敗時にリトライする間隔を指定します。値は，60〜2,147,483,647（秒）の10進数で指定します。after-errorパラメーターよりも大きい値を指定してください。このパラメーターを省略すると，600秒を仮定します。

リトライに関連するパラメーターの相関関係

JP1イベントの転送のリトライに関連するパラメーターは，forward-limit，after-error，retry-intervalです。初期設定では，JP1イベントの転送に失敗すると，3,600秒の間600秒の間隔で転送をリトライします。

クラスタ運用の場合，JP1イベントの転送中に転送元ホストまたは転送先ホストがフェールオーバーすると，そのJP1イベントの転送は失敗します。確実にJP1イベントを転送するために，必ず転送をリトライするように設定してください。

JP1イベントの転送のリトライに関連するパラメーターの相関関係を次の図に示します。

図16‒2　リトライ関連のパラメーターの相関関係

なお，転送抑止期間を除いたリトライ間隔内で，次のJP1イベントの転送が発生した場合には，その時点でリトライが行われます。

JP1イベントの転送のリトライ中にイベントサービスの再起動またはリロードが行われた場合，転送されなかったJP1イベントはリトライ期限内であればイベントサービスの起動時に再送されます。

buffnum　SESイベント数

12-50以前のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能に関連するパラメーターです。13-00以降のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能は廃止になったため，設定は不要です。

include　ses-conf　ファイル名

12-50以前のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能に関連するパラメーターです。13-00以降のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能は廃止になったため，設定は不要です。

include　ajs-conf

12-50以前のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能に関連するパラメーターです。13-00以降のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能は廃止になったため，設定は不要です。

expire　イベント保管期限

発行されたJP1イベントを，イベントDBに保管しておく時間を指定します。JP1イベントはJP1イベントの発行後，ここで指定された時間内はイベントDB中に保管され，JP1/IM - Viewなどから参照できます。ただし，イベントDBの容量がdb-sizeパラメーターで指定した値に達した場合は，保管期限に達していなくても削除されることがあります。値は0〜2,147,483,647（秒）の10進数で指定します。このパラメーターを省略すると，31,536,000秒，つまり365日が仮定されます。

db-size　イベントDBの容量

イベントDBの容量を指定します。指定された容量に達すると，expireパラメーターで指定した期限に達していなくても，古いJP1イベントが削除されることがあります。イベントサービスでは，指定された容量の最大約2倍のディスク容量を使用します。値は0〜2,147,483,647（バイト）の10進数で指定します。このパラメーターを省略すると，2,147,483,647バイトが仮定されます。

保存する日数分のイベントDBの容量の計算式を次に示します。容量を指定する際に参考にしてください。

[{a × (b + 64) + (c × 64)}× d]/2（バイト）

a：1日当たりに登録されるイベント※の総数

b：イベント1件当たりの平均サイズ。サイズは実測で測定してください。

c：1日当たりに転送されるイベントの総数

d：保存する日数

注※　1日当たりに登録されるイベントとは，自ホスト上で発生するイベント，他ホストから受信するJP1イベント，転送されるイベントのことを指します。

AIX上のイベントサーバ環境設定ファイル（conf）のdb-sizeを変更する場合，ulimitのfsizeを超えないように注意してください。db-sizeにulimitのfsizeを超える値を設定する場合には，fsizeを拡張してください。

remote-server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]

他サーバへイベントを転送する際の接続方法を指定します。このパラメーターには，異なるイベントサーバ名を複数指定できます。

イベントサーバ名

定義するイベントサーバ名を，次に示すどちらかの形式で指定します。

イベントサーバ名

個別のイベントサーバ名を，255バイト以内で指定します。

*

個別に指定されなかったイベントサーバ名に対する省略値を指定します。

この指定がない場合は，個別に指定されていないイベントサーバに対してはイベントを転送できません。

通信タイプ

指定したイベントサーバへの接続方法を指定します。

close

転送するJP1イベントが発生したら，転送元からTCP/IPのコネクションを張って送信します。送信後，2秒以上転送対象のJP1イベントが発生しないとコネクションを切断します。

ses

12-50以前のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能に関連するパラメーターです。13-00以降のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能は廃止になったため，設定は不要です。

keep-alive

転送するJP1イベントが発生したら，転送元からTCP/IPのコネクションを張って送信します。JP1イベント送信後，イベントサーバの終了時までコネクションを保存し再利用します。ただし，次に示す注意事項があるため，closeでの運用を推奨します。

注意事項

ファイアウォールで無通信時にコネクションを切断する設定をしている場合，または一時的な通信障害が発生した場合は，コネクション切断後の最初のJP1イベントの転送に失敗するおそれがあります。

アドレス

使用するIPアドレスを次に示すどれかの形式で指定します。特別な事情がないかぎり，<jp1hosts2>での運用を推奨します。

IPアドレス

ピリオドで区切った10進数（例：172.16.50.50）で指定します。

<jp1hosts2>

イベントサーバをJP1/Baseの通信方式で通信する場合，<jp1hosts2>と指定します。また，IPv6アドレスを使用して通信する場合も，<jp1hosts2>と指定します。転送先のIPアドレス解決時に，jp1hosts情報またはjp1hosts2情報を参照します。

ホスト名

システムのhostsファイル，ネームサーバなどでIPアドレスに変換できる255バイト以内の名称を指定します。

対象とするイベントサーバの，イベントサーバ設定ファイル（conf）に指定したportsパラメーターと一致させてください。

省略すると，ホスト名としてイベントサーバ名を仮定します。

ポート指定

使用するポート番号を次に示すどちらかの形式で指定します。

ポート番号

ポート番号を，10進数で指定します。

サービス名

システムのservicesファイルで定義されている，tcpのサービス名を指定します。

対象とするイベントサーバの，イベントサーバ設定ファイル（conf）に指定したportsパラメーターと一致させてください。

省略すると，自イベントサーバの転送用ポートと同じ値を仮定します。

forward-timeout　待ち時間

JP1イベントを転送する場合に，転送先からの応答を待つ時間を指定します。指定した時間内に応答がなかった場合は，転送失敗と見なします。

値は，10〜600（秒）の10進数で指定します。省略すると，90秒を仮定します。

options　[no-sync | sync]　[remote-receive]　[conv-off]　[v5-unused]　[KAJP1037-hntroff]　[KAJP1037-syslogoff]　[save-rep]　[auto-forward-off]　[suppress-notification-on]　[threshold-suppress-notification-on]　[rep-restore]

オプションのフラグを指定します。このパラメーターは，複数に分けて指定できます。

no-sync | sync

no-syncフラグを指定した場合（非推奨）

性能に特化した指定です。互換性のために残しています。このフラグを指定すると，JP1イベントのデータベースへの書き込みの，システムによるバッファリングを許します。JP1イベント発行の性能向上が期待できますが，システムが何らかの障害で停止した場合に，発行済みJP1イベントが消失することがあります。特殊な事情がないかぎり指定しないでください。

syncフラグを指定した場合（クラスタ環境推奨）

信頼性に特化した指定です。発行されたJP1イベントをそのつど確実にディスクに書き込みます。

このフラグを指定すると，システムの再起動後も確実にJP1イベントを取得できます。ただし，JP1イベントが発行されるたびにディスクに書き込むため，JP1イベント発行の性能が劣化する場合があります。なお，ディスクへの書き込みに遅延が発生すると，JP1/IM - ManagerなどからのJP1イベントの取得が大幅に遅延し，JP1イベントを取得する前にイベントDBの切り替えが発生する可能性があります。その際，JP1イベントのロストが発生するおそれがあります。そのため，このフラグを指定する場合は，システムで発生するJP1イベントの発生量が，登録性能を超えないようにしてください。登録性能については環境により異なりますので事前に検証を行ってください。

フラグを省略した場合（非クラスタ環境推奨）

初期設定の動作です。性能面，信頼性面の両面でバランスのとれた指定です。システムによるバッファリングをしながら，ディスクへの書き込みを定期的（10秒）に実施します。

remote-receive

他ホストで稼働しているプログラムからの，ネットワークを介したJP1イベント取得を許します。

ほかのホストに接続したJP1/IM - ViewのGUIから，このホストのJP1イベントを検索する場合，およびバージョン5以前の製品であるJP1/AOM - EEの情報を参照する場合は，このフラグの指定が必要です。

conv-off

12-50以前のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能に関連するフラグです。13-00以降のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能は廃止になったため，設定は不要です。

v5-unused

12-50以前のJP1/Baseでは，バージョン5以前の製品であるJP1/SES，JP1/AJSとの互換性のために用意されているすべての機能の利用を抑止します。13-00以降のJP1/Baseでは，JP1/SESイベントを使用する製品と連携するための機能は廃止になったため，設定は不要です。なお，このフラグを省略してもフラグが指定されたものとして扱います。

KAJP1037-hntroff

KAJP1037-E（イベント転送失敗）メッセージの統合トレースログへの出力を抑止します。

KAJP1037-syslogoff

KAJP1037-E（イベント転送失敗）メッセージのsyslog（UNIX）およびイベントログ（Windows）への出力を抑止します。

save-rep

イベントDBの重複防止テーブルをファイルに保持します。重複防止テーブルとは，JP1イベントが重複して登録されることを防止するテーブルです。

save-repフラグを指定する場合，イベントDBを格納するディレクトリには，32 + 転送元イベントサーバ総数 × 288バイトの空き容量が必要です。重複防止テーブルについては，「2.3.2　イベントDBとは」を参照してください。

なお，save-repオプションを設定しないで運用していた環境で，新たにsave-repオプションを指定する場合には，設定変更後イベントサービスを起動する前にjevdbmkrepコマンドを実行してください。

auto-forward-off

次に示すイベントが，抽出条件に一致しなくても転送される機能を無効にします。このフラグを指定した場合，次に示すイベントも，ほかのイベントと同様に，抽出条件に一致する場合だけ転送されるようになります。

JP1/Baseの起動通知イベント（00004724）

JP1/Baseの停止通知イベント（00004725）

しきい値による抑止通知イベント（00003D0B）

しきい値による抑止解除通知イベント（00003D0C）

しきい値による抑止全解除通知イベント（00003D0D）

しきい値による抑止継続通知イベント（00003D0E）

suppress-notification-on

jevagtfwコマンドによるイベント転送抑止状態が継続していることを通知するJP1イベントを発行します。このフラグは，jevagtfwコマンドを実行したマネージャーホストのイベントサーバで設定します。

threshold-suppress-notification-on

しきい値によるイベント転送抑止状態が継続していることを，マネージャーへ通知するJP1イベントを発行します。このフラグは，しきい値によるイベント転送抑止を設定したエージェントホストのイベントサーバで設定します。

rep-restore

イベントDBの重複防止テーブルが破損している場合に，イベントサービス起動時に自動的に修復します。save-repフラグを指定していない場合には無効となります。

注意事項

KAJP1037-hntroff，KAJP1037-syslogoffを設定しても，転送エラーを通知するKAJP1017-Eは統合トレースログおよびsyslog（UNIX），イベントログ（Windows）に出力されます。転送エラーはKAJP1017-Eで監視してください。

KAJP1037-Eメッセージは，イベントサービス転送エラーログ（fwderr.*）でも確認できます。

error-size　ファイルサイズ

イベントサービスエラーログファイル（error.*）の最大容量を指定します。指定したサイズを超えると，イベントサービスエラーログファイルは，先頭から上書きされます。値は，65,536〜2,147,483,647（バイト）までの10進数で指定します。省略すると，500,000バイトを仮定します。

保存する日数分のイベントサービスエラーログファイルの容量の計算式を次に示します。ファイルサイズを指定する際に参考にしてください。

a + (b × c) × d（バイト）

a：基本部1キロバイト

b：エラーのメッセージの平均サイズ（約120バイト）

c：1日当たりのエラーの発生回数

d：保存する日数

trace-size　ファイルサイズ

イベント転送トレースログファイル（trace.*）の最大容量を指定します。指定したサイズを超えると，イベント転送トレースログファイルは，先頭から上書きされます。値は，65,536〜2,147,483,647（バイト）までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する日数分のイベント転送トレースログファイルの容量の計算式を次に示します。ファイルサイズを指定する際には，ログの出力量および1日当たりのイベント取得件数も考慮に入れて設定してください。

a + (b + c + d) × e（バイト）

a：基本部1キロバイト

b：イベント1件登録時のログの出力量 × 1日当たりのイベント登録件数

c：イベント1件取得時のログの出力量 × 1日当たりのイベント取得件数

d：イベント1件転送時のログの出力量 × 1日当たりのイベント転送件数

e：保存する日数

ログの出力量はイベントサービスの動作によって異なりますが，参考値としてのログの出力量を次に示します。

表16‒12　ログの出力量（イベント転送トレースログ）

出力されるログの量(バイト)

イベント1件登録時

イベント1件取得時※1

イベント1件転送時※2（失敗時・イベント転送リトライ設定あり）

約150※3

約150※3

約1,500

注※1　イベント取得には，他アプリケーションによるJP1イベントの取得を含みます。参考値は，10件登録されているイベントDBの10件目のJP1イベント取得時のログ出力量となっています。また，イベントDBに登録されているJP1イベントの件数と，検索するJP1イベントの登録位置によって出力される量は変わります。

注※2　JP1イベント転送時にログ出力が最大になるのは，JP1イベントの転送に失敗し，リトライする場合です。

注※3　API設定ファイル（api）で，通信タイプをcloseに設定した場合のログの量です。通信タイプをkeep-aliveに設定した場合には，ログの量は少なくなりますが，closeに設定した場合で見積もってください。

イベント取得件数は，ユーザーアプリケーションやJP1シリーズのプログラムからイベント取得関数を使用してイベントを取得する件数です。JP1シリーズのプログラムの1日当たりのイベント取得件数は，次の計算式で求めた値を目安にしてください。

イベント取得回数※1 × イベントDBに登録されているイベント数 + 1日当たりのイベント登録件数※2

注※1　JP1/IMから，下記の回数の合計分だけイベントDBに対してイベントを取得します。

JP1/IM - Viewの起動の回数

JP1/IM - Viewのイベント検索の回数

注※2　JP1/AJSのイベント受信ジョブが実行登録されている場合，JP1/AJSは，新たにイベントDBに登録されたイベントを取得します。なお，イベント受信ジョブが複数登録されていても，JP1/AJSは登録されたイベントに対して1回だけイベントを取得します。

evtlog-size　ファイルサイズ

イベントサービストレースログファイル（imevterr.*）の最大容量（バイト数）を指定します。指定したサイズを超えると，イベントサービストレースログファイルは，先頭から上書きされます。値は，65,536〜2,147,483,647までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する日数分のイベントサービストレースログの容量の計算式を次に示します。ファイルサイズを指定する際には，ログの出力量および1日当たりのイベント取得件数も考慮に入れて設定してください。

a + (b + c + d) × e（バイト）

a：基本部1キロバイト

b：イベント1件登録時のログの出力量 × 1日当たりのイベント登録件数

c：イベント1件取得時のログの出力量 × 1日当たりのイベント取得件数

d：イベント1件転送時のログの出力量 × 1日当たりのイベント転送件数

e：保存する日数

ログの出力量はイベントサービスの動作によって異なりますが，参考値としてのログの出力量を次に示します。

表16‒13　ログの出力量（イベントサービストレースログ）

出力されるログの量（バイト）

イベント1件登録時

イベント1件取得時※1

イベント1件転送時※2（失敗時・イベント転送リトライ設定あり）

約300

約700

約400

注※1　イベント取得には，他アプリケーションによるJP1イベントの取得を含みます。参考値は，10件登録されているイベントDBの10件目のJP1イベント取得時のログ出力量となっています。また，イベントDBに登録されているJP1イベントの件数と，検索するJP1イベントの登録位置によって出力される量は変わります。

注※2　JP1イベント転送時にログ出力が最大になるのは，JP1イベントの転送に失敗し，リトライする場合です。

イベント取得件数は，ユーザーアプリケーションやJP1シリーズのプログラムからイベント取得関数を使用してイベントを取得する件数です。JP1シリーズのプログラムの1日当たりのイベント取得件数は，次の計算式で求めた値を目安にしてください。

イベント取得回数※1 × イベントDBに登録されているイベント数 + 1日当たりのイベント登録件数※2

注※1　JP1/IMから，下記の回数の合計分だけイベントDBに対してイベントを取得します。

JP1/IM - Viewの起動の回数

JP1/IM - Viewのイベント検索の回数

注※2　JP1/AJSのイベント受信ジョブが実行登録されている場合，JP1/AJSは，新たにイベントDBに登録されたイベントを取得します。なお，イベント受信ジョブが複数登録されていても，JP1/AJSは登録されたイベントに対して1回だけイベントを取得します。

fwderr-size　ファイルサイズ

イベントサービス転送エラーログファイル（fwderr.*）の最大容量を指定します。指定したサイズを超えると，イベントサービスエラーログファイルは，先頭から上書きされます。値は，65,536〜2,147,483,647（バイト）までの10進数で指定します。省略すると，1,000,000バイトを仮定します。

保存する転送失敗イベント数分の転送エラーログ容量の計算式を次に示します。

保存する転送失敗イベント数 ×（ 150 ＋ イベントサーバ名長 ＋ 送信先イベントサーバ名長）

送信先イベントサーバが複数ある場合，送信先イベントサーバ名長は，送信先イベントサーバの中で最も長い送信先イベントサーバ名長とします。

log-keep　ログファイルの個数

イベントサービスエラーログファイル，イベント転送トレースログファイル，イベントサービストレースログファイル，およびイベントサービス転送エラーログファイルを最大で幾つ作成するかを指定します。ログファイルは，イベントサービスの起動時に作成されます。イベントサービスの起動時に，指定した数以上のファイルがある場合は，最も古いファイルから削除されます。値は，0〜50の10進数で指定します。省略すると，5を仮定します。0を指定するとログを保存しません。

repetition-noncheck-server　{　*　|　イベントサーバ名　}　…

重複登録チェックを抑止するイベントサーバ名を指定します。重複登録チェックとは，JP1イベントの転送を受信する際にそのJP1イベントがすでに登録されているかどうかをチェックする処理のことを指します。重複と判断されるのは，JP1イベントの発行元イベントサーバ名，発行元イベントDB内通し番号，登録時刻が一致する場合です。

このパラメーターは複数指定でき，すべての指定の和が，重複登録チェックを抑止するイベントサーバとなります。このパラメーターを一つも指定しないと，すべての転送元イベントサーバからのJP1イベントの重複登録チェックを行います。

*

すべての転送元イベントサーバからの重複登録チェックが抑止されます。

イベントサーバ名

重複登録チェックを抑止するイベントサーバ名を個別に指定します。イベントサーバ名は，英字の大文字小文字を区別します。

restart　再起動回数　リトライ間隔　リセット時間

物理ホストのイベントサービスのプロセスが異常終了した場合の再起動の動作を設定します。再起動するための設定として，再起動回数，再起動のリトライ間隔および再起動回数のリセット時間を指定します。リセット時間で指定した期間内にプロセスが異常終了した回数が，再起動回数以下であれば，プロセスは再起動されます。再起動されると，回復したときにメッセージ（KAJP1072-I）を出力します。このメッセージはJP1イベント（イベントID：00003D04）としても通知されます。したがって，運用時にこのJP1イベントを監視すると，イベントサービスのプロセスが再起動されたことを検知できます。この指定はUNIX版のJP1/Baseだけで有効になり，Windows版のJP1/Baseでは無効になります。このパラメーターを省略した場合，イベントサービスのプロセスが異常終了しても，再起動されないため，イベントサービスは停止します。

なお，イベントサービスの再起動中は，転送元ホストから転送されるJP1イベントを受け付けられません。転送元ホストでJP1イベント転送のリトライを設定している場合は転送がリトライされますが，リトライ期間を過ぎると転送失敗となります。このような転送失敗を防ぐために，再起動回数×リトライ間隔の値は，転送元ホストのconfで指定するJP1イベント転送のリトライ期限（forward-limitパラメーター）の値より小さくなるよう設定してください。

再起動回数

再起動の試行回数を指定します。推奨値は4回です。値は，0〜99（回）の10進数で指定します。0を指定した場合，再起動されません。-1以下の値を指定した場合，0を仮定します。100以上の値を指定した場合，99を仮定します。

リトライ間隔

イベントサービスのプロセスが異常終了してから再起動をするまでの間隔を指定します。再起動に失敗した場合は，指定した間隔後に再起動します。推奨値は15秒です。値は，0〜3,600（秒）の10進数で指定します。-1以下の値を指定した場合，0を仮定します。3,601以上の値が指定された場合，3,600を仮定します。

リセット時間

再起動によってプロセスが起動してから，何秒後に再起動回数をリセットするかを指定します。プロセスが起動してから，指定した時間が経過すると，再起動回数がリセットされます。リセット時間の推奨値は，3,600秒です。値は，3,600〜2,147,483,647（秒）の10進数で指定します。3,599以下の値を指定した場合，3,600秒が仮定されます。2,147,483,648以上の値を指定した場合，2,147,483,647秒を仮定します。

推奨値である，再起動回数に4回，リトライ間隔に15秒，リセット時間に3,600秒を設定した場合の動作を次の図に示します。

図16‒3　イベントサービスのプロセスが異常終了した場合の動作例

図の例では，再起動後，再起動回数のリセット時間で指定した3,600秒以内に異常終了しなかった場合，3,600秒の時点で再起動回数がリセットされます。次回異常終了したときには1回目からカウントされます。一方，再起動後，3,600秒以内に異常終了した場合は，再起動回数を引き継ぎます。再起動回数が指定した回数に達すると，次回異常終了時には再起動しません。

注意事項

restartパラメーターの設定によって再起動できるイベントサービスのプロセスは，jevstatコマンドで確認できるプロセスIDのjevserviceプロセスの子プロセスだけです。

親プロセスが異常終了した場合，イベントサービスは停止します。

再起動回数は，子プロセスごとにカウントされます。

jevserviceプロセスの子プロセスには，次の6種類があります。

表16‒14　イベントサービスのプロセス構成

親プロセス

子プロセス

概要

jevservice

jevservice（LogTrc）

syslogまたは統合トレースログなどへ記録されるメッセージを出力します。

jevservice（DBMngr）

イベントDBを管理します。

jevservice（SESEmu）

SES互換機能です。JP1/Base 13-00からは起動しません。

jevservice（EvtAPI）

JP1イベントの登録要求または取得要求を受け付けます。

jevservice（FwdRcv）

転送されてきたJP1イベントを受信します。

jevservice（FwdMgr）

JP1イベントを転送します。

undisposedids　{　基本コード　|　基本コード-基本コード　}　…

イベント転送抑止による受信イベント破棄の対象から除外するイベントIDを指定します。ここで指定されたイベントIDのJP1イベントは，イベント転送抑止による受信イベント破棄が有効の場合でも，抑止対象のエージェントからのJP1イベントを受信します。

このパラメーターは複数指定できます。このパラメーターを省略した場合は，イベント破棄の対象になるJP1イベントをすべて破棄します。

なお，ログファイルトラップやイベントログトラップでは，条件によってイベントが大量に発生することが想定されます。そのため，初期設定では，イベントIDが3A71のJP1イベント（イベントログトラップで変換されたJP1イベント）をイベント破棄の対象としています。つまり，undisposedidsパラメーターには，3A71を除くイベントID（2000-3A70 3A72-7FFF7FFF）が指定されています。

基本コード

イベントIDの基本コードを，1〜8桁の16進数で指定します。

基本コード-基本コード

イベントIDの基本コードの範囲を，それぞれ1〜8桁の16進数で，ハイフンで区切って指定します。

suppress-notification-interval　通知間隔

jevagtfwコマンドによるイベント転送抑止状態が継続していることを通知するJP1イベントの発行間隔を指定します。値は，60〜86,400（秒）の10進数で指定します。このパラメーターを省略した場合は，3,600（秒）が仮定されます。

このパラメーターは，optionsパラメーターにsuppress-notification-onフラグを指定している場合だけ有効です。

threshold-suppress-notification-interval　通知間隔

しきい値によるイベント転送抑止状態が継続していることをマネージャーへ通知するJP1イベントの発行間隔を指定します。値は，60〜86,400（秒）の10進数で指定します。このパラメーターを省略した場合は，3,600（秒）が仮定されます。

このパラメーターは，optionsパラメーターにthreshold-suppress-notification-onフラグを指定している場合だけ有効です。

注意事項

JP1/Base 11-00以降では，log-levelパラメーターの設定が不要になりました。なお，このパラメーターを設定していてもJP1/Baseの運用には影響ありません。

定義例

# ポート番号は，システムの services ファイルに定義した，jp1imevt，および
# jp1imevtapi を使用する。
ports 0.0.0.0 jp1imevt jp1imevtapi
# ユーザー root と adm で実行されているプログラムだけがJP1イベントを取得
# できる。
users root adm
# JP1/Baseに対応したプログラムでは，すべてのJP1
# イベントを発行および取得できる。
eventids ＊
# 自マシンがWindowsである場合，また，自マシンがUNIXでもJavaプログラム
# から発行された場合は，JP1イベントをUNIX環境に転送する際，ユーザーID
# またはグループIDがそれぞれ 1001 および 100 であると見なす。
alt-userid 1001 100
# JP1イベントの転送に失敗したときに，転送をリトライする。リトライは，
# 転送に成功するか，1時間(3600秒)経過するまで繰り返す。
forward-limit 3600
# 他ホストへのイベント転送に失敗した場合，ネットワークの負荷増大を
# 防ぐため，そのホストには以後 300 秒間，イベントを転送しない。
after-error 300
# 到着後 31日(2678400秒)経ったJP1イベントは，削除する。また，31日
# 経たなくても，保管されたイベントのデータ量が 1000000 バイトに達したら，
# 古いJP1イベントを削除する。
expire 2678400
db-size 1000000
# 他ホストからのJP1イベント取得を許す。(他マシンに接続したJP1/IM -
# Console ViewからJP1/AOM - EEの情報を参照したい場合は必ず
# 指定してください。)
options remote-receive
# JP1イベントのディスクへの書き込みの，OSによるバッファリングを許す。
options no-sync
# host1・host2 は，自LAN内のマシンであるため，TCP/IPに接続した
# ままでよい。
# ほかのマシンは，電話回線を経由するため，接続をこまめに切る。
remote-server host1 keep-alive
remote-server host2 keep-alive
remote-server ＊    close
# エラーログファイルの最大容量を 500000バイト，トレースログファイルの
# 最大容量を 1000000バイトとする。この容量を超えると，ファイルの先頭から
# 上書きする。ログファイルが5個以上ある場合は，最も古いファイルから
# 削除する。
error-size 500000
trace-size 1000000
log-keep 5

転送設定ファイル

形式

# 転送設定ブロック

to-upper

イベントフィルター

end-to

　：

または

to　イベントサーバ名

イベントフィルター

end-to

　：

# 転送抑止設定ブロック

suppress　識別子　単位時間　しきい値　確認回数　[あて先]

イベントフィルター

end-suppress

パラメーターの分類

必須パラメーター

なし

選択パラメーター

to-upperまたはto

suppress

ファイル名

forward

格納先ディレクトリ

Windowsの場合

イベントサーバインデックスファイルで指定されたフォルダ¥

共有フォルダ¥jp1base¥event¥（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，インストール先フォルダ¥conf¥event¥servers¥default¥となっています。

UNIXの場合

イベントサーバインデックスファイルで指定されたディレクトリ/

共有ディレクトリ/event/（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，/etc/opt/jp1base/conf/event/servers/default/となっています。

説明

転送設定ファイル（forward）は，どのイベントサーバにどのJP1イベントを転送するかを記述した転送設定ブロックが集まったファイルです。また，しきい値によるイベント転送抑止のイベント転送抑止条件を指定します。

定義の反映時期

イベントサービスを起動もしくは再起動するか，またはjevreloadコマンドを実行して転送設定ファイルをリロードすると，設定が有効になります。jevreloadコマンドの詳細については，「15.　コマンド」の「jevreload」を参照してください。なお，イベントサービスを再起動する場合は，イベントサービスを前提とするサービスの再起動も必要です。

記述内容

転送設定ファイル（forward）には，次に示す規則があります。

転送設定ファイル（forward）は，1行1,023バイト以内のテキストファイルです。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

英字の大文字小文字は区別されます。

転送設定ブロックの記述内容

to-upper

転送設定ブロックがto-upper形式の場合，JP1イベントは，JP1/IM - Managerで定義された階層に従って，上位のサーバに転送されます。to-upper〜end-toが転送設定ブロックの単位になります。

to　イベントサーバ名

転送設定ブロックがto形式の場合，転送先のイベントサーバ名を指定します。イベントサーバ名は，英字の大文字小文字を区別します。自サーバのイベントサーバ設定ファイル（conf）で指定されている他イベントサーバ名を指定する必要があります。to〜end-toが転送設定ブロックの単位になります。

イベントフィルター

対象となるJP1イベントの条件を指定します。イベントフィルターの記述形式については，「イベントフィルターの文法」を参照してください。

転送抑止設定ブロックの記述内容

suppress　識別子　単位時間　しきい値　確認回数　[あて先]

しきい値によるイベント転送抑止のイベント転送抑止条件を指定します。suppress〜end-suppressが転送抑止設定ブロック（イベント転送抑止条件）の単位になります。

なお，個々のイベント転送抑止条件（suppress）の評価対象となるJP1イベントは，転送設定（to）で抽出したJP1イベントのうち，あて先およびイベントフィルターに該当するJP1イベントです。

識別子

イベント転送抑止条件ごとの名称を，1〜12バイトの英数字で指定します。イベント転送抑止の開始および解除時に，対象となるイベント転送抑止条件を識別するためです。イベントサーバ内でユニークな文字列になるよう指定してください。

単位時間

しきい値を判定する期間を，1〜3,600の秒単位で指定します。ここで指定した期間を一つの単位として，確認回数をカウントします。

しきい値

大量発生イベントを判定するJP1イベントの件数を，1〜72,000で指定します。単位時間当たりの抑止条件（あて先およびイベントフィルター）に該当するJP1イベントの件数が，しきい値以上になった場合，大量発生イベントであると判定します。

確認回数

大量発生イベントの発生と収束を判定する単位時間の回数を，1〜3,000で指定します。しきい値を超えた単位時間が，ここで指定した回数分連続した場合，大量発生イベントが発生したと判定して，イベント転送を抑止します。また，イベント転送抑止状態でしきい値を超えない単位時間が，指定した回数分連続した場合，大量発生イベントが収束したと判定して，イベント転送抑止を解除します。

なお，大量発生イベントの発生条件と収束条件を異なる値にする場合は，コンマで区切って指定します。例えば，「3,5」と指定した場合は，発生条件が3回，収束条件が5回になります。「3」と指定した場合は，発生条件および収束条件ともに3回になります。

[あて先]

イベント転送抑止条件の対象となる転送先イベントサーバ名を指定します。ここで指定したイベントサーバに転送されるJP1イベントが，イベント転送抑止条件の評価対象になります。

あて先には，次に示すどれかを指定します。あて先を省略した場合は，すべての転送先イベントサーバがイベント転送抑止条件の対象になります。

*

すべての転送先イベントサーバがイベント転送抑止条件の対象になります。

イベントサーバ名

イベント転送抑止条件の対象になる転送先イベントサーバ名を指定します。イベントサーバ名は，英字の大文字小文字を区別します。

(upper)

構成定義情報の上位ホスト名を転送先イベントサーバ名と仮定します。構成定義情報に上位ホストが定義されていない場合，該当のイベント転送抑止条件は無効になります。

イベントフィルター

転送設定ブロックと同様です。

注意事項

転送設定ファイル（forward）では，転送設定ブロックおよび転送抑止設定ブロックを複数指定できます。

イベントフィルターとして転送設定ファイル（forward）に日本語文字列を指定する場合，その文字コードは，イベントサービス起動時のロケール情報（環境変数LANGなど）と合致させてください。イベントフィルターとして指定した文字列の文字コードとイベントサービス起動時のロケール情報（環境変数LANGなど）が異なる場合，JP1イベントは転送されません。

複数の経路を使ってJP1イベントを転送する場合，転送先のイベントサーバが同一のJP1イベントを複数受信する場合があります。この場合，転送されてきたJP1イベントの重複チェックが行われます。重複チェックの条件を次に示します。

一つ目のJP1イベントと「発行元イベントサーバ名」が等しい。

一つ目のJP1イベントと「発行元別通し番号」が等しい。

一つ目のJP1イベントと「登録時刻」が等しい。

「登録要因」が「4」になっている（転送されてきたイベント）。

これらすべての条件を満たした場合，重複しているJPイベントと判断され，二つ目以降のJP1イベントは，イベントDBに登録されません。

同じ転送先を指定した転送設定ブロック（to〜end-to）が複数指定された場合，それぞれのブロックで指定されたイベントフィルターの順番で転送処理が行われます。最終的には各イベントフィルターをORで結合して転送処理を行った場合と等しい転送処理となります。

転送抑止設定ブロック（suppress〜end-suppress）が複数指定された場合，次のとおりイベント転送抑止条件（suppress）を評価して，転送抑止および転送抑止の解除の判定をします。

あて先が一致するすべてのイベント転送抑止条件（suppress）で評価します。

評価の結果，あて先が一致するイベント転送抑止条件（suppress）のうち，一つ以上のイベント転送抑止条件（suppress）で抑止対象と判定されたJP1イベントの転送を抑止します。そして，あて先が一致するすべてのイベント転送抑止条件（suppress）で抑止解除と判定された時点で，転送を再開します。

定義例

転送設定ブロックの定義例

次に示すシステム構成でJP1イベントを転送する場合の転送設定の例を示します。

表16‒15　転送設定の例の構成

ホスト名

構成の説明

jp1-svs1

統合マネージャー

jp1-svs2

サブマネージャー

jp1-sva1

拠点内のJP1ホスト

条件

jp1-sva1からjp1-svs2へ転送するJP1イベント

「SEVERITY」が「Error」である

「PRODUCT_NAME」が「/HITACHI/JP1/AJS」であり，かつ「SEVERITY」が「Warning」または「Notice」

「PRODUCT_NAME」が「/HITACHI/JP1/NT_LOGTRAP」

jp1-svs2からjp1-svs1へ転送するJP1イベント

「SEVERITY」が「Error」である

「PRODUCT_NAME」が「/HITACHI/JP1/AJS」であり，かつ「SEVERITY」が「Warning」

「PRODUCT_NAME」が「/HITACHI/JP1/NT_LOGTRAP」であり，かつ「SEVERITY」が「Warning」

JP1イベント転送の流れを次の図に示します。

図16‒4　JP1イベント転送の流れ

jp1-svs1のforwardファイルの定義例

#----------------------------------------------------------------
# JP1/Base - Event Service Forwarding Setting
#----------------------------------------------------------------
# Event Server Name : jp1-svs1
#(Nothing)

jp1-svs2のforwardファイルの定義例

#----------------------------------------------------------------
# JP1/Base - Event Service Forwarding Setting
#----------------------------------------------------------------
# Event Server Name : jp1-svs2
to jp1-svs1
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AJS
E.SEVERITY IN Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
E.SEVERITY IN Warning
end-to

jp1-sva1のforwardファイルの定義例

#----------------------------------------------------------------
# JP1/Base - Event Service Forwarding Setting
#----------------------------------------------------------------
# Event Server Name : jp1-sva1
to jp1-svs2
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/AJS
E.SEVERITY IN Warning Notice
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
end-to

転送抑止設定ブロック（イベント転送抑止条件）の定義例

次の条件に該当する転送抑止設定ブロック（イベント転送抑止条件）の定義例を示します。

監視ログファイル名が「/tmp/logfile1」のJP1イベントである。

JP1イベントのあて先が構成定義情報の上位ホストである。

60秒間を一つの単位として，JP1イベントが60秒間で900件以上の状態が，5回連続で発生した場合に抑止する。また，JP1イベントが60秒間で900件未満の状態が，5回連続で発生した場合は抑止を解除する。

suppress log1 60 900 5 (upper)
E.OBJECT_NAME IN /tmp/logfile1
end-suppress

API設定ファイル

形式

server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]

client　イベントサーバ名　接続元アドレス

log-keep　ログファイルの個数

log-size　ファイルサイズ

bridge　ブリッジ使用ホスト名

パラメーターの分類

必須パラメーター

server（イベントサーバ名，通信タイプ）

選択パラメーター

server（アドレス，ポート指定）

client

bridge

ファイル名

api

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥event¥

UNIXの場合

/etc/opt/jp1base/conf/event/

説明

アプリケーションプログラムからイベントサーバへの接続方法や使用するポートを設定しておくファイルです。通常は，初期設定を変更する必要はありません。他ホスト上のイベントサーバから，JP1イベントを取得するアプリケーションプログラムを自ホスト上で実行したい場合に指定を追加します。

また，イベントサーバ設定ファイル（conf）のportsパラメーターを初期設定から変更した場合は，それに合わせて変更する必要があります。

定義の反映時期

JP1/Baseのイベント変換機能や，イベントサービスと連携するJP1/IMやJP1/AJSなどのプログラムを起動または再起動すると，設定が有効になります。

記述内容

API設定ファイル（api）には，次に示す規則があります。

1行1,024バイト以内，ファイルサイズ2ギガバイト以内のテキストファイルにしてください。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。コメントと空行は，ファイル中の任意の場所に記述できます。

英字の大文字小文字は区別されます。

server　イベントサーバ名　通信タイプ　[アドレス　[ポート指定]　]

イベントサーバに接続する方法を指定します。異なるイベントサーバ名で指定する場合，このパラメーターは複数指定できます。

イベントサーバ名

定義するイベントサーバ名を，次に示すどちらかの形式で指定します。

イベントサーバ名

個別のイベントサーバ名を，255バイト以内で指定します。

*

個別に指定しなかったイベントサーバに対する値を指定します。

この指定がない場合は，個別に指定していないイベントサーバには接続できません。

通信タイプ

指定したイベントサーバへの接続の方法を指定します。

keep-alive

アプリケーションプログラムが明示的に接続を切らないかぎり，TCP/IPのコネクションは張ったままで再利用します。

close

1件のJP1イベントの取得ごとに，TCP/IPのコネクションを切断します。電話回線を使用しているなどの理由で，コネクションを常時接続していたくない場合に使用してください。ただし，効率は悪くなります。

注意事項

JP1/AJS，JP1/IM，JP1/Power Monitorでイベントサービスと連携する場合は，必ずkeep-aliveを設定してください。

次に示す場合は，closeを設定した場合でもkeep-aliveとして動作します。

イベントサービスと連携するプログラム（JP1/AJS，JP1/IM，JP1/Power Monitorなど）が接続しようとするイベントサービスのIPアドレスが，物理ホスト名（hostnameコマンドで返されるホスト名）でOSから解決されるIPアドレスと同じである場合。

アドレス

使用する接続先IPアドレスを次に示すどれかの形式で指定します。対象とするイベントサーバの，イベントサーバ設定ファイル（conf）に記述されたportsパラメーターの指定と一致させてください。省略すると，ホスト名としてイベントサーバ名を仮定します。特別な事情がないかぎり，<jp1hosts2>での運用を推奨します。

IPアドレス

ピリオドで区切った10進数（例：172.16.50.50）で指定します。

<jp1hosts2>

アプリケーションプログラムからイベントサーバへの接続に，JP1/Baseの通信方式を使用する場合，<jp1hosts2>と指定します。また，IPv6アドレスを使用して通信する場合も，<jp1hosts2>と指定します。接続先のIPアドレス解決時に，jp1hosts2情報を参照しますが，jp1hosts情報は参照しません。

ホスト名

システムのhostsファイル，ネームサーバなどでIPアドレスに変換できる255バイト以内の名称を指定します。

0.0.0.0

アプリケーションプログラムから，イベントの発行・取得が一切できなくなります（JP1のプログラムを含みます）。

JP1/AJSなど，多くのプログラムは，特に設定がなくてもイベントを発行しますが，イベントサービスが不要な場合は，「0.0.0.0」を指定すると，イベントの発行処理のオーバーヘッドを削減し，処理性能を向上できます。

ポート指定

使用するポート番号を次に示すどちらかの形式で指定します。対象とするイベントサーバの，イベントサーバ設定ファイル（conf）に記述されたportsパラメーターの指定と一致させてください。指定を省略すると，サービス名としてjp1imevtapiを仮定します。

ポート番号

ポート番号を，10進数で指定します。

サービス名

システムのservicesファイルで定義されているtcpのサービス名を指定します。

client　イベントサーバ名　接続元アドレス

イベントサーバに接続する際に使用する接続元アドレスを指定します。初期設定ではclientパラメーターの設定は省略されています。省略時には，接続元アドレスはOSが自動的に割り当てる設定になっています。複数のNICを割り当てている環境で，使用する接続元アドレスを明示的に指定する必要がある場合にこのパラメーターを定義します。このパラメーターは複数指定できます。

イベントサーバ名

接続先イベントサーバ名を，次に示すどちらかの形式で指定します。

イベントサーバ名

個別のイベントサーバ名を，255バイト以内で指定します。

*

個別に指定しなかったイベントサーバに対する値を指定します。

この指定がない場合，接続元アドレスは0.0.0.0になります。

接続元アドレス

使用する接続元アドレスを次に示すどれかの形式で指定します。

IPv4アドレス

ピリオドで区切った10進数（例：172.16.50.50）で指定します。ここに指定するIPアドレスは自ホストに割り当てられているものでなければなりません。

IPv6アドレス

コロンで区切った16進数（例：2001:db8::28）で指定します。ここに指定するIPアドレスは自ホストに割り当てられているものでなければなりません。

0.0.0.0

使用する接続元IPアドレスをOSが自動的に割り当てます。

log-keep　ログファイルの個数

ログファイルの個数

イベントサービスAPI用ログファイル（IMEvapi.*）の保存ファイル数を指定します。log-sizeで指定した容量を超えると切り替わり，ファイル数が最大になると，最も古いファイルを削除します。値は，0〜50の10進数で指定します。省略すると，5を仮定します。0を指定するとログを保存しません。

log-size　ファイルサイズ

ファイルサイズ

イベントサービスAPI用ログファイル（IMEvapi.*）の最大容量（バイト数）を指定します。値は，65,536〜2,147,483,647までの10進数で指定します。省略すると，1,000,000バイトを仮定します。ログ情報は，APIのロード時，およびエラーが発生した場合だけ出力されます。

bridge　ブリッジ使用ホスト名

イベントサービスのSSL通信が有効な場合，JP1イベント取得関数（JevGetEvent）をリモートホストに対して使用しているときは，起動しているローカルのイベントサーバ名を指定します。JP1イベント取得関数（JevGetEvent）の詳細については，マニュアル「JP1/Base 関数リファレンス」を参照してください。

物理ホストのイベントサービスが起動していないときだけ，このパラメーターを指定してください。このパラメーターを省略すると，物理ホストを仮定します。

属性付加設定ファイル

形式

# コメント

add

filter

イベントフィルター

end-filter

E.拡張属性名 属性値

　：

end-add [exit]

　：

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

recv_add_extattr（転送受信用の属性付加設定ファイル）

send_add_extattr（イベント登録用の属性付加設定ファイル）

add_extattr.model（属性付加設定ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

イベントサーバインデックスファイルで指定されたフォルダ¥

共有フォルダ¥jp1base¥event¥（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，インストール先フォルダ¥conf¥event¥servers¥default¥となっています。

UNIXの場合

イベントサーバインデックスファイルで指定されたディレクトリ/

共有ディレクトリ/event/（クラスタ運用時）

初期設定のイベントサーバインデックスファイル（index）では，/etc/opt/jp1base/conf/event/servers/default/となっています。

説明

任意の拡張属性を付加するJP1イベントの条件，および付加する拡張属性名と拡張属性値を設定するファイルです。属性付加設定ファイルには，転送受信用の属性付加設定ファイル（recv_add_extattr）とイベント登録用の属性付加設定ファイル（send_add_extattr）があります。

属性付加設定ファイルは，「推奨する定義方法」を参考に定義してください。初期設定では提供されません。

転送受信用の属性付加設定ファイル（recv_add_extattr）を定義すると，転送されたJP1イベントを受信する際に，定義に従った拡張属性が付加されます。イベント登録用の属性付加設定ファイル（send_add_extattr）を定義すると，JP1イベントをイベントDBに登録する際に，定義に従った拡張属性が付加されます。

各定義ファイルで拡張属性を付加する対象となるJP1イベントを次の表に示します。

定義ファイル

対象となるJP1イベント

転送受信用の属性付加設定ファイル（recv_add_extattr）

他イベントサーバから自イベントサーバあてに発行されたイベント※（JP1イベントの登録要因：3）。

転送設定の指定による他イベントサーバから自イベントサーバへ転送されたイベント（JP1イベントの登録要因：4）。

イベント登録用の属性付加設定ファイル（send_add_extattr）

自イベントサーバから自イベントサーバあてに発行されたイベント（JP1イベントの登録要因：1）。

自イベントサーバから他イベントサーバあてに発行されたイベント※（JP1イベントの登録要因：2）。

注※　jevsendコマンドまたはjevsenddコマンドの-dオプションで送信先イベントサーバを指定した場合，登録元のイベント登録用の属性付加設定ファイルと送信先の転送受信用の属性付加設定ファイルの両方の定義が有効になります。

定義の反映時期

イベントサービスを起動もしくは再起動するか，またはjevextreloadコマンドを実行して属性付加設定ファイルをリロードすると，設定が有効になります。jevextreloadコマンドの詳細については，「15.　コマンド」の「jevextreload」を参照してください。なお，イベントサービスを再起動する場合は，イベントサービスを前提とするサービスの再起動も必要です。

記述内容

属性付加設定ファイル（recv_add_extattr，send_add_extattr）には，次に示す規則があります。

1行1,023バイト以内のテキストファイルです。

パラメーターの各単語は，半角スペース（0x20）またはタブ（0x09）で区切ります。

各行の先頭のパラメーター名および#（0x23）の前には，空白などは入れられません。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

英字の大文字小文字は区別されます。

add〜end-add [exit]

add〜end-addが属性付加設定ブロックになります。属性付加設定ブロック内にフィルターブロックおよび任意の拡張属性を定義します。属性付加設定ブロックは複数定義できます。属性付加設定ブロックを複数定義した場合は，上位に定義した順に処理されます。end-addのあとにexitがあると，該当の属性付加設定ブロックの条件が成立した場合，それ以降の属性付加設定ブロックは処理されません。フィルターブロックを省略した場合も条件が成立と見なします。ただし，フィルターブロックと拡張属性の指定の両方を省略することはできません。

filter〜end-filter

filter〜end-filterがフィルターブロックになります。任意の拡張属性を付加するJP1イベントを絞り込むためのフィルターを定義します。フィルターブロックの形式を次に示します。

filter
イベントフィルター
end-filter

フィルターブロックを省略した場合は，すべてのJP1イベントが変換の対象となります。イベントフィルターには除外条件も指定できます。イベントフィルターの記述形式については，「イベントフィルターの文法」を参照してください。

E.拡張属性名 拡張属性値

拡張属性指定パラメーターです。JP1イベントに付加する任意の拡張属性（固有情報）の属性名および属性値を指定します。拡張属性指定パラメーターを複数定義することで，一つのJP1イベントに対して複数の拡張属性を複数付加できます。JP1イベントは100個まで拡張属性（共通情報と固有情報の合計）を持てます。また，JP1イベントに定義できる拡張属性値の長さの合計は，10,000バイトまでです。これらの制限を超える場合は，拡張属性は付加されません。なお，一つの属性付加設定ブロック内で，同一の拡張属性名は指定できません。

拡張属性指定パラメーターは省略できます。そのため，拡張属性を付加する必要がないJP1イベントに対しては，そのJP1イベントの条件をイベントフィルターに定義した上で，属性付加設定ブロックのend-addのあとにexitを指定することで，拡張属性を付加する必要がないJP1イベントを除外する指定ができます。

メモ

拡張属性値にマルチバイト文字を指定すると，JP1イベントの文字コードが「C」の場合に文字化けが発生します。マルチバイト文字を指定する場合は，イベント条件に文字コード（B.CODESET）の条件を追加し，文字コードが「8859_1」（C）の場合とそれ以外の場合で指定する文字列を分けて定義してください。

E.拡張属性名

「E.」に続けて，付加する拡張属性の名称を32バイトまでの英数字（英字は大文字）またはアンダーラインで指定します。ただし，拡張属性名の先頭の7バイトの文字列は「JP1ADD_」で固定です。したがって，「E.JP1ADD_」に続く25バイトまでの文字列を任意に指定できます。

拡張属性値

E.拡張属性名に対応する属性の内容を1〜255バイトの文字列で指定します。拡張属性値を空（NULL文字列）にした指定はできません。また，改行を含む値も指定できません。

注意事項

JP1イベントにすでに同名の拡張属性がある場合，指定した拡張属性値が再設定されます。

拡張属性を付加したJP1イベントを転送した場合，付加した拡張属性も一緒に転送されます。

推奨する定義方法

属性付加はエージェントホストでも設定できますが，どのイベントに属性付加するか一元管理するために，マネージャーホストで設定することを推奨します。

属性付加の処理は「属性付加設定ブロックの数×イベント件数」に比例してイベント登録性能に影響を与えます。そのため，属性付加設定ファイルは，次のことを考慮して定義することを推奨します。なお，属性付加の処理では，JP1イベント１件ごとに属性付加設定ブロックを先頭から順に処理します。

JP1/IM - Managerを3階層以上の階層構成で運用している場合，拠点マネージャーまたはサブマネージャーで属性付加設定ファイルを設定してください。

拡張属性を付加しないJP1イベントを対象とする条件を含む属性付加設定ブロックを先頭に定義することで，属性付加の処理を減らすことができます。

すべてのJP1イベントに対する条件，または発生頻度が高いJP1イベントに対する条件を属性付加設定ファイルの上位に定義してください。

一つのJP1イベントに対して条件ごとに異なる属性を付加する場合を除いて，各属性付加設定ブロックではend-addのあとにexitを指定してください。

属性付加設定ファイルに定義する属性付加設定ブロックの総数は，2,500件以内にしてください。2,500件を超えて属性付加設定ブロックを定義した場合でもエラーにはなりませんが，イベント登録性能が劣化して運用に影響を与えるおそれがあります。

定義例

次に示すシステム構成で，マネージャー側で受信したJP1イベントにエージェントホストが所属する業務グループ名を拡張属性として付加する場合の定義例を示します。

表16‒16　定義例のシステム構成

ホスト名

ホスト種別

jp1-mgr

統合マネージャー

jp1-agt001〜jp1-agt100

エージェント（業務グループ1）

jp1-agt101〜jp1-agt200

エージェント（業務グループ2）

統合マネージャー（jp1-mgr）の属性付加条件

重大度（SEVERITY）が「Information」または「Notice」以外のJP1イベントに拡張属性を付加する。

業務グループ1のエージェント（jp1-agt001〜jp1-agt100）から転送されたイベントに対して，業務グループ名「jp1-grp1」を拡張属性名「JP1ADD_GROUPNAME」として付加する。

業務グループ2のエージェント（jp1-agt101〜jp1-agt200）から転送されたイベントに対して，業務グループ名「jp1-grp2」を拡張属性名「JP1ADD_GROUPNAME」として付加する。

図16‒5　定義例のJP1イベント転送の流れ

統合マネージャー（jp1-mgr）の転送受信用の属性付加設定ファイル（recv_add_extattr）の定義例

# SEVERITYがInformationまたはNoticeであるJP1イベントを属性付加の対象から除外する
add
filter
E.SEVERITY IN Information Notice
end-filter
end-add exit
# エージェント(jp1-agt001〜jp1-agt100)から転送されたJP1イベントに対して
# 業務グループ名jp1-grp1を拡張属性JP1ADD_GROUPNAMEとして付加する
add
filter
B.SOURCESERVER RANGE jp1-agt001 jp1-agt100
end-filter
E.JP1ADD_GROUPNAME jp1-grp1
end-add exit
# エージェント(jp1-agt101〜jp1-agt200)から転送されたJP1イベントに対して
# 業務グループ名jp1-grp2を拡張属性JP1ADD_GROUPNAMEとして付加する
add
filter
B.SOURCESERVER RANGE jp1-agt101 jp1-agt200
end-filter
E.JP1ADD_GROUPNAME jp1-grp2
end-add exit

ログファイルトラップ動作定義ファイル

形式

retry-times=リトライ回数（イベントサービスへの接続用）

retry-interval=リトライ間隔（イベントサービスへの接続用）

open-retry-times=リトライ回数（ログファイルのオープン用）

open-retry-interval=リトライ間隔（ログファイルのオープン用）

read-retry-times=リトライ継続回数のしきい値（ログファイルの読み込み用）

hold-count=JP1イベントの保留件数

keep-event={ OLD | NEW }

upd-output-event={ 0 | 1 }

FILETYPE={ SEQ | SEQ2 | SEQ3 | WRAP1 | WRAP2 | HTRACE | UPD }

RECTYPE=｛VAR｛'¥n'｜'1行の終了文字'|'1行の終了記号'｝｜FIX　レコード長｝

HEADLINE=ヘッダーの行数

HEADSIZE=ヘッダーのサイズ

unset-extattr={[TRAP_ID,TRAP_NAME] | [TRAP_ID] | [TRAP_NAME]}

MARKSTR=[!]"正規表現"

[!]"正規表現n"※

ACTDEF=[{EXIT}][<重大度>]イベントID [!]"正規表現"

[!]"正規表現n"※

注※　「正規表現n」は複数個の指定を表します。

パラメーターの分類

必須パラメーター

なし

選択パラメーター

FILETYPE

RECTYPE

HEADLINE

HEADSIZE

MARKSTR

ACTDEF

ファイル名

任意

jevlog.conf.model（ログファイルトラップ動作定義ファイルのモデルファイル）

格納先ディレクトリ

次に示すディレクトリにjevlog.confの名称のログファイルトラップ動作定義ファイルを作成した場合は，jevlogstartコマンドの-fオプションの指定を省略できます。ログファイルトラップ動作定義ファイルは，次のディレクトリにあるモデルファイル（jevlog.conf.model）を参照してください。

Windowsの場合

インストール先フォルダ¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/

任意のディレクトリに任意のファイル名でログファイルトラップ動作定義ファイルを作成した場合は，jevlogstartコマンドの-fオプションにディレクトリ名を補ったファイル名を指定する必要があります。

説明

監視するログファイルの形式や，監視失敗時のリトライなどを設定しておくファイルです。ログファイルトラップ動作定義ファイルは初期設定では提供されません。ユーザーが作成する場合と，定義配布機能によって作成される場合があります。

定義の反映時期

jevlogstartコマンドまたはjevlogreloadコマンドを実行すると，設定が有効になります。jevlogstartコマンドおよびjevlogreloadコマンドの詳細については，「15.　コマンド」の「jevlogstart」，「jevlogreload」を参照してください。

記述内容

ログファイルトラップ動作定義ファイルには，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

1カラム目から入力します。

パラメーターと値は「=」でつなぎます。パラメーターと「=」との間には空白を入れてもかまいませんが，「=」と値の間には空白を入れないでください。また，一つのパラメーターに対して複数の値を指定する場合，値と値の間には空白を入れます。空白とは，一つ以上の半角スペース，またはタブのことです。次に例を示します。

（例）FILETYPE△△=SEQ

（例）ACTDEF=0△message

（凡例）△：1個の空白

値の後ろ（値が複数ある場合は最後の値）と改行の間にはコメントを記入することはできません。空白以外は入れないでください。

retry-times=リトライ回数（イベントサービスへの接続用）

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの回数を指定します。値は，0〜86,400（回）の10進数で指定します。このパラメーターを省略すると，3回が仮定されます。

なお，リトライ回数とリトライ間隔の指定に関係なく，リトライを開始してから86,400秒（24時間）経過するとエラーとなります。

retry-interval=リトライ間隔（イベントサービスへの接続用）

一時的な通信障害で，イベントサービスへの接続に失敗した場合に行うリトライの間隔を指定します。リトライ回数を1以上に設定した場合に有効となります。リトライ間隔は，イベントサービスへの接続に失敗してから次にイベントサービスへの接続を試みるまでの間隔です。イベントサービスへの接続処理に掛かる時間は含みません。値は，1〜600（秒）の10進数で指定します。このパラメーターを省略すると，10秒が仮定されます。

なお，リトライ回数とリトライ間隔の指定に関係なく，リトライを開始してから86,400秒（24時間）経過するとエラーとなります。

open-retry-times=リトライ回数（ログファイルのオープン用）

ログファイルトラップの開始時に，一時的にログファイルをオープンできなかった場合に行うリトライの回数を指定します。値は，1〜3,600（回）の10進数で指定します。このパラメーターを省略すると，1回が仮定されます。

なお，リトライ回数とリトライ間隔の指定に関係なく，リトライを開始してから3,600秒（1時間）経過するとエラーとなります。

open-retry-interval=リトライ間隔（ログファイルのオープン用）

ログファイルトラップの開始時に，一時的にログファイルをオープンできなかった場合に行うリトライ間隔を指定します。リトライ間隔は，ログファイルのオープンに失敗してから，次にログファイルのオープンを試みるまでの間隔です。値は，1〜600（秒）の10進数で指定します。このパラメーターを省略すると，1秒が仮定されます。

なお，リトライ回数とリトライ間隔の指定に関係なく，リトライを開始してから3,600秒（1時間）経過すると，エラーとなります。

read-retry-times=リトライの継続回数のしきい値（ログファイルの読み込み用）

一時的にログファイルの読み込みに失敗した場合に行うリトライの，継続回数のしきい値を指定します。リトライの継続回数のしきい値とは，10ミリ秒間隔で5回行うリトライを1セットとしてカウントした回数です。10ミリ秒間隔で5回行うリトライが，このパラメーターに指定した回数を超えると，エラーとなります。値は，1〜1,000（回）の10進数で指定します。このパラメーターを省略すると，100回が仮定されます。

hold-count=JP1イベントの保留件数

リトライ処理中に保留できるJP1イベントの件数を指定します。値は，1〜1,000（件）の10進数で指定します。このパラメーターを省略すると，100件が仮定されます。

リトライ処理をする場合，リトライ処理中に変換されたJP1イベントを保留するためのリソースが必要となります。リトライ処理をする場合に必要なメモリー所要量を次に示します。

JP1イベントの保留件数 × 1キロバイト

keep-event={ OLD | NEW }

リトライ処理中に保留されたJP1イベントが保留件数を超過した場合，超過したJP1イベントは消去されます。超過した場合に，古いJP1イベントと新しいJP1イベントのどちらを残すかを指定します。このパラメーターを省略すると，OLDが仮定されます。

OLD

古いJP1イベントを残したい場合に指定します。この場合，hold-countパラメーターに指定したJP1イベントの保留件数までJP1イベントを保留し，以降に発生したJP1イベントは保留されずに消去されます。

NEW

新しいJP1イベントを残したい場合に指定します。この場合，JP1イベントの保留件数を超過すると，古いJP1イベントから消去されます。

upd-output-event={ 0 | 1 }

ログファイルのデータ出力形式にUPDを指定した場合，監視対象となるログファイルを検出したときに，JP1イベント（00003A25または00003A26）を出力するかどうかを指定します。このパラメーターを省略すると0が仮定されます。UPD以外を指定した場合，このパラメーターの指定は無視されます。

0

JP1イベントを出力しない場合に指定します。

1

JP1イベントを出力する場合に指定します。

FILETYPE={ SEQ | SEQ2 | SEQ3 |WRAP1 | WRAP2 | HTRACE | UPD }

読み込むログファイルのデータ出力形式を指定します。このパラメーターを省略すると，SEQが仮定されます。

SEQ

シーケンシャルファイル（一つのログファイルに追加書き込みし続けるファイル，またはログファイルが一定の容量に達すると，別のファイル名で新たにログファイルを作成して書き込むファイル）の場合に指定します。

SEQ2

次のようなファイルの場合に指定します。

Windowsの場合

同一ボリューム内でファイル名を変更したあと，変更前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

UNIXの場合

ファイル名を変更，またはファイルをいったん削除したあと，変更／削除前のファイル名と同じ名称のファイルを作成して新たにログを書き込むファイルです。

注意事項

SEQ2で監視する場合，監視間隔の間にログファイルが1回切り替わると，切り替わる前のファイル内から前回読み込んだデータ以降に蓄積されたデータを読み込んだあと，新たなファイル内のデータを読み込みます。そのため，監視間隔の間に2回以上切り替わると，切り替わる直前のファイルからのデータしか読み込めません。ログファイルが切り替わる頻度を考慮してjevlogstartコマンドの-tオプション（監視間隔）を設定してください。

SEQ3（Windows限定）

Windows上で，ファイルをいったん削除したあと，削除前のファイル名と同じ名称のファイルを作成して，新たにログを書き込むファイルの場合に指定します。

なお，リモートマシンにあるこの形式のログファイルを，IM構成管理機能のリモート監視のログファイルトラップで監視する場合，SEQ2で監視できます。ただし，この形式のログファイルをローカルマシン上のログファイルトラップで監視する場合は，SEQ3で監視する必要があります。

注意事項

SEQ3で監視する場合，ログファイルが削除された際に，前回読み込んだデータ以降に蓄積されていたデータがあると，読み込めないデータが発生します。ログ出力後，すぐにログファイルを削除している場合は，注意が必要です。

SEQ2形式で出力されるファイルをSEQ3で監視した場合，ログファイルがリネームされた際に，前回読み込んだデータ以降に蓄積されていたデータがあると，読み込めないデータが発生します。SEQ2で監視している場合は，この現象は発生しません。

WRAP1

ラップアラウンドファイル（ラップアラウンドして，再び先頭からデータを上書きするファイル）の場合に指定します。

WRAP1の場合，読み込むログファイルのコピーを作成して，そのコピーと現在のログファイルを比較して読み込み位置を決定するため，監視するファイルの容量と同じサイズのディスク容量が必要です。

注意事項

WRAP1で大容量のファイルを監視する場合，書き込んでいるデータ位置がファイルの最後の方にあると，最初のJP1イベントが発生するまでに時間が掛かります。

次のようなラップアラウンドファイルの場合，JP1イベントへの変換が遅延したり，JP1イベントへ変換できなかったりすることがあります。

・短期間にラップアラウンドを繰り返す。

・ファイルの容量以上のログが一度に出力される。

・同じログデータが複数出力される。

WRAP2

ラップアラウンドファイル（ラップアラウンドするとき，データを削除して再び先頭からデータを書き込むファイル）の場合に指定します。

統合トレースログを監視する場合はWRAP2を適用してください。

ファイルを削除または名称を変更して作成し直す運用の場合は，SEQ2を指定してください。

注意事項

WRAP2の場合，データをすべて読み込む前にラップアラウンドしてデータが削除されると，読み込めないデータが発生します。監視間隔を長くすると，一度に読み込むデータの量が多くなるため，jevlogstartコマンドの-tオプション（監視間隔）の指定に注意してください。

JP1/Baseは，ラップアラウンドしたことを，ファイルのサイズが小さくなったことで検知しています。ラップアラウンド前とラップアラウンド後のファイルのサイズが同じである場合やラップアラウンド後のファイルのサイズが大きい場合，ラップアラウンドしたと判断しないため注意が必要です。

統合トレースログに出力されるメッセージについては，複数のプロセスから同時に出力されるとメッセージが破損することがあるため，特定のメッセージを監視したい場合は，統合トレースログの排他機能を有効にしてください。排他機能の詳細については，「15.　コマンド」の「hntr2conf」を参照してください。

HTRACE

マルチプロセス対応トレースファイル（複数のプロセスが一組のトレースファイルを共有し，メモリマップドファイルを使用した固定サイズのファイル）の場合に指定します。

ログファイルへの書き込み方法はWRAP1と同様で，ログファイルが一定の容量に達するとラップアラウンドして，再び先頭からデータを上書きします。

Windowsの場合，Unicodeファイルの監視は，文字コードがUTF-8で出力されたログに対応しています。文字コードがUTF-16で出力されたログは監視できません。

UPD

常に，最新のログファイルを監視する場合に指定します。

この形式のログファイルを監視する場合，jevlogstartコマンド実行時に，ワイルドカードを含むように監視ファイル名を指定します。ワイルドカード指定に該当するログファイルのうち，最新更新日時のログファイルを監視対象として，ログファイルトラップを起動します。ログファイルトラップ起動後（監視中）は，ワイルドカード指定に該当する，新規に作成されたログファイルを監視対象とします。

ワイルドカードの対象となるファイルの上限は，1,000個です。なお，ワイルドカードの対象となるファイルでも，ファイル名の長さが完全名で257バイト以上のときは監視対象にはなりません。

また，監視対象となるファイルは，シーケンシャルファイル（一つのログファイルに追加書き込みし続けるファイル）でなければなりません。

RECTYPE={ VAR { '¥n'| '1行の終了文字' | '1行の終了記号'} | FIX レコード長 }

読み込むログファイルのレコード形式を指定します。このパラメーターを省略すると，RECTYPE=VAR '¥n'が仮定されます。つまり，可変長で「¥n」が1行の区切りというレコード形式の指定になります。

VAR

可変長のレコード形式の場合に，1行の終了文字，または1行の終了記号を指定します。C言語でのキャラクター1文字の指定と同じように「’’」で囲み，エスケープシーケンスでも指定できます。

FIX

固定長のレコード形式の場合に，レコード長を1行の区切りとして指定します。レコード長は，1〜9,999,999（バイト）の10進数で指定します。

HEADLINE=ヘッダーの行数

読み込むログファイルの先頭にヘッダーがある場合，ヘッダーの行数を，0〜99,999（行）の10進数で指定します。このパラメーターを省略すると，0行が仮定されます。

HEADSIZE=ヘッダーのサイズ

読み込むログファイルの先頭にヘッダーがあり，かつそのヘッダーが行数で指定できない場合，ヘッダーのサイズを，0〜9,999,999（バイト）の10進数で指定します。行数で指定できないヘッダーとは，バイナリーデータや，レコード形式がログデータと異なっているヘッダーなどです。HEADLINEパラメーターを指定しているときには，このパラメーターは無効になります。このパラメーターを省略すると，0バイトが仮定されます。

WindowsでUnicodeファイルの監視をする場合，Unicodeファイルの先頭にBOMがあるときは，BOMのサイズ（UTF-8の場合は3バイト，UTF-16の場合は2バイト）を除いたヘッダーのサイズを指定してください。

unset-extattr={[TRAP_ID,TRAP_NAME] | [TRAP_ID] | [TRAP_NAME]}

JP1/Baseのバージョンが10-50以降の場合，ログファイルトラップが出力するJP1イベントの拡張属性に監視ID（JP1_TRAP_ID）と監視名（JP1_TRAP_NAME）が出力されます。これらの属性値を出力しないようにする場合に，このパラメーターを指定します。このパラメーターを省略すると，監視IDと監視名が出力されます。

TRAP_ID,TRAP_NAME

監視IDと監視名のどちらも出力しない場合に指定します。

TRAP_ID

監視IDを出力しない場合に指定します。

TRAP_NAME

監視名を出力しない場合に指定します。

MARKSTR=[!]"正規表現"

ログデータ以外のデータなど，監視の対象外にしたいデータを正規表現で指定します。正規表現は「"　"」で囲んでください。ログデータ以外のデータとは，一定間隔でログファイル中に出力されるデータなどです。ログデータ以外のデータの例を次に示します。

（例）"==== 13:00:00 JP1/Base Event ===="

「!」を「"　"」の前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを監視の対象外とします。

一つのMARKSTRパラメーターには，複数の正規表現を指定できます。複数の正規表現を指定した場合，AND条件となり，「!」の指定も含むすべての正規表現の条件に一致するデータだけを監視対象外とします。なお，複数の正規表現を指定する場合は，正規表現の間を改行で区切ってください。2行目からは値だけを指定します。この場合，2行目以降の値の前に一つ以上の空白を入れてください。次に，「====」および「MARK」を含むデータを監視の対象外に指定する場合の例を示します。

（例）MARKSTR="===="（改行）
      △△△△△"MARK"
    （凡例）△：空白

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべて監視対象外とします。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭からjevlogstartコマンドの-mオプションで指定した長さまでの間だけです。このパラメーターをすべて評価してからACTDEFを評価します。このパラメーターを省略すると，ログデータ以外のデータはないと仮定されます。

ACTDEF=[{EXIT}][<重大度>]イベントID [!]"正規表現"

JP1イベントに変換するログデータの正規表現と，対応するJP1イベントのイベントIDおよび重大度を指定します。正規表現に一致するログがあると，指定したイベントIDでJP1イベントを発行します。なお，「=」，「{EXIT}」，「<重大度>」，および「イベントID」の間にはスペースまたはタブを入れないでください。入れた場合は文法エラーになります。

このパラメーターは複数指定できます。指定できる個数に制限はありません。複数指定した場合，OR条件となり，それぞれの指定に一致するデータをすべてJP1イベントに変換します。

このパラメーターに指定した正規表現がチェックされるのは，入力したログデータのうち，先頭からjevlogstartコマンドの-mオプションで指定した長さまでの間だけです。

正規表現の拡張については，「3.4.5　使用する正規表現を拡張する」を参照してください。

WindowsでUnicodeファイルを監視する場合は，必ず拡張した正規表現を指定してください。この場合，正規表現の拡張設定（"REGEXP"="EXTENDED"）の有無に関係なく，拡張した正規表現でフィルタリングします。拡張した正規表現の指定方法については，「付録F.2　正規表現を拡張した場合に使用できる拡張正規表現」を参照してください。

このパラメーターは省略できません。

{EXIT}

複数のACTDEFパラメーターを指定した場合に，「{EXIT}」を指定した条件に一致した時点で，そのログデータの監視を終了します。

複数のACTDEFパラメーターを指定した場合，一つのログデータが複数のACTDEFパラメーターの条件に一致すると，一致した数だけJP1イベントが発行されます。「{EXIT}」を指定しておくと，「{EXIT}」を指定した条件のイベントIDでJP1イベントが発行され，以降の監視は行われません。

「{EXIT}」を指定した場合，および指定しない場合の処理の違いを次の図に示します。

図16‒6　ログファイルトラップ動作定義ファイル指定例

<重大度>

JP1イベントの拡張属性の重大度を「<　>」で囲んで指定します。重大度とイベントIDは，対にして指定します。指定できる値を次に示します。

Emergency

Alert

Critical

Error

Warning

Notice

Information

Debug

指定を省略した場合は，Noticeが仮定されます。

イベントID

イベントサーバにJP1イベントを登録する際のイベントIDを指定します。イベントIDは上位4バイト（基本コード）と下位4バイト（拡張コード）をコロン「:」で区切り，16進数で記述します。A〜Fは大文字で記述してください。なお，下位4バイトまたはコロン以下の下位4バイトは省略できます。この場合，省略値には0を仮定します。また，上位下位とも8桁に満たない場合は前から補われます。ユーザーが指定できる範囲の値，0:0〜1FFF:0および7FFF8000:0〜7FFFFFFF:0を指定してください。なお，拡張コードには0を指定してください。

イベントIDの表記例を次に示します。次に示す3通りの表記は同じ意味になります。

0000011A:00000000
11A:0
11A

"正規表現"

JP1イベントに変換するログデータを正規表現で指定します。正規表現は「"　"」で囲んでください。「!」を一つ目の「"　"」の手前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを変換対象とします。

一つのACTDEFパラメーターには，複数の正規表現を指定できます。複数の正規表現を指定した場合，AND条件となり，「!」の指定も含むすべての正規表現の条件に一致するデータだけをJP1イベントに変換します。なお，複数の正規表現を指定する場合は，正規表現の間を改行で区切ってください。2行目からは正規表現だけを指定します。この場合，2行目以降の値の前に一つ以上の空白を入れてください。次に，「jp1base」および「error」を含むデータを，イベントID「00000333」でJP1イベントに変換する場合の指定例を示します。

（例）ACTDEF=00000333  "jp1base"（改行）
      △△△△△"error"
    （凡例）△：空白

注意事項

JP1/Base 11-00以降では，retry-timesパラメーターを省略した場合の仮定値を0から3に変更しました。

次の誤りがある場合は，jevlogstartコマンド実行時にKAVA3646-Eのメッセージが標準エラー出力に出力され，ログファイルトラップの起動に失敗します。

ログファイルがマルチプロセス対応トレースであるが，ログファイルトラップ動作定義ファイルのファイル形式にHTRACEが指定されていない

ログファイルがマルチプロセス対応トレース以外であるが，ログファイルトラップ動作定義ファイルのファイル形式にHTRACEが指定されている

なお，jevlogstartコマンドに-rオプションを指定して実行した場合は，ログファイルトラップは，監視対象のログファイルが作成されるまで待機します。ファイル形式の指定に上記の誤りがある場合は，ログファイルが作成されたあとにKAVA3646-Eのメッセージがsyslog，イベントログ，および統合トレースログに出力され，ログファイルトラップが停止します。

このエラーメッセージが出力された場合は，ログファイルトラップ動作定義ファイルのファイル形式を指定し直してからjevlogstartコマンドを再度実行してください。

このほかのケースでファイル形式の指定を誤った場合は，ログファイルトラップの起動後，ログファイルが一定量に達して切り替わったときに，エラーメッセージおよびJP1イベント（00003A22または00003A27）で通知します。JP1イベントの詳細については，「17.3.1(16)　イベントID：00003A22の詳細」および「17.3.1(19)　イベントID：00003A27の詳細」を参照してください。

JP1イベント（00003A22または00003A27）が通知された場合は，エラーメッセージで示されるログファイルの状態を確認し，ログファイルトラップ動作定義ファイルのデータ出力形式（FILETYPE）を正しく定義してください。

また，形式を誤った状態のままで運用を継続しても正しく監視されません。データ出力形式を正しく定義したあと，ログファイルトラップを再起動してください。

JP1イベント（00003A22または00003A27）が通知されるケースを，ログファイルの形式ごとに示します。

表16‒17　ファイル形式ごとのJP1イベントが通知されるケース

ログファイルトラップ動作定義ファイルに指定したファイル形式

異常となるケース

SEQ

ログファイルが削除された場合

ログファイルのサイズが小さくなった場合

ログファイルが削除されたあと，同じ名称で再作成された場合※

SEQ2

リネームして再作成される前に，ログファイルのサイズが小さくなった場合

SEQ3（Windows限定）

監視中のログファイルのサイズが小さくなった場合

WRAP1

ログファイルが削除された場合

ログファイルのサイズが小さくなった場合

ログファイルが削除されたあと，同じ名称で再作成された場合※

WRAP2

ログファイルが削除された場合

ログファイルが削除されたあと，同じ名称で再作成された場合※

HTRACE

ログファイルが削除された場合

ログファイルが削除されたあと，同じ名称で再作成された場合

UPD

ログファイルが削除された場合

ログファイルのサイズが小さくなった場合

ログファイルが削除されたあと，同じ名称で再作成された場合

注※　ログファイルの形式がSEQ2の可能性があるため，ログファイルトラップ動作定義ファイルに指定したファイル形式を見直してください。

定義例

MARKSTRパラメーターおよびACTDEFパラメーターの定義例

次に示すログデータを基に，MARKSTRパラメーターおよびACTDEFパラメーター部分の定義例を説明します。

定義例1

ログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

定義例2

定義例1とは異なるログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

定義例3

ログファイルトラップの条件を左に，ログファイルトラップ動作定義ファイルの定義例を右に示します。

ログファイルトラップ起動定義ファイル

形式

START_OPT=[{SKIP}][<起動LANG>]監視名:jevlogstartコマンドオプション

　　：

START_OPT_CLS=[(クラスタID)][<起動LANG>]監視名:jevlogstartコマンドオプション

　　：

パラメーターの分類

必須パラメーター

なし

選択パラメーター

START_OPT

START_OPT_CLS

ファイル名

jevlog_start.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥event¥

UNIXの場合

/etc/opt/jp1base/conf/event/

説明

次に示すときに起動または終了するログファイルトラップを設定するファイルです。

ログファイルトラップ管理サービス（デーモン）が起動したとき

jevlogstart（クラスタ運用限定）コマンドが実行されたとき

jevlogstop（クラスタ運用限定）コマンドが実行されたとき

ログファイルトラップ起動定義ファイルは初期設定では提供されません。ユーザーが作成する場合と，IM構成管理による定義情報（プロファイル）として作成される場合があります。

ログファイルトラップ起動定義ファイルを使用してログファイルトラップを起動した場合，ログファイルトラップ起動実行結果ログに起動開始情報（KAVA3661-I）および起動結果情報（KAVA3662-I）が出力されます。また，パラメーターの指定に誤りがあった場合，警告メッセージが出力されて無効な指定となります。

ログファイルトラップ起動実行結果ログの出力先は，次のとおりです。

Windowsの場合

インストール先フォルダ¥log¥jevlog_start¥jevlog_start{1|2|3}.log

UNIXの場合

/var/opt/jp1base/log/jevlog_start/jevlog_start{1|2|3}.log

ログファイルトラップ起動定義ファイルを使用してログファイルトラップを起動する時間にはタイムアウト時間を設けています。

タイムアウト時間を経過してもjevlogstartコマンドが終了しない場合，実行済みのjevlogstartコマンドは処理を継続しますが，ログファイルトラップ起動定義での起動は打ち切り，次のログファイルトラップの起動に処理を移します。

参考

タイムアウトする要因として，ログファイルトラップの起動時にイベントサービスとの接続で時間が掛かることがあります。

タイムアウトになると，KAVA3662-Iメッセージ中の"Message="にjevlogstartコマンドの実行結果を出力しないため，最終的にログファイルトラップの起動に失敗してもわかりません。

イベントサービスとの接続処理が失敗してログファイルトラップが最終的に停止する場合がありますので，イベントサービスとの接続リトライ設定を推奨します。

定義の反映時期

次に示すときに設定が有効になります。

ログファイルトラップ管理サービス（デーモン）が起動したとき

jevlogstart（クラスタ運用限定）コマンドが実行されたとき

なお，jevlogstop（クラスタ運用限定）コマンドが実行されたときは，直前のjevlogstart（クラスタ運用限定）コマンド実行時に読み込んだログファイルトラップ起動定義ファイルの情報に基づいて，ログファイルトラップが終了されます。

記述内容

ログファイルトラップ起動定義ファイル（jevlog_start.conf）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

1行に1パラメーターを定義します。

1カラム目から入力します。

パラメーターと値は「=」でつなぎます。パラメーターと「=」との間には空白を入れてもかまいませんが，「=」と値の間には空白を入れないでください。

値の後ろ（値が複数ある場合は最後の値）と改行の間にはコメントを記入することはできません。空白以外は入れないでください。

START_OPT=[{SKIP}][<起動LANG>]監視名:jevlogstartコマンドオプション

ログファイルトラップ管理サービス（デーモン）起動時に起動するログファイルトラップおよび起動オプションを指定します。

このパラメーターは，START_OPT_CLSパラメーターと合わせて200件まで指定できます。START_OPTパラメーターとSTART_OPT_CLSパラメーターの指定の合計が200件を超える場合，201件目以降の指定は無効となります。

なお，このパラメーターで指定したログファイルトラップは，jevlogstart（クラスタ運用限定）コマンドおよびjevlogstop（クラスタ運用限定）コマンド実行時には，起動または終了対象になりません。

{SKIP}

START_OPTパラメーターでログファイルトラップの起動をスキップする場合に指定するオプションです。括弧{}で囲んで大文字で指定します。

{SKIP}を省略した場合は，起動対象になります。

IM構成管理のプロファイル管理機能でログファイルトラップの起動または停止操作をした場合に更新されるオプションで，起動時にこのオプションが定義から削除されて，停止時にはこのオプションが定義に付加されます。

START_OPT_CLS=[(クラスタID)][<起動LANG>]監視名:jevlogstartコマンドオプション

jevlogstart（クラスタ運用限定）コマンド実行時に起動し，jevlogstop（クラスタ運用限定）コマンド実行時に終了するログファイルトラップおよび起動オプションを指定します。このパラメーターは，クラスタ運用で共有ディスク上のログファイルを監視している場合に，フェールオーバー時にログファイルトラップをまとめて起動・終了するときに指定します。

このパラメーターは，START_OPTパラメーターと合わせて200件まで指定できます。START_OPTパラメーターとSTART_OPT_CLSパラメーターの指定の合計が200件を超える場合，201件目以降の指定は無効となります。

なお，このパラメーターで指定したログファイルトラップは，ログファイルトラップ管理サービス（デーモン）起動時には，起動対象になりません。

<起動LANG>

UNIXの場合，jevlogstartコマンド実行時の環境変数LANGの値を「< >」内に指定します。指定できるLANGの値については，「3.4.2　使用する言語種別を設定する（UNIXの場合）」の「表3-5　UNIXの文字コードおよび環境変数LANGの値」を参照してください。

LANGの値を省略した場合は，ログファイルトラップ管理デーモン起動時の環境変数LANGと同じ文字コードが仮定されます。

なお，この指定は，Windowsの場合は無効となります。指定した場合は，無視されます。

監視名

ログファイルトラップの監視名を指定します。コロン「:」の前までが監視名と見なされます。

監視名は30バイト以内で指定してください。使用できる文字は，英数字，ハイフン，およびアンダーラインです。監視名の先頭の文字は，必ず英数字を指定してください。大文字，小文字は区別されます。

なお，監視名は重複しないように指定してください。

jevlogstartコマンドオプション

jevlogstartコマンドのオプションを指定します。ログファイルトラップ管理サービス（デーモン）起動時またはjevlogstart（クラスタ運用限定）コマンド実行時には，この指定と監視名の指定を基にjevlogstartコマンドが生成され，ログファイルトラップが起動されます。

指定できるオプションについては，「15.　コマンド」の「jevlogstart」を参照してください。

Windowsのみ指定できる文字数に上限がありますので以下の計算式で計算してください。

16 + 「監視名」のバイト数 + 「jevlogstart コマンドオプション」のバイト数 <= 4096バイト

IM構成管理と連携する場合は，jevlogstartコマンドオプションにログファイルトラップ動作定義ファイル名（-fオプション）を必ず指定してください。

起動するログファイルトラップの監視名は，START_OPTパラメーターまたはSTART_OPT_CLSパラメーターの監視名に指定した値となります。このため，-aオプションを指定した場合は，無視されます。

また，jevlogstart（クラスタ運用限定）コマンドのオプション（-cluster）を指定した場合はパラメーター不正となり，定義が無効になります。

jevlogstartコマンド実行時のカレントディレクトリを次に示します。

Windowsの場合

インストール先フォルダ¥COMMAND

UNIXの場合

/opt/jp1base/command

コマンドオプションでファイルパスの相対パス指定をする場合は，これらのパスを基準に指定してください。

(クラスタID)

クラスタIDを「()」内に指定します。クラスタIDとは，クラスタシステムを識別するためのID番号です。複数のクラスタシステムを運用している場合に，0〜99の範囲でユーザーが任意に指定します。

値は0〜99の10進数で指定します。クラスタIDを省略した場合は，0が仮定されます。

複数のクラスタシステムを運用している場合の定義方法

複数のクラスタシステムを運用している場合は，論理ホストに対応するクラスタIDを決定し，各論理ホストのフェールオーバー時に起動・終了するログファイルトラップを定義します。

複数のクラスタシステムを運用している場合の構成例を次に示します。

図16‒7　複数のクラスタシステムを運用している場合の構成例

この構成例の場合，論理ホスト1のクラスタIDは「0」です。また，論理ホスト1が出力するログを監視するログファイルトラップは「ログファイルトラップA」および「ログファイルトラップB」です。したがって，ログファイルトラップ起動定義ファイルには，クラスタID「0」のログファイルトラップとして，「ログファイルトラップA」および「ログファイルトラップB」の起動オプションを定義します。

同様に，論理ホスト2については，クラスタID「1」のログファイルトラップとして，「ログファイルトラップC」および「ログファイルトラップD」の起動オプションを定義します。

なお，クラスタソフトには，論理ホスト1，論理ホスト2のフェールオーバー時にそれぞれ次のコマンドを実行するように登録しておきます。

論理ホスト1のフェールオーバー時

jevlogstart -cluster 0

jevlogstop -cluster 0

論理ホスト2のフェールオーバー時

jevlogstart -cluster 1

jevlogstop -cluster 1

このように登録することで，論理ホスト1のフェールオーバー時には「ログファイルトラップA」および「ログファイルトラップB」だけが，論理ホスト2のフェールオーバー時には「ログファイルトラップC」および「ログファイルトラップD」だけが，起動・終了の対象となります。

クラスタソフトに登録するコマンドの詳細については，「15.　コマンド」の「jevlogstart（クラスタ運用限定）」および「jevlogstop（クラスタ運用限定）」を参照してください。

定義例

#サービス(デーモン)起動時に，起動させるログファイルトラップを指定
START_OPT=<ja_JP.eucJP>KANSI1:-f /etc/〜/jevlog.conf /fil/aaa.log
    ：
#「jevlogstart -cluster [クラスタID]」要求時に，起動対象となるログファイルトラップを指定
#「jevlogstop -cluster [クラスタID]」要求時には，停止対象となる
START_OPT_CLS=(1)<ja_JP.eucJP>KANSI2:-f /etc/〜/jevlog.conf /share/aaa.log
    ：

ログ情報定義ファイル

形式

log-keep ログファイルの個数

log-size ファイルサイズ

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

jevlogd.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥event¥

UNIXの場合

/etc/opt/jp1base/conf/event/

ログ出力先ディレクトリ

Windowsの場合

インストール先フォルダ¥sys¥tmp¥event¥logtrap¥jevtraplog¥jevtraplog.{000|001|002|003|004}※

UNIXの場合

/var/opt/jp1base/sys/tmp/event/logtrap/jevtraplog/jevtraplog.{000|001|002|003|004}※

注※　これらのログファイル数は，log-keepパラメーターで変更できます。

説明

ログファイルトラップ用ログのファイル数およびファイル容量を設定しておくファイルです。ログ情報定義ファイル（jevlogd.conf）は初期設定では提供されません。ファイルが存在しない場合は，初期設定のログファイル数，およびファイル容量が設定されます。必要に応じてログ情報定義ファイル（jevlogd.conf）を作成し，設定を変更してください。

定義の反映時期

ログファイルトラップ管理サービス（デーモン）を起動すると，設定が有効になります。

記述内容

ログ情報定義ファイル（jevlogd.conf）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

パラメーターと値の間は一つ以上の半角スペースまたはタブで区切ります。

1行に1パラメーターを定義します。

各行の先頭パラメーター名の前に，スペースやタブなどは入れられません。

値の後ろと改行の間にはコメントを記入することはできません。

定義内容に誤りがあった場合は，初期設定の値が設定されます。

英字の大文字小文字は区別されます。

log-keep ログファイルの個数

ログファイルトラップ用ログファイル（jevtraplog.*）の保存ファイル数を指定します。log-sizeで指定した容量を超えると切り替わり，ファイル数が最大になると，最も古いファイルを削除します。ログファイルの個数は，0〜50（個）の10進数を指定します。このパラメーターを省略した場合は，初期設定値の5（個）が仮定されます。0を指定するとログを保存しません。

log-size ファイルサイズ

ログファイルトラップ用ログファイル（jevtraplog.*）の最大容量を指定します。ファイルサイズは，65,536〜2,147,483,647（バイト）の10進数を指定します。このパラメーターを省略した場合は，初期設定値の1,000,000（バイト）が仮定されます。

ログ情報は，ログファイルトラップ管理デーモンまたはサービスの起動時およびエラーが発生した場合に出力されます。

定義例

log-keep 5
log-size 65536

イベントログトラップ動作定義ファイル（Windows限定）

形式

server イベントサーバ名

retry-times リトライ回数

retry-interval リトライ間隔

matching-level [0 | 1]

filter-check-level [0 | 1]

ext-attr-option 拡張属性名

unicode-trap [0 | 1]

# フィルター

filter　ログの種別　[id=イベントID]　[trap-name=監視名]

　　条件文1

　　条件文2

　　　：

　　条件文n

end-filter

パラメーターの分類

必須パラメーター

なし

選択パラメーター

matching-level

filter-check-level

unicode-trap

filter

id

trap-name

ファイル名

ntevent.conf

格納先ディレクトリ

インストール先フォルダ¥conf¥event¥

説明

JP1イベントに変換するイベントログの条件や，監視失敗時のリトライなどを設定しておくファイルです。

定義の反映時期

イベントログトラップサービスを起動するか，またはjeveltreloadコマンドを実行してイベントログトラップ動作定義ファイルをリロードすると，設定が有効になります。jeveltreloadコマンドの詳細については，「15.　コマンド」の「jeveltreload（Windows限定）」を参照してください。

記述内容

イベントログトラップ動作定義ファイル（ntevent.conf）は，登録先イベントサーバ名，リトライ設定，および一つ以上のフィルターで構成されます。行頭に「#」を指定すると，改行するまでコメントになります。

server イベントサーバ名

イベントログをJP1イベントに変換して登録するときの登録先イベントサーバ名を255バイト以内で指定します。イベントサーバ名はダブルクォーテーションマーク（"）で囲みます。指定できるイベントサーバは自ホストで稼働しているイベントサーバに限ります。イベントサーバ名を省略した場合，自ホスト名が仮定されます。

retry-times リトライ回数

一時的な通信障害で，イベントサービスへの接続に失敗した場合のリトライ回数を指定します。値は，0〜86,400（回）の10進数で指定します。このパラメーターを省略すると，3回が仮定されます。

retry-interval リトライ間隔

一時的な通信障害で，イベントサービスへの接続に失敗した場合のリトライ間隔を指定します。リトライ回数を1以上に設定した場合に有効となります。リトライ間隔は，イベントサービスへの接続に失敗してから次にイベントサービスへの接続を試みるまでの間隔です。イベントサービスへの接続処理に掛かる時間は含みません。値は，1〜600（秒）の10進数で指定します。このパラメーターを省略すると，10秒が仮定されます。

matching-level [0 | 1]

フィルターにmessage属性を指定した場合に，メッセージDLLが正しく設定されてないなどの理由で，イベントログの説明文の読み込みに失敗したときの，イベントログと定義内容の比較レベルを指定します。0を指定すると，比較しないで次のフィルターと比較をします。1を指定すると，比較をします。このパラメーターを省略すると，0が仮定されます。

filter-check-level [0 | 1]

フィルターに不正な（システムに存在しない）ログの種別や不正な正規表現指定がある場合のチェックレベルを指定します。0を指定すると，フィルターに不正なログの種別や不正な正規表現がある場合，該当するフィルターを無効にします。ただし，有効なフィルターが一つでもある場合，サービスの起動またはリロードは成功します。有効なフィルターが一つもない場合，サービスの起動またはリロードは失敗します。1を指定すると，フィルターに不正なログの種別や不正な正規表現が一つでもある場合，サービスの起動またはリロードは失敗します。このパラメーターを省略すると0が仮定されます。

ext-attr-option 拡張属性名

拡張属性A0〜A6，PLATFORM，PPNAME以外の拡張属性を追加で作成したいときに指定します。

複数の拡張属性を追加で作成するときは，拡張属性名を半角スペースで区切って指定します。拡張属性名の指定順序は任意です。

指定できる拡張属性名を次に示します。

拡張属性名

意味

A7

Windowsログレベル

A8

Windowsログキーワード

A9

Windowsログオペコード

OS_VERSION

Windowsバージョン番号

このパラメーターを省略すると，JP1イベント変換時に上記の拡張属性は作成されません。

上記四つの拡張属性を作成する場合の記述例を次に示します。

ext-attr-option A7 A8 A9 OS_VERSION

unicode-trap [0 | 1]

イベントログトラップのマッチング方式を指定します。

WindowsのイベントログはUnicode形式で出力されますが，JP1/Base自体はUnicodeに対応していません。そのため，イベントログにUnicode固有の環境依存文字がある場合，イベントログトラップの正規表現のミスマッチやイベントログが文字化けしてJP1イベントに登録されることがあります。そのような場合，このパラメーターでイベントログトラップのマッチング方式をUnicode検索に基づくマッチングにすることで，正規表現のミスマッチやイベントログの文字化けが防げます。

0を指定すると，イベントログトラップのマッチング方式が，Windowsのシステムロケールに基づくマッチングになります。イベントログをJP1/Baseが扱える文字コードに変換してマッチングするため，イベントログトラップの正規表現のミスマッチやイベントログが文字化けしてJP1イベントに登録されることがあります。また，JP1イベントを登録する際のコードセットが，既定のコードセットになります。

1を指定すると，イベントログトラップのマッチング方式が，Unicode検索に基づくマッチングになります。イベントログをUnicode形式のまま文字でマッチングすることができ，イベントログが文字化けすることもなくJP1イベントに登録できます。また，JP1イベントを登録する際のコードセットが，UTF-8になります。フィルター条件文の正規表現には，拡張正規表現を適用します。

このパラメーターを省略すると0が仮定されます。

なお，このパラメーターの指定値は，リロード（jeveltreloadコマンド）では変更されません。指定値を変更した場合は，イベントログトラップサービスを再起動してください。

フィルターの文法

フィルターは，JP1イベントに変換するイベントログの条件を指定した「条件文」の集まりです。フィルター内の条件文はAND条件，フィルター間はOR条件です。複数のフィルターを定義した場合は，ファイル内で上位に定義されているフィルターから順に解析され，どれかのフィルターに該当した時点でフィルターが成立します。フィルターは必ず一つ以上指定してください。フィルターの記述形式を次の図に示します。

図16‒8　フィルターの記述形式（イベントログトラップ動作定義ファイル）

ログの種別

監視対象となるログの種別を指定します。ログの種別とは，Windowsの［イベント ビューア］に表示される各ログの名前のことです。ログの種別は「"　"」（ダブルクォーテーションマーク）で囲みます。なお，複数のフィルターで同一のログ種別を指定できます。

指定できるログ種別を次に示します。

Windowsのログ※1※2

"アプリケーション"または"Application"

"セキュリティ"または"Security"

"システム"または"System"

"セットアップ"または"Setup"

アプリケーションとサービスのログ

"DNS Server"

"Directory Service"

"ファイル レプリケーション サービス"または"File Replication Service"

"DFS Replication"※3

"Internet Explorer"

"Key Management Service"

"ハードウェア イベント"または"HardwareEvents"　　ほか※4

注※1

Windowsログの「転送されたイベント」を指定することはできません。

注※2

アプリケーションやシステムイベントログなどに，リモートマシンで発生したイベントログを転送している場合，転送されたイベントログをJP1イベントに正常に変換できません。リモートマシンで発生したイベントログは，発生元マシン上のイベントログトラップで監視対象としてください。

注※3

日本語文字は指定できません。

注※4

フィルターに指定できる「ログの種別」は次の手順で確認してください。条件に当てはまらない場合は，無効な「ログの種別」となります。

MS-DOSプロンプト上でwevtutilコマンドを実行し，システムに登録されている「ログの種別」の一覧を確認する。

コマンドの入力例を次に示します。

>wevtutil el

1.で確認した「ログの種別」の有効・無効の設定および種別を「ログの種別」ごとに確認する。

コマンドの入力例を次に示します。

>wevtutil gl Application

name: Application

enabled: true

type: Admin

:

次の条件をすべて満たす場合だけ，フィルターに指定できます。

・enabledが「true」である

・typeが「Admin」または「Operational」である

[id=イベントID]

イベントサーバにJP1イベントを登録する際のイベントIDを指定します。イベントIDは上位4バイト（基本コード）と下位4バイト（拡張コード）をコロン「:」で区切り，16進数で記述します。A〜Fは大文字で記述してください。なお，下位4バイトまたはコロン以下の下位4バイトは省略できます。この場合，省略値には0を仮定します。また，上位下位とも8桁に満たない場合は前から補われます。ユーザーが指定できる範囲の値，0:0〜1FFF:0および7FFF8000:0〜7FFFFFFF:0を指定してください。なお，拡張コードには0を指定してください。

イベントIDの表記例を次に示します。次に示す3通りの表記は同じ意味になります。

id=0000011A:00000000
id=11A:0
id=11A

「id=」と「イベントID」の間にはスペースまたはタブを入れないでください。また，「ログの種別」，「trap-name=監視名」との間には必ずスペースを入れてください。複数のフィルターで同一のイベントIDを指定できます。このパラメーターを省略すると，イベントID「00003A71」を仮定します。

[trap-name=監視名]

イベントログを変換して登録されたJP1イベントが，どのフィルターに該当したJP1イベントなのかを判別するための監視名を指定します。監視名は30バイト以内で指定してください。使用できる文字は，英数字，ハイフン，およびアンダーラインです。監視名の先頭の文字は，必ず英数字を指定してください。大文字，小文字は区別されます。

「trap-name=」と「監視名」の間にはスペースまたはタブを入れないでください。複数のフィルターで同一の監視名を指定できます。このパラメーターを省略すると，JP1イベント変換時に拡張属性は作成されません。イベントログトラップ動作定義ファイルの初期設定では，このパラメーターの指定はありません。

条件文の書式

条件文には，次の表に示す属性名と，対応するイベントビューアのプロパティの［全般］タブに表示される項目を指定します。

表16‒18　条件文に指定できる属性名

属性名

記述する内容

type

ログの種類を記述します。

イベントビューアのプロパティで表示されるレベルの内容を「表16-19　typeに指定できるログの種類と対応するJP1イベントの重大度」に従って記述します。

「成功の監査」，「失敗の監査」については，イベントビューアのプロパティの「キーワード」に表示されます。

source

イベントビューアのプロパティで表示されるソースの情報に合わせて記述します。

異なっている場合は，記述を変更してください。

category※

イベントビューアのプロパティで表示される分類の情報を記述します。

id

イベントビューアのプロパティで表示されるイベントIDの情報を記述します。

user

イベントビューアのプロパティで表示されるユーザー名を記述します。

message※

イベントビューアのプロパティで表示される説明の情報を記述します。

computer

イベントビューアのプロパティで表示されるコンピュータ名を記述します。

level※

イベントビューアのプロパティで表示されるレベル名を記述します。

keyword※

イベントビューアのプロパティで表示されるキーワード名を記述します。

opcode※

イベントビューアのプロパティで表示されるオペコード名を記述します。

注※

Windowsのイベントログの仕組みに従って，イベントログの説明文を記載したメッセージDLLが正しく設定された状態でご利用ください。メッセージDLLが正しく設定されていないと，イベントログから説明文を読み込めないため，トラップの対象にできないことがあります。なお，メッセージDLLがないメッセージをトラップしたい場合は，matching-levelパラメーターを1に設定してください。

メッセージDLLが正しく設定されていない場合，イベントビューアに「メッセージDLLファイルがない可能性があり，説明が見つからない」という旨の文字列が出力されます。この文字列はイベントビューアが出力している文字列のため，イベントログトラップではトラップできません。

メッセージDLLが存在しない状態でJP1イベントに変換した場合，メッセージとして，イベントビューアで「メッセージDLLファイルがない可能性があり，説明が見つからない」という旨の文字列以降に出力される文字列を「"（ダブルクォーテーション）」で囲んで登録します。この文字列が複数存在する場合には，「,（コンマ）」で区切ります。また，カテゴリーDLLが存在しない状態で変換に失敗した場合には，該当する数値を「（　）」で囲み，カテゴリーとして登録します。

レベル，キーワード，オペコードの変換に失敗した場合も，カテゴリーの変換に失敗した場合と同様に，該当する数値を「（　）」で囲み，登録します。

イベントビューアに「詳細な情報は，http://go.microsoft.com/fwlink/events.aspの[ヘルプとサポート センター]を参照してください。」という内容の文字列が出力されることがあります。この文字列はイベントビューアが出力している文字列のため，イベントログトラップではトラップできません。

イベントログのソース名の先頭にMicrosoft-Windows-が付いていても，イベントビューアには省略されて表示されないことがあります。これはイベントビューアの仕様によるものです。これが原因でイベントビューアに表示されているソース名をsource属性に指定した場合，ソース名が一致しないことがあります。

Microsoft-Windows-が先頭に付いているかどうかは，イベントビューア［全般］タブの「詳細情報」，または［詳細］タブの［System］−［Provider］−［Name］で確認できます。しかし，一部のソース名については，イベントビューアで確認できないソース名もあります。その場合は，イベントログからJP1イベントに変換されたイベントがあれば，登録されたJP1イベントの拡張属性「PRODUCT_NAME」の「/HITACHI/JP1/NTEVENT_LOGTRAP/ソース」のソース部分をソース名として使用してください。または，条件文のソース名を完全一致（"^ソース名$"）や前方一致（"^ソース名"）で指定するのではなく，部分一致（"ソース名"）で指定してください。

記述形式を次に示します。

type　ログの種類1 ログの種類2 ログの種類3・・・

ログの種類を指定します。複数の種類を指定した場合は，どれか一つが一致した場合に条件が成立します。変換後のJP1イベントの重大度は，ログの種類によって決まります。指定できるログの種類と，対応するJP1イベントの重大度を次の表に示します。

表16‒19　typeに指定できるログの種類と対応するJP1イベントの重大度

ログの種類

内容

JP1イベントの重大度

Information

情報

Information

Warning

警告

Warning

Error

エラー

Error

Critical

重大

Critical

Verbose

詳細

Information

Audit_success

成功の監査

Notice

Audit_failure

失敗の監査

Notice

上記以外のログの種類をtypeに指定することはできません。また，上記以外のログの種類のイベントが変換対象となった場合は，JP1イベントの重大度にはInformationが設定されます。

type以外の属性名

属性名　'正規表現1' '正規表現2' '正規表現3'・・・

type以外の属性名では，条件を正規表現で指定します。正規表現は「'　'」で囲んでください。「!」を「'　'」の前に付けた場合，除外条件となり，指定した正規表現に一致しないデータを変換対象とします。

正規表現の中に「'」（シングルクォーテーション）を指定する場合は，「'」の前に「¥」を追加し，「¥'」と指定してください。使用できる正規表現は，OSによって異なります。正規表現の文法の詳細については，「付録F　正規表現の文法」を参照してください。

unicode-trapパラメーターに1を指定している場合は，条件文に拡張した正規表現を指定してください。正規表現の拡張については，「3.4.5　使用する正規表現を拡張する」を参照してください。

なお，イベントログのメッセージに改行文字が含まれる場合，filter文内の指定はAND条件になるため，改行文字を含まないで分割して指定することを推奨します。

運用上，改行文字を正規表現として指定する必要がある場合は，次のことに注意して指定してください。

改行文字は，出力するアプリケーションによって異なります。「¥n」の場合は「¥n」で指定し，「¥r¥n」の場合は「.¥n」と指定してください。なお，改行文字が，どちらのコードか見た目ではわかりません。アプリケーションの開発元に確認するか，実際に動作確認した上で監視を開始してください。

注意事項

リトライ回数とリトライ間隔の組み合わせによっては，24時間以上のリトライ処理ができますが，リトライ処理が24時間を超えた場合，リトライ処理は打ち切られ，イベントログトラップサービスは停止します。

Windowsのメディアセンス機能によってサービスが停止する現象を回避するためには，リトライ機能を使用してください。

filter-check-levelの指定が0（または指定なし）で，フィルターが無効となった場合，KAVA3025-Wまたは，KAVA3026-Wのメッセージがイベントログ，統合トレースログ（リロード時は標準エラー出力だけ）に出力されます。ただし，これらのメッセージは10件出力した時点で打ち切りとなります。

filter-check-levelの指定が0（または指定なし）で，有効なフィルターが存在しなかった場合，KAVA3027-E（リロード時は，KAVA3028-E）のメッセージがイベントログ，統合トレースログ（リロード時は，イベントログ，統合トレースログ，標準エラー出力）に出力されます。

ファイル名「ntevent2.conf」は予約された名称となります。定義ファイルをバックアップする際，この名称を使用しないでください。

unicode-trapの指定が1で，コードセットがUTF-8のJP1イベントが登録された場合，そのJP1イベントの転送先ホストのJP1/Baseは，バージョン8以降にしてください。

JP1/Base 11-00以降では，trap-intervalパラメーターおよびjp1event-sendパラメーターの設定が不要になりました。なお，これらのパラメーターを設定していてもJP1/Baseの運用に影響ありません。

JP1/Base 11-00以降では，retry-timesパラメーターを省略した場合の仮定値を0から3に変更しました。

標準提供のイベントログトラップ動作定義ファイル

標準提供のイベントログトラップ動作定義ファイル（ntevent.conf）では，イベントサービスへ接続できなかった場合に10秒間隔で3回リトライを行います。また，JP1イベントに変換するログの条件として，「システムログ」の「警告」と「エラー」，および「アプリケーションログ」の「警告」と「エラー」がJP1イベントに変換されるように定義されています。標準提供の指定を次に示します。

retry-times 3
retry-interval 10

filter "System"
    type Warning Error
end-filter

filter "Application"
    type Warning Error
end-filter

なお，このイベントログトラップ動作定義ファイル（ntevent.conf）および転送設定ファイル（forward）を初期設定で使用した場合，JP1イベントの転送に失敗するとKAJP1037-Eのメッセージがイベントログに出力され，JP1イベントに変換されます。変換されたJP1イベントは再度転送され，転送の失敗が繰り返されます。

この転送の繰り返しを回避するためには，KAJP1037-Eのメッセージをトラップしないように動作定義ファイルの設定を変更してください。設定例を次に示します。

retry-times 3
retry-interval 10

filter "System"
type Warning Error
end-filter

#重要度が[Error][Warning]で，かつソースが[JP1/Base Event]
#以外のイベントログをトラップする。
filter "Application"
    type Warning Error
    source !'JP1/Base Event'
end-filter

#重要度が[Error][Warning]で，かつソースが[JP1/Base Event]
#で，かつイベントIDが[1037]以外のイベントログをトラップする。
filter "Application"
    type Warning Error
    source 'JP1/Base Event'
    id !'1037'
end-filter

フィルターの定義例

定義例1：OR条件とAND条件

OR条件の定義例

ログの種別が「システムログ」で，説明に「TEXT」，「MSG」，または「-W」のどれかを含む。

filter "System"
    message 'TEXT' 'MSG' '-W'
end-filter

条件をスペースまたはタブで区切って指定すると，OR条件になります。

AND条件の定義例

ログの種類が「システムログ」で，説明に「TEXT」，「MSG」，および「-W」をすべて含む。

filter "System"
    message 'TEXT'
    message 'MSG'
    message '-W'
end-filter

条件を改行で区切って指定すると，AND条件になります。改行した場合は，属性名から記述してください。

定義例2：複数のフィルターを設定する

ログの種別が「アプリケーションログ」のイベントログのうち，次に示す条件のイベントログをトラップする。

フィルター1

種別：アプリケーションログ

種類：エラー

説明：「-E」および「JP1/Base」を含む。

フィルター2

種別：アプリケーションログ

種類：警告

説明：「-W」または「warning」を含む。

#フィルター1
filter "Application"
    type Error
    message '-E'
    message 'JP1/Base'
end-filter
#フィルター2
filter "Application"
    type Warning
    message '-W' 'warning'
end-filter

定義例3：正規表現を使用する

次に示す条件のイベントログをトラップする。

種別：アプリケーションログ

種類：エラー

イベントID：111

説明：「-E」または「MSG」を含み，かつ「TEXT」を含まない。

filter "Application"
    type Error
    id '^111$'
    message '-E' 'MSG'
    message !'TEXT'
end-filter

「111」のイベントIDを条件にしたい場合は，正規表現を使用して，「id '^111$'」と指定してください。「id '111'」と指定すると，「イベントIDに111を含む」という条件になるため，イベントIDが「1112」や「0111」でも条件が成立します。「!」を「'　'」の手前に付けた場合は，指定した正規表現に一致しないデータを選択します。正規表現の詳細については，「付録F　正規表現の文法」を参照してください。

定義例4：特定のイベントログだけ変換しない

ログの種別が「システムログ」で，ログの種類が「警告」のイベントログのうち，次に示す条件のイベントログだけトラップしない。

ソース：AAA

イベントID：111

説明：「TEXT」を含む。

#ソースがAAAのイベントログはトラップしない。
filter "System"
    type Warning
    source !'AAA'
end-filter
#ソースがAAA，かつイベントIDが111以外のイベントログをトラップする。
filter "System"
    type Warning
    source 'AAA'
    id !'^111$'
end-filter
#ソースがAAA，イベントIDが111，かつ説明に「TEXT」を含まないイベントログをトラップする。
filter "System"
    type Warning
    source 'AAA'
    id '^111$'
    message !'TEXT'
end-filter

定義例5：JP1イベントのイベントIDと監視名を指定する

フィルター1の条件に合致する場合，イベントIDが「0000111A」でJP1_TRAP_NAME属性に「Action-1」の値が入ったJP1イベントに変換する。

フィルター2の条件に合致する場合，イベントIDが「0000111B」でJP1_TRAP_NAME属性に「Action-2」の値が入ったJP1イベントに変換する。

フィルター1

種別：アプリケーションログ

種類：エラー

フィルター2

種別：アプリケーションログ

種類：警告

#フィルター1
filter "Application"　id=111A　trap-name=Action-1
    type Error
end-filter
#フィルター2
filter "Application"　id=111B　trap-name=Action-2
    type Warning
end-filter

配布定義ファイル

形式

[配布先ホスト,...]

定義情報

[&配布先ホスト,...]

定義情報

[配布先ホスト,...]@動作定義ファイル名

定義情報

　　　：

パラメーターの分類

必須パラメーター

なし

選択パラメーター

配布先ホスト

定義情報

@動作定義ファイル名

ファイル名

表16‒20　配布定義ファイルのファイル名

配布対象の定義ファイル

配布定義ファイルのファイル名

転送設定ファイル

[jev_forward.conf | 任意のファイル]

ログファイルトラップ動作定義ファイル

[jev_logtrap.conf | 任意のファイル]

ログファイルトラップ起動定義ファイル

[jev_logstart.conf | 任意のファイル]

イベントログトラップ動作定義ファイル

[jev_ntevent.conf | 任意のファイル]

格納先ディレクトリ

表16‒21　配布定義ファイルの格納先（Windowsの場合）

配布対象の定義ファイル

配布定義ファイルの格納先

転送設定ファイル

Eventフォルダ※¥

ログファイルトラップ動作定義ファイル

インストール先フォルダ¥conf¥

ログファイルトラップ起動定義ファイル

インストール先フォルダ¥conf¥event¥

イベントログトラップ動作定義ファイル

インストール先フォルダ¥conf¥event¥

注※　「Eventフォルダ」の部分は，次のフォルダに置き換えてください。

インストール先フォルダ¥conf¥event¥servers¥default

共有フォルダ¥jp1base¥event（クラスタ運用時）

表16‒22　配布定義ファイルの格納先（UNIXの場合）

配布対象の定義ファイル

配布定義ファイルの格納先

転送設定ファイル

Eventディレクトリ※/

ログファイルトラップ動作定義ファイル

/etc/opt/jp1base/conf/

ログファイルトラップ起動定義ファイル

/etc/opt/jp1base/conf/event/

イベントログトラップ動作定義ファイル

/etc/opt/jp1base/conf/event/

注※　「Eventディレクトリ」の部分は，次のディレクトリに置き換えてください。

/etc/opt/jp1base/conf/event/servers/default

共有ディレクトリ/event（クラスタ運用時）

説明

配布したい定義情報と，配布先ホストを設定しておくファイルです。配布定義ファイルは，配布対象の定義ファイルごとに作成する必要があります。標準の名称または任意のファイル名で，格納先に作成してください。

定義の反映時期

jevdef_distribコマンドを実行すると定義情報が配布され，設定が反映されます。jevdef_distribコマンドの詳細については，「15.　コマンド」の「jevdef_distrib」を参照してください。

記述内容

配布定義ファイルには，次に示す規則があります。

最初の「[　]」より前は，すべてコメント行になります。「[　]」以降は，定義情報と判断されます。

コメント行「#」を指定した場合は，コメント行も配布されます。

各行の最後には，必ず改行を入れてください。

[配布先ホスト]

JP1/IM - Managerのシステム構成で定義してあり，かつ，07-00以降のJP1/Baseがインストールされたホストのホスト名を指定します。

複数のホストに同じ定義情報を配布したい場合は，「[　]」内に，複数の配布先ホストを「,」で区切って指定します。

一つのホスト名に指定できる文字数は，255バイト以内です。

1行の最大長は1,023バイトです。

&

ホスト名の前に&を指定すると，構成定義情報でそのホストの下位1階層に定義された全ホストに対して定義情報が配布されます。構成定義情報で最下位に定義されたホストに対して「&」を指定しても，対象ホストがないため無視されます。「[　]」内には，&を指定したホストと，&を指定していないホストを混在して記述できます。

@動作定義ファイル名

ログファイルトラップ動作定義ファイルの定義情報を配布する場合だけ，任意のファイル名または相対パスで指定します。定義情報は，配布先ホストの次に示すフォルダの配下に指定されたファイル名または相対パスで配布されます。

Windowsの場合：インストール先フォルダ¥conf¥

UNIXの場合：/etc/opt/jp1base/conf/

上記のフォルダを含むフルパス名が256バイト以内になるように指定してください。

なお，指定する動作定義ファイル名には，: , ; * ? " < > | とタブ・スペースは使用できません。また，上位階層を示す「..¥」は使用できません。

このパラメーターを省略すると動作定義ファイル名としてjevlog.confが仮定されます。

「[　]」のあとに「@動作定義ファイル名」を指定すると，定義情報が「[　]」内に指定されたすべてのホストに，指定されたファイル名または相対パスで配布されます。

定義情報

各ホストに配布する定義情報を定義します。定義情報の形式は，各定義ファイルの形式と同じです。詳細については下記を参照してください。

「転送設定ファイル」のファイル形式

「ログファイルトラップ動作定義ファイル」のファイル形式

注　ファイル属性に関するパラメーター（FILETYPE，HEADLINE，HEADSIZE，およびRECTYPE）は変更しないでください。

「イベントログトラップ動作定義ファイル（Windows限定）」のファイル形式

定義例

次に示すシステムで，定義情報を一括して配布する場合の配布定義ファイルの定義例を示します。

図16‒9　システムの構成例

上記のシステム構成例のManagerHostは，統合マネージャーです。SubHostA，SubHostB，SubHostCは，ManagerHostの管理対象ホスト，JP1host_1，JP1host_2は，SubHostAの管理対象ホストとしてJP1/IM - Managerのシステム構成で定義されています。システム構成の定義については，マニュアル「JP1/Integrated Management 3 - Manager 構築ガイド」を参照してください。

ManagerHostから管理対象ホストへ転送設定ファイル（forward）の定義情報を配布する場合の配布定義ファイルの定義例を次に示します。

#------------------------------------------
# JP1/Base - Event Server jev_forward.conf
#------------------------------------------

[SubHostA, SubHostB, SubHostC]
#-------------------------------------------
# JP1/Base - Event Server Forwarding Setting
#-------------------------------------------
to ManagerHost
E.SEVERITY IN Error
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
end-to

[JP1host_1，JP1host_2]
#-------------------------------------------
# JP1/Base - Event Server Forwarding Setting
#-------------------------------------------
to SubHostA
E.SEVERITY IN Error Warning
OR
E.PRODUCT_NAME IN /HITACHI/JP1/NT_LOGTRAP
end-to

次に，ログファイルトラップ動作定義ファイルの定義情報を配布する場合の設定例について説明します。ここでは，ManagerHostからSubHostA，SubHostBに「ACTDEF1」というファイル名で定義情報を配布し，SubHostCに「ACTDEF2」というファイル名で定義情報を配布します。

ログファイルトラップ動作定義ファイルの定義情報を配布する場合の配布定義ファイル（jev_logtrap.conf）の定義例を次に示します。

#------------------------------------------
# JP1/Base - Event Server jev_logtrap.conf
#------------------------------------------

[SubHostA,SubHostB]@ACTDEF1
FILETYPE=SEQ
RECTYPE =VAR '¥n'
HEADLINE=3
MARKSTR ="====="
         "MARK"
ACTDEF  =00000111:00000000  "message"
[SubHostC]@ACTDEF2
FILETYPE=SEQ
RECTYPE =VAR '¥n'
HEADLINE=3
MARKSTR ="====="
         "MARK"
ACTDEF  =00000222:00000000  "error"

パスワード定義ファイル（Windows限定）

形式

; コメント

OSユーザー名または情報検索用ユーザー名:パスワード

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

任意

格納先ディレクトリ

任意

説明

複数のOSユーザーまたは情報検索用ユーザーのパスワード管理情報を一括して設定しておくファイルです。

定義の反映時期

jbsmkpassコマンドを実行すると，設定が有効になります。jbsmkpassコマンドの詳細については，「15.　コマンド」の「jbsmkpass（Windows限定）」を参照してください。

記述内容

一つのエントリーに対して1行の形式で表します。各行に記述できる文字数は，4,096バイト以内です。「;」以降は改行されるまでコメントになります。一つのエントリーは，「:」で区切られた二つのフィールドで構成されます。各フィールドに記述する内容を次に示します。

OSユーザー名または情報検索用ユーザー名

各ホストに登録されているOSユーザー名または情報検索用ユーザー名を指定します。

なお，登録するOSユーザー名には，ユーザー名だけでなく，自ホストが所属するドメイン名やローカルホスト名も記述できます。ドメイン名やローカルホスト名を記述する場合，「domain¥user1」，「server¥user1」のように，ドメイン名やローカルホスト名とユーザー名の区切り文字として「¥」を使用します。ドメイン名を記述した場合，登録するOSユーザーがドメイン上のユーザーであるかどうかチェックされます。ドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。ローカルホスト名を記述した場合，登録するOSユーザーがローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，そのOSユーザー名では登録できません。

ドメイン名やローカルホスト名を記述しなかった場合，登録するOSユーザー名がローカルユーザーであるかどうかチェックされます。ローカルユーザーでなかった場合，信頼するドメインを含むドメイン上のユーザーであるかどうかチェックされます。ローカルユーザーおよびドメイン上のユーザーでなかった場合，そのOSユーザー名では登録できません。

なお，Windowsのドメインコントローラー上で登録する場合は，「ドメイン名¥ユーザー名」の形式で記述してください。ドメインコントローラー上ではドメインユーザーとローカルユーザーの区別がないため，ドメインユーザーとして扱われるためです。

また，情報検索用ユーザーを登録する場合は，「aduser/情報検索用ユーザーとして使用するOSユーザー名」の形式で記述してください。

パスワード

OSユーザーまたは情報検索用ユーザーのパスワードを指定します。パスワードを省略した場合は，パスワードなしのOSユーザーまたは情報検索用ユーザーと見なしてパスワード管理情報に登録します。

注意事項

［JP1/Base環境設定］ダイアログボックスの［ユーザーマッピング］タブで，［OSユーザー設定時にWindowsに対してログオンチェックを行わない］をチェックした場合，OSユーザー名やOSユーザーのパスワードが誤っていても，パスワード管理情報に登録できます。ただし，実際にジョブやリモートコマンドを実行するときに権限エラーとなってしまうので，注意が必要です。

定義例

jp1user1:passwd000

ユーザー権限レベルファイル

形式

; コメント

JP1ユーザー:JP1資源グループ=JP1権限レベル:JP1資源グループ=JP1権限レベル:・・・

パラメーターの分類

必須パラメーター

なし

選択パラメーター

JP1ユーザー

JP1資源グループ

JP1権限レベル

ファイル名

JP1_UserLevel

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥user_acl¥

共有フォルダ¥jp1base¥conf¥user_acl¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/user_acl/

共有ディレクトリ/jp1base/conf/user_acl/（クラスタ運用時）

説明

JP1ユーザーのJP1資源グループに対する操作権限を設定しておくファイルです。

定義の反映時期

jbsaclreloadコマンドを実行すると，設定が有効になります。jbsaclreloadコマンドの詳細については，「15.　コマンド」の「jbsaclreload」を参照してください。

記述内容

登録または変更したいJP1ユーザーのJP1資源グループに対するJP1権限レベルの割り当ては，一つのエントリーに対して1行の形式で表します。各行に記述できる文字数は，4,096バイト以内です。「;」以降は改行されるまでコメントになります。一つのエントリーは，「:」で区切られた二つ以上のフィールドで構成されます。各フィールドに記述する内容を次に示します。

JP1ユーザー

認証サーバに登録したJP1ユーザー名を指定します。JP1ユーザー名には，小文字しか使用できません。指定できる文字数は，1〜31（バイト）です。

JP1資源グループ=JP1権限レベル

JP1資源グループとJP1権限レベル（JP1ユーザーの操作権限）を指定します。JP1資源グループに指定できるバイト数は，64バイト以内です。

一つのJP1資源グループに対して，複数のJP1権限レベルを「,」で区切って，JP1_AJS_Admin,JP1_JPQ_Admin,JP1_Console_Adminのように指定できます。

JP1資源グループとJP1権限レベルについて次に説明します。

JP1資源グループ

JP1資源グループとは，ジョブ，ジョブネット，イベントなどの管理対象（資源）を幾つかに分けたグループのことです。指定するJP1資源グループについては，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。「*」を指定すると，すべてのJP1資源グループにアクセスできるようになります。なお，「*」を指定したJP1ユーザーに，「*」以外のJP1資源グループは設定できません。

JP1権限レベル

JP1権限レベルとは，管理対象（資源）に対してJP1ユーザーがどのような操作権限を持っているかを表しています。ジョブ，ジョブネット，イベントなどの管理対象（資源）の種類に応じて，操作項目を定めています。管理対象（資源）の種類と，それに対する操作項目の幾つかを組み合わせた形式でJP1ユーザーの操作権限を管理します。

JP1権限レベルには，JP1_AJS_Admin，JP1_JPQ_Admin，JP1_Console_Adminなどがあります。指定するJP1権限レベルについては，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。

注意事項

ユーザー権限レベルファイル（JP1_UserLevel）は，GUIでも利用しています。GUIで設定した内容は，このファイルに反映されます。

各行の最後には，必ず改行（Windowsの場合は「CR」（0x0d）および「LF」（0x0a），UNIXの場合は「LF」（0x0a）を入れてください。

定義例

jp1admin:*=JP1_AJS_Admin,JP1_JPQ_Admin,JP1_Console_Admin

ユーザー権限定義ファイル

形式（JP1ユーザーを指定する場合）

; コメント

JP1ユーザー:JP1資源グループ=JP1権限レベル:JP1資源グループ=JP1権限レベル:・・・

形式（DSグループを指定する場合）

; コメント

[DSグループ名]:JP1資源グループ=JP1権限レベル:JP1資源グループ=JP1権限レベル:・・・

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

任意

格納先ディレクトリ

任意

説明

JP1ユーザーまたはDSグループのJP1資源グループに対する操作権限を定義するファイルです。JP1ユーザーは標準ユーザー，連携ユーザー，およびDSユーザーが該当します。jbssetaclコマンドの-fオプションにこの定義ファイルを指定します。

定義の反映時期

jbssetaclコマンドの-fオプションにこの定義ファイルを指定して実行すると認証サーバまたはディレクトリサーバに設定が反映されます。DSユーザーまたはDSグループの操作権限変更時は，JP1/Baseの再起動またはリロードコマンド（jbsaclreload）の実行が必要です。

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

記述内容

登録または変更したいJP1ユーザーまたはDSグループのJP1資源グループに対するJP1権限レベルの割り当ては，一つのエントリーに対して1行の形式で表します。各行に記述できる文字数は，4,096バイト以内です。「;」以降は改行されるまでコメントになります。一つのエントリーは，「:」で区切られた二つ以上のフィールドで構成されます。各フィールドに記述する内容を次に示します。

JP1ユーザー

JP1ユーザー名を指定します。JP1ユーザー名には，小文字しか使用できません。指定できる文字数は，1〜31（バイト）です。JP1ユーザーに使用できる文字は，* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < >とスペース，タブを除くASCII文字だけです。

[DSグループ名]

ディレクトリサーバのセキュリティグループ名を指定します。

DSユーザーを使用する運用の場合だけ指定できます。

指定できる文字数は，1〜256（バイト）です。また，DSグループ名に使用できる文字は，* / ¥ " ' ^ [ ] { } ( ) : ; | = , + ? < >とタブを除くASCII文字だけです。

JP1資源グループ=JP1権限レベル

JP1資源グループとJP1権限レベル（JP1ユーザーまたはDSグループの操作権限）を指定します。JP1資源グループに指定できるバイト数は，64バイト以内です。

一つのJP1資源グループに対して，複数のJP1権限レベルを「,」で区切って，JP1_AJS_Admin,JP1_JPQ_Admin,JP1_Console_Adminのように指定できます。

JP1資源グループとJP1権限レベルについて次に説明します。

JP1資源グループ

JP1資源グループとは，ジョブ，ジョブネット，イベントなどの管理対象（資源）を幾つかに分けたグループのことです。指定するJP1資源グループについては，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。「*」を指定すると，すべてのJP1資源グループにアクセスできるようになります。なお，「*」を指定したJP1ユーザーまたはDSグループに，「*」以外のJP1資源グループは設定できません。

JP1権限レベル

JP1権限レベルとは，管理対象（資源）に対してJP1ユーザーまたはDSグループがどのような操作権限を持っているかを表しています。ジョブ，ジョブネット，イベントなどの管理対象（資源）の種類に応じて，操作項目を定めています。管理対象（資源）の種類と，それに対する操作項目の幾つかを組み合わせた形式でJP1ユーザーまたはDSグループの操作権限を管理します。

JP1権限レベルには，JP1_AJS_Admin，JP1_JPQ_Admin，JP1_Console_Adminなどがあります。指定するJP1権限レベルについては，JP1/Baseのユーザー認証を利用するJP1製品の各マニュアルで確認してください。

注意事項

JP1操作権限が不要でログイン認証だけ必要なJP1ユーザー（DSユーザー）をActive Directoryに登録する場合でも，JP1操作権限属性に設定が必要になります。その場合は，JP1操作権限が不要なことを表す文字列としてnoneを設定してください。定義例（JP1ユーザー名が「jp1userx」）を次に示します。

jp1userx:*=none

定義例

JP1ユーザー名「jp1admin」のJP1資源グループとJP1権限レベルを定義する場合

jp1admin:*=JP1_AJS_Admin,JP1_JPQ_Admin,JP1_Console_Admin

DSグループ名「GRP-Adm」のJP1資源グループとJP1権限レベルを定義する場合

[GRP-Adm]:*=JP1_AJS_Admin,JP1_JPQ_Admin,JP1_Console_Admin

ディレクトリサーバ変更ファイル（Windows限定）

形式

"SERVER"=ディレクトリサーバ名またはドメイン名

"PORT"=接続先ポート番号

"SEARCH_USER_DN"=情報検索用ユーザー識別名

"BASE_DN"=コンテナオブジェクト識別名※

"ATTR_NAME"=相対識別名または属性名

"SSL"=dword:{00000000 | 00000001}

"AREC_EXCLUSIVE"=dword:{00000000 | 00000001}

注※

BASE_DNパラメーターは，連携ユーザーを使用する運用の場合だけ指定できます。

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

任意

格納先ディレクトリ

任意

説明

連携したディレクトリサーバが障害などで使用できなくなった場合，一時的に変更するための共通定義情報を設定しておくファイルです。

定義の反映時期

jbschgdsコマンドを実行すると，ディレクトリサーバ変更ファイルの設定が共通定義情報に反映されます。また，一時的な変更の解除も，jbschgdsコマンドを使用します。jbschgdsコマンドの詳細については，「15.　コマンド」の「jbschgds（Windows限定）」を参照してください。

定義内容が有効になる契機を次に示します。

連携ユーザーを使用する運用の場合

ログイン認証時に有効になります。

DSユーザーを使用する運用の場合

JP1/Base（認証サーバ）の起動時に有効になります。JP1/Base起動後にディレクトリサーバ連携定義を変更した場合は，JP1/Baseの再起動またはリロードコマンド（jbs_spmd_reload）の実行が必要です。

記述内容

ディレクトリサーバ変更ファイルの記述内容は，「ディレクトリサーバ連携定義ファイル（Windows限定）」を参照してください。ただし，ENABLEは指定しないでください。

定義例

"SERVER"="host-B.domain.local"
"PORT"=dword:0000027C
"SEARCH_USER_DN"="CN=Groupcsearcher,OU=GroupC,DC=domain,DC=local"
"BASE_DN"="OU=JP1,DC=domain,DC=local"
"ATTR_NAME"="CN"
"SSL"=dword:00000001

ディレクトリサーバ連携定義ファイル（Windows限定）

形式

[JP1_DEFAULT¥JP1BASE¥DIRSRV]

"ENABLE"=dword:{00000000 | 00000001 | 00000002}

"SERVER"=ディレクトリサーバ名またはドメイン名

"PORT"=接続先ポート番号

"SEARCH_USER_DN"=情報検索用ユーザー識別名

"BASE_DN"=コンテナオブジェクト識別名※

"ATTR_NAME"=相対識別名または属性名

"SSL"=dword:{00000000 | 00000001}

"AREC_EXCLUSIVE"=dword:{00000000 | 00000001}

注※

BASE_DNパラメーターは，連携ユーザーを使用する運用の場合だけ指定できます。

パラメーターの分類

必須パラメーター

なし

選択パラメーター

ENABLE

SERVER

SEARCH_USER_DN

BASE_DN

ATTR_NAME

SSL

ファイル名

jp1bs_ds_setup.conf（ディレクトリサーバ連携定義ファイル）

jp1bs_ds_setup.conf.model（ディレクトリサーバ連携定義ファイルのモデルファイル）

格納先ディレクトリ

インストール先フォルダ¥conf¥ds¥

共有フォルダ¥jp1base¥conf¥ds¥（クラスタ運用時）

説明

ディレクトリサーバと連携してユーザー認証をするため，認証サーバで共通定義情報を設定しておくファイルです。セカンダリー認証サーバを設置している場合は，プライマリー認証サーバおよびセカンダリー認証サーバの両方に設定してください。

定義の反映時期

jbssetcnfコマンドを実行すると，ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）の設定が共通定義情報に反映されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

定義内容が有効になる契機を次に示します。

連携ユーザーを使用する運用の場合

ログイン認証時に有効になります。

DSユーザーを使用する運用の場合

JP1/Base（認証サーバ）の起動時に有効になります。JP1/Base起動後にディレクトリサーバ連携定義を変更した場合は，JP1/Baseの再起動またはリロードコマンド（jbs_spmd_reload）の実行が必要です。

記述内容

ディレクトリサーバ連携定義ファイル（jp1bs_ds_setup.conf）には，次のパラメーターを定義します。

ENABLE（省略できる）

ディレクトリサーバと連携するかどうかを指定します。ディレクトリサーバと連携しない場合は，00000000を指定します。連携ユーザーを使用してディレクトリサーバと連携する場合は，00000001を指定します。DSユーザーを使用してディレクトリサーバと連携する場合は，00000002を指定します。共通定義情報に設定していない場合は，00000000が仮定されます。

SERVER

連携ユーザーを使用してディレクトリサーバと連携する場合は，ディレクトリサーバ名またはドメイン名を指定します。

DSユーザーを使用してディレクトリサーバと連携する場合は，ドメイン名を指定します。

連携するディレクトリサーバまたはドメイン名の名前解決は，jp1hosts情報およびjp1hosts2情報ではできません。そのため，連携するディレクトリサーバまたはドメイン名は，OSのhostsファイルなどで名前解決できるように設定してください。

SSLを使用する場合はFQDN形式で指定してください。指定できる文字数は，1〜255（バイト）です。

メモ

このパラメータにドメインコントーラーのホスト名は一つしか定義できません。

ただし，ドメイン配下に複数台のドメインコントローラーがある場合，このパラメータにドメイン名を指定することで複数台のドメインコントローラーを参照することができます。

PORT（省略できる）

通常時に使用するディレクトリサーバの接続先ポート番号を16進数で指定します。指定できる範囲は，00000001〜0000ffffです。

共通定義情報に設定していない場合，次のポート番号が仮定されます。

SSLを使用しないとき：389（00000185）

SSLを使用するとき：636（0000027C）

SEARCH_USER_DN

ディレクトリサーバにアクセスする情報検索用ユーザーの識別名を指定します。指定できる文字数は，1〜4,095（バイト）です。連携ユーザーを使用する運用の場合，情報検索用ユーザーは，検索起点となるコンテナオブジェクトおよびその配下のコンテナオブジェクトに対して，参照権限があるディレクトリサーバのユーザーになります。DSユーザーを使用する運用の場合はユーザーまたはグループのJP1 操作権限へ書き込み権限があるユーザーを指定してください。このパラメーターを無効にする場合は，"SEARCH_USER_DN"=""と定義してください。

連携ユーザーを使用する運用でディレクトリサーバ連携拡張機能を使用する場合，またはDSユーザーを使用する運用の場合，このパラメーターを必ず定義してください。

BASE_DN

このパラメーターは，連携ユーザーを使用する運用の場合だけ有効です。

JP1ユーザーが存在するコンテナオブジェクトの識別名を指定します。指定できる文字数は，1〜4,095（バイト）です。

SEARCH_USER_DNパラメーターを指定した場合，このパラメーターで指定したコンテナオブジェクト配下のJP1ユーザーと連携できるようになります。

ATTR_NAME

JP1ユーザー名およびDSグループ名として使用する相対識別名の属性名を指定します。指定できる文字数は，1〜255（バイト）です。

SEARCH_USER_DNパラメーターを指定した場合，JP1ユーザー名として使用する属性名を，次の属性から指定できるようになります。ただし，UserPrincipalNameを指定した場合，DSグループ名にはsAMAccountNameが仮定されますので，ドメイン内で区別できる一意となる名称を設定してください。

CN

sAMAccountName

UserPrincipalName

CNを使用する場合の注意事項

ディレクトリサーバ連携拡張機能を使用する場合，BASE_DNパラメーターに指定したコンテナオブジェクト配下のOSユーザー（JP1ユーザーと連携するOSユーザー）のCN属性値は，一意になるように設定してください。

SSL（省略できる）

SSLを使用するかどうかを指定します。SSLを使用しない場合は，00000000を指定します。SSLを使用する場合は，00000001を指定します。共通定義情報に設定していない場合は，00000001が仮定されます。

AREC_EXCLUSIVE（省略できる）

連携ユーザーを使用する運用の場合，SERVERパラメーターに指定したディレクトリサーバへの接続動作を指定します。接続時に通常の名前解決を行う場合は，00000000を指定します。名前解決を簡略する場合は，00000001を指定します。共通定義情報に設定していない場合は，00000000が仮定されます。ディレクトリサーバの名前解決に時間がかかる場合には，00000001を指定します。

注意事項

論理ホスト上で設定する場合は，実行系および待機系の両方で設定します。その際，[JP1_DEFAULT¥JP1BASE]のJP1_DEFAULTを論理ホスト名に変更してください。

定義例

次に示すディレクトリサーバの構成で，ディレクトリサーバと連携してユーザー認証する場合の定義例を示します。

図16‒10　ディレクトリサーバの構成例（OU=JP1のコンテナオブジェクトをディレクトリサーバ連携の対象とする場合）

[JP1_DEFAULT¥JP1BASE¥DIRSRV]
"ENABLE"=dword:00000001
"SERVER"="host-A.domain.local"
"PORT"=dword:0000027C
"SEARCH_USER_DN"="CN=Groupcsearcher,OU=GroupC,DC=domain,DC=local"
"BASE_DN"="OU=JP1,DC=domain,DC=local"
"ATTR_NAME"="CN"
"SSL"=dword:00000001

図16‒11　ディレクトリサーバの構成例（OU=GroupCおよびその配下のコンテナオブジェクトをディレクトリサーバ連携の対象とする場合）

[JP1_DEFAULT¥JP1BASE¥DIRSRV]
"ENABLE"=dword:00000001
"SERVER"="host-A.domain.local"
"PORT"=dword:0000027C
"SEARCH_USER_DN"="CN=Groupcsearcher,OU=GroupC,DC=domain,DC=local"
"BASE_DN"="OU=GroupC,DC=domain,DC=local"
"ATTR_NAME"="sAMAccountName"
"SSL"=dword:00000001

ユーザーマッピング定義ファイル

形式

; コメント

JP1ユーザー名:サーバホスト名:ユーザーリスト

パラメーターの分類

必須パラメーター

なし

選択パラメーター

JP1ユーザー名

サーバホスト名

ユーザーリスト

ファイル名

jp1BsUmap.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥user_acl¥

共有フォルダ¥jp1base¥conf¥user_acl¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/user_acl/

共有ディレクトリ/jp1base/conf/user_acl/（クラスタ運用時）

説明

複数のJP1ユーザーのユーザーマッピング情報を一括して設定しておくファイルです。

定義の反映時期

jbsmkumapコマンドまたはjbssetumapコマンドを実行すると，設定が有効になります。jbsmkumapコマンドおよびjbssetumapコマンドの詳細については，「15.　コマンド」の「jbsmkumap」，「jbssetumap」を参照してください。

記述内容

一つのエントリーに対して1行の形式で表します。各行に記述できる文字数は，4,096バイト以内です。「;」以降は改行されるまでコメントになります。一つのエントリーは，「:」で区切られた三つのフィールドで構成されます。各フィールドに記述する内容を次に示します。

JP1ユーザー名

認証サーバに登録したJP1ユーザー名を指定します。JP1ユーザー名には，小文字しか使用できません。指定できる文字数は，1〜31（バイト）です。「*」を指定すると，認証サーバに登録されたすべてのJP1ユーザーにユーザーリストで指定したユーザーの権限が与えられます。複数のエントリーを記述する場合，同じサーバホストに対して，JP1ユーザー名には「*」と「認証サーバに登録した任意のJP1ユーザー名」を混合して指定できます。ただし，「*」は一つしか指定できません。

サーバホスト名

操作命令を出すサーバホスト名を指定します。指定できる文字数は，255バイト以内です。「*」を指定すると，すべてのサーバホストからの操作が有効になります。

サーバホストが物理ホストの場合

サーバホスト名には，hostnameコマンドで表示されるホスト名を指定してください。ただし，DNS運用でドメイン名を使用している場合は，FQDN形式のホスト名の定義も追加してください。

サーバホストが論理ホストの場合

サーバホスト名には，論理ホスト名を指定してください。ただし，jp1hosts情報またはjp1hosts2情報に論理ホストを定義しないで，DNS運用でドメイン名を使用している場合は，FQDN形式の論理ホスト名の定義も追加してください。

なお，JP1/AJS - Viewからログインする場合，および自ホストに対してJP1/AJSのコマンドを実行する場合，自ホスト名をサーバホスト名として設定する必要があります。詳細については，マニュアル「JP1/Automatic Job Management System 3 設計ガイド（システム構築編）」，「JP1/Automatic Job Management System 3 設計ガイド（業務設計編）」，および「JP1/Automatic Job Management System 3 運用ガイド」を参照してください。

ユーザーリスト

各ホストに登録されているOSユーザー名を指定します。「,」で区切って複数指定できます。OSユーザー名を複数指定した場合，ユーザーリストの先頭に記述したOSユーザー名が，ジョブの実行やコマンド実行時などにユーザーを指定しなかった場合のプライマリーOSユーザーとなります。一つのOSユーザー名として指定できる文字数は，64バイト以内です。

なお，Windowsでこのユーザーリストに指定できるOSユーザーは，jbspassmgrコマンド，jbsumappassコマンド，またはjbsmkpassコマンドを利用してパスワード情報を登録したOSユーザーだけです。マッピングするOSユーザーをユーザーリストに指定する場合，必ずパスワード管理情報にそのOSユーザーの情報を登録してください。なお，OSユーザーの情報を登録したときに，自ホストが所属するドメイン名を記述した場合は，ユーザーリストのOSユーザー名にもドメイン名を記述する必要があります。

注意事項

ユーザーマッピング定義ファイル（jp1BsUmap.conf）は，GUIでも利用しています。GUIで設定した内容は，このファイルに反映されます。

定義例

jp1admin:*:Administrator

パスワードポリシー定義ファイル

形式

[JP1_DEFAULT¥JP1BASE¥PASSWDPOLC]

"ENABLE"=dword:{00000000 | 00000001}

"PASSWD_LEN_MIN"=dword:16進数

"NUM_OF_CHAR_TYPE_MIN"=dword:16進数

"REQ_CHAR_TYPE"=文字種

パラメーターの分類

必須パラメーター

なし

選択パラメーター

ENABLE

PASSWD_LEN_MIN

NUM_OF_CHAR_TYPE_MIN

REQ_CHAR_TYPE

ファイル名

jp1bs_passwdpolc.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥passwdpolc¥

共有フォルダ¥jp1base¥conf¥passwdpolc¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/passwdpolc/

共有ディレクトリ/jp1base/conf/passwdpolc/（クラスタ運用時）

説明

パスワードポリシーの設定のため，認証サーバで共通定義情報を設定するファイルです。セカンダリー認証サーバを設置している場合は，プライマリー認証サーバおよびセカンダリー認証サーバの両方に設定してください。

パスワードポリシーチェックが有効の場合，認証サーバは，指定されたパスワードがすべてのポリシー項目の条件を満たしていることで，有効なパスワードと判断します。

論理ホスト上で設定する場合は，実行系および待機系の両方で設定します。その場合，[JP1_DEFAULT¥JP1BASE]のJP1_DEFAULTを論理ホスト名に変更してください。

定義の反映時期

jbssetcnfコマンドを実行すると，パスワードポリシー定義ファイル（jp1bs_passwdpolc.conf）の情報が共通定義情報に反映されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

JP1/Base（認証サーバ）の起動時に有効になります。

記述内容

パスワードポリシー定義ファイルには，次に示す規則があります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1BASE¥PASSWDPOLC]

パスワードポリシーチェックの設定情報を記述するセクションです。論理ホストを設定する場合は，「JP1_DEFAULT」を論理ホスト名にしてください。

"ENABLE"=dword:{00000000 | 00000001}

パスワードポリシーチェックを有効にするか無効にするかを指定します。有効にする場合は「dword:00000001」を指定します。無効にする場合は「dword:00000000」を指定します。共通定義に設定していない場合は，「dword:00000000」が仮定されます。

これ以降のパラメーターは，ENABLEパラメーターにdword:00000001を指定した場合に有効となります。

"PASSWD_LEN_MIN"=dword:16進数

パスワードの最小文字数を16進数で指定します。指定できる範囲は，「00000006」（6文字）〜「00000020」（32文字）です。

値を設定していない場合は初期値「00000006」（6文字）が仮定されます。

"NUM_OF_CHAR_TYPE_MIN"=dword:16進数

パスワードに含めることを強制する文字種の組み合わせの数を16進数で指定します。

指定できる範囲は，「00000000」（0）〜「00000004」（4）です。値を設定していない場合は初期値「00000000」（0）が仮定されます。「00000000」（0）の場合，パスワードに含める文字種の組み合わせは強制されません。対象の文字種類は，数字，英大文字，英小文字，記号の4種類です。

"REQ_CHAR_TYPE"=文字種

パスワードに含めることを強制する文字種を指定します。複数指定する場合は，「，（コンマ）」で区切って指定します。大文字，小文字は区別しません。

NUM

数値（0〜9）の使用を強制します。

UPPER

英大文字（A〜Z）の使用を強制します。

LOWER

英小文字（a〜z）の使用を強制します。

SYMBOL

記号の使用を強制します。

パスワードに使用できる文字は，¥ " :とタブ・スペースを除くASCII文字だけです。

共通定義情報に設定していない場合，パスワードに含めることを強制する文字種の指定はないと仮定されます。また，上記以外の指定できない値を指定した場合もパスワードに含めることを強制する文字種の指定はないと仮定されます。

定義例

パスワードポリシーチェックを有効とする場合の定義例を示します。次のパスワードポリシーを設定します。

パスワード最小文字数が8

パスワード最小文字種数が3

パスワードには「数字」，「英大文字」，「英小文字」を必ず使用しなければならない

[JP1_DEFAULT¥JP1BASE¥PASSWDPOLC]
"ENABLE"=dword:00000001
"PASSWD_LEN_MIN"=dword:00000008
"NUM_OF_CHAR_TYPE_MIN"=dword:00000003
"REQ_CHAR_TYPE"="NUM,UPPER,LOWER"

ヘルスチェック定義ファイル

形式

[JP1_EVENT]

OUTPUT={YES | NO}

RECOVER={YES | NO}

[SYSLOG]

OUTPUT={YES | NO}

RECOVER={YES | NO}

[OTHER_HOSTS]

INTERVAL=他ホスト監視間隔（秒）

TIMEOUT=通信タイムアウト時間（秒）

STOP_CHECK={YES | NO}

ERROR_DETAIL={YES | NO}

POLLENDMSG={YES | NO}

HOST=ホスト名1,ホスト名2,...

THRESHOLD={監視しきい値 | ホスト名:監視しきい値},...

パラメーターの分類

必須パラメーター

なし

選択パラメーター

[OTHER_HOSTS]セクション

INTERVAL

TIMEOUT

ERROR_DETAIL

HOST

POLLENDMSG

THRESHOLD

ファイル名

jbshc.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥jbshc¥

共有フォルダ¥jp1base¥conf¥jbshc¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/jbshc/

共有ディレクトリ/jp1base/conf/jbshc/（クラスタ運用時）

説明

ヘルスチェック機能の動作として，監視対象ホストやプロセスの監視間隔を設定しておくファイルです。

定義の反映時期

JP1/Baseを再起動，またはjbs_spmd_reloadコマンドを実行すると設定が有効になります。

記述内容

ヘルスチェック定義ファイル（jbshc.conf）には，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，その行は無効になります。

改行だけの行は無効になります。

ヘルスチェック定義ファイルは，1行1,023バイト以内のテキストファイルです。

[JP1_EVENT]

JP1イベントの発行に関するセクションです。

OUTPUT={YES | NO}

ヘルスチェックで問題を検知した場合にJP1イベントを発行するかどうかを指定します。「YES」または「NO」のどちらかを指定します。このパラメーターを省略した場合は，「YES」が仮定されます。

RECOVER={YES | NO}

ヘルスチェックで検知した問題が回復した場合にJP1イベントを発行するかどうかを指定します。「YES」または「NO」のどちらかを指定します。このパラメーターを省略した場合は，「YES」が仮定されます。

なお，OUTPUTパラメーターに「NO」を指定した場合は，RECOVERパラメーターに「YES」を指定しても無効になります。

[SYSLOG]

syslog，またはイベントログへのメッセージ出力に関するセクションです。

OUTPUT={YES | NO}

ヘルスチェックで問題を検知した場合に，syslogまたはイベントログにメッセージを出力するかどうかを指定します。「YES」または「NO」のどちらかを指定します。このパラメーターを省略した場合は，「YES」が仮定されます。

RECOVER={YES | NO}

ヘルスチェックで検知した問題が回復した場合に，syslogまたはイベントログにメッセージを出力するかどうかを指定します。「YES」または「NO」のどちらかを指定します。このパラメーターを省略した場合は，「YES」が仮定されます。

なお，OUTPUTパラメーターに「NO」を指定した場合は，RECOVERパラメーターに「YES」を指定しても無効になります。

[OTHER_HOSTS]

他ホスト監視の動作に関するセクションです。

INTERVAL=他ホスト監視間隔（秒）

他ホストを監視する間隔を指定します。指定できる値は，60〜7,200（秒）です。

監視間隔の目安を次に示します。

HOSTパラメーターに指定したホスト数×3（秒）

監視に掛かる時間は，1台当たり3秒を目安にしてください。ただし，ネットワーク状況や監視対象ホストの状態によって監視に掛かる時間は変わる場合があります。

監視間隔を目安よりも短く設定すると，障害を早期に検知できますが，指定した監視間隔の間に他ホストを監視し終わらないことがあります。このような場合，前回の監視処理が終了するまで待機します。

監視間隔を目安よりも長く設定すると，ネットワークやOSのリソースの消費を抑えられますが，障害の検知が遅れるおそれがあります。

このパラメーターを省略した場合は，300秒が仮定されます。

運用中，統合トレースログにKAVA7219-Wのメッセージが出力された場合

指定した監視間隔が短いおそれがあります。次に示す計算式で監視間隔を見積もってください。

現在の設定値 ＋ ((KAVA7227-Iの出力時刻 - KAVA7219-Wの出力時刻) × 1.1)

TIMEOUT=通信タイムアウト時間（秒）

監視元ホスト（マネージャー）から監視対象ホストへ監視（ポーリング）を開始してから応答が返ってくるまでのタイムアウト時間を指定します。

指定できる値は，1〜3,600（秒）です。このパラメーターを省略した場合は，60秒が仮定されます。

通信タイムアウト時間を経過しても監視対象ホストから応答がなかった場合，KAVA7223-EメッセージまたはKAVA7229-Wメッセージが出力されて監視が失敗します。

STOP_CHECK={YES | NO}

監視対象ホストの起動・停止を監視するかどうかを指定します。「YES」または「NO」のどちらかを指定します。指定を省略した場合は，「NO」が仮定されます。

ERROR_DETAIL={YES | NO}

他ホスト監視に失敗した場合に出力されるメッセージ（KAVA7223-EおよびKAVA7229-W）に，エラーの詳細情報を出力するかどうかを指定します。「YES」または「NO」のどちらかを指定します。指定を省略した場合は，「NO」が仮定されます。

POLLENDMSG={YES | NO}

ポーリング完了メッセージ（KAVA7239-I）を出力するかどうかを指定します。「YES」または「NO」のどちらかを指定します。指定を省略した場合は，「NO」が仮定されます。

HOST=ホスト名1,ホスト名2,...

他ホストを監視する場合に，監視対象ホストを指定します。自ホストだけを監視する場合は，指定は不要です。

複数のホストを指定する場合は，コンマで区切って指定します。HOSTパラメーターは複数指定できます。なお，監視できる他ホスト数は2,500台までです。2,501台以上を指定した場合は，2,501台目以降のホストは監視しません。ホスト名の大文字・小文字は区別されます。

ホスト名を複数指定する場合は，1行で記述する方法と複数行で記述する方法があります。次に示す定義は同じ定義内容になります。

1行で記述する方法

HOST=hostA,hostB,hostC

複数行で記述する方法

HOST=hostA

HOST=hostB

HOST=hostC

THRESHOLD={監視しきい値 | ホスト名:監視しきい値},...

他ホスト監視で異常が発生したと判断するしきい値を指定します。監視しきい値に指定した回数分，監視に連続で失敗した場合，監視対象で異常が発生したと判断して，監視元ホスト（マネージャー）に異常を通知します。

監視しきい値に指定できる値は，1〜64です。このパラメーターを省略した場合は，「監視しきい値」の値として1が仮定されます。

監視しきい値

監視しきい値に指定した値が，すべての監視対象ホストに適用されます。指定を省略した場合は，1が仮定されます。複数指定した場合は，最初に指定した値が有効になります。

ホスト名:監視しきい値

監視しきい値に指定した値が，ホスト名に指定した監視対象ホストだけに適用されます。ホスト名に指定できる文字数は，255バイト以内です。「ホスト名:監視しきい値」で指定した監視しきい値は，「監視しきい値」で指定した監視しきい値よりも優先されます。

ホスト名はHOSTパラメーターに指定したホスト名と，大文字・小文字を含めて完全に一致するようにしてください。同じホスト名を複数指定した場合は，最初に指定した値が有効になります。

監視しきい値を複数指定する場合は，1行で記述する方法と複数行で記述する方法があります。次に示す定義は同じ定義内容になります。

1行で記述する方法

THRESHOLD=1,hostA:3,hostB:5

複数行で記述する方法

THRESHOLD=1

THRESHOLD=hostA:3

THRESHOLD=hostB:5

注意事項

TIMEOUTパラメーターの通信タイムアウト時間をINTERVALパラメーターの他ホスト監視間隔よりも長く設定すると，監視間隔の時間内で監視が完了しないおそれがあります。通常の運用では，通信タイムアウト時間は初期設定の60（秒）のままで運用してください。通信タイムアウト時間を変更する場合は，他ホスト監視間隔よりも短くなるように設定してください。なお，通信タイムアウト時間を他ホスト監視間隔よりも長く設定するとKAVA7237-Wメッセージが出力されます。

ERROR_DETAILパラメーターが有効（YES）のときに，KAVA7223-EメッセージまたはKAVA7229-Wメッセージに出力されるエラーの詳細情報の内容と対処については，マニュアル「JP1/Base メッセージ」を参照してください。

THRESHOLDパラメーターのホスト名に指定できるホストは，HOSTパラメーターに指定した監視対象ホストが対象になります。監視対象ホストでないホストを指定した場合は，KAVA7238-Wメッセージが出力されます。

THRESHOLDパラメーターを設定した場合，設定した監視しきい値の分だけ監視対象ホストの異常の検知が遅れます。通常の運用では，監視しきい値は初期設定の１（回）のままで運用してください。「2.7.5(5)　一時的な障害で監視エラーが発生する場合の運用方法」に示すような監視障害が発生する場合は，監視しきい値の調整を検討してください。

共通定義設定用ファイル（ヘルスチェック機能）

形式

[JP1_DEFAULT¥JP1BASE¥JBSHC]

"ENABLE"=dword:{00000000 | 00000001}

"FAILOVER"=dword:{00000000 | 00000001}

パラメーターの分類

必須パラメーター

なし

選択パラメーター

ENABLE

FAILOVER

ファイル名

任意

jbshc_setup.conf.model（共通定義設定用ファイル（ヘルスチェック機能）のモデルファイル）

格納先ディレクトリ

共通定義設定用ファイル（ヘルスチェック機能）のモデルファイルの格納先ディレクトリを次に示します。モデルファイルをコピーして，任意のファイル名で作成してください。

Windowsの場合

インストール先フォルダ¥conf¥jbshc¥

共有フォルダ¥jp1base¥conf¥jbshc¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/jbshc/

共有ディレクトリ/jp1base/conf/jbshc/（クラスタ運用時）

説明

ヘルスチェック機能の設定情報を共通定義情報に設定するためのファイルです。ヘルスチェック機能は，初期設定では無効になっています。

定義の反映時期

jbssetcnfコマンドを実行すると，ヘルスチェック機能の設定情報が共通定義情報に登録されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

記述内容

共通定義設定用ファイル（ヘルスチェック機能）には，次に示す規則があります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1BASE¥JBSHC]

ヘルスチェック機能の設定の有無，および異常検知時のフェールオーバーの有無を記述するセクションです。論理ホストを設定する場合は，「JP1_DEFAULT」を論理ホスト名にしてください。

"ENABLE"=dword:{00000000 | 00000001}

ヘルスチェック機能を有効にするか無効にするかを指定します。有効にする場合は「dword:00000001」を指定します。無効にする場合は「dword:00000000」を指定します。共通定義情報に設定していない場合は，「dword:00000000」が仮定されます。

"FAILOVER"=dword:{00000000 | 00000001}

クラスタシステムで運用する場合，自ホストを監視するヘルスチェック機能がプロセスの異常を検知した際にフェールオーバーするかどうかを指定します。フェールオーバーするときは「dword:00000001」を指定します※。フェールオーバーしないときは「dword:00000000」を指定します。共通定義情報に設定していない場合は，「dword:00000000」が仮定されます。

注※　Windowsの場合はJP1/Baseサービスを停止し，UNIXの場合はヘルスチェック機能のプロセス（jbshcd）を停止します。この停止を検知し，クラスタソフトでフェールオーバーするようにします。

JP1/Baseパラメーター定義ファイル

形式

[JP1_DEFAULT¥JP1BASE]

"SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT"=dword:{0 | 1}

"SEND_PROCESS_RESTART_EVENT"=dword:{0 | 1}

"SEND_AUTHSRV_EVENT"=dword:{0 | 1}

パラメーターの分類

必須パラメーター

なし

選択パラメーター

SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT

SEND_PROCESS_RESTART_EVENT

SEND_AUTHSRV_EVENT

ファイル名

jp1bs_param_V7.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥

共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/

共有ディレクトリ/jp1base/conf/（クラスタ運用時）

説明

JP1/Baseでは，プロセスが異常終了した場合や，認証サーバを2台設置していて，自動で認証サーバの切り替えが発生した場合に，エラーメッセージを統合トレースログに出力しています。このメッセージをJP1イベントとして発行するため，あらかじめ設定しておくファイルです。通常は，初期設定から変更する必要はありません。

定義の反映時期

jbssetcnfコマンドを実行すると，JP1/Baseパラメーター定義ファイル（jp1bs_param_V7.conf）の設定が共通定義情報に反映されます。JP1/BaseおよびJP1/Baseを前提とする製品を再起動すると，設定が有効になります。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

記述内容

jp1bs_param_V7.conf内から下記記述を探してください。

SEND_PROCESS_TERMINATED_ABNORMALLY_EVENT

プロセスが異常終了した場合や，プロセス起動時にタイムアウトした場合にJP1イベントを発行するかどうかを定義します。共通定義情報に設定していない場合は，dword:0が仮定されます。

SEND_PROCESS_RESTART_EVENT

プロセスの再起動が完了した場合にJP1イベントを発行するかどうかを定義します。共通定義情報に設定していない場合は，dword:0が仮定されます。

SEND_AUTHSRV_EVENT

認証サーバの切り替えが発生した場合にJP1イベントを発行するかどうかを定義します。共通定義情報に設定していない場合は，dword:0が仮定されます。

JP1イベントを発行したい場合は，各パラメーターの値をdword:0からdword:1に変更してください。JP1イベントを発行する設定を解除したい場合は，各パラメーターの値をdword:1からdword:0に戻してください。

注意事項

論理ホスト上で設定する場合は，実行系および待機系の両方で設定します。その際，[JP1_DEFAULT¥JP1BASE]のJP1_DEFAULTを論理ホスト名に変更してください。

拡張起動プロセス定義ファイル

形式

プロセス名|パス|起動オプション|再起動可否|再起動回数|リトライ間隔|再起動回数リセット時間|

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

jp1bs_service_0700.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥

共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/

共有ディレクトリ/jp1base/conf/（クラスタ運用時）

説明

何らかの理由でプロセスが異常終了した場合，自動でプロセスを再起動するために，あらかじめ再起動の設定をしておくファイルです。通常は，初期設定から変更する必要はありません。

拡張起動プロセス定義ファイルで管理するプロセスの一覧を次に示します。

表16‒23　拡張起動プロセス定義ファイルで管理するプロセスの一覧

親プロセス名

機能

子プロセス名

機能

jbs_spmd

JP1/Baseプロセス管理

jbscomd

プロセス間通信

jbssrvmgrプロセスおよびjbslcactプロセスの前提プロセス

jcocmd

コマンド実行

jbsroute

構成管理

jbssessionmgr

認証サーバ

jbsplugin

プラグインサービス

jbshcd

ヘルスチェック（自ホスト監視用）

jbshchostd

ヘルスチェック（他ホスト監視用）

jbssrvmgr

サービス管理制御機能

jbscomdプロセスに依存する。

jbslcact

ローカルアクション機能

jbscomdプロセスに依存する。

定義の反映時期

jbs_spmd_reloadコマンドを実行するか，JP1/Baseを再起動すると，設定が有効になります。jbs_spmd_reloadコマンドの詳細については，「15.　コマンド」の「jbs_spmd_reload」を参照してください。

記述内容

定義ファイルには，あらかじめ定義情報が記載されています。プロセス名，パス，起動オプションのパラメーターは変更しないでください。また，パラメーターを区切っている|は省略できません。コメント文を挿入したい場合は，行頭に#を付けてください。改行されるまでコメント文になります。

再起動可否

プロセスが異常終了した場合に，再起動するかどうかを指定します。再起動しない場合は0，再起動する場合は1を指定します。初期設定では，0が設定されています。

なお，依存関係を持ったプロセス群については，すべての子プロセスに対して同じ値を設定してください。

再起動回数

プロセスの再起動の試行回数を指定します。指定できる値は，0〜99です。各プロセスで，あらかじめ最適値が設定されています。運用方法に応じてカスタマイズしてください。再起動可否のパラメーターに0が指定されている場合は，値が指定されていても無効になります。

リトライ間隔

プロセスの再起動のリトライ間隔を秒単位で指定します。指定できる値は，0〜3,600です。各プロセスで，あらかじめ最適値が設定されています。運用方法に応じてカスタマイズしてください。再起動可否のパラメーターに0が指定されている場合は，値が指定されていても無効になります。

再起動回数リセット時間

再起動によってプロセスが起動してから，何秒後に再起動回数をリセットするかを指定します。プロセスが起動してから，指定した時間が経過すると，再起動回数がリセットされます。再度プロセスが異常終了した場合は，再起動回数が1からカウントされます。

再起動によってプロセスが起動してから，指定した時間より前に再度異常終了した場合は，前回の再起動回数を引き継ぎます。指定できる値は，3,600〜2,147,483,647（秒）です。各プロセスで，あらかじめ最適値が設定されています。運用方法に応じてカスタマイズしてください。再起動可否のパラメーターに0が指定されている場合は，値が指定されていても無効になります。

注意事項

設定を省略したり，正常値を設定していない状態でプロセスを起動したりすると，エラーとなり起動しません。また，設定を省略したり正常値を設定していない状態でjbs_spmd_reloadコマンドを実行すると，エラーとなり，設定は反映されません。

クラスタ構成では，論理ホストのプロセス管理のプロセスを起動する際，論理ホストのconfフォルダに拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）がない場合，物理ホストの拡張起動プロセス定義ファイル（jp1bs_service_0700.conf）がコピーされます。

クラスタ運用の場合に再起動したいときは，クラスタソフトの制御によって再起動してください。

定義例

プロセスが異常終了した場合

ここでは，JP1/Baseのプロセスに対して次の条件を設定します。

再起動可否：する

再起動回数：4回

リトライ間隔：3秒

再起動回数リセット時間：3,600秒

jcocmd|C:¥ProgramFiles¥HITACHI¥JP1Base¥bin¥jcocmd.exe||1|4|3|3600|
jbsroute|C:¥ProgramFiles¥HITACHI¥JP1Base¥bin¥jbsroute.exe|-o,600|1|4|3|3600|
jbssessionmgr|C:¥ProgramFiles¥HITACHI¥JP1Base¥bin¥jbssessionmgr.exe||1|4|3|3600|
jbsplugin|C:¥ProgramFiles¥HITACHI¥JP1Base¥bin¥jbsplugind.exe||1|4|3|3600|

図16‒12　プロセスが異常終了した場合の動作例

図の例では，再起動後，再起動回数のリセット時間で指定した3,600秒以内に異常終了しなかった場合，3,600秒の時点で再起動回数がリセットされます。次回異常終了したときには1回目からカウントされます。一方，再起動後，3,600秒以内に異常終了した場合は，再起動回数を引き継ぎます。再起動回数が，指定した回数に達すると，次回異常終了時には再起動しません。

依存関係を持ったプロセスが異常終了した場合

ここでは，JP1/Baseのプロセスに対して次の条件を設定します。

再起動可否：する

再起動回数：4回

リトライ間隔：3秒

再起動回数リセット時間：21,600秒

jbscomd|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbscomd.exe||1|4|3|21600|
jcocmd|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jcocmd.exe||0|3|3|21600|
jbsroute|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbsroute.exe|-o,600|0|3|3|21600|
jbssessionmgr|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbssessionmgr.exe||0|3|3|21600|
jbsplugin|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbsplugind.exe||0|3|3|21600|
jbshcd|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbshcd.exe||0|3|3|21600|
jbshchostd|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbshchostd.exe||0|3|3|21600|
jbssrvmgr|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbssrvmgr.exe|jbscomd|1|4|3|21600|
jbslcact|C:¥Program Files¥Hitachi¥JP1Base¥bin¥jbslcact.exe|jbscomd|1|4|3|21600|

図16‒13　依存関係を持ったプロセスが異常終了した場合の動作例

前提プロセスであるjbscomdプロセスが異常終了した場合，依存しているプロセス（jbssrvmgrおよびjbslcact）も停止します。再起動可否が設定されていると，前提プロセス（jbscomd）の再起動が完了したあとに，依存しているプロセスも再起動します。

再起動可否については，依存関係を持っているすべてのプロセス群に対して，同じ値を設定してください。

jp1hosts定義ファイル

形式

#　コメント

ホスト名　IPアドレス，IPアドレス，IPアドレス

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

jp1hostsまたは任意のファイル名

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥

共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/

共有ディレクトリ/jp1base/conf/（クラスタ運用時）

説明

JP1独自のhosts情報を設定しておくファイルです。jp1hosts定義ファイルは，初期設定で提供されています。ただし，初期の状態では利用できません。このファイルを利用する場合は，運用に合わせて編集してください。なお，独自にjp1hosts定義ファイルを作成，編集することもできますが，この場合も格納場所は，初期設定で提供されているjp1hostsファイルと同じ場所にしてください。

定義の反映時期

jbshostsimportコマンドを実行すると，jp1hosts情報が共通定義情報に反映されます。jbshostsimportコマンドの詳細については，「15.　コマンド」の「jbshostsimport」を参照してください。

記述内容

jp1hosts定義ファイルには，次に示す規則があります。

jp1hosts定義ファイルは，一つのエントリーに対して1行の形式で表します。1行に記述できる文字数は，255バイト以内です。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

ホスト名　IPアドレス，IPアドレス，IPアドレス

ホスト名とIPアドレスの対応を記述します。ホスト名とIPアドレスの間は，一つ以上の半角スペースまたはタブ文字で区切ってください。

ホスト名

ASCII文字だけ使用できます。

次の文字は使用できません。

" / ¥ [ ] ; : | = , + ? < >

IPアドレスとして認識できる文字列は，ホスト名として利用できません。

IPアドレス

IPv4アドレスを指定できます。IPv6アドレスは指定できません。

IPアドレスを複数指定する場合は，「,」で区切ってください。「,」の前後の半角スペース，タブ文字は入力しても無視されます。

形式は，W.X.Y.Zだけです。W，X，Y，Zには，それぞれ0〜255の範囲の十進数で指定してください。

IPアドレスを複数設定する場合，送信時には，ホスト名に最初に設定されているIPアドレスが使用されます。

送信をIPバインド方式にしている場合，送信側のIPアドレスは，自ホスト名に最初に設定されているIPアドレスが使用されます。

一つのホスト名に対して指定できるIPアドレスの数は4です。また，同じホスト名の複数指定はできません。複数指定した場合，jbshostsimportコマンドを実行した際にエラーとなります。

jp1hosts2定義ファイル

形式

#　コメント

+DefaultResolve {0 | 1}

+PhysicalMerge {0 | 1}

ホスト名　IPアドレス　IPアドレス　IPアドレス

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

jp1hosts2.confまたは任意のファイル名

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥

共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/

共有ディレクトリ/jp1base/conf/（クラスタ運用時）

説明

JP1独自のhosts情報を設定しておくファイルです。jp1hosts2定義ファイルは，初期設定で提供されています。なお，独自にjp1hosts2定義ファイルを作成，編集することもできます。

定義の反映時期

jbshosts2importコマンドを実行すると，jp1hosts2情報が反映されます。jbshosts2importコマンドの詳細については，「15.　コマンド」の「jbshosts2import」を参照してください。

記述内容

jp1hosts2定義ファイルには，次に示す規則があります。

jp1hosts2定義ファイルは，一つのエントリーに対して1行の形式で表します。1行に記述できる文字数に制限はありません。

定義できるホスト数は，最大10,000台です。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

+DefaultResolve {0 | 1}

jp1hosts2情報に定義していないホスト名に対して，OSのhostsなどで名前解決をする場合の方法を指定します。このパラメーターを省略した場合，0が仮定されます。

0

IPv4アドレスだけを求める場合に指定します。

1

IPv4アドレスおよびIPv6アドレスを求める場合に指定します。

+PhysicalMerge {0 | 1}

物理マージ機構を有効にするかどうかを指定します。物理マージ機構とは，物理ホストのjp1hosts2情報を論理ホストのjp1hosts2情報にマージする機能です。このパラメーターは，論理ホストのjp1hosts2情報にだけ有効です。論理ホストにjp1hosts2情報が設定されていない，または論理ホストのjp1hosts2情報でこのパラメーターを省略した場合，1が仮定されます。

0

物理マージ機構を無効にする場合に指定します。

1

物理マージ機構を有効にする場合に指定します。

jp1hosts2情報をマージする際の規則

物理ホストのjp1hosts2情報と論理ホストのjp1hosts2情報で，同じホスト名が定義されている場合，論理ホストのjp1hosts2情報の定義が適用されます。マージ例を次に示します。

物理ホストのjp1hosts2情報

論理ホストのjp1hosts2情報

マージ後の論理ホストのjp1hosts2情報

hostA addr1

hostB addr2

hostC addr3

hostB addr4

hostD addr5

hostB addr4

hostD addr5

hostA addr1

hostC addr3

+DefaultResolveパラメーターについても，次に示す規則でマージされます。なお，+PhysicalMergeパラメーターはマージされません。

論理ホストのjp1hosts2情報に+DefaultResolveパラメーターが定義されていない場合，物理ホストのjp1hosts2情報の定義が適用されます。

論理ホストのjp1hosts2情報に+DefaultResolveパラメーターが定義されている場合，論理ホストのjp1hosts2情報の定義が適用されます。

ホスト名　IPアドレス　IPアドレス　IPアドレス

ホスト名とIPアドレスの対応を記述します。ホスト名とIPアドレスの間は，一つ以上の半角スペースまたはタブ文字で区切ってください。

ホスト名

ASCII文字だけ使用できます。

次の文字は使用できません。

" / ¥ [ ] ; : | = , + ? < >

IPアドレスとして認識できる文字列は，ホスト名として利用できません。

IPアドレス

IPv4アドレスまたはIPv6アドレスを指定できます。

IPアドレスを複数指定する場合は，一つ以上の半角スペースかタブ文字，または「,」で区切ってください。

IPアドレスは，一つのホストに対してIPv4アドレスとIPv6アドレスを，それぞれ四つずつ指定できます。合計すると最大八つ指定できます。

ほかのホストに対してIPアドレスを複数指定した場合，そのホストに対して通信する際のIPアドレスは，そのホスト名に最初に指定されているIPアドレスが使用されます。

送信時の通信方式をIPバインド方式にしている場合，送信元のIPアドレスは，送信先のIPアドレスの種別によって異なります。送信先がIPv4アドレスの場合は，自ホスト名に最初に設定されているIPv4アドレスが使用されます。送信先がIPv6アドレスの場合は，自ホスト名に最初に設定されているIPv6アドレスが使用されます。

IPv4アドレスの形式

形式は，W.X.Y.Zです。W，X，Y，Zには，それぞれ0〜255の範囲の十進数で指定してください。

IPv6アドレスの形式

形式は，A:B:C:D:E:F:G:Hです。A，B，C，D，E，F，G，Hには，それぞれ0〜ffffの範囲の16進数で指定してください。

数値が0から始まる場合，先頭の0を省略できます。

0000の場合，0を指定します。

一つ以上0000が連続する場合，1回だけ「::」で省略できます。

（例）

　省略前：0123:0000:0000:0000:4567:0000:0000:89ab

　省略後：123::4567:0:0:89ab

IPv6アドレスを指定する場合の注意事項

次に示すアドレスの指定は，無効になります。

IPv4互換アドレス（::1と::0以外の上位96ビットが0のアドレス）

IPv4射影アドレス（上位80ビットが0，かつ上位81ビットから96ビットの16ビットが1のアドレス）

IPv6のリンクローカルアドレス（上位10ビットが1111 1110 10のアドレス）

（例）fe80::

マルチキャスト形式（上位8ビットが1のアドレス）

ブランケット（[]），全省略（::），ネットワークインターフェース（%），およびサブネットマスク（/）

ホストアクセス制限定義ファイル

形式

AllowHost {

upper-host

all-host

host ホスト名1

host ホスト名2

　　　：

host ホスト名n

}

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

jbsdfts_srv.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥jbsdfts

共有フォルダ¥jp1base¥conf¥jbsdfts¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/jbsdfts

共有ディレクトリ/jp1base/conf/jbsdfts/（クラスタ運用時）

説明

JP1/IMのIM構成管理と連携する場合に，アクセスを許可するホストを指定しておくファイルです。ここで指定されたホスト以外からのアクセスは，すべて拒否します。ただし，自ホストのJP1/IMからのアクセスは，すべて許可します。

定義の反映時期

jbs_spmd_reloadコマンドを実行するか，JP1/Baseを再起動すると，設定が有効になります。jbs_spmd_reloadコマンドの詳細については，「15.　コマンド」の「jbs_spmd_reload」を参照してください。

記述内容

upper-host

JP1/IMのIM構成管理上の上位ホストをすべて許可します。IM構成管理に組み込まれていないホストでは，上位ホストなしとみなされます。初期設定は，upper-hostが設定されています。

all-host

すべてのホストを許可します。

host　ホスト名

ホスト名に指定されたホストを許可します。

SSL通信定義ファイル

形式

[JP1_DEFAULT¥JP1BASE¥SSL]

"ENABLE"=dword:{00000000 | 00000001}

"CERTIFICATEFILE"=サーバ証明書ファイル名

"CACERTIFICATEFILE"=ルート証明書ファイル名

"PRIVATEKEYFILE"=秘密鍵ファイル名

"SSLPROTOCOL"=SSL（TLS）バージョン

"SSLCIPHERS"=暗号スイート

"BASESSL"=サービス名

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

jp1bs_ssl.conf（SSL通信定義ファイル）

jp1bs_ssl.conf.model（SSL通信定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥

共有フォルダ¥jp1base¥conf¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/

共有ディレクトリ/jp1base/conf/（クラスタ運用時）

説明

通信暗号化機能（SSL通信）を有効にするかどうか，およびサーバ証明書のファイル名やルート証明書の格納先などのSSL通信の設定情報を共通定義情報に設定するためのファイルです。

定義の反映時期

jbssetcnfコマンドを実行すると，SSL通信定義ファイルの情報が共通定義情報に登録されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

そのあと，JP1/Baseを再起動すると，共通定義情報の設定が有効になります。

記述内容

SSL通信定義ファイルには，次に示す規則があります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1BASE¥SSL]

通信暗号化機能（SSL通信）を有効にするかどうか，およびSSL通信の設定情報を記述するセクションです。論理ホストを設定する場合は，「JP1_DEFAULT」を論理ホスト名にしてください。

"ENABLE"=dword:{00000000 | 00000001}

通信暗号化機能（SSL通信）を有効にするか無効にするかを指定します。有効にする場合は「dword:00000001」を指定します。無効にする場合は「dword:00000000」を指定します。共通定義に設定していない場合は，「dword:00000000」が仮定されます。

「dword:00000001」を指定した場合，非SSL通信ホスト設定ファイル（jp1bs_nosslhost.conf）によるSSL通信しないホストを設定できます。

これ以降のパラメーターは，ENABLEパラメーターにdword:00000001を指定した場合に有効となります。

"CERTIFICATEFILE"=サーバ証明書ファイル名

通信暗号化機能で使用するサーバ証明書のファイル名をフルパスで指定します。指定できる文字数は，1〜255（バイト）です。このパラメーターは，コマンド実行を使用するホストおよび認証サーバプロセスを起動するホストなど，SSL通信でサーバ側になるホストで指定してください。このパラメーターを無効にする場合は，「"CERTIFICATEFILE"=""」と定義してください。

"CACERTIFICATEFILE"=ルート証明書ファイル名

通信暗号化機能で使用するルート証明書のファイル名をフルパスで指定します。ルート証明書に複数のファイルが必要となる場合は，それらを結合したファイル名を指定してください。指定できる文字数は，1〜255（バイト）です。このパラメーターは，SSL通信を使用するすべてのホストで指定してください。

"PRIVATEKEYFILE"=秘密鍵ファイル名

通信暗号化機能で使用するサーバ証明書の発行を依頼したときに指定した秘密鍵ファイル名をフルパスで指定します。指定できる文字数は，1〜255（バイト）です。このパラメーターは，コマンド実行を使用するホストおよび認証サーバプロセスを起動するホストなど，SSL通信でサーバ側になるホストで指定してください。このパラメーターを無効にする場合は，「"PRIVATEKEYFILE"=""」と定義してください。なお，楕円曲線暗号を利用する場合は，PKCS#8形式の秘密鍵ファイル名を指定してください。

"SSLPROTOCOL"=SSL（TLS）バージョン

SSL通信のバージョンを指定します。指定できるバージョンは，「TLSv1_3」および「TLSv1_2」です。

TLSv1_3

TLS1.3を使用する場合に指定します。

TLSv1_2

TLS1.2を使用する場合に指定します。

このパラメーターは，コマンド実行を使用するホストおよび認証サーバプロセスを起動するホストなど，SSL通信でサーバ側になるホストで指定してください。複数指定する場合は，コロンで区切ってください。このパラメーターを無効にする場合は，「"SSLPROTOCOL"=""」と定義してください。

"SSLCIPHERS"=暗号スイート

TLS1.2を規定しているRFC5246，およびTLS1.3を規定しているRFC8446で定義しているSSL通信の暗号スイートを指定します。このパラメーターを指定しなかった場合，サーバ証明書に応じた強力な暗号スイートが自動で選択されるため，通常は指定する必要ありません。

暗号スイートを指定する場合は，OpenSSLでサポートする形式で指定してください。例えば，TLS_DHE_RSA_WITH_AES_256_CBC_SHA256を使用したい場合は，DHE-RSA-AES256-SHA256と指定する必要があります。暗号スイートの詳細は，OpenSSLの公式サイトを参照してください。

ECC形式の暗号スイートを指定する場合は，使用するTLSのバージョンに応じて，次に示す暗号スイートを指定してください。

SSLのバージョン

暗号スイート（SSLCIPHERS）

TLS1.2

ECDHE-ECDSA-AES256-GCM-SHA384

ECDHE-ECDSA-AES128-GCM-SHA256

ECDHE-ECDSA-AES256-SHA384

ECDHE-ECDSA-AES128-SHA256

TLS1.3※

TLS_AES_256_GCM_SHA384

TLS_AES_128_GCM_SHA256

注※

TLS1.2とTLS1.3では鍵交換およびデジタル署名のアルゴリズムが異なっているため，RSA暗号のサーバ証明書でも上記表のTLS1.3の暗号スイートを指定できます。

複数指定する場合は，コロンで区切ってください。指定できる文字数は，1〜255（バイト）です。このパラメーターは，コマンド実行を使用するホストおよび認証サーバプロセスを起動するホストなど，SSL通信でサーバ側になるホストで指定してください。このパラメーターを無効にする場合は，「"SSLCIPHERS"=""」と定義してください。

なお，JP1/IMおよびJP1/AJS3 - ManagerでSSL通信を有効にする際，一部の暗号スイートが使用できない場合があります。詳細は，各製品のリリースノートを参照してください。

"BASESSL"=サービス名

通信暗号化機能を有効にするサービス名を指定します。指定できるサービス名は，「jp1bsuser」，「jp1imcmda」および「jp1bsagent」です。複数指定する場合は，コンマで区切ってください。

jp1bsuser

認証サーバ（ユーザー認証）のSSL通信を有効にする場合に指定します。

jp1imcmda

JP1/IM - ViewとのSSL通信を有効にする場合に指定します。JP1/IM - Viewの通信暗号化機能（SSL通信）については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」を参照してください。

jp1bsagent

SSL通信に対応した次の制御でSSL通信を有効にする場合に指定します。

マネージャーホストのJP1/IM - Manager，JP1/BaseとエージェントホストのJP1/Base間のJP1イベント転送，JP1イベント検索，JP1イベント受信，自動アクション，コマンド実行，構成管理，およびヘルスチェック

このパラメーターは，SSL通信を使用するすべてのホストで指定してください。

ただし，サービス名「jp1bsagent」については非SSL通信ホスト設定ファイルに指定したホストでは指定できません。

注意事項

各パラメーターは，JP1/IMおよびJP1/AJS3 - ManagerでSSL通信を有効にする場合も使用します。詳細は，各製品のマニュアルを参照してください。

論理ホスト上で設定する場合は，実行系および待機系の両方で設定します。その際，[JP1_DEFAULT¥JP1BASE¥SSL]のJP1_DEFAULTを論理ホスト名に変更してください。

セキュリティ確保のため，サーバ証明書（CERTIFICATEFILE），ルート証明書（CACERTIFICATEFILE），および秘密鍵（PRIVATEKEYFILE）の格納先として，資料採取ツールが採取対象としているディレクトリは避けてください。資料採取ツールの採取対象については，「18.3.1　トラブル発生時に採取が必要な資料（Windowsの場合）」および「18.3.2　トラブル発生時に採取が必要な資料（UNIXの場合）」を参照してください。

定義例

[JP1_DEFAULT¥JP1BASE¥SSL]
"ENABLE"=dword:00000001
"CERTIFICATEFILE"="C:¥JP1¥SSL¥cert.pem"
"CACERTIFICATEFILE"="C:¥JP1¥SSL¥cacert.pem"
"PRIVATEKEYFILE"="C:¥JP1¥SSL¥certkey.pem"
"SSLPROTOCOL"="TLSv1_2"
"BASESSL"="jp1bsuser,jp1imcmda,jp1bsagent"

非SSL通信ホスト設定ファイル

形式

[NO_SSL_HOST]

非SSL通信ホスト名

非SSL通信ホスト名

　　　：

パラメーターの分類

必須パラメーター

なし

選択パラメーター

非SSL通信ホスト名

ファイル名

jp1bs_nossl.conf（非SSL通信ホスト設定ファイル）

jp1bs_nossl.conf.model（非SSL通信ホスト設定ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/

説明

通信暗号化機能（SSL通信）が有効な環境で，SSL通信しない接続先および接続元のホストを設定するファイルです。このファイルの設定は，物理ホスト，論理ホストおよびイベントサービスで有効です。

SSL通信が有効な環境では，このファイルに指定されていないホストとはSSL通信します。また，このファイルがないときも接続先および接続元のホストとSSL通信します。

定義の反映時期

非SSL通信ホスト設定ファイルを編集したあと，JP1/Baseサービスおよびイベントサービスを起動または再起動すると，設定が有効になります。

記述内容

非SSL通信（SSL通信しない）する接続先および接続元のホスト名を指定します。非SSL通信ホスト設定ファイルには，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

各行の最後には，必ず改行を入れてください。

ASCII文字だけ使用できます。

次の文字は使用できません。

" / ¥ [ ] ; : | = , + ? < >

1行に1つのホスト名を定義します。

ホスト名に指定できる文字数は，255バイト以内です。大小文字を区別しません。

ホスト名の前後に指定された半角スペースおよびタブは，無視されます。

定義できるホスト数は，最大100台です。

同じホスト名を複数指定した場合は，最初に指定した値が有効になります。

注意事項

非SSL通信ホスト設定ファイルは，物理ホスト，論理ホストおよび任意のイベントサービスで参照されるファイルです。そのため，運用中に非SSL通信ホスト設定ファイルが誤って編集されても正しく通信できるよう，JP1/Baseおよびイベントサービスの起動時に，世代番号を付与した三世代分の非SSL通信ホスト設定ファイルとエラーを除いた非SSL通信ホスト設定ファイルを退避します。退避したファイルを削除しないでください。

表16‒24　非SSL通信ホスト設定ファイルの退避先

Windowsの場合

UNIXの場合

JP1/Baseの起動時

物理ホストの場合

インストール先フォルダ¥sys¥nossl_base.conf

インストール先フォルダ¥sys¥nossl_base{1|2|3}.conf

論理ホストの場合

共有フォルダ¥jp1base¥sys¥nossl_base.conf

共有フォルダ¥jp1base¥sys¥nossl_base{1|2|3}.conf

物理ホストの場合

/var/opt/jp1base/sys/nossl_base.conf

/var/opt/jp1base/sys/nossl_base{1|2|3}.conf

論理ホストの場合

共有ディレクトリ/jp1base/sys/nossl_base.conf

共有ディレクトリ/jp1base/sys/nossl_base{1|2|3}.conf

イベントサービスの起動時

物理ホストの場合

インストール先フォルダ¥sys¥tmp¥event¥servers¥default¥nossl_evt.conf

インストール先フォルダ¥sys¥tmp¥event¥servers¥default¥nossl_evt{1|2|3}.conf

論理ホストの場合

共有フォルダ¥jp1base¥event¥nossl_evt.conf

共有フォルダ¥jp1base¥event¥nossl_evt{1|2|3}.conf

物理ホストの場合

/var/opt/jp1base/sys/tmp/event/servers/default/nossl_evt.conf

/var/opt/jp1base/sys/tmp/event/servers/default/nossl_evt{1|2|3}.conf

論理ホストの場合

共有ディレクトリ/event/nossl_evt.conf

共有ディレクトリ/event/nossl_evt{1|2|3}.conf

非SSL通信ホスト設定ファイルにエラーがある場合，JP1/Baseサービスおよびイベントサービスは，エラーのある行は無視してログ（KAVB3920-WまたはKAJP1510-Wメッセージ）だけを出力して起動します。

定義例

非SSL通信ホスト設定ファイルの定義例を示します。

すべてのホストとの通信をSSL通信にする場合

すべてのホストとの通信を暗号化通信にする場合は，[NO_SSL_HOST]行だけを定義します。

[NO_SSL_HOST]

ホストとの通信が非SSL通信とSSL通信で混在する場合

ホスト（hostA）との通信は非SSL通信となり，それ以外のホストとの通信はSSL通信となります。

[NO_SSL_HOST]
hostA

ローカルアクション環境変数ファイル

形式

環境変数名1=変数値1

[環境変数名2=変数値2]

　　　：

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

任意。なお，ファイル名は，255バイト以内で設定してください。

格納先ディレクトリ

任意。なお，格納先ディレクトリおよびファイル名は，ローカルアクション実行定義ファイルのvarオプションに指定してください。

説明

ローカルアクション機能で指定されたコマンドを実行するときの環境変数を設定するファイルです。複数のローカルアクション環境変数ファイルを用意することで，実行するコマンドごとに任意の環境変数を指定できます。Windowsの場合，ローカルアクション環境変数ファイルを指定しない場合，システムの環境変数でコマンドが実行されます。

定義の反映時期

ローカルアクション機能で指定されたコマンドを実行するときに参照されます。

記述内容

環境変数名

環境変数の名称を指定します。改行文字を含む環境変数は指定できません。

変数値

環境変数名の値を指定します。

環境変数名と変数値の設定内容は，システム環境変数の値と置換できます。例えば，Windowsの場合に%で囲む指定や，UNIXの$で始まる指定のように，システム環境変数名を「<-」と「->」で囲み，「<-variable->」のように指定してください。ただし，置換できるのは1行に対して1か所だけです。

ローカルアクション実行定義ファイル

形式

# 共通ブロック

[cmn

[usr JP1ユーザー名]

[var 環境変数ファイル名]

[evt [{yes|no}]/[{yes|no}]]

[cnt-opt [queue=実行待ちアクション数] , [exec=同時実行数]]

end-cmn]

# アクションブロック

act アクション名

cnd

イベントフィルター

end-cnd

[det 同一アクション抑止時間]

[usr JP1ユーザー名]

[var 環境変数ファイル名]

cmd 実行するコマンド

[evt [{yes|no}]/[{yes|no}]]

[cmd-opt usrprofile={0|1}]

end-act

　　　：

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

jbslcact.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥lcact

共有フォルダ¥jp1base¥conf¥lcact（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/lcact/

共有ディレクトリ/jp1base/conf/lcact/（クラスタ運用時）

説明

ローカルアクション機能の実行条件と実行コマンドを定義するファイルです。共通ブロックとアクションブロックで構成されます。共通ブロックは，すべてのアクションブロックで共通に設定するパラメーターを定義します。アクションブロックは，アクションを成立させるJP1イベントの条件と，JP1イベントの条件が成立した場合に実行するアクションを一対として定義します。

ローカルアクション機能が実行される場合，上位に定義されたアクションブロックから条件の判定を行い，条件が成立したときにアクションを実行します。条件が成立したアクションブロックより下位に定義されたアクションブロックは，条件の判定を行わず，アクションも実行されません。このため，優先度の高い条件を上位に定義してください。

定義の反映時期

JP1/Baseを起動またはリロードすると，設定が有効になります。

記述内容

ローカルアクション実行定義ファイルには，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

1行の最大長は4,200バイトです。

パラメーターは，半角スペース（0x20）またはタブ（0x09）で区切ります。

英字の大文字小文字は区別します。

共通ブロックはアクションブロックの前に一つだけ指定します。共通ブロックとアクションブロックで共通するパラメーターが指定されている場合は，アクションブロックの指定が有効になります。共通ブロックの記述形式を次に示します。

cmn 〜 end-cmn

共通ブロックの開始と終了を示すパラメーターです。

usr　JP1ユーザー名

アクションを実行するOSユーザーにマッピングするJP1ユーザーを指定します。このパラメーターを省略した場合，アクションブロックに同じパラメーターが必要になります。

var　環境変数ファイル名

アクションを実行する場合に参照する環境変数ファイル名を255バイト以内で指定します。

evt [{yes|no}]/[{yes|no}]

アクション開始イベントとアクション完了イベントのJP1イベントを発行するかどうかを指定します。/の前がアクション開始イベントで，後ろがアクション完了イベントの指定になります。yesが指定されている場合，JP1イベントが発行されます。noが指定されている場合や省略されている場合，JP1イベントは発行されません。

cnt-opt [queue=実行待ちアクション数] , [exec=同時実行数]

実行待ちアクション数および同時実行数を指定します。queueオプションとexecオプションを指定する場合は，コンマで区切ってください。

queue=実行待ちアクション数

アクションの条件が成立したあとに，アクションを実行待ちできる上限値を指定します。指定した上限値を超えると，そのアクションは実行されないため，余裕のある値を指定してください。指定できる値の範囲は，0〜65,535です。このオプションを省略した場合は，1,024が仮定されます。

exec=同時実行数

同時に実行できるアクション数の上限値を指定します。実行中のアクション数が指定した上限値に達していると，そのアクションは実行待ちになります。指定できる値の範囲は，1〜48です。このオプションを省略した場合は，1が仮定されます。

アクションブロックは，上限を1,000として複数指定できますが，省略はできません。共通ブロックとアクションブロックで共通するパラメーターが指定されている場合は，アクションブロックの指定が有効になります。アクションブロックの記述形式を次に示します。

act アクション名 〜 end-act

アクションブロックの開始と終了を示すパラメーターです。actパラメーターのあとには任意のアクション名を50バイト以内で指定してください。アクション名はローカルアクション実行履歴ログに出力されます。

cnd 〜 end-cnd

アクションを成立させるJP1イベントの条件を指定するブロックの開始と終了を示すパラメーターです。このブロックは，actパラメーターの直後に指定してください。アクションを成立させる条件はイベントフィルターの記述形式で指定します。イベントフィルターの記述形式については，「イベントフィルターの文法」を参照してください。

なお，ローカルアクションの実行条件（イベントフィルター）で対象となるJP1イベントは，次に示す自イベントサーバに登録されたJP1イベントだけです。

自イベントサーバから自イベントサーバあてに発行されたイベント（JP1イベントの登録要因：1）。

他イベントサーバから自イベントサーバあてに発行されたイベント（JP1イベントの登録要因：3）。

例えば，jevsendコマンド（-dオプションを指定）やjevsenddコマンドなどで自ホストの他イベントサーバから自イベントサーバに登録された場合です。

他イベントサーバから転送されたJP1イベント（JP1イベントの登録要因：4）は対象外です。

det　同一アクション抑止時間

同じアクションを実行しない時間を秒単位で指定します。指定できる時間の範囲は，1〜3,600（秒）です。このパラメーターを省略した場合，同じアクションの実行を抑止しません。

usr　JP1ユーザー名

アクションを実行するOSユーザーにマッピングするJP1ユーザーを指定します。JP1ユーザー名には，属性変数名が指定できます。このパラメーターを省略した場合，共通ブロックに同じパラメーターが必要になります。

var　環境変数ファイル名

アクションを実行する場合に参照する環境変数ファイル名を255バイト以内で指定します。環境変数ファイル名には，属性変数名が指定できます。

cmd 実行するコマンド

アクションで実行するコマンドを4,096バイト以内で指定します。実行するコマンドには，属性変数名が指定できます。実行するコマンドの形式については，「2.8.2　ローカルアクションで実行できるコマンド」を参照してください。

evt [{yes|no}]/[{yes|no}]

アクション開始イベントとアクション完了イベントのJP1イベントを発行するかどうかを指定します。/の前がアクション開始イベントで，後ろがアクション完了イベントの指定になります。yesが指定されている場合，JP1イベントが発行されます。noが指定されている場合や省略されている場合，JP1イベントは発行されません。

cmd-opt usrprofile={0|1}（Windows限定）

コマンドの実行時にユーザープロファイルをロードすることを指定します。

このオプションを省略した場合は，0を仮定します。

0：マッピングOSユーザーのユーザープロファイルをロードしない

1：マッピングOSユーザーのユーザープロファイルをロードする

属性変数名

属性変数名は，アクションブロック内の項目に指定できます。属性変数名を指定できる項目は，JP1ユーザー名，環境変数ファイル名，実行するコマンドの3項目です。アクションを実行する前に，アクションが成立した条件のJP1イベントから，属性変数名に対応した属性値を取得して展開します。複数個所での展開はできますが，展開後の文字列に対しての展開はできません。指定できる属性変数名の一覧を次に示します。

表16‒25　ローカルアクションで指定できる属性変数名の一覧

情報の種類

属性変数名

内容

JP1イベント基本属性に含まれる情報

EVID

イベントID（基本コード:拡張コード）

EVPID

イベント発行元プロセスID

EVUSRID

イベント発行元プロセスのユーザーID

EVGRPID

イベント発行元プロセスのグループID

EVUSR

イベント発行元ユーザー名

EVGRP

イベント発行元グループ名

EVHOST

イベント発行元ホスト名

EVIPADDR

イベント発行元IPアドレス

EVMSG

メッセージテキスト全体

JP1イベント拡張属性に含まれる情報

EVSEV

イベント拡張情報重大度

（Emergency，Alert，Critical，Error，Warning，Notice，Information，Debug）

EV"拡張属性名"

任意の拡張属性

属性変数名の指定例を次に示します。

cmd  abcd.bat $EVUSR

cmdパラメーターに属性変数名EVUSR（属性値:USER01）を指定した例です。この例では，abcd.bat USER01に展開されます。

属性変数名を指定するときの注意事項を次に示します。

展開後の文字列長が制限値をオーバーしている場合，アクションは実行されません。

該当しない項目の属性変数名の値はNULLになります。また，JP1イベントの種類によっては，属性変数名自体のないものや，各属性に含まれる情報に文字として認識できないコード（ASCIIコードおよび環境設定で指定した日本語文字コードの文字集合に含まれない部分）が含まれていることで，アクションが実行できない，または実行されても結果が不正になる場合があります。JP1イベント発行元製品のマニュアルなどを事前に参照し，設定してください。

属性変数名の直後に文字を記述する場合，英数字および「_ 」を指定すると正しく変換されません。このような場合は，属性変数名を｛｝で囲んでください。次に指定例を示します。なお，次の例では，イベントID（$EVID）は100:0，拡張属性EX（$EV"EX"）はABCが設定されていると仮定します。

アクション定義 → 変換後の情報
「$EVID abc」  →「100:0 abc」
「$EVIDabc」   →「$EVIDabc」(Windowsの場合)，なし(UNIXの場合)
「${EVID}abc」 →「100:0abc」
「$EVID_abc」  →「$EVID_abc」(Windowsの場合)，なし(UNIXの場合)
「${EVID}_abc」→「100:0_abc」
「$EV"EX" abc」→「ABC abc」
「$EV"EX"abc」 →「ABCabc」

変換元の文字情報に，次に示す制御文字が含まれていた場合，その制御文字は半角スペース（0x20）に変換されて処理されます。

半角スペースに変換される制御文字：0x01〜0x1F（タブ(0x09)を除く），0x7F

例えば，$EVMSGの指定によって取得したメッセージの中に改行コード（0x0A）が含まれていた場合，改行コード（0x0A）は半角スペース（0x20）に変換されて処理されます。

（例）アクション（echo $EVMSG）を設定し，イベントのメッセージとして改行コードを含む文字列”1行目 0x0A 2行目”を受信した場合には，アクションとして実行されるコマンドは "echo 1行目△2行目"となります（△は半角スペースを表す）。

UNIXの場合，最終的な展開はシェルの解釈に依存します。展開後のデータに「*」など，シェルで特別な意味を持つ文字がある場合，その内容に置き換えられます。置き換えが行われないようにするには，変数全体を「"」で囲み，「"$EVMSG"」のように記述してください。

共通定義設定用ファイル（ローカルアクション機能）

形式

[JP1_DEFAULT¥JP1BASE¥LCACT]

"LOGSIZE"=ローカルアクション実行履歴ログファイルのサイズ

"LOGFILENUM"=ローカルアクション実行履歴ログファイルの保存面数

"PAUSE"=dword:{00000000 | 00000001}

"CODECONV"=dword:{00000000 | 00000001}

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

任意

jp1bs_lcact_setup.conf.model（共通定義設定用ファイル（ローカルアクション機能）のモデルファイル）

格納先ディレクトリ

共通定義設定用ファイル（ローカルアクション機能）のモデルファイルの格納先ディレクトリを次に示します。モデルファイルをコピーして，任意のファイル名で作成してください。

Windowsの場合

インストール先フォルダ¥conf¥lcact¥

共有フォルダ¥jp1base¥conf¥lcact¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/lcact/

共有ディレクトリ/jp1base/conf/lcact/（クラスタ運用時）

説明

マシンメンテナンスなどの作業のため，ローカルアクション機能を休止したり，休止を解除して起動したりする設定や，ローカルアクション実行履歴ログファイルのログ情報を共通定義情報に設定するためのファイルです。

定義の反映時期

jbssetcnfコマンドを実行すると，共通定義設定用ファイル（ローカルアクション機能）の情報が共通定義情報に登録されます。jbssetcnfコマンドの詳細については，「15.　コマンド」の「jbssetcnf」を参照してください。

そのあと，jbs_spmd_reloadコマンドを実行するか，JP1/Baseを再起動すると，共通定義情報の設定が有効になります。jbs_spmd_reloadコマンドの詳細については，「15.　コマンド」の「jbs_spmd_reload」を参照してください。

記述内容

共通定義設定用ファイル（ローカルアクション機能）には，次に示す規則があります。

「=」「,」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1BASE¥LCACT]

ローカルアクション機能の設定の有無，およびローカルアクション実行履歴ログファイルのログ情報を記述するセクションです。論理ホストを設定する場合は，「JP1_DEFAULT」を論理ホスト名にしてください。

"LOGSIZE"=ローカルアクション実行履歴ログファイルのサイズ

ローカルアクション実行履歴ログファイルのサイズ（バイト単位）を16進数で指定します。指定できる範囲は，「00002000」（8KB）〜「00400000」（4,096KB）です。指定できる範囲の下限値よりも小さい値を指定した場合は下限値を仮定し，上限値よりも大きい値を指定した場合は上限値を仮定します。共通定義情報に設定していない場合は，00100000（1,024KB）が仮定されます。

"LOGFILENUM"=ローカルアクション実行履歴ログファイルの保存面数

ローカルアクション実行履歴ログファイルの保存面数を16進数で指定します。指定できる範囲は，「00000001」（1面）〜「00000010」（16面）です。指定できる範囲の下限値よりも小さい値を指定した場合は下限値を仮定し，上限値よりも大きい値を指定した場合は上限値を仮定します。共通定義情報に設定していない場合は，00000004（4面）が仮定されます。

"PAUSE"=dword:{00000000 | 00000001}

ローカルアクション機能を起動するか，休止するかを指定します。起動する場合は「dword:00000000」を指定します。休止する場合は「dword:00000001」を指定します。共通定義情報に指定できる値以外の値を設定した場合や，値を設定していない場合は，「dword:00000000」が仮定されます。

"CODECONV"=dword:{00000000 | 00000001}

属性変数名を指定してJP1イベントから属性値を展開する場合に，文字コードを変換するかどうかを指定します。JP1イベントの文字コードで，そのままの属性値を展開する場合は，「dword:00000000」を指定します。動作環境の文字コードに合わせて属性値を変換して展開する場合は，「dword:00000001」を指定します。共通定義情報に指定できる値以外の値を設定した場合や，値を設定していない場合は，「dword:00000000」が仮定されます。

収集情報ファイル

形式

情報識別子<FILE>ファイル名

　　　：

パラメーターの分類

必須パラメーター

なし

選択パラメーター

なし

ファイル名

jbsparamdump.conf

格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/

説明

jbsparamdumpコマンドでJP1/Baseの設定情報を収集する際，ユーザーが任意に格納先やファイル名を設定したファイルを収集するために，その格納先とファイル名を指定するファイルです。

例えば，ログファイルトラップ動作定義ファイルを任意の名称で複数配置して運用している場合，各ファイルの格納先とファイル名をこのファイルに指定することで，ログファイルトラップ動作定義ファイルの定義情報を収集できるようになります。

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

定義の反映時期

jbsparamdumpコマンドを実行するときに参照されます。

記述内容

収集情報ファイルには，次に示す規則があります。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

情報識別子は重複して指定できます。

情報識別子とファイル名の間の<FILE>は省略できません。

情報識別子に含まれるスペースおよびタブは情報識別子の一部と見なします。

<FILE>とファイル名の間のスペースおよびタブは無視します。

ファイル名の末尾のスペースおよびタブは無視します。

ファイルの文字コードは，jbsparamdumpコマンドを実行する環境の文字コードと同じにする必要があります。

情報識別子

収集対象を識別する為の文字列を，256バイト以内で指定します。

ファイル名

収集対象とするファイル名をフルパスで指定します。指定できるファイルはテキスト形式のファイルだけです。

定義例

定義例およびjbsparamdumpコマンド実行時の出力例を次に示します。

定義例

# LOGTRAP DEFINITIONS
LOGTRAP_AP1<FILE>D:¥temp¥jevlog_ap1.conf
LOGTRAP AP2<FILE>C:¥Program Files¥HITACHI¥JP1Base¥conf¥jevlog_ap2_1.conf
LOGTRAP AP2<FILE>C:¥Program Files¥HITACHI¥JP1Base¥conf¥jevlog_ap2_2.conf

出力例（userconf.prmファイル）

***JP1/Base User Configurations(FileVersion=105000 TimeStamp=2013/09/12 14:22:13)

*****LOGTRAP_AP1<FILE>D:¥temp¥jevlog_ap1.conf
jevlog_ap1.confのファイル内容
***End LOGTRAP_AP1(SUCCESS)

*****LOGTRAP AP2<FILE>C:¥Program Files¥HITACHI¥JP1Base¥conf¥jevlog_ap2_1.conf
jevlog_ap2_1.confのファイル内容
***End LOGTRAP AP2(SUCCESS)

*****LOGTRAP AP2<FILE>C:¥Program Files¥HITACHI¥JP1Base¥conf¥jevlog_ap2_2.conf
jevlog_ap2_2.confのファイル内容
***End LOGTRAP AP2(SUCCESS)

共通定義設定用ファイル（構成管理機能）

形式

[JP1_DEFAULT¥JP1BASE¥JBS_ROUTE]

"JBSRT_DISTRIB_VERSION"=dword:{00000000 | 00000001}

"JBSROUTE_COM_TIMEOUT"=dword:16進数

パラメーターの分類

必須パラメーター

なし

選択パラメーター

JBSRT_DISTRIB_VERSION

JBSROUTE_COM_TIMEOUT

ファイル名

任意

jbsrt_setup.conf.model（共通定義設定用ファイル（構成管理機能）のモデルファイル）

格納先ディレクトリ

共通定義設定用ファイル（構成管理機能）のモデルファイルの格納先ディレクトリを次に示します。モデルファイルをコピーして，任意のファイル名で作成してください。

Windowsの場合

インストール先フォルダ¥conf¥route¥

共有フォルダ¥jp1base¥conf¥route¥（クラスタ運用時）

UNIXの場合

/etc/opt/jp1base/conf/route/

共有ディレクトリ/jp1base/conf/route/（クラスタ運用時）

説明

構成管理機能の設定情報を共通定義情報に設定するためのファイルです。なお，JP1/Baseを新規インストールした場合，JBSRT_DISTRIB_VERSIONは1（差分配布方式）で設定されます。JP1/Base 11-10より前のバージョンから上書きインストールした場合，JBSRT_DISTRIB_VERSIONは未定義（一括配布方式）で設定されます。

差分配布機能の詳細については，「2.6.3　コマンドによるシステム階層構成の管理」を参照してください。

定義の反映時期

jbssetcnfコマンドを実行すると，共通定義設定用ファイル（構成管理機能）の情報が共通定義情報に登録されます。共通定義JBSRT_DISTRIB_VERSIONの設定値は，jbsrt_distribコマンド実行時に有効になります。共通定義JBSROUTE_COM_TIMEOUTの設定値は，jbs_spmd_reloadコマンドを実行するか，JP1/Baseを再起動すると反映されます。jbssetcnfコマンドおよびjbsrt_distribコマンドの詳細については，「15.　コマンド」の「jbssetcnf」および「jbsrt_distrib」を参照してください。

記述内容

共通定義設定用ファイル（構成管理機能）には，次に示す規則があります。

「=」の前後，行頭，および行末にスペースまたはタブを入れないでください。これらを入れた場合，jbssetcnfコマンド実行時にエラーとなります。

改行だけの行は無効になります。

[JP1_DEFAULT¥JP1BASE¥JBS_ROUTE]

構成管理機能の設定について記述するセクションです。論理ホストを設定する場合は，「JP1_DEFAULT」を論理ホスト名にしてください。

"JBSRT_DISTRIB_VERSION"=dword:{00000000 | 00000001}

構成定義情報の配布方式を一括配布方式にするか，差分配布方式にするかを指定します。一括配布方式にする場合は「dword:00000000」を指定します。差分配布方式にする場合は「dword:00000001」を指定します。共通定義情報に指定できる値以外の値を設定した場合や，値を設定していない場合は，「dword:00000000」が仮定されます。

"JBSROUTE_COM_TIMEOUT"=dword:16進数

構成配布または構成同期を実行する際の通信タイムアウト時間（秒単位）を16進数で指定します。指定できる範囲は，「00000001」（1秒）〜「00015180」（86,400秒）です。指定できる値以外の値を設定した場合，起動時は初期値「00000258」（600秒），リロード時はリロード前の値が仮定されます。値を設定していない場合は初期値「00000258」（600秒）が仮定されます。

注意事項

通信タイムアウト時間（JBSROUTE_COM_TIMEOUT）を長く設定すると，構成管理機能のコマンド（jbsrt_distrib，jbsrt_sync）の実行やIM構成管理を使用したシステムの階層構成（IM構成）の設定に時間が掛かるおそれがあります。初期設定の600秒のままで運用することを推奨します。

「2.6.3(5)　通信タイムアウト時間の見直し」に示すようなケースで，タイムアウトが発生する場合は，通信タイムアウト時間の調整を検討してください。

構成定義ファイル

形式

[マネージャーホスト１]

管理対象ホスト

管理対象ホスト

：

[マネージャーホスト２]

管理対象ホスト

：

ファイル名

jbs_route.conf（構成定義ファイル）

jbs_route.conf.model（構成定義ファイルのモデルファイル）

格納先ディレクトリ

Windowsの場合

物理ホストのとき

Baseパス¥conf¥route¥

論理ホストのとき

共有フォルダ¥jp1base¥conf¥route¥

UNIXの場合

物理ホストのとき

/etc/opt/jp1base/conf/route/

論理ホストのとき

共有ディレクトリ/jp1base/conf/route/

説明

JP1/IMで管理するシステムの階層構造を定義するファイルです。

JP1/IMは，システムを管理するマネージャーと，管理対象であるエージェントによって，階層構造のシステム構成により運用します。また，マネージャーは階層化できます。これによって，さまざまな規模のシステムを管理します。

システム階層構造は，JP1/IMの基盤機能を提供する前提製品JP1/Baseにより管理されています。

このファイルで定義した階層構造の情報を基にして，次のようにJP1/IMの機能が動作します。

JP1イベント転送

重要なJP1イベントは，構成定義情報で定義した，下位のホストから上位のホストへ転送されます（デフォルトの設定の場合）。

自動アクション，コマンド実行

構成定義情報で指定したホストに対して，自動アクションやコマンド実行によるコマンド実行指示を要求できます。

ファイルの最終行には，改行を入れてください。

定義の反映時期

構成定義情報の内容は，次のコマンドを実行して定義が反映されてから有効になります。

jbsrt_distrib（定義情報の配布）

jbsrt_sync（最上位マネージャーでの定義情報の同期）

jbsrt_del（定義情報の削除）

記述内容

[マネージャーホスト]

マネージャーのホスト名を指定します。

マネージャーは，JP1/IM - Managerがインストールされているホストです。

ホスト名は，1〜255バイトの，半角英数字および記号（"-"," ."）で指定します。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

システム構成を分割定義する場合は，ほかの構成定義ファイルと重複するホスト名の前に「*」を付けます。

管理対象ホスト

マネージャーによって管理される管理対象ホストのホスト名を指定します。

ホスト名は，1〜255バイトの，半角英数字および記号（"-"," ."）で指定します。

行の先頭に#（0x23）を指定すると，その行はコメント行になります。

システム構成を分割定義する場合は，ほかの構成定義ファイルと重複するホスト名の前に「*」を付けます。

管理対象ホストには，JP1/Baseがインストールされている必要があります。管理対象ホストは，複数のマネージャーを持つことはできません。

ホスト名には，hostsファイルやDNSに登録してあるホスト名，jp1hostsまたはjp1hosts2に定義しているホスト名を指定してください。

ホスト名として，誤って使用不可文字の「*」を記述した場合，jbsrt_distribコマンドが構成定義を削除する時に「*」が付いたホスト以下の構成定義情報が削除されません。

指定するホスト名にエイリアス名は使用できません。

コマンド実行，自動アクション機能を使用する場合，管理対象ホストにはコマンド実行，自動アクション機能で指定するホスト名を指定してください。また，指定するホストが物理ホストの場合，hostnameコマンドで返されるホスト名を指定してください。

定義例

次の表の階層構成でJP1/IMのシステムを組む場合の構成定義ファイルの定義例を一括定義する場合と分割定義する場合に分けて示します。

表16‒26　JP1/IMのシステムの階層構成（例）

統合マネージャー

拠点マネージャー

エージェント

jp1sv1

jp1sv2

jp1ag1，jp1ag2

jp1sv3

jp1ag3，jp1ag4，jp1ag5

一括定義する場合

一括定義する場合，統合マネージャーで次のように構成定義ファイルを編集します（拠点マネージャー，エージェントでの編集は不要です）。

統合マネージャー（jp1sv1）の構成定義ファイル

[jp1sv1]
jp1sv2
jp1sv3
[jp1sv2]
jp1ag1
jp1ag2
[jp1sv3]
jp1ag3
jp1ag4
jp1ag5

分割定義する場合

分割定義する場合，統合マネージャー，各拠点マネージャーで次のように構成定義ファイルを編集します（エージェントでの編集は不要です）。

統合マネージャー（jp1sv1）の構成定義ファイル

[jp1sv1]
*jp1sv2
*jp1sv3

拠点マネージャー（jp1sv2）の構成定義ファイル

[*jp1sv2]
jp1ag1
jp1ag2

拠点マネージャー（jp1sv3）の構成定義ファイル

[*jp1sv3]
jp1ag3
jp1ag4
jp1ag5

環境変数ファイル

形式

環境変数名1=変数値1

[環境変数名2=変数値2]

：

：

ファイル名

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

コマンドを実行するホストの任意のフォルダ

UNIXの場合

コマンドを実行するホストの任意のディレクトリ

説明

JP1/IMの管理対象ホストでコマンドを実行するときの環境変数を定義するファイルです。

自動アクションやJP1/IM - Viewでの操作によって，JP1/IMの管理対象ホストでコマンドを実行するときには，そのコマンドの実行環境として環境変数を指定できます。環境変数は，ここで説明している形式で記述された環境変数ファイルにより指定できます。

環境変数ファイルのファイル名は任意です。複数の環境変数ファイルを用意することにより，実行するコマンドごとに任意の環境変数を指定できます。

Windows環境で環境変数ファイルを指定しない場合，システムの環境変数でコマンドが実行されます。

各行の最後には，必ず改行を入れてください。

1行の上限サイズは1023バイトです。マルチバイト文字コードを指定した場合は，JP1/Baseの文字コードでエンコーディングされます。

「環境変数名=変数値」の形式以外の文字列は指定しないでください。コマンドを実行するホスト側のOSによってはコマンドが異常終了することがあります。

定義の反映時期

環境変数ファイルは，コマンド実行を開始するときに参照されます。

記述内容

環境変数名

環境変数の名称を指定します。

改行文字を含む環境変数は指定できません。

変数値

環境変数の値を指定します。

1行の上限サイズは1,023バイトです。なお，環境変数ファイルのエンコーディングは，コマンドを実行する管理対象ホストの文字コードとなります。

ここにシステム環境変数名を指定することでシステム環境変数の値を引き継げます。

システム環境変数を指定する場合は，システム環境変数名を「<-」と「->」で囲み，「<-variable->」のように指定してください。

ホストグループ定義ファイル

形式

ホストグループ名

{

ホスト名1

ホスト名2

：

：

}

ファイル名

任意のファイルを使用します。

格納先ディレクトリ

Windowsの場合

任意のフォルダ

UNIXの場合

任意のディレクトリ

説明

JP1/IMの管理対象ホストのグループを定義するファイルです。

JP1/IMでは，自動アクションやJP1/IM - Viewの操作によりコマンドを実行するとき，実行先のホストをグループ化して，各ホストで同じコマンドを一括して実行できます。

定義の反映時期

jcocmddefコマンドを実行して設定したあとに有効になります。

クラスタ構成で論理ホストの設定をする場合は，実行系と待機系の両方で設定してください。

記述内容

ホストグループ名

ホストグループを識別する名称を指定します。

ホストグループ名は，32文字以内の半角英数字で指定します。空白および全角文字は使用できません。

コマンドを実行するときにホストグループを対象とするときは，この名称を指定します。例えば，自動アクション定義ファイルの「d=実行先ホスト名・グループ名」の定義項目や，JP1/IM - Viewの［コマンド実行］画面の［実行ホスト名］などに指定します。

ホスト名

グループを構成するホストの名称を指定します。

ホスト名は，255文字以内の半角英数字で指定します。空白および全角文字は使用できません。

なお，ここで指定できるのは，構成定義ファイルで定義した管理対象ホストだけです。

ホストグループの削除

ホストグループを削除したいときは，ホストグループ定義ファイルに削除したいホストグループ名の空の定義を作成して，jcocmddefコマンドを実行してください。

ホストグループの編集

既存のホストグループの定義内容を変更したい場合は，同じホストグループ名でホストグループ定義ファイルを作り直し，jcocmddefコマンドを実行してください。

17　JP1イベント

この章では，JP1/Baseが出力するJP1イベントの種類と発行契機，およびJP1イベント情報の詳細について説明します。

17.1　JP1イベントの属性

JP1イベントの属性には基本属性と拡張属性があります。

基本属性は，すべてのJP1イベントが持っている属性です。拡張属性は，JP1イベントを発行するプログラムが独自に割り当てる属性です。

17.1.1　基本属性

表17‒1　JP1イベントの基本属性

通称

形式※1

内容

イベントDB内の通し番号

数値（32ビット）

発行元によらないでこのイベントサーバに到達した順番（ローカルイベントも含む）。この属性はJP1イベントのイベントサーバ間の転送時に保存されない。主にJP1イベントを擬似オペレーターやほかのイベントサーバへ転送した時の漏れ・重複の防止に用いる。※7

イベントID

数値（32ビット）の2組※2

発行APや事象の内容を表す8バイトの値。

登録要因

数値（32ビット）

JP1イベントがこのイベントサーバに登録された要因。この属性はJP1イベントのイベントサーバ間転送時に保存されない。登録要因を次に示す。

1の場合：

自イベントサーバから自イベントサーバあての発行

2の場合：

自イベントサーバから他イベントサーバあての発行（この値はアプリケーションで取得できません）

3の場合：

他イベントサーバから自イベントサーバあての発行

4の場合：

環境設定の指定による他イベントサーバから自イベントサーバへの転送

発行元プロセスID

数値（32ビット）

発行元APのプロセスID。

登録時刻

数値（32ビット）

発行元イベントサーバでの登録時刻（発行元ホストの時計に基づく。UTCの1970-01-01 00:00:00からの秒数）。

到着時刻

数値（32ビット）

自イベントサーバでの登録時刻（UTCの1970-01-01 00:00:00からの秒数）。この属性はJP1イベントのイベントサーバ間転送時に保存されない。

発行元ユーザーID

数値（32ビット）

発行元プロセスのユーザーID（数値）。WindowsとJavaでは環境設定による固定値（-1〜65,535）。

発行元グループID

数値（32ビット）

発行元プロセスのグループID（数値）。WindowsとJavaでは環境設定による固定値（-1〜65,535）。

発行元ユーザー名

文字列（0〜20バイト）

発行元プロセスのユーザー名。

発行元グループ名

文字列（0〜20バイト）

発行元プロセスのグループ名。WindowsとJavaではヌル文字列。

発行元イベントサーバ名※3

文字列（0〜255バイト）

発行元のイベントサーバ名。

JP1イベントが，エージェントホスト→サブマネージャーホスト→マネージャーホストのように転送された場合でも，最初のエージェントホストのイベントサーバ名が入る。

送信先イベントサーバ名※3

文字列（0〜255バイト）

発行元APが他イベントサーバへの転送を明示して指定した場合に，他イベントサーバの名称が入る。

発行元IPアドレス

バイト列（0〜16バイト）

発行元イベントサーバに対応するIPアドレス（NAT（ネットワークアドレス変換）やプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。

送信先IPアドレス

バイト列（0〜16バイト）

送信先イベントサーバに対応するIPアドレス（NAT（ネットワークアドレス変換）やプロキシを経由した場合および環境設定で転送したJP1イベントについては正確な値ではない）。

発行元別通し番号

数値（32ビット）

発行元ホストでのイベントDB内通し番号（転送によって値は変化しない）。※6

コードセット

文字列（0〜255バイト）

メッセージ・詳細情報・拡張属性が記述されている文字コードセット名。※4

メッセージ

文字列（0〜1,023バイト）※5

JP1イベントの内容を表した文字列。

詳細情報

文字列またはバイト列（0〜1,024バイト）※5

任意のデータ。

注※1　文字列は0を除く任意のバイト列です。バイト列は0を含むことがあります。

注※2　上位4バイト（基本コード），下位4バイト（拡張コード）で示される16進数で表現されます。例えば，00000111:00000000または111:0と表現します。値の範囲については各JP1プログラムのマニュアルを参照してください。また，ユーザーの使用できるIDは0:0〜1FFF:0および7FFF8000:0〜7FFFFFFF:0の範囲です。なお，拡張コードは必ず0になります。

注※3　通常，イベントサーバ名はホスト名です。

注※4　次の値などがあります。

8859_1（ISO-8859-1）

SJIS（シフトJIS）

EUCJIS（EUC日本語）

UTF-8（日本語UTF-8）

注※5　メッセージと詳細情報を合わせて1,024バイトに制限されます。メッセージと詳細情報の関係を次に示します。

詳細情報の有無と形式

メッセージなし

メッセージあり（文字列）

なし

−

1,023バイト

あり（文字列）

1,023バイト

合計1,022バイト

あり（バイト列）

1,024バイト

合計1,023バイト

注※6　値は0〜2,147,483,647の範囲です。2,147,483,647に達すると0に戻ります。ただし，登録要因が2のイベントなど，内部的に使用しているイベントは取得できないため，通し番号が抜けているように見える場合があります。

17.1.2　拡張属性

JP1イベントの拡張属性とは，JP1イベント発行元プログラムが任意に指定できる属性です。拡張属性には共通情報と固有情報があります。共通情報はJP1プログラムで統一されている情報を示します。ただし，設定項目は各JP1プログラムで異なります。固有情報は共通情報以外の拡張属性を示します。

表17‒2　共通情報の一覧

項目

属性名

内容

重大度

SEVERITY

JP1イベントの緊急性を表す。緊急性の高い順に，次の値がある。

"Emergency"（緊急）

"Alert"（警戒）

"Critical"（致命的）

"Error"（エラー）

"Warning"（警告）

"Notice"（通知）

"Information"（情報）

"Debug"（デバッグ）

ユーザー名

USER_NAME

業務を実行しているユーザー名。

プロダクト名

PRODUCT_NAME

JP1イベントを発行したプログラム名。次に示すプログラム名などがある。

"/HITACHI/JP1/AJS"

"/HITACHI/JP1/AOM"

"/HITACHI/JP1/IM"

"/HITACHI/JP1/NBQ"

"/HITACHI/JP1/NETMDM"

"/HITACHI/JP1/NPS"

"/HITACHI/JP1/NQSEXEC"

"/HITACHI/JP1/SES"

"/HITACHI/JP1/BASE"

オブジェクトタイプ

OBJECT_TYPE

オブジェクトの種類を表す。

"JOB" "JOBNET" "BATCHJOB" "ACTION" "LIST" "EVENTDB" "COMMAND" "LOGFILE" "SESSION" "SPMD"

オブジェクト名

OBJECT_NAME

ジョブ，ジョブネットなどのオブジェクトの名称。ジョブネットなど階層のあるオブジェクトの場合，最下層の要素。

登録名タイプ

ROOT_OBJECT_TYPE

オブジェクトの種別。通常はオブジェクトタイプと同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの種別となる。値の範囲はオブジェクトタイプと同じ。

登録名

ROOT_OBJECT_NAME

ユーザーの操作時に実行を指示する単位になる名称。通常はオブジェクト名と同じだが，ジョブネットなど階層のあるオブジェクトの場合，最上層のオブジェクトの名称になる。

オブジェクトID

OBJECT_ID

オブジェクトID。

PRODUCT_NAMEとの組み合わせによってオブジェクトのインスタンスを統合システム内で一意に意識できる文字列（形式は他製品に依存する。この情報はJP1/IM - Viewの［統合機能メニュー］画面から各製品のモニターを呼び出すときに使用する）。

事象種別

OCCURRENCE

オブジェクト名に示したオブジェクトに対して起こった事象。次に示す事象種別などがある。

"END"

"LATEEND"

"LATESTART"

"NOTICE"

"PAUSE"

"START"

"SWITCH"

"RECEIVE"

開始時刻

START_TIME

実行開始または再実行開始の時刻（UTC 1970-01-01 00:00:00からの秒数）。

終了時刻

END_TIME

実行終了の時刻（UTC 1970-01-01 00:00:00からの秒数）。

終了コード

RESULT_CODE

10進数文字列の終了コード。

17.2　JP1/Baseが出力するJP1イベント一覧

表17‒3　JP1/Baseが出力するJP1イベント一覧

イベントID

発行契機

メッセージ

00001011

スケールアウトによってエージェントホストが追加された場合

Agent host (エージェントホスト名) has scale-out.

00003D00

イベントDBを切り替えた場合

イベントDBを旧DB番号から新DB番号に切り替えました

00003D04

イベントサービスの再起動機能によって異常終了したプロセスを再起動した場合

イベントサービスは内部機能の再起動により回復しました

00003D05

jevagtfwコマンドでイベント転送抑止を実施してから，一定時間以上経過した場合

jevagtfwコマンドによるイベント転送抑止が累計抑止時間秒間継続しています (server=ホスト名)

00003D06

jevagtfwコマンドでイベント転送抑止を実施した場合

ホスト名のイベント転送を抑止しました

00003D07

jevagtfwコマンドでイベント転送抑止を解除した場合

ホスト名のイベント転送抑止を解除しました

00003D08

jevagtfwコマンドで受信イベント破棄を実施した場合

ホスト名から受信したイベントを破棄する状態にしました

00003D09

jevagtfwコマンドで受信イベント破棄を解除した場合

ホスト名のイベント受信破棄状態を解除しました

00003D0B※⁴

しきい値によるイベント転送抑止で大量発生イベントを検知して抑止を開始する場合

ホスト名はしきい値によるイベント転送抑止を開始します (抑止条件=識別子)

00003D0C※⁴

しきい値によるイベント転送抑止で，大量発生イベントの収束を検知して抑止状態を解除する場合

ホスト名はしきい値によるイベント転送抑止を解除しました (抑止条件=識別子)

00003D0D※⁴

しきい値によるイベント転送抑止で，リロード（jevreloadコマンドを実行）またはイベントサービス停止によって抑止状態を解除する場合

ホスト名はしきい値によるイベント転送抑止をすべて解除しました

00003D0E※⁴

しきい値によるイベント転送抑止で，抑止状態になってから，一定時間以上経過した場合

ホスト名のイベント転送抑止が累計抑止時間秒間継続しています (抑止条件=識別子)

00003A10※³

ログファイルトラップのリトライによってイベントサービスに再接続できた場合

ログファイルトラップのリトライが行われたため，イベント発行が遅延しました

00003A20※³

ログファイルトラップがログファイルの監視を開始できない場合

該当ログファイルの監視を開始出来ません

00003A21※³

APのログファイルの読み込みリトライ回数がしきい値をオーバーし，該当ログファイルの監視を停止した場合

指定された回数リトライ処理を行いましたが，該当ログファイルの読み込みが出来ないため監視を停止します

00003A22※³

APのログファイルの状態が異常となった場合

該当ログファイルを正しく監視することができない状態になりました

00003A25※³

ログファイルトラップの起動時，最初の対象ログファイルの監視を開始した場合

ログファイル(ファイル形式)の監視を開始しました

00003A26※³

ログファイルトラップの起動中（監視中）に，対象ログファイルの監視切り替えが発生した場合

ログファイル(ファイル形式)の監視を切り替えました

00003A27※³

UPDタイプのログファイルを監視中に，監視中のログファイルの状態が異常になった場合

ログファイル(ファイル形式)を正しく監視することができない状態となりました

00003A28※³

監視ファイル名の指定（ワイルドカード指定）に，該当するファイル数が上限を超えた場合

監視ファイル名に該当するファイル数が上限を超えたため，監視を停止します

00003A29※³

監視するログファイルを特定できなくなった場合

監視するログファイルを特定できないため，監視を停止します

00003A2A※³

ファイル数の増加によって，ファイル数の上限に近付いてきた場合

監視ファイル名に該当するファイル数がファイル数になりました

00003A30

リモート監視ログ（ログファイルトラップまたはイベントログトラップ）が，異常終了してから再起動した場合

前回停止時から今回起動時までのログのJP1イベントが登録されていないおそれがあります

00003A31

リモート監視ログ（ログファイルトラップまたはイベントログトラップ）が，イベントサービスへ接続できる状態で異常終了した場合

続行不可能なエラーが発生したためリモート監視を停止します

00003A32

リモート監視ログ（ログファイルトラップまたはイベントログトラップ）のリトライによって，イベントサービスに再接続できた場合

リモート監視のリトライが行われたため、イベント発行が遅延しました

00003A71またはイベントログトラップ動作定義ファイルのフィルターで指定されたイベントID

Windowsイベントのログメッセージを検知した場合

Windowsイベントのログメッセージ

ログファイルトラップ動作定義ファイルのACTDEFパラメーターで指定されたイベントID※³

APのログファイルのレコードを検知した場合

ログファイルの1行分のデータの内容

00003FA0※1

コマンド実行制御が［コマンド実行］画面からコマンド実行要求を受け取った場合

[ホスト名 : JP1ユーザー名] コマンド実行を開始しました

00003FA1※1

［コマンド実行］画面から実行要求されたコマンドが実行完了した場合

[ホスト名 : JP1ユーザー名] コマンド実行が終了しました

00003FA2※1

［コマンド実行］画面から実行要求されたコマンドが，何らかの原因で実行されなかった場合

[ホスト名 : JP1ユーザー名] コマンド実行が異常終了しました

00003FA3※1

jcocmddefコマンドで経過時間イベント発行間隔を指定している場合。

［コマンド実行］画面および自動アクションから実行要求されたコマンドが，経過時間イベント発行間隔を超えて実行している場合。

[ホスト名] コマンド実行の実行時間が数値秒を超えました

00003FA5※1

jcocmddefコマンドでコマンド先行入力数のしきい値が設定されている場合。自動アクションの先行入力数がしきい値に達した場合。

実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が閾値[xx件]を超えました

00003FA6※1

jcocmddefコマンドでコマンド先行入力数のしきい値が設定されている場合。自動アクションの先行入力数が0になった場合。

実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が0件になりました

00003FA7

コマンド実行履歴ファイルの自動再編成に失敗した場合

Restoration of the command execution log file failed.

00004700※2

認証サーバが閉塞状態になった場合

接続順序 : 認証サーバ名を閉塞状態に設定しました

00004701※2

認証サーバの閉塞状態が解除された場合

接続順序 : 認証サーバ名の閉塞状態を解除しました

00004702※2

全認証サーバが閉塞状態になった場合

全ての認証サーバが閉塞しました

00004720※2

プロセスが異常終了した場合

コンポーネント名 の管理対象プロセス名 は異常終了しました

00004721※2

プロセス起動時にタイムアウトした場合

コンポーネント名 のプロセス名 の起動がタイムアウトしました. 処理を継続します

00004722※2

異常終了したプロセスの再起動が完了した場合

コンポーネント名 の管理対象プロセス名 の再起動が完了しました

00004724※⁴

JP1/Baseの起動が完了した場合

ホスト名 のJP1/Baseを起動しました

00004725※⁴

JP1/Baseを停止する場合

ホスト名 のJP1/Baseを停止します

00004740

監視対象プロセスが異常終了した場合

機能名 が異常終了しました

00004741

監視対象プロセスが共有メモリーに一定期間アクセス（更新）しなくなった場合（重大度：Error）

機能名 が処理中のままnn秒経過しています

00004742

監視対象プロセスが共有メモリーに一定期間アクセス（更新）しなくなった場合（重大度：Warning）

機能名 が処理中のままnn秒経過しています． mm秒経過後にエラー状態になります

00004743

共有メモリーに一定期間アクセス（更新）していなかった監視対象プロセスが回復した場合

機能名 の正常状態が確認されました

00004747

ヘルスチェック機能が異常終了した場合

エラーが発生したため，ヘルスチェック機能を終了します

00004748

他ホスト監視中に異常を検知した場合（サービスが機能していない）

ホスト名 の サービス名 が機能していないため監視通知が出来ない状態です

00004749

他ホスト監視中に異常を検知した場合（ホストに接続できない）

ホスト名に接続できないため監視ができません. (要因メッセージ：詳細情報)

0000474A

他ホストを監視できるようになった場合。

停止中の監視対象ホストが起動した場合。

ホスト名 の監視が可能になりました

0000474B

共有メモリーが参照できない場合

共有メモリーがロックされています

0000474C

監視対象ホストが停止した場合

ホスト名 が停止中のため監視しません

0000474D

監視対象ホストが停止しているのか異常なのかの区別がつかない場合

停止通知を受けていないホスト名に接続できないため監視できません. (要因メッセージ：詳細情報)

0000474E

一部機能の共有メモリーが参照できない場合

機能名の状態が確認できません

0000474F

一部機能の共有メモリーが参照できない状態が続いている場合

機能名の状態が確認できない状態が続いています

00004750

一部機能の共有メモリーが参照できない状態から回復した場合

機能名の状態が確認できるようになりました

00004780

アクション実行の開始要求を受け付けたとき，JP1イベント（アクション開始イベント）を登録したとき

アクション実行の開始要求を受け付けました（アクション実行情報）

00004781

コマンドを実行して完了した場合，JP1イベント（アクション完了イベント）を登録したとき

アクション実行が完了しました（アクション実行情報）

00004782

コマンドを実行できないで完了した場合，JP1イベント（アクション完了イベント（実行不可））を登録したとき

アクションが実行できずに完了しました（アクション実行情報）

00004783

アクションがキャンセルされて完了した場合，JP1イベント（アクション完了イベント（キャンセル））を登録したとき

アクションがキャンセルされて完了しました（アクション実行情報）

注※1　JP1/IM - Manager用にjcocmddefコマンドを使って設定した場合にだけ，発行されるJP1イベントです。設定の詳細については，「15.　コマンド」の「jcocmddef」を参照してください。

注※2　認証サーバの閉塞状態の変更時，またはプロセスの異常終了時にJP1イベントを発行させる設定をした場合にだけ発行されます。認証サーバの閉塞状態，またはプロセスの異常をJP1イベントで監視したい場合は，「4.3　プロセスの異常終了および認証サーバの切り替え発生を検知する」を参照してください。

注※3　ログファイルトラップ，またはJP1/AJSのログ監視ジョブが発行します。

注※4　イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されるJP1イベントです。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

17.3　JP1イベントの詳細

JP1イベントの詳細をイベントID別に示します。

17.3.1　イベントID別JP1イベントの詳細

(1)　イベントID：00001011の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00001011

メッセージ

−

Agent host (エージェントホスト名) has scale-out.

拡張属性

共通情報

重大度

SEVERITY

Information

固有情報

OS種別

OS_TYPE

OSの名称（WindowsまたはLinux）

インストール情報

INSTALLPP_INFO

連携製品（JP1/PFM）のインストールの有無（PFM_InstallまたはPFM_Not_Install）

(2)　イベントID：00003D00の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003D00

メッセージ

−

イベントDBを旧DB番号から新DB番号に切り替えました

詳細情報

−

旧イベントDB番号

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

OBJECT_TYPE

EVENTDB

オブジェクト名

OBJECT_NAME

旧イベントDB番号

オブジェクトID

OBJECT_ID

イベントサーバ名:旧DB番号

事象種別

OCCURRENCE

SWITCH

固有情報

旧イベントDB番号

E0

旧イベントDB番号

(3)　イベントID：00003D04の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003D04

メッセージ

−

イベントサービスは内部機能の再起動により回復しました。

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

OBJECT_TYPE

EVENT

オブジェクト名

OBJECT_NAME

jevservice

事象種別

OCCURRENCE

NOTICE

(4)　イベントID：00003D05の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D05

メッセージ

B.MESSAGE

KAJP1087-W jevagtfwコマンドによるイベント転送抑止が累計抑止時間秒間継続しています (server=ホスト名)

拡張属性

共通情報

重大度

E.SEVERITY

Warning

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

JEVAGTFW

事象種別

E.OCCURRENCE

INTERVAL_PROGRESS

固有情報

抑止条件

E.HOST

ホスト名※

通知間隔

E.INTERVAL

通知する間隔（秒）

抑止時刻

E.SUPPRESSED_TIME

抑止した時刻

注※　英字はすべて大文字になります。

(5)　イベントID：00003D06の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D06

メッセージ

B.MESSAGE

KAJP1410-I ホスト名のイベント転送を抑止しました

拡張属性

共通情報

重大度

E.SEVERITY

Information

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

JEVAGTFW

事象種別

E.OCCURRENCE

START_SUPPRESS

固有情報

抑止条件

E.HOST

ホスト名※

注※　英字はすべて大文字になります。

(6)　イベントID：00003D07の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D07

メッセージ

B.MESSAGE

KAJP1421-I ホスト名のイベント転送抑止を解除しました

拡張属性

共通情報

重大度

E.SEVERITY

Information

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

JEVAGTFW

事象種別

E.OCCURRENCE

END_SUPPRESS

固有情報

抑止条件

E.HOST

ホスト名※

抑止時刻

E.SUPPRESSED_TIME

抑止した時刻

注※　英字はすべて大文字になります。

(7)　イベントID：00003D08の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D08

メッセージ

B.MESSAGE

KAJP1430-I ホスト名から受信したイベントを破棄する状態にしました

拡張属性

共通情報

重大度

E.SEVERITY

Information

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

JEVAGTFW

事象種別

E.OCCURRENCE

START_DISPOSE

固有情報

抑止条件

E.HOST

ホスト名※

注※　英字はすべて大文字になります。

(8)　イベントID：00003D09の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D09

メッセージ

B.MESSAGE

KAJP1424-I ホスト名のイベント受信破棄状態を解除しました

拡張属性

共通情報

重大度

E.SEVERITY

Information

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

JEVAGTFW

事象種別

E.OCCURRENCE

END_DISPOSE

固有情報

抑止条件

E.HOST

ホスト名※

抑止時刻

E.SUPPRESSED_TIME

破棄していた時間（秒）

注※　英字はすべて大文字になります。

(9)　イベントID：00003D0Bの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D0B

メッセージ

B.MESSAGE

KAJP1083-W ホスト名はしきい値によるイベント転送抑止を開始します (抑止条件=識別子)

拡張属性

共通情報

重大度

E.SEVERITY

Warning

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

FORWARD_SUPPRESS

事象種別

E.OCCURRENCE

START

固有情報

抑止条件

E.SUPPRESS_ID

識別子

注　このイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されます。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

(10)　イベントID：00003D0Cの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D0C

メッセージ

B.MESSAGE

KAJP1084-I ホスト名はしきい値によるイベント転送抑止を解除しました (抑止条件=識別子)

拡張属性

共通情報

重大度

E.SEVERITY

Information

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

FORWARD_SUPPRESS

事象種別

E.OCCURRENCE

END

固有情報

抑止条件

E.SUPPRESS_ID

識別子

注　このイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されます。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

(11)　イベントID：00003D0Dの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D0D

メッセージ

B.MESSAGE

KAJP1085-I ホスト名はしきい値によるイベント転送抑止をすべて解除しました

拡張属性

共通情報

重大度

E.SEVERITY

Information

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

FORWARD_SUPPRESS

事象種別

E.OCCURRENCE

END_ALL

固有情報

抑止条件

E.SUPPRESS_ID

*

注　このイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されます。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

(12)　イベントID：00003D0Eの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

B.ID

00003D0E

メッセージ

B.MESSAGE

KAJP1086-W ホスト名のイベント転送抑止が累計抑止時間秒間継続しています (抑止条件=識別子)

拡張属性

共通情報

重大度

E.SEVERITY

Warning

プロダクト名

E.PRODUCT_NAME

/HITACHI/JP1/IM

オブジェクトタイプ

E.OBJECT_TYPE

EVENT

オブジェクト名

E.OBJECT_NAME

jevservice

オブジェクトID

E.OBJECT_ID

FORWARD_SUPPRESS

事象種別

E.OCCURRENCE

INTERVAL_PROGRESS

固有情報

抑止条件

E.SUPPRESS_ID

識別子

注　このイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されます。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

(13)　イベントID：00003A10の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A10

メッセージ

−

KAVA3640-W ログファイルトラップのリトライが行われたため，イベント発行が遅延しました。(ID=ID番号[監視名])

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

jevlogstart

オブジェクトID

OBJECT_ID

リトライ処理をしたログファイルトラップのID番号

事象種別

OCCURRENCE

RECONNECT

固有情報

リトライ開始時刻

RETRY_START_TIME

リトライ処理が開始された時刻（UTC 1970-01-01 00:00:00からの秒数）

再接続時刻

RECONNECT_TIME

イベントサービスへ再接続が確認できた時刻（UTC 1970-01-01 00:00:00からの秒数）

保留イベント数

HOLD_EVENT

リトライ処理中に保留されたJP1イベントの件数

消去イベント数

DELETE_EVENT

リトライ処理中に消去されたJP1イベントの件数

(14)　イベントID：00003A20の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A20

メッセージ

−

KAVA3643-E 該当ログファイルの監視を開始出来ません (code=エラー番号, file name=ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

(15)　イベントID：00003A21の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A21

メッセージ

−

KAVA3644-E 指定された回数リトライ処理を行いましたが，該当ログファイルの読み込みが出来ないため監視を停止します (code=エラー番号, file name=ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイル監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

(16)　イベントID：00003A22の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A22

メッセージ

−

KAVA3645-E 該当ログファイルを正しく監視することができない状態になりました (code=数値, file name=ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

異常検知時刻

WATCH_CHECK_TIME

ログファイルの異常を検知した時刻（UTC 1970-01-01 00:00:00からの秒数）

(17)　イベントID：00003A25の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A25

メッセージ

−

KAVA3668-I ログファイル(ファイル形式)の監視を開始しました (id=プロセスID[監視名]/スレッドID[監視名], file name=ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

監視開始時刻

WATCH_START_TIME

対象ログファイルの監視を開始した時刻（UTC 1970-01-01 00:00:00からの秒数）

(18)　イベントID：00003A26の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A26

メッセージ

−

KAVA3669-I ログファイル(ファイル形式)の監視を切り替えました(id=プロセスID[監視名]/スレッドID[監視名], file name=ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

監視切替時刻

WATCH_CHANGE_TIME

対象ログファイルの監視を切り替えた時刻（UTC 1970-01-01 00:00:00からの秒数）

(19)　イベントID：00003A27の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A27

メッセージ

−

KAVA3670-E ログファイル(ファイル形式)を正しく監視することが出来ない状態となりました(id=プロセスID[監視名]/スレッドID[監視名], code=エラー番号, file name=ログファイル名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

異常検知時刻

WATCH_CHECK_TIME

ログファイルの異常を検知した時刻（UTC 1970-01-01 00:00:00からの秒数）

(20)　イベントID：00003A28の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A28

メッセージ

−

KAVA3671-E 監視ファイル名に該当するファイル数が上限を超えたため，監視を停止します (id=プロセスID[監視名]/スレッドID[監視名], FILETYPE=ファイル形式)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイルの監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

(21)　イベントID：00003A29の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A29

メッセージ

−

KAVA3672-E 監視するログファイルを特定できないため，監視を停止します (id=プロセスID[監視名]/スレッドID[監視名], code=エラー番号, FILETYPE=ファイル形式)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

監視停止時刻

WATCH_STOP_TIME

ログファイルの監視を停止した時刻（UTC 1970-01-01 00:00:00からの秒数）

(22)　イベントID：00003A2Aの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A2A

メッセージ

−

KAVA3673-W 監視ファイル名に該当するファイル数がファイル数になりました (id=プロセスID[監視名]/スレッドID[監視名] , FILETYPE=ファイル形式)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンドの-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名はjevlogstartコマンドの-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンドの-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

監視ログファイル（パス）名

オブジェクトID

OBJECT_ID

ログファイルトラップのID番号

事象種別

OCCURRENCE

NOTICE

固有情報

ファイル数チェック時刻

WATCH_FILECHECK_TIME

ファイル数のチェック時刻（UTC 1970-01-01 00:00:00からの秒数）

(23)　イベントID：00003A30の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A30

メッセージ

−

KAVA3909-W 前回停止時から今回起動時までのログのJP1イベントが登録されていないおそれがあります(接続先=イベントサーバ名,監視先=監視先,監視名=監視名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

ログ監視の場合：

jelallog

イベントログ監視の場合：

jelalelt

オブジェクトID

OBJECT_ID

問題を検出したリモート監視のID番号

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

MONITOR_HOST

監視対象ホスト名

監視名

MONITOR_NAME

監視名

(24)　イベントID：00003A31の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A31

メッセージ

−

KAVA3910-E 続行不可能なエラーが発生したためリモート監視を停止します(event server = イベントサーバ名,target host = 監視先,monitor name = 監視名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

Windowsの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

ログ監視の場合：

jelallog

イベントログ監視の場合：

jelalelt

オブジェクトID

OBJECT_ID

異常終了するリモート監視のID番号

事象種別

OCCURRENCE

NOTICE

固有情報

監視対象ホスト名

MONITOR_HOST

監視対象ホスト名

監視名

MONITOR_NAME

監視名

(25)　イベントID：00003A32の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003A32

メッセージ

−

KAVA3915-W リモート監視のリトライが行われたため、イベント発行が遅延しました (接続先=イベントサーバ名, 監視先=監視対象ホスト名, 監視名=監視名)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

Windowsの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名。

JP1/IMの［プロファイル表示/編集］画面の追加オプションに-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

ログ監視の場合：

jelallog

イベントログ監視の場合：

jelalelt

オブジェクトID

OBJECT_ID

リトライ処理をしたリモート監視のID番号

事象種別

OCCURRENCE

RECONNECT

固有情報

監視対象ホスト名

MONITOR_HOST

監視対象ホスト名

監視名

MONITOR_NAME

監視名

リトライ開始時刻

RETRY_START_TIME

リトライ処理が開始された時刻

（UTC 1970-01-01 00:00:00からの秒数）

再接続時刻

RECONNECT_TIME

イベントサービスへ再接続が確認できた時刻

（UTC 1970-01-01 00:00:00からの秒数）

保留イベント数

HOLD_EVENT

リトライ処理中に保留されたJP1イベントの件数

削除イベント数

DELETE_EVENT

リトライ処理中に消去されたJP1イベントの件数

(26)　イベントID：00003A71またはイベントログトラップ動作定義ファイルのフィルターで指定されたイベントIDの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

イベントログトラップ動作定義ファイルのフィルターで指定されたイベントID。

イベントIDの指定が省略された場合は，00003A71。

メッセージ

−

Windowsイベントログのメッセージ。※1

最大1,023バイト。超えた分は切り捨て。

拡張属性

共通情報

重大度

SEVERITY

Windowsログの種類に応じて登録する。

値：ログの種類

Critical：重大

Error：エラー

Warning：警告

Information：情報，詳細，その他

Notice：監査成功，監査失敗

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/NTEVENT_LOGTRAP/ソース

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

NTEVENTLOG

登録名タイプ

ROOT_OBJECT_

TYPE

LOGFILE

登録名

ROOT_OBJECT_

NAME

NTEVENTLOG

固有情報

Windowsログ登録日時

A0

time_t型（UTC 1970-01-01 00:00:00からの秒数）

コンピュータ名

A1

コンピュータ名

NTログ種別

A2

System/Security/Application/Setup/Directory Service/DNS Server/File Replication Service/Internet Explorer/Key Management Service/HardwareEvents

その他，イベントビューアの"ログの名前"に表示される内容。

NTログ種類

A3

Critical/Error/Warning/Information/Verbose/Audit_Success/Audit_Failure

その他，イベントビューアの"レベル"に表示される内容。

セキュリティログの場合，イベントビューアの"キーワード"に表示される内容。

NTログ分類

A4

分類。

分類できなかった場合：None

イベントビューアの"タスクのカテゴリ"に表示される内容。

NTイベントID

A5

WindowsのイベントID

NTユーザー名

A6

Windowsのユーザー名。

ユーザー名がわからなかった場合：N/A

NTログレベル※2

A7

レベル。

イベントビューアの"レベル"に表示される内容。

最大256バイト。超えた分は切り捨て。

NTログキーワード※2

A8

キーワード。

イベントビューアの"キーワード"に表示される内容。

最大256バイト。超えた分は切り捨て。

NTログオペコード※2

A9

オペコード。

イベントビューアの"オペコード"に表示される内容。

最大256バイト。超えた分は切り捨て。

プラットフォーム

PLATFORM

NT

PP名

PPNAME

リモート監視のイベントログトラップの場合

/HITACHI/JP1/IM/REMOTE_MONITORING/EVENTLOGTRAP

JP1/Baseのイベントログトラップの場合

/HITACHI/JP1/NTEVENT_LOGTRAP

Windowsバージョン番号※2

OS_VERSION

Windowsメジャーバージョン番号

発生元ホスト名※3

JP1_SOURCEHOST

発生元ホスト名

監視名※4

JP1_TRAP_NAME

イベントログトラップ動作定義ファイルに指定された監視名

注※1　イベントログの説明文を記載したメッセージDLLが正しく設定されていない場合は，挿入句や詳細コードをダブルクォーテーションマーク（"）で囲んでJP1イベントのメッセージに登録します。

注※2　イベントログトラップ動作定義ファイルにext-attr-optionパラメーターを指定すると作成される情報です。ext-attr-optionパラメーターを指定しない場合は作成されません。

注※3　リモート監視のイベントログトラップで，JP1/IM - Managerの共通定義設定用ファイルの共通定義属性（"ATTR_EVENT_LOGTRAP_SOURCEHOST"）に，「00000001」を指定すると作成される情報です。JP1/IM - Managerの共通定義設定用ファイルについては，マニュアル「JP1/Integrated Management 3 - Manager コマンド・定義ファイルリファレンス」を参照してください。

注※4　イベントログトラップ動作定義ファイルのフィルターでtrap-nameパラメーターを指定すると作成される情報です。trap-nameパラメーターを指定しない場合は作成されません。

(27)　ログファイルトラップ動作定義ファイルのACTDEFパラメーターで指定されたイベントIDの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

ACTDEFパラメーターに指定されている値

メッセージ

−

ログファイル1行分のログデータの内容

拡張属性

共通情報

重大度

SEVERITY

動作定義ファイルのACTDEFパラメーターで指定された重大度

プロダクト名

PRODUCT_NAME

Windowsの場合：

jevlogstartコマンド，またはJP1/IMの［プロファイル表示/編集］画面の追加オプションに，-pオプションを指定した場合

/HITACHI/JP1/NT_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンド，またはJP1/IMの［プロファイル表示/編集］画面の追加オプションに，-pオプションを指定していない場合

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

jevlogstartコマンド，またはJP1/IMの［プロファイル表示/編集］画面の追加オプションに，-pオプションを指定した場合

/HITACHI/JP1/UX_LOGTRAP/プログラム名

プログラム名は-pオプションで指定したログデータ出力元プログラム名。

jevlogstartコマンド，またはJP1/IMの［プロファイル表示/編集］画面の追加オプションに，-pオプションを指定していない場合

/HITACHI/JP1/UX_LOGTRAP

オブジェクトタイプ

OBJECT_TYPE

LOGFILE

オブジェクト名

OBJECT_NAME

起動コマンドのオプションで指定したログファイル名

登録名タイプ

ROOT_OBJECT_

TYPE

LOGFILE

登録名

ROOT_OBJECT_

NAME

起動コマンドのオプションで指定したログファイル名

固有情報

プラットフォーム

PLATFORM

Windowsの場合：NT

UNIXの場合：UNIX

PP名

PPNAME

リモート監視のログファイルトラップの場合

/HITACHI/JP1/IM/REMOTE_MONITORING/LOGTRAP

JP1/Baseのログファイルトラップの場合

Windowsの場合：

/HITACHI/JP1/NT_LOGTRAP

UNIXの場合：

/HITACHI/JP1/UX_LOGTRAP

ホスト名

JP1_SOURCEHOST

ログの発生元ホスト名

監視ID

JP1_TRAP_ID

ログファイルトラップのID番号

監視名

JP1_TRAP_NAME

監視名※

注※　jevlogstartコマンドに-aオプションを指定した場合だけ出力されます。

(28)　イベントID：00003FA0の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FA0

メッセージ

−

KAVB2100-I [ホスト名 : JP1ユーザー名] コマンド実行を開始しました。

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCOCMD

オブジェクトタイプ

OBJECT_TYPE

COMMAND

オブジェクト名

OBJECT_NAME

JCOCMD

事象種別

OCCURRENCE

NOTICE

ユーザー名

USER_NAME

コマンドを実行するJP1ユーザー名

開始時刻

START_TIME

コマンド実行要求受付時刻

固有情報

実行先ホスト

EXECHOST

コマンド実行先ホスト名

実行コマンド

EXECCMD

実行するコマンド名

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名

(29)　イベントID：00003FA1の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FA1

メッセージ

−

KAVB2101-I [ホスト名 : JP1ユーザー名] コマンド実行が終了しました。

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCOCMD

オブジェクトタイプ

OBJECT_TYPE

COMMAND

オブジェクト名

OBJECT_NAME

JCOCMD

事象種別

OCCURRENCE

NOTICE

ユーザー名

USER_NAME

コマンドを実行するJP1ユーザー名

終了時刻

END_TIME

コマンド終了時刻

終了コード

RESULT_CODE

実行したコマンドのリターンコード

固有情報

実行先ホスト

EXECHOST

コマンド実行先ホスト名

実行コマンド

EXECCMD

実行したコマンド名

(30)　イベントID：00003FA2の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FA2

メッセージ

−

KAVB2102-E [ホスト名 : JP1ユーザー名] コマンド実行が異常終了しました。

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCOCMD

オブジェクトタイプ

OBJECT_TYPE

COMMAND

オブジェクト名

OBJECT_NAME

JCOCMD

事象種別

OCCURRENCE

NOTICE

ユーザー名

USER_NAME

コマンドを実行するJP1ユーザー名

終了時刻

END_TIME

コマンド異常終了時刻

(31)　イベントID：00003FA3の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FA3

メッセージ

−

KAVB2402-W [ホスト名] コマンド実行の実行時間が数値秒を超えました

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCOCMD

オブジェクトタイプ

OBJECT_TYPE

COMMAND（［コマンド実行］画面の場合）

ACTION（自動アクションの場合）

オブジェクト名

OBJECT_NAME

JCOCMD

事象種別

OCCURRENCE

NOTICE

ユーザー名

USER_NAME

コマンドを実行するJP1ユーザー名

開始時刻

START_TIME

コマンド実行要求受付時刻

固有情報

実行先ホスト

EXECHOST

コマンド実行先ホスト名

実行コマンド

EXECCMD

実行するコマンド名

投入元ホスト

REQUESTHOST

コマンドを投入したホスト名

コマンドID

COMMANDID

コマンドID

実行時間

EXEC_TIME

コマンドの実行経過時間

(32)　イベントID：00003FA5の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FA5

メッセージ

−

KAVB2071-W 実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が閾値[xx件]を超えました。

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCOCMD

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCOCMD

事象種別

OCCURRENCE

NOTICE

ユーザー名

USER_NAME

コマンドを実行するJP1ユーザー名

開始時刻

START_TIME

コマンド実行要求受付時刻

固有情報

実行先ホスト

EXECHOST

コマンド実行先ホスト名

投入元ホスト

REQUESTHOST

コマンドを投入したホスト名

(33)　イベントID：00003FA6の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FA6

メッセージ

−

KAVB2072-I 実行先ホスト名で実行元ホスト名から要求されたコマンドの先行入力数が0件になりました。

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCOCMD

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCOCMD

事象種別

OCCURRENCE

NOTICE

ユーザー名

USER_NAME

コマンドを実行するJP1ユーザー名

開始時刻

START_TIME

コマンド実行要求受付時刻

固有情報

実行先ホスト

EXECHOST

コマンド実行先ホスト名

投入元ホスト

REQUESTHOST

コマンドを投入したホスト名

(34)　イベントID：00003FA7の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00003FA7

メッセージ

−

KAVB2641-E Restoration of the command execution log file failed.

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/IM/JCOCMD

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

JCOCMD

事象種別

OCCURRENCE

Error

(35)　イベントID：00004700の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004700

メッセージ

−

KAVA1524-W 接続順序: 認証サーバ名 was successfully blocked.

KAVA1524-W接続順序 : 認証サーバ名を閉塞状態に設定しました.

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSSESS

オブジェクトタイプ

OBJECT_TYPE

SESSION

オブジェクト名

OBJECT_NAME

認証サーバを閉塞したホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

接続失敗先ホスト名

AUTHSRV_NAME

閉塞された認証サーバ名

(36)　イベントID：00004701の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004701

メッセージ

−

KAVA1525-I 接続順序: 認証サーバ名 was successfully unblocked.

KAVA1525-I 接続順序 : 認証サーバ名の閉塞状態を解除しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSSESS

オブジェクトタイプ

OBJECT_TYPE

SESSION

オブジェクト名

OBJECT_NAME

認証サーバの閉塞を解除したホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

接続失敗先ホスト名

AUTHSRV_NAME

閉塞解除された認証サーバ名

(37)　イベントID：00004702の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004702

メッセージ

−

KAVA1396-E All authentication servers were blocked.

KAVA1396-E 全ての認証サーバが閉塞しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSSESS

オブジェクトタイプ

OBJECT_TYPE

SESSION

オブジェクト名

OBJECT_NAME

すべての認証サーバへの接続が閉塞したホスト名

事象種別

OCCURRENCE

NOTICE

(38)　イベントID：00004720の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004720

メッセージ

−

KAVB3737-E The コンポーネント名 管理対象プロセス名 terminated abnormally

KAVB3737-E コンポーネント名 の管理対象プロセス名 は異常終了しました

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

異常終了したプロセス名

事象種別

OCCURRENCE

NOTICE

(39)　イベントID：00004721の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004721

メッセージ

−

KAVB3613-W コンポーネント名 timeout occurred in 管理対象プロセス名. Processing continues.

KAVB3613-Wコンポーネント名 のプロセス名 の起動がタイムアウトしました. 処理を継続します

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

起動タイムアウトしたプロセス名

事象種別

OCCURRENCE

NOTICE

(40)　イベントID：00004722の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004722

メッセージ

−

KAVB3616-I Restart of the コンポーネント名 管理対象プロセス名 has finished.

KAVB3616-I コンポーネント名 の管理対象プロセス名 の再起動が完了しました

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

再起動したプロセス名

事象種別

OCCURRENCE

NOTICE

(41)　イベントID：00004724の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004724

メッセージ

−

KAVB3664-I ホスト名 のJP1/Baseを起動しました

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

起動したホスト名

事象種別

OCCURRENCE

NOTICE

注　このイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されます。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

(42)　イベントID：00004725の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004725

メッセージ

−

KAVB3665-I ホスト名 のJP1/Baseを停止します

拡張属性

共通情報

重大度

SEVERITY

Notice

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/SPMD

オブジェクトタイプ

OBJECT_TYPE

SPMD

オブジェクト名

OBJECT_NAME

停止するホスト名

事象種別

OCCURRENCE

NOTICE

注　このイベントは，イベントフィルターの抽出条件に一致しなくても，転送設定ファイル（forward）に記載されているすべての転送先へ転送されます。転送したくない場合は，除外条件に記述するか，イベントサーバ設定ファイル（conf）のoptionsパラメーターにauto-forward-offフラグを指定してください。

(43)　イベントID：00004740の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004740

メッセージ

−

KAVA7017-E 機能名 が異常終了しました. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

異常終了した機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

内部機能名

SFUNCTION_NAME

内部機能名

プロセスID

PROCESS_ID

プロセスID

スレッドID

THREAD_ID

スレッドID

(44)　イベントID：00004741の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004741

メッセージ

−

KAVA7014-E 機能名 が処理中のままnn秒経過しています. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

内部機能名

SFUNCTION_NAME

内部機能名

プロセスID

PROCESS_ID

プロセスID

スレッドID

THREAD_ID

スレッドID

(45)　イベントID：00004742の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004742

メッセージ

−

KAVA7013-W 機能名 が処理中のままnn秒経過しています. mm秒経過後にエラー状態になります． (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

内部機能名

SFUNCTION_NAME

内部機能名

プロセスID

PROCESS_ID

プロセスID

スレッドID

THREAD_ID

スレッドID

(46)　イベントID：00004743の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004743

メッセージ

−

KAVA7016-I 機能名 の正常状態が確認されました. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

内部機能名

SFUNCTION_NAME

内部機能名

プロセスID

PROCESS_ID

プロセスID

スレッドID

THREAD_ID

スレッドID

(47)　イベントID：00004747の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004747

メッセージ

−

KAVA7003-E エラーが発生したため，ヘルスチェック機能を終了します. (ホスト名=ホスト名)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

ホスト名

事象種別

OCCURRENCE

NOTICE

(48)　イベントID：00004748の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004748

メッセージ

−

KAVA7222-E ホスト名 の サービス名 が機能していないため監視通知が出来ない状態です.

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

ホスト名

事象種別

OCCURRENCE

NOTICE

固有情報

サービス名

SERVICE_NAME

サービス名

(49)　イベントID：00004749の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004749

メッセージ

−

KAVA7223-E ホスト名に接続できないため監視ができません. (要因メッセージ：詳細情報)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

ホスト名

事象種別

OCCURRENCE

NOTICE

(50)　イベントID：0000474Aの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

0000474A

メッセージ

−

KAVA7224-I ホスト名 の監視が可能になりました.

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

ホスト名

事象種別

OCCURRENCE

NOTICE

(51)　イベントID：0000474Bの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

0000474B

メッセージ

−

KAVA7030-E 共有メモリーがロックされています. (ホスト名=ホスト名, プロセス名=プロセス名, 機能名=機能名, 内部機能名=内部機能名, pid=プロセスID, tid=スレッドID)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

内部機能名

SFUNCTION_NAME

内部機能名

プロセスID

PROCESS_ID

プロセスID

スレッドID

THREAD_ID

スレッドID

(52)　イベントID：0000474Cの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

0000474C

メッセージ

−

KAVA7228-I ホスト名 が停止中のため監視しません

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

監視しないホスト名

事象種別

OCCURRENCE

NOTICE

(53)　イベントID：0000474Dの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

0000474D

メッセージ

−

KAVA7229-W 停止通知を受けていないホスト名に接続できないため監視ができません. (要因メッセージ：詳細情報)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

監視できないホスト名

事象種別

OCCURRENCE

NOTICE

(54)　イベントID：0000474Eの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

0000474E

メッセージ

−

KAVA7032-W 機能名の状態が確認できません. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid = プロセスID, tid = スレッドID)

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

内部機能名

SFUNCTION_NAME

内部機能名

プロセスID

PROCESS_ID

プロセスID

スレッドID

THREAD_ID

スレッドID

(55)　イベントID：0000474Fの詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

0000474F

メッセージ

−

KAVA7033-E 機能名の状態が確認できない状態が続いています. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid = プロセスID, tid = スレッドID)

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

内部機能名

SFUNCTION_NAME

内部機能名

プロセスID

PROCESS_ID

プロセスID

スレッドID

THREAD_ID

スレッドID

(56)　イベントID：00004750の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004750

メッセージ

−

KAVA7034-I 機能名の状態が確認できるようになりました. (ホスト名=ホスト名, プロセス名=プロセス名, 内部機能名=内部機能名, pid = プロセスID, tid = スレッドID)

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/JBSHC

オブジェクトタイプ

OBJECT_TYPE

JBSHC

オブジェクト名

OBJECT_NAME

機能名

事象種別

OCCURRENCE

NOTICE

固有情報

ホスト名

HOST_NAME

ホスト名

プロセス名

PROCESS_NAME

プロセス名

内部機能名

SFUNCTION_NAME

内部機能名

プロセスID

PROCESS_ID

プロセスID

スレッドID

THREAD_ID

スレッドID

(57)　イベントID：00004780の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004780

メッセージ

−

KNAM3203-I アクション実行の開始要求を受け付けました（アクション実行情報）

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/LOCAL_ACTION

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

LOCAL ACTION

オブジェクトID

OBJECT_ID

アクション名

ユーザー名

USER_NAME

JP1ユーザー名

開始時刻

START_TIME

アクション実行の開始時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクションイベント通番

ACT_EVENT_SEQ

アクションの契機となったJP1イベントの通し番号

アクションイベントID

ACT_EVENT_ID

アクションの契機となったJP1イベントID

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名※

実行コマンド

EXECCMD

実行するコマンド名（属性変数展開後）

注※　未使用時は空文字が設定されます。

(58)　イベントID：00004781の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004781

メッセージ

−

KNAM3210-I アクション実行が完了しました（アクション実行情報）

拡張属性

共通情報

重大度

SEVERITY

Information

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/LOCAL_ACTION

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

LOCAL ACTION

オブジェクトID

OBJECT_ID

アクション名

ユーザー名

USER_NAME

JP1ユーザー名

開始時刻

START_TIME

アクション実行の開始時刻

終了時刻

END_TIME

アクション実行の終了時刻

終了コード

RESULT_CODE

アクションで実行したコマンドの終了コード

事象種別

OCCURRENCE

NOTICE

固有情報

アクションイベント通番

ACT_EVENT_SEQ

アクションの契機となったJP1イベントの通し番号

アクションイベントID

ACT_EVENT_ID

アクションの契機となったJP1イベントID

プロセスID

EXEC_PID

実行したプロセスID/スレッドID※

OSユーザー名

EXEC_USER

実行したOSユーザー名※

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名※

実行コマンド

EXECCMD

実行したコマンド名（属性変数展開後）

注※　未使用時は空文字が設定されます。

(59)　イベントID：00004782の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004782

メッセージ

−

KNAM3211-E アクションが実行できずに完了しました（アクション実行情報）

拡張属性

共通情報

重大度

SEVERITY

Error

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/LOCAL_ACTION

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

LOCAL ACTION

オブジェクトID

OBJECT_ID

アクション名

ユーザー名

USER_NAME

JP1ユーザー名

開始時刻

START_TIME

アクション実行の開始時刻

終了時刻

END_TIME

アクション実行の終了時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクションイベント通番

ACT_EVENT_SEQ

アクションの契機となったJP1イベントの通し番号

アクションイベントID

ACT_EVENT_ID

アクションの契機となったJP1イベントID

プロセスID

EXEC_PID

実行したプロセスID/スレッドID※

OSユーザー名

EXEC_USER

実行したOSユーザー名※

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名※

実行コマンド

EXECCMD

実行するコマンド名（属性変数展開後）

エラーコード

ERR_CODE

実行できなかった要因のエラー番号

注※　未使用時や定まっていない場合は空文字が設定されます。

(60)　イベントID：00004783の詳細

属性種別

項目

属性名

内容

基本属性

イベントID

−

00004783

メッセージ

−

KNAM3212-W アクションがキャンセルされて完了しました（アクション実行情報）

拡張属性

共通情報

重大度

SEVERITY

Warning

プロダクト名

PRODUCT_NAME

/HITACHI/JP1/BASE/LOCAL_ACTION

オブジェクトタイプ

OBJECT_TYPE

ACTION

オブジェクト名

OBJECT_NAME

LOCAL ACTION

オブジェクトID

OBJECT_ID

アクション名

ユーザー名

USER_NAME

JP1ユーザー名

開始時刻

START_TIME

アクション実行の開始時刻

終了時刻

END_TIME

アクション実行の終了時刻

事象種別

OCCURRENCE

NOTICE

固有情報

アクションイベント通番

ACT_EVENT_SEQ

アクションの契機となったJP1イベントの通し番号

アクションイベントID

ACT_EVENT_ID

アクションの契機となったJP1イベントID

プロセスID

EXEC_PID

実行したプロセスID/スレッドID※

OSユーザー名

EXEC_USER

実行したOSユーザー名※

環境変数ファイル名

EXECENV

実行時に使用する環境変数ファイル名※

実行コマンド

EXECCMD

実行するコマンド名（属性変数展開後）

注※　未使用時や定まっていない場合は空文字が設定されます。

第6編　トラブルシューティング編

18　トラブルシューティング

この章では，JP1/Baseでトラブルの原因になりやすい項目やトラブルへの対処方法などについて説明します。

18.1　対処の手順

JP1/Baseでトラブルが起きた場合の対処の手順を次の図に示します。

図18‒1　トラブル発生時の対処の手順

18.2　ログ情報の種類

JP1/Baseを運用しているときに出力されるログ情報は4種類あります。

共通メッセージログ

統合トレースログ

プロセス別ログ

操作ログ

この節では4種類のログ情報について説明します。

18.2.1　共通メッセージログ

共通メッセージログとは，システム側のトラブルを通知する，システム管理者向けのログ情報のことです。共通メッセージログは，必要最小限のトラブル情報を通知します。

共通メッセージログは，UNIXの場合はsyslog，Windowsの場合はWindowsイベントログに出力されます。

なお，SUSE Linux 15以降の場合，デフォルトの設定ではsyslogには出力されずに，ジャーナルと呼ばれるログファイルに出力されます。共通メッセージログをsyslogに出力する場合は，syslog出力が有効である必要があります。syslog出力を有効化する手順については「3.4.8　SUSE Linux 15以降で運用する場合のsyslog出力について」を参照してください。

18.2.2　統合トレースログ

統合トレースログとは，各プログラムが出力するトレース情報を，統合トレース機能（HNTRLib2）を通じて，一つの出力先ファイルにまとめて採取するログ情報のことです。共通メッセージログより詳しい内容のメッセージが出力されます。

統合トレースログの初期設定の出力先は次のとおりです。

Windowsの場合

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥hntr2{1|2|3|4}.log

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2{1|2|3|4}.log

UNIXの場合

/var/opt/hitachi/HNTRLib2/spool/hntr2{1|2|3|4}.log

出力先やログファイルのサイズなどを参照したり，変更したりする場合は，hntr2utl2コマンド，hntr2confコマンド，またはhntr2getconfコマンドで実行できます。詳細については，「15.　コマンド」の「hntr2utl2（Windows限定）」，「hntr2utl2（UNIX限定）」，「hntr2conf」，または「hntr2getconf」を参照してください。

統合トレースログファイルは，任意のテキストエディターで参照できます。統合トレースログの出力例を次の図に示します。

図18‒2　統合トレースログファイルの出力例

統合トレースログファイルに出力されるヘッダー情報と出力項目の説明を次の表に示します。

表18‒1　統合トレースログファイルのヘッダー情報

ヘッダー情報

説明

OS情報

統合トレース機能が起動しているOSの情報が出力されます。

ホスト名

統合トレース機能が起動しているホスト名が出力されます。

タイムゾーン

Windowsの場合

OSのタイムゾーンが出力されます。

UNIXの場合

統合トレースプロセスの環境変数TZが出力されます。

環境変数TZが設定されていない場合はUnknownと出力されます。

統合トレースログ機能起動時刻

統合トレース機能を起動した時刻が出力されます。

表18‒2　統合トレースログファイルの出力項目

出力項目

説明

番号（4桁）

トレースレコードの通番

番号はログを出力したプロセスごとに採番されます。

日付（10バイト）

トレースの取得日付：yyyy/mm/dd（年/月/日）

時刻（12バイト）

トレースの取得時刻（ローカル時刻）：hh:mm:ss.sss（時:分:秒.ミリ秒）

AP名（16バイト以内）

アプリケーションを識別するための名称（アプリケーション識別名）。

プロセス管理

JBS_SPMD

起動管理

JP1ControlSvc

認証アクセス制御

jp1BsSess

操作権限アクセス制御

jp1BsAcl

認証サーバ

jbssessionmgr

構成管理

jbsroute

コマンド実行（制御プロセス）

jcocmdrouter

コマンド実行（JP1/Base間通信プロセス）

jcocmdcom

コマンド実行（JP1/IM - M，JP1/Base間通信プロセス）

jcocmdapi

コマンド実行（実行制御プロセス）

jcocmdexe

コマンド実行（実行プロセス）

jcocmdcmc

プラグインサービス

jbsplugin

プラグイン（マネージャーコマンド）

jbsrmtcmd

プラグイン（エージェントコマンド）

plAdapter_Event

ヘルスチェック(自ホスト監視用)

jbshcd

ヘルスチェック(他ホスト監視用)

jbshchostd

イベントサービス

jevservice

JP1/AJS互換プロセス

jevsessvc

ログファイルトラップ(Windows)

jevtraplog

ログファイルトラップ(UNIX)

jevlogd

イベントログトラップ

jevtrapevt

その他のコマンド名

コマンド名

pid

プロセスID。OSが付けるプロセスID。

tid

スレッドID。スレッドを識別するためのID。

メッセージID

メッセージの出力形式で説明したメッセージID。この製品で使用するメッセージID。

メッセージテキスト

統合トレースログに出力されるメッセージのテキスト。この製品から出力されるメッセージテキスト。

重要

統合トレースログに出力されるログの時刻は，出力したプロセスのタイムゾーンでフォーマットされます。

このため，環境変数TZを変更したユーザーなどがサービスを起動したり，コマンドを実行したりすると，OSに設定されているタイムゾーンと異なる時刻が出力されることがあります。

18.2.3　プロセス別ログ

プロセス別ログとは，JP1/Baseの各機能が出力するログ情報のことです。各機能によって異なるログファイルに出力されます。出力されるログファイルについては，「18.2.5　ログファイルおよびディレクトリ一覧」を参照してください。

18.2.4　操作ログ

操作ログとは，認証サーバに対して「いつ」「だれが」「何を行ったか」などの操作情報の履歴を出力するログ情報です。操作ログの詳細については，「付録I　操作ログの出力」を参照してください。

18.2.5　ログファイルおよびディレクトリ一覧

(1)　Windowsの場合

Windows版JP1/Baseが出力するログ情報の種類と初期設定のログファイルの一覧については，「付録A.1(2)　ログファイル一覧（Windowsの場合）」を参照してください。

(2)　UNIXの場合

UNIX版JP1/Baseが出力するログ情報の種類と初期設定のログファイルの一覧については，「付録A.2(2)　ログファイル一覧（UNIXの場合）」を参照してください。

18.3　トラブル発生時に採取が必要な資料

JP1/Baseでは採取が必要な資料を一括採取するための「資料採取ツール」を用意しています。資料採取ツールは，Windowsの場合バッチファイル（jbs_log.bat）で，UNIXの場合シェルスクリプト（jbs_log.sh）で提供しています。これら資料採取ツールの詳細については，「15.　コマンド」の「jbs_log.bat（Windows限定）」および「jbs_log.sh（UNIX限定）」を参照してください。

資料採取ツールの初期設定で採取できる資料については，次に示す表中に記号で示しています。

18.3.1　トラブル発生時に採取が必要な資料（Windowsの場合）

(1)　OSのシステム情報

次に示すOSのログ情報の採取が必要です。これらの情報は資料採取ツールで採取できます。

情報の種類

採取資料

ファイル名※1

資料採取日時

date /tの実行結果

time /tの実行結果

date.log

Windowsイベントログ

アプリケーションログ：

システムフォルダ¥system32¥config¥AppEvent.Evt

システムログ：

システムフォルダ¥system32¥config¥SysEvent.Evt

SysEvent(Backup).evt

AppEvent(Backup).evt

マシンに設定されているホスト名の設定

システムフォルダ¥system32¥drivers¥etc¥hosts

hosts

マシンに設定されているサービスポートの設定

システムフォルダ¥system32¥drivers¥etc¥services

services

NICの実装状況

ipconfig /allの実行結果

ipconfig.log

起動サービス一覧

net startの実行結果

netstart.log

マシンの環境変数

setの実行結果

set.log

ワトソンログファイル※2

ユーザー指定フォルダ¥drwtsn32.log

drwtsn32.log

クラッシュダンプ※2

ユーザー指定フォルダ¥user.dmp

user.dmp

マシンのシステム情報

msinfo32 /report ファイル名の実行結果

msinfo32.log

適用HotFix一覧

systeminfoの実行結果

hotfix.log

ユーザー権利の割り当て

secedit /export /cfg ファイル名/areas USER_RIGHTS /quietの実行結果

secedit.log

グループポリシー

gpresult /zの実行結果

gpresult.log

動的ポートの範囲（IPV4）

netsh int ipv4 show dynamicporttcpの実行結果

dynamicport_ipv4.log

動的ポートの範囲（IPV6）

netsh int ipv6 show dynamicporttcpの実行結果

dynamicport_ipv6.log

ルーティング情報

netstat -rnの実行結果

netstat_rn.log

注※1　資料採取ツールを実行したあとの格納先でのファイル名です。

注※2　あらかじめ出力設定をしておく必要があります。設定方法については，「4.7　トラブル発生時の資料採取の準備（Windows限定）」を参照してください。

(2)　JP1/Baseの情報

JP1/Baseに関する次の情報の採取が必要です。これらの情報は資料採取ツールで採取できます。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

情報の種類

採取資料

ファイル名※1

環境設定情報

インストール先フォルダ¥conf以下のファイル

採取元のファイル名と同じファイル名

インストール先フォルダ¥default¥以下のファイル

採取元のファイル名と同じファイル名

インストール先フォルダ¥plugin¥conf¥以下のファイル

採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥conf以下のファイル※2

採取元のファイル名と同じファイル名

共通定義情報

jbsgetcnfコマンドの実行結果

jbsgetcnfコマンドで指定したファイル

jbsgetcnf -h論理ホスト名の実行結果※2

ログ情報

インストール先フォルダ¥log¥以下のファイル

採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥log¥以下のファイル※2

採取元のファイル名と同じファイル名

%ALLUSERSPROFILE%¥Hitachi¥jp1¥jp1_default¥JP1Base¥log¥以下のファイル※4

採取元のファイル名と同じファイル名

%ALLUSERSPROFILE%¥Hitachi¥jp1¥論理ホスト名¥JP1Base¥log¥以下のファイル※4

採取元のファイル名と同じファイル名

インストールログ

Windowsのインストール先フォルダ¥Temp¥jp1common¥jp1base¥hliclib*.log

採取元のファイル名と同じファイル名

Windowsのインストール先フォルダ¥TEMP¥RF¥以下のファイル

採取元のファイル名と同じファイル名

サービス稼働情報

インストール先フォルダ¥sys¥OPI¥以下のファイル

採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥sys¥OPI¥以下のファイル

採取元のファイル名と同じファイル名

イベントサービスの設定情報

インストール先フォルダ¥sys¥tmp¥event¥以下のファイル

採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥event¥以下のファイル※2

採取元のファイル名と同じファイル名

イベントDB

インストール先フォルダ¥sys¥event¥以下のファイル※3

採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥event¥以下のファイル※2※3

採取元のファイル名と同じファイル名

コマンド実行履歴

インストール先フォルダ¥log¥COMMAND以下のファイル※3

採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥log¥Command¥以下のファイル※2※3

採取元のファイル名と同じファイル名

統合トレースログ

システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

システムドライブ¥Program Files¥Hitachi¥HNTRLib2¥spool¥hntr2*.log

採取元のファイル名と同じファイル名

ファイル一覧

dir /s インストール先フォルダの実行結果

dir_jp1base.log

dir /s 共有フォルダ¥jp1baseの実行結果

dir_jp1base.log

バージョン情報

システムドライブ¥Program Files

¥InstallShield Installation Information

¥{F8C71F7C-E5DE-11D3-A21E-006097C00EBC}¥setup.ilg，setup.ini

base_setup.ilg，base_setup.ini

パッチ適用履歴

インストール先フォルダ¥Patchlog.txt

Patchlog_jp1base.txt

JP1/Baseのバインド状況

netstat -naoの実行結果

netstat.log

ネットワークアドレス解決のためのホスト名

jbsgethostbynameの実行結果

jbsgethostbyname.log

フォルダのアクセス権限

cacls インストール先フォルダの実行結果

cacls_jp1base.log

cacls 共有フォルダ¥jp1baseの実行結果

cacls インストール先フォルダ¥logの実行結果

cacls_jp1base_log.log

cacls 共有フォルダ¥jp1base¥logの実行結果

cacls インストール先フォルダ¥log¥COMMANDの実行結果

cacls_jp1base_log_COMMAND.log

cacls 共有フォルダ¥jp1base¥log¥COMMANDの実行結果

cacls インストール先フォルダ¥sysの実行結果

cacls_jp1base_sys.log

cacls インストール先フォルダ¥sys¥eventの実行結果

cacls_jp1base_sys_event.log

cacls インストール先フォルダ¥sys¥event¥serversの実行結果

cacls_jp1base_sys_event_servers.log

cacls インストール先フォルダ¥sys¥event¥servers¥defaultの実行結果

cacls_jp1base_sys_event_servers_default.log

cacls 共有フォルダ¥jp1base¥eventの実行結果

cacls_jp1base_event.log

日立総合インストーラのログファイル

Windowsのインストール先フォルダ¥Temp¥HCDINST¥以下のファイル

左記ファイルのコピーファイル

製品情報ファイル

システムドライブ¥Program Files¥Hitachi¥jp1common¥jp1base¥jp1base.dat

採取元のファイル名と同じファイル名

jp1hosts2情報

インストール先フォルダ¥sys¥jp1hosts2¥以下のファイル

採取元のファイル名と同じファイル名

共有フォルダ¥jp1base¥sys¥jp1hosts2¥以下のファイル※2

採取元のファイル名と同じファイル名

jbshosts2exportの実行結果

jbshosts2export_JP1_DEFAULT.log

jbshosts2export -h 論理ホスト名の実行結果※2

jbshosts2export_論理ホスト名.log

統合トレースログの排他制御種別

hntr2getconf -tの実行結果

hntr2conf_f.log，hntr2x64conf_f.log

統合トレースログの設定情報

hntr2getconf -f -b -n -s -wの実行結果

hntr2conf_f.log，hntr2x64conf_f.log

形名およびバージョン情報

インストール先フォルダ¥Version.txt

採取元のファイル名と同じファイル名

ライセンス種別情報

インストール先フォルダ¥ProductInfo.txt

採取元のファイル名と同じファイル名

共通定義情報退避ファイル

Windowsのインストール先フォルダ¥Temp¥JP1_COMDEF¥以下のファイル

採取元のファイル名と同じファイル名

注　イベントサーバインデックスファイル（index）で別パスを指定している場合，および統合トレースログの出力先を変更している場合は，指定したパス，および変更した出力先から直接採取してください。

注※1　資料採取ツールを実行したあとの格納先でのファイル名です。

注※2　論理ホスト（クラスタ）環境の資料を採取する際に採取します。

注※3　イベントDBおよびコマンド実行履歴を採取する場合，ファイルサイズが大きく，資料採取にディスク容量が必要となる場合があります。資料採取する場合，事前にファイルサイズを確認してください。

注※4　インストール時の環境変数「%ALLUSERSPROFILE%」に設定されている値になります。

(3)　JP1/Baseのプロセス一覧

Windowsのタスク マネージャでプロセスの動作状態を確認します。

(4)　オペレーション内容

トラブル発生時のオペレーション内容について次に示す情報が必要です。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/IM - Managerの構成）

再現性

JP1/IM - Viewからログインしている場合のログインユーザー名

(5)　画面上のエラー情報

次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー（および詳細ボタンがある場合はその内容）

(6)　ユーザーダンプ

JP1/Baseのプロセスがアプリケーションエラーで停止した場合は，ユーザーダンプを採取してください。

(7)　問題レポートの採取

JP1/Baseのプロセスがアプリケーションエラーで停止した場合は，問題レポートを採取してください。

18.3.2　トラブル発生時に採取が必要な資料（UNIXの場合）

(1)　OSのシステム情報

次に示すOSのログ情報の採取が必要です。これらの情報は資料採取ツールで採取できます。

情報の種類

採取資料

ファイル名※1

資料採取日時

dateの実行結果

jp1_default_base_1st.tar.Z，date.log

シスログ（syslog）

/var/adm/syslog/syslog.log（AIX）※2

/var/log/messages（Linux）※2※3

jp1_default_base_1st.tar.Z，syslog.log

マシンに設定されているホスト名

/etc/hosts

jp1_default_base_1st.tar.Z，hosts

マシンに設定されているサービスポートの設定

/etc/services

jp1_default_base_1st.tar.Z，services

マシンに設定されているユーザーの一覧

/etc/passwd

jp1_default_base_1st.tar.Z，passwd

ネットワークインターフェースの状態情報

ip linkの実行結果（Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，およびSUSE Linux 15）

netstat -inの実行結果（上記以外）

jp1_default_base_1st.tar.Z，netstat_in.log

プロセス一覧

ps -elfaの実行結果

jp1_default_base_1st.tar.Z，ps.log

マシンの環境変数

envの実行結果

jp1_default_base_1st.tar.Z，env.log

カーネルパラメーター情報

AIX：

lsattr -E -l sys0の実行結果

ulimit -aの実行結果

/etc/security/limits※3

Linux：

/sbin/sysctl -aの実行結果

ulimit -aの実行結果

jp1_default_base_1st.tar.Z

AIX：

lsatt.log

ulimit.log

limits

Linux：

sysctl.log

ulimit.log

ページサイズ情報

pagesizeの実行結果（AIX）

採取しない（Linux）

jp1_default_base_1st.tar.Z，pagesize.log

共有メモリー情報

ipcs -aの実行結果

jp1_default_base_1st.tar.Z,ipcs.log

メモリー情報

lsps -sの実行結果（AIX）

cat /proc/meminfo（Linux）

jp1_default_base_1st.tar.Z，swapinfo.log

ディスク情報

df -kの実行結果

jp1_default_base_1st.tar.Z，df.log

システム診断状況

/usr/bin/alog -o -t bootの実行結果（AIX）※3

/bin/dmesgの実行結果（Linux）

jp1_default_base_1st.tar.Z，sys_info.log

OSのパッチ適用状況

AIX：

lslpp -l -a

/usr/bin/instfix -a -icv

Linux：

/bin/rpm -qa

jp1_default_base_1st.tar.Z，patch_info.log

OSのバージョン情報

uname -aの実行結果

jp1_default_base_1st.tar.Z，uname_a.log

インストール済みの日立製品情報

/etc/.hitachi/pplistd/pplistd

jp1_default_base_1st.tar.Z，pplistd

ネットワークアドレス解決のためのホスト名

jbsgethostbynameの実行結果

jp1_default_base_1st.tar.Z，jbsgethostbyname.log

Linuxリリース情報

/etc/redhat-release（Linux）※

注※　存在する場合にだけ採取します。

jp1_default_base_1st.tar.Z，redhat-release

/etc/os-release(Linux)

jp1_default_base_1st.tar.Z，os-release

ネームサービス設定ファイル

/etc/netsvc.conf（AIX）

/etc/nsswitch.conf（Linux）

jp1_default_base_1st.tar.Z，netsvc.conf（AIX），nsswitch.conf（Linux）

DNSサーバ設定ファイル

/etc/resolv.conf

jp1_default_base_1st.tar.Z，resolv.conf

ネットワーク・インターフェースの設定

ifconfig -aの実行結果

jp1_default_base_1st.tar.Z，ifconfig.log

ルーティング情報

ip routeの実行結果（Linux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux 9，SUSE Linux 12，およびSUSE Linux 15）

netstat -rnの実行結果（上記以外）

jp1_default_base_1st.tar.Z，netstat_rn.log

ジャーナル（journal）

journalctl -l --no-pagerコマンド実行結果※4

jp1default_base_1st.tar.Z，journal.log

注※1　資料採取ツールを実行したあとの圧縮ファイルおよび解凍後のファイル名です（圧縮ファイル，解凍後のファイルの順に記載しています）。Linuxでは，拡張子がgzになります。

注※2　syslogファイルは，ファイル名が異なる場合があります。

注※3　JP1/Base管理者権限で資料採取ツールを実行した場合，これらの資料は権限不足で採取できません。

注※4　journalログをテキスト出力します。

　オプションは，次の通りです。

　　-l：出力を切り詰めない。

　　--no-pager：出力をページャーにパイプしない。

(2)　JP1/Baseの情報

JP1/Baseに関する次の情報の採取が必要です。これらの情報は資料採取ツールで採取できます。また，ネットワーク接続でのトラブルの場合，接続先マシン上のファイルの採取も必要です。

情報の種類

採取資料

ファイル名

環境設定情報

/etc/opt/jp1base/conf/以下のファイル

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

/etc/opt/jp1base/default/以下のファイル

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

/opt/jp1base/plugin/conf/以下のファイル

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/conf以下のファイル※1

論理ホスト名_1st.tar.Z，採取元のファイル名と同じファイル名

共通定義情報

/opt/jp1/hcclibcnf/

（jbsgetcnfコマンドを実行した出力結果でも確認できます）

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

/etc/opt/jp1base/default/以下のファイル

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

ログ情報

/var/opt/jp1base/log/以下のファイル

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/log※1※2

論理ホスト名_base_1st.tar.Z，採取元のファイル名と同じファイル名

インストールログ

/tmp/HITACHI_JP1_INST_LOG/jp1base_inst{1|2|3|4|5}.log

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

/etc/.hitachi/.hliclog/hliclib*{1|2|3|4|5}.log

採取元のファイル名と同じファイル名

/etc/.hitachi/.hliclog/hliccmd{1|2|3|4|5}.log

採取元のファイル名と同じファイル名

/tmp/rf/以下のファイル

採取元のファイル名と同じファイル名

サービス稼働情報

/var/opt/jp1base/sys/OPI/以下のファイル

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/sys/OPI/以下のファイル

論理ホスト名_base_1st.tar.Z，採取元のファイル名と同じファイル名

イベントサービスの設定情報

/var/opt/jp1base/sys/tmp/event/以下のファイル

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/event/以下のファイル※1

論理ホスト名_base_1st.tar.Z，採取元のファイル名と同じファイル名

イベントDB

/var/opt/jp1base/sys/event/以下のファイル

jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/event/以下のファイル※1

論理ホスト名_base_2nd.tar.Z，採取元のファイル名と同じファイル名

コマンド実行履歴

/var/opt/jp1base/log/COMMAND以下のファイル

jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/log/COMMAND以下のディレクトリ

jp1_default_base_2nd.tar.Z，採取元のファイル名と同じファイル名

プロセスの動作状況（イベントサービスを除く）

jbs_spmd_statusの実行結果

jp1_default_base_1st.tar.Z，jbs_spmd_status.log

jbs_spmd_status -h 論理ホスト名の実行結果※1

jp1_default_base_1st.tar.Z，jbs_spmd_status_論理ホスト名.log

イベントサービスのプロセスの動作状況

jevstatコマンドの実行結果

jp1_default_base_1st.tar.Z，jevstat.log

jevstat 論理ホスト名の実行結果※1

jp1_default_base_1st.tar.Z，jevstat_論理ホスト名.log

統合トレースログファイル

/var/opt/hitachi/HNTRLib2/spool/hntr2*.log

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

ISAMの保守情報

Jischkコマンドの実行結果

物理ホスト指定時：

/var/opt/jp1base/log/COMMAND

論理ホスト指定時：

共有ディレクトリ/jp1base/log/COMMAND

物理ホスト指定時：

jp1_default_base_1st.tar.Z，com.jischk,log

論理ホスト指定時：

jp1_default_base_1st.tar.Z，com.jischk_論理ホスト名.log

coreの解析情報※3，※5，※6

carコマンドの実行結果

（/var/opt/jp1base/，および/opt/jp1base/以下のcoreファイルの解析結果）

jp1_default_base_2nd.tar.Z，core_モジュール名.log

jp1_default_base_2nd.tar.Z，core_モジュール名_car.tar.Z（Linux 9以降の場合はcore_モジュール名_car.tar）

ファイル一覧

lsコマンドの実行結果

ls -lRa /opt/jp1base

ls -lRa /etc/opt/jp1base

ls -lRa /var/opt/jp1base

jp1_default_base_1st.tar.Z，inst_dir.log

lsコマンドの実行結果※1

ls -lRa 共有ディレクトリ/jp1base

ls -lRa 共有ディレクトリ/event

jp1_default_base_1st.tar.Z，share_dir.log

パッチ適用履歴

/opt/jp1base/PatchInfo

jp1_default_base_1st.tar.Z，PatchInfo

パッチログ情

報

/opt/jp1base/PatchLog

jp1_default_base_1st.tar.Z，PatchLog

JP1/Baseのバインド状況

ss -napの実行結果（OSがLinux 7，Linux 8，Linux 9，Oracle Linux 7，Oracle Linux 8，Oracle Linux9，SUSE Linux 12，およびSUSE Linux 15の場合）

netstat -naの実行結果（OSがAIXの場合）

jp1_default_base_1st.tar.Z，netstat_na.log

jp1hosts2情報

/var/opt/jp1base/sys/jp1hosts2/以下のファイル

jp1_default_base_1st.tar.Z，採取元のファイル名と同じファイル名

共有ディレクトリ/jp1base/sys/jp1hosts2/以下のファイル※1

論理ホスト名_base_1st.tar.Z，採取元のファイル名と同じファイル名

jbshosts2exportの実行結果

jp1_default_base_1st.tar.Z，jbshosts2export_JP1_DEFAULT.log

jbshosts2export -h 論理ホスト名の実行結果※1

論理ホスト名_base_1st.tar.Z，jbshosts2export_論理ホスト名.log

JP1/Base管理者の設定内容※4

jbssetadmingrp -vの実行結果

jp1_default_base_1st.tar.Z，jbssetadmin.log

統合トレースログの排他制御種別

hntr2getconf -tの実行結果

hntr2getconf_t.log

統合トレースログの設定情報

hntr2getconf -f -b -n -s -wの実行結果

hntr2getconf_f.log

共通定義情報退避ファイル

/tmp/JP1_COMDEF/以下のファイル

採取元のファイル名と同じファイル名

注　イベントサーバインデックスファイル（index）で別パスを指定している場合，および統合トレースログの出力先を変更している場合は，資料採取ツールに次のオプションを指定して，指定したパス，および変更した出力先の情報を採取してください。

jbs_log.sh (任意のオプション) [indexファイルで指定したディレクトリ]

jbs_log.sh (任意のオプション) [統合トレースログの出力先ディレクトリ]

注※1　論理ホスト（クラスタ）環境の資料を採取する際に採取します。

注※2　イベントDBおよびコマンド実行履歴を採取する場合，ファイルサイズが大きく，資料採取にディスク容量が必要となる場合があります。資料採取する場合，事前にファイルサイズを確認してください。

注※3　Linuxでは，次の注意事項があります。

Linuxでは，標準設定でコアファイル出力時の最大サイズが「0」となっている場合があります。この場合，コアダンプは出力されません。このため，コアダンプが出力できるように，jbs_startスクリプトおよびjbs_start.clusterスクリプトは標準で，次のように設定されています。

if [ 'uname' = Linux ]; then

ulimit -c unlimited

fi

この設定がご使用マシンのセキュリティポリシーに反する場合は，次のように行の先頭に「#」を付けてコメント行に変更してください。コメント行に変更すると，ファイルの設定は無効になります。ただし，JP1/Baseのプロセスがセグメンテーション障害やバス障害などのコアダンプ出力契機に，コアダンプが出力されないため，調査ができないことがあります。

#if [ 'uname' = Linux ]; then

#ulimit -c unlimited

#fi

注※4　資料採取ツールをJP1/Base管理者権限で実行した場合，この情報は権限不足で採取できません。

注※5　コアダンプファイルに関連するABRTの設定（Linux限定）では，次の注意事項があります。

自動バグレポートツール（ABRT）をインストールしているLinuxでは，ABRTの設定でプロセスやOSアカウントのユーザーまたはユーザーのグループに対してコアダンプファイルの生成を制限している場合，JP1/Baseのプロセスで発生したセグメンテーション障害やバス障害などのコアダンプファイルの出力契機に，コアダンプが出力されないため調査できません。

ご使用の運用に合わせて，JP1/Baseを実行するOSアカウントのユーザーまたはユーザーのグループやプロセスに対して，コアダンプファイルの生成を制限しないようにABRTの設定を見直してください。詳細については，ご使用のLinuxのドキュメントを参照してください。

注※6　Red Hat Enterprise Linux 8以降の環境で資料を採取する場合，デフォルトの設定ではシステムを再起動する前に出力されたcoreファイルの解析情報を採取できません。

再起動する前に出力されたcoreファイルの解析情報を採取できるように，次の手順でJP1/Baseを起動する前にジャーナルを永続化してください。

1. /etc/systemd/journald.confを開いて編集する。

[...]

[Journal]

Storage=persistent

#Compress=yes

:

2. systemd-journaldを再起動する。

systemctl restart systemd-journald

(3)　オペレーション内容

トラブル発生時のオペレーション内容について次に示す情報が必要です。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/IM - Managerの構成）

再現性

JP1/IM - Viewからログインしている場合のログインユーザー名

(4)　画面上のエラー情報

次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー（および詳細ボタンがある場合はその内容）

18.4　資料の採取方法

18.4.1　資料の採取方法（Windowsの場合）

(1)　資料採取ツールを実行する

資料採取ツール（jbs_log.bat）を実行します。

jbs_log.batを実行すると，同ホスト上のJP1/Baseの障害調査に必要な資料を採取できます。

資料採取ツールで採取する資料の総容量はご使用の環境によって大きく変化します。実行する前に次に示す方法で容量を見積もり，ご使用のマシンの空き容量を確認してください。

jbs_log.batで物理ホストを指定した場合のデータサイズ

jbs_log.batで物理ホストを指定し（オプションを指定しない），JP1/Baseおよびマシン環境情報の資料を採取するときは，以下の方法で採取する資料のサイズを見積もれます。

データサイズ = 5 + a + b + c + d メガバイト

a

インストール先フォルダ¥log¥以下のデータサイズ（最大45メガバイト※1）

b

インストール先フォルダ¥sys¥以下のデータサイズ（最大55メガバイト※2）

c

ワトソンログおよびクラッシュダンプのデータサイズ

d

以下のファイルの合計値

システムドライブ（C:¥WINNTなど）¥system32¥config¥AppEvent.evt

システムドライブ（C:¥WINNTなど）¥system32¥config¥SysEvent.evt

注※1　JP1/IM - Managerを同一のホストで使用する場合には，さらに142メガバイト必要です。

注※2　初期設定値です。イベントDBのサイズを変更した場合には増加します。

jbs_log.batで論理ホストを指定した場合のデータサイズ

jbs_log.batで論理ホストを指定し，JP1/Baseおよびマシン環境情報の資料を採取するときは，以下の方法で採取する資料のサイズを見積もれます。

データサイズ = 5 + a + b + c + d + e + f メガバイト

a

インストール先フォルダ¥log¥以下のデータサイズ（最大45メガバイト※1）

b

インストール先フォルダ¥sys¥以下のデータサイズ（最大55メガバイト※2）

c

ワトソンログおよびクラッシュダンプのデータサイズ

d

以下のファイルの合計値

システムドライブ（C:¥WINNTなど）¥system32¥config¥AppEvent.evt

システムドライブ（C:¥WINNTなど）¥system32¥config¥SysEvent.evt

e

共有フォルダ¥jp1base¥log¥のデータサイズ（最大45メガバイト※1）

f

共有フォルダ¥jp1base¥event¥のデータサイズ（最大55メガバイト※2）

注※1　JP1/IM - Managerを同一のホストで使用する場合には，さらに142メガバイト必要です。

注※2　初期設定値です。イベントDBのサイズを変更した場合には増加します。最大値の見積もりはリリースノートを参照してください。

フォルダのデータサイズは，エクスプローラ上で右クリックをして表示されるメニューの［フォルダのプロパティ］画面で確認できます。

各フォルダのディスク占有量の最大値の見積もりは，リリースノートを参照してください。

次にツールの実行例を示します。

c:¥>c:¥usertools¥jbs_log.bat 資料格納フォルダ

資料格納フォルダは，フルパスで指定してください。パスに空白を含む場合は，ダブルクォーテーションマーク（"）で囲んで指定してください。

ツールを実行すると，資料格納フォルダに指定したディレクトリの下にjp1_defaultフォルダが作成されます。-hオプションを指定した場合は，jp1_defaultフォルダと論理ホスト名のフォルダが作成されます。各フォルダの下に，base_1stとbase_2ndのフォルダが作成され，そのフォルダの中に採取した資料がコピーされます。必要に応じて採取した資料を圧縮ツールなどで圧縮してください。

なお，jbs_log.batでは，コマンド実行履歴ファイル（ISAM）やイベントDBなどを採取しないオプションを提供しています。詳細については，「15.　コマンド」の「jbs_log.bat（Windows限定）」を参照してください。

(2)　プロセスの状態を確認する

Windowsのタスク マネージャを使って，プロセスの動作状態を確認してください。正常に動作している場合に表示されるプロセスを次に示します。なお，表内の(　)内の数値は同時に実行できるプロセス数です。

親プロセス名

機能

子プロセス名

機能

hntr2srv.exe(1)

統合トレース起動用

−

−

hntr2mon.exe(1)

統合トレース

−

−

jbs_service.exe(1)

JP1/Baseプロセス管理起動用※1

−

−

jbs_spmd.exe(1)

JP1/Baseプロセス管理※1

jbssessionmgr.exe(1)

認証サーバ※1※3

認証サーバとして設定したホスト上にだけ存在する。

jbs_spmd_statusコマンドを実行した場合の表示名はjbssessionmgrとなる。

jbsroute.exe(1)

構成管理※1※3

jbs_spmd_statusコマンドを実行した場合の表示名はjbsrouteとなる。

jcocmd.exe(1)

jcocmdexe.exe(1)

jcocmdapi.exe

(コマンド実行画面数※2+1(JP1/IM - Managerがインストールされている場合))

コマンド実行※1※3

jbs_spmd_statusコマンドを実行した場合の表示名はjcocmdとなる。

jbsplugind.exe

プラグインサービス※1※3

jbs_spmd_statusコマンドを実行した場合の表示名はjbspluginとなる。

jbshcd.exe(1)

ヘルスチェック（自ホスト監視用）※1※3

jbs_spmd_statusコマンドを実行した場合の表示名はjbshcdとなる。

jbshchostd.exe(1)

ヘルスチェック（他ホスト監視用）※1※3

jbs_spmd_statusコマンドを実行した場合の表示名はjbshchostdとなる。

jbssrvmgr.exe(1)

サービス管理制御機能※1※3

jbs_spmd_statusコマンドを実行した場合の表示名はjbssrvmgrとなる。

jbslcact.exe(1)

ローカルアクション機能※1※3

jbs_spmd_statusコマンドを実行した場合の表示名はjbslcactとなる。

jbscomd.exe(1)

jbscomd_api.exe(1)

jbscomd_ses.exe(1)

jbscomd_snd.exe(1)

jbscomd_rcv.exe(1)

プロセス間通信※1※3

jbs_spmd_statusコマンドを実行した場合の表示名はjbscomdとなる。

jbapmsrvcecon.exe(1)

起動管理

powendar.exe(1)

電源制御

JP1/Power Monitorがインストールされていると，このプロセスが生成される。

jevservice.exe(1)

イベントサービス※1※4

−

−

jevtraplog.exe(1)

ログファイルトラップ

−

ログファイルトラップを使用した場合だけ生成される。

jevtrapevt.exe(1)

イベントログトラップ

−

イベントログトラップを使用した場合だけ生成される。

（凡例）

−：なし

注※1　クラスタシステムで複数の論理ホストが一つの物理ホスト上で動作する場合，または一つの論理ホストと物理ホストが同時に起動される場合は，上記のプロセスの同時に実行できるプロセス数の上限は，（論理ホスト数+1）×プロセス数となります。

注※2　接続しているJP1/IM - Viewがコマンド実行画面を開いている数のことです。開いている画面数だけプロセス数が増えます。コマンド実行画面を閉じると，閉じた分だけプロセスは消滅します。

注※3　これらのプロセスの状態は，jbs_spmd_statusコマンドで確認できます。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合

jbssessionmgr

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

認証サーバが設定されていない場合

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

注※4　これらのプロセスの状態は，jevstatコマンドで確認できます。jevstatコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

jevservice

(3)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/IM - Managerの構成）

再現性

JP1/IM - Viewからログインしている場合のログインユーザー名

(4)　画面上のエラー情報を採取する

画面にエラーが表示された場合は，その情報も採取します。次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー

詳細ボタンがある場合は，その内容もコピーしてください。

(5)　問題レポートを採取する

JP1/Baseのプロセスがアプリケーションエラーで停止した場合，次の手順で問題レポートを採取してください。

コントロールパネルの［アクション センター］をクリックする。

［メンテナンス］をクリックする。

［問題レポートの解決策を確認］から，［信頼性履歴の表示］をクリックする。

［問題レポートをすべて表示］をクリックする。

該当する問題をダブルクリックする。

［クリップボードにコピー］を選択する。

テキストエディターなどにコピーし，保存する。

18.4.2　資料の採取方法（UNIXの場合）

(1)　資料採取ツールを実行する

資料採取ツール（jbs_log.sh）を実行します。

jbs_log.shを実行すると，同ホスト上のJP1/Baseの障害調査に必要な資料を採取できます。

資料採取ツールで採取する資料の総容量はご使用の環境によって大きく変化します。実行する前に次に示す方法で容量を見積もり，ご使用のマシンの空き容量を確認してください。

jbs_log.shで物理ホストを指定した場合のデータサイズ

jbs_log.shで物理ホストを指定し（オプションを指定しない），JP1/Baseおよびマシン環境情報の資料を採取するときは，以下の方法で採取する資料のサイズを見積もれます。

データサイズ = 3 + a + b +（60 × c） メガバイト

a

/var/opt/jp1base/以下のデータサイズ（最大508メガバイト※1※2）

b

/直下のcoreのサイズ（存在する場合だけ）

c

/直下，/var/opt/jp1base/，または/opt/jp1base/以下のcoreの数

注※1　JP1/IM - Managerを同一のホストで使用する場合には，さらに254メガバイト必要です。

注※2　初期設定値です。イベントDBのサイズを変更した場合には増加します。最大値の見積もりはリリースノートを参照してください。

jbs_log.shで論理ホストを指定した場合のデータサイズ

jbs_log.shで論理ホストを指定し，JP1/Baseおよびマシン環境情報の資料を採取するときは，以下の方法で採取する資料のサイズを見積もれます。

データサイズ = 3 + a + b +（60 × c）+ d + e メガバイト

a

/var/opt/jp1base/以下のデータサイズ（最大83メガバイト※1※2）

b

/直下のcoreのサイズ（存在する場合だけ）

c

/直下，/var/opt/jp1base/，または/opt/jp1base/以下のcoreの数

d

共有ディレクトリ/jp1base/log/のデータサイズ（最大45メガバイト※1）

e

共有ディレクトリ/event/のデータサイズ（最大55メガバイト※2）

注※1　JP1/IM - Managerを同一のホストで使用する場合には，さらに142メガバイト必要です。

注※2　初期設定値です。イベントDBのサイズを変更した場合には増加します。最大値の見積もりはリリースノートを参照してください。

フォルダのデータサイズは，duコマンドを使用して確認できます。

各フォルダのディスク占有量の最大値の見積もりは，リリースノートを参照してください。

次に，ツールの実行例を示します。

jbs_log.sh -f 出力ファイル名

なお，jbs_log.shでは，コマンド実行履歴ファイル（ISAM）やイベントDBなどを採取しないオプションを提供しています。詳細については，「15.　コマンド」の「jbs_log.sh（UNIX限定）」を参照してください。

(2)　プロセスの状態を確認する

psコマンドを使用したときに表示されるプロセスを次に示します。UNIXの場合は，資料採取ツール（jbs_log.sh）を実行すると，ほかの資料とともにpsコマンドの実行結果を採取できます。

表内の(　)内の数値は同時に実行できるプロセス数です。

親プロセス名

機能

子プロセス名

機能

hntr2mon(1)

統合トレース

−

−

jbs_spmd(1)

プロセス管理※1

jbssessionmgr(1)

認証サーバ※1※4

認証サーバとして設定したホスト上にだけ存在する。

jbs_spmd_statusコマンドを実行した場合の表示名はjbssessionmgrとなる。

jbsroute(1〜9)

構成管理※1※4

jbs_spmd_statusコマンドを実行した場合の表示名はjbsrouteとなる。

jcocmd(1)

jcocmdexe(1)

jcocmdapi(コマンド実行画面数※2+1(JP1/IM - Managerがインストールされている場合))

jcocmdcmc(0〜コマンド数※3)

コマンド実行※1※4

jbs_spmd_statusコマンドを実行した場合の表示名はjcocmdとなる。

jbsplugind※5

プラグインサービス※1※4

jbs_spmd_statusコマンドを実行した場合の表示名はjbspluginとなる。

jbshcd(1)

ヘルスチェック（自ホスト監視用）※1※4

jbs_spmd_statusコマンドを実行した場合の表示名はjbshcdとなる。

jbshchostd(1)

ヘルスチェック（他ホスト監視用）※1※4

jbs_spmd_statusコマンドを実行した場合の表示名はjbshchostdとなる。

jbssrvmgr(1)

サービス管理制御機能※1※4

jbs_spmd_statusコマンドを実行した場合の表示名はjbssrvmgrとなる。

jbslcact(1)

ローカルアクション機能※1※4

jbs_spmd_statusコマンドを実行した場合の表示名はjbslcactとなる。

jbscomd(1)

jbscomd_api(1)

jbscomd_ses(1)

jbscomd_snd(1)

jbscomd_rcv(1)

プロセス間通信※1※4

jbs_spmd_statusコマンドを実行した場合の表示名はjbscomdとなる。

jevservice(1)

イベントサービス※1※6

jevservice(5〜9,999)

イベントサービス

jevlogd(1〜2)

ログファイルトラップ

jelparentim

(0〜jevlogstartコマンド実行数)

ログファイルトラップ

jelparentim一つにつき，監視するファイル数分jelchildimプロセスが生成される。なお，jevlogstopコマンドを実行すれば，jelparentimプロセスは消滅する。

（凡例）

−：なし

注※1　クラスタシステムで複数の論理ホストが一つの物理ホスト上で動作する場合，または一つの論理ホストと物理ホストが同時に起動される場合は，上記のプロセスの同時に実行できるプロセス数の上限は，（論理ホスト数+1）×プロセス数となります。

注※2　接続しているJP1/IM - Viewがコマンド実行画面を開いている数のことです。開いている画面数だけプロセス数が増えます。コマンド実行画面を閉じると，閉じた分だけプロセスは消滅します。

注※3　JP1/IM - Managerによるリモートコマンドや自動アクションの実行数のことです。コマンド一つにつき，プロセスが一つ生成されます。処理が完了すると，プロセスは消滅します。なお，コマンドを連続して実行した場合，複数のプロセスが生成されることがあります。

注※4　これらのプロセスの状態は，jbs_spmd_statusコマンドで確認できます。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合

jbssessionmgr

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

認証サーバが設定されていない場合

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

注※5　ps-elコマンドで表示されるプロセス名は，「jbsplugin」となります。

注※6　これらのプロセスの状態は，jevstatコマンドで確認できます。jevstatコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

jevservice

(3)　オペレーション内容を確認する

トラブル発生時のオペレーション内容を確認し，記録しておいてください。確認が必要な情報を次に示します。

オペレーション内容の詳細

発生時刻

マシン構成（各OSのバージョン，ホスト名，JP1/IM - Managerの構成）

再現性

JP1/IM - Viewからログインしている場合のログインユーザー名

(4)　画面上のエラー情報を採取する

画面にエラーが表示された場合は，その情報も採取します。次に示すハードコピーを採取してください。

エラーダイアログボックスのハードコピー

詳細ボタンがある場合は，その内容もコピーしてください。

18.5　トラブルへの対処方法

この節では，トラブル発生時の現象別の対処方法について説明します。

18.5.1　OS共通のトラブル

(1)　短時間に大量のJP1イベントが発生し，登録遅延，転送遅延が発生した。

障害の発生によって突発的に大量のJP1イベントが発生すると，障害が発生しているのに，障害通知のJP1イベントがJP1/IM - Viewに表示されるまでに時間が掛かったり，JP1イベントを契機にしたJP1/AJSのジョブの実行が遅れたりすることがあります。障害が発生したホストの障害を復旧しイベントサービスを再起動しても，転送処理中となったJP1イベントは転送され続けます。

JP1イベントの大量発生（大量発生イベント）によるマシンの負荷や業務への影響が大きく，どうしてもJP1イベントの転送を中止したい場合は，イベント転送抑止コマンド（jevagtfwコマンド）を使用して，JP1イベントの転送を抑止してください。jevagtfwコマンドによるイベント転送抑止については，「2.5.3　JP1イベントが大量発生しているエージェントからのイベント転送をマネージャーから抑止する」を参照してください。jevagtfwコマンドの詳細については，「15.　コマンド」の「jevagtfw」を参照してください。

イベント転送抑止コマンド（jevagtfwコマンド）を使用できない環境の場合は，JP1イベントの転送元イベントサーバのイベントDBを初期化してください。なお，イベントDBに登録されているJP1イベントを保存したい場合は，あらかじめjevexportコマンドでイベントDBをcsvファイルに出力してください。

イベントDBの初期化の手順については，「10.2　イベントDBの初期化」を参照してください。

また，JP1イベントの大量発生（大量発生イベント）を防止するために，転送するJP1イベントの条件を転送設定ファイル（forward）で調整してください。なお，大量発生イベントを検知するためのしきい値を設定して，イベント転送を自動的に抑止することもできます。しきい値によるイベント転送抑止については，「2.5.4　しきい値を設定して大量発生イベントの転送を自動的に抑止する」を参照してください。

(2)　イベントDBが破損した。

イベントDBは，次に示す要因によって破損することがあります。

停電などで，急にシステムの電源が落ちた。

イベントサービスの稼働中に，OSのコマンドやバックアップ用のソフトウェアでイベントDBをバックアップおよびリストアした。

イベントDBをエディターなどで編集した。

コマンドの出力結果などをイベントDBにリダイレクトした。

ハードディスクに障害が発生した。

イベントDBが破損しても，イベントサービスは起動または続行し，新規のJP1イベントの登録や取得は正常に行えます。ただし，破損したレコードは，イベント検索や取得の対象外となります。また，イベントDBに破損したレコードが存在すると，JP1/IM - Viewからのイベント検索の性能が低下するおそれがあります。

イベントDBが破損すると，イベントログ，syslog，および統合トレースログにメッセージ（KAJP1057-W，KAJP1058-W，またはKAJP1059-E）が出力されます。これらのメッセージが出力された場合は，イベントDBを初期化してください。

イベントDBの初期化の手順については，「10.2　イベントDBの初期化」を参照してください。

(3)　転送元イベントサーバのイベントDBが削除され，転送先イベントサーバでJP1イベントの登録遅延が発生した。

サーバリプレースやディスク障害などで転送元イベントサーバのイベントDBが失われ，転送元イベントサーバのイベントDB内通し番号が0に戻ると，転送されるJP1イベントの発行元イベントDB内通し番号が，転送先イベントサーバの重複防止テーブルに記録している転送元イベントサーバの発行元イベントDB内通し番号の最大値より小さくなります。このため，JP1イベント転送時に転送先イベントサーバで重複チェックのためのイベントDB検索が実行され，転送先イベントサーバでJP1イベントの登録遅延が発生することがあります。サーバリプレースやディスク障害などで転送元イベントサーバのイベントDBが失われた場合，次の手順を参照してイベントDBをリカバリーしてください。

「3.5.2(4)　イベントDBのリカバリー」

「3.5.3(4)　イベントDBのリカバリー」

なお，転送元イベントサーバが操作できない場合，転送先イベントサーバでも重複防止テーブルクリア用JP1イベント（ユーザイベント）を登録することで重複防止テーブルの転送元イベントサーバの発行元イベントDB内通し番号の最大値をクリアできます。

実行手順

jevsend -i 7FFF8001 -m "DPT CLEAR EVENT" -e OBJECT_NAME=転送元イベントサーバ名

注意事項

重複防止テーブルがファイル方式の場合だけ実行可能です。

重複防止テーブルクリア用JP1イベント発行後に，転送元イベントサーバから一度もJP1イベントを受信していない状態で，jevdbmkrepコマンドを使用して重複防止テーブルを再作成すると，転送元イベントサーバの発行元イベントDB内通し番号の最大値のクリアは無効となります。jevdbmkrepコマンド実行後に再度重複防止テーブルクリア用JP1イベントを発行してください。

(4)　定義ファイルに設定した内容と実際の動作が異なる。

ホストで稼働しているサービスの設定が，定義ファイルに設定した内容とは異なる内容で反映されているため，期待していた動作とは異なる動作をする場合があります。この原因を解明するには，実際に稼働しているサービスの稼働情報の内容と定義ファイルの内容を比較する必要があります。

実際に稼働しているサービスの稼働情報の内容を知るには，jbsgetopinfoコマンドを使用します。このコマンドでは，イベントサービスの転送設定ファイル，ログファイルトラップ動作定義ファイル，イベントログトラップ動作定義ファイル（Windows限定）から定義される稼働情報について確認できます。定義ファイルの内容と比較し，異なる場合には定義ファイルの内容を有効になるよう対処してください。jbsgetopinfoコマンドの詳細については，「15.　コマンド」の「jbsgetopinfo」を参照してください。

18.5.2　Windowsの場合のトラブル

(1)　JP1/IM - Viewの［イベントコンソール］画面に表示されるJP1イベントの時刻がずれる。

要因

システムのmsvcrt.dllのバージョンが古い場合に発生します。

対処

JP1/Baseのインストール時にmsvcrt.dllを置き換えるかどうかの確認ダイアログボックスが表示された場合，必ず［再起動］を選択してファイルの置き換え，インストール後にシステムを再起動してください。

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

(2)　認証サーバが起動しない。

要因

［JP1/Base環境設定］画面の［認証サーバ］タブの［認証サーバ］で，認証サーバとして自ホストを指定していない場合，認証サーバは起動しません。JP1/Baseの新規インストール時に自動セットアップを選択しない場合は，起動しないようになっています。

対処

［JP1/Base環境設定］画面の［認証サーバ］タブの［認証サーバ］で，認証サーバに自ホストを指定してください。

(3)　「サービス固有のエラー3004」が表示され，JP1/Base EventlogTrapサービスが起動できない。

要因

イベントサービス（JP1/Base Event）が起動する前に，イベントログトラップサービス（JP1/Base EventlogTrap）が起動したためです。これは，イベントログトラップサービス（JP1/Base EventlogTrap）を［コントロールパネル］の［サービス］ダイアログボックス上で起動方法を「自動」にした場合に発生することがあります。

対処

イベントログトラップサービス（JP1/Base EventlogTrap）を自動起動にしたい場合は，起動管理機能（JP1/Base Control Serviceサービス）を利用して，イベントサービス（JP1/Base Event）の起動後に，イベントログトラップサービス（JP1/Base EventlogTrap）が起動するように設定してください。起動管理機能（JP1/Base Control Serviceサービス）の詳細については，「9.　サービスの起動順序および終了順序の設定（Windows限定）」を参照してください。

(4)　起動管理機能（JP1/Base Control Serviceサービス）でサービスを正常に起動または停止できない。

要因

次に示す要因が考えられます。

対話形式のコマンド，またはダイアログボックスを表示するコマンドを起動順序定義ファイル（JP1SVPRM.DAT）に登録している。

スペースを含むパスのコマンドをダブルクォーテーションマーク（"）で囲まずに起動順序定義ファイル（JP1SVPRM.DAT）に記述している。

対処

要因への対処を示します。番号は，上記要因の番号に対応しています。

対話形式のコマンド，またはダイアログボックスを表示するコマンドがないか確認し，これらのコマンドを登録しないようにしてください。

ダブルクォーテーションマーク（"）で囲むか，環境変数PATHに参照パスを登録し，実行ファイル名だけを起動順序定義ファイル（JP1SVPRM.DAT）に記述してください。

(5)　起動管理機能（JP1/Base Control Serviceサービス）でサービスをシステム終了時に停止できない。

要因

次に示す要因が考えられます。

JP1/Power Monitorをインストールしていない。

スタートメニューからシャットダウンを実行した。

JP1/Power Monitorから強制終了を実行したが，定義ファイルに[Control Value]セクションを登録していなかった。

JP1/Power Monitor以外でOSのシャットダウンコマンドを実行した。

停止しないサービスの起動方法が［コントロールパネル］の［サービス］ダイアログボックスの表示で「自動」になっている。

手動でJP1/Base Control Serviceサービスを停止した。

対処

要因への対処を示します。番号は，上記要因の番号に対応しています。

JP1/Power Monitorをインストールしてください。

JP1/Power Monitorを使って計画終了，または強制終了を行ってください。

[Control Value]セクションを定義ファイルに登録してください。

JP1/Power Monitorを使って計画終了，または強制終了を行ってください。

停止しないサービスの起動方法を［コントロールパネル］の［サービス］ダイアログボックスで「手動」に変更してください。

JP1/Power Monitorを使って計画終了，または強制終了を行ってください。

(6)　特定の順番でサービスを起動する必要があるため，起動管理機能を使ってサービスの起動完了を待って順番にサービスが起動するように定義している。しかし，先に起動する必要があるサービスの起動が完了しないうちに次のサービスが起動してしまい，エラーメッセージが出る。

要因

次に示す要因が考えられます。

起動管理機能（JP1/Base Control Serviceサービス）は，直前のサービスの起動処理を完了してから次のサービスの起動処理を開始しようとしたが，定義されている最大待ち時間を過ぎてもサービスの起動処理が完了しなかったため，次に定義されているサービスの起動処理を開始した。

起動順序定義ファイル（JP1SVPRM.DAT）の設定が，直前のサービスの起動処理の完了を待たずに，次のサービスを起動処理する設定になっている。

対処

要因への対処を示します。番号は，上記要因の番号に対応しています。

時間切れを起こしたサービスの起動に必要な時間を調査してください。そして，起動順序定義ファイル（JP1SVPRM.DAT）内の該当サービスのWait=パラメーターの値を，時間切れを起こさない時間に変更して運用してください。

起動順序定義ファイル（JP1SVPRM.DAT）内の該当サービスのParallel=パラメーターの設定を見直してください。詳細については，「16.　定義ファイル」の「起動順序定義ファイル（Windows限定）」を参照してください。

(7)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，"XXXXサービスが既に起動されています"と警告が出る。

要因

この警告メッセージは，起動管理機能を使って起動しようとしているサービスがすでに起動しているときに出力されます。この警告メッセージが出力される要因として，該当するサービスのスタートアップの設定が自動起動になっていることが考えられます。

対処

起動管理機能を使ってサービスを起動する場合は，そのサービスのスタートアップの設定を手動に変更してください。

(8)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，イベントビューアのアプリケーションログに「指定時間を過ぎてもXXXXサービスの起動完了が確認できませんでした。」のメッセージが出力される。

●該当するサービスが起動している場合

次に示す設定を見直してください。

Wait=パラメーターが該当サービスのセクション内に設定されていない場合

該当サービスを起動するのに，待ち時間60秒以上の時間を必要としています。該当サービスのセクション内にWait=パラメーターを設定し，60秒よりも大きい値を設定してください。

Wait=パラメーターが該当サービスのセクション内に設定されている場合

該当サービスを起動するのに，設定した待ち時間以上の時間を必要としています。該当サービスのWait=パラメーターの値を，現在設定している値より大きい値に変更してください。

●該当するサービスが起動していない場合

該当サービス製作会社に，起動が失敗する原因について調査してもらってください。

(9)　起動管理機能（JP1/Base Control Serviceサービス）を使ってサービスを起動すると，「KAVA4003-E 予期しないエラーが発生したため，XXXXサービスを起動できませんでした.」のメッセージが出力され，サービスが起動できない。

要因

マシンの起動時に，Windowsのサービスコントロールマネージャーによって自動起動が設定されているサービスの起動と，起動管理機能で設定されているサービスの起動が並行して動作した場合に発生することがあります。

対処

起動管理機能で設定されているサービスが起動するタイミングを遅らせるよう設定してください。これによって，サービス起動時の過負荷による起動の失敗を回避できます。

設定の詳細については，「9.3　サービスが起動するタイミングを設定する」を参照してください。

(10)　ディレクトリサーバ連携機能有効時にログインできない。

統合トレースログを調査してください。次のエラーメッセージが出力されていたときは，マニュアル「JP1/Base メッセージ」を参照して要因と対処を確認し，ディレクトリサーバ管理者に連絡してください。

KAVA1677-W

KAVA1678-W

KAVA1679-W

KAVA1687-W

KAVA1688-W

KAVA1690-W

KAVA1691-W

メモ

画面から正しいJP1ユーザー（連携ユーザー）とパスワードでログインしてもディレクトリサーバでの認証時にエラーとなり，認証に失敗する場合があります。

これらのメッセージは，次のメッセージの前に出力されています。

KAVA1691-W JP1ユーザー名連携ユーザーのユーザー認証に失敗しました。

18.5.3　UNIXの場合のトラブル

(1)　認証サーバが起動しない

要因

認証サーバを停止するように設定を変更した場合，jbssetusrsrvコマンドで自ホストを認証サーバに指定しただけでは，認証サーバは起動しません。

対処

jbssetusrsrvコマンドで自ホストを認証サーバに指定した後，次に示す操作をしてください。

cd /etc/opt/jp1base/conf
cp -p jp1bs_spmd.conf.session.model jp1bs_spmd.conf

(2)　イベントサービスを起動しようとすると，KAJP1005-EやKAJP1852-Eのエラーが発生してイベントサービスが起動できない

要因

次に示す要因が考えられます。

カーネルパラメーターがJP1/Baseおよびそのほかの製品を考慮した値に設定されていない。

イベントサーバインデックスファイル（index）で指定したディレクトリがシンボリックリンクされているが，そのシンボリックリンク先のディレクトリが存在しない。

イベントサービスの起動時に作成されるディレクトリが権限エラーなどで作成できない。

対処

要因への対処を示します。番号は，上記要因の番号に対応しています。

カーネルパラメーターの値を設定し直してください。なお，カーネルパラメーターの値については，「付録G　カーネルパラメーター一覧」を参照してください。

ディレクトリを作成し，シンボリックリンクを再作成してください。

ユーザーの権限をスーパーユーザー権限にして，イベントサービスを再起動してください。

18.5.4　ヘルスチェック機能で異常を検知した場合

ヘルスチェック機能では，JP1/Baseの各プロセスの異常を検知できます。ここでは，ヘルスチェック機能で検知した異常要因と対処方法について説明します。

(1)　システムリソース（CPU，ディスクなど）が大量に消費されている。または，プロセスへの要求が性能の限界を超えている。

高負荷の要因となっている処理をキャンセルしてください。

(2)　すぐに終了するはずのコマンドが終了しない。または，コマンドがリソースを保持したまま終了しない。

コマンドプロセスをkillコマンドなどのOS機能で強制終了してください。

(3)　プロセスがデッドロック，または無限ループの状態になっている。

プロセスがデッドロック，または無限ループの状態になって処理が長時間終了しない場合は，次の表に示す対処方法に従って対処してください。

項番

機能

プロセス名

対処方法

1

プロセス管理機能

jbs_spmd

JP1/Baseを再起動する。

Windowsの場合

JP1/Baseサービス（ユーザー管理を含むプロセス管理）を再起動する。

UNIXの場合

JP1/Baseを再起動する。※

2

認証サーバ

jbssessionmgr

3

構成管理

jbsroute

4

コマンド実行

jcocmd

5

プラグインサービス

jbsplugind

6

イベントサービス

jevservice

イベントサービスを再起動する。

Windowsの場合

JP1/Base Eventサービスを再起動する。

UNIXの場合

イベントサービスを再起動する。※

7

ログファイルトラップ

jevtraplog

jevtraplog

ログファイルトラップ管理サービス（デーモン）を再起動する。

Windowsの場合

JP1/Base LogTrapサービスを再起動する。

UNIXの場合

ログファイルトラップ管理デーモンを再起動する。※

jevlogd

jelparentim

エラーメッセージに示されるID番号のログファイルトラップをjevlogstartコマンドで再起動する。

Windowsの場合

メッセージに示されるID番号と同じスレッドIDのログファイルトラップを再起動する。

UNIXの場合

メッセージに示されるID番号と同じプロセスIDのログファイルトラップを再起動する。

jelchildim

8

イベントログトラップ

jevtrapevt

イベントログトラップサービス（JP1/Base EventlogTrap）を再起動する。

9

ヘルスチェック

jbshcd

JP1/Baseを再起動する。

Windowsの場合

JP1/Baseサービス（ユーザー管理を含むプロセス管理）を再起動する。

UNIXの場合

JP1/Baseを再起動する。※

jbshchostd

10

サービス管理制御

jbssrvmgr

11

ローカルアクション

jbslcact

12

プロセス間通信

jbscomd

注※　プロセスの終了コマンドで，該当するプロセスを停止したあと，ps -elコマンドで終了していないプロセスがないか確認してください。プロセスが残っている場合は，killコマンドで終了してください。その後，起動コマンドでプロセスを起動してください。

(4)　監視対象ホストに接続できない。

ホストが起動しているかどうか確認してください。

JP1/Baseが起動しているか確認してください。

ネットワークが正常かどうか確認してください。

監視対象ホストにインストールされたJP1/Baseのバージョンが07-11以降かどうか確認してください。

18.6　JP1/Base使用上の注意事項

18.6.1　システム起動時の注意事項

次のコマンドを同時に実行した場合，JP1/Baseが正しく起動しないおそれがあります。これらのコマンドを同時に実行しないでください。

jbs_start

jbs_start.cluster

jbs_spmd

JP1/Base 11-10以降では，マネージャーホストでJP1/IM - Managerのリモートコマンドや自動アクションを使用している場合，コマンド実行履歴ファイルの自動再編成機能によってJP1/Baseの起動に時間が掛かる場合があります。コマンド実行履歴ファイルの自動再編成機能については，「4.9　コマンド実行履歴ファイルの自動再編成機能について」を参照してください。

18.6.2　システム運用時の注意事項

JP1/Baseを起動しているときは，次のコマンドを使用しないでください。

jbs_setup_cluster（Windows限定）

jbshostsimport

jbssetadmingrp（UNIX限定）の-vオプション以外

jbsunsetcnf

jevdbinit

jevdbmkrep

jp1base_setup（UNIX限定）

jp1base_setup_cluster（UNIX限定）

jp1bshasetup（Windows限定）

Jischk

Jiscond

Jisconv

Jiscpy

Jisext

Jiskeymnt

Jislckext

Jisprt

Jislckreg（UNIX限定）

Jisrsdel（UNIX限定）

JP1製品がJP1/Baseのユーザー認証を利用する機能を実行中でなければ，JP1/Baseを起動している状態で，次に示す環境設定情報を変更できます。

JP1ユーザーの設定※

JP1資源グループ別権限レベルの設定（Windowsの場合）※

JP1ユーザーの操作権限の設定（UNIXの場合）

認証サーバの変更

注※

DSユーザーを使用する運用の場合は，ユーザー認証を利用する機能が実行中でも変更できます。

運用中に上記環境設定情報を変更する場合は，十分に注意してください。

Windowsでは，JP1/Baseが参照するフォルダおよびファイルとしてネットワークドライブ上のフォルダおよびファイルを使用することはできません。指定した場合には動作を保証できません。

UNIXでは，JP1/Baseが参照するディレクトリおよびファイルとしてNFSマウントされたディスク上のディレクトリおよびファイルを指定できません。指定した場合には動作を保証できません。

文字コード（JIS第3水準，第4水準）は扱えません。

Windowsで性能が要求される運用をする場合，次の設定を行うことをおすすめします。

［コントロールパネル］−［パフォーマンスの情報とツール］−［詳細ツール］−［Windowsのデザインとパフォーマンスの調整］−［詳細設定］タブ−［プロセッサのスケジュール］で「バックグラウンドサービス」を選択する。

JP1/Baseのコマンドや定義ファイルに指定するファイル名には，Windowsの予約デバイスファイル（AUX，CON，NUL，PRN，CLOCK$，COM[0-9]，LPT[0-9]）を指定しないでください。

ウィルス対策ソフトによってJP1/Baseのファイルおよびフォルダアクセスに影響が発生し製品が予期しない動作をするおそれがあります。

ウィルス対策ソフトを使用する場合は，次のフォルダ配下すべてをウィルススキャンの対象外に設定してください。

・インストール先フォルダ（Windowsのデフォルト）

物理ホスト環境：

・システムドライブ¥Program Files (x86)¥Hitachi¥JP1Base

・%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base

論理ホスト環境：

・共有フォルダ¥jp1base¥conf¥

・共有フォルダ¥jp1base¥log¥

・共有フォルダ¥jp1base¥event¥

・%ALLUSERSPROFILE%¥Hitachi¥JP1¥論理ホスト名¥JP1Base

・インストール先ディレクトリ（UNIX）

物理ホスト環境：

・/opt/jp1base

・/etc/opt/jp1base

・/var/opt/jp1base

・/usr/tmp/jp1_ses

・/usr/lib/jp1_ses

・/opt/jp1/hcclibcnf/regdir

論理ホスト環境：

・共有ディレクトリ/jp1base

・共有ディレクトリ/event

・統合トレースログフォルダ（Windowsのデフォルト）

・システムドライブ¥Program Files (x86)¥Hitachi¥HNTRLib2

・統合トレースログディレクトリ（UNIX）

・/opt/hitachi/HNTRLib2

・/var/opt/hitachi/HNTRLib2

・indexファイルに指定したフォルダ

デフォルトは，Windowsの場合「インストール先フォルダ¥conf¥event¥」，UNIXの場合「/etc/opt/jp1base/conf/event/」です。

・ログファイルトラップで監視しているログファイルなどのファイル

18.6.3　ユーザー認証に関する注意事項

1台の認証サーバにログインの負荷が集中すると，KAVB0109-E，KAVB0105-E，KAVB0106-E，またはKAVB0108-Eのメッセージが出力され，ログインできなくなることがあります。この現象が発生した場合，しばらく待ってから再度ログインを実行してください。

各メッセージの詳細については，マニュアル「JP1/Integrated Management 3 - Manager メッセージ」を参照してください。

JP1/AJS - Viewからログインするときに，パスワードの後ろに付けたスペースは無視されます。

18.6.4　起動順序の制御に関する注意事項

JP1/Base Control Serviceサービスの［ログオン］の設定を「システムアカウント」以外に変更しないでください。また，［デスクトップの対話をサービスに許可］オプションにチェックを入れないでください。

JP1SVPRM.DATファイルには，対話形式のコマンドやダイアログボックスを表示するコマンドを登録しないでください。

18.6.5　JP1/Baseで使用するファイルおよびディレクトリに関する注意事項

UNIXでJP1/Baseを使用する場合，/var/opt/jp1base/tmp以下にはファイルなどを作成しないでください。作成した場合，削除される場合があります。

Windowsでは，コマンド実行機能でインストール先フォルダ¥COMMANDをカレントフォルダとして使用しています。そのため，JP1ユーザーにマッピングしているOSユーザーに対して，カレントフォルダの読み取り権限が必要となります。また，カレントフォルダにリダイレクトによるファイル作成や，一時ファイルの作成をする場合は，書き込み権限が必要となります。

付録

付録A　ファイルおよびディレクトリ一覧

JP1/Baseで使用するファイルおよびディレクトリを次に示します。

付録A.1　ファイルおよびディレクトリ一覧（Windowsの場合）

表中のBase_Pathは，マニュアル本文中で使用している「インストール先フォルダ」です。なお，Base_Pathは，初期設定では次のフォルダとなります。

システムドライブ¥Program Files (x86)¥Hitachi¥jp1base

表中のSystemDriveは，マニュアル本文中で使用している「システムドライブ」です。

表A‒1　JP1/Baseのファイルおよびフォルダ一覧（Windowsの場合）

内容

ファイル名・フォルダ名

コマンド格納フォルダ

Base_Path¥bin¥

Base_Path¥bin¥ext

環境設定フォルダ※1

Base_Path¥conf¥

共有フォルダ¥jp1base¥conf¥

言語種別設定ファイル

Base_Path¥conf¥jp1bs_param.conf

共有フォルダ¥jp1base¥conf¥jp1bs_param.conf

構成定義ファイル

Base_Path¥conf¥route¥jbs_route.conf

共有フォルダ¥jp1base¥conf¥route¥jbs_route.conf

起動プロセス定義ファイル

Base_Path¥conf¥jp1bs_spmd.conf

Base_Path¥conf¥jp1bs_spmd.conf.model（認証サーバの起動なし（2038年非対応））

Base_Path¥conf¥jp1bs_spmd.conf.session.model（認証サーバの起動あり（2038年非対応））

Base_Path¥conf¥jp1bs_spmd.conf.2038_model（認証サーバの起動なし（2038年対応））

Base_Path¥conf¥jp1bs_spmd.conf.session.2038_model（認証サーバの起動あり（2038年対応））

JP1/IM関数　ヘッダーファイル

Base_Path¥include¥JevApi.h

ログフォルダ※2

Base_Path¥log¥

共有フォルダ¥jp1base¥log¥

プラグイン用フォルダ

Base_Path¥plugin¥

稼働情報格納フォルダ

Base_Path¥sys¥OPI¥

共有フォルダ¥jp1base¥sys¥OPI¥

readme

Base_Path¥readme.txt

形名およびバージョン情報

Base_Path¥Version.txt

ライセンス種別情報

Base_Path¥ProductInfo.txt

イベントDB格納フォルダ※3

Base_Path¥sys¥event¥servers¥※4

共有フォルダ¥jp1base¥event¥※4

jp1hosts2情報

Base_Path¥sys¥jp1hosts2¥hostdb{0|1}.bin

共有フォルダ¥jp1base¥sys¥jp1hosts2¥hostdb{0|1}.bin

ログおよびテンポラリーフォルダ※2

Base_Path¥sys¥tmp¥event¥servers¥※⁴

イベントID保存ファイル

Base_Path¥sys¥tmp¥event¥servers¥default¥ereb.backup※4

共有フォルダ¥jp1base¥event¥ereb.backup※4

ログファイルトラップ機能内部動作ファイル

Base_Path¥sys¥tmp¥event¥logtrap¥conftbl.ID番号

ツール関連フォルダ

Base_Path¥tools¥

資料採取ツールサンプルバッチファイル

Base_Path¥tools¥jbs_log.bat

JP1イベントを発行および取得する関数サンプルソースファイル

Base_Path¥tools¥event¥receiver.c

Base_Path¥tools¥event¥sender.c

AR System連携用サンプルバッチファイル

Base_Path¥tools¥helpdesk¥register_ars.bat

Active Directoryのスキーマ拡張用のモデルファイル

Base_Path¥tools¥schema¥JP1_UserLevel_schema.ldf.model

統合トレースログフォルダ

[32bit] SystemDrive¥Program Files (x86)¥Hitachi¥HNTRLib2¥spool¥

[64bit] SystemDrive¥Program Files¥Hitachi¥HNTRLib2¥spool¥

IT Report Utility（システム情報採取ツール）関連フォルダ

IT Report Utilityと連携するためのファイル

%ProgramFiles%¥Hitachi¥systoru¥pattern¥!830_HNTRLIB2※5

転送抑止状態管理フォルダ

Base_Path¥conf¥event¥servers¥default¥suppress※4

エージェントごとの転送抑止情報フォルダ

Base_Path¥conf¥event¥servers¥default¥suppress¥エージェントのホスト名※4

オートスケール連携スクリプトフォルダ※1

Base_Path¥tools¥cloud¥

スクリプトファイル

Base_Path¥tools¥cloud¥jbsas_setup_agent.ps1

Base_Path¥tools¥cloud¥jbsas_add_agent.ps1

Base_Path¥tools¥cloud¥jbsas_add_agent_cli.ps1

Base_Path¥tools¥cloud¥jbsas_del_agent.ps1

Base_Path¥tools¥cloud¥jbsas_del_agent_cli.ps1

スクリプトファイルのモデルファイル

Base_Path¥tools¥cloud¥jbsas_setup_agent.ps1.model

Base_Path¥tools¥cloud¥jbsas_add_agent.ps1.model

Base_Path¥tools¥cloud¥jbsas_add_agent_cli.ps1.model

Base_Path¥tools¥cloud¥jbsas_del_agent.ps1.model

Base_Path¥tools¥cloud¥jbsas_del_agent_cli.ps1.model

内部ファイル

Base_Path¥tools¥cloud¥jbsas_util.ps1

Base_Path¥tools¥cloud¥jbsas_hosts

内部ファイルのモデルファイル

Base_Path¥tools¥cloud¥jbsas_util.ps1.model

共通定義情報退避ファイル出力先フォルダ

Windowsのインストール先フォルダ¥Temp¥JP1_COMDEF¥

共通定義情報（JP1/Baseを除く）退避ファイル（物理ホスト）

comdef_JP1_DEFAULT.conf

共通定義情報（JP1/Baseを除く）退避ファイル（論理ホスト）

comdef_論理ホスト名.conf

内部ファイル

logical.list

注※1　定義ファイルについては，「付録A.1(1)　定義ファイル一覧（Windowsの場合）」を参照してください。

注※2　ログファイルについては，「付録A.1(2)　ログファイル一覧（Windowsの場合）」を参照してください。

注※3　イベントDBのファイル名については，「2.3.2　イベントDBとは」を参照してください。

注※4　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるフォルダに格納されます。

注※5　Windows Server 2012以降のサーバ系OSの場合。

(1)　定義ファイル一覧（Windowsの場合）

表A‒2　定義ファイル一覧（Windowsの場合）

機能

ファイル名・フォルダ名

起動管理機能

起動順序定義ファイル

Base_Path¥conf¥boot¥JP1SVPRM.DAT

Base_Path¥conf¥boot¥JP1SVPRM.DAT.MODEL

サービス起動遅延時間／タイマー監視時間定義ファイル

Base_Path¥conf¥boot¥jp1svprm_wait.dat

Base_Path¥conf¥boot¥jp1svprm_wait.dat.sample

イベントサービス

イベントサーバインデックスファイル

Base_Path¥conf¥event¥index

イベントサーバ設定ファイル

Base_Path¥conf¥event¥servers¥default¥conf※1

共有フォルダ¥jp1base¥event¥conf※1

転送設定ファイル

Base_Path¥conf¥event¥servers¥default¥forward※1

共有フォルダ¥jp1base¥event¥forward※1

イベント転送抑止用の転送設定ファイル

Base_Path¥conf¥event¥servers¥default¥suppress¥forward_suppress※1

任意の転送抑止定義ファイル

Base_Path¥conf¥event¥servers¥default¥suppress¥転送抑止定義ファイル名※1

API設定ファイル

Base_Path¥conf¥event¥api

転送受信用の属性付加設定ファイル

Base_Path¥conf¥event¥servers¥default¥recv_add_extattr※1

共有フォルダ¥jp1base¥event¥recv_add_extattr※1

イベント登録用の属性付加設定ファイル

Base_Path¥conf¥event¥servers¥default¥send_add_extattr※1

共有フォルダ¥jp1base¥event¥send_add_extattr※1

イベント変換機能

ログファイルトラップ動作定義ファイル

任意のファイルおよび任意のフォルダを指定できます。

ログファイルトラップ起動定義ファイル

Base_Path¥conf¥event¥jevlog_start.conf

ログ情報定義ファイル

Base_Path¥conf¥event¥jevlogd.conf

イベントログトラップ動作定義ファイル

Base_Path¥conf¥event¥ntevent.conf

イベントサービスの定義情報の収集・配布機能

配布定義ファイル（転送設定ファイル）

Base_Path¥conf¥event¥servers¥default¥[jev_forward.conf | 任意のファイル]※2

共有フォルダ¥jp1base¥event¥[jev_forward.conf | 任意のファイル]※2

配布定義ファイル（ログファイルトラップ動作定義ファイル）

Base_Path¥conf¥[jev_logtrap.conf | 任意のファイル]※2

配布定義ファイル（イベントログトラップ動作定義ファイル）

Base_Path¥conf¥event¥[jev_ntevent.conf | 任意のファイル]※2

ユーザー管理機能

パスワード定義ファイル

任意のファイルおよび任意のフォルダを指定できます。

ユーザー権限レベルファイル

Base_Path¥conf¥user_acl¥JP1_UserLevel

共有フォルダ¥jp1base¥conf¥user_acl¥JP1_UserLevel

ディレクトリサーバ変更ファイル

任意のファイルおよび任意のフォルダを指定できます。

ディレクトリサーバ連携定義ファイル

Base_Path¥conf¥ds¥jp1bs_ds_setup.conf

Base_Path¥conf¥ds¥jp1bs_ds_setup.conf.model

共有フォルダ¥jp1base¥conf¥ds¥jp1bs_ds_setup.conf

共有フォルダ¥jp1base¥conf¥ds¥jp1bs_ds_setup.conf.model

ユーザーマッピング定義ファイル

Base_Path¥conf¥user_acl¥jp1BsUmap.conf

共有フォルダ¥jp1base¥conf¥user_acl¥jp1BsUmap.conf

パスワードポリシー定義ファイル

Base_Path¥conf¥passwdpolc¥jp1bs_passwdpolc.conf

共有フォルダ¥jp1base¥conf¥passwdpolc¥jp1bs_passwdpolc.conf

ヘルスチェック機能

ヘルスチェック定義ファイル

Base_Path¥conf¥jbshc¥jbshc.conf

共有フォルダ¥jp1base¥conf¥jbshc¥jbshc.conf

共通定義設定用ファイル（ヘルスチェック機能）のモデルファイル

Base_Path¥conf¥jbshc¥jbshc_setup.conf.model

共有フォルダ¥jp1base¥conf¥jbshc¥jbshc_setup.conf.model

共通定義設定用ファイル（ヘルスチェック機能）（07-10以前からのバージョンアップ用）のモデルファイル

Base_Path¥default¥jbshc_com.conf.model

共有フォルダ¥jp1base¥default¥jbshc_com.conf.model

プラグインサービス

要求転送設定ファイル

Base_Path¥conf¥plugin¥reqforward.conf

共有フォルダ¥jp1base¥conf¥plugin¥reqforward.conf

操作ログ出力機能

操作ログ定義ファイル

Base_Path¥conf¥jp1bs_baselog_setup.conf

Base_Path¥conf¥jp1bs_baselog_setup.conf.model

プロセス管理機能

JP1/Baseパラメーター定義ファイル

Base_Path¥conf¥jp1bs_param_V7.conf

共有フォルダ¥jp1base¥conf¥jp1bs_param_V7.conf

拡張起動プロセス定義ファイル

Base_Path¥conf¥jp1bs_service_0700.conf

共有フォルダ¥jp1base¥conf¥jp1bs_service_0700.conf

通信設定

jp1hosts定義ファイル

Base_Path¥conf¥jp1hosts

共有フォルダ¥jp1base¥conf¥jp1hosts

jp1hosts2定義ファイル

Base_Path¥conf¥jp1hosts2.conf

共有フォルダ¥jp1base¥conf¥jp1hosts2.conf

通信方式設定ファイル

Base_Path¥conf¥physical_ipany.conf

Base_Path¥conf¥logical_ipany.conf

Base_Path¥conf¥physical_recovery_0651.conf

Base_Path¥conf¥logical_recovery_0651.conf

Base_Path¥conf¥physical_anyany.conf

Base_Path¥conf¥physical_ipip.conf

Base_Path¥conf¥logical_ipip.conf

共有フォルダ¥jp1base¥conf¥physical_ipany.conf

共有フォルダ¥jp1base¥conf¥logical_ipany.conf

共有フォルダ¥jp1base¥conf¥physical_recovery_0651.conf

共有フォルダ¥jp1base¥conf¥logical_recovery_0651.conf

共有フォルダ¥jp1base¥conf¥physical_anyany.conf

共有フォルダ¥jp1base¥conf¥physical_ipip.conf

共有フォルダ¥jp1base¥conf¥logical_ipip.conf

ホストアクセス制限定義ファイル

Base_Path¥conf¥jbsdfts¥jbsdfts_srv.conf

SSL通信定義ファイル

Base_Path¥conf¥jp1bs_ssl.conf

共有フォルダ¥jp1base¥conf¥jp1bs_ssl.conf

非SSL通信ホスト設定ファイル

Base_Path¥conf¥jp1bs_nosslhost.conf

SSL定義書き出しファイル

Base_Path¥sys¥tmp¥event¥servers¥default¥ssl.conf

共有フォルダ¥jp1base¥event¥ssl.conf

非SSL通信ホスト設定ファイル退避ファイル（JP1/Base本体）

Base_Path¥sys¥nossl_base.conf

Base_Path¥sys¥nossl_base{1|2|3}.conf

共有フォルダ¥jp1base¥sys¥nossl_base.conf

共有フォルダ¥jp1base¥sys¥nossl_base{1|2|3}.conf

非SSL通信ホスト設定ファイル退避ファイル（イベントサービス）

Base_Path¥sys¥tmp¥event¥servers¥default¥nossl_evt.conf

Base_Path¥sys¥tmp¥event¥servers¥default¥nossl_evt{1|2|3}.conf

共有フォルダ¥jp1base¥event¥nossl_evt.conf

共有フォルダ¥jp1base¥event¥nossl_evt{1|2|3}.conf

ローカルアクション機能

ローカルアクション環境変数ファイル

任意のファイルおよび任意のフォルダを指定できます。

ローカルアクション実行定義ファイル

Base_Path¥conf¥lcact¥jbslcact.conf

共有フォルダ¥jp1base¥conf¥lcact¥jbslcact.conf

共通定義設定用ファイル（ローカルアクション機能）

Base_Path¥conf¥lcact¥jp1bs_lcact_setup.conf.model

共有フォルダ¥jp1base¥conf¥lcact¥jp1bs_lcact_setup.conf.model

JP1/Baseの設定情報の一括収集

収集情報ファイル

Base_Path¥conf¥jbsparamdump.conf

構成管理機能

共通定義設定用ファイル（構成管理機能）

Base_Path¥conf¥route¥jbsrt_setup.conf.model

共有フォルダ¥jp1base¥conf¥route¥jbsrt_setup.conf.model

オートスケール連携スクリプト

スクリプト定義ファイル

Base_Path¥tools¥cloud¥jbsas_setup_agent.ini

Base_Path¥tools¥cloud¥jbsas_setup_manager.ini

Base_Path¥tools¥cloud¥jbsas_setup_manager_cli.ini

スクリプト定義ファイルのモデルファイル

Base_Path¥tools¥cloud¥jbsas_setup_agent.ini.model

Base_Path¥tools¥cloud¥jbsas_setup_manager.ini.model

Base_Path¥tools¥cloud¥jbsas_setup_manager_cli.ini.model

注※1　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるフォルダに格納されます。

注※2　定義情報の配布機能を使用していない場合には存在しません。

(2)　ログファイル一覧（Windowsの場合）

JP1/Baseが出力する初期設定のログファイルの一覧を次の表に示します。

重要

JP1/Baseが出力するログファイルには，製品保守の必要上出力している内部ログファイルがあります。これらは，ユーザーが参照，または変更する必要はありません。なお，システム障害が発生したときなど資料採取のために，これらのファイルをご利用元で一時保管していただくことがあります。

「ログの種類」には，JP1/Baseが出力するログの種類を記載しています。

「ファイル名・フォルダ名」には，JP1/Baseを初期設定でインストールした場合のログファイル名と，クラスタ運用の場合のログファイル名をそれぞれフルパスで記載しています。

「最大ディスク占有量」には，ログファイルが最大でどの程度ディスクを使用するのかを記載しています。ログファイルが複数ある場合は，その合計量を記載しています。

「ファイルの切り替え時期」には，JP1/Baseが出力先のログファイルを切り替えるタイミングを記載しています。ファイルがこの欄に示すサイズに達したとき，または，この欄に示す事象が起きたときに出力先が切り替わります。なお，ログファイルが一つの場合，ファイルの切り替えが発生すると同ファイルに上書きされます。ログファイルが複数あり，最大ディスク占有量に達した場合は，更新日付の古いファイルから上書きされます。

表A‒3　ログファイル一覧（Windowsの場合）

ログの種類

ファイル名・フォルダ名

最大ディスク占有量

ファイルの切り替え時期

プロセス管理ログ

Base_Path¥log¥JBS_SPMD{1|2|3}.log

共有フォルダ¥jp1base¥log¥JBS_SPMD{1|2|3}.log

384KB

128KB

Base_Path¥log¥JBS_SPMD_COMMAND{1|2|3}.log

共有フォルダ¥jp1base¥log¥JBS_SPMD_COMMAND{1|2|3}.log

384KB

128KB

Base_Path¥log¥JBS_SERVICE{1|2|3}.log

共有フォルダ¥jp1base¥log¥JBS_SERVICE{1|2|3}.log

384KB

128KB

認証サーバログ

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥jbssessionapi.log{1|2|3|4|5|6|7|8}.log※1

%ALLUSERSPROFILE%¥Hitachi¥JP1¥論理ホスト名¥JP1Base¥log¥jbssessionapi.log{1|2|3|4|5|6|7|8}.log※1

5MB

640KB

Base_Path¥log¥jbssessionmgr{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbssessionmgr{1|2|3|4|5|6|7|8}.log

5MB

640KB

Base_Path¥log¥jbssessionmgr_trace{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbssessionmgr_trace{1|2|3|4|5|6|7|8}.log

5MB

640KB

認証サーバ設定コマンドログ

Base_Path¥log¥JBSSESS{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JBSSESS{1|2|3|4|5|6|7|8}.log

5MB

640KB

Base_Path¥log¥JBS_SETUP¥JBSSETUPSRV{1|2}.log

128KB

64KB

環境設定プログラムログ

Base_Path¥log¥jp1bssetup{1|2}.log

共有フォルダ¥jp1base¥log¥jp1bssetup{1|2}.log

128KB

64KB

論理ホスト設定プログラムログ

Base_Path¥log¥jp1hasetup.{log|log.old}

2,000KB

1,000KB

Base_Path¥log¥JBS_SETUP¥JBSSETUPCLUSTER{1|2}.log

128KB

64KB

コマンド実行履歴ファイル（ISAM）※2

Base_Path¥log¥COMMAND¥ACTISAMLOGV8.DRF

共有フォルダ¥jp1base¥log¥COMMAND¥ACTISAMLOGV8.DRF

1.2GB※3

なし

Base_Path¥log¥COMMAND¥ACTISAMLOGV8.K01

共有フォルダ¥jp1base¥log¥COMMAND¥ACTISAMLOGV8.K01

2MB※3

なし

Base_Path¥log¥COMMAND¥ACTISAMLOGV8.KDF

共有フォルダ¥jp1base¥log¥COMMAND¥ACTISAMLOGV8.KDF

1KB

コマンド実行時

Base_Path¥log¥COMMAND¥CMDISAMLOGV8.DRF

共有フォルダ¥jp1base¥log¥COMMAND¥CMDISAMLOGV8.DRF

1.2GB※3

なし

Base_Path¥log¥COMMAND¥CMDISAMLOGV8.K01

共有フォルダ¥jp1base¥log¥COMMAND¥CMDISAMLOGV8.K01

2MB※3

なし

Base_Path¥log¥COMMAND¥CMDISAMLOGV8.KDF

共有フォルダ¥jp1base¥log¥COMMAND¥CMDISAMLOGV8.KDF

1KB

コマンド実行時

共通定義情報ログ

Base_Path¥log¥JBSCNFCMD¥JBSCNFCMD{1|2}.log

128KB

64KB

jp1hosts情報コマンドログ

Base_Path¥log¥JBSCNFCMD¥JBSCOMMCMD{1|2}.log

128KB

64KB

ユーザーマッピングコマンドログ

Base_Path¥log¥JBSUMAPCMD¥JBSUMAPCMD{1|2}.log

共有フォルダ¥jp1base¥log¥JBSUMAPCMD¥JBSUMAPCMD{1|2}.log

128KB

64KB

リモートコマンドログ※2

Base_Path¥log¥JCOCMD¥jcocmd_result{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmd_result{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥jcocmdapi{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdapi{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥jcocmdapi_trace{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdapi_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥jcocmdcom{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdcom{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥jcocmdcom_trace{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdcom_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥jcocmdexe{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdexe{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥jcocmdexe_trace{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdexe_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥jcocmdrouter{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdrouter{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥jcocmdrouter_trace{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥jcocmdrouter_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

Base_Path¥log¥JCOCMD¥JCOCMDCMD{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥JCOCMD¥JCOCMDCMD{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

プラグインサービスログ

Base_Path¥log¥plugin¥jbsplugin{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbsplugin{1|2|3|4|5|6|7|8}.log

5MB

640KB

Base_Path¥log¥plugin¥jbsplugincom_{0|1|2|3|4|5|6|7|8|9}※4_{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbsplugincom_{0|1|2|3|4|5|6|7|8|9}※4_{1|2|3|4|5|6|7|8}.log

50MB

640KB

Base_Path¥log¥plugin¥jbsplugincmd{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbsplugincmd{1|2|3|4|5|6|7|8}.log

5MB

640KB

Base_Path¥log¥plugin¥jbsplugincmdapi{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbsplugincmdapi{1|2|3|4|5|6|7|8}.log

5MB

640KB

Base_Path¥log¥plugin¥jbspluginhcshm{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbspluginhcshm{1|2|3|4|5|6|7|8}.log

5MB

640KB

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥plugin¥jbsrmtcmd{1|2|3|4|5|6|7|8}.log※1

2,048KB

256KB

Base_Path¥log¥plugin¥jbspluginremotecmd{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥plugin¥jbspluginremotecmd{1|2|3|4|5|6|7|8}.log

5MB

640KB

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥plugin¥jbsrmtapi{1|2|3|4|5|6|7|8}.log※1

2,048KB

256KB

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥plugin¥jbspluginmgrapi{1|2|3|4|5|6|7|8}.log※1

%ALLUSERSPROFILE%¥Hitachi¥JP1¥論理ホスト名¥JP1Base¥log¥plugin¥jbspluginmgrapi{1|2|3|4|5|6|7|8}.log※1

5MB

640KB

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥plugin¥jbsplugincomapi{1|2|3|4|5|6|7|8}.log※1

%ALLUSERSPROFILE%¥Hitachi¥JP1¥論理ホスト名¥JP1Base¥log¥plugin¥jbsplugincomapi{1|2|3|4|5|6|7|8}.log※1

5MB

640KB

構成管理ログ※2

Base_Path¥log¥route¥JBSRT{1|2|3|4|5}.log

共有フォルダ¥jp1base¥log¥route¥JBSRT{1|2|3|4|5}.log

20MB

4MB

起動順序制御ログ

Base_Path¥log¥boot¥ContServ{1|2}.log

128KB

64KB

イベントログトラップトレースログ

Base_Path¥log¥ntevtrap¥trace{1|2}.log

1,024KB

512KB

イベントログトラップトラップログ

Base_Path¥log¥ntevtrap¥trap{1|2|3|4}.log

4,096KB

1,024KB

ヘルスチェック機能ログ（自ホスト監視）

Base_Path¥log¥jbshc¥jbshc{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshc{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

ヘルスチェック機能ログ（他ホスト監視）

Base_Path¥log¥jbshc¥jbshchost{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshchost{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

ヘルスチェックコマンドログ

Base_Path¥log¥jbshc¥jbshcstatus{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshcstatus{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

ヘルスチェックAPI用ログ

Base_Path¥log¥jbshc¥jbshcapi{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbshc¥jbshcapi{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

アプリケーションエラーログ

Base_Path¥log¥jbsdump.log

5MB

5MB

操作ログ

Base_Path¥log¥BASE¥base_log[{1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16}].log

68MB※5

1,024KB※5※6

イベント設定一元管理取得コマンド用トレースログ

Base_Path¥sys¥tmp¥event¥servers¥default¥jevdef_get.{000|001|002}※7

共有フォルダ¥jp1base¥event¥jevdef_get.{000|001|002}※7

192KB

コマンド実行時

イベント設定一元管理配布コマンド用トレースログ

Base_Path¥sys¥tmp¥event¥servers¥default¥jevdef_distrib.{000|001|002}※7

共有フォルダ¥jp1base¥event¥jevdef_distrib.{000|001|002}※7

192KB

コマンド実行時

イベントサービス用トレースログ

Base_Path¥sys¥tmp¥event¥servers¥default¥trace.{000|001|002|003|004}※7※8

共有フォルダ¥jp1base¥event¥trace.{000|001|002|003|004}※7※8

12.5MB※8

イベントサービス起動時

Base_Path¥sys¥tmp¥event¥servers¥default¥imevterr.{000|001|002|003|004}※7※8

共有フォルダ¥jp1base¥event¥imevterr.{000|001|002|003|004}※7※8

5MB※8

イベントサービス起動時

イベントサービス用転送エラーログ

Base_Path¥sys¥tmp¥event¥servers¥default¥fwderr.{000|001|002|003|004}※7※8

共有フォルダ¥jp1base¥event¥fwderr.{000|001|002|003|004}※7※8

5MB※8

イベントサービス起動時

イベントサービス用エラーログ

Base_Path¥sys¥tmp¥event¥servers¥default¥error.{000|001|002|003|004}※7※8

共有フォルダ¥jp1base¥event¥error.{000|001|002|003|004}※7※8

2,500KB※8

イベントサービス起動時

イベントサービスAPI用ログ

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥event¥IMEvapi.{000|001|002|003|004}※9※10

5MB※9

1MB※9

イベントサービス用ログ

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥event¥IMEvenc.{000|001|002|003|004}※10

5MB

1MB

イベントサービスメッセージ切り替えログ

Base_Path¥log¥jevmessage¥jevmessageid{1|2}.log

10KB

5KB

ログファイルトラップエラーログ

Base_Path¥sys¥tmp¥event¥logtrap¥.errorfile.ID番号

数百バイト程度※12

ログファイルトラップ起動時

ログファイルトラップログ

Base_Path¥sys¥tmp¥event¥logtrap¥jevtraplog¥jevtraplog.{000|001|002|003|004}

5MB※13

1MB※13

ログファイルトラップ起動実行結果ログ

Base_Path¥log¥jevlog_start¥jevlog_start{1|2|3}.log※15※16

3MB

1MB

リモート監視ログ（ログファイルトラップ）

Base_Path¥sys¥tmp¥event¥logtrap¥jelallog¥jelallog{1-5}.log※15

5MB

1MB

リモート監視ログ（イベントログトラップ）

Base_Path¥sys¥tmp¥event¥logtrap¥jelalelt¥jelalelt{1-5}.log※15

5MB

1MB

インストール時のログ

Windowsのインストール先フォルダ¥Temp¥jp1common¥jp1base¥hliclibtrc{1|2|3|4|5}.log

1MB

200KB

Windowsのインストール先フォルダ¥Temp¥jp1common¥jp1base¥hliclibmgrtrc{1|2|3|4|5}.log

1MB

200KB

Windowsのインストール先フォルダ¥Temp¥jp1common¥jp1base¥hlicliberr{1|2|3|4|5}.log

50KB

10KB

Windowsのインストール先フォルダ¥Temp¥jp1common¥jp1base¥hliclibmgrerr{1|2|3|4|5}.log

50KB

10KB

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

サーバ系OSのリモートデスクトップサービス（旧称：ターミナルサービス）環境では，次のようにログ出力先が変わります。

%USERPROFILE%¥WINDOWS¥Temp¥HCDINST¥製品形名[_{1|2|3|4|5}].LOG

25KB

インストール時

Windowsのインストール先フォルダ¥Temp¥HCDINST¥NETMINST.LOG

256KB

256KB

Windowsのインストール先フォルダ¥Temp¥RF¥HRF4SECURITYINSTALL{1|2|3|4}.LOG

1,024KB

256KB

Windowsのインストール先フォルダ¥Temp¥RF¥HRF4INSTALL{1|2|3|4}.LOG

1,024KB

256KB

プロセス間通信トレースログ

Base_Path¥log¥JBSCOM¥jbscomd{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd{1|2|3|4}.log

10MB

2.5MB

Base_Path¥log¥JBSCOM¥jbscomd_api{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd_api{1|2|3|4}.log

10MB

2.5MB

Base_Path¥log¥JBSCOM¥jbscomd_snd{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd_snd{1|2|3|4}.log

10MB

2.5MB

Base_Path¥log¥JBSCOM¥jbscomd_rcv{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥jbscomd_rcv{1|2|3|4}.log

10MB

2.5MB

Base_Path¥log¥JBSCOM¥command{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥JBSCOM¥command{1|2|3|4}.log

10MB

2.5MB

稼働情報採取コマンドエラーログ

Base_Path¥log¥jbsopi¥jbsopi_cmd{1|2|3|4|5}.log

5MB

1MB

稼働情報API用ログ

Base_Path¥log¥jbsopi¥jbsopi_api{1|2|3|4|5}.log

共有フォルダ¥jp1base¥log¥jbsopi¥jbsopi_api{1|2|3|4|5}.log

5MB

1MB

サービス管理制御ログ

Base_Path¥log¥jbssrvmgr¥jbssrvmgr{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥jbssrvmgr¥jbssrvmgr{1|2|3|4}.log

10MB

2.5MB

サービス管理制御トレースログ

Base_Path¥log¥jbssrvmgr¥jbssrvmgr_trace{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥jbssrvmgr¥jbssrvmgr_trace{1|2|3|4}.log

10MB

2.5MB

サービス管理制御API用ログ

Base_Path¥log¥jbssrvmgr¥jbssrvmgr_api{1|2|3|4}.log

共有フォルダ¥jp1base¥log¥jbssrvmgr¥jbssrvmgr_api{1|2|3|4}.log

10MB

2.5MB

ローカルアクション実行履歴ログ

Base_Path¥log¥lcact¥localact{1〜n}※14.log

共有フォルダ¥jp1base¥log¥lcact¥localact{1〜n}※14.log

1,024KB※14

256KB※14

ローカルアクションログ

Base_Path¥log¥jbslcact¥jbslcact{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbslcact¥jbslcact{1|2|3|4|5|6|7|8}.log

2,048KB

256KB

Base_Path¥log¥jbslcact¥jbslcact_list{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbslcact¥jbslcact_list{1|2|3|4|5|6|7|8}.log

2,048KB

256KB

Base_Path¥log¥jbslcact¥jbslcact_cancel{1|2|3|4|5|6|7|8}.log

共有フォルダ¥jp1base¥log¥jbslcact¥jbslcact_cancel{1|2|3|4|5|6|7|8}.log

2,048KB

256KB

製品情報ログ

Base_Path¥log¥hliclib¥hliclib*.log

5MB

1MB

JP1/Base通信基盤ログ

%ALLUSERSPROFILE%¥Hitachi¥JP1¥jp1_default¥JP1Base¥log¥jp1BsComm¥error{1|2|3|4|5}.log※10

5MB

1MB

設定情報収集コマンド個別ログ

Base_Path¥log¥JBS_SETUP¥JBSPARAMDUMP{1|2}.log

2MB

1MB

転送抑止および抑止解除の記録用ログ

Base_Path¥conf¥event¥servers¥default¥suppress¥エージェントのホスト名¥{log|log.old}※7

128KB

64KB

イベント転送抑止コマンド用トレースログ

Base_Path¥sys¥tmp¥event¥servers¥default¥jevagtfw.{000|001|002|003|004}※7

5MB

1MB

注※1　インストール時の環境変数「%ALLUSERSPROFILE%」に設定されている値になります。

注※2　JP1/IM - Manager用のログファイルです。

注※3　JP1/IM - Managerのjcocmddefコマンドの-recordオプションを使うことで以下の範囲で変更できます。

レコード数1の場合（-record 1）

DRFファイル:7KB，K01ファイル:4KB

レコード数20,000の場合（初期設定値）

DRFファイル:125MB，K01ファイル:200KB

レコード数196,600の場合（-record 196600）

DRFファイル:1.2GB，K01ファイル:2MB

注※4　jbsplugincomプロセス識別番号を示します。

注※5　ファイル数・最大ディスク占有量は，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で変更できます。変更できる範囲については，「付録I.5　操作ログを出力するための設定」を参照してください。

注※6　JP1/Base起動時に，ファイルの切り替えを自動で行うか行わないかを，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で指定できます。

注※7　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるフォルダに格納されます。

注※8　ファイル数，最大ディスク占有量は，イベントサーバ設定ファイル（conf）で変更できます。変更できる範囲については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

注※9　ファイル数・最大ディスク占有量は，API設定ファイル（api）で変更できます。変更できる範囲については，「16.　定義ファイル」の「API設定ファイル」を参照してください。

注※10　実行時の環境変数「%ALLUSERSPROFILE%」に設定されている値になります。

注※11　1行は100バイト程度です。

注※12　ログファイルトラップ起動時に作成され，正常終了時に削除されます。エラー発生時には，ログファイルトラップを終了したときにファイルがそのまま残ります。ログファイルトラップでエラーが多発すると，エラーファイルが増えていくため，不要なエラーファイルは削除する必要があります。

注※13　ファイル数・最大ディスク占有量は，ログ情報定義ファイル（jevlogd.conf）で変更できます。変更できる範囲については，「16.　定義ファイル」の「ログ情報定義ファイル」を参照してください。

注※14　ファイル数・最大ディスク占有量は，共通定義設定用ファイル（ローカルアクション機能）で変更できます。変更できる範囲については，「16.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。

注※15　ログの出力形式は，HNTRLib2（マルチプロセス対応トレース）です。

注※16　ログを削除する場合，ログ出力先フォルダにあるmmapフォルダも削除してください。

付録A.2　ファイルおよびディレクトリ一覧（UNIXの場合）

表A‒4　JP1/Baseのファイルおよびディレクトリ一覧（UNIXの場合）

内容

ファイル名・ディレクトリ名

コマンド格納ディレクトリ

/opt/jp1base/bin/

/opt/jp1base/bin/ext/※1

環境設定ディレクトリ※²

/etc/opt/jp1base/conf/

共有ディレクトリ/jp1base/conf/

言語種別設定ファイル

/etc/opt/jp1base/conf/jp1bs_param.conf

共有ディレクトリ/jp1base/conf/jp1bs_param.conf

構成定義ファイル

/etc/opt/jp1base/conf/route/jbs_route.conf

共有ディレクトリ/jp1base/conf/route/jbs_route.conf

起動プロセス定義ファイル

/etc/opt/jp1base/conf/jp1bs_spmd.conf

/etc/opt/jp1base/conf/jp1bs_spmd.conf.model（認証サーバの起動なし（2038年非対応））

/etc/opt/jp1base/conf/jp1bs_spmd.conf.session.model（認証サーバの起動あり（2038年非対応））

/etc/opt/jp1base/conf/jp1bs_spmd.conf.2038_model（認証サーバの起動なし（2038年対応））

/etc/opt/jp1base/conf/jp1bs_spmd.conf.session.2038_model（認証サーバの起動あり（2038年対応））

文字コードマッピング定義ファイル

/opt/jp1base/lib/eventenc.dat

/opt/jp1base/lib/eventenc.dat.model

言語種別マッピング定義ファイル

/opt/jp1base/lib/eventlng.dat

/opt/jp1base/lib/eventlng.dat.model

JP1/IM関数　ヘッダーファイル

/opt/jp1base/include/JevApi.h

ログディレクトリ※³

/var/opt/jp1base/log/

共有ディレクトリ/jp1base/log/

プラグイン用ディレクトリ

/opt/jp1base/plugin/

稼働情報格納ディレクトリ

/var/opt/jp1base/sys/OPI/

共有ディレクトリ/jp1base/sys/OPI/

イベントDB格納ディレクトリ※⁴

/var/opt/jp1base/sys/event/servers/※⁵

共有ディレクトリ/event/※⁵

jp1hosts2情報

/var/opt/jp1base/sys/jp1hosts2/hostdb{0|1}.bin

共有ディレクトリ/jp1base/sys/jp1hosts2/hostdb{0|1}.bin

ログおよびテンポラリーディレクトリ※³

/var/opt/jp1base/sys/tmp/event/servers/※⁵

イベントID保存ファイル

/var/opt/jp1base/sys/tmp/event/servers/default/ereb.backup※⁵

ログファイルトラップ機能内部動作ファイル

/var/opt/jp1base/sys/tmp/event/logtrap/conftbl.ID番号

ツール関連ディレクトリ

/opt/jp1base/tools/

資料採取ツールサンプルスクリプトファイル

/opt/jp1base/tools/jbs_log.sh

JP1イベントを発行および取得する関数サンプルソースファイル

/opt/jp1base/tools/event/receiver.c

/opt/jp1base/tools/event/sender.c

AR System連携用サンプルスクリプトファイル

/opt/jp1base/tools/helpdesk/register_ars.sh

統合トレースログディレクトリ

/var/opt/hitachi/HNTRLib2/spool/

IT Report Utility（システム情報採取ツール）関連フォルダ

IT Report Utilityと連携するためのファイル

/etc/opt/hitachi/systoru/pattern/!830_HNTRLIB2

転送抑止状態管理ディレクトリ

/etc/opt/jp1base/conf/event/servers/default/suppress※⁵

エージェントごとの転送抑止情報ディレクトリ

/etc/opt/jp1base/conf/event/servers/default/suppress/エージェントのホスト名※⁵

オートスケール連携スクリプトディレクトリ※²

/opt/jp1base/tools/cloud/

スクリプトファイル

/opt/jp1base/tools/cloud/jbsas_setup_agent.sh

/opt/jp1base/tools/cloud/jbsas_add_agent.sh

/opt/jp1base/tools/cloud/jbsas_add_agent_cli.sh

/opt/jp1base/tools/cloud/jbsas_del_agent.sh

/opt/jp1base/tools/cloud/jbsas_del_agent_cli.sh

スクリプトファイルのモデルファイル

/opt/jp1base/tools/cloud/jbsas_setup_agent.sh.model

/opt/jp1base/tools/cloud/jbsas_add_agent.sh.model

/opt/jp1base/tools/cloud/jbsas_add_agent_cli.sh.model

/opt/jp1base/tools/cloud/jbsas_del_agent.sh.model

/opt/jp1base/tools/cloud/jbsas_del_agent_cli.sh.model

内部ファイル

/opt/jp1base/tools/cloud/jbsas_util.sh

/opt/jp1base/tools/cloud/jbsas_hosts

内部ファイルのモデルファイル

/opt/jp1base/tools/cloud/jbsas_util.sh.model

共通定義情報退避ファイル出力先ディレクトリ

/tmp/JP1_COMDEF/

共通定義情報（JP1/Baseを除く）退避ファイル（物理ホスト）

comdef_JP1_DEFAULT.conf

共通定義情報（JP1/Baseを除く）退避ファイル（論理ホスト）

comdef_論理ホスト名.conf

内部ファイル

logical.list

注※1　Linuxの場合に作成されます。

注※2　定義ファイルについては，「付録A.2(1)　定義ファイル一覧（UNIXの場合）」を参照してください。

注※3　ログファイルについては，「付録A.2(2)　ログファイル一覧（UNIXの場合）」を参照してください。

注※4　イベントDBのファイル名については，「2.3.2　イベントDBとは」を参照してください。

注※5　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるディレクトリに格納されます。

(1)　定義ファイル一覧（UNIXの場合）

表A‒5　定義ファイル一覧（UNIXの場合）

機能

ファイル名・ディレクトリ名

イベントサービス

イベントサーバインデックスファイル

/etc/opt/jp1base/conf/event/index

イベントサーバ設定ファイル

/etc/opt/jp1base/conf/event/servers/default/conf※1

共有ディレクトリ/event/conf※1

転送設定ファイル

/etc/opt/jp1base/conf/event/servers/default/forward※1

共有ディレクトリ/event/forward※1

イベント転送抑止用の転送設定ファイル

/etc/opt/jp1base/conf/event/servers/default/suppress/forward_suppress※1

任意の転送抑止定義ファイル

/etc/opt/jp1base/conf/event/servers/default/suppress/転送抑止定義ファイル名※1

API設定ファイル

/etc/opt/jp1base/conf/event/api

転送受信用の属性付加設定ファイル

/etc/opt/jp1base/conf/event/servers/default/recv_add_extattr※1

共有ディレクトリ/event/recv_add_extattr※1

イベント登録用の属性付加設定ファイル

/etc/opt/jp1base/conf/event/servers/default/send_add_extattr※1

共有ディレクトリ/event/send_add_extattr※1

イベント変換機能

ログファイルトラップ動作定義ファイル

任意のファイルおよび任意のディレクトリを指定できます。

ログファイルトラップ起動定義ファイル

/etc/opt/jp1base/conf/event/jevlog_start.conf

ログ情報定義ファイル

/etc/opt/jp1base/conf/event/jevlogd.conf

イベントサービスの定義情報の収集・配布機能

配布定義ファイル（転送設定ファイル）

/etc/opt/jp1base/conf/event/servers/default/[jev_forward.conf | 任意のファイル]※2

共有ディレクトリ/event/[jev_forward.conf | 任意のファイル]※2

配布定義ファイル（ログファイルトラップ動作定義ファイル）

/etc/opt/jp1base/conf/[jev_logtrap.conf | 任意のファイル]※2

配布定義ファイル（イベントログトラップ動作定義ファイル）

/etc/opt/jp1base/conf/event/[jev_ntevent.conf | 任意のファイル]※2

ユーザー管理機能

ユーザー権限レベルファイル

/etc/opt/jp1base/conf/user_acl/JP1_UserLevel

共有ディレクトリ/jp1base/conf/user_acl/JP1_UserLevel

ユーザーマッピング定義ファイル

/etc/opt/jp1base/conf/user_acl/jp1BsUmap.conf

共有ディレクトリ/jp1base/conf/user_acl/jp1BsUmap.conf

パスワードポリシー定義ファイル

/etc/opt/jp1base/conf/passwdpolc/jp1bs_passwdpolc.conf

共有ディレクトリ/jp1base/conf/passwdpolc/jp1bs_passwdpolc.conf

ヘルスチェック機能

ヘルスチェック定義ファイル

/etc/opt/jp1base/conf/jbshc/jbshc.conf

共有ディレクトリ/jp1base/conf/jbshc/jbshc.conf

共通定義設定用ファイル（ヘルスチェック機能）のモデルファイル

/etc/opt/jp1base/conf/jbshc/jbshc_setup.conf.model

共有ディレクトリ/jp1base/conf/jbshc/jbshc_setup.conf.model

共通定義設定用ファイル（ヘルスチェック機能）（07-10以前からのバージョンアップ用）のモデルファイル

/etc/opt/jp1base/default/jbshc_com.conf.model

共有ディレクトリ/jp1base/default/jbshc_com.conf.model

プラグインサービス

要求転送設定ファイル

/etc/opt/jp1base/conf/plugin/reqforward.conf

共有ディレクトリ/jp1base/conf/plugin/reqforward.conf

操作ログ出力機能

操作ログ定義ファイル

/etc/opt/jp1base/conf/jp1bs_baselog_setup.conf

/etc/opt/jp1base/conf/jp1bs_baselog_setup.conf.model

プロセス管理機能

JP1/Baseパラメーター定義ファイル

/etc/opt/jp1base/conf/jp1bs_param_V7.conf

共有ディレクトリ/jp1base/conf/jp1bs_param_V7.conf

拡張起動プロセス定義ファイル

/etc/opt/jp1base/conf/jp1bs_service_0700.conf

共有ディレクトリ/jp1base/conf/jp1bs_service_0700.conf

通信設定

jp1hosts定義ファイル

/etc/opt/jp1base/conf/jp1hosts

共有ディレクトリ/jp1base/conf/jp1hosts

jp1hosts2定義ファイル

/etc/opt/jp1base/conf/jp1hosts2.conf

共有ディレクトリ/jp1base/conf/jp1hosts2.conf

通信方式設定ファイル

/etc/opt/jp1base/conf/physical_ipany.conf

/etc/opt/jp1base/conf/logical_ipany.conf

/etc/opt/jp1base/conf/physical_recovery_0651.conf

/etc/opt/jp1base/conf/logical_recovery_0651.conf

/etc/opt/jp1base/conf/physical_anyany.conf

/etc/opt/jp1base/conf/physical_ipip.conf

/etc/opt/jp1base/conf/logical_ipip.conf

共有ディレクトリ/jp1base/conf/physical_ipany.conf

共有ディレクトリ/jp1base/conf/logical_ipany.conf

共有ディレクトリ/jp1base/conf/physical_recovery_0651.conf

共有ディレクトリ/jp1base/conf/logical_recovery_0651.conf

共有ディレクトリ/jp1base/conf/physical_anyany.conf

共有ディレクトリ/jp1base/conf/physical_ipip.conf

共有ディレクトリ/jp1base/conf/logical_ipip.conf

ホストアクセス制限定義ファイル

/etc/opt/jp1base/conf/jbsdfts/jbsdfts_srv.conf

SSL通信定義ファイル

/etc/opt/jp1base/conf/jp1bs_ssl.conf

共有ディレクトリ/jp1base/conf/jp1bs_ssl.conf

非SSL通信ホスト設定ファイル

/etc/opt/jp1base/conf/jp1bs_nosslhost.conf

SSL定義書き出しファイル

/var/opt/jp1base/sys/tmp/event/servers/default/ssl.conf

共有ディレクトリ/jp1base/event/ssl.conf

非SSL通信ホスト設定ファイル退避ファイル（JP1/Base本体）

/var/opt/jp1base/sys/nossl_base.conf

/var/opt/jp1base/sys/nossl_base{1|2|3}.conf

共有ディレクトリ/jp1base/sys/nossl_base.conf

共有ディレクトリ/jp1base/sys/nossl_base{1|2|3}.conf

非SSL通信ホスト設定ファイル退避ファイル（イベントサービス）

/var/opt/jp1base/sys/tmp/event/servers/default/nossl_evt.conf

/var/opt/jp1base/sys/tmp/event/servers/default/nossl_evt{1|2|3}.conf

共有ディレクトリ/event/nossl_evt.conf

共有ディレクトリ/event/nossl_evt{1|2|3}.conf

ローカルアクション機能

ローカルアクション環境変数ファイル

任意のファイルおよび任意のフォルダを指定できます。

ローカルアクション実行定義ファイル

/etc/opt/jp1base/conf/lcact/jbslcact.conf

共有ディレクトリ/jp1base/conf/lcact/jbslcact.conf

共通定義設定用ファイル（ローカルアクション機能）

/etc/opt/jp1base/conf/lcact/jp1bs_lcact_setup.conf.model

共有ディレクトリ/jp1base/conf/lcact/jp1bs_lcact_setup.conf.model

JP1/Baseの設定情報の一括収集

収集情報ファイル

/etc/opt/jp1base/conf/jbsparamdump.conf

構成管理機能

共通定義設定用ファイル（構成管理機能）

/etc/opt/jp1base/conf/route/jbsrt_setup.conf.model

共有ディレクトリ/jp1base/conf/route/jbsrt_setup.conf.model

オートスケール連携スクリプト

スクリプト定義ファイル

/opt/jp1base/tools/cloud/jbsas_setup_agent.ini

/opt/jp1base/tools/cloud/jbsas_setup_manager.ini

/opt/jp1base/tools/cloud/jbsas_setup_manager_cli.ini

スクリプト定義ファイルのモデルファイル

/opt/jp1base/tools/cloud/jbsas_setup_agent.ini.model

/opt/jp1base/tools/cloud/jbsas_setup_manager.ini.model

/opt/jp1base/tools/cloud/jbsas_setup_manager_cli.ini.model

注※1　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるディレクトリに格納されます。

注※2　定義情報の配布機能を使用していない場合には存在しません。

(2)　ログファイル一覧（UNIXの場合）

JP1/Baseが出力する初期設定のログファイルの一覧を次の表に示します。

重要

JP1/Baseが出力するログファイルには，製品保守の必要上出力している内部ログファイルがあります。これらは，ユーザーが参照，または変更する必要はありません。なお，システム障害が発生したときなど資料採取のために，これらのファイルをご利用元で一時保管していただくことがあります。

「ログの種類」には，JP1/Baseが出力するログの種類を記載しています。

「ファイル名・フォルダ名」には，JP1/Baseを初期設定でインストールした場合のログファイル名と，クラスタ運用の場合のログファイル名をフルパスで記載しています。

「最大ディスク占有量」には，ログファイルが最大でどの程度ディスクを使用するのかを記載しています。ログファイルが複数ある場合は，その合計量を記載しています。

「ファイルの切り替え時期」には，JP1/Baseが出力先のログファイルを切り替えるタイミングを記載しています。ファイルがこの欄に示すサイズに達したとき，または，この欄に示す事象が起きたときに出力先が切り替わります。なお，ログファイルが一つの場合，ファイルの切り替えが発生すると同ファイルに上書きされます。ログファイルが複数あり，最大ディスク占有量に達した場合は，更新日付の古いファイルから上書きされます。

表A‒6　ログファイル一覧（UNIXの場合）

ログの種類

ファイル名・ディレクトリ名

最大ディスク占有量

ファイルの切り替え時期

JP1/Base起動時ログ

/var/opt/jp1base/log/JBS_START/jbs_start.log[.old]

共有ディレクトリ/jp1base/log/JBS_START/jbs_start.log[.old]

128KB

コマンド実行時

JP1/Base終了時ログ

/var/opt/jp1base/log/JBS_STOP/jbs_stop.log[.old]

共有ディレクトリ/jp1base/log/JBS_STOP/jbs_stop.log[.old]

128KB

コマンド実行時

プロセス管理ログ

/var/opt/jp1base/log/JBS_SPMD{1|2|3}.log

共有ディレクトリ/jp1base/log/JBS_SPMD{1|2|3}.log

384KB

128KB

/var/opt/jp1base/log/JBS_SPMD_COMMAND{1|2|3}.log

共有ディレクトリ/jp1base/log/JBS_SPMD_COMMAND{1|2|3}.log

384KB

128KB

認証サーバログ

/var/opt/jp1base/log/jbssessionapi.log{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbssessionapi.log{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/jbssessionmgr{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbssessionmgr{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/jbssessionmgr_trace{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbssessionmgr_trace{1|2|3|4|5|6|7|8}.log

5MB

640KB

認証サーバ設定コマンドログ

/var/opt/jp1base/log/JBSSESS{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JBSSESS{1|2|3|4|5|6|7|8}.log

5MB

640KB

コマンド実行履歴ファイル（ISAM）※1

/var/opt/jp1base/log/COMMAND/actisamlogv8.DAT

共有ディレクトリ/jp1base/log/COMMAND/actisamlogv8.DAT

1.2GB※2

なし

/var/opt/jp1base/log/COMMAND/actisamlogv8.K01

共有ディレクトリ/jp1base/log/COMMAND/actisamlogv8.K01

2MB※2

なし

/var/opt/jp1base/log/COMMAND/actisamlogv8.DEF

共有ディレクトリ/jp1base/log/COMMAND/actisamlogv8.DEF

1KB

コマンド実行時

/var/opt/jp1base/log/COMMAND/cmdisamlogv8.DAT

共有ディレクトリ/jp1base/log/COMMAND/cmdisamlogv8.DAT

1.2GB※2

なし

/var/opt/jp1base/log/COMMAND/cmdisamlogv8.K01

共有ディレクトリ/jp1base/log/COMMAND/cmdisamlogv8.K01

2MB※2

なし

/var/opt/jp1base/log/COMMAND/cmdisamlogv8.DEF

共有ディレクトリ/jp1base/log/COMMAND/cmdisamlogv8.DEF

1KB

コマンド実行時

共通定義情報ログ

/var/opt/jp1base/log/JBSCNFCMD/JBSCNFCMD{1|2}.log

128KB

64KB

jp1hosts情報コマンドログ

/var/opt/jp1base/log/JBSCNFCMD/JBSCOMMCMD{1|2}.log

128KB

64KB

ユーザーマッピングコマンドログ

/var/opt/jp1base/log/JBSUMAPCMD/JBSUMAPCMD{1|2}.log

共有ディレクトリ/jp1base/log/JBSUMAPCMD/JBSUMAPCMD{1|2}.log

128KB

64KB

リモートコマンドログ※1

/var/opt/jp1base/log/JCOCMD/jcocmd_result{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmd_result{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdapi{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdapi_trace{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdapi_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdcmc{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdcmc{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdcmc_trace{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdcmc_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdcom{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdcom{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdcom_trace{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdcom_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdexe{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdexe{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdexe_trace{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdexe_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdrouter{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdrouter{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/jcocmdrouter_trace{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/jcocmdrouter_trace{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

/var/opt/jp1base/log/JCOCMD/JCOCMDCMD{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/JCOCMD/JCOCMDCMD{1|2|3|4|5|6|7|8}.log

20MB

2.5MB

プラグインサービスログ

/var/opt/jp1base/log/plugin/jbsplugin{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugin{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/plugin/jbsplugincom_{0|1|2|3|4|5|6|7|8|9}※3_{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugincom_{0|1|2|3|4|5|6|7|8|9}※3_{1|2|3|4|5|6|7|8}.log

50MB

640KB

/var/opt/jp1base/log/plugin/jbsplugincmd{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugincmd{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/plugin/jbspluginmgrapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbspluginmgrapi{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/plugin/jbsplugincomapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugincomapi{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/plugin/jbsplugincmdapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbsplugincmdapi{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/plugin/jbspluginhcshm{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbspluginhcshm{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/plugin/jbsrmtcmd{1|2|3|4|5|6|7|8}.log

2,048KB

256KB

/var/opt/jp1base/log/plugin/jbspluginremotecmd{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/plugin/jbspluginremotecmd{1|2|3|4|5|6|7|8}.log

5MB

640KB

/var/opt/jp1base/log/plugin/jbsrmtapi{1|2|3|4|5|6|7|8}.log

2,048KB

256KB

インストール時のログ

/tmp/HITACHI_JP1_INST_LOG/jp1base_inst{1|2|3|4|5}.log

128KB

インストール時

/etc/.hitachi/.hliclog/hliclibtrc{1|2|3|4|5}.log

10MB

2MB

/etc/.hitachi/.hliclog/hliclibmgrtrc{1|2|3|4|5}.log

10MB

2MB

/etc/.hitachi/.hliclog/hlicliberr{1|2|3|4|5}.log

50KB

10KB

/etc/.hitachi/.hliclog/hliclibmgrerr{1|2|3|4|5}.log

50KB

10KB

/etc/.hitachi/.hliclog/hliccmd{1|2|3|4|5}.log

1MB

Hitachi PP Installer起動時

/tmp/rf/hrf4securityinstall{1|2}.log

4MB

インストール実行時に1MBを超えていた場合

/tmp/rf/hrf4installhitachi.log

10MB

インストール時

/tmp/rf/hrf4unknowninstall{1|2}.log

4MB

インストール実行時に1MBを超えていた場合

セットアップ時のログ

/var/opt/jp1base/log/JBS_SETUP/jbs_setup.log

−

なし※¹⁵

構成管理ログ※1

/var/opt/jp1base/log/route/JBSRT{1|2|3|4|5}.log

共有ディレクトリ/jp1base/log/route/JBSRT{1|2|3|4|5}.log

20MB

4MB

ヘルスチェック機能ログ（自ホスト監視）

/var/opt/jp1base/log/jbshc/jbshc{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshc{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

ヘルスチェック機能ログ（他ホスト監視）

/var/opt/jp1base/log/jbshc/jbshchost{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshchost{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

ヘルスチェックコマンドログ

/var/opt/jp1base/log/jbshc/jbshcstatus{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshcstatus{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

ヘルスチェックAPI用ログ

/var/opt/jp1base/log/jbshc/jbshcapi{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshcapi{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

ヘルスチェック共有メモリー削除コマンドログ

/var/opt/jp1base/log/jbshc/jbshcshmctl{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbshc/jbshcshmctl{1|2|3|4|5|6|7|8}.log

50MB

6.25MB

操作ログ

/var/opt/jp1base/log/BASE/base_log[{1|2|3|4|5|6|7|8|9|10|11|12|13|14|15|16}].log

68MB※4

1,024KB※4※5

イベント設定一元管理取得コマンド用トレースログ

/var/opt/jp1base/sys/tmp/event/servers/default/jevdef_get.{000|001|002}※6

共有ディレクトリ/event/jevdef_get.{000|001|002}※6

192KB

コマンド実行時

イベント設定一元管理配布コマンド用トレースログ

/var/opt/jp1base/sys/tmp/event/servers/default/jevdef_distrib.{000|001|002}※6

共有ディレクトリ/event/jevdef_distrib.{000|001|002}※6

192KB

コマンド実行時

イベントサービス用トレースログ

/var/opt/jp1base/sys/tmp/event/servers/default/trace.{000|001|002|003|004}※6※7

共有ディレクトリ/event/trace.{000|001|002|003|004}※6※7

12.5MB※7

イベントサービス起動時

/var/opt/jp1base/sys/tmp/event/servers/default/imevterr.{000|001|002|003|004}※6※7

共有ディレクトリ/event/imevterr.{000|001|002|003|004}※6※7

5MB※7

イベントサービス起動時

/var/opt/jp1base/sys/tmp/event/servers/default/imses.{log|old}※6

共有ディレクトリ/event/imses.{log|old}※6

2MB

イベントサービス起動時

イベントサービス用転送エラーログ

/var/opt/jp1base/sys/tmp/event/servers/default/fwderr.{000|001|002|003|004}※6※7

共有ディレクトリ/event/fwderr.{000|001|002|003|004}※6※7

5MB※7

イベントサービス起動時

イベントサービス用エラーログ

/var/opt/jp1base/sys/tmp/event/servers/default/error.{000|001|002|003|004}※6※7

共有ディレクトリ/event/error.{000|001|002|003|004}※6※7

2,500KB※7

イベントサービス起動時

イベントサービスAPI用ログ

/var/opt/jp1base/sys/tmp/event/IMEvapi.{000|001|002|003|004}※8

5MB※8

1MB※8

イベントサービス用ログ

/var/opt/jp1base/sys/tmp/event/IMEvenc.{000|001|002|003|004}

5MB

1MB

イベント登録/受信プロセスとイベントサービスとの通信で発生したエラー情報

/var/opt/jp1base/sys/tmp/event/sock.log

1KB

1KB

ログファイルトラップエラーログ

/var/opt/jp1base/sys/tmp/event/logtrap/.errorfile.ID番号

数百バイト程度※⁹

ログファイルトラップ起動時

ログファイルトラップログ

/var/opt/jp1base/sys/tmp/event/logtrap/jevtraplog/jevtraplog.{000|001|002|003|004}

5MB※¹⁰

1MB※¹⁰

ログファイルトラップ起動実行結果ログ

/var/opt/jp1base/log/jevlog_start/jevlog_start{1|2|3}.log※¹³※¹⁴

3MB

1MB

リモート監視ログ（ログファイルトラップ）

/var/opt/jp1base/sys/tmp/event/logtrap/jelallog/jelallog{1-5}.log

5MB

1MB

jbs_killall.clusterコマンドトレースログ※¹¹

共有ディレクトリ/jp1base/log/jbs_killall.cluster[.{1|2|3|4}]

256KB

コマンド実行時

プロセス間通信トレースログ

/var/opt/jp1base/log/JBSCOM/jbscomd{1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd{1|2|3|4}.log

10MB

2.5MB

/var/opt/jp1base/log/JBSCOM/jbscomd_api{1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd_api{1|2|3|4}.log

10MB

2.5MB

/var/opt/jp1base/log/JBSCOM/jbscomd_snd{1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd_snd{1|2|3|4}.log

10MB

2.5MB

/var/opt/jp1base/log/JBSCOM/jbscomd_rcv{1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/jbscomd_rcv{1|2|3|4}.log

10MB

2.5MB

/var/opt/jp1base/log/JBSCOM/command{1|2|3|4}.log

共有ディレクトリ/jp1base/log/JBSCOM/command{1|2|3|4}.log

10MB

2.5MB

稼働情報採取コマンドエラーログ

/var/opt/jp1base/log/jbsopi/jbsopi_cmd{1|2|3|4|5}.log

5MB

1MB

稼働情報API用ログ

/var/opt/jp1base/log/jbsopi/jbsopi_api{1|2|3|4|5}.log

共有ディレクトリ/jp1base/log/jbsopi/jbsopi_api{1|2|3|4|5}.log

5MB

1MB

サービス管理制御ログ

/var/opt/jp1base/log/jbssrvmgr/jbssrvmgr{1|2|3|4}.log

共有ディレクトリ/jp1base/log/jbssrvmgr/jbssrvmgr{1|2|3|4}.log

10MB

2.5MB

サービス管理制御トレースログ

/var/opt/jp1base/log/jbssrvmgr/jbssrvmgr_trace{1|2|3|4}.log

共有ディレクトリ/jp1base/log/jbssrvmgr/jbssrvmgr_trace{1|2|3|4}.log

10MB

2.5MB

サービス管理制御API用ログ

/var/opt/jp1base/log/jbssrvmgr/jbssrvmgr_api{1|2|3|4}.log

共有ディレクトリ/jp1base/log/jbssrvmgr/jbssrvmgr_api{1|2|3|4}.log

10MB

2.5MB

ローカルアクション実行履歴ログ

/var/opt/jp1base/log/lcact/localact{1〜n}※¹².log

共有ディレクトリ/jp1base/log/lcact/localact{1〜n}※¹².log

1,024KB※¹²

256KB※¹²

ローカルアクションログ

/var/opt/jp1base/log/jbslcact/jbslcact{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbslcact/jbslcact{1|2|3|4|5|6|7|8}.log

2,048KB

256KB

/var/opt/jp1base/log/jbslcact/jbslcact_list{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbslcact/jbslcact_list{1|2|3|4|5|6|7|8}.log

2,048KB

256KB

/var/opt/jp1base/log/jbslcact/jbslcact_cancel{1|2|3|4|5|6|7|8}.log

共有ディレクトリ/jp1base/log/jbslcact/jbslcact_cancel{1|2|3|4|5|6|7|8}.log

2,048KB

256KB

JP1/Base管理者設定コマンドログ

/var/opt/jp1base/log/JBS_SETUP/jbssetadmingrp{1|2}.log

128KB

64KB

JP1/Base通信基盤ログ

/var/opt/jp1base/log/jp1BsComm/error{1|2|3|4|5}.log

5MB

1MB

設定情報収集コマンド個別ログ

/var/opt/jp1base/log/JBS_SETUP/JBSPARAMDUMP{1|2}.log

2MB

1MB

転送抑止および抑止解除の記録用ログ

/etc/opt/jp1base/conf/event/servers/default/suppress/エージェントのホスト名/{log|log.old}※6

128KB

64KB

イベント転送抑止コマンド用トレースログ

/var/opt/jp1base/sys/tmp/event/servers/default/jevagtfw.{000|001|002|003|004}※6

5MB

1MB

注※1　JP1/IM - Manager用のログファイルです。

注※2　JP1/IM - Managerのjcocmddefコマンドの-recordオプションを使うことで以下の範囲で変更できます。

レコード数1の場合（-record 1）

DATファイル:7KB，K01ファイル:4KB

レコード数20,000の場合（初期設定値）

DATファイル:125MB，K01ファイル:200KB

レコード数196,600の場合（-record 196600）

DATファイル:1.2GB，K01ファイル:2MB

注※3　jbsplugincomプロセス識別番号を示します。

注※4　ファイル数・最大ディスク占有量は，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で変更できます。変更できる範囲については，「付録I.5　操作ログを出力するための設定」を参照してください。

注※5　JP1/Base起動時に，ファイルの切り替えを自動で行うか行わないかを，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で指定できます。

注※6　イベントサーバインデックスファイル（index）で別パスを指定した場合は，異なるディレクトリに格納されます。

注※7　ファイル数，最大ディスク占有量は，イベントサーバ設定ファイル（conf）で変更できます。変更できる範囲については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

注※8　ファイル数・最大ディスク占有量は，API設定ファイル（api）で変更できます。変更できる範囲については，「16.　定義ファイル」の「API設定ファイル」を参照してください。

注※9　ログファイルトラップ起動時に作成され，正常終了時に削除されます。エラー発生時には，ログファイルトラップを終了したときにファイルがそのまま残ります。ログファイルトラップでエラーが多発すると，エラーファイルが増えていくため，不要なエラーファイルは削除する必要があります。

注※10　ファイル数・最大ディスク占有量は，ログ情報定義ファイル（jevlogd.conf）で変更できます。変更できる範囲については，「16.　定義ファイル」の「ログ情報定義ファイル」を参照してください。

注※11　クラスタ運用時にjbs_killall.clusterコマンドを実行すると出力されるログファイルです。

注※12　ファイル数・最大ディスク占有量は，共通定義設定用ファイル（ローカルアクション機能）で変更できます。変更できる範囲については，「16.　定義ファイル」の「共通定義設定用ファイル（ローカルアクション機能）」を参照してください。

注※13　ログの出力形式は，HNTRLib2（マルチプロセス対応トレース）です。

注※14　ログを削除する場合，ログ出力先ディレクトリにあるmmapディレクトリも削除してください。

注※15　インストール時など環境構築時だけログを出力します。

付録B　プロセス一覧

JP1/Baseのプロセスを次に示します。

付録B.1　プロセス一覧（Windowsの場合）

Windowsのタスク マネージャを使って，プロセスの動作状態を確認してください。正常に動作している場合に表示されるプロセスを次に示します。なお，表内の(　)内の数値は同時に実行できるプロセス数です。

親プロセス名

機能

子プロセス名

機能

hntr2srv.exe(2)

統合トレース起動用

−

−

hntr2mon.exe(2)

統合トレース

−

−

jbs_service.exe(1)

JP1/Baseプロセス管理起動用※1

−

−

jbs_spmd.exe(1)

JP1/Baseプロセス管理※1

jbssessionmgr.exe(1)※2※3

認証サーバ※1※6

認証サーバとして設定したホスト上にだけ存在する。

jbs_spmd_statusコマンドを実行した場合の表示名はjbssessionmgrとなる。

jbsroute.exe(1)※2

構成管理※1※6

jbs_spmd_statusコマンドを実行した場合の表示名はjbsrouteとなる。

jcocmd.exe(1)※2

jcocmdexe.exe(1)

jcocmdapi.exe(コマンド実行画面数※4+1（JP1/IM - Managerがインストールされている場合）)

jcocmdcom.exe(1)※5

コマンド実行※1※6

jbs_spmd_statusコマンドを実行した場合の表示名はjcocmdとなる。

jbsplugind.exe(1)※2

プラグインサービス※1※6

jbs_spmd_statusコマンドを実行した場合の表示名はjbspluginとなる。

jbshcd.exe(1)

ヘルスチェック（自ホスト監視用）※1※6

jbs_spmd_statusコマンドを実行した場合の表示名はjbshcdとなる。

jbshchostd.exe(1)

ヘルスチェック（他ホスト監視用）※1※6

jbs_spmd_statusコマンドを実行した場合の表示名はjbshchostdとなる。

jbssrvmgr.exe(1)

サービス管理制御機能※1※6

jbs_spmd_statusコマンドを実行した場合の表示名はjbssrvmgrとなる。

jbslcact.exe(1)

ローカルアクション機能※1※6

jbs_spmd_statusコマンドを実行した場合の表示名はjbslcactとなる。

jbscomd.exe(1)

jbscomd_api.exe(1)

jbscomd_ses.exe(1)

jbscomd_snd.exe(1)

jbscomd_rcv.exe(1)

プロセス間通信※1※6

jbs_spmd_statusコマンドを実行した場合の表示名はjbscomdとなる。

jbapmsrvcecon.exe(1)※3

起動管理

powendar.exe(1)

電源制御

JP1/Power Monitorがインストールされていると，この子プロセスが生成される。

jevservice.exe(1)

イベントサービス※1※7

−

−

jevtraplog.exe(1)

ログファイルトラップ

−

ログファイルトラップ

ログファイルトラップを使用した場合だけ生成される。

jevtrapevt.exe(1)

イベントログトラップ

−

イベントログトラップ

イベントログトラップを使用した場合だけ生成される。

（凡例）

−：なし

注※1　クラスタシステムで複数の論理ホストが一つの物理ホスト上で動作する場合，または一つの論理ホストと物理ホストが同時に起動される場合は，上記のプロセスの同時に実行できるプロセス数の上限は，（論理ホスト数+1）×プロセス数となります。

注※2　これらのプロセスは，JP1/Baseの基盤となる重要なプロセスです。JP1/Baseでは，これらのプロセスの異常終了時に備えて，異常終了時に自動で再起動する機能と，プロセスの異常を検知した場合にJP1イベントを発行する機能を提供しています。プロセス停止による業務への影響を最小限にするために，あらかじめ設定しておくことをお勧めします。設定方法については，「4.　JP1/Baseの障害に備えた設定」を参照してください。

注※3　タスクマネージャ上ではプロセス名称の途中までしか表示されません。

注※4　接続しているJP1/IM - Viewがコマンド実行画面を開いている数のことです。開いている画面数だけプロセス数が増えます。コマンド実行画面を閉じると，閉じた分だけプロセスは消滅します。

注※5　08-00で追加になったプロセスです。

注※6　これらのプロセスの状態は，jbs_spmd_statusコマンドで確認できます。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合

jbssessionmgr

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

認証サーバが設定されていない場合

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

注※7　これらのプロセスの状態は，jevstatコマンドで確認できます。jevstatコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

jevservice

付録B.2　プロセス一覧（UNIXの場合）

UNIXのpsコマンドを使ってプロセスの動作状態を確認してください。正常に動作している場合に表示されるプロセスを次に示します。なお，表内の(　)内の数値は同時に実行できるプロセス数です。

親プロセス名

機能

子プロセス名

機能

hntr2mon(1)

統合トレース

−

−

jbs_spmd(1)

プロセス管理※1

jbssessionmgr(1)※2

認証サーバ※1※5

認証サーバとして設定したホスト上にだけ存在する。

jbs_spmd_statusコマンドを実行した場合の表示名はjbssessionmgrとなる。

jbsroute(1〜9)※2

構成管理※1※5

jbs_spmd_statusコマンドを実行した場合の表示名はjbsrouteとなる。

jcocmd(1)※2

jcocmdexe(1)

jcocmdapi(コマンド実行画面数※3+1（JP1/IM - Managerがインストールされている場合）)

jcocmdcmc(0〜コマンド数※4)

jcocmdcom(1)※⁸

コマンド実行※1※5

jbs_spmd_statusコマンドを実行した場合の表示名はjcocmdとなる。

jbsplugind(1)※2※7

プラグインサービス※1※5

jbs_spmd_statusコマンドを実行した場合の表示名はjbspluginとなる。

jbshcd(1)

ヘルスチェック（自ホスト監視用）※1※5

jbs_spmd_statusコマンドを実行した場合の表示名はjbshcdとなる。

jbshchostd(1)

ヘルスチェック（他ホスト監視用）※1※5

jbs_spmd_statusコマンドを実行した場合の表示名はjbshchostdとなる。

jbssrvmgr(1)

サービス管理制御機能※1※5

jbs_spmd_statusコマンドを実行した場合の表示名はjbssrvmgrとなる。

jbslcact(1)

ローカルアクション機能※1※5

jbs_spmd_statusコマンドを実行した場合の表示名はjbslcactとなる。

jbscomd(1)

jbscomd_api(1)

jbscomd_ses(1)

jbscomd_snd(1)

jbscomd_rcv(1)

プロセス間通信※1※5

jbs_spmd_statusコマンドを実行した場合の表示名はjbscomdとなる。

jevservice(1)

イベントサービス※1※6

jevservice(5〜9,999)

−

jevlogd(1)

ログファイルトラップ

jelparentim

(0〜jevlogstartコマンド実行数)

ログファイルトラップ

jelparentim一つにつき，監視するファイル数分jelchildimプロセスが生成される。なお，jevlogstopコマンドを実行すれば，jelparentimプロセスは消滅する。

jelallog

(0〜ログファイルトラップのプロセス起動回数)

JP1/IMの［プロファイル表示/編集］画面から，リモート監視のログファイルトラップのプロセスを起動した回数だけ生成される。なお，プロセスを停止すれば消滅する。

（凡例）

−：なし

注※1　クラスタシステムで複数の論理ホストが一つの物理ホスト上で動作する場合，または一つの論理ホストと物理ホストが同時に起動される場合は，上記のプロセスの同時に実行できるプロセス数の上限は，（論理ホスト数+1）×プロセス数となります。

注※2　これらのプロセスは，JP1/Baseの基盤となる重要なプロセスです。JP1/Baseでは，これらのプロセスの異常終了時に備えて，異常終了時に自動で再起動する機能と，プロセスの異常を検知した場合にJP1イベントを発行する機能を提供しています。プロセス停止による業務への影響を最小限にするために，あらかじめ設定しておくことをお勧めします。設定方法については，「4.　JP1/Baseの障害に備えた設定」を参照してください。

注※3　接続しているJP1/IM - Viewがコマンド実行画面を開いている数のことです。開いている画面数だけプロセス数が増えます。コマンド実行画面を閉じると，閉じた分だけプロセスは消滅します。

注※4　JP1/IMによるリモートコマンドや自動アクションの実行数のことです。コマンド一つにつき，プロセスが一つ生成されます。処理が完了すると，プロセスは消滅します。なお，コマンドを連続して実行した場合，複数のプロセスが生成されることがあります。

注※5　これらのプロセスの状態は，jbs_spmd_statusコマンドで確認できます。jbs_spmd_statusコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

認証サーバが設定されている場合

jbssessionmgr

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

認証サーバが設定されていない場合

jbsroute

jcocmd

jbsplugin

jbshcd

jbshchostd

jbssrvmgr

jbslcact

jbscomd

注※6　これらのプロセスの状態は，jevstatコマンドで確認できます。jevstatコマンドを実行して正常にプロセスが動作しているときの表示を次に示します。

jevservice

注※7　ps-efコマンドで表示されるプロセス名は，「jbsplugin」となります。

注※8　07-51で追加になったプロセスです。

付録C　ポート番号一覧

JP1/Baseで使用するプロトコルはTCP/IPです。各ポート番号は，製品の提供時に初期設定されています。

注意事項

Windowsファイアウォールをオン（有効）にした環境でJP1/Baseを使用する場合，JP1/Baseのサービスで使用するポート番号を例外リストへ登録する必要があります。

ファイアウォールの設定については，JP1のWebサイトに公開しているドキュメントの「JP1/Base ファイアウォール設定ガイド」を参照してください。

付録C.1　JP1/Baseのポート番号

コネクション確立時は，次に示す表中のポート番号を，接続を受ける側が使用します。表中のポート番号に接続する側は，OSによって割り当てられる空きポート番号（エフェメラルポート）を使用します。この場合に使用するポート番号の範囲は，OSによって異なります。

表C‒1　JP1/Baseで使用するポート番号

サービス名

ポート番号

用途

jp1imevt

20098/tcp

JP1イベントを他ホストに転送するときに使用

jp1imevtapi

20099/tcp

JP1イベントを登録・取得するすべての製品，およびJP1イベント発行関数・JP1イベント取得関数で使用

jp1imrt

20237/tcp

構成管理で使用（JP1/IM - Manager使用時）

jp1imcmda

20238/tcp

コマンド実行で使用（JP1/IM - Manager使用時）

jp1imcmdc

20239/tcp

コマンド実行で使用（JP1/IM - Manager使用時）

jp1bsuser

20240/tcp

ユーザー認証サーバで使用

jp1bsplugin

20306/tcp

JP1/IM用定義情報の収集・配布時，JP1/Baseのヘルスチェック機能で使用，およびjevagtfwコマンドによるイベント転送抑止で使用

jp1bscom

20600/tcp

JP1/IMの構成管理とサービス管理制御との通信で使用

ldap

389/tcp※

ディレクトリサーバ連携で使用

ldaps

636/tcp※

注※　JP1/Base（認証サーバ）とディレクトリサーバ間の通信でSSLを利用するかどうかで使用するポート番号は変わります。SSLを利用する場合は，636/tcpを使用します。

付録C.2　ファイアウォールの通過方向

JP1/Baseは，パケットフィルタリング型，NAT（スタティックモード）型のアドレス変換をサポートしています。

表C‒2　ファイアウォールの通過方向

サービス名

ポート番号

ファイアウォールの通過方向

jp1imevt

20098/tcp

JP1イベント転送元のJP1/Base → JP1イベント転送先のJP1/Base

jp1imevtapi

20099/tcp

JP1/IM - ManagerなどのJP1イベントを取得するプログラム → JP1/Base

jp1imrt

20237/tcp

JP1/IM - Manager → JP1/Base

上位JP1/IM - Manager → 下位JP1/IM - Manager

jp1imcmda

20238/tcp

JP1/IM - View → JP1/IM - Managerが導入されているホストのJP1/Base

JP1/IM - Manager → JP1/Base

jp1imcmdc

20239/tcp

JP1/IM - Managerが導入されているホストのJP1/Base ←→ コマンド実行先ホストのJP1/Base

jp1bsuser

20240/tcp

JP1/IM - Manager → JP1/Base

JP1/AJS - Manager → JP1/Base

JP1/AJS - Agent → JP1/Base

jp1bsplugin

20306/tcp

JP1/IM - Managerなどのサービスを使用する上位プログラム → JP1/Base

JP1/Baseのヘルスチェック機能を使用する場合

監視ホストのJP1/Base → 監視対象ホストのJP1/Base

jp1bscom

20600/tcp

JP1/IM - Manager ←→ ほかのホストのJP1/Base

上位JP1/IM - Manager ←→ 下位JP1/IM - Manager

ldap

389/tcp※

JP1/Base（認証サーバ） → ディレクトリサーバ

ldaps

636/tcp※

ICMP

-

JP1/Base（jp1ping） → ほかのホストのJP1/Base

（凡例）

→：コネクション確立時，左項から右項への片方向で接続することを表す。

←→：コネクション確立時，両方向で相互接続することを表す。

注※　JP1/Base（認証サーバ）とディレクトリサーバ間の通信でSSLを利用するかどうかで使用するポート番号は変わります。SSLを利用する場合は，636/tcpを使用します。

表C-2のポート番号を利用してコネクションを確立したい場合は，ファイアウォールの設定で「サービス名のポート」と「サービス名のポート番号に対して確立されたセッションへの返信はANY」を必ず通すようにしてください。返信が「ANY」となるのは，OSによる自動採番のためです。

ファイアウォールサーバマシン上にJP1/Baseをインストールする場合は，同一マシン内での通信もファイアウォールの対象となる場合がありますので，同一マシン内でも通信できるように設定してください。

付録C.3　コネクションの接続状態

表C‒3　コネクションの接続状態

サービス名

ポート番号

コネクションの接続状態

jp1imevt

20098/tcp

イベントサーバ設定ファイル（conf）のremote-serverパラメーターにkeep-aliveを設定している場合，コネクションを維持します。強制的にコネクションを切断したい場合は，パラメーターにcloseを設定してください。

jp1imevtapi

20099/tcp

API設定ファイル（api）のserverパラメーターにkeep-aliveを設定している場合，コネクションを維持します。強制的にコネクションを切断したい場合は，パラメーターにcloseを設定してください。

jp1imrt

20237/tcp

コネクションは必要なときだけ接続します。

jp1imcmda

20238/tcp

コネクションを維持します。強制的にコネクションが切断された場合，再度コマンド実行要求が必要です。

jp1imcmdc

20239/tcp

コネクションを維持します。※1強制的にコネクションが切断された場合でも，自動的に再接続されます。

jp1bsuser

20240/tcp

コネクションは必要なときだけ接続します。

jp1bsplugin

20306/tcp

コネクションは必要なときだけ接続します。

jp1bscom

20600/tcp

コネクションは必要なときだけ接続します。

ldap

389/tcp※2

コネクションは必要なときだけ接続します。

ldaps

636/tcp※2

コネクションは必要なときだけ接続します。

注※1　無通信状態で30分以上経過した場合，コネクションを切断します。

注※2　JP1/Base（認証サーバ）とディレクトリサーバ間の通信でSSLを利用するかどうかで使用するポート番号は変わります。SSLを利用する場合は，636/tcpを使用します。

付録D　制限値一覧

JP1/Baseの各種の制限値を次に示します。

表D‒1　制限値一覧

項目

制限値

イベントサービスの環境設定（イベントサーバ設定ファイル，転送設定ファイルおよび配布定義ファイル）の1行の最大長

1,023バイト

転送設定ファイルの一つのフィルターの全体の最大長

64キロバイト

イベントサーバ名の最大長

暗号化機能を使用しない場合（SSL通信定義ファイルのBASESSLにjp1bsagentを設定しない場合）

Windowsの場合：240バイト

Linuxの場合：255バイト

AIXの場合：255バイト

暗号化機能を使用する場合（SSL通信定義ファイルのBASESSLにjp1bsagentを設定する場合）

Windowsの場合：240バイト

Linuxの場合：63バイト

AIXの場合：61バイト

JP1ユーザー名

1〜31バイト

JP1ユーザー用パスワード

6〜32バイト

OSユーザー名

1〜64バイト（ドメイン名を含む。ただし，OSによって最大長が異なる）

OSユーザーパスワード

1〜64バイト

情報検索用ユーザー名

8〜64バイト（aduser/部分を含む）

サーバホスト名の最大長

255バイト

論理ホスト名の最大長

Windowsの場合：180バイト※

Linuxの場合：32バイト※

AIXの場合：32バイト※

jbs_killall.cluster（UNIX限定）コマンドを使用する場合：32バイト

ユーザー権限レベルファイルの1行の最大長

4,096バイト

ユーザーマッピング定義ファイルの1行の最大長

4,096バイト

認証サーバに同時にログインできるJP1ユーザー数

10,000ユーザー

登録できるJP1ユーザー数

3,000ユーザー

登録できるOSユーザー数

2,048ユーザー

ユーザー権限レベルファイルに登録できるJP1ユーザー数

3,000ユーザー

ヘルスチェック定義ファイルの1行の最大長

1,023バイト

転送設定ファイル・属性付加設定ファイルの最大ファイルサイズ

2ギガバイト

注※　JP1/Baseの制限値は上記のとおりですが，クラスタソフトで上記制限値に対応していない場合があります。JP1/Baseで論理ホスト名を指定する場合は，クラスタソフトの制限値を超えないよう注意してください。また，JP1/IM-ManagerやJP1/AJSなどの上位製品と同居する場合は，上位製品の上限値を超えないように注意してください。

付録E　メモリー所要量とディスク占有量の見積もり

付録E.1　メモリー所要量

JP1/Baseの実行処理に必要なリソースを割り当てるために，OSのカーネルパラメーターを調整します。カーネルパラメーターの調整が必要なシステムリソース一覧については，「付録G　カーネルパラメーター一覧」を参照してください。

付録E.2　ディスク占有量（Windowsの場合）

Windowsの場合のJP1/Baseのディスク占有量については，リリースノートを参照してください。

付録E.3　ディスク占有量（UNIXの場合）

UNIXの場合のJP1/Baseのディスク占有量については，リリースノートを参照してください。

付録E.4　クラスタ運用時の共有ディスクのディスク占有量

JP1/Baseのディスク占有量については，リリースノートを参照してください。

付録F　正規表現の文法

JP1製品で正規表現を使用する場合は次に示す正規表現を利用できます。正規表現を使って検索する場合，検索条件は次の表記法に従って指定してください。

付録F.1　初期設定で使用できる正規表現

Windowsの場合に，初期設定で使用できる正規表現について説明します。UNIXでは，OS提供の正規表現が適用されるため，次に示す文法とは異なります。UNIX上で使用できる正規表現については，各正規表現の文法（regexpまたはregex）を参照してください。

(1)　通常文字

通常文字とは，正規表現としてその文字自体を検索対象に指定した場合に一致する文字です。通常文字として扱わないのは「改行文字」と「特殊文字」だけです。通常文字では，大小文字を区別します。

(2)　特殊文字

特殊文字とは，サーカムフレックス（^），ドル記号（$），ピリオド（.），アスタリスク（*），および円記号（¥）です。

それぞれの特殊文字について次に説明します。

^

^は，先頭指定（前方一致）を意味します。正規表現の最初の文字として使用する場合だけ特殊文字になります。先頭以外で使用する場合は通常文字として扱われます。

^を特殊文字として指定すると，行頭にある指定の文字列に一致します。

$

$は，末尾指定（後方一致）を意味します。正規表現の最後の文字として使用する場合だけ特殊文字になります。末尾以外で使用する場合，通常文字として扱われます。

$を特殊文字として指定すると，行末にある指定の文字列に一致します。なお，^と併用すると，指定した文字列だけの行に一致します。

.（ピリオド）

.（ピリオド）は，「改行文字」以外の任意の1文字であることを意味します。

.（ピリオド）を特殊文字として指定すると，「改行文字」以外の任意の1文字に一致します。

*

*は，直前の正規表現の0回以上の繰り返しを意味します。

¥

¥は，特殊文字（*，.，^，$，¥）の打ち消しを意味します。

¥を特殊文字の前に指定すると，その特殊文字は，通常文字として扱われます。また，¥を英小文字の前に指定すると，エラーになります。なお，英小文字の前に指定しても，エラーにならない場合を次に示します。

¥n

¥nは，改行コードを意味します。

¥t

¥tは，タブを意味します。

付録F.2　正規表現を拡張した場合に使用できる拡張正規表現

JP1製品では，正規表現を拡張すると，WindowsとUNIXで共通の正規表現を使用できるようになります。正規表現を拡張したい場合は，「3.4.5　使用する正規表現を拡張する」を参照して設定してください。なお，UNIXの場合は，各OSによって適用される拡張正規表現が異なります。AIXの場合はXPG4に準拠した拡張正規表現，Linuxの場合はPOSIX1003.2に準拠した拡張正規表現が適用されます。Windowsの場合は，XPG4の拡張正規表現の文法に準じます。ここでは，拡張正規表現のうち，使用頻度が高そうな正規表現について説明します。

拡張した場合に使用できる正規表現を次に示します。

文字列

指定の文字列の行に一致します。

^文字列

行頭にある指定の文字列に一致します。

文字列$

行末にある指定の文字列に一致します。なお，^と併用すると，指定した文字列だけの行に一致します。

^文字列$

指定の文字列だけの行に一致します。

^$

空行に一致します。

.(ピリオド)

「改行文字」以外の任意の1文字に一致します。

[文字列]

[　]内の文字列に指定された文字のどれかに一致します。

[文字-文字]

文字コードの昇順で範囲内のどれか1文字に一致します。

[^文字-文字]

文字コードの昇順で範囲外のどれか1文字に一致します。

文字*

直前の文字が0回以上繰り返されている文字列に一致します。

正規表現｜正規表現

左右の正規表現のどちらかに一致します。

¥特殊文字

特殊文字を通常文字として扱います。

（正規表現）

正規表現をグループ化します。

付録F.3　使用できる正規表現の比較

初期設定で使用できる正規表現と，正規表現を拡張した場合に使用できる正規表現のうち主なものについて，次の表に示します。

指定方法

機能

Windowsの場合

（JP1独自の正規表現）

UNIXの場合

（基本正規表現）※1

Windowsの場合

（拡張正規表現）※3

UNIXの場合

（拡張正規表現）※2

文字列

指定の文字列の行に一致する

○

○

○

○

^文字列

行頭にある指定の文字列に一致する

○

○

○

○

文字列$

行末にある指定の文字列に一致する

○

○

○

○

^文字列$

指定の文字列だけの行に一致する

○

○

○

○

^$

空行に一致する

○

○

○

○

.（ピリオド）

任意の1文字に一致する

○

○

○

○

.*

.（ピリオド）と*の併用です。任意の文字列に一致します。

○

○

○

○

[文字列]

[　]内の文字列に指定された文字のどれかに一致する

×

○

○

○

[^文字列]

[　]内の文字列に指定された文字以外の文字に一致する

×

○

○

○

[文字-文字]

文字コードの昇順で範囲内の文字に一致する

×

○

○

○

[^文字-文字]

文字コードの昇順で範囲外の文字に一致する

×

○

○

○

文字*

直前の文字が0回以上繰り返されている文字列に一致する

○

○

○

○

文字+

直前の文字が1回以上繰り返されている文字列に一致する

×

×

○

○

文字?

直前の文字が0回または1回繰り返されている文字列に一致する

×

×

○

○

文字{n}

直前の文字がn回繰り返されている文字列に一致する

×

×

○

○

文字{n,}

直前の文字がn回以上繰り返されている文字列に一致する

×

×

○

○

文字{n,m}

直前の文字がn回以上，m回以内の文字列に一致する

×

×

○

○

正規表現｜正規表現

左右の正規表現のどちらかに一致する

×

×

○

○

¥特殊文字

特殊文字を通常文字として扱う

○

○

○

○

(正規表現)

正規表現をグループ化する

×

×

○

○

（凡例）

○：使用できる

×：使用できない

注※1　初期設定で基本正規表現を使用しているのはJP1/Baseだけです。ほかのJP1製品では異なる正規表現を使用しているため，初期設定で使用できる正規表現については各製品のマニュアルを参照してください。

注※2　正規表現を拡張した場合，各OSによって適用される拡張正規表現が異なります。AIXの場合はXPG4に準拠した拡張正規表現，Linuxの場合はPOSIX1003.2に準拠した拡張正規表現が適用されます。使用できる正規表現の詳細については，各正規表現の文法（regexpまたはregex）を参照してください。

注※3　正規表現を拡張した場合，XPG4の拡張正規表現の文法に準拠します。なお，正規表現規格で未定義とされている項目については，UNIXの場合と動作が異なることがあります。

付録F.4　正規表現を指定する際のヒント

正規表現を指定する際に参考にしてください。

正規表現ですべての文字に一致する「.*」を多数使用すると，検索に時間が掛かることがあります。長いメッセージなどに対して「.*」を使用する場合は，必要な個所にだけ「.*」を使用してください。

UNIXでは，空白以外の文字に一致させたい場合など，「.*」の代わりに，空白以外の文字の繰り返しとなる「[^ ]*」を使用すると，検索時間を短縮できます。

付録F.5　正規表現の指定例

指定方法

機能

正規表現として指定した文字列

文字列の例

一致

文字列

指定の文字列の行に一致する

spring

spring has come.

○

winter-summer-autumn-spring

○

-----spring-----

○

^文字列

行頭にある指定の文字列に一致する

^spring

spring has come.

○

winter-summer-autumn-spring

×

-----spring-----

×

文字列$

行末にある指定の文字列に一致する

spring$

spring has come.

×

winter-summer-autumn-spring

○

-----spring-----

×

^文字列$

指定の文字列だけの行に一致する

^spring$

spring has come.

×

winter-summer-autumn-spring

×

spring

○

　　spring

×

^$

空行に一致する

^$

○

spring

×

.(ピリオド)

任意の1文字に一致する

in.e

winter has come.

○

mother of invention

○

life is in everything

○

eight nine ten

×

increasing population

×

s..ing

picnic in spring

○

skiing in winter

○

[文字列]

[　]内の文字列に指定された文字のどれかに一致する

[pr]

spring has come.

○

today is monday.

×

[文字-文字]

文字コードの昇順で範囲内の文字のどれか1文字に一致する

[a-i]

spring has come.

○

[^文字-文字]

文字コードの昇順で範囲外の文字のどれか1文字一致する

[^a-i]

spring has come.

○

文字*

直前の文字が0回以上繰り返されている文字列に一致する

ro*m

terminal

○

cd-rom

○

living room

○

h.*n

This is a pen.

○

That is an apple.

○

正規表現｜正規表現

左右の正規表現のどちらかに一致する

[0-9]+|apple

That is an apple.

○

spring in 2003

○

¥特殊文字

特殊文字を通常文字として扱う

o¥.h

<stdio.h>

○

another man

×

(正規表現)

正規表現をグループ化する

i(n.e|ng)

winter has come.

○

interesting book

○

（凡例）

太字：指定した正規表現と一致する文字列

空欄：空行

○：一致する文字列がある

×：一致する文字列がない

付録G　カーネルパラメーター一覧

UNIX環境でJP1/Baseを使用する場合，JP1/Baseの実行に必要なリソースを割り当てるために，OSのカーネルパラメーターを調整します。

調整が必要なカーネルパラメーターを次に示します。

「加算するパラメーター」については，システム内で使用するすべてのプログラム分の見積もり値（合計）に加算してください。

「調整するパラメーター」については，システム内で使用するすべてのプログラムの見積もり値を確認した上で，JP1/Baseを含むすべてのプログラムで問題が起こらない値に調整してください。

付録G.1　カーネルパラメーター一覧（AIXの場合）

AIXではカーネルパラメーターの調整は不要です。

付録G.2　カーネルパラメーター一覧（Linuxの場合）

(1)　デフォルトの設定で必要とするシステムリソース

デフォルトの設定でJP1/Base分として調整する必要があるシステムリソースの見積もり値を次に示します。

(a)　加算するパラメーター

システムリソース

パラメーター

見積もり

ファイルシステム

fs.file-max

イベントサービス分※1

180＋転送先ホスト数×6＋イベントを転送してくるホスト数×6＋同時に発行されるイベント数※2×6＋イベントを取得するプログラム数※3×6＋同時に実行されるイベントサービスのコマンドの数×10

ログファイルトラップ分

ログファイルトラップ起動数×9＋ログファイルトラップで監視するファイルの総延べ数×9＋同時に実行されるログファイルトラップのコマンドの数×10＋IM構成管理のリモート監視プロファイル数×10

イベントサービスとログファイルトラップ以外の分

60＋JP1/Baseのコマンド実行数×10

注※1

論理ホストを使用する場合は次の値で見積もってください。

180＋転送先ホスト数×6＋イベントを転送してくるホスト数×6＋同時に発行されるイベント数×6＋イベントを取得するプログラム数×6

注※2

イベントは，jevsendコマンド，jevsenddコマンド，JP1/AJSのイベント送信ジョブ，JP1シリーズのほかのプログラム，およびJP1/Baseの拡張機能で作成されたユーザープログラムで発行されます。同時に発行されるイベント数は，これらのプログラムが同時に実行される際の最大数となります。マシンの性能にもよりますが，同時とは1秒程度を仮定してください。

注※3

イベントは，JP1/AJSのイベント受信ジョブ，JP1/Baseの拡張機能で作成されたユーザープログラムで取得されます。イベントを取得するプログラム数は，起動しているこれらのプログラム数となります。

注意事項

OSバージョンおよびカーネルバージョンで異なります。使用するOSのマニュアルを参照して，見積もり値で提示された内容で見積もってください。なお，使用するOSで該当するカーネルパラメーターが設定できない場合には，設定は不要です。

(b)　調整するパラメーター

システムリソース

パラメーター

見積もり

ソケットバックログ

net.core.somaxconn※

1,024以上

注※　JP1/IM構成管理機能のエージェントとして使用する場合，net.core.somaxconnパラメーターには1,024以上の値を設定する必要があります。

(2)　コマンド実行機能を使用する場合

JP1/IM - Managerからリモートコマンドおよび自動アクションを使用する場合に，JP1/Base分として調整する必要があるシステムリソースの見積もり値を次に示します。

(a)　加算するパラメーター

システムリソース

パラメーター

見積もり

ファイルシステム

fs.file-max

JP1/IM - Managerによってリモートコマンドが同時に実行される実行数×16

共有メモリー

kernel.shmall

kernel.shmmniの見積もり値×kernel.shmmaxの見積もり値

kernel.shmmni

1＋同時に実行されるリモートコマンドの数※

セマフォ

kernel.semの第4パラメーター（SEMMNI）

3

kernel.semの第2パラメーター（SEMMNS）

3

注※　この値が256を超える場合，256で計算してください。この値はコマンド実行先ホストとして指定されたホストで見積もられます。

(b)　調整するパラメーター

システムリソース

パラメーター

見積もり

共有メモリー

kernel.shmmax

143,468以上

(3)　ヘルスチェック機能を使用する場合

JP1/Baseのヘルスチェック機能を使用する場合に，JP1/Base分として調整する必要があるシステムリソースの見積もり値を次に示します。

(a)　加算するパラメーター

システムリソース

パラメーター

見積もり

共有メモリー

kernel.shmall

kernel.shmmniの見積もり値×kernel.shmmaxの見積もり値

kernel.shmmni

10＋10×論理ホスト数

(b)　調整するパラメーター

システムリソース

パラメーター

見積もり

共有メモリー

kernel.shmmax

215,644以上

(4)　ローカルアクション機能を使用する場合

ローカルアクションを使用する場合に，JP1/Base分として調整する必要があるシステムリソースの見積もり値を次に示します。

(a)　加算するパラメーター

システムリソース

パラメーター

見積もり

ファイルシステム

fs.file-max

ローカルアクションの同時実行数

付録H　通信設定の変更対応

JP1/Baseは，さまざまなネットワーク構成に応じて通信設定を変更できます。ネットワークの構成や運用方法によっては，通信方式を設定する必要があります。JP1/Baseの通信設定の変更に関するファイルおよびパラメーターを次に示します。

付録H.1　jp1hosts2定義ファイルの設定変更

JP1独自のhosts情報を設定しておくファイルです。OSの名前解決ができない場合，複数LAN接続の環境で特定のLANを使用する場合，クラスタシステムで自ホストが複数の受信用IPアドレスを使用する場合などに設定します。また，IPv6アドレスを使用して通信する場合に設定します。

hosts情報を設定していないホスト名に対しては，OSの名前解決を利用します。ネットワーク構成によっては，通信方式設定ファイルの設定が必要な場合があります。jp1hosts2定義ファイルの詳細については，「16.　定義ファイル」の「jp1hosts2定義ファイル」を参照してください。

設定変更が必要となる場合の例

OSの名前解決で，接続先ホストが名前解決できない場合，または優先IPアドレスとして取得できない場合

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して受信する場合

複数LAN接続の環境で，特定のLANだけを使用して受信する場合

Windows環境で，同一ホスト上で物理ホストと論理ホストのサービスを起動する場合

複数LAN接続の環境で，特定のLANを使用して送信する場合

IPv6アドレスを使用して通信する場合

付録H.2　jp1hosts定義ファイルの設定変更

JP1独自のhosts情報を設定しておくファイルです。OSの名前解決ができない場合，複数LAN接続の環境で特定のLANを使用する場合，クラスタシステムで自ホストが複数の受信用IPアドレスを使用する場合などに設定します。

hosts情報を設定していないホスト名に対しては，OSの名前解決を利用します。ネットワーク構成によっては，通信方式設定ファイルの設定が必要な場合があります。jp1hosts定義ファイルの詳細については，「16.　定義ファイル」の「jp1hosts定義ファイル」を参照してください。

設定変更が必要となる場合の例

OSの名前解決で，接続先ホストが名前解決できない場合，または優先IPアドレスとして取得できない場合

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して受信する場合

複数LAN接続の環境で，特定のLANだけを使用して受信する場合

Windows環境で，同一ホスト上で物理ホストと論理ホストのサービスを起動する場合

複数LAN接続の環境で，特定のLANを使用して送信する場合

付録H.3　通信方式設定ファイルの設定変更

クラスタシステムで送信設定をANYバインド方式に変更する場合や，複数LAN接続の環境で特定のLANを使用する場合に設定します。なお，名前解決するためには，jp1hosts定義ファイルまたはjp1hosts2定義ファイルの設定が必要な場合があります。通信方式設定ファイルの詳細については，「6.3.2(2)　通信方式設定ファイル」を参照してください。

設定変更が必要となる場合の例

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して通信する場合

複数LAN接続の環境で，特定のLANだけを使用して通信する場合

クラスタシステムから論理ホストを削除し，物理ホストだけの環境にする場合

付録H.4　イベントサーバ設定ファイル（conf）のportsパラメーターの設定変更

JP1イベントを受信する際に，イベントサーバが使用するIPアドレスを設定します。イベントサーバ設定ファイルのclient-bindパラメーターを省略した場合は，送信元イベントサーバのIPアドレスに設定されます。イベントサーバ設定ファイルの詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

設定変更が必要となる場合の例（jp1hosts2情報を使用するときは，変更不要）

クラスタシステムかつ複数LAN接続の環境で，複数のLANを使用して受信する場合

複数LAN接続の環境で，特定のLANだけを使用して通信する場合

付録H.5　イベントサーバ設定ファイル（conf）のclient-bindパラメーターの設定変更

JP1イベントを転送する際に，イベントサーバが使用するIPアドレスを設定します。client-bindパラメーターを省略した場合，イベントの送信元IPアドレスは，portsパラメーターに指定されたアドレスが使用されます。設定していないイベントサーバ名に関しては，OSの名前解決を利用します。イベントサーバ設定ファイルの詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

設定変更が必要となる場合の例（jp1hosts2情報を使用するときは，変更不要）

クラスタシステムかつ複数LAN接続の環境で，複数のLANに対してイベントを送信する場合（0.0.0.0を指定）

複数LAN接続の環境で，特定のLANだけを使用して送信する場合

付録H.6　イベントサーバ設定ファイル（conf）のremote-serverパラメーターの設定変更

JP1イベントを転送する際に，転送先のイベントサーバ名の名前解決をする場合に設定します。イベント転送先イベントサーバのportsパラメーターで指定しているアドレスを指定します。イベントサーバ名を設定していない場合は，OSの名前解決を利用します。イベントサーバ設定ファイルの詳細については，「16.　定義ファイル」の「イベントサーバ設定ファイル」を参照してください。

設定変更が必要となる場合の例（jp1hosts2情報を使用するときは，変更不要）

OSの名前解決で，イベント転送先イベントサーバ名が名前解決できない場合

優先IPアドレスとして取得できない場合

付録H.7　API設定ファイル（api）のserverパラメーターの設定変更

アプリケーションプログラムからイベントサーバにイベントを登録する際の，自ホスト内での名前解決や，他ホストのイベントを検索する際に名前解決する場合に設定します。このパラメーターを設定していないホストに関しては，OSの名前解決を利用します。API設定ファイルの詳細については，「16.　定義ファイル」の「API設定ファイル」を参照してください。

設定変更が必要となる場合の例（jp1hosts2情報を使用するときは，変更不要）

イベントサーバ設定ファイルのportsパラメーターに，OSの名前解決で優先的に付与される任意のIPアドレス以外のIPアドレスを指定している場合

OSの名前解決で，JP1/IM - Viewのイベント検索で指定したイベントサーバ名が名前解決できない場合

優先IPアドレスとして取得できない場合

付録H.8　API設定ファイル（api）のclientパラメーターの設定変更

アプリケーションプログラムから，イベントサーバへ接続するときに使用するIPアドレスを設定します。このパラメーターを省略した場合は，OSが自動的にIPアドレスを割り当てます。イベントサーバ設定ファイルの詳細については，「16.　定義ファイル」の「API設定ファイル」を参照してください。

設定変更が必要となる場合の例

複数LAN接続の環境で，特定のLANだけを使用して送信する場合

通信設定の詳細については，「6.　ネットワーク構成に応じたJP1/Baseの通信設定」を参照してください。

付録H.9　各機能の通信設定への対応状況

JP1/Baseが提供する各機能の通信設定への対応状況を次の表に示します。設定を変更した場合は，JP1/Base，JP1/Baseを前提とする製品，およびJP1/Baseと依存関係のあるプログラムの再起動が必要です。

JP1/IM，JP1/AJSなどのJP1/Baseを前提とする製品も通信設定に対応しています。JP1/Baseを前提とする製品の通信設定への対応については，各製品のマニュアルを参照してください。

表H‒1　各機能の通信設定への対応状況

機能

通信設定

jp1hosts定義ファイル，jp1hosts2定義ファイル

通信方式設定ファイル

confファイル

API設定ファイル

ユーザー管理

ユーザー認証

○※

○

−

○

ユーザーマッピング

−

−

−

−

サービスの起動管理

起動順序制御

−

−

−

−

終了順序制御

−

−

−

−

イベントサービス

○

○

○

○

イベント変換

ログファイルトラップ

○※

−

−

○

イベントログトラップ

○※

−

−

○

イベントサービスの定義情報の収集と配布

○

○

−

−

プロセス管理

○※

−

−

○

ヘルスチェック

○※

○

−

○

ローカルアクション

○※

−

−

○

ISAMユーティリティコマンド

−

−

−

−

統合トレース（HNTRLib2）

−

−

−

−

JP1/Baseの機能を拡張してユーザーが作成したプログラム

○※

−

−

○

（凡例）

○：使用する

−：使用しない

注※　JP1イベントの登録時および取得時は，jp1hosts2情報だけ参照します。

付録H.10　通信方式設定ファイルに定義されたパラメーター

通信方式設定ファイルに定義されたパラメーターの意味を次の表に示します。

表H‒2　通信設定パラメーター

パラメーター

説明

値

意味

JP1_COM_VERSION

JP1/Base 06-51以前の通信設定を使用するか，JP1/Base 06-71以降の通信設定を使用するかを決定します。

0

JP1/Base 06-51以前の通信設定

1

JP1/Base 06-71以降の通信設定

JP1_BIND_ADDR

サーババインド方式（受信側）を決定します。

ANY

すべてのIPアドレスでバインド

IP

指定したIPアドレスでバインド

JP1_CLIENT_BIND_ADDR

クライアントバインド方式（送信側）を決定します。

ANY

バインドするIPアドレスをOSに任せる

IP

指定したIPアドレスでバインド

COM_LISTEN_ALL_ADDR

複数のIPアドレスでサービスが待ち受けるかを決定します。

0

最優先のIPアドレスでバインド

1

複数のIPアドレスでバインド

COM_MAX_LISTEN_NUM

COM_LISTEN_ALL_ADDR=1の場合に，サービスが待ち受けるIPアドレスの個数を決定します。

4

4個のIPアドレスでバインド

付録H.11　JP1/Base 06-51以前の通信方式とJP1/Base 06-71以降の通信方式の違い

JP1/Base 06-51以前の通信方式とJP1/Base 06-71以降の通信方式は，共通定義情報のJP1_COM_VERSIONの設定値でどちらの通信方式を使用しているか確認できます。JP1_COM_VERSIONが0の場合は，JP1/Base 06-51以前の通信方式を使用しています。JP1_COM_VERSIONが1の場合は，JP1/Base 06-71以降の通信方式を使用しています。

JP1/Baseの通信方式の設定の確認方法については，「6.3.4　JP1/Baseの通信方式の設定を確認する」を参照してください。

JP1_COM_VERSIONの設定値によって，JP1/Baseの各機能の通信時の動作に違いがあります。通信時の動作の違いとは，各通信時の設定項目の設定値に従って動作するかどうかの違いです。

JP1/Base 06-51以前の通信方式の場合の各機能の通信時の動作を次の表に示します。

表H‒3　JP1/Base 06-51以前の通信方式（JP1_COM_VERSIONが0）の場合の通信時の動作

機能

通信時の設定項目

JP1_BIND_ADDR

JP1_CLIENT_BIND_ADDR

COM_LISTEN_ALL_ADDR

COM_MAX_LISTEN_NUM

jp1hosts情報

jp1hosts2情報

構成管理

○

−※1

−※2

−※3

○

○

コマンド実行

○

−※1

−※2

−※3

○

○

ユーザー管理

○

−※1

−

−

○

○

定義情報収集・配布

○

−※1

−

−

○

○

ヘルスチェック

○

−※1

−

−

○

○

サービス管理制御

○

−※1

−

−

○

○

プロセス間通信

○

−※1

−

−

○

○

イベントサービス※4

○

○

○

○

○

○

イベントAPI（クライアント）※5

−

−※6

−

−

−

○

（凡例）

○：設定値を参照する

−：設定値を参照しない

注※1　JP1_BIND_ADDRの設定値で動作します。

注※2　設定値に1（複数のIPアドレスでバインド）を仮定します。

注※3　設定値に16（16個のIPアドレスでバインド）を仮定します。

注※4　イベントサーバ設定ファイル（conf）のportsおよびremote-serverパラメーターのアドレス部分に，<jp1hosts2>が設定されている場合，表に示す設定項目の設定値を参照します。

注※5　JP1/BaseおよびJP1/IMなどのほかの製品で，JP1イベントを登録・取得する際に使用される機能です。API設定ファイル（api）のserverパラメーターのアドレス部分に，<jp1hosts2>が設定されている場合，表に示す設定項目の設定値を参照します。

注※6　送信元のIPアドレスは，API設定ファイル（api）のclientパラメーターだけで設定できます。

JP1/Base 06-71以降の通信方式の場合の各機能の通信時の動作を次の表に示します。

表H‒4　JP1/Base 06-71以降の通信方式（JP1_COM_VERSIONが1）の場合の通信時の動作

機能

通信時の設定項目

JP1_BIND_ADDR

JP1_CLIENT_BIND_ADDR

COM_LISTEN_ALL_ADDR

COM_MAX_LISTEN_NUM

jp1hosts情報

jp1hosts2情報

構成管理

○

○

○

○

○

○

コマンド実行

○

○

○

○

○

○

ユーザー管理

○

○

○

○

○

○

定義情報収集・配布

○

○

○

○

○

○

ヘルスチェック

○

○

○

○

○

○

サービス管理制御

○

○

○

○

○

○

プロセス間通信

○

○

○

○

○

○

イベントサービス※1

○

○

○

○

○

○

イベントAPI（クライアント）※2

−

−※3

−

−

−

○

（凡例）

○：設定値を参照する

−：設定値を参照しない

注※1　イベントサーバ設定ファイル（conf）のportsおよびremote-serverパラメーターのアドレス部分に，<jp1hosts2>が設定されている場合，表に示す設定項目の設定値を参照します。

注※2　JP1/BaseおよびJP1/IMなどのほかの製品で，JP1イベントを登録・取得する際に使用される機能です。API設定ファイル（api）のserverパラメーターのアドレス部分に，<jp1hosts2>が設定されている場合，表に示す設定項目の設定値を参照します。

注※3　送信元のIPアドレスは，API設定ファイル（api）のclientパラメーターだけで設定できます。

付録H.12　クラスタセットアップ時の通信方式

JP1/Baseでクラスタシステム用の設定をした場合，自動的に次の表に示す通信方式が設定されます。

表H‒5　クラスタセットアップ時の通信方式

パラメーター

設定される値

JP1_COM_VERSION

0

JP1_BIND_ADDR

IP

JP1_CLIENT_BIND_ADDR

ANY

COM_LISTEN_ALL_ADDR

0

COM_MAX_LISTEN_NUM

4

付録I　操作ログの出力

JP1/Baseの操作ログとは，認証サーバに対する不正な操作などセキュリティ上の問題発生時の原因究明や，システムを安全に運用するための情報収集を目的として，認証サーバに対して「いつ」「だれが」「何を行ったか」などの操作情報の履歴を出力するログ情報です。

JP1/Baseの操作ログには，対象資源であるJP1ユーザーアカウント情報または操作権限情報が登録・変更・削除された場合に，変更情報が出力されます。例えば，JP1ユーザーのパスワードを変更した場合，いつ，どのOSユーザーによって，どのJP1ユーザーのパスワードを変更したかの情報が操作ログに出力されます。また，認証サーバの起動または停止の情報も出力されます。

操作ログは，初期設定では出力されません。

操作ログは，CSV形式で出力されるテキストファイルです。定期的に保存して表計算ソフトで加工すると，分析資料として利用できます。

なお，出力された操作ログはJP1/Auditを使用して収集すると，一元管理できます。

ここでは，操作ログの出力内容と操作ログを出力するための設定方法について説明します。

付録I.1　操作ログに出力される事象の種別

操作ログに出力される事象の種別およびJP1/Baseが操作ログを出力する契機を次の表に示します。事象の種別とは，操作ログに出力される事象を分類するための，操作ログ内での識別子です。

表I‒1　操作ログに出力される事象の種別

事象の種別

説明

JP1/Baseが出力する契機

StartStop

ソフトウェアの起動および終了を示す事象。

認証サーバの起動時または停止時

ConfigurationAccess

管理者が許可された運用操作を実行し，操作が成功または失敗したことを示す事象。

JP1ユーザーの登録・削除時

JP1ユーザーのパスワード変更

JP1ユーザーの操作権限の登録・変更・削除時

JP1資源グループの登録・削除時

JP1資源グループの操作権限の登録・削除・変更時

jbs_spmd_reloadコマンドの実行時

jbsaclreloadコマンドの実行時

付録I.2　操作ログの保存形式

操作ログは，操作ログファイル（base_log.log）に出力されます。操作ログファイル（base_log.log）は，シーケンシャルファイルです。一定の容量に達すると，ファイル名を変更して保存したあと，変更前と同じ名称のファイルを作成して新たにログを書き込みます。一定の容量に達して操作ログファイル（base_log.log）が切り替わる際，「base_log.log」を，「base_log1.log」に変更して保存し，新たに「base_log.log」を作成して，ログを書き込みます。再び「base_log.log」が一定量に達すると，保存済みの「base_log1.log」を「base_log2.log」に変更したあと，「base_log.log」を「base_log1.log」に変更して保存します。

このように，保存済みのログファイルは，新たにファイルが作成されるごとにファイル名末尾の数値+1をしたファイル名称に変更されます。つまり，数値が大きいログファイルほど古いログファイルとなります。なお，一定の保存面数を超えると，古いログファイルから削除されます。

ファイルの切り替え時期，出力先および保存面数は操作ログ定義ファイル（jp1bs_baselog_setup.conf）で変更できます。ログファイルサイズの初期値は1,024キロバイトです。保存面数の初期値は4面です。操作ログ定義ファイルの設定方法については，「付録I.5　操作ログを出力するための設定」を参照してください。

付録I.3　操作ログの出力形式

操作ログは，操作対象のJP1ユーザーおよびJP1資源グループ単位にレコードが出力されます。例えば，JP1ユーザーに登録されている二つのJP1資源グループ（jp1group1，jp1group2）のJP1権限レベルを変更した場合，「JP1資源グループ(jp1group1)の変更」と「JP1資源グループ(jp1group2)の変更」という二つのレコードが出力されます。

また，ユーザー権限レベルファイル（JP1_UserLevel）でJP1資源グループやJP1権限レベルの内容を変更し，jbsaclreloadコマンドまたはjbs_spmd_reloadコマンドを実行した場合，認証サーバ上の操作権限情報とユーザー権限レベルファイル（JP1_UserLevel）の内容を比較し，変更した定義に関する情報だけが操作ログに出力されます。

操作ログ出力の出力形式，出力先，出力項目について説明します。

(1)　出力形式

CALFHM x.x,出力項目1=値1,出力項目2=値2,…,出力項目n=値n

(2)　出力先

Windowsの場合

インストール先フォルダ¥log¥BASE¥base_log[n※].log

UNIXの場合

/var/opt/jp1base/log/BASE/base_log[n※].log

注※

nは1〜16の10進数です。

(3)　出力項目

出力項目は二つの分類があります。

共通出力項目

操作ログを出力するJP1製品が共通して出力する項目です。

固有出力項目

操作ログを出力するJP1製品が任意に出力する項目です。

(a)　共通出力項目

表I‒2　操作ログの共通出力項目

項番

出力項目

値

内容

項目名

出力される属性名

1

共通仕様識別子

−

CALFHM

ログフォーマット識別子

2

共通仕様リビジョン番号

−

x.x

ログフォーマットを管理するためのリビジョン番号

3

通番

seqnum

通し番号

操作ログレコードの通し番号（プロセスごとに採番される）

4

メッセージID

msgid

KAJP6xxx-x

製品のメッセージID

5

日付・時刻

date

yyyy-mm-ddThh:mm:ss.sssTZD※1

操作ログの出力日時およびタイムゾーン

6

発生プログラム名

progid

JP1Base

事象が発生したプログラムのプログラム名

7

発生コンポーネント名

compid

User_management

事象が発生したコンポーネント名

8

発生プロセスID

pid

認証サーバのプロセスID

事象が発生したプロセスのプロセスID

9

発生場所（ホスト名）

ocp:host

認証サーバのホスト名※4

事象が発生したホストのホスト名

10

事象の種別

ctgry

StartStop

ConfigurationAccess

操作ログに出力される事象を分類するためのカテゴリー名

11

事象の結果

result

Success（成功）

Failure（失敗）

事象の結果

12

サブジェクト識別情報

subj:euid

OSユーザー名※4

Unknown※2

Not Support※3

事象を発生させたOSユーザー名

（凡例）

−：出力される属性名はありません。

注※1　Tは日付と時刻の区切りです。ZDはタイムゾーン指定子です。次のどれかが出力されます。

+hh:mm：UTCからhh:mmだけ進んでいることを示す。

-hh:mm：UTCからhh:mmだけ遅れていることを示す。

Z：UTCと同じであることを示す。

注※2　Unknownは，jbs_spmd_reloadコマンド実行時に出力されるメッセージ（KAJP6016-I〜KAJP6020-I）の場合に出力されます。このコマンドを実行したOSユーザー名は，直後に出力されるKAJP6022-I〜KAJP6023-Wのサブジェクト種別情報に出力されます。

注※3　Not Supportは，08-00以前のJP1/Baseで，ユーザー認証機能のコマンドを実行した場合に出力されます。どのOSユーザーによって実行されたか知りたい場合には，JP1/Baseのバージョンを08-10以上にしてください。

注※4　値を取得できなかった場合は，Noneが出力されます。

(b)　固有出力項目

表I‒3　操作ログの固有出力項目

項番

出力項目

値

内容

項目名

出力される属性名

1

オブジェクト情報

obj

JP1user

Permission

Process

Password

操作の対象

2

操作情報

op

Add

Apply

Update

Delete

Start

Stop

操作内容

3

オブジェクトロケーション情報：認証サーバ名

objloc:authsv

認証サーバ名※1

操作対象の資源がある認証サーバ名を出力する

4

オブジェクトロケーション情報：JP1ユーザー名

objloc:user

JP1ユーザー名※1

操作対象の資源のJP1ユーザー名を出力する

5

変更前情報：JP1資源グループ名

before:rsrcgrp

JP1資源グループ名※1

変更前の情報として，削除された情報を出力する

6

変更後情報：JP1資源グループ名

after:rsrcgrp

JP1資源グループ名※1

変更後の情報を出力する

7

変更後情報：JP1権限レベル名

after:prmssn

JP1権限レベル名※1

変更後の情報を出力する

8

権限情報

auth

Windows

Administrator

UNIX

SuperUser

操作したOSユーザーが持つ権限

9

リクエスト送信元ホスト

from:ipv4またはfrom:ipv6

コマンド実行ホストのIPアドレス※1※2

コマンド実行ホストのIPアドレス

10

自由記述

msg

メッセージ※2の詳細については「付録I.6　操作ログに出力されるメッセージの一覧」を参照。

事象の内容を示すメッセージ

注※1　この値は，操作ログによって出力の有無が異なります。表I-4を参照してください。

注※2　値を取得できなかった場合は，Noneが出力されます。

操作ログに出力される固有出力項目のうち，出力の有無が異なる項目について，メッセージIDごとに次の表に示します。

表I‒4　メッセージIDと固有出力項目の出力有無

メッセージID

オブジェクトロケーション情報：認証サーバ名

オブジェクトロケーション情報：JP1ユーザー名

変更前情報：JP1資源グループ名

変更後情報：JP1資源グループ名

変更後情報：JP1権限レベル名

リクエスト送信元ホスト

KAJP6000-I

○

○

×

×

×

○

KAJP6001-W

○

○

×

×

×

○

KAJP6002-I

○

○

×

×

×

○

KAJP6003-W

○

○

×

×

×

○

KAJP6004-I

○

○

×

×

×

○

KAJP6005-W

○

○

×

×

×

○

KAJP6006-I

○

○

×

○

○

○

KAJP6007-W

○

×

×

×

×

○

KAJP6008-I

○

○

×

○

○

○

KAJP6010-I

○

○

○

×

×

○

KAJP6011-W

○

○

×

×

×

○

KAJP6012-I

○

×

×

×

×

×

KAJP6013-E

○

×

×

×

×

×

KAJP6014-I

○

×

×

×

×

×

KAJP6015-E

○

×

×

×

×

×

KAJP6016-I

○

○

×

○

○

○

KAJP6017-W

○

×

×

×

×

○

KAJP6018-I

○

○

×

○

○

○

KAJP6020-I

○

○

○

×

×

○

KAJP6022-I

×

×

×

×

×

×

KAJP6023-W

×

×

×

×

×

×

KAJP6024-I

○

×

×

×

×

×

KAJP6025-I

○

×

×

×

×

×

（凡例）

○：出力される。

×：出力されない。

(4)　出力例

jbsadduserコマンドでJP1ユーザー「jp1user1」を登録した場合，認証サーバ「server1」の操作ログに出力される内容

CALFHM 1.0,seqnum=59,msgid=KAJP6000-I,date=2006-09-10T11:05:23.480+09:00,
progid=JP1Base,compid=User_management,pid=4028,
ocp:host=hostA,ctgry=ConfigurationAccess,result=Success,
subj:euid=Administrator,obj=JP1user,op=Add,objloc:authsv=server1,
objloc:user=jp1user1,auth=Administrator,from:ipv4=206.aa.bb.ccc,
msg=JP1ユーザーの登録に成功しました

付録I.4　操作ログが出力される契機

各メッセージIDが出力するメッセージ本文を知りたい場合は，「付録I.6　操作ログに出力されるメッセージの一覧」を参照してください。

表I‒5　操作ログが出力される契機およびメッセージID

契機

メッセージID

操作

結果

失敗ログが出力される事象

JP1ユーザーの登録時

登録成功

−

KAJP6000-I

登録失敗

登録済みのJP1ユーザーを登録しようとした

KAJP6001-W

JP1ユーザーのパスワードの変更時※1

変更成功

−

KAJP6002-I

変更失敗

変更しようとしたJP1ユーザーが存在しない

旧パスワードが誤っている

KAJP6003-W

JP1ユーザーの削除時

削除成功

−

KAJP6004-I

削除失敗

削除しようとしたJP1ユーザーが存在しない

KAJP6005-W

JP1資源グループの登録時

登録成功

−

KAJP6006-I

JP1資源グループの変更時

変更成功

−

KAJP6008-I

JP1資源グループの削除時

削除成功

−

KAJP6010-I

削除失敗

削除しようとしたJP1ユーザーが存在しない

KAJP6011-W

認証サーバの起動時

起動成功

−

KAJP6012-I

KAJP6024-IまたはKAJP6025-I

起動失敗

認証サーバの起動に失敗した

KAJP6013-E

認証サーバの停止

停止成功

−

KAJP6014-I

停止失敗

認証サーバの停止に失敗した

KAJP6015-E

JP1/Baseのプロセスの再読み込み時（jbs_spmd_reloadコマンド実行時）※2

登録成功

−

KAJP6016-I

更新失敗

更新処理が途中で失敗した

KAJP6017-W

変更成功

−

KAJP6018-I

削除成功

−

KAJP6020-I

コマンド成功

−

KAJP6022-I

コマンド失敗

jbs_spmd_reloadコマンドが失敗した

KAJP6023-W

ユーザー権限レベルの再読み込み時（jbsaclreloadコマンド実行時）※3

登録成功

−

KAJP6006-I

変更成功

−

KAJP6008-I

削除成功

−

KAJP6010-I

更新失敗

更新処理が途中で失敗した

KAJP6007-W

（凡例）

−：出力される失敗ログはありません。

注※1　連携ユーザーのパスワードを変更しようとしたとき，操作ログは出力されません。連携ユーザーのパスワードは連携先のディレクトリサーバで管理するため，認証サーバ上で変更できません。jbschgpasswdコマンドを実行するとKAVA5209-Eメッセージが出力されます。

注※2　jbs_spmd_reloadコマンドは，JP1/Baseのプロセスを再読み込みするコマンドです。このコマンドを実行すると，ユーザー権限レベルファイル（JP1_UserLevel）に定義された操作権限の情報が読み込まれます。認証サーバ上の操作権限情報から変更のあったJP1ユーザー情報だけが，操作ログに出力されます。

注※3　jbsaclreloadコマンドは，ユーザー権限レベルファイル（JP1_UserLevel）に定義された操作権限の情報を読み込むコマンドです。認証サーバ上の操作権限情報から変更のあったJP1ユーザー情報だけが，操作ログに出力されます。

付録I.5　操作ログを出力するための設定

操作ログを出力するためには，操作ログ定義ファイル（jp1bs_baselog_setup.conf）で設定します。

(1)　設定手順

(a)　物理ホストの場合

1.　操作ログ定義ファイル（jp1bs_baselog_setup.conf）を編集する。

1-1　ENABLEパラメーターを設定する。

操作ログ定義ファイル（jp1bs_baselog_setup.conf）をエディターで開き，ENABLEパラメーターを次のように変更します。

変更前（初期設定）

"ENABLE"=dword:00000000

変更後

"ENABLE"=dword:00000001

1-2　操作ログの出力先を初期設定から変更する場合，LOGFILEDIRパラメーターを設定する。

LOGFILEDIRパラメーターを次のように変更します。

Windowsの場合

変更前（初期設定）

"LOGFILEDIR"="インストール先フォルダ¥log¥BASE"

変更後

"LOGFILEDIR"="任意の出力先"

UNIXの場合

変更前（初期設定）

"LOGFILEDIR"="/var/opt/jp1base/log/BASE"

変更後

"LOGFILEDIR"="任意の出力先"

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

設定内容が共通定義情報に反映されます。

3.　設定を有効にする。

JP1/Baseを再起動するか，jbs_spmd_reloadコマンドを実行すると設定が有効になります。

(b)　論理ホストの場合

1.　共有ディスク上の操作ログ定義ファイル（jp1bs_baselog_setup.conf）を編集する。

1-1　[JP1_DEFAULT¥JP1BASE¥BASE_LOG]パラメーターを設定する。

操作ログ定義ファイル（jp1bs_baselog_setup.conf）をエディターで開き，[JP1_DEFAULT¥JP1BASE¥BASE_LOG]パラメーターを次のように設定します。

変更前（初期設定）

[JP1_DEFAULT¥JP1BASE¥BASE_LOG]

変更後

[論理ホスト名¥JP1BASE¥BASE_LOG]

1-2　ENABLEパラメーターを設定する。

ENABLEパラメーターを次のように設定します。

変更前（初期設定）

"ENABLE"=dword:00000000

変更後

"ENABLE"=dword:00000001

1-3　操作ログの出力先を設定する。

LOGFILEDIRパラメーターを次のように設定します。論理ホスト側の操作ログは，共有ディスク上に出力するように指定することをお勧めします。

Windowsの場合

変更前（初期設定）

"LOGFILEDIR"="インストール先フォルダ¥log¥BASE"

変更後

"LOGFILEDIR"="共有フォルダ¥jp1base¥log¥BASE"

UNIXの場合

変更前（初期設定）

"LOGFILEDIR"="/var/opt/jp1base/log/BASE"

変更後

"LOGFILEDIR"="共有ディレクトリ/jp1base/log/BASE"

2.　実行系でjbssetcnfコマンドを実行する。

定義ファイルの設定内容が共通定義情報に反映されます。

3.　実行系の設定を待機系に反映する。

クラスタ運用の場合，共通定義情報を各サーバ上で一致させる必要があります。詳細については「5.6.1(1)　共通定義情報を追加，変更した場合」を参照してください。

4.　設定を有効にする。

クラスタソフトからJP1/Baseを再起動するか，jbs_spmd_reloadコマンドを実行すると設定が有効になります。

(2)　操作ログ定義ファイル（jp1bs_baselog_setup.conf）の詳細

(a)　格納先ディレクトリ

Windowsの場合

インストール先フォルダ¥conf¥

共有フォルダ¥jp1base¥conf¥

UNIXの場合

/etc/opt/jp1base/conf/

共有ディレクトリ/jp1base/conf/

(b)　形式

操作ログ定義ファイル（jp1bs_baselog_setup.conf）には，操作ログの出力の有無，操作ログファイル（base_log.log）の出力先，サイズ，保存面数および自動的にファイルを切り替えるための設定を次の形式で定義します。

"項目名"=値

(c)　記述内容

操作ログファイル（base_log.log）の出力先以外は，すべて16進数で指定します。（　）内の数値は，10進数です。

ENABLE

操作ログの出力を有効にするか無効にするかを指定します。下記以外の値を指定した場合，初期値を仮定します。

初期値：00000000

操作ログの出力を無効にする場合：00000000

操作ログの出力を有効にする場合：00000001

LOGFILEDIR

操作ログファイル（base_log.log）の出力先を指定します。論理ホスト側の操作ログは，共有ディスク上に出力するように指定することをお勧めします。

初期値

Windowsの場合：インストール先フォルダ¥log¥BASE

UNIXの場合：/var/opt/jp1base/log/BASE

論理ホストの場合の出力先例

Windowsの場合：共有フォルダ¥jp1base¥log¥BASE

UNIXの場合：共有ディレクトリ/jp1base/log/BASE

LOGSIZE

操作ログファイル（base_log.log）のサイズをバイトで指定します。下記の指定できる範囲の下限値よりも小さい値を指定した場合は，下限値を仮定し，上限値よりも大きい値を指定した場合には，上限値を仮定します。

初期値：00100000（1,024KB）

指定できる範囲：00002000〜00400000（8KB〜4,096KB）

LOGFILENUM

操作ログファイル（base_log.log）の保存する面数を指定します。下記の指定できる範囲の下限値よりも小さい値が設定された場合には，下限値を仮定し，上限値よりも大きい値が設定された場合には，上限値を仮定します。

初期値：00000004（4面）

指定できる範囲：00000001〜00000010（1〜16面）

LOGCHANGEOPT

JP1/Baseが起動した時点で，自動的にファイルを切り替えるかどうかを指定します。下記以外の値を指定した場合，初期値を仮定します。

初期値：00000000

起動時に切り替えない場合：00000000

起動時に切り替える場合：00000001

(d)　操作ログ定義ファイルの定義例

例えば，ENABLEの値を「00000001」に変更すると，1メガバイトの操作ログが出力され4面まで保存できます。

[JP1_DEFAULT¥JP1BASE¥BASE_LOG]
"ENABLE"=dword:00000001
"LOGFILEDIR"="/var/opt/jp1base/log/BASE"
"LOGSIZE"=dword:00100000
"LOGFILENUM"=dword:00000004
"LOGCHANGEOPT"=dword:00000000

付録I.6　操作ログに出力されるメッセージの一覧

KAJP6000-I

JP1ユーザーの登録に成功しました

The JP1 user was registered successfully.

KAJP6001-W

JP1ユーザーの登録に失敗しました

An attempt to register the JP1 user has failed.

KAJP6002-I

JP1ユーザーのパスワードの変更に成功しました

The password for the JP1 user was changed successfully.

KAJP6003-W

JP1ユーザーのパスワードの変更に失敗しました

An attempt to change the password for the JP1 user has failed.

KAJP6004-I

JP1ユーザーの削除に成功しました

The JP1 user was deleted successfully.

KAJP6005-W

JP1ユーザーの削除に失敗しました

An attempt to delete the JP1 user has failed.

KAJP6006-I

JP1資源グループの登録に成功しました

The JP1 resource group was registered successfully.

KAJP6007-W

JP1ユーザーの操作権限に関する定義情報の再読み込みに失敗しました

An attempt to reload the definition information about the JP1 user operating permissions has failed.

KAJP6008-I

JP1資源グループの変更に成功しました

The JP1 resource group was changed successfully.

KAJP6010-I

JP1資源グループの削除に成功しました

The JP1 resource group was deleted successfully.

KAJP6011-W

JP1資源グループの削除に失敗しました

An attempt to delete the JP1 resource group has failed.

KAJP6012-I

認証サーバの起動に成功しました

The authentication server was started successfully.

KAJP6013-E

認証サーバの起動に失敗しました

An attempt to start the authentication server has failed.

KAJP6014-I

認証サーバの停止に成功しました

The authentication server was stopped successfully.

KAJP6015-E

認証サーバの停止に失敗しました

An attempt to stop the authentication server has failed.

KAJP6016-I

JP1資源グループの登録に成功しました

The JP1 resource group was registered successfully.

KAJP6017-W

JP1ユーザーの操作権限に関する定義情報の再読み込みに失敗しました

An attempt to reload the definition information about the JP1 user operating permissions has failed.

KAJP6018-I

JP1資源グループの変更に成功しました

The JP1 resource group was changed successfully.

KAJP6020-I

JP1資源グループの削除に成功しました

The JP1 resource group was deleted successfully.

KAJP6022-I

jbs_spmd_reloadコマンドの実行に成功しました

The jbs_spmd_reload command was executed successfully.

KAJP6023-W

jbs_spmd_reloadコマンドの実行に失敗しました

An attempt to execute the jbs_spmd_reload command has failed.

KAJP6024-I

認証サーバのSSL通信が有効です

SSL communication is enabled for the authentication server.

KAJP6025-I

認証サーバのSSL通信が無効です

SSL communication is disabled for the authentication server.

付録J　JP1/Base管理者での運用（UNIX限定）

JP1/BaseをJP1/Baseのシステム管理者およびJP1/Base管理者で運用する場合，役割を明確にすることで，特定のOSユーザー権限の有無を意識する必要がなくなります。JP1/Base管理者がJP1/Baseを運用するためには，あらかじめ設定が必要です。JP1/Base管理者がJP1/Baseを運用する場合でも，JP1/Baseのプロセスはroot権限で動作します。なお，JP1/Base管理者を設定しても，JP1/Baseのシステム管理者がそれまでどおりJP1/Baseを運用することもできます。

ここでは，JP1/Baseのシステム管理者とJP1/Base管理者の役割分担，およびJP1/Base管理者がJP1/Baseを運用するための設定について説明します。なお，JP1/Base管理者での運用の概要については，「2.11　JP1/BaseをJP1/Base管理者で運用する（UNIX限定）」を参照してください。

付録J.1　JP1/Baseを運用するための役割分担

JP1/Baseでは，JP1/Baseの環境設定や一部のコマンドを実行する際に，OSやJP1/Baseの関連製品のユーザー権限が必要です。そのため，JP1/Base管理者がJP1/Baseの環境設定や運用のすべてをJP1/Baseシステムの管理者に代わって実行することはできません。したがって，JP1/Baseシステムの管理者とJP1/Base管理者の役割分担は次のようになります。

JP1/Baseのシステム管理者

OSの操作

JP1/Baseの環境設定

JP1/Baseの障害対策

JP1/Base管理者

JP1/Baseのシステム管理者がする作業以外のJP1/Baseの運用業務

JP1/Base管理者を設定した場合，運用のイメージは次のようになります。

図J‒1　JP1/Base管理者を設定した場合の運用イメージ

JP1/Baseのシステム管理者とJP1/Base管理者の役割の詳細を，次の表に示します。

表J‒1　JP1/Baseのシステム管理者の役割

項番

機能

1

OSの操作

hostsなどのネットワーク関連の設定

2

共有ディレクトリの割り当て，およびJP1/Base管理者に該当するディレクトリの更新権限の追加（論理ホストで運用時）

3

クラスタソフトへの登録（クラスタ環境で運用時）

4

JP1/Base管理者で運用するための設定

JP1管理者グループの作成

5

JP1/Base管理者とするOSユーザーをJP1管理者グループに設定

6

JP1/Baseの環境設定

JP1/Baseのインストール

7

JP1/Baseのアンインストール

8

コマンド実行履歴ファイルの移行（jcocmdconvコマンド）

9

JP1/Base管理者での運用の設定（jbssetadmingrpコマンド）

10

HNTRLibが管理するrootユーザー専用コマンドの実行

11

ISAMで使用するリソースの削除（Jisrsdelコマンド）

12

ロックテーブルのエントリー数の拡張および縮小（Jislckextコマンド）

13

JP1/Baseの障害対策

すべての論理ホストの強制停止（jbs_killall.clusterコマンド）

14

資料採取（jbs_log.shコマンド）※

注※　資料採取のjbs_log.shコマンドは，JP1/Base管理者でも実行できます。ただし，JP1/Base管理者権限で実行した場合，次に示す資料は権限不足で採取できません。

シスログ（syslog）

/var/log/messages（Linuxの場合）

カーネルパラメーター情報

/etc/security/limits（AIXの場合）

システム診断状況

/usr/bin/alog -o -t bootの実行結果（AIXの場合）

なお，資料採取に失敗した場合，次のメッセージがコンソールに表示されます。

Can not get 採取に失敗した資料名.

表J‒2　JP1/Base管理者の役割

項番

機能

1

JP1/Baseの運用

JP1/Baseの起動および停止

2

ユーザー管理

ユーザー認証

3

ユーザーマッピング

4

イベントサービス

5

イベント変換

ログファイルトラップ

6

定義収集および配布

IM構成管理による定義情報の管理，およびサービス稼働情報の管理

7

イベントサービスの定義収集，および配布

8

JP1製品の定義収集

9

プロセス管理

10

ヘルスチェック

11

ローカルアクション

12

論理ホストの実行系および待機系の追加

13

ISAMファイル関連のユーティリティコマンド

ただし，次に示すコマンドは使用できません。

ISAMで使用するリソースの削除（Jisrsdelコマンド）

ロックテーブルのエントリー数の拡張および縮小（Jislckextコマンド）

なお，JP1/Base管理者で運用する場合は，次の機能は使用できません。JP1/Baseのシステム管理者が実行してください。

スーパーユーザーへのマッピング

JP1/Base管理者がスーパーユーザー（「root」のOSユーザー）へのマッピング定義を追加設定した場合，エラーとなり，エラーメッセージが出力されます。

自動起動

JP1/Base管理者での運用はサポートしていません。

付録J.2　JP1/Base管理者で運用するための設定

JP1/Base管理者で運用する場合，JP1/Baseのシステム管理者はあらかじめ，次に示す設定が必要です。

JP1管理者グループ（OSのユーザーグループ）の作成

既存のOSグループをJP1管理者グループとして使用することもできます。

JP1/Base管理者とするユーザーのプライマリーグループの設定

プライマリーグループをJP1管理者グループにします。

JP1/Base管理者での運用を有効にする設定※

この設定は，jbssetadmingrpコマンドを実行します。このコマンドは，JP1/Base管理者での運用の設定も確認できます。jbssetadmingrpコマンドについては，「15.　コマンド」の「jbssetadmingrp（UNIX限定）」を参照してください。

注※

JP1/Base管理者での運用を有効にしたあと，設定を無効にするにはJP1/Baseのアンインストールと再インストールが必要です。JP1/Baseをアンインストールする際には，JP1/Baseを前提とする製品のアンインストールも必要になるため，十分に検討した上でJP1/Base管理者での運用を有効にする設定をしてください。

(1)　特定の機能を使用するための設定

JP1/Base管理者での運用時に，次に示す機能を使用する場合は，事前に設定が必要です。なお，この設定は，JP1/Baseのシステム管理者がしてください。

論理ホストの共有ディレクトリ，操作ログの出力先ディレクトリ，またはイベントサービスが使用するディレクトリの設定

ISAMファイル関連のユーティリティコマンドの実行

(a)　論理ホストの共有ディレクトリ，操作ログの出力先ディレクトリ，またはイベントサービスが使用するディレクトリの設定

論理ホストの共有ディレクトリ，操作ログの出力先ディレクトリ，またはイベントサービスが使用するディレクトリをJP1/Base管理者が使用するために，該当するディレクトリのすべての上位ディレクトリに，JP1/Base管理者がアクセスできる必要があります。次に示すディレクトリのすべての上位ディレクトリに，othersでの参照および実行権限を与えてください。

各論理ホストの共有ディレクトリ

操作ログの出力先ディレクトリ（初期設定以外の場合）

イベントサーバインデックスファイル（index）で指定した，default以外のディレクトリ

(b)　ISAMファイル関連のユーティリティコマンドを実行するための設定

ISAMファイル関連のユーティリティコマンドを実行する場合は，事前にumask値を「002」に変更してください。

(2)　JP1/Base管理者での運用を無効にするための設定

JP1/Base管理者での運用を無効にする手順を次に示します。

設定情報およびイベントDBをバックアップする。

設定情報およびイベントDBのバックアップ手順については，「3.5.3(1)　設定情報のバックアップ」および「3.5.3(2)　イベントDBのバックアップ」を参照してください。

JP1/Baseをアンインストールする。

JP1/Baseのアンインストール手順については，「3.3.3　アンインストール」を参照してください。なお，アンインストール後，インストールフォルダにJP1/Baseのファイルが残っている場合は，完全に削除してください。

JP1/Baseを新規インストールする。

設定情報をリカバリーする。

設定情報のリカバリー手順については，「3.5.3(3)　設定情報のリカバリー」を参照してください。

ただし，JP1/Base管理者での運用を無効にする場合の設定情報のリカバリーでは，バックアップした定義ファイルの権限，所有者，およびグループが復元されない手順でリカバリーする必要があります。手順3で新規インストールした定義ファイルの権限，所有者，およびグループが引き継がれるようにしてください。

イベントDBをリカバリーする。

イベントDBのリカバリー手順については，「3.5.3(4)　イベントDBのリカバリー」を参照してください。

また，リカバリー後，イベントDBファイルの所有者，アクセス権限，および所有グループを次に示す操作で変更してください。

cd /var/opt/jp1base/sys/event/servers/default※，またはcd 共有ディレクトリ/event※
chmod 644 ./IMEvent*.*
Linuxの場合：chown root:root ./IMEvent*.*
AIXの場合：chown root:system ./IMEvent*.*

注※　イベントサーバインデックスファイル（index）で，イベントサーバが使用するディレクトリに別のパスを指定している場合は，指定したパスの配下に配置してください。

(3)　JP1/Base管理者での運用が有効な環境でのバックアップとリカバリー

JP1/Base管理者での運用が有効な環境でのバックアップとリカバリーの手順を次に示します。

設定情報およびイベントDBをバックアップする。

設定情報およびイベントDBのバックアップ手順については，「3.5.3(1)　設定情報のバックアップ」および「3.5.3(2)　イベントDBのバックアップ」を参照してください。

設定情報およびイベントDBをリカバリーする。

設定情報およびイベントDBのリカバリー手順については，「3.5.3(3)　設定情報のリカバリー」および「3.5.3(4)　イベントDBのリカバリー」を参照してください。

JP1/Base管理者での運用を有効にする。

jbssetadmingrpコマンドを実行して，JP1/Base管理者での運用を有効にしてください。なお，JP1管理者グループの名称および「gid」は，バックアップしたホストと一致させてください。

付録J.3　論理ホストをJP1/Base管理者で運用するための設定

論理ホストをJP1/Base管理者で運用する場合，論理ホストは物理ホストに設定されたJP1/Base管理者での運用の有効または無効を引き継ぎます。論理ホストをJP1/Base管理者で運用するための設定手順を次に示します。なお，この設定は，JP1/Baseのシステム管理者が実行してください。

(1)　既存の論理ホストをJP1/Base管理者で運用する場合

非クラスタ環境の場合

共有ディレクトリをマウントする。

次のコマンドを実行し，JP1/Base管理者での運用を有効にする。

jbssetadmingrp -s JP1管理者グループ

手順2の実行結果から，物理および論理ホストごとにJP1/Base管理者での運用が有効になっているか確認する。

ホストごとの実行結果を示すメッセージを確認してください。

なお，JP1/Base管理者での運用が有効になっていないホストがある場合は，そのホストをマウントし，再度手順2を実行してください。

次のコマンドを実行し，すべての論理ホストでJP1/Base管理者での運用が有効となっているか確認する。

jbssetadmingrp -v

クラスタ環境の場合

クラスタ環境でJP1/Base管理者での運用を有効にする場合，実行系と待機系のホスト間でJP1管理者グループの名称とIDを一致させる必要があります。

実行系で次のコマンドを実行し，JP1/Base管理者での運用を有効にする。

jbssetadmingrp -s JP1管理者グループ

手順1の実行結果から，物理および論理ホストごとにJP1/Base管理者での運用が有効になっているか確認する。

ホストごとの実行結果を示すメッセージを確認してください。

なお，JP1/Base管理者での運用が有効になっていないホストがある場合は，そのホストをマウントし，再度手順1を実行してください。

実行系で次のコマンドを実行し，すべての論理ホストでJP1/Base管理者での運用が有効となっているか確認する。

jbssetadmingrp -v

待機系で次のコマンドを実行し，JP1/Base管理者での運用を有効にする。

jbssetadmingrp -s JP1管理者グループ

手順4の実行結果から，実行系と待機系のJP1管理者グループ名と「gid」が一致しているか確認する。

不一致の場合は，OS側の設定を変更してから，再度手順4を実行してください。なお，論理ホストに対して，KAVA1829-Wメッセージが出力されますが，無視してください。

待機系にすべての論理ホストをフェールオーバーする。

待機系で次のコマンドを実行し，すべての論理ホストでJP1/Base管理者での運用が有効となっているか確認する。

jbssetadmingrp -v

なお，実行系と待機系でJP1管理者グループと「gid」が不一致の場合は，実行系にすべての論理ホストをフェールオーバーし，OS側の設定を変更してから，再度手順4から実行してください。

(2)　新規の論理ホストをJP1/Base管理者で運用する場合

論理ホストを新規に作成する場合は，論理ホストのセットアップ時に，すでにJP1管理者グループのアクセス権を与えられた物理ホストのファイルを論理ホストにコピーするため，論理ホストでJP1/Base管理者での運用を有効にする設定は不要となります。

(3)　論理ホストのJP1/Base管理者での運用を無効にする場合

共有ディレクトリをマウントする。

次のコマンドを実行し，JP1/Base管理者での運用を無効にする。

jbssetadmingrp -s sys※

注※　AIXの場合は，systemとなります。

なお，クラスタ環境の場合は，実行系および待機系で実行してください。

手順2でJP1/Base管理者での運用を無効にした論理ホストで，次のコマンドを実行する。

jbssetadmingrp -v

手順3の実行結果から，JP1/Base管理者での運用を無効にした論理ホストで，JP1/Base管理者での運用が無効となっているか確認する。

付録K　セキュアなシステムの運用

JP1/Baseを使用したシステムを，セキュアに運用するための方法について説明します。

JP1/Baseを使用したシステムをセキュアに運用するためには，前提としてファイアウォールやOSアカウントの管理など運用上の対策が必要です。その上で，JP1/Baseの機能として，意図しないホストからの通信接続を制限することでセキュアなシステム運用を実現します。

付録K.1　セキュアなシステムの前提条件

システム管理者はシステムをセキュアに運用する前提として，次に示すような不正な行為に対して対策する必要があります。

図K‒1　不正な行為とその対策

不正な行為

対策

外部ネットワークからの攻撃

ファイアウォールを設置する。

マネージャーホストへの不正なログイン

マネージャーホストのAdministratorsグループのアカウント，rootアカウント，およびJP1/Base管理者グループに所属するOSアカウントを管理して，マシン管理者およびJP1製品の管理者以外のマネージャーホストへのログインを制御する。

JP1/IM - Managerへの不正なログイン

VPNの設置などで，JP1/IM - ViewとJP1/IM - Manager間の通信の盗聴を防ぐ。

付録K.2　意図しないホストからの通信接続を制限する

JP1/Baseは，マネージャーホスト（送信元）とエージェントホスト（送信先）間の通信の際に，接続できるホストを制限できます。これによって，意図しないホストからのコマンド実行要求や，構成定義の変更を防げます。

通信接続の制限は，次に示す機能に対応しています。

コマンド実行機能

構成定義に登録された上位ホストから送信されるコマンド実行要求だけ，受信するように設定できます。

構成管理機能

構成定義に登録された上位ホストから送信される構成変更要求だけ，受信するように設定できます。

連携製品からの操作要求（JP1/Base間の通信）

次に示す製品の連携で，任意に定義したホストから送信される要求だけ，受信するように設定できます。

JP1/IM - Rule Operationからのコマンド実行要求

JP1/IM - Planning Operationからのオペレーションジョブ実行要求

JP1/Navigation PlatformとJP1/Automatic Operationで連携する場合の通信

JP1/Navigation PlatformとJP1/IM - Managerで連携する場合の通信

図K‒2　意図しないホストからの通信接続の制限

付録K.3　意図しないホストからの通信接続を制限するための定義

意図しないホストからの通信接続を制限するには，接続を許可するホストを定義した任意の名称のファイルを作成し，jbssetcnfコマンドで共通定義情報に設定します。

定義ファイルの設定内容を次に示します。

制限対象の機能

キー名称

オプション名および指定値

内容

コマンド実行機能

構成管理機能

JP1_DEFAULT¥JP1BASE¥COM_CONTROL¥ROUTE

"UPPER_ONLY"=dword:{ 00000000 | 00000001 }

構成定義に登録された上位ホスト以外から送信された要求を抑止するオプションです。共通定義情報が設定されていない場合は，初期値が仮定されます。また，指定できる値以外が指定された場合，起動時は初期値，リロード時はリロード前の値が仮定されます。

00000000：無効（初期値）

00000001：有効

"ALT_CLIENT_HOSTS"="{ ホスト名 | IPアドレス }, ..."

UPPER_ONLYオプションが有効のときでも，このオプションに指定したホストから送信される要求は受け付けます。UPPER_ONLYオプションが無効ときに，このオプションを指定した場合は無効になります。ホストはコンマ区切りで四つまで指定できます。初期値は，未定義になります。

連携製品からの操作要求（JP1/Base間の通信）

JP1_DEFAULT¥JP1BASE¥COM_CONTROL¥RECEIVE

"CLIENT_HOSTS"="{ ホスト名 | IPアドレス }, ..."

このオプションに指定したホスト以外から送信された要求は抑止されます。オプションが未定義の場合は，接続制限はしません。ホストはコンマ区切りで八つまで指定できます。初期値は，未定義になります。

注※

クラスタシステムで運用している場合は，JP1_DEFAULTを論理ホスト名に置き換えて設定します。また，実行系および待機系の両方で設定します。

(1)　定義ファイルの注意事項

ALT_CLIENT_HOSTSオプションまたはCLIENT_HOSTSオプションを無効にする場合は，空文字（""）を定義してください。

ALT_CLIENT_HOSTSオプションおよびCLIENT_HOSTSオプションに，指定できるIPアドレスの形式を次に示します。なお，次に示すIPアドレスの形式に従わないアドレスは，ホスト名として扱われます。

IPv4アドレスを指定する場合の形式

形式は，W.X.Y.Zです。W，X，Y，Zには，それぞれ0〜255の範囲の十進数で指定してください。

IPv6アドレスIPv4アドレスを指定する場合の形式

形式は，A:B:C:D:E:F:G:Hです。A，B，C，D，E，F，G，Hには，それぞれ0〜ffffの範囲の16進数で指定してください。

数値が0から始まる場合，先頭の0を省略できます。

0000の場合，0を指定します。

一つ以上0000が連続する場合，1回だけ「::」で省略できます。

（例）

　省略前：0123:0000:0000:0000:4567:0000:0000:89ab

　省略後：123::4567:0:0:89ab

ALT_CLIENT_HOSTSオプションおよびCLIENT_HOSTSオプションの定義内容に，次に示す不正がある場合は，起動時は初期値，リロード時はリロード前の定義内容を仮定して処理を継続します。

ホスト名を重複して指定している。なお，大文字・小文字は区別されません。

指定できるホスト数を超えてホストを指定している。

256バイト以上のホスト名を指定している。

名前解決できないホスト名を指定している。

構成定義に登録された上位ホストおよびオプションに定義したホスト名に対応するIPアドレスを変更した場合は，jbs_spmd_reloadコマンドを実行すると反映されます。

構成定義に登録された上位ホストおよびオプションに定義したホスト名に対応するIPアドレスは，送信元ホストが実際に通信で使用しているIPアドレスと一致させる必要があります。

NAT環境で運用する場合は，変換後の送信元IPアドレスをALT_CLIENT_HOSTSオプションまたはCLIENT_HOSTSオプションに定義してください。

UPPER_ONLYオプションが有効なサブマネージャーホストから構成定義を変更する場合は，サブマネージャーホストのALT_CLIENT_HOSTSオプションに自ホスト名または自ホストのIPアドレスを定義してください。

UPPER_ONLYオプションが有効で，構成定義に上位ホストが登録されていないホストの場合，次に示す動作となります。

任意のホストから構成変更要求（定義配布）を受信します。

自ホスト以外のホストからのコマンド実行要求を抑止します。

付録K.4　意図しないホストからの通信接続を制限するための手順

意図しないホストからの通信接続を制限するための手順を次に示します。

定義ファイルを任意の名称で作成する

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

[JP1_DEFAULT¥JP1BASE¥COM_CONTROL¥ROUTE]
"UPPER_ONLY"=dword:00000001
"ALT_CLIENT_HOSTS"="host1"
[JP1_DEFAULT¥JP1BASE¥COM_CONTROL¥RECEIVE]
"CLIENT_HOSTS"="host1,host2"

jbssetcnfコマンドを実行する

jbssetcnfコマンドを実行して，定義ファイルの内容を共通定義に登録します。

jbssetcnf 定義ファイル名

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

JP1/Baseを再起動またはリロードする

JP1/Baseを再起動またはリロードして，設定した定義を有効にします。リロードは，jbs_spmd_reloadコマンドを実行します。jbs_spmd_reloadコマンドの詳細は「15.　コマンド」の「jbs_spmd_reload」を参照してください。

付録K.5　通信接続の制限によって要求が拒否された場合に出力されるメッセージ

通信接続の制限によって，意図しないホストからの要求を拒否した場合，そのことを示すメッセージが出力されます。制限対象となる機能およびコマンドごとに，要求元ホストと要求先ホストで出力されるメッセージを，次の表に示します。出力先は，統合トレースログになります。

表K‒1　通信接続の制限によって要求が拒否された場合に出力されるメッセージ

制限対象の機能

制限対象のコマンド

制限対象のホスト

出力されるメッセージ

コマンド実行機能

−

要求元ホスト

KAVB2630-E 許可されていないホストからの要求を拒否しました。(要求元ホスト名または要求元IPアドレス)

−

要求先ホスト

KAVB2630-E 許可されていないホストからの要求を拒否しました。(要求元ホスト名または要求元IPアドレス)

構成管理機能

jbsrt_distribコマンド実行（構成定義の削除）

要求元ホスト

KAVB3104-W 以下のホスト及び下位ホストの構成情報が削除できませんでした. 個別に削除した後，再度実行して下さい ホスト名

jbsrt_distribコマンド実行（構成定義の配布）

KAVB3107-E 以下のホストで構成情報が設定できません ホスト名

KAVB3108-E 定義配布に失敗しました。以下のホストで構成情報が設定できませんでした. ホスト名

jbsrt_syncコマンド実行（構成定義の同期）

KAVB3111-E 同期コマンドの実行に失敗しました. 以下のホストでエラーが発生しました. ホスト名

−

要求先ホスト

KAVB3164-E 許可されていないホストからの要求を拒否しました(要求元ホスト名または要求元IPアドレス)

連携製品からの操作要求（JP1/Base間の通信）

−

要求元ホスト

KAVA6701-E 実行先ホストに接続できませんでした（host=ホスト名）

−

要求先ホスト

KAVA6046-E 許可されていないホストからの要求を拒否しました。(要求元ホスト名または要求元IPアドレス)

（凡例）

−：該当なし。

付録L　オートスケール機能と連携した運用

クラウドプラットフォーム（Amazon EC2）のオートスケール機能と連携した運用について説明します。

オートスケール機能はAmazon EC2サービスが提供する機能の一つで，システムの負荷などをしきい値として，必要に応じて自動的に仮想マシンの台数を増やしたり（スケールアウト），自動的に削除したり（スケールイン）します。

オートスケール機能と連携した運用では，スケールアウトによって追加された仮想マシンを，自動的にシステムの監視対象に追加します。具体的には，マネージャーから次の監視運用が自動的に設定されます。

JP1/IMによる基本的な統合監視が設定される

構成定義（IM構成管理を使用しない）によるシステムの階層構成の管理

JP1イベントによるシステムで発生したさまざまな事象の一元管理

JP1/Baseのヘルスチェック機能の他ホスト監視

JP1/PFMによるアラーム監視が設定される（JP1/PFMを使用して監視する場合だけ）

また，スケールインによって削除された仮想マシンに対して，これらの設定を自動的に解除します。

Amazon EC2 API Toolsを使用するオートスケール連携は，バージョン11および12の互換用です。バージョン13以降では，AWS CLIを使用してください。

付録L.1　オートスケール機能と連携して運用する場合のシステム構成

オートスケール機能と連携して運用する場合のシステム構成について説明します。

システムは監視対象となるホスト（エージェントホスト）と，エージェントを監視するホスト（マネージャーホスト）で構成されます。

図L‒1　オートスケール機能と連携して運用する場合のシステム構成図

(1)　前提とするクラウドサービス

Amazon EC2サービス

(2)　サポート対象のOS

Windows

Windows Server 2016

Windows Server 2019

Windows Server 2022

Linux

Linux 7

Linux 8

Linux 9

(3)　前提とするプログラム

マネージャーホストおよびエージェントホストにインストールするプログラムを次に示します。

マネージャーホスト

JP1/Base 13-00以降※

JP1/Integrated Management - Manager 13-00以降

AWS CLI（AWS CLIの前提プログラム）

注※

JP1/Baseに同梱しているスクリプトは，AWS CLIのバージョン2.0.0（2020年2月10日リリース版）で動作検証しています。JP1/Baseに同梱しているスクリプトで使用しているAWS CLIのコマンド（aws ec2 describe-instance-status，aws ec2 describe-instances）のインタフェースなどに変更がないバージョンの範囲で使用できます。

互換用のAmazon EC2 API Toolsを使用する場合は，上記のプログラムの代わりに，次のプログラムをインストールしてください。

JP1/Base 11-00以降

JP1/Integrated Management - Manager 11-00以降

Java Runtime Environment（JRE）1.7以降

Amazon EC2 API Tools（Amazon EC2 API Toolsの前提プログラム）

JP1/PFMを使用して監視する場合は，次のプログラムをインストールしてください。

JP1/Performance Management - Manager 11-00以降

エージェントホスト

JP1/Base 11-00以降

JP1/PFMを使用して監視する場合は，次のプログラムをインストールしてください。

JP1/Performance Management - Agent Option for Platform 11-00以降

JP1/Performance Management - Base 11-00以降

(4)　ホストの環境条件

マネージャーホストおよびエージェントホストの環境条件を次に示します。

マネージャーホスト

特に制限はありません。物理マシン環境または仮想マシン環境（クラウド環境上の仮想マシンを含む）のどちらの環境でも運用できます。

エージェントホスト

Amazon EC2サービスが提供する仮想マシン環境（Amazon EC2インスタンス）である必要があります。

付録L.2　オートスケール機能と連携して運用する場合の前提条件

オートスケール機能と連携して運用する場合の前提条件を次に示します。

マネージャーホストおよびエージェントホストは，クラスタ環境の論理ホストには適用できません。

システムの構成はマネージャーホストを含めて2,500台以内にしてください。

マネージャーホストの自動アクション機能のコマンド同時実行数の設定値は，1にしてください。

JP1/PFMを使用して監視する場合は，次に示す条件があります。

二重監視機能は使用できません。

エージェント階層（User Agent）への追加または削除はできません。

必要な場合は，スケールアウトまたはスケールイン後に，手動で設定してください。

業務グループへの追加または削除はできません。

必要な場合は，スケールアウトまたはスケールイン後に，手動で設定してください。

DNS環境でも運用できますが，FQDN名のホスト名には対応していません。

JP1/Baseの「JP1/Base管理者での運用」は利用できません。

付録L.3　スケールアウト時に監視対象に追加する

スケールアウトによってエージェントホストが追加された場合，エージェントホストからマネージャーホストへJP1イベントを通知します。マネージャーホストで，このJP1イベントに対する自動アクションを実行し，スケールアウトによって追加されたエージェントホストをシステムの監視対象に追加するための設定を実施します。

図L‒2　スケールアウト時の動作の概要

(1)　JP1イベントによるスケールアウトの通知

スケールアウト発生後の最初のOS起動時に，JP1イベントでマネージャーホストにスケールアウトの発生を通知するスケールアウト通知イベント（イベントID：1011）を発行します。イベントの詳細については，「17.3.1(1)　イベントID：00001011の詳細」を参照してください。

イベントの送信に失敗した場合は，600秒間隔で6回までリトライを実施します。

スケールアウト通知イベントの送信先となるマネージャーホストは，事前にスクリプト定義ファイルに設定する必要があります。また，通知イベントの属性（イベントIDおよびメッセージ）は，任意の値に変更できます。

スクリプト定義ファイルの詳細については，「付録L.8　オートスケール連携スクリプト」を参照してください。

(2)　ネットワーク設定と監視設定

スケールアウト通知イベントに対する自動アクションによって，次に示すネットワークの設定と監視設定を実施します。

マネージャーホストのhostsファイルに，エージェントホストのホスト名とIPアドレスを追加します。

ヘルスチェック定義ファイル（jbshc.conf）にエージェントホストを追加し，JP1/Baseをリロードして定義を有効にします。

構成定義ファイル（jbs_route.conf）にエージェントホストを追加し，構成情報を配布します。

また，JP1/PFMを使用して監視している場合は，スクリプト定義ファイルに指定したアラームテーブル名に従い，エージェントにアラームテーブルをバインドします。なお，エージェントにバインドするアラームテーブル名は，スクリプト定義ファイルに設定できます。スクリプト定義ファイルの詳細については，「付録L.8　オートスケール連携スクリプト」を参照してください。

(3)　監視が正常に実施されたかどうかの確認

監視が正常に実施されたかどうかについては，スケールアウト通知イベントに対する自動アクションの終了コードで確認できます。正常終了した場合は終了コードが0，異常終了した場合は終了コードが0以外となります。

異常終了した場合は，異常の原因を取り除いた上で，自動アクションを再実行してください。

付録L.4　スケールイン時に監視を解除する

スケールインによってエージェントホストが削除された場合，ヘルスチェック機能でエージェントホストの停止または異常を検知し，マネージャーホストに登録されたJP1イベントに対する自動アクションを実行します。これによって，エージェントホストをシステムの監視対象から削除します。

(1)　ヘルスチェックによるスケールインの検知

スケールインの発生は，ヘルスチェック機能（他ホスト監視）で検知します。

エージェントはJP1/Baseサービスの停止時に，停止通知イベント（イベントID：4725）をマネージャーに転送します。イベントの詳細については，「17.3.1(42)　イベントID：00004725の詳細」を参照してください。

何らかの理由で停止通知イベントを受信できなかった場合，エージェントの異常を検知して，異常検知イベント（イベントID：4749または474D）を発行します。

正常監視中に異常を検知した場合は，異常検知イベント（イベントID：4749）を発行します。イベントの詳細については，「17.3.1(49)　イベントID：00004749の詳細」を参照してください。

停止または異常の区別がつかない場合は，異常検知イベント（イベントID：474D）を発行します。イベントの詳細については，「17.3.1(53)　イベントID：0000474Dの詳細」を参照してください。

(2)　ネットワーク設定と監視設定の解除

ヘルスチェックの停止通知イベント（イベントID：4725）または異常検知イベント（イベントID：4749または474D）に対する自動アクションによって，次に示すネットワークの設定と監視設定の解除を実施します。

マネージャーホストのhostsファイルからスケールインされたエージェントホストに対応する情報を削除します。

ヘルスチェック定義ファイル（jbshc.conf）からエージェントホストを削除し，JP1/Baseをリロードして定義を有効にします。

構成定義ファイル（jbs_route.conf）からエージェントホストを削除します。

jbsas_setup_manager.iniファイルの設定パラメーター（JbsrtDistribByScaleIn）の値がYESの場合，構成定義を配布します。値がNOの場合，構成定義は配布されません。次回のスケールアウト発生時に構成定義が配布されます。初期値はNOです。

JP1/PFMを使用して監視している場合は，エージェントの監視情報を削除します。

一時的なエラーによってJP1イベントが通知されスケールアウトが実施されていない場合は，自動アクションが実行されてもこれらの設定の解除はされません。

(3)　監視の解除が正常に実施されたかどうかの確認

監視の解除が正常に実施されたかどうかについては，停止通知イベント（イベントID：4725）または異常検知イベント（イベントID：4749または474D）に対する自動アクションの終了コードで確認できます。正常終了した場合は終了コードが0，異常終了した場合は終了コードが0以外となります。

異常終了した場合は，異常の原因を取り除いた上で，自動アクションを再実行してください。

付録L.5　オートスケール機能と連携して運用する場合のセットアップ手順（マネージャーホスト）

オートスケール機能と連携して運用する場合のマネージャーホストのセットアップ手順を次に示します。

なお，手順7および手順8は，JP1/PFMを使用して監視する場合に必要な手順です。

AWS CLIをインストールする

Amazon Web Servicesの公式サイトからAWS CLIをダウンロードして，任意のディレクトリに配置してください。

AWS CLIの実行に必要な環境変数を設定する。

AWS CLIの実行に必要な環境変数を，スクリプト定義ファイル（jbsas_setup_manager_cli.ini）に設定してください。AWS CLIの実行環境に必要な設定の詳細については，AWS CLIの公式サイトを参照してください。スクリプト定義ファイルの詳細については，「付録L.8　オートスケール連携スクリプト」を参照してください。

JP1/BaseおよびJP1/IM - Managerをインストールする。

JP1/Baseのヘルスチェック機能を有効にする。

スケールアウトしたホストの監視を開始するための自動アクションを設定する。

オートスケール連携スクリプト（jbsas_add_agent_cli）を実行するために，次の表に示す自動アクション定義を設定してください。なお，自動アクション定義の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の自動アクションによるコマンド実行について説明している章を参照してください。

表L‒1　自動アクション定義（スケールアウト用）

定義項目

定義値

アクション名

任意に指定

イベントID

1011（スケールアウト通知イベントのイベントIDを変更している場合は，変更後のイベントIDを指定）

イベント条件

なし

実行ユーザー名

Windowsの場合：

jp1adminまたはAdministrators権限を持つOSユーザーにマッピングされたJP1ユーザー名

Linuxの場合：

jp1adminまたはスーパーユーザー権限を持つOSユーザーとマッピングされたJP1ユーザー名

実行ホスト名

マネージャーホスト名

アクション

Windowsの場合：

powershell -ExecutionPolicy RemoteSigned "&'インストール先フォルダ¥tools¥cloud¥jbsas_add_agent_cli.ps1'" $EVIPADDR $EVHOST $EV"OS_TYPE" $EV"INSTALLPP_INFO" <nul

互換用のAmazon EC2 API Toolsを使用する場合は，次の内容を設定してください。

powershell -ExecutionPolicy RemoteSigned "&'インストール先フォルダ¥tools¥cloud¥jbsas_add_agent.ps1'" $EVIPADDR $EVHOST $EV"OS_TYPE" $EV"INSTALLPP_INFO" <nul

Linuxの場合：

/bin/sh /opt/jp1base/tools/cloud/jbsas_add_agent_cli.sh $EVIPADDR $EVHOST $EV"OS_TYPE" $EV"INSTALLPP_INFO"

互換用のAmazon EC2 API Toolsを使用する場合は，次の内容を設定してください。

/bin/sh /opt/jp1base/tools/cloud/jbsas_add_agent.sh $EVIPADDR $EVHOST $EV"OS_TYPE" $EV"INSTALLPP_INFO"

スケールインしたホストの監視を終了するための自動アクションを設定する。

オートスケール連携スクリプト（jbsas_del_agent_cli）を実行するために，次の表に示す自動アクション定義を設定してください。なお，自動アクション定義の詳細については，マニュアル「JP1/Integrated Management 3 - Manager 導入・設計ガイド」の自動アクションによるコマンド実行について説明している章を参照してください。

表L‒2　自動アクション定義（スケールイン用）

定義項目

定義値

アクション名

任意に指定

イベントID

4725,4749,474D

イベント条件

なし

実行ユーザー名

Windowsの場合：

jp1adminまたはAdministrators権限を持つOSユーザーにマッピングされたJP1ユーザー名

Linuxの場合：

jp1adminまたはスーパーユーザー権限を持つOSユーザーとマッピングされたJP1ユーザー名

実行ホスト名

マネージャーホスト名

アクション

Windowsの場合：

powershell -ExecutionPolicy RemoteSigned "&'インストール先フォルダ¥tools¥cloud¥jbsas_del_agent_cli.ps1'" $EVOBNAM <nul

互換用のAmazon EC2 API Toolsを使用する場合は，次の内容を設定してください。

powershell -ExecutionPolicy RemoteSigned "&'インストール先フォルダ¥tools¥cloud¥jbsas_del_agent.ps1'" $EVOBNAM <nul

Linuxの場合：

/bin/sh /opt/jp1base/tools/cloud/jbsas_del_agent_cli.sh $EVOBNAM

互換用のAmazon EC2 API Toolsを使用する場合は，次の内容を設定してください。

/bin/sh /opt/jp1base/tools/cloud/jbsas_del_agent.sh $EVOBNAM

JP1/PFM - Managerをインストールする。

エージェントにバインドするアラームテーブルを設定する。

スケールアウトしたエージェントホストにバインドするアラームテーブル名を，スクリプト定義ファイル（jbsas_setup_manager_cli.ini）に設定してください。スクリプト定義ファイルの詳細については，「付録L.8　オートスケール連携スクリプト」を参照してください。

また，オートスケール機能と連携して運用する場合のセットアップ手順の実施に合わせて，運用に必要な設定をしてください。一例を次に示します。

エージェントの障害に対処するために自動アクションを設定する。

自動アクション定義の実行ホスト名に「$EVHOST」と指定することで，イベント転送元のエージェントに対して自動アクションを実行して，障害に対処するための処理を実施できます。

付録L.6　オートスケール機能と連携して運用する場合のセットアップ手順（エージェントホスト）

オートスケール機能と連携して運用する場合のエージェントホストのセットアップ手順を次に示します。

次の手順はAmazon EC2サービスが提供する仮想マシン（EC2インスタンス）で実施してください。

なお，手順3から手順7については，JP1/PFMを使用して監視する場合に必要な手順です。

JP1/Baseをインストールする。

JP1/Baseのヘルスチェック機能を有効にする。

JP1/PFM - BaseおよびJP1/PFM - Agentをインストールする。

必要に応じて，JP1/PFMの各種設定のセットアップを実施する。

一部の設定は，JP1/PFMのサービスが起動している状態で，JP1/PFM - Web Consoleから設定する必要があります。JP1/PFMのサービスを起動して設定を実施した場合は，次の手順を実施してください。

1. エージェントホストのJP1/PFMサービスを停止する。

2. エージェントホストでjpctool db clearコマンドを実行して，すべてのレコード情報を削除する。

3. マネージャーホストでjpctool service deleteコマンドを実行して，設定を実施したエージェントのサービス情報を削除する。また，jpctool service syncコマンドを実行して，JP1PFM - Web Consoleに同期させる。

（Linuxの場合だけ）jpcconf host hostmode - mode hostnameコマンドを実行して，監視ホスト名をhostnameコマンドで取得する方法に変更する。

JP1/PFMの自動起動設定を無効にする。

Windowsの場合

JP1/PFMの全サービスについて，Windowsの［サービス］ダイアログボックスから［スタートアップ］を「手動」に設定する。

Linuxの場合

自動起動スクリプトファイル（jpc_start）を配置している場合は，格納した自動起動スクリプトファイル（jpc_start）ファイルを削除する。

（JP1/PFM BaseのバージョンがV11でかつLinuxの場合だけ）サービス自動起動スクリプトファイル（jp1_pc）を編集する。

編集前：

#!/bin/sh
## Copyright (C) 2004, Hitachi, Ltd.
## Licensed Material of Hitachi, Ltd.
：

編集後：

#!/bin/sh
## Copyright (C) 2004, Hitachi, Ltd.
## Licensed Material of Hitachi, Ltd.
### BEGIN INIT INFO
# Provides: jp1_pc
# Required-Start: $local_fs $remote_fs $syslog $network
# Required-Stop: $local_fs $remote_fs $syslog $network
# Default-Start: 3 5
# Default-Stop: 0 6
# Description: Start PFM services.
### END INIT INFO
：

マネージャーホストをhostsファイルまたはDNSに登録して通信できる状態にする。

スケールアウト通知イベントの設定をする。

スケールアウトを通知するイベントの送信先となるマネージャーホストを，スクリプト定義ファイル（jbsas_setup_agent.ini）に指定してください。なお，イベントの属性（イベントID，メッセージ）を変更できます。

スクリプト定義ファイルの詳細については，「付録L.8　オートスケール連携スクリプト」を参照してください。

（Windowsの場合だけ）Amazon EC2起動サービスの設定をする。

次に示す手順に従い，設定してください。

・EC2Configの場合

1. ［EC2 Services Properties］ダイアログボックスを開く。

［アプリ］画面から，［EC2 Config Service Settings］をクリックします。

2. ［General］タブをクリックして展開する。

3. ［Set Computer Name］および［User Data］チェックボックスをチェックして適用する。

・EC2Launch v1の場合

1. EC2LaunchSettingsを開く。

2. ［Set Computer Name］および［Handle User Data］チェックボックスをチェックして適用する。

・EC2Launch v2の場合

1. EC2LaunchSettingsを開く。

2. ［General］タブをクリックして展開する。

3. ［Set the computer name of the instance］および［Reboot after setting computer name］をチェックして適用する。

（Linux 7.3以前の場合だけ）cloud.cfgファイルを編集する。

/etc/cloud/cloud.cfgファイルに次の行を追加する。

preserve_hostname: true

また，オートスケール機能と連携して運用する場合のセットアップ手順の実施に合わせて，運用に必要な設定をしてください。一例を次に示します。

ログファイルトラップを設定する。

ログファイルに出力される障害メッセージなどをJP1イベントに変換してマネージャーホストに転送することで，マネージャーホストで回復処理などを実施できます。

JP1イベントの転送設定を変更する

マネージャーホストへのイベント転送設定は，転送設定ファイル（forward）の初期設定で，次に示す内容が設定されています。転送したい重要なイベントがある場合は変更してください。

to-upper
E.SEVERITY IN Warning Error Critical Alert Emergency Emergence
end-to

付録L.7　Amazon EC2サービスの設定

Amazon EC2サービスに必要となる設定手順を次に示します。

この手順は［AWSマネジメントコンソール］上で実施してください。［AWSマネジメントコンソール］の詳細な説明や操作方法については，Amazon Web Servicesの公式サイトを参照してください。

エージェントホストの仮想マシンイメージを作成する。

「付録L.6　オートスケール機能と連携して運用する場合のセットアップ手順（エージェントホスト）」でセットアップしたエージェントホストの仮想マシンイメージ（AMI）を作成してください。イメージの作成方法については，Amazon Web Servicesの公式サイトを参照してください。

オートスケールの起動設定または起動テンプレートを作成する。

スケールアウトによる仮想マシンの起動時に，オートスケール連携スクリプト（jbsas_setup_agent）を実行するための設定が必要となります。次に示す手順に従い，設定しください。

・起動設定の場合

1. ［AWS マネジメントコンソール］から［Amazon EC2］コンソールを開く。

2. 左側ナビゲーションペインの［Auto Scaling］で［起動設定］をクリックする。

3. ［起動設定の作成］をクリックする。

4. ［AMIの選択］画面から，手順1で作成した仮想マシンイメージ（AMI）を選択する。

5. ［詳細設定］画面の［高度な詳細］-［ユーザーデータ］で［テキストで］を選択して，テキストボックスに次の内容を記述する。

・起動テンプレートの場合

1. ［AWS マネジメントコンソール］から［Amazon EC2］コンソールを開く。

2. 左側ナビゲーションペインの［インスタンス］で［起動テンプレート］をクリックする。

3. ［起動テンプレートを作成］をクリックする。

4. ［AMIの選択］画面から，手順1で作成した仮想マシンイメージ（AMI）を選択する。

5. ［高度な詳細］画面の［ユーザーデータ］のテキストボックスに次の内容を記述する。

ユーザーデータに入力する内容

Windowsの場合

<script>
powershell -ExecutionPolicy RemoteSigned "&'インストール先フォルダ¥tools¥cloud¥jbsas_setup_agent.ps1'"
</script>

Linuxの場合※

#!/bin/sh
/bin/hostnamectl set-hostname `/bin/hostname | /bin/sed -e 's/¥..*//'`
/bin/sh /opt/jp1base/tools/cloud/jbsas_setup_agent.sh

注※　Linuxの場合の2行目のコマンドラインは，ホスト名がFQDN形式の場合，ドメイン名を省略したショート名に変更する処理です。JP1/PFMを使用しない場合，かつFQDN形式のホスト名で運用する場合，記述は不要です。

6. 画面の指示に従い，設定を完了する。

Auto Scalingグループを作成する。

手順2で作成した起動設定または起動テンプレートを使用して，オートスケールの動作を制御するAuto Scalingグループを作成してください。Auto Scalingグループの作成方法の詳細については，Amazon Web Servicesの公式サイトを参照してください。

付録L.8　オートスケール連携スクリプト

JP1/Baseではオートスケール機能と連携した運用に必要となる設定や操作をバッチ処理としてまとめたスクリプト（オートスケール連携スクリプト）を提供しています。

(1)　ファイル構成

オートスケール連携スクリプトは，マネージャーまたはエージェントで実行する「スクリプトファイル」，スクリプトの実行に必要な変数を定義した「スクリプト定義ファイル」，スクリプトが内部処理で使用する「内部ファイル」で構成されます。

なお，スクリプトファイルは，Windowsの場合PowerShellスクリプト，Linuxの場合シェルスクリプトです。

表L‒3　スクリプトファイル

スクリプトファイル名

適用ホスト

説明

Windowsの場合

jbsas_setup_agent.ps1

jbsas_setup_agent.ps1.model

Linuxの場合

jbsas_setup_agent.sh

jbsas_setup_agent.sh.model

エージェント

スケールアウト時にエージェントホストで実行するスクリプトとそのモデルファイルです。エージェントの初期セットアップを実施して，マネージャーにJP1イベントでスケールアウトを通知します。

Windowsの場合

jbsas_add_agent_cli.ps1

jbsas_add_agent_cli.ps1.model

Linuxの場合

jbsas_add_agent_cli.sh

jbsas_add_agent_cli.sh.model

マネージャー

スケールアウト時にマネージャーホストで実行するスクリプトとそのモデルファイルです。追加されたホストをマネージャーの監視対象に追加します。

Windowsの場合

jbsas_add_agent.ps1

jbsas_add_agent.ps1.model

Linuxの場合

jbsas_add_agent.sh

jbsas_add_agent.sh.model

マネージャー

互換用のAmazon EC2 API Toolsを使用する場合に，スケールアウト時にマネージャーホストで実行するスクリプトとそのモデルファイルです。追加されたホストをマネージャーの監視対象に追加します。

Windowsの場合

jbsas_del_agent_cli.ps1

jbsas_del_agent_cli.ps1.model

Linuxの場合

jbsas_del_agent_cli.sh

jbsas_del_agent_cli.sh.model

マネージャー

スケールイン時にマネージャーホストで実行するスクリプトとそのモデルファイルです。削除されたホストを，マネージャーの監視対象から削除します。

Windowsの場合

jbsas_del_agent.ps1

jbsas_del_agent.ps1.model

Linuxの場合

jbsas_del_agent.sh

jbsas_del_agent.sh.model

マネージャー

互換用のAmazon EC2 API Toolsを使用する場合に，スケールイン時にマネージャーホストで実行するスクリプトとそのモデルファイルです。削除されたホストを，マネージャーの監視対象から削除します。

表L‒4　スクリプト定義ファイル

定義ファイル名

適用ホスト

説明

jbsas_setup_agent.ini

jbsas_setup_agent.ini.model

エージェント

エージェントホストが実行するスクリプトファイル（jbsas_setup_agent）が使用するシェル変数を定義したファイルとそのモデルファイルです。

jbsas_setup_manager_cli.ini

jbsas_setup_manager_cli.ini.model

マネージャー

マネージャーホストが実行するスクリプトファイル（jbsas_add_agent_cliまたはjbsas_del_agent_cli）が使用するシェル変数を定義したファイルとそのモデルファイルです。

jbsas_setup_manager.ini

jbsas_setup_manager.ini.model

マネージャー

互換用のAmazon EC2 API Toolsを使用する場合に，マネージャーホストが実行するスクリプトファイル（jbsas_add_agentまたはjbsas_del_agent）が使用するシェル変数を定義したファイルとそのモデルファイルです。

表L‒5　内部ファイル

ファイル名

適用ホスト

説明

Windowsの場合

jbsas_util.ps1

jbsas_util.ps1.model

Linuxの場合

jbsas_util.sh

jbsas_util.sh.model

共通（マネージャーおよびエージェント）

スクリプトファイルが内部処理で使用する関数をまとめたファイルとそのモデルファイルです。

jbsas_hosts

マネージャー

監視中のエージェントホストの情報を管理するためのファイルです。

(2)　格納先ディレクトリ

オートスケール連携スクリプトのファイルはすべて次のディレクトリに格納されます。

Windowsの場合

インストール先フォルダ¥tools¥cloud¥

Linuxの場合

/opt/jp1base/tools/cloud/

(3)　スクリプトファイル

スクリプトファイルの処理内容については，「付録L.3　スケールアウト時に監視対象に追加する」および「付録L.4　スケールイン時に監視を解除する」を参照してください。

スクリプトファイルは編集する必要はありません。任意にカスタマイズすることもできますが，追加・変更した処理部分に関しては，サポートサービスの対象外となるため注意してください。

JP1/Base 11-00から上書きインストールした場合，スクリプトファイル（jbsas_add_agent.ps1など）は上書きされません。モデルファイル（jbsas_add_agent.ps1.modelなど）をスクリプトファイル名でコピーして置き換えて使用してください。

(4)　スクリプト定義ファイル

形式

変数名1=変数値1
[変数名2=変数値2]
：

記述内容

変数名，変数値，および「=」の前後にスペースおよびタブを入れないでください。

Linuxの場合，変数値に空白を含む場合は「"」で囲んでください。

定義の反映時期

スクリプトファイル実行時に読み込まれます。

設定パラメーター

jbsas_setup_agent.iniファイルおよびjbsas_setup_manager.iniファイルで設定するパラメーターについて，次の表に示します。

表L‒6　jbsas_setup_agent.iniファイルの設定パラメーター

変数名

変数値（既定値）

設定要否

説明

ManagerHostName

Manager

○

マネージャーホスト名を指定します。

ホスト名に使用できる文字および文字数については，関連製品（JP1/IMまたはJP1/PFM）のマニュアルを参照してください。

JP1EventID

1011

△

マネージャーに送信するJP1イベントのイベントIDを指定します。

指定できる範囲は，0〜1FFF，7FFF8000〜7FFFFFFFです。

JP1EventMsg

Windowsの場合

Agent host ($AgentHostName) has scale-out.

Linuxの場合

"Agent host ($AgentHostName) has scale-out."

△

マネージャーに送信するJP1イベントのメッセージを指定します。

メッセージは，1,023バイト以内の文字列で指定してください。

既定値の$AgentHostNameにはエージェントホスト名が出力されます。

（凡例）

○：設定が必須のパラメーター

△：必要に応じて設定を変更するパラメーター

表L‒7　jbsas_setup_manager_cli.iniファイルの設定パラメーター

変数名

変数値（既定値）

設定要否

説明

JbsrtDistribByScaleIn

NO

△

スケールイン時に構成定義情報を更新するかどうかを指定します。

YESを指定した場合

構成定義ファイルから対象ホストを削除して，構成定義を配布します。対象ホストはすぐに構成定義情報の下位ホストから削除されます。

なお，通信の遅延によって監視が大幅に遅れるおそれがあるため，運用上の特別な理由がないかぎり，YESは指定しないでください。YESを指定する場合は，目安としてスケールインの対象となるホスト数が1時間当たり20台以下になるよう運用してください。

NOを指定した場合

処理性能を優先した指定です。構成定義ファイルから対象ホストを削除して，構成定義は配布しません。次回スケールアウト時に構成定義情報が更新されます。

JP1PFMAgentAlarmTableList_W

"PFM Windows Template Alarms [CPU] 09.00","PFM Windows Template Alarms [MEM] 09.00","PFM Windows Template Alarms [DSK] 09.00"

△

エージェントにバインドするWindows用のアラームテーブル名です。

複数指定する場合は，コンマ区切りで指定してください。

JP1PFMAgentAlarmTableList_L

"PFM UNIX Template Alarms [CPU] 09.00","PFM UNIX Template Alarms [MEM] 09.00","PFM UNIX Template Alarms [DSK] 09.00"

△

エージェントにバインドするLinux用のアラームテーブル名です。

複数指定する場合は，コンマ区切りで指定してください。

EC2_HOMEPath※

指定なし

○

AWS CLIのインストール先パスを指定します。

EC2_URL※

指定なし

○

AWSのリージョンのURLを指定します。

AWS_ACCESS_KEY※

指定なし

○

AWSのアクセスキー文字列を指定します。

AWS_SECRET_KEY※

指定なし

○

AWSのシークレットアクセスキー文字列を指定します。

（凡例）

○：設定が必須のパラメーター

△：必要に応じて設定を変更するパラメーター

注※　AWS CLIのツール実行環境の設定に必要な環境変数です。設定値の詳細については，Amazon Web Servicesの公式サイトを参照してください。

表L‒8　jbsas_setup_manager.iniファイルの設定パラメーター

変数名

変数値（既定値）

設定要否

説明

JbsrtDistribByScaleIn

NO

△

スケールイン時に構成定義情報を更新するかどうかを指定します。

YESを指定した場合

構成定義ファイルから対象ホストを削除して，構成定義を配布します。対象ホストはすぐに構成定義情報の下位ホストから削除されます。

なお，通信の遅延によって監視が大幅に遅れるおそれがあるため，運用上の特別な理由がないかぎり，YESは指定しないでください。YESを指定する場合は，目安としてスケールインの対象となるホスト数が1時間当たり20台以下になるよう運用してください。

NOを指定した場合

処理性能を優先した指定です。構成定義ファイルから対象ホストを削除して，構成定義は配布しません。次回スケールアウト時に構成定義情報が更新されます。

JP1PFMAgentAlarmTableList_W

"PFM Windows Template Alarms [CPU] 09.00","PFM Windows Template Alarms [MEM] 09.00","PFM Windows Template Alarms [DSK] 09.00"

△

エージェントにバインドするWindows用のアラームテーブル名です。

複数指定する場合は，コンマ区切りで指定してください。

JP1PFMAgentAlarmTableList_L

"PFM UNIX Template Alarms [CPU] 09.00","PFM UNIX Template Alarms [MEM] 09.00","PFM UNIX Template Alarms [DSK] 09.00"

△

エージェントにバインドするLinux用のアラームテーブル名です。

複数指定する場合は，コンマ区切りで指定してください。

EC2_HOMEPath※

指定なし

○

Amazon EC2 API Toolsのインストール先パスを指定します。

JAVA_HOMEPath※

指定なし

○

Java（JRE）のインストール先パスを指定します。

EC2_URL※

指定なし

○

AWSのリージョンのURLを指定します。

AWS_ACCESS_KEY※

指定なし

○

AWSのアクセスキー文字列を指定します。

AWS_SECRET_KEY※

指定なし

○

AWSのシークレットアクセスキー文字列を指定します。

（凡例）

○：設定が必須のパラメーター

△：必要に応じて設定を変更するパラメーター

注※　Amazon EC2 API Toolsのツール実行環境の設定に必要な環境変数です。設定値の詳細については，Amazon Web Servicesの公式サイトを参照してください。

付録L.9　監視設定および解除の処理時間

マネージャーホストでスケールアウトを検知して監視が設定される時間と，スケールインを検知して監視が解除される時間の目安を次に示します。

(1)　スケールアウトによる監視設定時間

スケールアウトされたエージェントホストがマネージャーホストからの監視が設定される時間は，次の表に示す計算式から求めた処理時間が目安になります。

OS

監視設定の処理時間

Windows

（（スケールアウト前の構成管理台数+スケールアウト後の構成管理台数）/2）×（15秒/100台）×スケールアウト台数

Linux

（（スケールアウト前の構成管理台数+スケールアウト後の構成管理台数）/2）×（5秒/100台）×スケールアウト台数

注意事項

大規模な構成管理台数（600台以上）が組まれている環境では，スケールアウトおよびスケールインの対象となる台数は1時間当たり20台以下で運用することを推奨します。

(2)　スケールインによる監視解除時間

スケールインされたエージェントホストがマネージャーホストからの監視が解除される時間は，次の表に示す計算式から求めた処理時間が目安になります。ただし，この処理時間は，設定パラメーター（JbsrtDistribByScaleIn）にNO（既定値）が設定されていた場合です。

OS

監視解除の処理時間

JP1/PFMを使用している場合

JP1/PFMを使用していない場合

Windows

（1台当たり約35秒）×スケールイン台数

（1台当たり約6秒）×スケールイン台数

Linux

（1台当たり約30秒）×スケールイン台数

（1台当たり約5秒）×スケールイン台数

付録L.10　オートスケール機能と連携して運用する場合の注意事項

オートスケール機能と連携した運用を開始する前からマネージャーホストの監視対象であるホストは，スケールイン時の監視解除の対象になりません。マネージャーホストのスクリプトを実行して監視を開始したホストだけが対象になります。

オートスケール機能と連携した運用中は，マネージャーホスト上の次に示すファイルを手動で編集しないでください。編集した場合には，動作を保証できません。

ヘルスチェック定義ファイル（jbshc.conf）

構成定義ファイル（jbs_route.conf）

エージェント管理情報ファイル（jbsas_hosts）

OSのhostsファイル

メンテナンスなどの理由でこれらのファイルを編集する必要がある場合は，オートスケール機能を一時停止するか，JP1製品サービスを停止して運用を中断してください。ただし，オートスケール機能と連携するための監視設定機能で追加されたホスト名の定義は編集しないでください。

スケールインの監視解除時，エージェントホストの状態によっては監視が解除されないで正常終了する場合があります。監視が解除されないことでヘルスチェック定義ファイルの他ホスト監視数が2,500を超えた場合は，定義エラーになりKAVA7052-Wメッセージが出力されます。そのため，AWSでオートスケール対象であるホスト名とヘルスチェック定義ファイルを比較して，監視が不要となったホスト名の定義が残っていないか確認してください。

スケールインで監視が解除されないで各定義ファイルに不要となったホスト名の定義が残っている場合は，次に示す形式でスクリプトを実行して，エージェントホストの監視を解除してください。

Windowsの場合（PowerShellで実行）

インストール先フォルダ¥tools¥cloud¥jbsas_del_agent_cli.ps1 監視を解除するエージェントホスト名
互換用のAmazon EC2 API Toolsを使用する場合
インストール先フォルダ¥tools¥cloud¥jbsas_del_agent.ps1 監視を解除するエージェントホスト名

Linuxの場合

/opt/jp1base/tools/cloud/jbsas_del_agent_cli.sh 監視を解除するエージェントホスト名
互換用のAmazon EC2 API Toolsを使用する場合
/opt/jp1base/tools/cloud/jbsas_del_agent.sh 監視を解除するエージェントホスト名

付録M　Docker，Podmanに関する注意事項（Linux限定）

付録M.1　Dockerイメージの作成について

JP1/BaseをDockerイメージに取り込む手順を次に示します。

製品媒体の内容をあらかじめDockerfile格納ディレクトリにコピーする。

なお，コピーしたファイル群はコンペア等（バイナリレベル）で一致することを確認してください。

# mount /dev/cdrom ホスト上のマウントディレクトリ
# cp -a ホスト上のマウントディレクトリ Dockerfile格納ディレクトリ

以降のDockerfileの例では，「Dockerfile格納ディレクトリ/media」内に製品媒体をコピーしています。

ローカルyumレポジトリサーバを設定しているシステムの場合は，Dockerfile格納ディレクトリ内にレポジトリファイルを作成する。

Dockerイメージを作成するためのDockerfileを作成する。

サンプルを以下に示します。なお，Dockerfileの書式の詳細についてはDocker社のDockerfile referenceまたはman dockerfileを参照してください。

FROM rhel7.1:latest ※1
MAINTAINER 作成者 メールアドレス ※2
COPY local.repo /etc/yum.repos.d/ ※3
RUN yum -y install glibc.i686 libstdc++.i686 ncompress ncursespsmisc glibc-devel glibc-devel.i686 ※4
RUN yum -y install tar iputils net-tools procps-ng hostname ※5
RUN localedef -i ja_JP -f UTF-8 ja_JP.utf8 ※6
RUN mkdir /var/tmp/JP1 ※7
COPY media /var/tmp/JP1 ※8
WORKDIR /var/tmp/JP1 ※9
RUN export LANG=ja_JP.utf8 && ./LINUX/setup -f -k 形名 ./ ※10
...
RUN rm -rf /var/tmp/JP1 ※11

注※1

ベースとなるDockerのイメージを指定します。":latest"は最新のイメージを指定しています。

注※2

イメージの管理者として作成者の氏名や連絡用のメールアドレスを指定します。省略可能です。

注※3

事前に作成しておいたレポジトリファイルをコンテナ内にコピーすることを指定します。

注※4

本製品の前提パッケージを事前にインストールすることを指定します。

注※5

Linux 7のDockerイメージをベースイメージとする場合に，デフォルトでインストールされていないコマンド（tar, ps, hostname, netstat, ping）をインストールします。

注※6

ロケールを追加します。（上記例ではUTF-8を追加）

注※7

コンテナ内にワークディレクトリを作成します。

注※8

あらかじめDockerfile格納ディレクトリにコピーしておいた製品媒体の内容を，コンテナ上の/var/tmp/JP1にコピーすることを指定します。

注※9

カレントディレクトリをコンテナ上の/var/tmp/JP1に位置づけすることを指定します。

注※10

言語に合わせたLANG環境変数を設定後，Hitachi PP Installerのサイレントインストール機能を使用してコンテナ上にインストールすることを指定します。（上記例ではUTF-8を設定）

LANG環境変数を指定しない場合はCを仮定してインストール時のセットアップが行われます。

注※11

コンテナ上のワークディレクトリを削除することを指定します。

docker buildコマンドで手順3で作成したDockerfileを指定し，Dockerイメージを作成する。

# docker build -t Dockerイメージ名 Dockerfile格納ディレクトリ

手順3のDockerfile記載例では，このコマンドを実行する際，Dockerfile格納ディレクトリをカレントディレクトリとする必要があります。

付録M.2　コンテナにJP1/Baseを導入する場合の注意事項

DockerコンテナにJP1/Baseを導入し，Dockerホストまたは他のホストと連携する場合には，次の前提条件と，設定手順が必須となります。

なお，Dockerが導入されているホストをDockerホスト，Dockerが提供するコンテナをコンテナと呼びます。

(1)　前提条件

JP1/Baseを導入したコンテナをコンテナ間以外で連携する場合は，両方向から問題なくTCP/IP通信ができるよう設定してください。例として次の方法を示します。

(a)　ポートフォワーディング機能を使用した方法

コンテナごとに，連携するホストと通信できるIPアドレスを静的に付与

JP1/Baseを導入したコンテナをコンテナ間以外で連携する場合は，コンテナごとに対応するIPアドレスを，Dockerホストに静的に割り当ててください。

明示的にIPアドレスを指定したDockerコンテナへのポートフォワーディング設定

コンテナをコンテナ間以外で連携する場合は，1.で割り当てたIPアドレスに対して，Dockerホスト側のJP1/Baseが使用するポート番号から，コンテナ側のJP1/Baseが使用するポート番号へのポートフォワーディングの設定が必須となります。

JP1/Baseの使用するポートについては，「付録C　ポート番号一覧」を参照してください。

# docker run -p 外部IPアドレス:外部IPアドレス上のJP1/Baseが使用するポート:コンテナ上のJP1/Baseが使用するポート ...

-p：コンテナ内のJP1/Baseのポートを，外部から通信可能なIPアドレス上のポートにマップします。

# docker run --privileged -p xxx.xxx.xxx.xxx:20098:20098
  -p xxx.xxx.xxx.xxx:20099:20099 -p xxx.xxx.xxx.xxx:20237:20237
  -p xxx.xxx.xxx.xxx:20238:20238 -p xxx.xxx.xxx.xxx:20239:20239
  -p xxx.xxx.xxx.xxx:20240:20240 -p xxx.xxx.xxx.xxx:20306:20306
  -p xxx.xxx.xxx.xxx:20600:20600 --name コンテナ名 --hostname ホスト名 -id ベースイメージ名:タグ名

なお，xxx.xxx.xxx.xxxは1.でDockerホストに静的に割り当てたIPアドレスです。

各オプションの詳細についてはDocker社サイト掲載のリリースノートを参照してください。

コンテナを特権モードで起動

JP1/Baseの一部のコマンドで，特権モードでのコンテナ起動が必須となります。JP1/Baseを導入するコンテナは特権モード（--privileged）で起動してください。設定例は2.を参照してください。

コンテナからの転送されたJP1イベントについて

コンテナに導入されたJP1/Baseから，他のホストにJP1イベントを転送する場合，転送されたJP1イベントの「発行元IPアドレス」に1.および2.で設定されたIPアドレスが設定されません。そのため，転送先ホストでは，コンテナから転送されたイベントの「発行元IPアドレス」を使用した運用は避けてください。

(b)　Dockerホスト上でmacvlanブリッジを使用する方法

コンテナを特権モードで起動

JP1/Baseの一部のコマンドで，特権モードでのコンテナ起動が必須となります。JP1/Baseを導入するコンテナは特権モード（--privileged）で起動してください。設定例を次に示します。

# docker run --privileged --name コンテナ名 --hostname ホスト名 -id ベースイメージ名:タグ名

Dockerホストでmacvlanを設定し，VNICを作成する。

# ip link add link 外部へ接続するIPアドレスが設定されているIF name VNIC名 type macvlan mode private

DockerホストでVNICをコンテナに割り当てる。

# ID=コンテナID
# ip link set VNIC名 netns $(docker inspect --format "{{.State.Pid}}" $ID)

Dockerホストからコンテナを操作し，割り当てられたVNICにIPアドレスを付与する。

# docker exec $ID yum install -y iproute libmnl libnfnetlink libnetfilter_conntrack iptables
# docker exec $ID ip addr add dev VNIC名 付与するIPアドレス/ネットマスク
# docker exec $ID ip link set VNIC名 up

各IPアドレス設定コマンドをインストール済みの場合は不要です。

コンテナからの転送されたJP1イベントについて

コンテナに導入されたJP1/Baseから，他のホストにJP1イベントを転送する場合，転送されたJP1イベントの「発行元IPアドレス」に1.および2.で設定されたIPアドレスが設定されません。そのため，転送先ホストでは，コンテナから転送されたイベントの「発行元IPアドレス」を使用した運用は避けてください。

(2)　設定手順

コンテナ内のJP1/Baseの認証サーバーを再設定する。

DockerfileでJP1/Baseをインストールする場合，インストール時（Dockerイメージ作成時）とコンテナ起動時でホスト名が異なることで，インストール時に設定されるプライマリー認証サーバー名が，コンテナ起動時の物理ホスト名と異なる状態となります。そのため，認証サーバーをコンテナ内で使用する場合は，コンテナ起動時のホスト名を再度設定する必要があります。

次のコマンドラインの実行が必須です。

# /opt/jp1base/bin/jbssetusrsrv `hostname`

コンテナ内のJP1/Baseで，連携するホストをJP1hosts2に設定する。

コンテナ内のhostsファイルは，起動（start）・停止（stop）のたびにオーバーライトされ，他のホストの記載が消えてしまいます。そのため，連携するホスト情報はjp1hosts2に設定してください。

連携するホストで，コンテナのホスト名から手順1および手順2によって設定されたコンテナに対応するIPアドレスを名前解決できるよう設定する。

Dockerコンテナが外部からの要求を受け付ける場合，コンテナに対応するIPアドレスで待ち受けます。そのため，連携するホスト側では，コンテナのホスト名からコンテナに対応するIPアドレスを名前解決できるよう設定してください。

コンテナの起動について

Dockerコンテナ起動時にJP1/Baseのサービス自動起動機能は使用できません。コンテナ起動後に，JP1/Baseの起動コマンドからJP1/Baseのサービスを起動してください。もしくは，Dockerコンテナ起動時に実行するコマンドをシェルにして，そのシェルからJP1/Baseの起動コマンドを実行するなどを検討してください。

JP1/Baseの起動コマンドについては，「7.2　JP1/Baseを起動および終了する（UNIXの場合）」を参照してください。

コンテナの停止について

JP1/Baseの終了コマンドからJP1/Baseのサービスを停止後，コンテナを停止してください。

JP1/Baseの終了コマンドについては，「7.2　JP1/Baseを起動および終了する（UNIXの場合）」を参照してください。

コンテナ同士の連携について

コンテナ同士を連携する場合には，コンテナ・リンク機能（--link）を使用してください。詳細はDocker社のDocker Engine referenceを参照してください。

付録M.3　Dockerホスト，コンテナにJP1/Baseを導入する場合の注意事項

Dockerホスト，コンテナにJP1/Baseを導入する場合には次の設定が必要です。

Dockerホストに導入したJP1/Baseにphysical_ipip.confの適用

Dockerホストとコンテナ両方にJP1/Baseを導入する場合，DockerホストでJP1/Baseをインストールした後，physical_ipip.confをjbssetcnfコマンドで適用してから起動してください。

# /opt/jp1base/bin/jbssetcnf /etc/opt/jp1base/conf/physical_ipip.conf

付録M.4　Podmanイメージの作成について

Red Hat Enterprise Linux 8以降は，DockerコマンドとDockerエンジンが非サポートとなりますので，Dockerの代わりに提供されるPodmanにJP1/Baseを取り込む手順を次に示します。

製品媒体の内容をあらかじめDockerfile※格納ディレクトリにコピーする。

なお，コピーしたファイル群はコンペア等（バイナリレベル）で一致することを確認してください。

# mount /dev/cdrom ホスト上のマウントディレクトリ
# cp -a ホスト上のマウントディレクトリ Dockerfile格納ディレクトリ

注※

PodmanもDockerfileを使用して，イメージを作成することができます。

以降のDockerfileの例では，「Dockerfile格納ディレクトリ/media」内に製品媒体をコピーしています。

ローカルyumレポジトリサーバを設定しているシステムの場合は，Dockerfile格納ディレクトリ内にレポジトリファイルを作成する。

Podmanイメージを作成するためのDockerfileを作成する。

サンプルを以下に示します。なお，Dockerfileの書式の詳細についてはDocker社のDockerfile referenceまたはman dockerfileを参照してください。

FROM rhel8.1:latest ※1
MAINTAINER 作成者 メールアドレス ※2
COPY local.repo /etc/yum.repos.d/ ※3
RUN yum -y install glibc.i686 libstdc++.i686 libnsl.i686 ncompress ncurses psmisc glibc-devel glibc-devel.i686 ※4
RUN yum -y install tar iputils net-tools procps-ng hostname ※5
RUN localedef -i ja_JP -f UTF-8 ja_JP.utf8 ※6
RUN mkdir /var/tmp/JP1 ※7
COPY media /var/tmp/JP1 ※8
WORKDIR /var/tmp/JP1 ※9
RUN export LANG=ja_JP.utf8 && ./LINUX/setup -f -k 形名 ./ ※10
...
RUN rm -rf /var/tmp/JP1 ※11

注※1

ベースとなるPodmanのイメージを指定します。":latest"は最新のイメージを指定しています。

注※2

イメージの管理者として作成者の氏名や連絡用のメールアドレスを指定します。省略可能です。

注※3

事前に作成しておいたレポジトリファイルをコンテナ内にコピーすることを指定します。

注※4

本製品の前提パッケージを事前にインストールすることを指定します。

注※5

Linux 8のPodmanイメージをベースイメージとする場合に，デフォルトでインストールされていないコマンド（tar, ps, hostname, netstat, ping）をインストールします。

注※6

ロケールを追加します。（上記例ではUTF-8を追加）

注※7

コンテナ内にワークディレクトリを作成します。

注※8

あらかじめDockerfile格納ディレクトリにコピーしておいた製品媒体の内容を，コンテナ上の/var/tmp/JP1にコピーすることを指定します。

注※9

カレントディレクトリをコンテナ上の/var/tmp/JP1に位置づけすることを指定します。

注※10

言語に合わせたLANG環境変数を設定後，Hitachi PP Installerのサイレントインストール機能を使用してコンテナ上にインストールすることを指定します。（上記例ではUTF-8を設定）

LANG環境変数を指定しない場合はCを仮定してインストール時のセットアップが行われます。

注※11

コンテナ上のワークディレクトリを削除することを指定します。

podman buildコマンドで手順3で作成したDockerfileを指定し，Podmanイメージを作成する。

# podman build -t Podmanイメージ名 Dockerfile格納ディレクトリ

手順3のDockerfile記載例では，このコマンドを実行する際，Dockerfile格納ディレクトリをカレントディレクトリとする必要があります。

付録M.5　PodmanコンテナにJP1/Baseを導入する場合の注意事項

PodmanコンテナにJP1/Baseを導入し，Podmanホストまたは他のホストと連携する場合には，次の前提条件と，設定手順が必須となります。

なお，Podman が導入されているホストをPodmanホスト，Podmanが提供するコンテナをコンテナと呼びます。

(1)　前提条件

JP1/Baseを導入したコンテナをコンテナ間以外で連携する場合は，両方向から問題なくTCP/IP 通信ができるよう設定してください。例として次の方法を示します。

(a)　ポートフォワーディング機能を使用した方法

コンテナごとに，連携するホストと通信できるIPアドレスを静的に付与

JP1/Baseを導入したコンテナをコンテナ間以外で連携する場合は，コンテナごとに対応するIPアドレスを，Podmanホストに静的に割り当ててください。

明示的にIPアドレスを指定したPodmanコンテナへのポートフォワーディング設定

コンテナをコンテナ間以外で連携する場合は，手順1で割り当てたIPアドレスに対して，Podmanホスト側のJP1/Baseが使用するポート番号から，コンテナ側のJP1/Baseが使用するポート番号へのポートフォワーディングの設定が必須となります。

JP1/Baseの使用するポートについては，「付録C　ポート番号一覧」を参照してください。

# podman run -p 外部IPアドレス:外部IPアドレス上のJP1/Baseが使用するポート:コンテナ上のJP1/Baseが使用するポート ...

-p：コンテナ内のJP1/Baseのポートを，外部から通信可能なIPアドレス上のポートにマップします。

# podman run --privileged -p xxx.xxx.xxx.xxx:20098:20098
  -p xxx.xxx.xxx.xxx:20099:20099 -p xxx.xxx.xxx.xxx:20237:20237
  -p xxx.xxx.xxx.xxx:20238:20238 -p xxx.xxx.xxx.xxx:20239:20239
  -p xxx.xxx.xxx.xxx:20240:20240 -p xxx.xxx.xxx.xxx:20306:20306
  -p xxx.xxx.xxx.xxx:20600:20600 --name コンテナ名 --hostname ホスト名 -id ベースイメージ名:タグ名

なお，xxx.xxx.xxx.xxxは手順1でPodmanホストに静的に割り当てたIPアドレスです。

各オプションの詳細についてはpodman.io掲載のリリースノートを参照してください。

コンテナを特権モードで起動

JP1/Baseの一部のコマンドで，特権モードでのコンテナ起動が必須となります。JP1/Baseを導入するコンテナは特権モード（--privileged）で起動してください。設定例は手順2を参照してください。

コンテナからの転送されたJP1イベントについて

コンテナに導入されたJP1/Baseから，他のホストにJP1イベントを転送する場合，転送されたJP1イベントの「発行元IPアドレス」に手順1および手順2で設定されたIPアドレスが設定されません。そのため，転送先ホストでは，コンテナから転送されたイベントの「発行元IPアドレス」を使用した運用は避けてください。

(b)　Podmanホスト上でmacvlanブリッジを使用する方法

コンテナを特権モードで起動

JP1/Baseの一部のコマンドで，特権モードでのコンテナ起動が必須となります。JP1/Baseを導入するコンテナは特権モード（--privileged）で起動してください。設定例を次に示します。

# podman run --privileged --name コンテナ名 --hostname ホスト名 -id ベースイメージ名:タグ名

Podmanホストでmacvlanを設定し，VNICを作成する。

# ip link add link 外部へ接続するIPアドレスが設定されているIF name VNIC名 type macvlan mode private

PodmanホストでVNICをコンテナに割り当てる。

# ID=コンテナID
# ip link set VNIC名 netns $(podman inspect --format "{{.State.Pid}}" $ID)

Podmanホストからコンテナを操作し，割り当てられたVNICにIPアドレスを付与する。

# podman exec $ID yum install -y iproute libmnl libnfnetlink libnetfilter_conntrack iptables
# podman exec $ID ip addr add dev VNIC名 付与するIPアドレス/ネットマスク
# podman exec $ID ip link set VNIC名 up

各IPアドレス設定コマンドをインストール済みの場合は不要です。

コンテナからの転送されたJP1イベントについて

コンテナに導入されたJP1/Baseから，他のホストにJP1イベントを転送する場合，転送されたJP1イベントの「発行元IPアドレス」に手順1および手順2で設定されたIPアドレスが設定されません。そのため，転送先ホストでは，コンテナから転送されたイベントの「発行元IPアドレス」を使用した運用は避けてください。

(2)　設定手順

コンテナ内のJP1/Baseの認証サーバーを再設定する。

DockerfileでJP1/Baseをインストールする場合，インストール時（Podmanイメージ作成時）とコンテナ起動時でホスト名が異なることで，インストール時に設定されるプライマリー認証サーバー名が，コンテナ起動時の物理ホスト名と異なる状態となります。そのため，認証サーバーをコンテナ内で使用する場合は，コンテナ起動時のホスト名を再度設定する必要があります。

次のコマンドラインの実行が必須です。

# /opt/jp1base/bin/jbssetusrsrv `hostname`

コンテナ内のJP1/Baseで，連携するホストをJP1hosts2に設定する。

コンテナ内のhostsファイルは，起動（start）・停止（stop）のたびにオーバーライトされ，他のホストの記載が消えてしまいます。そのため，連携するホスト情報はjp1hosts2に設定してください。

連携するホストで，コンテナのホスト名から手順1および手順2によって設定されたコンテナに対応するIPアドレスを名前解決できるよう設定する。

Podmanコンテナが外部からの要求を受け付ける場合，コンテナに対応するIPアドレスで待ち受けます。そのため，連携するホスト側では，コンテナのホスト名からコンテナに対応するIPアドレスを名前解決できるよう設定してください。

コンテナの起動について

Podmanコンテナ起動時にJP1/Baseのサービス自動起動機能は使用できません。コンテナ起動後に，JP1/Baseの起動コマンドからJP1/Baseのサービスを起動してください。もしくは，Podmanコンテナ起動時に実行するコマンドをシェルにして，そのシェルからJP1/Baseの起動コマンドを実行するなどを検討してください。

JP1/Baseの起動コマンドについては，「7.2　JP1/Baseを起動および終了する（UNIXの場合）」を参照してください。

コンテナの停止について

JP1/Baseの終了コマンドからJP1/Baseのサービスを停止後，コンテナを停止してください。

JP1/Baseの終了コマンドについては，「7.2　JP1/Baseを起動および終了する（UNIXの場合）」を参照してください。

コンテナ同士の連携について

Podmanでは、コンテナ・リンク機能（--link）は非サポートです。コンテナ同士の連携は，ホスト名とコンテナのIPアドレスをマッピングするよう各コンテナの/etc/hostsファイルを編集してください。

付録M.6　Podmanホスト，コンテナにJP1/Baseを導入する場合の注意事項

Podmanホスト，コンテナにJP1/Baseを導入する場合には次の設定が必要です。

Podmanホストに導入したJP1/Baseにphysical_ipip.confの適用

Podmanホストとコンテナ両方にJP1/Baseを導入する場合，PodmanホストでJP1/Baseをインストールした後，physical_ipip.confをjbssetcnfコマンドで適用してから起動してください。

# /opt/jp1base/bin/jbssetcnf /etc/opt/jp1base/conf/physical_ipip.conf

付録N　各バージョンの変更内容

付録N.1　13-00の変更内容

(1)　資料番号（3021-3-L09）の変更内容

次の適用OSを追加した。

Microsoft(R) Windows Server(R) 2022

Red Hat(R) Enterprise Linux(R) Server 9 (64-bit x86_64)

Oracle Linux(R) Operating System 9

次の適用OSを削除した。

Windows(R) 10 Enterprise 32-bit

Windows(R) 10 Home 32-bit

Windows(R) 10 Pro 32-bit

HP-UX 11i V3 (IPF)

Solaris 11 (SPARC)

Red Hat(R) Enterprise Linux(R) Server 6 (64-bit x86_64)

Oracle Linux(R) Operating System 6 (x64)

CentOS 6 (x64)

CentOS 7

CentOS 8

次の機能を削除した。

JP1/SES互換機能

SNMPトラップ変換機能

これに伴い，上記の機能に関連する項目の説明を削除または変更した。

JP1/Baseをインストールする手順（Windowsの場合）の説明に，JP1/AJSまたはJP1/IMの提供媒体に同梱されたJP1/Baseを選択する手順を追加した。

12-50以前のJP1/Baseに13-00以降のJP1/Baseを上書きインストールする場合の注意事項を追加した。

次の項目に関する説明を追加して，2038年以降も使用する場合の説明を記載した。

Linuxで運用する場合のbig timestampsの有効化

コマンド実行のサービスの起動の抑止

JP1/Baseの起動プロセス定義ファイル

Linuxで使用できる文字コードに英語のUTF-8を追加した。

また，JP1/Baseの定義ファイルに次のファイルを追加した。

文字コードマッピング定義ファイル

言語種別マッピング定義ファイル

これに伴い，バージョンアップインストール後に文字コードと言語種別のマッピング定義を変更するための手順を追加した。

SSL通信で楕円曲線暗号（ECC）を利用できるようにした。

これに伴い，サーバ側のSSL通信環境のセットアップについて，秘密鍵の作成に関する説明を変更した。また，楕円曲線暗号を利用する場合のopensslコマンドの使用例，およびSSL通信定義ファイルでの秘密鍵ファイル名の指定に関する説明を追加した。

イベントフィルターの文法について，条件文の属性名の「B.TIME（登録時刻）」と「B.ARRIVEDTIME（到着時刻）」に対する数値の範囲を変更した。

これに伴い，条件文の比較キーワードの「RANGE」，「TRANGE」，「WITHIN」の説明を変更した。

イベントサーバ設定ファイルの次のパラメーターを，必須パラメーターから選択パラメーターに変更した。

include

optionsのv5-unused

SSL通信定義ファイルで指定できるSSL通信のバージョンにTLS1.3を追加した。

また，ECC形式の暗号スイートの指定に関する説明を追加した。

オートスケール連携で使用するAWS CLI対応のスクリプトを追加した。

(2)　資料番号（3021-3-L10）の変更内容

次の適用OSを追加した。

Microsoft(R) Windows Server(R) 2022

Red Hat(R) Enterprise Linux(R) Server 9 (64-bit x86_64)

Oracle Linux(R) Operating System 9

次の適用OSを削除した。

Windows(R) 10 Enterprise 32-bit

Windows(R) 10 Home 32-bit

Windows(R) 10 Pro 32-bit

HP-UX 11i V3 (IPF)

Solaris 11 (SPARC)

Red Hat(R) Enterprise Linux(R) Server 6 (64-bit x86_64)

Oracle Linux(R) Operating System 6 (x64)

CentOS 6 (x64)

CentOS 7

CentOS 8

次のメッセージを削除した。

KAJP1023-E，KAJP1068-I，KAJP1801-I（Windows），KAJP1801-I（UNIX），KAJP1802-I（Windows），KAJP1802-I（UNIX），KAJP1803-E（Windows），KAJP1803-E（UNIX），KAJP1804-E，KAJP1805-E（Windows），KAJP1805-E（UNIX），KAJP1806-E（Windows），KAJP1806-E（UNIX），KAJP1807-E，KAJP1808-W，KAJP1810-E，KAJP1811-E，KAJP1812-W，KAJP1813-E，KAJP1814-E，KAJP1815-E，KAJP1816-W，KAJP1817-E，KAJP1820-E，KAJP1826-E，KAJP1830-E，KAJP1840-E，KAJP1841-W，KAJP1852-E，KAJP1860-I，KAJP1861-I，KAJP1863-E，KAJP1864-E，KAJP1869-E，KAJP1870-E，KAJP1871-I，KAVA2000-E，KAVA2101-E，KAVA2101-E，KAVA2102-I，KAVA2103-I，KAVA2104-I，KAVA2105-W，KAVA2106-E，KAVA2107-E，KAVA2108-E，KAVA2109-E，KAVA2110-E，KAVA2111-W

次のメッセージについて，対処を変更した。

KAJP1004-E，KAJP1503-W，KAJP1508-E，KAVA1480-W，KAVA6694-W，KAVB2639-W，KAVB3186-W，KAVB3915-E，KNAM1095-W

(3)　資料番号（3021-3-L11）の変更内容

次の適用OSを追加した。

Microsoft(R) Windows Server(R) 2022

Red Hat(R) Enterprise Linux(R) Server 9 (64-bit x86_64)

Oracle Linux(R) Operating System 9

次の適用OSを削除した。

Windows(R) 10 Enterprise 32-bit

Windows(R) 10 Home 32-bit

Windows(R) 10 Pro 32-bit

HP-UX 11i V3 (IPF)

Solaris 11 (SPARC)

Red Hat(R) Enterprise Linux(R) Server 6 (64-bit x86_64)

Oracle Linux(R) Operating System 6 (x64)

CentOS 6 (x64)

CentOS 7

CentOS 8

次の機能を削除した。

JP1/SES互換機能

SNMPトラップ変換機能

次のコンパイラーを追加した。

Visual C++(R) 2019

2038年以降も使用する場合の説明を追加した。

これに伴い，次の項目の説明を変更または追加した。

SAMPLEアプリケーションで開始イベントを発行する場合のコーディング例を変更した。

2038年対応のライブラリーとリンクオプションを追加した。

JevGetArrivedTime()関数，JevGetRegistTime()関数をtime_t型の戻り値を返す関数として使用する場合の説明を追加した。

従来のJevGetArrivedTime()関数，JevGetRegistTime()関数と同等の機能を持つ2038年対応のJevGetArrivedTimeT()関数，JevGetRegistTimeT()関数を追加した。

サンプルソースファイルで扱うイベントの項目から開始時刻を削除した。

サンプルソースファイルsender.cのコーディング内容を変更した。

付録N.2　12-50の変更内容※

注※

バージョン12-50のマニュアル訂正内容を含みます。

(1)　資料番号（3021-3-D65-20）の変更内容

JP1/Baseを前提とした製品がインストールされている状態でJP1/Baseをアンインストールする場合，メッセージを出力しアンインストールを中断するように変更した。また，JP1/Baseのバージョンダウンや修復のためにJP1/Baseだけアンインストールして再インストールする場合に，JP1/Baseだけを強制的にアンインストールする機能および復旧する手順を追加した。

統合トレースログのログファイルサイズ，ログファイル数，およびバッファーファイルサイズを設定できる次のコマンドを追加した。

hntr2utl2（UNIX限定）

hntr2utl2（Windows限定）

次の適用OSを削除した。

Microsoft(R) Windows(R) 7

Windows(R) 8

Windows(R) 8.1

Microsoft(R) Windows Server(R) 2012

Microsoft(R) Windows Server(R) 2012 R2

DHCPの使用に関する説明を追加した。

JP1ユーザーの設定項目「所有する権限」の初期設定値の説明に「JP1_IOTDM_Admin」を追加した。

UNIXで論理ホストを削除する場合の手順の説明を変更した。

クラスタ運用の通信設定の変更（jp1host2情報の場合）について，論理ホストの共通定義の待機系への反映に関する記載を追加した。

hntr2confコマンドの注意事項について，バッファーファイルサイズまたは排他制御種別を変更する場合の説明を変更した。

hntr2utilコマンド（UNIX限定およびWindows限定）とhntr2utl2コマンド（UNIX限定およびWindows限定）の注意事項について，ログの量の計算式，および，バッファーファイルサイズを変更する場合の説明を変更した。

jbsgetcnfコマンド，jbssetcnfコマンドの注意事項を追加した。

イベントフィルターの文法について，条件文の書式に関する注意事項を追加した。

イベントサービストレースログについて，出力されるログの量（参考値）の説明を変更した。

ユーザー権限レベルファイルの注意事項を追加した。

コマンド実行履歴ファイル（ISAM）のACTISAMLOGV8.DRFおよびCMDISAMLOGV8.DRFのファイル切り替え時期の記載内容の一部を変更した。

次のログの最大ディスク占有量を変更した。

イベントサービスメッセージ切り替えログ

インストール時のログプロセス間通信トレースログの製品形名[_{1|2|3|4|5}].LOG

また，次のログの最大ディスク占有量，および，ファイル切り替え時期の記載内容を変更した。

リモート監視ログ（ログファイルトラップ）

リモート監視ログ（イベントログトラップ）

正規表現の指定方法「.*」に関する機能の説明を変更した。

(2)　資料番号（3021-3-D66-20）の変更内容

次のメッセージを追加した。

KAJP1621-E，KAVA1870-E，KAVA1871-E，KAVB3667-E

次の適用OSを削除した。

Microsoft(R) Windows(R) 7

Windows(R) 8

Windows(R) 8.1

Microsoft(R) Windows Server(R) 2012

Microsoft(R) Windows Server(R) 2012 R2

(3)　資料番号（3021-3-D67-20）の変更内容

次の適用OSを削除した。

Microsoft(R) Windows(R) 7

Windows(R) 8

Windows(R) 8.1

Microsoft(R) Windows Server(R) 2012

Microsoft(R) Windows Server(R) 2012 R2

付録N.3　12-10の変更内容

(1)　資料番号（3021-3-D65-10）の変更内容

JP1ユーザー認証のパスワードポリシー（パスワードポリシー定義ファイルで定義）を設定して，セキュリティを強化できるようにした。

マネージャーホストとエージェントホスト間の通信をSSL通信で暗号化できるようにした。また，マネージャーホストとエージェントホスト間の通信をSSL通信による暗号化をするかしないかを設定できるようにした。

また，稼働情報としてSSL通信の設定情報を取得できるようにした。

障害レポートとしてバックアップする場合のバックアップの取得例を追加した。

(2)　資料番号（3021-3-D66-10）の変更内容

次のメッセージを追加した。

KAJP1503-W〜KAJP1510-W，KAVA1896-Q，KAVA1951-Q，KAVA5908-E，KAVA6694-W，KAVA6695-W，KAVA8241-E，KAVA8242-W，KAVA8243-W，KAVB3186-W，KAVB3187-W，KAVB3920-W，KNAM1095-W，KNAM1096-W

次のメッセージについて，出力メッセージ，メッセージの説明，および対処を変更した。

KAVA1586-E，KAVA5033-E，KAVA5049-E，KAVA5133-E，KAVA5233-E，KAVA5333-E，KAVA5433-E

(3)　資料番号（3021-3-D67-10）の変更内容

該当なし

付録N.4　12-00の変更内容

(1)　資料番号（3021-3-D65）の変更内容

次の適用OSを削除した。

Microsoft(R) Windows Server(R) 2008 R2

AIX V6.1

Solaris 10 (SPARC)

Windows版のインストーラーに，64bit版の統合トレース機能（HNTRLib2）を追加した。

次の適用OSを追加した。

Microsoft(R) Windows Server(R) 2019

SUSE Linux(R) Enterprise Server 15

JP1ユーザーのパスワード保管形式の初期設定をハッシュレベル2モードに変更した。

(2)　資料番号（3021-3-D66）の変更内容

次の適用OSを削除した。

Microsoft(R) Windows Server(R) 2008 R2

次のメッセージを追加した。

KAJP1054-E，KAJP1055-E

次の適用OSを追加した。

Microsoft(R) Windows Server(R) 2019

SUSE Linux(R) Enterprise Server 15

(3)　資料番号（3021-3-D67）の変更内容

次の適用OSを削除した。

Microsoft(R) Windows Server(R) 2008 R2

対応するコンパイラーに，Visual C++(R) 2015およびVisual C++(R) 2017を追加した。

次の適用OSを追加した。

Microsoft(R) Windows Server(R) 2019

SUSE Linux(R) Enterprise Server 15

付録N.5　11-50の変更内容

(1)　資料番号（3021-3-A01-20）の変更内容

ユーザー認証で，JP1認証情報（JP1ユーザー認証情報およびJP1操作権限）をディレクトリサーバと連携して管理できるようになった。

構成配布または構成同期を実行する際の通信タイムアウト時間の見直しについての説明を追加した。

ヘルスチェック機能の他ホスト監視を使用して，マネージャーホストから監視できるエージェントホストの台数を2,500台に拡張した。

大規模なシステム（エージェント1,024台以上）でJP1/IM - Managerのリモートコマンドや自動アクションを使用する運用の場合の注意事項を追加した。

コマンド実行履歴ファイルの自動再編成に掛かる時間についての説明を追加・変更した。

jbslistaclコマンドで，DSユーザーおよびDSグループの操作権限を表示できるようになった。

jbsrmaclコマンドで，DSユーザーまたはDSグループから操作権限を削除できるようなった。

jbssetaclコマンドで，DSユーザーおよびDSグループに操作権限を登録できるようになった。

jbsaclreloadコマンドで，DSユーザーのJP1認証情報をディレクトリサーバから再読み込みできるようになった。

DSユーザーを使用する運用の場合の注意事項を追加した。

jbslistuserコマンドで，DSユーザーの一覧を表示できるようになった。

一度に多くのホストに構成定義を配布する場合の注意事項を追加した。

3階層以上のシステム階層構成で運用する場合の注意事項を追加した。

jcocmddefコマンドのレコード数（-recordオプション）の初期値を196,600レコードに拡張した。

jevmessageid.batコマンド実行時に，イベントビューアーを起動している場合の注意事項を追加した。

JP1ユーザーまたはDSグループのJP1資源グループに対する操作権限を定義するファイルを追加した。

共通定義設定用ファイル（構成管理機能）で，構成配布または構成同期を実行する際の通信タイムアウト時間を指定できるようになった。

属性付加設定ファイルに定義する属性付加設定ブロックの総数の推奨値を2,500件以内に拡張した。

ディレクトリサーバ連携定義ファイルおよびディレクトリサーバ変更ファイルのSERVERパラメーターに，ドメイン名も指定できることを明記した。

ディレクトリサーバ連携定義ファイルおよびディレクトリサーバ変更ファイルにAREC_EXCLUSIVEパラメーターを追加した。

コアダンプファイルに関連するABRTの設定（Linux限定）についての注意事項を追加した。

JP1/Baseのファイルおよびフォルダ一覧に，Active Directoryのスキーマ拡張用のモデルファイルを追加した。

JP1/Baseで使用するポート番号に，ディレクトリサーバ連携（DSユーザーを使用する運用の場合）で使用するポート番号を追加した。

オートスケール機能と連携して運用する場合の前提となるシステム構成を，マネージャーホストを含めて2,500台以内に拡張した。

(2)　資料番号（3021-3-A02-20）の変更内容

次のメッセージを追加した。

KAVA1950-E，KAVA3421-W，KAVA3422-E，KAVA6656-E，KAVA8000-I，KAVA8001-W，KAVA8002-E，KAVA8003-E，KAVA8004-I，KAVA8010-E，KAVA8011-W，KAVA8012-W，KAVA8013-W，KAVA8014-W，KAVA8015-W，KAVA8016-W，KAVA8017-W，KAVA8020-W，KAVA8100-W，KAVA8101-W，KAVA8102-W，KAVA8103-W，KAVA8104-W，KAVA8105-W，KAVA8110-E，KAVA8111-W，KAVA8112-W，KAVA8113-W，KAVA8114-W，KAVA8115-E，KAVA8120-E，KAVA8121-W，KAVA8122-W，KAVA8123-W，KAVA8125-E，KAVA8130-E，KAVA8140-E，KAVA8144-W，KAVA8210-E，KAVA8212-E，KAVA8213-E，KAVA8220-E，KAVA8221-E，KAVA8222-E，KAVA8223-E，KAVA8230-E，KAVA8240-E，KAVB3173-W，KAVB3180-W，KAVB3181-W，KAVB3185-I

次のメッセージを変更した。

KAVA1662-E

次のメッセージについて，出力メッセージ，メッセージの説明，および対処を変更した。

KAVA5901-E

次のメッセージについて，対処を変更した。

KAVA6651-E，KAVA6678-E，KAVB2605-E

次のメッセージについて，メッセージの出力行を追加した。また，対処を変更した。

KAVB3118-E，KAVB3119-E

(3)　資料番号（3021-3-A03-20）の変更内容

該当なし

付録N.6　11-10の変更内容

(1)　資料番号（3021-3-A01-10）の変更内容

IM構成管理による定義情報の管理とコマンドによるイベントサービスの定義情報の収集と配布を併用できるようにした。

JP1/Baseの適用OSにMicrosoft(R) Windows Server(R) 2016を追加した。

変更のあるエージェントだけを対象に，構成定義情報を更新できるようにした。

ヘルスチェック機能の他ホスト監視において，1回ごとの監視に掛かった時間をメッセージで出力できるようにした。

ユーザー管理機能に関する初期設定値の，JP1ユーザーが所有する権限に，JP1_Analytics_Adminを追加した。

JP1/Baseの設定情報を一括収集するjbsparamdumpコマンドの収集対象に構成管理機能のセットアップ情報を追加した。

次のコマンドの実行時に実行確認のメッセージを省略できるようにした。また，コマンドの戻り値を拡張できるようにした。

jbsrt_del

jbsrt_distrib

jbsrt_sync

配布および収集対象とするログファイルトラップ動作定義ファイル名に，「インストール先フォルダ¥conf¥」および「/etc/opt/jp1base/conf/」配下の相対パスを指定できるようにした。

Windows環境において，UTF-8のUnicodeで出力されるマルチプロセス対応トレース（HTRACE）形式のログファイルを監視（ログファイルトラップ）できるようにした。

イベントサーバ設定ファイルのoptionsパラメーターにrep-restoreフラグを追加した。

ログファイルトラップ起動定義ファイルのSTART_OPTパラメーターにSKIPオプションを追加した。

次のJP1イベントを追加した。

00001011

資料採取ツールで採取できる情報に次の情報を追加した。

ルーティング情報

ネットワークインターフェースの状態情報

統合トレースログの設定情報（ファイル名，サイズ，数，バッファーファイルのサイズ，および監視周期時間）

-ss napの実行結果（OSがRed Hat(R) Enterprise Linux(R) Server 7，Oracle Linux(R) Operating System 7，CentOS 7，およびSUSE Linux(R) Enterprise Server 12の場合）

クラウドプラットフォーム（Amazon EC2）のオートスケール機能と連携して運用できるようになった。

リモートコマンドログのログサイズを拡張した。

(2)　資料番号（3021-3-A02-10）の変更内容

JP1/Baseの適用OSにMicrosoft(R) Windows Server(R) 2016を追加した。

次のメッセージを追加した。

KAJP1096-I，KAJP1097-I，KAJP1098-E，KAJP1214-E，KAJP1501-I，KAJP1502-W，KAJP1611-I，KAJP1612-I，KAJP1613-E，KAJP1614-E，KAJP1615-E，KAVA1744-E，KAVA1868-E，KAVA3035-W，KAVA3420-I，KAVA3520-I，KAVA7239-I

次のメッセージの出力先を変更した。

KAVA3611-E

次のメッセージを変更した。

KAJP1136-E，KAJP1154-E，KAVA3410-W，KAVA3510-W，KAVA3646-E

(3)　資料番号（3021-3-A03-10）の変更内容

JP1/Baseの適用OSにMicrosoft(R) Windows Server(R) 2016を追加した。

対応するコンパイラーにgcc version 4.4.7を追加した。

付録N.7　11-00の変更内容

(1)　資料番号（3021-3-001-20および3021-3-301-20）からの変更内容

次の適用OSを追加した。

Windows(R) 10

Red Hat(R) Enterprise Linux(R) Server 7 (64-bit x86_64)

SUSE Linux(R) Enterprise Server 12

Oracle Linux(R) Operating System 6 (x64)，Oracle Linux(R) Operating System 7

CentOS 6 (x64)，CentOS 7

次の適用OSを削除した。

Microsoft(R) Windows(R) XP Professional Operating System，Microsoft(R) Windows Server(R) 2003，Microsoft(R) Windows Server(R) 2003 R2，Microsoft(R) Windows Vista(R)，Microsoft(R) Windows Server(R) 2008

Red Hat(R) Enterprise Linux(R) 5

ヘルスチェック機能の他ホスト監視で，監視しきい値と通信タイムアウト時間を指定できるようにした。

ヘルスチェック機能の他ホスト監視に失敗した場合に出力されるメッセージ（KAVA7223-EおよびKAVA7229-W）に，エラーの詳細情報が出力されるようにした。

ヘルスチェック機能が出力するメッセージ中のプロセス名および機能名一覧を追加した。

ログファイルトラップで，2ギガバイト以上のログファイルを監視できるようにした。

イベントログトラップによるJP1イベント変換時に，イベントIDと監視名を指定できるようにした。

JP1イベントに任意の拡張属性を付加できるようにした。

認証サーバ（ユーザー認証）に関連する通信，およびJP1/IMのコマンド実行に関連する通信をSSL通信で暗号化できるようにした。

Windowsのスタートメニューから［プログラム］−［JP1_Base］で表示されるメニュー名称を変更した。

次のコマンドを追加した。

jevextreload

openssl

次に示すコマンドで統合トレースログのバッファーファイルサイズおよび監視周期時間を変更できるようにした。

hntr2conf

hntr2util（UNIX限定）

hntr2util（Windows限定）

jevsenddコマンドの-tオプションの省略時の仮定値を変更した。

次の定義ファイルを追加した。

属性付加設定ファイル

SSL通信定義ファイル

次のパラメーターを追加した。

ヘルスチェック定義ファイルのTHRESHOLDパラメーター，TIMEOUTパラメーター，およびERROR_DETAILパラメーター

次のパラメーターを削除した。

イベントサーバ設定ファイルのlog-levelパラメーター

イベントログトラップ動作定義ファイル（Windows限定）のtrap-intervalパラメーターおよびjp1event-sendパラメーター

SNMPトラップ変換動作定義ファイルのimevt_regkindパラメーター

次のパラメーターの省略時の仮定値を変更した。

ログファイルトラップ動作定義ファイルのretry-timesパラメーター

イベントログトラップ動作定義ファイル（Windows限定）のretry-timesパラメーター

次のログファイルを追加した。

インストール時のログ

次のログファイルのファイルサイズを変更した。

ヘルスチェック機能ログ（自ホスト監視）

ヘルスチェック機能ログ（他ホスト監視）

ヘルスチェックコマンドログ

ヘルスチェックAPI用ログ

ヘルスチェック共有メモリー削除コマンドログ

次のメッセージを追加した。

KAJP6024-I，KAJP6025-I

(2)　資料番号（3021-3-002-20および3021-3-302-20）からの変更内容

次のメッセージを追加した。

KAJP1078-E，KAJP1079-E，KAJP1080-E，KAJP1090-I，KAJP1091-E，KAJP1092-W，KAJP1093-E，KAJP1094-E，KAJP1095-E，KAJP6024-I，KAJP6025-I，KAVA1480-W，KAVA1481-W，KAVA1695-W，KAVA1697-E，KAVA1895-E，KAVA3675-E，KAVA3676-E，KAVA5903-W，KAVA5905-E，KAVA7237-W，KAVA7238-W，KAVB2639-W，KAVB2640-W，KAVB3915-E，KAVB3916-I，KAVB3917-I，KAVB3918-E，KAVB3919-E

次のメッセージを変更した。

KAJP1756-E，KAVA1524-W，KAVA1525-I，KAVA3003-E，KAVA3009-E，KAVA3600-I，KAVA7030-E，KAVA7223-E，KAVA7229-W，KAVB3647-E

(3)　資料番号（3021-3-003-20および3021-3-303-20）からの変更内容

適用OSの変更に伴い，JP1/Baseが提供する関数を使用するためのコンパイラー，OSで必要なライブラリー，コンパイルオプション，およびリンクオプションを変更した。

付録N.8　10-50の変更内容

(1)　資料番号（3021-3-001-20，3021-3-002-20，および3021-3-003-20）の変更内容

次の適用OSを追加した。

Windows(R) 8.1

Microsoft(R) Windows Server(R) 2012 R2

大量発生イベントの転送を抑止するために，次の機能を追加した。

イベント転送抑止コマンド（jevagtfwコマンド）によるイベント転送抑止

しきい値によるイベント転送抑止

ユーザー管理機能に関する初期設定値の，JP1ユーザーが所有する権限に，HNP_Adminを追加した。

自動起動スクリプトの環境変数LANGの言語種別についての記述を追加した。

HP-UX版，Solaris版，およびAIX版のJP1/Baseが動作する言語種別として，日本語UTF-8をサポートした。

ローカルアクションの実行条件で対象となるJP1イベントについての説明を追加した。

jbsgetcnfコマンドで定義情報を採取する際に，コンポーネントを指定できるようにした。

統合トレースログを出力する際に，排他制御をするかどうか指定できるようにした。

jbshostsimportコマンドで，jp1hosts2情報が設定されている環境に対してjp1hosts情報を強制的に登録できるようにした。

また，jp1hosts情報とjp1hosts2情報の両方が設定された場合の動作について記述を追加した。

イベントサービスの通信設定についての注意事項を追加した。

ログファイルトラップを使用して，WindowsでUnicodeファイルを監視する場合の注意事項を追加した。

JP1/Baseの設定情報を一括で収集できるようにした。

jbsmkumapコマンドおよびjbssetumapコマンドで，共通定義情報にユーザーマッピング情報を登録する際の注意事項を追加した。

jbssetcnfコマンドで，JP1/AJSの共通定義情報を変更する際の注意事項を追加した。

Windowsで，Unicode（UTF-8）形式で出力されたログをログファイルトラップで監視できるようにした。

次のJP1イベントを追加した。

00003D05，00003D06，00003D07，00003D08，00003D09，00003D0B，00003D0C，00003D0D，00003D0E

ログファイルトラップが発行するJP1イベントの拡張属性に，監視IDと監視名を追加した。

資料採取ツールで採取できる情報に次の情報を追加した。

ユーザー権利の割り当て

グループポリシー

動的ポートの範囲（IPV4）

動的ポートの範囲（IPV6）

統合トレースログの排他制御種別

統合トレースログの出力先

構成管理ログのファイル数およびファイルサイズを変更した。

通信方式設定ファイルに定義されたパラメーターについての説明を追加した。

JP1/Base 06-51以前の通信方式とJP1/Base 06-71以降の通信方式の違いについての説明を追加した。

クラスタセットアップ時の通信方式についての説明を追加した。

通信接続の制限によって要求が拒否された場合に出力されるメッセージについての説明を追加した。

次のメッセージを追加した。

KAJP1083-W，KAJP1084-I，KAJP1085-I，KAJP1086-W，KAJP1087-W，KAJP1350-I，KAJP1351-I，KAJP1352-E，KAJP1401-I，KAJP1402-E，KAJP1403-E，KAJP1404-I，KAJP1405-I，KAJP1406-E，KAJP1407-E，KAJP1408-I，KAJP1410-I，KAJP1411-E，KAJP1413-I，KAJP1414-I，KAJP1415-E，KAJP1416-I，KAJP1417-I，KAJP1418-I，KAJP1419-I，KAJP1420-I，KAJP1421-I，KAJP1422-I，KAJP1423-E，KAJP1424-I，KAJP1425-E，KAJP1426-I，KAJP1427-I，KAJP1428-I，KAJP1429-I，KAJP1430-I，KAJP1431-I，KAJP1432-E，KAJP1433-I，KAJP1434-E，KAJP1435-E，KNAM9001-I，KNAM9002-I，KNAM9003-E，KNAM9004-E，KNAM9005-E，KNAM9006-E，KNAM9007-E，KNAM9008-E，KNAM9009-E，KNAM9010-E，KNAM9011-W，KNAM9012-I，KNAM9013-E，KNAM9014-E，KNAM9015-W，KNAM9016-W，KNAM9020-I，KNAM9021-E，KNAM9022-I，KNAM9023-E，KNAM9024-I，KNAM9025-E，KNAM9026-I，KNAM9027-E，KNAM9028-W

次のメッセージの説明を変更した。

KAJP1033-E，KAVA0443-E，KAVA0590-E，KAVA0592-E，KAVA0678-E，KAVA0901-E，KAVA0906-E，KAVA3650-I，KAVA6726-E，KAVB2027-E，KAVB3098-E，KAVB3107-E，KNAM3130-E，KNAM3170-E

対応するコンパイラーにVisual C++(R) 2012を追加した。

(2)　資料番号（3021-3-301-20，3021-3-302-20，および3021-3-303-20）の変更内容

適用OSを追加した。

Windows(R) 8.1

Microsoft(R) Windows Server(R) 2012 R2

大量発生イベントの転送を抑止するために，次の機能を追加した。

イベント転送抑止コマンド（jevagtfwコマンド）によるイベント転送抑止

しきい値によるイベント転送抑止

ユーザー管理機能に関する初期設定値の，JP1ユーザーが所有する権限に，HNP_Adminを追加した。

自動起動スクリプトの環境変数LANGの言語種別についての記述を追加した。

HP-UX版，Solaris版，およびAIX版のJP1/Baseが動作する言語種別として，日本語UTF-8をサポートした。

ローカルアクションの実行条件で対象となるJP1イベントについての説明を追加した。

jbsgetcnfコマンドで定義情報を採取する際に，コンポーネントを指定できるようにした。

統合トレースログを出力する際に，排他制御をするかどうか指定できるようにした。

jbshostsimportコマンドで，jp1hosts2情報が設定されている環境に対してjp1hosts情報を強制的に登録できるようにした。

また，jp1hosts情報とjp1hosts2情報の両方が設定された場合の動作について記述を追加した。

イベントサービスの通信設定についての注意事項を追加した。

ログファイルトラップを使用して，WindowsでUnicodeファイルを監視する場合の注意事項を追加した。

JP1/Baseの設定情報を一括で収集できるようにした。

jbsmkumapコマンドおよびjbssetumapコマンドで，共通定義情報にユーザーマッピング情報を登録する際の注意事項を追加した。

jbssetcnfコマンドで，JP1/AJSの共通定義情報を変更する際の注意事項を追加した。

Windowsで，Unicode（UTF-8）形式で出力されたログをログファイルトラップで監視できるようにした。

次のJP1イベントを追加した。

00003D05，00003D06，00003D07，00003D08，00003D09，00003D0B，00003D0C，00003D0D，00003D0E

ログファイルトラップが発行するJP1イベントの拡張属性に，監視IDと監視名を追加した。

資料採取ツールで採取できる情報に次の情報を追加した。

ユーザー権利の割り当て

グループポリシー

動的ポートの範囲（IPV4）

動的ポートの範囲（IPV6）

統合トレースログの排他制御種別

統合トレースログの出力先

構成管理ログのファイル数およびファイルサイズを変更した。

通信方式設定ファイルに定義されたパラメーターについての説明を追加した。

JP1/Base 06-51以前の通信方式とJP1/Base 06-71以降の通信方式の違いについての説明を追加した。

クラスタセットアップ時の通信方式についての説明を追加した。

通信接続の制限によって要求が拒否された場合に出力されるメッセージについての説明を追加した。

次のメッセージを追加した。

KAJP1083-W，KAJP1084-I，KAJP1085-I，KAJP1086-W，KAJP1087-W，KAJP1350-I，KAJP1351-I，KAJP1352-E，KAJP1401-I，KAJP1402-E，KAJP1403-E，KAJP1404-I，KAJP1405-I，KAJP1406-E，KAJP1407-E，KAJP1408-I，KAJP1410-I，KAJP1411-E，KAJP1413-I，KAJP1414-I，KAJP1415-E，KAJP1416-I，KAJP1417-I，KAJP1418-I，KAJP1419-I，KAJP1420-I，KAJP1421-I，KAJP1422-I，KAJP1423-E，KAJP1424-I，KAJP1425-E，KAJP1426-I，KAJP1427-I，KAJP1428-I，KAJP1429-I，KAJP1430-I，KAJP1431-I，KAJP1432-E，KAJP1433-I，KAJP1434-E，KAJP1435-E，KNAM9001-I，KNAM9002-I，KNAM9003-E，KNAM9004-E，KNAM9005-E，KNAM9006-E，KNAM9007-E，KNAM9008-E，KNAM9009-E，KNAM9010-E，KNAM9011-W，KNAM9012-I，KNAM9013-E，KNAM9014-E，KNAM9015-W，KNAM9016-W，KNAM9020-I，KNAM9021-E，KNAM9022-I，KNAM9023-E，KNAM9024-I，KNAM9025-E，KNAM9026-I，KNAM9027-E，KNAM9028-W

次のメッセージの説明を変更した。

KAJP1033-E，KAVA0443-E，KAVA0590-E，KAVA0592-E，KAVA0678-E，KAVA0901-E，KAVA0906-E，KAVA3650-I，KAVA6726-E，KAVB2027-E，KAVB3098-E，KAVB3107-E，KNAM3130-E，KNAM3170-E

対応するコンパイラーにVisual C++(R) 2012を追加した。

付録N.9　10-10の変更内容

(1)　資料番号（3021-3-001-10，3021-3-002-10，および3021-3-003-10）の変更内容

次の適用OSを追加した。

Windows(R) 8，Microsoft(R) Windows Server(R) 2012

Red Hat(R) Enterprise Linux(R) 5 (AMD/Intel 64)，Red Hat(R) Enterprise Linux(R) 5 (x86)

Solaris 11 (SPARC)

ログファイルトラップで監視できないログファイルの形式について説明を追加した。

IM構成管理での張り返し通信方式の設定について，説明を追加した。

ディレクトリサーバと連携してログイン認証する場合に，次の機能を拡張した。

指定したOU配下の階層の，すべてのOU（組織単位）をディレクトリサーバ連携の対象にできるようにした。

JP1ユーザー名として使用する属性名をCN以外も指定できるようにした。

ログファイルトラップで指定するログファイルの形式を確認する方法について説明を追加した。

ディレクトリサーバ連携拡張機能で必要となる情報検索用ユーザーの設定方法や表示形式に関わるコマンド（jbschkds，jbsmkpass，jbspassmgr，jbsrmumappass，jbsumappass）および定義ファイル（パスワード定義ファイル）を変更した。

次のコマンドおよび定義ファイルの注意事項を追加した。

jbsrt_distribコマンド

イベントログトラップ動作定義ファイル（Windows限定）

Unicode形式のイベントログを監視する際に，正規表現のミスマッチングや文字化けを防ぐため，Unicode検索に基づくマッチング方式を設定できるようにして，JP1イベントを登録する際のコードセットをUTF-8にした。

Windowsで，Unicode（UTF-16）形式で出力されたログをログファイルトラップで監視できるようにした。

JP1/Baseを使用したシステムをセキュアに運用するために，意図しないホストからの通信接続を制限できるようにした。

メッセージを追加，変更した。

適応OSにRed Hat(R) Enterprise Linux(R) 5を追加したことに伴い，対応するコンパイラーにgcc version 4.1.2を追加した。

ローカルアクション機能の共通定義設定用ファイルにCODECONVパラメーターを追加した。

(2)　資料番号（3021-3-301-10，3021-3-302-10，および3021-3-303-10）の変更内容

次の適用OSを追加した。

Windows(R) 8，Microsoft(R) Windows Server(R) 2012

Red Hat(R) Enterprise Linux(R) 5 (AMD/Intel 64)，Red Hat(R) Enterprise Linux(R) 5 (x86)

Solaris 11 (SPARC)

ログファイルトラップで監視できないログファイルの形式について説明を追加した。

言語種別の設定に中国語を追加した。

IM構成管理での張り返し通信方式の設定について，説明を追加した。

ディレクトリサーバと連携してログイン認証する場合に，次の機能を拡張した。

指定したOU配下の階層の，すべてのOU（組織単位）をディレクトリサーバ連携の対象にできるようにした。

JP1ユーザー名として使用する属性名をCN以外も指定できるようにした。

ログファイルトラップで指定するログファイルの形式を確認する方法について説明を追加した。

ディレクトリサーバ連携拡張機能で必要となる情報検索用ユーザーの設定方法や表示形式に関わるコマンド（jbschkds，jbsmkpass，jbspassmgr，jbsrmumappass，jbsumappass）および定義ファイル（パスワード定義ファイル）を変更した。

次のコマンドおよび定義ファイルの注意事項を追加した。

jbsrt_distribコマンド

イベントログトラップ動作定義ファイル（Windows限定）

Unicode形式のイベントログを監視する際に，正規表現のミスマッチングや文字化けを防ぐため，Unicode検索に基づくマッチング方式を設定できるようにして，JP1イベントを登録する際のコードセットをUTF-8にした。

Windowsで，Unicode（UTF-16）形式で出力されたログをログファイルトラップで監視できるようにした。

JP1/Baseを使用したシステムをセキュアに運用するために，意図しないホストからの通信接続を制限できるようにした。

メッセージを追加，変更した。

適応OSにRed Hat(R) Enterprise Linux(R) 5を追加したことに伴い，対応するコンパイラーにgcc version 4.1.2を追加した。

ローカルアクション機能の共通定義設定用ファイルにCODECONVパラメーターを追加した。

付録N.10　10-00の変更内容

(1)　資料番号（3021-3-001，3021-3-002，および3021-3-003）の変更内容

次の適用OSを追加した。

Red Hat(R) Enterprise Linux(R) 6 (AMD/Intel 64)，Red Hat(R) Enterprise Linux(R) 6 (x86)

次の適用OSを削除した。

Microsoft(R) Windows Server(R) 2003, Datacenter Edition for Itanium-based Systems，Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium-based Systems，Microsoft(R) Windows Server(R) 2008 for Itanium(R)-based Systems

AIX 5L V5.3

HP-UX 11i V2 (IPF)

Solaris 9 (SPARC)，Solaris 10 (x64)，Solaris 10 (x86)

JP1独自のhosts情報に，jp1hosts2情報を使用できるようにした。

JP1/Baseの通信に，IPv6アドレスを使用できるようにした。

JP1/Base管理者権限で，JP1/Baseを運用できるようにした。

ログファイルトラップで，SEQ3形式とUPD形式のログファイルを監視できるようにした。

HP-UX，Solaris，およびAIXで，UTF-8で出力されたログをログファイルトラップで監視できるようにした。

次のJP1イベントを追加した。

00003A25，00003A26，00003A27，00003A28，00003A29，00003A2A

メッセージを追加，変更した。

(2)　資料番号（3021-3-301，3021-3-302，および3021-3-303）の変更内容

次の適用OSを追加した。

Red Hat(R) Enterprise Linux(R) 6 (AMD/Intel 64)，Red Hat(R) Enterprise Linux(R) 6 (x86)

次の適用OSを削除した。

Microsoft(R) Windows Server(R) 2003, Datacenter Edition for Itanium-based Systems，Microsoft(R) Windows Server(R) 2003, Enterprise Edition for Itanium-based Systems，Microsoft(R) Windows Server(R) 2008 for Itanium(R)-based Systems

AIX 5L V5.3

HP-UX 11i V2 (IPF)

Solaris 9 (SPARC)，Solaris 10 (x64)，Solaris 10 (x86)

JP1独自のhosts情報に，jp1hosts2情報を使用できるようにした。

JP1/Baseの通信に，IPv6アドレスを使用できるようにした。

JP1/Base管理者権限で，JP1/Baseを運用できるようにした。

ログファイルトラップで，SEQ3形式とUPD形式のログファイルを監視できるようにした。

HP-UX，Solaris，およびAIXで，UTF-8で出力されたログをログファイルトラップで監視できるようにした。

次のJP1イベントを追加した。

00003A25，00003A26，00003A27，00003A28，00003A29，00003A2A

メッセージを追加，変更した。

付録N.11　09-50の変更内容

(1)　資料番号（3020-3-R71-30，3020-3-R72-30，および3020-3-R73-30）の変更内容

次の適用OSを追加した。

Microsoft(R) Windows(R) 7

Red Hat(R) Enterprise Linux(R) 5 Advanced Platform (x86)，Red Hat(R) Enterprise Linux(R) 5 Advanced Platform (AMD/Intel 64)，Red Hat(R) Enterprise Linux(R) 5 Advanced Platform (Intel Itanium)

JP1/BaseがISO9001の認証を受けたため記述を追加した。

イベントログトラップ機能で，Microsoft(R) Windows Vista(R)，Microsoft(R) Windows Server(R) 2008，およびMicrosoft(R) Windows Server(R) 2008 R2で追加されたイベント種別に対応した。

コマンドで収集および配布できるイベントサービスの定義情報に，ログファイルトラップ起動定義ファイルを追加した。

複数LAN接続の環境の場合に使用するIPアドレスについて，説明を追加および変更した。

JP1/Baseのインストール先フォルダのデフォルトおよび権限設定について説明を追加した。

ユーザー管理機能に関するデフォルト値の，JP1ユーザーが所有する権限に，JP1_ITSLM_AdminおよびCosminexus_vMNG_Adminを追加した。

パスワードの保護を強化する場合に，パスワードの保管形式を変更する手順を追加した。

共通定義情報を更新する操作を追加した。

イベントサーバ設定ファイル（conf）のportsパラメーターに指定するIPアドレスについての注意事項を追加した。

クラスタソフトにJP1/Baseのサービスを登録するときの注意事項を追加した。

ネットワーク構成に応じて通信設定が必要となる場合について，また，その際に設定する定義ファイルについて，説明を追加および変更した。

jbssetcnfコマンドの実行時に指定する通信方式設定ファイルを変更した。

イベントサービスを停止する場合の注意事項を追加した。

連携するディレクトリサーバを一時的に変更する手順を追加した。

JP1/Baseが動作しているマシンのIPアドレスを変更したときに必要な作業について，手順を変更した。

ログファイルトラップ管理サービス（デーモン）の状態を確認するコマンドを追加した。

jbs_start.clusterコマンドの実行時に出力されるメッセージを抑止する手順を追加した。

次のコマンドの戻り値を訂正した。

jbsadduser，jbschgpasswd，jbslistuser，jevexport，jevlogreload

jevdef_distribコマンドの-sオプションを追加し，ログファイルトラップ起動定義ファイルの定義情報を配布できるようにした。

jevdef_getコマンドの-sオプションを追加し，ログファイルトラップ起動定義ファイルの情報を収集できるようにした。また，-rオプションを追加し，特定のホストから個別に定義情報を収集できるようにした。

jevlogstartコマンドの-xオプションを追加し，ログファイルをJP1イベント化したときの拡張属性JP1_SOURCEHOSTに，ログデータの出力元ホスト名を設定できるようにした。また，-sオプションの指定時に大文字および小文字が区別されることを記載した。

起動順序定義ファイルのパラメーターに，スペースを含むバッチファイル名を指定する場合の注意事項を追加した。

各行の先頭のパラメーター名だけでなく，#（0x23）の前にも空白などが入れられないことを記載した。

イベントサーバ設定ファイルのclient-bindパラメーターに，複数のアドレスが指定されている場合の注意事項を記載した。

ログファイルトラップ動作定義ファイルのACTDEFパラメーターの形式を訂正した。

Microsoft(R) Windows Vista(R)，Microsoft(R) Windows Server(R) 2008，およびMicrosoft(R) Windows Server(R) 2008 R2の場合に，ログの種類を記述するときの注意事項を追加した。

配布定義ファイルにログファイルトラップ起動定義ファイルを追加した。

ディレクトリサーバ連携定義ファイル（Windows限定）の形式を訂正した。

次のJP1イベントを追加した。

00003A30，00003A31，00003A32

JP1イベント「00003A71」のPP名を，リモート監視のイベントログトラップの場合とJP1/Baseのイベントログトラップの場合に分けた。

「動作定義ファイルのACTDEFパラメーターに指定されている値」をIDとするJP1イベントのPP名を，リモート監視のログファイルトラップの場合とJP1/Baseのログファイルトラップの場合に分けた。また，ホスト名を追加した。

インストール時に出力するログファイルを追加した。

ログファイルトラップおよびイベントログトラップのリモート監視ログを追加した。

jbs_killall.clusterコマンドトレースログのファイル名を変更した。

jbscomd_api.exeのプロセス数を訂正した。

UNIXの場合のプロセスにjelallogを追加した。

jp1bscomのファイアウォールの通過方向を追加した。

JP1/SESイベントを使用する場合の注意事項について，Microsoft(R) Windows Server(R) 2008およびMicrosoft(R) Windows Server(R) 2008 R2のV5互換機能の制限を追加した。

操作ログを出力するための設定手順を変更した。

メッセージを追加，変更，削除した。

HP-UX（PA-RISC）のコンパイラー情報を削除した。

付録N.12　09-10の変更内容

(1)　資料番号（3020-3-R71-20，3020-3-R72-20，および3020-3-R73-20）の変更内容

イベントログトラップ機能で，Microsoft(R) Windows Vista(R)およびMicrosoft(R) Windows Server(R) 2008で追加されたイベント種別に対応した。

ログファイルトラップ起動定義ファイルを使用してログファイルトラップを起動できるようにした。

ログファイルトラップで監視できないログファイルの説明に，毎回先頭からログ情報が記録されるファイルを追加した。

ヘルスチェック機能で他ホストを監視する場合に，監視対象ホストの起動・停止を監視するかどうかを選択できるようにした。これに伴い，次のとおり定義ファイルの記述内容を変更した。

ヘルスチェック定義ファイルにSTOP_CHECKパラメーターを追加した。

イベントサーバ設定ファイルのoptionsパラメーターにauto-forward-offフラグを追加した。

また，JP1イベント「0000474A」の発行契機を追加した。

x64環境の場合に，インストール時，インストール先フォルダを設定する際の注意点を追記した。

jbs_setup_cluster（Windows限定）コマンドの形式の誤りを訂正した。

次のコマンドについて，コマンド使用時の注意事項を追加した。

jbsrt_distribコマンド，jevexportコマンド

jevlogstartコマンドの-rオプションの説明を変更した。

配布定義ファイルの記述内容で，@動作定義ファイル名の説明を変更した。

次のJP1イベントを追加した。

00004724，00004725，0000474C，0000474D

トラブル発生時に採取が必要な資料を追加した。

JP1/Baseの起動中に使用できないコマンドにjbs_setup_cluster（Windowsの場合）を追加した。

メッセージを追加，変更した。

対応するコンパイラーにVisual C++(R) 2008を追加した。

付録N.13　09-00の変更内容

(1)　資料番号（3020-3-R71，3020-3-R72，および3020-3-R73）の変更内容

ローカルアクション機能を追加した。

IM構成管理に対応した。

稼働情報を収集できるようにした。

メッセージを追加・変更した。

付録O　このマニュアルの参考情報

このマニュアルを読むに当たっての参考情報を示します。

付録O.1　関連マニュアル

関連マニュアルを次に示します。必要に応じてお読みください。

JP1/Base関連

JP1 Version 13 JP1/Base 運用ガイド（3021-3-L09）

JP1 Version 13 JP1/Base メッセージ（3021-3-L10）

JP1 Version 13 JP1/Base 関数リファレンス（3021-3-L11）

JP1/IM関連

JP1 Version 13 統合管理 基本ガイド（3021-3-L01）

JP1 Version 13 JP1/Integrated Management 3 - Manager 導入・設計ガイド（3021-3-L02）

JP1 Version 13 JP1/Integrated Management 3 - Manager 構築ガイド（3021-3-L03）

JP1 Version 13 JP1/Integrated Management 3 - Manager 運用ガイド（3021-3-L04）

JP1 Version 13 JP1/Integrated Management 3 - Manager 画面リファレンス（3021-3-L05）

JP1 Version 13 JP1/Integrated Management 3 - Manager コマンド・定義ファイルAPIリファレンス（3021-3-L06）

JP1 Version 13 JP1/Integrated Management 3 - Manager メッセージ（3021-3-L07）

JP1 Version 9 JP1/Integrated Management - Rule Operation 構築・運用ガイド（3020-3-R83）

JP1 Version 9 JP1/Integrated Management - Rule Operation 画面リファレンス（3020-3-R84）

JP1/AJS関連

JP1 Version 13 ジョブ管理 基本ガイド（ジョブスケジューラー編）（3021-3-L41）

JP1 Version 13 JP1/Automatic Job Management System 3 導入ガイド（3021-3-L42）

JP1 Version 13 JP1/Automatic Job Management System 3 設計ガイド（システム構築編）（3021-3-L43）

JP1 Version 13 JP1/Automatic Job Management System 3 設計ガイド（業務設計編）（3021-3-L44）

JP1 Version 13 JP1/Automatic Job Management System 3 構築ガイド（3021-3-L45）

JP1 Version 13 JP1/Automatic Job Management System 3 運用ガイド（3021-3-L46）

JP1 Version 13 JP1/Automatic Job Management System 3 トラブルシューティング（3021-3-L47）

JP1 Version 13 JP1/Automatic Job Management System 3 操作ガイド（3021-3-L48）

JP1 Version 13 JP1/Automatic Job Management System 3 コマンドリファレンス（3021-3-L49）

JP1 Version 13 JP1/Automatic Job Management System 3 連携ガイド（3021-3-L50）

JP1 Version 13 JP1/Automatic Job Management System 3 メッセージ（3021-3-L51）

その他

JP1 Version 12 JP1/Power Monitor（3021-3-D34）

JP1 Version 10 JP1/NETM/DM 導入・設計ガイド(Windows(R)用)（3021-3-175）

JP1 Version 10 JP1/NETM/DM 構築ガイド(Windows(R)用)（3021-3-176）

JP1 Version 10 JP1/NETM/DM 運用ガイド1(Windows(R)用)（3021-3-177）

JP1 Version 10 JP1/NETM/DM 運用ガイド2(Windows(R)用)（3021-3-178）

JP1 Version 10 JP1/NETM/DM Client(UNIX(R)用)（3021-3-181）

JP1 Version 8 JP1/NETM/DM SubManager(UNIX(R)用)（3020-3-L42）

JP1 Version 6 JP1/NETM/DM Manager（3000-3-841）

付録O.2　このマニュアルでの表記

このマニュアルでは，日立製品およびそのほかの製品の名称を省略して表記しています。このマニュアルでの表記と製品の正式名称を次の表に示します。

このマニュアルでの表記

正式名称

AIX

AIX V7.2

AIX V7.3

HNTRLib2

Hitachi Network Objectplaza Trace Library 2

JP1/AJS

JP1/AJS

JP1/Automatic Job Scheduler

JP1/AJS - Agent

JP1/AJS3 - Agent

JP1/Automatic Job Management System 3 - Agent

JP1/AJS3 - Agent Minimal Edition

JP1/Automatic Job Management System 3 - Agent Minimal Edition

JP1/AJS - Manager

JP1/AJS3 - Manager

JP1/Automatic Job Management System 3 - Manager

JP1/AJS - View

JP1/AJS3 - View

JP1/Automatic Job Management System 3 - View

JP1/AJS3 - WOA

JP1/Automatic Job Management System 3 - Web Operation Assistant

JP1/AOM

JP1/Automatic Operation Monitor

JP1/Audit

JP1/Audit Management - Manager※

JP1/IM

JP1/IM - EG

JP1/Integrated Management - Event Gateway for Network Node Manager i（バージョン9以降）※

JP1/Integrated Management 2 - Event Gateway for Network Node Manager i

JP1/Integrated Management 3 - Event Gateway for Network Node Manager i

JP1/IM2 - EG

JP1/Integrated Management 2 - Event Gateway for Network Node Manager i

JP1/Integrated Management 3 - Event Gateway for Network Node Manager i

JP1/IM - Manager

JP1/Integrated Management - Manager

JP1/Integrated Management 2 - Manager

JP1/Integrated Management 3 - Manager

JP1/IM2 - Manager

JP1/Integrated Management 2 - Manager

JP1/Integrated Management 3 - Manager

JP1/IM - Rule Operation

JP1/Integrated Management - Rule Operation

JP1/IM - View

JP1/Integrated Management - View

JP1/Integrated Management 2 - View

JP1/Integrated Management 3 - View

JP1/IM2 - View

JP1/Integrated Management 2 - View

JP1/Integrated Management 3 - View

JP1/IM - Planning Operation

JP1/Integrated Management - Planning Operation※

JP1/Navigation Platform

JP1/Navigation Platform※

JP1/NETM/DM

JP1/NETM/DM Client

JP1/NETM/DM Client

JP1/NETM/DM Client - Base

JP1/NETM/DM Manager

JP1/NETM/DM Manager

JP1/Power Monitor

JP1/Power Monitor

Linux

Oracle Linux 7

Oracle Linux(R) Operating System 7

Oracle Linux 8

Oracle Linux(R) Operating System 8

Oracle Linux 9

Oracle Linux(R) Operating System 9

Linux 7

Red Hat(R) Enterprise Linux(R) Server 7 (64-bit x86_64)

Linux 8

Red Hat(R) Enterprise Linux(R) Server 8 (64-bit x86_64)

Linux 9

Red Hat(R) Enterprise Linux(R) Server 9 (64-bit x86_64)

SUSE Linux 12

SUSE Linux(R) Enterprise Server 12

SUSE Linux 15

SUSE Linux(R) Enterprise Server 15

注※　この製品は日本語環境だけで動作する製品です。

AIXおよびLinuxを総称してUNIXと表記することがあります。

プログラムプロダクトの実行中にメッセージなどでプログラムプロダクト名称が表示される場合も略称を使用しています。

付録O.3　このマニュアルで使用する英略語

このマニュアルで使用する英略語を次に示します。

英略語

正式名称

AMD

Advanced Micro Devices

API

Application Programming Interface

CA

Certificate Authority

CN

Common Name

CSR

Certificate Signing Request

CSV

Comma Separated Value

DB

Database

DN

Distinguished Name

DNS

Domain Name System

EUC

Extended Unix Code

FD

Floppy Disk

FQDN

Fully Qualified Domain Name

FTP

File Transfer Protocol

GUI

Graphical User Interface

HTML

Hyper Text Markup Language

IP

Internet Protocol

IPF

Itanium(R) Processor Family

ISAM

Indexed Sequential Access Method

JIS

Japanese Industrial Standards

LAN

Local Area Network

LDAP

Lightweight Directory Access Protocol

NAT

Network Address Translator

NIC

Network Interface Card

NTP

Network Time Protocol

OS

Operating System

OU

Organization Unit

POSIX

Portable Operating System Interface for UNIX

RFC

Request For Comments

SNMP

Simple Network Management Protocol

SSL

Secure Socket Layer

TCP/IP

Transmission Control Protocol/Internet Protocol

TLS

Transport Layer Security

UAC

User Account Control

UTC

Universal Time Coordinated

UTF

UCS Transformation Format

WWW

World Wide Web

VPN

Virtual Private Network

付録O.4　KB（キロバイト）などの単位表記について

1KB（キロバイト），1MB（メガバイト），1GB（ギガバイト），1TB（テラバイト）はそれぞれ1,024バイト，1,024²バイト，1,024³バイト，1,024⁴バイトです。

付録P　用語解説

（英字）

ANYバインド方式

ホストに割り当てられているすべてのIPアドレスへの接続を受信できる通信方式です。通信の待ち受け処理では，ポート番号を使用してホストへアクセスしてきたすべてのデータを確実に受信できます。また，接続処理では，ホストが複数のサブネットを利用している場合でも，すべてのサブネット上のホストにデータを確実に送信できます。通常，物理ホストだけでJP1/Baseを運用する場合，このANYバインド方式で動作します（特に設定の必要はありません）。

DSグループ

JP1操作権限が設定されているActive Directoryのセキュリティグループです。セキュリティグループにJP1操作権限を設定することで，そのセキュリティグループに所属するアカウントにもJP1操作権限を付与することができ，JP1操作権限を容易に設定できます。

DSユーザー

ディレクトリサーバと連携してユーザー認証をするJP1ユーザーで，JP1認証情報（JP1ユーザー認証情報およびJP1操作権限）をディレクトリサーバで管理します。

IPバインド方式

特定のIPアドレスへの接続だけを受信できる通信方式です。通信の待ち受け処理では，特定のIPアドレスあてにきたデータだけを受信します。また，接続処理では，特定のIPアドレスを使用しているNICだけを経由してデータを送信します。

通常，JP1/Baseをクラスタ運用する場合，このIPバインド方式で動作します（クラスタシステム用に設定すると，通信方式がIPバインド方式に変わります）。

JP1/AJS

JP1/AJSは，業務を自動的に運用するためのプログラムです。処理を順序付けて定期的に実行したり，特定の事象が発生したときに処理を開始したりできます。

JP1/Audit Management - Manager

内部統制の有効性を評価するために必要な証跡記録を一元管理し，内部統制の報告書作成や監査業務を支援する製品です。ユーザー情報やシステム構成の変更などの証跡記録を利用して，業務の正当性を確認したり，リソースへの操作やアクセス状況を監査したりできます。

JP1/Base

JP1/Baseは，イベントサービス機能を提供するプログラムです。サービスの起動順序を制御したり，JP1イベントを送受信したりできます。

また，JP1/Baseは，JP1/IM，JP1/AJS，およびJP1/Power Monitorの前提プログラムです。JP1/IM，およびJP1/AJSを使ったシステムを導入する場合，JP1ユーザーの操作を制限する機能を提供します。

JP1/Base管理者

JP1/Baseを運用する権限を持ちます。UNIX環境で，プライマリーグループがJP1管理者グループのOSユーザーです。システム管理者以外のOSユーザーで，JP1/Baseを運用したい場合に設定します。

JP1/Cm2

ネットワークの構成管理，性能管理および障害管理のための統合ネットワーク管理プログラムの総称です。

JP1/IM - Manager

JP1/IM - Manager（JP1/Integrated Management 3 - Manager）は，システム全体の一元的な監視と操作を実現し，システムを統合管理するためのプログラムです。

JP1/IM - Managerは，「セントラルコンソール」および「セントラルスコープ」の二つの機能によって構成されています。

JP1/IM - View

JP1/IMでのシステム統合管理を実現するためのビューアー機能を提供するプログラム（GUI提供プログラム）です。

JP1/IM - ManagerおよびJP1/IM - Rule Operationで共通のJP1/IM - Viewを使用します。目的に応じて，それぞれの製品に接続し，システムの監視や管理を行います。

JP1/Power Monitor

JP1/Power Monitorは，ホストを自動的に起動・終了するプログラムです。

スケジュールを設定してホストを起動・終了したり，離れた場所にあるホストを起動・終了したりできます。

jp1hosts情報

JP1独自のhosts情報のことです。一つのホスト名から一つのIPアドレスしか解決できないOSであっても，jp1hosts情報を定義すればJP1/Baseでは，一つのホスト名に複数のIPアドレスを割り当てられ，一つのホスト名から複数のIPアドレスに解決できます。なお，jp1hosts情報は共通定義情報に登録すると有効になります。

jp1hosts2情報

JP1独自のhosts情報のことです。一つのホスト名から一つのIPアドレスしか解決できないOSであっても，jp1hosts2情報を定義すればJP1/Baseでは，一つのホスト名に複数のIPアドレスを割り当てられ，一つのホスト名から複数のIPアドレスに解決できます。なお，jp1hosts2情報はホストに登録すると有効になります。

JP1イベント

システムで発生した事象をJP1で管理するための情報です。

JP1イベントは，次のような属性に分けて，事象を記録しています。

基本属性

すべてのJP1イベントが持つ属性です。

属性名を表記する場合，例えばイベントIDはB.ID（または単にID）のように記述します。

拡張属性

JP1イベントの発行元が任意に指定できる属性です。拡張属性は，次の共通情報と固有情報で構成されます。

・共通情報（形式が統一されている拡張属性の情報）

・固有情報（共通情報以外の各製品固有の形式の情報）

属性名を表記する場合，例えば重大度はE.SEVERITY（または単にSEVERITY）のように記述します。

JP1イベントは，JP1/Baseのイベントサービス機能が管理しています。システムで発生した事象をJP1イベントとしてデータベースに記録しています。

JP1管理者グループ

システム管理者（スーパーユーザー権限）以外のOSユーザーで，JP1を運用するために設定するユーザーグループです。このグループをプライマリーグループとしているOSユーザーに，JP1/Baseを運用する権限を与えます。

JP1権限レベル

管理対象（資源）に対してJP1ユーザーがどのような操作ができるかを表しています。ジョブ，ジョブネット，イベントなどの管理対象（資源）の種類に応じて，操作項目を定めています。管理対象（資源）の種類と，それに対する操作項目の幾つかを組み合わせた形式でJP1ユーザーのアクセス権限を管理します。

JP1資源グループ

ジョブ，ジョブネット，イベントなどの管理対象（資源）を幾つかのグループに分けて管理します。この管理対象（資源）を分けたグループのことをJP1資源グループと呼びます。

JP1ユーザー

JP1/IMまたはJP1/AJSを使用するときのユーザー名です。JP1ユーザーは，認証サーバに登録され，他ホストへのアクセス権限を認証サーバで管理されます。OSに登録されているユーザーとは異なる場合があります。

JP1ユーザーにはユーザー認証の方法によって，次に示すJP1ユーザー種別があります。

標準ユーザー

DSユーザー

連携ユーザー

（ア行）

イベントID

JP1イベントの属性の一つで，JP1イベントを発行したプログラムや，発生した事象の内容を示す識別子です。JP1イベントの基本属性で，属性名は「B.ID」です。

イベントIDは，例えば，7FFF8000のような値で，16進数で表記します。

イベントIDは，JP1シリーズの各製品で一意になるように割り当てられています。JP1シリーズの各製品が発行するJP1イベントについては，各製品のマニュアルを参照してください。

ユーザーが使用できるイベントIDは，0〜1FFFおよび7FFF8000〜7FFFFFFFです。

なお，JP1イベントの詳細は，基本コード（上位4バイト）と拡張コード（下位4バイト）に分かれた8バイトの数値です。通常は，基本コードだけを使って4バイトで表記します。拡張コードは，ユーザーがAPIで設定するなど特別な場合を除いて0です。基本コードと拡張コードの表記が必要な場合は，「:」でつなげて，7FFF8000:0のように表します。

イベントサーバ

JP1/BaseでJP1イベントを管理する機能を持つプログラムです。イベントサーバを起動すると，JP1イベントを収集・配布できる状態になります。

イベントサービス

システム内で発生した事象をJP1イベントとして登録，および管理するための機能です。

イベントログトラップ

WindowsのイベントログをJP1イベントに変換する機能です。

エージェント

システム上でほかのプログラムに管理される役割を持つプログラムのことです。または，システム上でほかのホストに管理される役割を持つホストのことです。

JP1/IM，JP1/AJSを例にすると，JP1/IMの場合はJP1/Baseが，JP1/AJSの場合はJP1/AJS - Agent，JP1/Baseがエージェントとしての役割を持つプログラムになります。

（カ行）

拡張属性

JP1イベントの属性のうち，JP1イベントの発行元プログラムが任意に指定する属性です。拡張属性には共通情報と固有情報があります。共通情報にはJP1プログラムで統一されている情報を示します。固有情報は共通情報以外の拡張属性を示します。

稼働情報

JP1/Baseサービスが読み込んだ定義情報のことです。現在JP1/Baseでどの定義が有効になっているかを確認できます。

キー定義ファイル

データファイルとキーファイルとの対応を表すデータを格納するファイルです。

キーファイル

キーを検索するためのインデックス情報を，階層木構造で格納するファイルです。データファイルのレコードを検索するためのキーも格納されます。キーファイルには，主キーファイルと副キーファイルがあります。

基本属性

JP1イベントの属性のうち，すべてのJP1イベントに共通する属性です。

共通定義情報

JP1/Base，JP1/IM，JP1/AJS，およびJP1/Power Monitorの定義情報の集まりで，JP1/Baseが管理しています。データベースは，各サーバのローカルディスクにあり，定義パラメーターが物理ホストおよび論理ホストごとに分けて格納されています。

なお，JP1をクラスタシステムで運用する場合は，実行系・待機系の各サーバにある共通定義情報の論理ホストの定義内容を同じにする必要があります。このため，セットアップや環境設定をしたときは，実行系サーバでパラメーターを設定したあとで，待機系サーバに設定をコピーします。

クライアント

処理を実行するほかのホスト（プログラム）に対して，実行の指示を出し，その結果を受け取るホストです。JP1/IMでは，JP1/IM - View，JP1/AJSでは，JP1/AJS - Viewがクライアントとなります。

クラスタシステム

クラスタシステムとは，複数のサーバシステムを連携して一つのシステムとして運用するシステムで，障害が発生しても業務を継続できるようにすることを目的としています。この処理を引き継ぐことをフェールオーバーといいます。業務を実行中のサーバ（実行系）で障害が発生すると，待機していた別のサーバ（待機系）が業務の処理を引き継ぎます。実行「系」から待機「系」へ業務を切り替えるため，「系切り替えシステム」とも呼びます。

なお，クラスタシステムの種類には，複数のサーバが並列処理をして負荷分散することを目的としたシステム構成などもありますが，このマニュアルでは，フェールオーバーによって業務の中断を防ぐ機能のことだけを指します。

系切り替えシステム

クラスタシステムを参照してください。

構成定義

JP1/IMが運用管理するシステムの構成を定義した情報です。

構成定義には，JP1/IMのマネージャーとエージェントの階層関係を定義します。また，マネージャーは階層化して定義でき，例えば上位の統合マネージャーと下位の拠点マネージャーのように定義できます。

構成定義に定義している階層化したホストの情報は，JP1/IMでマネージャーに重要なJP1イベントを転送するための転送先ホストや，JP1/IMで自動アクションによってコマンドを実行できるホストの情報などとして使われます。

（サ行）

情報検索用ユーザー

ディレクトリサーバ連携の対象ユーザーをディレクトリサーバ内で，検索するためのユーザーのことです。検索起点となるコンテナオブジェクトおよびその配下のコンテナオブジェクトに対して，参照権限があるディレクトリサーバのユーザーです。

スパース文字

キーとして使用しないように指定した文字のことです。スパース文字は，キー定義ファイルを作成するときや，キーを追加するときに指定します。

レコードを追加するとき，あるキーのすべての内容がスパース文字と同じ場合，そのキーはキーファイルに追加されません。このようなキーを，スパースキーといいます。これによって，キーファイルの容量を削減できます。また，重複キーの処理時間を短縮できます。

正規表現

特定のテキスト文字列に対応する文字や特殊文字の並びのことです。

セカンダリー認証サーバ

一つのユーザー認証圏内に認証サーバを2台設置するときに，予備として稼働する認証サーバのことです。

（タ行）

大量発生イベント

短期間にユーザーの想定を超えて大量に発生するJP1イベントのことです。

ディレクトリサーバ

ネットワーク上に存在するさまざまな資源，および資源の属性を一元管理するためのサービスを提供するサーバのことです。

（ナ行）

認証サーバ

JP1ユーザーのアクセス権限を管理するサーバです。一つのユーザー認証圏に1台設置する必要があります。このサーバを利用してJP1ユーザーを一括で管理します。JP1/IM，JP1/AJSを導入する場合，JP1ユーザー名をこのサーバに登録する必要があります。

（ハ行）

ビューアー

マネージャーやエージェントが管理する情報を確認し，マネージャーやエージェントを操作するための画面を提供するプログラムのことです。または，ビューアーを実行するホストのことです。

JP1/IM，JP1/AJSを例にすると，JP1/IM - View，JP1/AJS - Viewなどがビューアーとしての役割を持つプログラムになります。

標準ユーザー

認証サーバでユーザー認証をするJP1ユーザーのことです。JP1認証情報（JP1ユーザー認証情報およびJP1操作権限）を認証サーバで管理します。

フェールオーバー

JP1を実行するサーバに障害が発生した場合に，ほかの正常なサーバにJP1を移動させて処理を続行することです。または，システム管理者の操作によって，JP1を実行するサーバを切り替えることです。

実行系サーバから待機系サーバにフェールオーバーするため，系切り替えとも言います。

複数LAN接続

複数のLANで構成されたシステムに対応するJP1の機能のことです。

この機能を使うと，複数のLANに接続されたホスト上で，JP1の通信に使うLANを設定できます。システムやほかのアプリケーションとは別にJP1独自に通信設定できるので，多様なネットワーク構成や運用方法に柔軟に対応できます。

なお，複数のLANに接続したホストを，マルチホームホストや複数NICのホストと呼ぶこともあります。

JP1/Baseでは，次の複数LAN接続の環境での運用をサポートしています。

複数のネットワークに分かれている環境

物理ホスト

クラスタシステムを構成する各サーバに固有な環境のことです。物理ホストの環境は，フェールオーバー時にはほかのサーバに引き継がれません。

プライマリー認証サーバ

一つのユーザー認証圏内に認証サーバを2台設置するときに，通常時に利用する認証サーバのことです。

プロセス

Windowsの場合のサービスプログラム，UNIXの場合のデーモンプログラムなどを示します。

閉塞状態

接続に失敗した認証サーバに接続を試みない状態のことです。これは，一つのユーザー認証圏内に認証サーバを2台設置したときに発生することがあります。

（マ行）

マネージャー

システム上のほかのプログラムを管理する役割を持つプログラムのことです。または，システム上のほかのホストを管理する役割を持つホストのことです。

JP1/IM，JP1/AJSを例にすると，JP1/IM - ManagerやJP1/IM - Rule Operation，JP1/AJS - Managerなどがマネージャーとしての役割を持つプログラムになります。これらのプログラムはシステム上のほかのプログラム（エージェント）を管理します。

（ヤ行）

ユーザー認証圏

システム内で認証サーバが管理するホスト群の範囲を表しています。JP1ユーザーは，認証サーバが管理するホスト群に対してジョブの実行，コマンドの実行，自動アクションなどの各種操作ができます。JP1/IM，JP1/AJSを導入する場合，ユーザー認証圏を決める必要があります。

ユーザーマッピング

JP1ユーザーに，OSに登録されているユーザーの権限を与える機能です。

JP1ユーザーとして認証サーバに登録されたユーザーが，各ホストのOSに登録されているユーザーの権限で各ホストの操作を実行できるようになります。

（ラ行）

連携ユーザー

ディレクトリサーバと連携してユーザー認証をするJP1ユーザーで，JP1認証情報（JP1ユーザー認証情報およびJP1操作権限）うちJP1ユーザー認証情報だけをディレクトリサーバで管理します。そのため，JP1ユーザーを認証サーバに登録する際，パスワードは入力しません。

ローカルアクション

特定のJP1イベントが発生したときに，ローカルホスト内で自動的にコマンドを実行する機能です。

ログファイルトラップ機能

アプリケーションプログラムがログファイルに出力するログをJP1イベントに変換する機能です。

論理ホスト

クラスタシステムでの運用時にJP1の実行環境となる論理上のサーバのことです。障害の発生時には，論理ホスト単位でフェールオーバーします。

論理ホストは専用のIPアドレスと共有ディスクを持ち，フェールオーバー時にはそのIPアドレスと共有ディスクを引き継いで動作します。そのため，障害で物理的なサーバが切り替わった場合も，ほかのホストからは同じIPアドレスでアクセスでき，一つのホストが常に動作しているように見えます。

索引

A

Amazon EC2サービスの設定[1]

ANYバインド方式[1]

用語解説[1]

api[1]

api（API設定ファイル）[1]

API設定ファイル[1]

API設定ファイル（api）[1]

B

［Baseクラスタ構成の設定］ダイアログボックス[1]

C

conf[1]

conf（イベントサーバ設定ファイル）[1]

cpysvprm（Windows限定）[1]

D

DNSを使ったシステムでのイベントサーバの設定[1]

DSグループ

用語解説[1]

DSユーザー[1]

用語解説[1]

DSユーザーを使用する運用の場合の設定[1]

F

forward[1]

forward（転送設定ファイル）[1]

定義情報を収集する[1]

定義情報を配布する[1]

H

Hitachi Network Objectplaza Trace Monitor 2 (x64)（サービス）[1]

Hitachi Network Objectplaza Trace Monitor 2（サービス）[1]

Hitachi PP Installer

使用方法[1]

初期画面例[1]

注意事項[1]

hntr2conf[1]

hntr2getconf[1]

hntr2getname（Windows限定）[1]

hntr2kill（UNIX限定）[1]

hntr2mon（UNIX限定）[1]

hntr2util（UNIX限定）[1]

hntr2util（Windows限定）[1]

hntr2utl2（UNIX限定）[1]

hntr2utl2（Windows限定）[1]

HNTRLib2（統合トレース機能）[1]

設定する[1]

I

index[1]

index（イベントサーバインデックスファイル）[1]

IPv6環境[1]

IPアドレス

確認方法[1]

変更による影響および必要な作業[1]

IPバインド方式[1]

用語解説[1]

ISAMファイル

操作および保守に関するユーティリティコマンド[1]

J

jbs_killall.cluster（UNIX限定）[1]

jbs_log.bat（Windows限定）[1]

jbs_log.sh（UNIX限定）[1]

jbs_setup_cluster（Windows限定）[1]

jbs_spmd_reload[1]

jbs_spmd_status[1]

jbs_spmd_stop[1]

jbs_spmd（UNIX限定）[1]

jbs_start.cluster（UNIX限定）[1]

jbs_start（UNIX限定）[1]

jbs_stop.cluster（UNIX限定）[1]

jbs_stop（UNIX限定）[1]

jbsacllint[1]

jbsaclreload[1]

jbsadduser[1]

jbsadmin（Windows限定）[1]

jbsblockadesrv[1]

jbscancellcact[1]

jbschgds（Windows限定）[1]

jbschgpasswd[1]

jbschkds（Windows限定）[1]

jbsdfts_srv.conf[1]

jbsgetcnf[1]

jbsgetopinfo[1]

jbsgetumap[1]

jbshc.conf[1]

jbshosts2export[1]

jbshosts2import[1]

jbshostsexport[1]

jbshostsimport[1]

jbslcact.conf[1]

jbslistacl[1]

jbslistlcact[1]

jbslistsrv[1]

jbslistuser[1]

jbsmkpass（Windows限定）[1]

jbsmkumap[1]

jbsparamdump[1]

jbspassmgr（Windows限定）[1]

jbsrmacl[1]

jbsrmumap[1]

jbsrmumappass（Windows限定）[1]

jbsrmuser[1]

jbsrt_del[1]

jbsrt_distrib[1]

jbsrt_get[1]

jbsrt_sync[1]

jbssetacl[1]

jbssetadmingrp（UNIX限定）[1]

jbssetcnf[1]

jbssetumap[1]

jbssetupsrv（Windows限定）[1]

jbssetusrsrv（UNIX限定）[1]

jbsumappass（Windows限定）[1]

jbsunblockadesrv[1]

jbsunsetcnf[1]

jcocmdconv[1]

jcocmddef[1]

jcocmddel[1]

jcocmdlog[1]

jcocmdshow[1]

jev_forward.conf[1]

jev_logstart.conf[1]

jev_logtrap.conf[1]

jev_ntevent.conf[1]

jevagtfw[1]

jevdbinit[1]

jevdbmkrep[1]

jevdbswitch[1]

jevdef_distrib[1]

jevdef_get[1]

jeveltreload（Windows限定）[1]

jevexport[1]

jevextreload[1]

jevfwstat[1]

jevlog_start.conf[1]

jevlogd.conf[1]

jevlogdstart（UNIX限定）[1]

jevlogdstat[1]

jevlogdstop（UNIX限定）[1]

jevlogreload[1]

jevlogstart[1]

jevlogstart（クラスタ運用限定）[1]

jevlogstat[1]

jevlogstop[1]

jevlogstop（クラスタ運用限定）[1]

jevmessageid.bat（Windows限定）[1]

jevregsvc（Windows限定）[1]

jevreload[1]

jevsend[1]

jevsend（概要）[1]

jevsendd[1]

jevsendd（概要）[1]

jevstart（UNIX限定）[1]

jevstat[1]

jevstop（UNIX限定）[1]

Jischk[1]

Jiscond[1]

Jisconv[1]

Jiscpy[1]

Jisext[1]

Jisinfo[1]

Jiskeymnt[1]

Jisktod[1]

Jislckclear（Windows限定）[1]

Jislckext[1]

Jislckfree（Windows限定）[1]

Jislckreg（UNIX限定）[1]

Jismlcktr（Windows限定）[1]

Jisprt[1]

Jisrsdel（UNIX限定）[1]

JP1_HOSTNAME環境変数[1]

JP1_UserLevel[1]

JP1/AJS

Windowsイベントログ監視ジョブを使用する場合[1]

用語解説[1]

ログファイル監視ジョブ[1]

JP1/Audit Management - Manager

用語解説[1]

JP1/Base

運用中の設定変更[1]

各機能サポート状況一覧（UNIXの場合）[1]

各機能サポート状況一覧（Windowsの場合）[1]

起動確認する（UNIX）[1]

起動確認する（Windows）[1]

起動する（UNIX）[1]

起動する（Windows）[1]

互換性[1]

終了する（UNIX）[1]

終了する（Windows）[1]

使用上の注意事項[1]

制限値一覧[1]

通信設定[1]

ポート番号一覧[1]

用語解説[1]

JP1/Base（サービス）[1]

JP1/Base Control Service（サービス）[1]

JP1/Base Event（サービス）[1]

JP1/Base EventlogTrap（サービス）[1]

JP1/Base LogTrap（サービス）[1]

JP1/Base管理者[1]

用語解説[1]

JP1/Base管理者での運用（UNIX限定）[1]

JP1/Baseの機能詳細[1]

JP1/Baseの通信暗号化について[1]

JP1/Baseパラメーター定義ファイル[1]

JP1/Cm2

用語解説[1]

JP1/IM - Manager

用語解説[1]

JP1/IM - View

用語解説[1]

JP1/Power Monitor

用語解説[1]

jp1base_setup_cluster（UNIX限定）[1]

jp1base_setup（UNIX限定）[1]

jp1bs_ds_setup.conf[1]

jp1bs_param_V7.conf[1]

jp1bs_service_0700.conf[1]

jp1bshasetup（Windows限定）[1]

jp1BsUmap.conf[1]

jp1hosts[1]

用語解説[1]

jp1hosts2.conf[1]

jp1hosts2情報

バックアップ（UNIX）[1]

バックアップ（Windows）[1]

用語解説[1]

リカバリー（UNIX）[1]

リカバリー（Windows）[1]

jp1hosts2情報を定義する[1]

jp1hosts2定義ファイル[1]

jp1hosts情報を定義する[1]

jp1hosts定義ファイル[1]

jp1ping[1]

Jp1svprm_wait.dat[1]

JP1SVPRM.DAT[1]

JP1SVPRM.DAT（起動順序定義ファイル）[1]

JP1イベント

一覧[1]

拡張属性[1]

基本属性[1]

取得件数[1]

種類[1]

詳細[1]

送受信する[1]

属性[1]

重複チェック[1]

転送[1]

転送のリトライ[1]

保管期限[1]

用語解説[1]

JP1イベントを契機にコマンドを実行する[1]

JP1管理者グループ[1]

用語解説[1]

JP1権限レベル[1]

用語解説[1]

JP1資源グループ[1]

用語解説[1]

［JP1資源グループ詳細］ダイアログボックス[1]

JP1独自のhosts情報

コマンド[1]

JP1ユーザー

GUIを使って設定する（Windows）[1]

コマンドを使って設定する（Windows）[1]

設定する（UNIX）[1]

操作権限を設定する（UNIX）[1]

操作権限を設定する（Windows）[1]

用語解説[1]

［JP1ユーザー］ダイアログボックス（ユーザー追加）[1]

［JP1ユーザー］ダイアログボックス（ユーザーマッピング）[1]

L

LANG環境変数[1]

N

ntevent.conf[1]

ntevent.conf（動作定義ファイル）

定義情報を収集する[1]

定義情報を配布する[1]

O

openssl[1]

OSユーザー

個別に削除する（コマンド）[1]

個別に登録する（コマンド）[1]

パスワード管理情報を一括して設定する（コマンド）[1]

パスワード管理情報を設定する（GUI）[1]

［OSユーザー設定時にWindowsに対してログオンチェックを行わない］[1]

S

SSL通信環境のセットアップ

クライアント側[1]

サーバ側[1]

SSL通信定義ファイル[1]

SSL通信に必要なファイル[1]

W

Windowsイベントログ監視ジョブを使用する場合[1]

あ

アプリケーションプログラムのログファイルを変換する[1]

アンインストール

注意事項（UNIX）[1]

注意事項（Windows）[1]

手順（UNIX）[1]

手順（Windows）[1]

い

意図しないホストからの通信接続を制限する[1]

イベントDB

csvファイルに出力する[1]

初期化する[1]

バックアップ（UNIX）[1]

バックアップ（Windows）[1]

容量[1]

リカバリー（UNIX）[1]

リカバリー（Windows）[1]

イベントDBとは[1]

イベントID

00001011の詳細[1]

00003A10の詳細[1]

00003A20の詳細[1]

00003A21の詳細[1]

00003A22の詳細[1]

00003A25の詳細[1]

00003A26の詳細[1]

00003A27の詳細[1]

00003A28の詳細[1]

00003A29の詳細[1]

00003A2Aの詳細[1]

00003A30の詳細[1]

00003A31の詳細[1]

00003A32の詳細[1]

00003D00の詳細[1]

00003D04の詳細[1]

00003D05の詳細[1]

00003D06の詳細[1]

00003D07の詳細[1]

00003D08の詳細[1]

00003D09の詳細[1]

00003D0Bの詳細[1]

00003D0Cの詳細[1]

00003D0Dの詳細[1]

00003D0Eの詳細[1]

00003FA0の詳細[1]

00003FA1の詳細[1]

00003FA2の詳細[1]

00003FA3の詳細[1]

00003FA5の詳細[1]

00003FA6の詳細[1]

00003FA7の詳細[1]

00004700の詳細[1]

00004701の詳細[1]

00004702の詳細[1]

00004720の詳細[1]

00004721の詳細[1]

00004722の詳細[1]

00004724の詳細[1]

00004725の詳細[1]

00004740の詳細[1]

00004741の詳細[1]

00004742の詳細[1]

00004743の詳細[1]

00004747の詳細[1]

00004748の詳細[1]

00004749の詳細[1]

0000474Aの詳細[1]

0000474Bの詳細[1]

0000474Cの詳細[1]

0000474Dの詳細[1]

0000474Eの詳細[1]

0000474Fの詳細[1]

00004750の詳細[1]

00004780の詳細[1]

00004781の詳細[1]

00004782の詳細[1]

00004783の詳細[1]

イベントID：00003A71またはイベントログトラップ動作定義ファイルのフィルターで指定されたイベントIDの詳細[1]

用語解説[1]

ログファイルトラップ動作定義ファイルのACTDEFパラメーターで指定されたイベントIDの詳細[1]

イベントサーバ

用語解説[1]

イベントサーバインデックスファイル[1]

イベントサーバインデックスファイル（index）[1]

イベントサーバ設定ファイル[1]

イベントサーバ設定ファイル（conf）[1]

イベントサービス[1]

DNSを使ったシステムでのイベントサーバの設定[1]

稼働中に初期化する[1]

使用するコマンド[1]

設定手順[1]

注意事項[1]

通信設定を変更する[1]、[2]

定義情報を収集する[1]

定義情報を配布する[1]

停止中に初期化する[1]

用語解説[1]

イベントサービスとは[1]

イベントサービスへの接続失敗時のリトライ

イベントログトラップの場合[1]

ログファイルトラップの場合[1]

イベント転送抑止条件[1]

イベントフィルター

記述例[1]

イベント変換[1]

イベントログトラップ[1]

用語解説[1]

イベントログトラップ機能

起動する[1]

クラスタ運用[1]

自動で起動する[1]

終了する[1]

イベントログトラップ動作定義ファイル[1]

イベントログトラップ動作定義ファイル（Windows限定）[1]

イベントログトラップによる監視の開始と終了[1]

インストール

注意事項（UNIX）[1]

注意事項（Windows）[1]

手順（UNIX）[1]

手順（Windows）[1]

う

運用ごとに設定が必要となる定義ファイル[1]

え

エージェント

用語解説[1]

お

オートスケール機能と連携した運用[1]

オートスケール機能と連携して運用する場合のシステム構成[1]

オートスケール機能と連携して運用する場合のセットアップ手順（マネージャーホスト）[1]

オートスケール機能と連携して運用する場合の前提条件[1]

オートスケール機能と連携して運用する場合の注意事項[1]

オートスケール機能と連携して運用する場合のセットアップ手順（エージェントホスト）[1]

オートスケール連携スクリプト[1]

か

概要[1]

拡張起動プロセス定義ファイル[1]

拡張正規表現[1]

拡張属性[1]

用語解説[1]

各バージョンの変更内容

09-00の変更内容[1]

09-10の変更内容[1]

09-50の変更内容[1]

10-00の変更内容[1]

10-10の変更内容[1]

10-50の変更内容[1]

11-00の変更内容[1]

11-10の変更内容[1]

11-50の変更内容[1]

稼働情報

用語解説[1]

環境変数

JP1_HOSTNAME[1]

LANG[1]

環境変数ファイル[1]

監視設定および解除の処理時間[1]

監視できないログファイル[1]

監視できるログファイル[1]

監視できるログファイル数[1]

き

キー定義ファイル

用語解説[1]

キーファイル

用語解説[1]

起動確認する（UNIX）[1]

起動確認する（Windows）[1]

起動管理[1]

使用をやめる[1]

起動管理機能

使用するコマンド[1]

注意事項[1]

起動順序定義ファイル（JP1SVPRM.DAT）[1]

起動順序定義ファイル（Windows限定）[1]

起動する

JP1/Base（UNIX）[1]

JP1/Base（Windows）[1]

イベントログトラップ機能[1]

使用するコマンド[1]

ログファイルトラップ[1]

機能一覧（UNIX）[1]

機能概要[1]

基本属性[1]

用語解説[1]

共通定義情報

コマンド[1]

バックアップ（UNIX）[1]

バックアップ（Windows）[1]

用語解説[1]

リカバリー（UNIX）[1]

リカバリー（Windows）[1]

共通定義設定用ファイル（構成管理機能）[1]

共通定義設定用ファイル（ヘルスチェック機能）[1]

共通定義設定用ファイル（ローカルアクション機能）[1]

共通メッセージログ[1]

共有ファイルの作成（UNIX）[1]

共有フォルダの指定（Windows）[1]

く

クライアント

用語解説[1]

クラスタID[1]

クラスタ運用

JP1/Baseの機能[1]

JP1の再起動[1]

概要[1]

環境設定（UNIX）[1]

環境設定（Windows）[1]

クラスタソフトへの登録（UNIX）[1]

クラスタソフトへの登録（Windows）[1]

言語種別を変更する（UNIX限定）[1]

設定変更時の作業[1]

セットアップ（UNIX）[1]

セットアップ（Windows）[1]

前提条件[1]

注意事項[1]

クラスタシステム[1]

概要[1]

実行系サーバ[1]

待機系サーバ[1]

用語解説[1]

け

系切り替えシステム

用語解説[1]

言語種別

変更する（UNIX限定）[1]

こ

構成定義

用語解説[1]

構成定義情報の配布方式を指定する[1]

構成定義ファイル[1]

互換性[1]

コネクションの接続状態[1]

コマンド[1]

ISAMファイルの操作，保守[1]

jbsrt_del[1]

jbsrt_distrib[1]

jbsrt_get[1]

jbsrt_sync[1]

jcocmddef[1]

jcocmddel[1]

jcocmdlog[1]

jcocmdshow[1]

JP1/Baseの設定情報の一括収集およびトラブルシューティング[1]

JP1独自のhosts情報[1]

一覧[1]

イベントサービス[1]

起動管理機能[1]

起動・終了，セットアップ[1]

共通定義情報[1]

構成定義[1]

通信暗号化[1]

ネットワーク設定の確認[1]

バージョンアップ[1]

ユーザー管理機能[1]

ローカルアクション，自動アクション，およびコマンド実行に関するコマンド[1]

コマンド実行履歴ファイル

ディレクトリ（UNIX）[1]

ディレクトリ（Windows）[1]

コマンドによるシステム階層構成の管理[1]

さ

サービス

Hitachi Network Objectplaza Trace Monitor 2 (x64)（統合トレース 64bit版）[1]

Hitachi Network Objectplaza Trace Monitor 2（統合トレース）[1]

JP1/Base（ユーザー管理を含むプロセス管理）[1]

JP1/Base Control Service（起動管理）[1]

JP1/Base Event（イベントサービス）[1]

JP1/Base EventlogTrap（イベントログトラップサービス）[1]

JP1/Base LogTrap（ログファイルトラップ管理サービス）[1]

一覧[1]

起動[1]

起動確認する[1]

起動順序[1]

起動順序の設定手順[1]

起動順序を制御する（概要）[1]

起動するタイミングを設定する[1]

終了[1]

終了順序の設定手順[1]

終了順序を制御する（概要）[1]

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）[1]

サービスとしてログオン[1]

し

システムの階層構成の設定[1]

システムの日時変更[1]

実行系サーバ[1]

［実行系 論理ホストの設定］ダイアログボックス[1]

自動起動

イベントログトラップ機能[1]

設定する（UNIX限定）[1]

ログファイルトラップ[1]

自動終了の設定（UNIX限定）[1]

自動セットアップ（UNIX）[1]

自動セットアップ（Windows）[1]

収集情報ファイル[1]

終了する

JP1/Base（UNIX）[1]

JP1/Base（Windows）[1]

イベントログトラップ機能[1]

使用するコマンド[1]

ログファイルトラップ[1]

情報検索用ユーザー

用語解説[1]

資料採取ツール[1]

資料の採取方法（UNIXの場合）[1]

資料の採取方法（Windowsの場合）[1]

す

スケールアウト時に監視対象に追加する[1]

スケールイン時に監視を解除する[1]

スパース文字[1]

用語解説[1]

せ

正規表現[1]

拡張する[1]

拡張正規表現[1]

指定する際のヒント[1]

指定例[1]

初期設定の文法[1]

比較[1]

用語解説[1]

制限値一覧[1]

セカンダリー認証サーバ[1]

用語解説[1]

セキュアなシステムの運用[1]

セキュアなシステムの前提条件[1]

設定する

IPアドレスの変更[1]

JP1ユーザー（UNIX）[1]

JP1ユーザー（Windows）[1]

イベントログトラップ機能[1]

クラスタ運用環境（UNIX）[1]

クラスタ運用環境（Windows）[1]

正規表現を拡張する[1]

操作権限（UNIX）[1]

操作権限（Windows）[1]

ディレクトリサーバ[1]

認証サーバ（UNIX）[1]

認証サーバ（Windows）[1]

標準ユーザー[1]

ユーザーマッピング（UNIX）[1]

ユーザーマッピング（Windows）（GUI）[1]

ユーザーマッピング（Windows）（コマンド）[1]

連携ユーザー[1]

ログファイルトラップ[1]

セットアップ[1]

使用するコマンド[1]

論理ホスト（UNIX）[1]

論理ホスト（Windows）[1]

そ

操作権限[1]

GUIを使って設定する（Windows）[1]

一括して設定する（UNIX）[1]

一括して設定する（Windows）[1]

個別に登録する（UNIX）[1]

個別に登録する（Windows）[1]

削除する（UNIX）[1]

削除する（Windows）[1]

操作ログ[1]

出力[1]

出力形式[1]

出力される契機[1]

出力される事象の種別[1]

出力されるメッセージの一覧[1]

出力するための設定[1]

操作ログ定義ファイル（jp1bs_baselog_setup.conf）の詳細[1]

操作ログ定義ファイルの定義例[1]

保存形式[1]

操作ログ定義ファイル（jp1bs_baselog_setup.conf）

詳細[1]

定義例[1]

属性付加設定ファイル[1]

た

待機系サーバ[1]

［待機系 論理ホストの設定］ダイアログボックス[1]

大量発生イベント

用語解説[1]

大量発生イベントとは[1]

大量発生イベントの転送を抑止する[1]

大量発生イベントへの対策[1]

単一ネットワークでの運用[1]

つ

通信暗号化機能の設定[1]

通信暗号化で使用するコマンド[1]

通信設定[1]

単一ネットワークでの運用に戻す[1]

必要な場合[1]

変更対応[1]

通信方式[1]

ANYバインド方式[1]

IPバインド方式[1]

て

定義収集[1]

定義収集機能

JP1製品の定義情報の収集[1]

収集する[1]

定義配布[1]

定義配布機能

配布する[1]

定義ファイル

API設定ファイル[1]

JP1/Baseパラメーター定義ファイル[1]

jp1hosts2定義ファイル[1]

jp1hosts定義ファイル[1]

SSL通信定義ファイル[1]

イベントサーバインデックスファイル[1]

イベントサーバ設定ファイル[1]

イベントログトラップ動作定義ファイル（Windows限定）[1]

拡張起動プロセス定義ファイル[1]

環境変数ファイル[1]

起動順序定義ファイル（Windows限定）[1]

共通定義設定用ファイル（ヘルスチェック機能）[1]

共通定義設定用ファイル（ローカルアクション機能）[1]

構成定義ファイル[1]

サービス起動遅延時間／タイマー監視時間定義ファイル（Windows限定）[1]

属性付加設定ファイル[1]

定義ファイル一覧[1]

ディレクトリサーバ変更ファイル（Windows限定）[1]

ディレクトリサーバ連携定義ファイル（Windows限定）[1]

転送設定ファイル[1]

配布定義ファイル[1]

パスワード定義ファイル（Windows限定）[1]

パスワード定義ファイル[1]

非SSL通信ホスト設定ファイル[1]

ヘルスチェック定義ファイル[1]

ホストアクセス制限定義ファイル[1]

ホストグループ定義ファイル[1]

ユーザー権限定義ファイル[1]

ユーザー権限レベルファイル[1]

ユーザーマッピング定義ファイル[1]

ローカルアクション環境変数ファイル[1]

ローカルアクション実行定義ファイル[1]

ログ情報定義ファイル[1]

ログファイルトラップ起動定義ファイル[1]

ログファイルトラップ動作定義ファイル[1]

ディスク占有量

UNIX[1]

Windows[1]

共有ディスク[1]

ディレクトリ一覧[1]

ディレクトリサーバ[1]

指定する[1]

用語解説[1]

ディレクトリサーバと連携してユーザー認証する場合の設定[1]

ディレクトリサーバ変更ファイル（Windows限定）[1]

ディレクトリサーバ連携[1]

ディレクトリサーバ連携機能

注意事項[1]

ディレクトリサーバ連携定義ファイル（Windows限定）[1]

転送設定ファイル[1]

転送設定ファイル（forward）[1]

定義情報を収集する[1]

定義情報を配布する[1]

と

同一ホスト上で物理ホスト環境と論理ホスト環境を構築する場合の設定[1]

統合トレース機能（HNTRLib2）[1]

設定する[1]

統合トレースログ[1]

動作定義ファイル（ntevent.conf）

定義情報を収集する[1]

定義情報を配布する[1]

動作定義ファイル（ログファイルトラップ機能用）

定義情報を収集する[1]

定義情報を配布する[1]

トラブルシューティング[1]

採取が必要な資料[1]

対処の手順[1]

対処方法（OS共通）[1]

対処方法（UNIX）[1]

対処方法（Windows）[1]

ヘルスチェック機能で異常を検知した場合[1]

に

認証サーバ[1]

GUIを使って設定する（Windows）[1]

コマンドを使って設定する（Windows）[1]

指定する（UNIX）[1]

指定する（Windows）[1]

信頼性を高めるための運用例[1]

認証サーバ設定後の作業[1]

用語解説[1]

ね

ネットワーク

構成に応じた通信設定[1]

設定の確認で使用するコマンド[1]

単一ネットワークでの運用[1]

ネットワークを分離した環境での運用（jp1hosts2情報の場合）[1]

ネットワークを分離した環境での運用（jp1hosts情報の場合）[1]

複数ネットワークでの運用[1]

は

配布定義ファイル[1]

パスワード[1]

［パスワード管理］ダイアログボックス[1]

保管形式の設定[1]

連携ユーザーのパスワード[1]

パスワード定義ファイル（Windows限定）[1]

パスワードポリシー定義ファイル[1]

バックアップ

jp1hosts2情報（UNIX）[1]

jp1hosts2情報（Windows）[1]

イベントDB（UNIX）[1]

共通定義情報（UNIX）[1]

共通定義情報（Windows）[1]

対象ファイル（UNIX）[1]

対象ファイル（Windows）[1]

定義ファイル（UNIX）[1]

定義ファイル（Windows）[1]

バックアップ（Windows）

イベントDB（Windows）[1]

パラメーターの分類[1]

張り返し通信[1]

ひ

非SSL通信ホスト設定ファイル[1]

ビューアー

用語解説[1]

標準ユーザー[1]

GUIを使って設定する（Windows）[1]

コマンドを使って設定する（Windows）[1]

設定する（UNIX）[1]

設定する（Windows）[1]

操作権限を設定する（UNIX）[1]

操作権限を設定する（Windows）[1]

用語解説[1]

ふ

ファイアウォール

通過方向[1]

定義情報の収集と配布[1]

ファイル一覧[1]

フェールオーバー[1]

用語解説[1]

複数LAN接続[1]

用語解説[1]

複数ネットワークでの運用[1]

物理ホスト

前提条件[1]

用語解説[1]

物理マージ機構[1]

プライマリー認証サーバ[1]

設定情報をコピーする（UNIX）[1]

設定情報をコピーする（Windows）[1]

用語解説[1]

プロセス

一覧（UNIX）[1]

一覧（Windows）[1]

用語解説[1]

プロセス管理[1]

プロセスのハングアップや異常終了を検知する[1]

プロセス別ログ[1]

へ

閉塞状態[1]

解除する（GUI）[1]

解除する（コマンド）[1]

確認する（GUI）[1]

確認する（コマンド）[1]

用語解説[1]

〜にする（GUI）[1]

〜にする（コマンド）[1]

閉塞中[1]

ヘルスチェック機能[1]

監視対象プロセス[1]

クラスタ運用[1]

他ホストの監視[1]

プロセス監視の仕組み[1]

ヘルスチェック機能で検知できる障害[1]

ヘルスチェック定義ファイル[1]

ほ

ポート番号一覧[1]

ホストアクセス制限定義ファイル[1]

ホストグループ定義ファイル[1]

ホスト名の変更[1]

ま

［マッピングOSユーザー詳細］ダイアログボックス[1]

マネージャー

用語解説[1]

め

メモリー所要量[1]

も

文字コード互換モードの設定手順[1]

ゆ

ユーザー管理[1]

設定する（UNIX）[1]

設定する（Windows）[1]

設定の流れ（UNIX）[1]

設定の流れ（Windows）[1]

注意事項（UNIX）[1]

注意事項（Windows）[1]

ユーザー管理機能

使用するコマンド[1]

初期設定値（UNIX）[1]

初期設定値（Windows）[1]

ユーザー権限定義ファイル[1]

ユーザー権限レベルファイル[1]

ユーザーダンプの出力設定[1]

ユーザー認証[1]、[2]

DSユーザーを使用する運用の場合の設定[1]

連携ユーザーを使用する運用の場合の設定[1]

ユーザー認証圏[1]

用語解説[1]

ユーザーマッピング[1]、[2]

一括して設定する（UNIX）[1]

一括して設定する（Windows）[1]

確認する（Windows）[1]

個別に削除する（UNIX）[1]

個別に削除する（Windows）[1]

個別に登録する（UNIX）[1]

個別に登録する（Windows）[1]

設定する（UNIX）[1]

設定する（Windows）（GUI）[1]

設定する（Windows）（コマンド）[1]

変更する（Windows）[1]

用語解説[1]

ユーザーマッピング定義ファイル[1]

ユーザーマッピングを設定する前にOSユーザーにユーザー権利を与える[1]

ユーザーを管理する[1]

よ

用語解説[1]

り

リカバリー

jp1hosts2情報（UNIX）[1]

jp1hosts2情報（Windows）[1]

イベントDB（UNIX）[1]

イベントDB（Windows）[1]

共通定義情報（UNIX）[1]

共通定義情報（Windows）[1]

定義ファイル（UNIX）[1]

定義ファイル（Windows）[1]

リモートインストール

UNIX[1]

Windows[1]

る

ルーティング[1]

ルスチェック機能を利用した障害対策の流れ[1]

れ

連携ユーザー[1]

GUIを使って設定する[1]

コマンドを使って設定する[1]

設定する[1]

用語解説[1]

連携ユーザーを使用する運用の場合の設定[1]

ろ

ローカルアクション[1]

用語解説[1]

ローカルアクション環境変数ファイル[1]

ローカルアクション実行定義ファイル[1]

ローカル ログオン[1]

ログ情報

種類[1]

ログ情報定義ファイル[1]

ログファイル一覧[1]

ログファイル監視ジョブを使用する場合[1]

ログファイルトラップ[1]、[2]

起動する[1]

自動で起動する[1]

終了する[1]

動作状況を確認する[1]

ログファイルトラップ起動定義ファイル[1]

ログファイルトラップ機能

クラスタ運用[1]

用語解説[1]

ログファイルトラップ動作定義ファイル[1]

ログファイルトラップによる監視の開始と終了[1]

ログファイルトラップの前提条件[1]

ログファイルの監視失敗時のリトライ[1]

ログメッセージおよびイベントログをJP1イベントに変換する[1]

論理ホスト[1]

サービスの起動管理[1]

削除する（UNIX）[1]

削除する（Windows）[1]

セットアップ（UNIX）[1]

セットアップ（Windows）[1]

前提条件[1]

非クラスタ環境での論理ホスト運用[1]

非クラスタ環境で論理ホストを運用する場合の設定[1]

用語解説[1]