本シリーズについて

本シリーズは、Hinemosは聞いたことはあるけど、何ができるの？どうすれば使えるの？という人を対象に、Hinemosのセットアップから基本的な利用方法について記載しています。 本シリーズのドキュメント通りに進めていただくことで、Hinemosに触れたことがない人でも、Hinemosを使いこなす最初の一歩を踏み出していただける内容になっています。
Hinemosとは？という方は、まずはこちらをご覧ください。 入門編①Hinemosを動かしてみようでは、Hinemosのセットアップ手順と簡単な操作方法について記載しています。まずは、Hinemosをいろいろと操作できる環境を作っていきましょう。

前提

本ドキュメントでは、お手元にWindowsが動作するPCがあり、その上でVMware Workstation Playerが動作する環境があることを前提とします。

注意事項

本ドキュメントに登場するHinemos本体のバージョン番号（7.2.*）はご利用のバージョンに適宜読み替えてください。

免責事項

本ソフトウェアの使用・本ドキュメントに従った操作により生じたいかなる損害に対しても、弊社は一切の責任を負いません。

環境構築に必要なパッケージの入手方法

Hinemosをセットアップするにあたり、VMware Workstation PlayerとRHELをダウンロードし、VMware Workstation Player上に2台のゲストOSとして、RHEL10.1をインストールしてください。

本書ではRHEL10.1を使用する前提で記載していますが、Hinemosの動作要件にある別LinuxのOSおよびバージョンについては、適宜ご利用の環境に読み替えてください。

1. 1. VMware Workstation Playerのダウンロード

   Windows版のVMware Workstation Player をダウンロードしてください。

2. 2. RHEL のダウンロード

   下記のサイトから、RHEL10.1をダウンロードしてください。

   RHELのダウンロード（外部リンク）

本ドキュメントで構築するシステム構成

Hinemosは、マネージャ、管理対象ノード、クライアントから構成されます。

• Hinemosマネージャ

  • - Hinemosの運用管理機能を提供するサーバ。
  • - Hinemosマネージャをインストールします。
  • - Windows11上のVMware Workstation PlayerのゲストOS1として構築します。

• 管理対象ノード

  • - Hinemosの管理対象となるマシン。
  • - ジョブ機能や、一部の監視機能を使用する場合は、Hinemosエージェントをインストールする必要があります。入門編①では、Hinemosエージェントは使用しません。
  • - Windows11上のVMware Workstation PlayerのゲストOS2として構築します。

• Hinemosクライアント

  • - オペレータが操作する端末。
  • - ブラウザ経由でアクセスできるWebクライアント。
  • - Windows11上のVMware Workstation PlayerのゲストOS1にWebクライアントを構築します。
  • - Windows11上のブラウザ（Microsoft Edge）を使用します。
  

Hinemosのセットアップ

Hinemosパッケージのダウンロードから、インストール・起動までを説明します。

1. 1. Hinemosパッケージのダウンロード

   HinemosはOSSの統合運用管理ツールですので、GitHubのHinemosプロジェクト（外部リンク）よりどなたでも自由にダウンロードできます。まずは、はじめに今回のセットアップで使用するHinemosマネージャのパッケージとHinemosクライアントのパッケージを以下のサイトからダウンロードしましょう。

   【本体(マネージャ/エージェント/クライアント)パッケージは、こちら】

   次のパッケージをダウンロードしてください。

   • ・ hinemos-7.2-manager-7.2.x-1.el10.x86_64.rpm
   • ・ hinemos-7.2-web-7.2.x-1.el10.x86_64.rpm

   ダウンロードするパッケージは、一番新しいバージョンをダウンロードしてください。

2. 2. Hinemosマネージャのセットアップ

   次に rhel-manager にHinemosマネージャをインストールしていきますが、その前に以下の4点を確認しておきましょう。

   • ・SELinuxが無効になっているか

     HinemosマネージャはSELinuxが有効になっている場合は、インストールできません。あらかじめSELinuxを無効(disabled)に設定しておく必要があります。

     [root@rhel-manager ~]# cat /etc/selinux/config
     …
     # NOTE: In earlier Fedora kernel builds, SELINUX=disabled would also
     # fully disable SELinux during boot. If you need a system with SELinux
     # fully disabled instead of SELinux running with no policy loaded, you
     # need to pass selinux=0 to the kernel command line. You can use grubby
     # to persistently set the bootloader to boot with selinux=0:
     #
     #    grubby --update-kernel ALL --args selinux=0
     #
     # To revert back to SELinux enabled:
     #
     #    grubby --update-kernel ALL --remove-args selinux
     #
     SELINUX=disabled
     …
     

     上記のように「SELINUX」のパラメータとして「enforcing」が設定されている場合は、SELinuxが有効となっているため、上記の「enforcing」を「disabled」に変更して、サーバを再起動してください。

   • ・firewalldが適切に設定されているか

     Hinemosマネージャへ接続する際に、接続時に使用するポートがHinemosクライアントから接続可能な状態である必要があります。OSのインストール直後は、firewalldが有効になっており使用ポートに対する通信がREJECTされる設定となっている可能性があるため、Hinemosマネージャ側の待ち受けポートの許可設定を適切に行う必要があります。

     お試しで使っていただく分には、Hinemosマネージャのfirewalldを止めていただければ利用可能な状態となるため、ここではfirewalldを停止する方法を紹介します。

     [root@rhel-manager ~]# systemctl stop firewalld

     Hinemosを利用する上で必要となるネットワーク条件については、以下のドキュメントに詳細な情報が記載されています。

     - Hinemos ver.7.2 基本機能マニュアル 2.2.9 ネットワークの要件

     実際に運用する環境にHinemosをセットアップする場合は、上記のドキュメントの情報を基に、適切に待ち受けポートの設定を行ってください。

   • ・Java8がインストールされているか

     Hinemos7.2系のマネージャは、Java8にて動作するため、Java8が事前にインストールされている必要があります。

     RHEL10.1では、java-1.8.0-openjdkが提供されていないため、Hinemosサブスクリプション契約することで利用できるHinemos JRE、もしくはAmazon Correttoを使用します。

     以下ではAmazon Correttoをインストールする手順例をご紹介します。

     Amazon CorrettoのRPMファイルを以下よりダウンロードしましょう。

     https://docs.aws.amazon.com/ja_jp/corretto/latest/corretto-8-ug/downloads-list.html

     取得したRPMファイルをrhel-manager上に配置し、Amazon Correttoをインストールします。

     [root@rhel-manager ~]# rpm -ivh java-1.8.0-amazon-corretto-devel-1.8.0_482.b08-1.x86_64.rpm
     警告: java-1.8.0-amazon-corretto-devel-1.8.0_482.b08-1.x86_64.rpm: ヘッダー V4 RSA/SHA256 Signature、鍵 ID b04f24e3: NOKEY
     検証しています...              ################################# [100%]
     準備しています...              ################################# [100%]
     更新中 / インストール中...
     1:java-1.8.0-amazon-corretto-devel-################################# [100%]

   • ・その他必要なパッケージについて

     その他にもHinemos ver.7.2のマネージャを動作させるために、以下のパッケージをインストールしておく必要があります。

     • - vim-common
     • - unzip

     インターネットに接続できる環境であれば、yumコマンドでインストール可能ですので、インストールされていない場合はインストールしてください。

   • ・OSのホスト名に対して名前解決ができているか

     動作環境によっては、ホスト名の名前解決ができないため、Hinemosマネージャがうまく動作しないことがあります。

     rhel-managerに自身のホスト名が登録されているか確認してください。まずは、rhel-managerのホスト名を確認します。

     [root@rhel-manager ~]# hostname
     rhel-manager

     次に、pingコマンドでホスト名rhel-managerを名前解決できるか確認します。

     [root@rhel-manager ~]# ping rhel-manager
     PING rhel-manager.hinemos.nttdata.co.jp (172.16.57.199) 56(84) バイトのデータ
     64 バイト応答 送信元 rhel-manager (172.16.57.199): icmp_seq=1 ttl=64 時間=0.062ミリ秒
     64 バイト応答 送信元 rhel-manager (172.16.57.199): icmp_seq=2 ttl=64 時間=0.061ミリ秒
     ...

     上記メッセージが表示されていたら、ホスト名rhel-managerは名前解決できています。Ctrl-Cでpingコマンドを止めましょう。

     上記メッセージが表示されなかった場合、DNSサーバまたは/etc/hostsにホスト名を登録しましょう。DNSサーバにホスト名を登録する方法については、利用しているDNSサーバの登録手順に従って登録してください。

     /etc/hostsにrhel-managerのホスト名を登録する場合

     [root@rhel-manager ~]# echo 172.16.57.199 rhel-manager >> /etc/hosts
     [root@rhel-manager ~]# cat /etc/hosts
     ...
     172.16.57.199 rhel-manager
     

     以上で事前準備は完了です。
     それでは、Hinemosマネージャをインストールしていきましょう。

     1. 2-1. ダウンロードした「hinemos-7.2-manager-7.2.x-1.el10.x86_64.rpm」を rhel-manager 上に配置します。
     2. 2-2. rhel-manager に root ユーザでログインします。
     3. 2-3. rpmコマンドを使いインストールを行います。/root 配下にインストールパッケージを配置している場合は、以下のように行います。

        [root@rhel-manager ~]# cd /root
        [root@rhel-manager ~]# rpm -ivh hinemos-7.2-manager-7.2.0-1.el10.x86_64.rpm
        検証しています...              ################################# [100%]
        準備しています...              ################################# [100%]
        更新中 / インストール中...
        1:hinemos-7.2-manager-0:7.2.0-1.el1################################# [100%]
        (省略)

        Hinemosマネージャをインストール後、Hinemosマネージャが動作するためのJAVA_HOMEの設定を変更します。

        「Java8がインストールされているか 」で事前にインストールしたJavaのインストール先に合わせ、hinemos.cfgを修正します。

        hinemos.cfg内の「JAVA_HOME」、「JAVA_SDK_HOME」をインストールしたJavaのパスに変更しましょう。

        [root@rhel-manager ~]# vi /opt/hinemos/etc/hinemos.cfg
        # Copyright (c) 2018 NTT DATA INTELLILINK Corporation. All rights reserved.
        #
        # Hinemos (http://www.hinemos.info/)
        #
        # See the LICENSE file for licensing information.
        ### Software Attributes
        export HINEMOS_MANAGER_ID=
        export HINEMOS_HOME=/opt/hinemos
        export HINEMOS_ETC_DIR=/opt/hinemos/etc
        export HINEMOS_LOG_DIR=/opt/hinemos/var/log
        export HINEMOS_MANAGER_SERVICE=hinemos_manager
        export HINEMOS_PG_SERVICE=hinemos_pg
        export DBPORT=24001
        
        export JAVA_HOME=/usr/lib/jvm/java-1.8.0-amazon-corretto/jre
        export JAVA_SDK_HOME=/usr/lib/jvm/java-1.8.0-amazon-corretto/jre
        
        #export JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk
        #export JAVA_SDK_HOME=/usr/lib/jvm/java-1.8.0-openjdk
        …
        

        では、続いてインストールしたHinemosマネージャを起動してみましょう。serviceコマンドを使いHinemosマネージャを起動します。

        [root@rhel-manager ~]# service hinemos_manager start
        Redirecting to /bin/systemctl start hinemos_manager.service

        Hinemosマネージャが起動したら、最後にnetstatコマンドを使いrhel-managerの8080番ポートがListenされているか確認しましょう。

        [root@rhel-manager ~]# netstat -aon | grep 8080
        tcp6       0      0 :::8080                 :::*                    LISTEN      off (0.00/0/0)

        netstatコマンドが使えない環境の場合、ssコマンドを使って確認します。

        [root@rhel-manager ~]# ss -lnt | grep 8080
        LISTEN 0      4096               *:8080             *:*

        上記メッセージが表示されればHinemosマネージャの起動は無事完了です。

3. 3. Hinemosクライアントのセットアップ

   次に、rhel-manager にHinemos Webクライアントをセットアップします。

   1. 3-1. ダウンロードした「hinemos-7.2-web-7.2.x-1.el10.x86_64.rpm」を rhel-manager 上に配置します。
   2. 3-2. rhel-manager に root ユーザでログインします。
   3. 3-3. rpmコマンドを使いインストールを行います。/root 配下にインストールパッケージを配置している場合は、以下のように行います。

      [root@rhel-manager ~]# cd /root
      [root@rhel-manager ~]# rpm -ivh hinemos-7.2-web-7.2.0-1.el10.x86_64.rpm
      検証しています...              ################################# [100%]
      準備しています...              ################################# [100%]
      更新中 / インストール中...
      1:hinemos-7.2-web-0:7.2.0-1.el10   ################################# [100%]
      Created symlink '/etc/systemd/system/multi-user.target.wants/hinemos_web.service' → '/usr/lib/systemd/system/hinemos_web.service'.

      Hinemos Webクライアントをインストール後、Hinemos Webクライアントが動作するためのJAVA_HOMEの設定を変更します。

      「Java8がインストールされているか 」で事前にインストールしたJavaのインストール先に合わせ、hinemos_web.cfgを修正します。

      hinemos_web.cfg内の「JAVA_HOME」、「JAVA_SDK_HOME」をインストールしたJavaのパスに変更しましょう。

      [root@rhel-manager ~]# /opt/hinemos_web/conf/hinemos_web.cfg
      # Copyright (c) 2018 NTT DATA INTELLILINK Corporation. All rights reserved.
      #
      # Hinemos (http://www.hinemos.info/)
      #
      # See the LICENSE file for licensing information.
      ### Server Attributes
      export SERVICE_STARTUP_WAIT=false
      ### Software Attributes
      export HINEMOS_WEB_ID=
      export HINEMOS_WEB_HOME=/opt/hinemos_web
      export HINEMOS_WEB_ETC_DIR=/opt/hinemos_web/conf
      export HINEMOS_WEB_LOG_DIR=/opt/hinemos_web/var/log
      export HINEMOS_WEB_SERVICE=hinemos_web
      
      export JAVA_HOME=/usr/lib/jvm/java-1.8.0-amazon-corretto/jre
      export JAVA_SDK_HOME=/usr/lib/jvm/java-1.8.0-amazon-corretto/jre
      
      #export JAVA_HOME=/usr/lib/jvm/jre-1.8.0-openjdk
      #export JAVA_SDK_HOME=/usr/lib/jvm/java-1.8.0-openjdk
      …
      

      では、続いてインストールしたHinemos Webクライアントを起動してみましょう。serviceコマンドを使いHinemosマネージャを起動します。

      [root@rhel-manager ~]# service hinemos_web start
      Redirecting to /bin/systemctl start hinemos_web.service

      上記メッセージが表示されればHinemos Webクライアントの起動は無事完了です。

Hinemosへの管理対象の登録

Hinemosへのログインから、管理対象の登録までを説明します。

windows_client 上のブラウザを起動し、Hinemosマネージャに接続してみましょう。

1-1. ブラウザを起動し、Hinemos Webクライアントをインストールしたサーバにアクセスします。今回の場合、接続先URLは「http://172.16.57.199」です。

1-2. Hinemosマネージャにログインします。「接続[ログイン]」ダイアログが表示されますので、各項目を入力します。

• ユーザID

  ログインユーザを入力します。インストール直後は、「hinemos」ユーザしか存在しないため、「hinemos」と入力します。

• パスワード

  ログインユーザのパスワードを入力します。「hinemos」ユーザのデフォルトのパスワードは「hinemos」ですので、こちらも「hinemos」と入力します。

• 接続先URL

  Hinemosマネージャへ接続するURLを入力します。接続先URLは、「http://(「Hinemosのセットアップ」2-3.で控えたHinemosマネージャのIPアドレスとポート番号)/HinemosWeb/」と入力します。

マルチマネージャ接続

◆1つのHinemosクライアントから複数のHinemosマネージャにログインし、 各Hinemosマネージャに対して設定や監視結果の確認等を行うことができます。「接続[ログイン]」ダイアログの「ログイン先を追加」ボタンを押すと、ユーザID、パスワード、接続先URLを入力する欄が追加されるので、追加でログインしたいHinemosの情報を入力し、「ログイン」ボタンを押します。

1-3. ログイン時の設定が適切であれば、ログイン成功のダイアログが表示されます。
「OK」ボタンを押すと以下のようなHinemosクライアントの初期画面が表示されます。

上記のように、画面右下にログインユーザと接続先URLが表示されれば、ログイン完了です。

Hinemosでは、管理対象を登録するデータベースをリポジトリと呼んでおり、最初に管理対象をリポジトリに登録する必要があります。では、実際に、rhel-nodeを管理対象として登録してみましょう。

2-1. 「リポジトリ」パースペクティブをメニューバーから表示します。

2-2. 「リポジトリ[ノード]」ビューの右上のアイコンから「作成」を選択します。

2-3. 監視対象ノードの情報を入力し、「登録」ボタンを押します。ピンクの背景色で表示されている内容は必須の設定項目となります。以下のように設定してください。

• ファシリティID

  個々の管理対象ノード及びスコープを識別するため付与する文字列です。ノードやスコープの登録を行なう際に、システム内で一意になるように付与します。スコープについては、のちほど説明します。

• ファシリティ名

  ファシリティIDと同様、管理対象ノード及びスコープに対して付与する文字列です。任意に設定することができるため、運用者が見て管理対象ノードを識別しやすい文字列を設定します。

• プラットフォーム

  設定時に「Linux」、「Windows」、「Android」、「Network Equipment」、「Other」より管理対象のプラットフォームを選択します。

• IPアドレスのバージョン

  管理対象と通信を行う際に使用するIPアドレスのバージョンを指定します。「4」、「6」の2種類から選択します。また、選択したバージョンのIPアドレスは必須の設定項目となります。

• ノード名

  管理対象のホスト名を入力します。

2-4.「リポジトリ[ノード]」ビューにて管理対象が登録されたことを確認します。

2-5. 次に、デバイスサーチを利用してrhel-managerを管理対象として登録しましょう。
デバイスサーチは、SNMP経由で対象の情報の一部を取得し、適切な項目に設定します。
再度「リポジトリ[ノード]」ビューの右上のアイコンから「作成」を押し、以下のようにデバイスサーチのIPアドレス欄に、rhel-managerのIPアドレスを入力し、Searchボタンを押してください。

2-6. ファシリティIDとファシリティ名を手動で以下のように設定し、「登録」ボタンを押してください。

以上で管理対象の登録は完了です。

ノードサーチ

◆ノードサーチ機能を利用することで、指定したIPアドレスの範囲を探索し、SNMPの応答があるノードに関してはノード情報を自動で登録することができます。リポジトリ[ノード]ビューの『ノードサーチ』ボタンを押して、リポジトリ[ノードサーチ]ダイアログを開きます。

Hinemosでは、管理対象に対して監視やジョブ実行など様々な操作を行えますが、管理対象一台一台に対して設定していくのは煩雑で手間がかかります。そこで、Hinemosでは『スコープ』という管理対象を自由にグループ化できる仕組みを持っており、監視やジョブの対象をスコープ単位で設定することができます。
それでは、「スコープ」を作成し、管理対象を割り当ててみましょう。

3-1. 「リポジトリ[スコープ]」ビューの右上のアイコンから「作成」を選択します。

3-2. スコープの情報を入力し、「登録」ボタンを押します。ピンクの背景色で表示されている内容は必須の設定項目となります。以下のように設定してください。

• ファシリティID

  管理対象ノードのファシリティIDと同様、個々のスコープを識別するため付与する文字列です。システム内で一意になるように付与します。なお、ファシリティIDは、管理対象ノードと共通の情報として扱われます。そのため、管理対象ノードと同じファシリティIDは使用できない点は注意してください。

• ファシリティ名

  管理対象ノードのファシリティ名と同様、任意に設定することができるため、運用者が見て管理対象ノードを識別しやすい文字列を設定します。

3-3. 作成したスコープに管理対象ノードを割り当てます。「リポジトリ[スコープ]」ビューで作成したスコープをフォーカスした状態で、右上のアイコンから「割当て」を選択します。

3-4. 登録した管理対象ノード一覧が表示されるため、割当てたい管理対象ノードを選択し(複数選択可)、「割当て」ボタンを押します。

3-5. 登録が完了したら、「リポジトリ[スコープ]」ビューにて対象スコープに管理対象ノードが割当てられたことを確認します。

以上で、Hinemosへの管理対象の登録は完了です。

Hinemosから管理対象の状態を見る

入門編①の最後に、簡単な監視設定を行い、管理対象の状態を確認するところまでを説明して終わりたいと思います。

Hinemosは多くの監視機能を有していますが、ここでは最もシンプルなpingの応答があるかどうかを確認するPING監視の設定を行います。

1-1. 「監視設定」パースペクティブをメニューバーから表示します。

1-2. 「監視設定[一覧]」ビューの右上のアイコンから「作成」を選択します。

1-3. 「監視種別」ダイアログから「PING監視 (数値)」を選択します。

1-4. PING監視の設定を入力し、「OK」ボタンを押します。ピンクの背景色で表示されている内容は必須の設定項目となります。以下のように設定してください。

• 監視項目ID

  監視項目を登録する際にユーザが定義する文字列です。監視結果にもれなく表示されますので、監視内容を判別できるようなIDを設定することをお勧めします。システム内で一意になるように設定します。

• スコープ

  監視対象のスコープ、もしくはノードを選択します。

• 条件：間隔

  監視間隔を指定します。大量に監視設定を行った場合のHinemosマネージャへの負荷を考慮し、原則5分以上の設定を推奨していますが、動作確認等で利用する場合は待ち時間を短くするため、1分の指定も可能です。

• アプリケーション

  運用にあわせ任意の文字列を設定することができます。こちらも監視結果に表示されますので、運用する人が見て判断しやすい内容を設定することをお勧めします。

  以下の内容は必須の設定項目ではありませんが、監視設定にはほぼ必須の内容です。

• 通知ID

  通知方法として使用する通知設定の通知IDを指定します。選択ボタンを押すことで、監視結果に適用する通知IDの選択画面が表示されます。Hinemosクライアントへの表示やメールによる通知など、様々な通知方法を選択できます。通知の詳細は、今後の入門編で紹介していきます。

1-5. 「監視設定[一覧]」ビューにてPING監視設定が登録されたことを確認します。

以上でPING監視の設定は終了です。

先ほど設定したPING監視の結果を確認してみましょう。「監視」パースペクティブをメニューバーから表示します。

監視対象からのpingの応答がある場合は、管理対象の台数分（今回は2台分）の監視結果が緑色（重要度：情報）で出力されます。

rhel-nodeを停止しpingの応答を返せないようにした場合は、以下のように応答が返せなくなった管理対象の台数分（今回は1台分）の監視結果が赤色（重要度：危険）で出力され、利用者に障害の発生を知らせます。

改訂 Hinemos統合管理[実践]入門

Hinemos ver.6.2の[実践]入門の本が販売中です。
内容はHinemos ver.6.2以降でHinemosをより詳しく知りたい方には、お勧めの一冊です。

Hinemosではじめる 実践ジョブ管理・自動化入門

Hinemos ver.7.0のジョブ管理、自動化を中心に記載した本が販売中です。
ジョブ管理、自動化についてより詳しく知りたい方には、お勧めの一冊です。