【Hinemos】Hinemosエージェントと通信できないときのトラブルシューティング
投稿日： / 更新日：
こんにちは！
今回は、Hinemosエージェントをインストール後、Hinemosクライアントでエージェントがリポジトリ上に表示されていないときに確認したいことをまとめました。
以前に出ている「Hinemosエージェントがリポジトリ登録されないときに確認したいこと」のリメイク記事となります。本記事ではとくにver.7系用の設定方法について説明します。
■Hinemosエージェントをリポジトリ上に登録するために必要な手順と条件
まずは、Hinemosエージェントをリポジトリ上に登録するために必要な手順について、まとめました。
- 管理対象のマシンにHinemosエージェントをインストールする
- Hinemosエージェントをインストールしたマシンを、リポジトリ[ノード]ビューでノード登録する
また、上記の手順を実施した後、以下の条件がを満たしている必要があります。
- 登録したノード情報の「ノード名」とHinemosエージェントサーバのホスト名が一致していること
- 登録したノード情報の「IPアドレス」とエージェントサーバのIPアドレスが一致していること
次の項から、Hinemosエージェントがリポジトリ上に表示されない場合に確認することを説明します。
確認1「Hinemosエージェントが起動しているか確認する」
HinemosマネージャがHinemosエージェントを識別するためには、識別対象のHinemosエージェントが起動している必要があります。
Linux版Hinemosエージェントの場合は、
|
1 |
service hinemos_agent status |
または
|
1 |
systemctl status hinemos_agent |
でステータスを確認できます。
|
1 |
Hinemos Agent (PID 6000) is running... |
|
1 |
Active: active (running) since 〇〇 |
それぞれ上記のようなログが出た場合は起動していると判断できます。
Hinemosエージェントが停止している場合は、以下のコマンドで起動させてください。
|
1 |
service hinemos_agent start |
確認2「HinemosマネージャのIPアドレスがHinemosエージェントの設定ファイルに追記されているか確認する」
Hinemosエージェントでは、インストール時に接続先のHinemosマネージャのIPアドレスを指定できます。
しかし、インストール時にHinemosマネージャのIPアドレスが指定されていない場合、Hinemosマネージャ側がエージェントをリポジトリ登録することができません。
Hinemosエージェントのインストールフォルダ配下の【conf】フォルダ内にある「Agent.properties」を確認し、HinemosマネージャのIPアドレスが追記されていなかった場合は「Agent.properties」を以下のように編集します。
接続先マネージャのIPアドレスが指定されていない場合のAgent.properties
今回接続するHinemosマネージャのIPアドレスは【10.2.40.100】なので、IPアドレスの部分を書き換えます。
接続先マネージャのIPアドレス書き換え後のAgent.properties
また、ここでの注意点として、ver.7以降のHinemosマネージャのデフォルトのポート番号は8083となっています。
ver.6以前ではデフォルトの受付ポート番号が8081となっていましたが、受付ポート番号8081はHinemosプロパティ「ws.agent.address」で
指定されているため、互換性のある旧バージョンのエージェントとの接続にて利用されています。
Hinemosプロパティ「rest.agent.address」の受付ポート番号を変更する
場合、ポート番号8081、8080以外の値を指定してください。
Agent.propertiesを編集した後は、Hinemosエージェント再起動します。
確認3「HinemosエージェントのファシリティIDを設定ファイルに追記する」
上記2つの確認項目をクリアしても、HinemosマネージャがHinemosエージェントを識別しない場合があります。
HinemosエージェントはIPアドレスとホスト名から、自身のファシリティIDを特定しますが、NATなどの利用でIPアドレスが変換されてしまう環境等では、 この機能は正常に動作しません。
上記のようにIPアドレスが変換されてしまう環境では、HinemosエージェントのファシリティIDを手動で追記する必要があります。
HinemosエージェントのファシリティIDを手動で追記するためには、確認2と同じく、Hinemosエージェントのインストールフォルダ配下の【conf】フォルダ内にある「Agent.properties」を編集します。
ファシリティIDが手動で追記されていないAgent.properties
青い枠線の【facilityId】の値に、Hinemosエージェントをインストールしたマシンのファシリティ名を入力します。
入力する際は先頭の#を削除し、コメントアウトを外してください。
ファシリティIDを手動で入力したAgent.properties
上記のファシリティIDを手動で設定したのち、確認2の手順と同様、Hinemosエージェントを再起動してください。
最後に、確認1～3を実施したHinemosエージェントが、マネージャに識別されているかどうかを確認してみます。
まずは、確認3の手順を実施後、Hinemosエージェントを再起動しないままリポシジトリ[エージェントビュー]を確認してみます。
表示件数0件
Hinemosエージェントを再起動した後、リポジトリ[エージェント]ビューをリロードします。
表示件数1件
Hinemosエージェントが識別されました！
■最後に
Hinemosエージェントがなかなか識別されない場合は上記3つの手順を参考に、設定内容を確認してみてください。
ご覧いただきありがとうございました！
