クイックスタートガイド

1. Red Hat Enterprise Linux 7.5 以降。
2. 最新の Red Hat Gluster Storage バージョン 3.5 以降に更新された Red Hat Gluster Storage サーバー。アップグレードプロセスの詳細は、Red Hat Gluster Storage インストールガイドの Red Hat ストレージのアップグレード セクションを参照してください。

3. ハードウェアの最小要件。

   注記

   詳細は、ナレッジベースのアーティクル Red Hat Gluster Storage Hardware Compatibility を参照してください。

4. Network Time Protocol (NTP) の設定。
5. ポートへのファイアウォールアクセス。

1. インストールプロセスを続行する前に、必要なポートを開きます。

2. tendrl_server および gluster_serversグループの両方に適用されるインベントリーファイルの [all:vars] セクションで、configure_firewalld_for_tendrl 変数を False に設定します。本ガイドの 3.5 Web Administration のインストール 手順の最後の インベントリー変数の例 で説明されている変数の例を参照してください。

   注記

   インベントリーファイルは、Web Administration Ansible のインストールプロセスの一部として作成されます。

3. 本ガイドの Web Administration のインストール の手順に従います。

1. Web Administration サーバーおよびすべての Gluster ストレージサーバーで、以下のリポジトリーを有効にします。

   # subscription-manager repos --enable=rhel-7-server-rpms
   
   # subscription-manager repos --enable=rhel-7-server-ansible-2-rpms

   Copy to Clipboard Toggle word wrap

2. Web 管理サーバーで以下のリポジトリーを有効にします。

   # subscription-manager repos --enable=rh-gluster-3-web-admin-server-for-rhel-7-server-rpms

   Copy to Clipboard Toggle word wrap

3. すべての Gluster ストレージサーバーで以下のリポジトリーを有効にします。

   # subscription-manager repos --enable=rh-gluster-3-for-rhel-7-server-rpms
   # subscription-manager repos --enable=rh-gluster-3-web-admin-agent-for-rhel-7-server-rpms

   Copy to Clipboard Toggle word wrap

4. ローカルホスト(ローカルホストへのSSH接続)に加えて、Web Administration サーバーシステムからリモートの Gluster サーバーへのパスワードなしの SSH 接続を設定します。

   注記

   SSHキーベース認証の設定方法は、Red Hat Enterprise Linux システム管理者のガイド の 鍵ベースの認証の使用 セクションを参照してください。

5. httpd パッケージがすでに Web Administration サーバーにインストールされている場合は、httpd サービスを停止してからインストールを続行します。

   # systemctl stop httpd

   Copy to Clipboard Toggle word wrap

1. Web Administration サーバーに最新バージョンの Ansible および tendrl-ansible をインストールします。
2. 必須およびオプションの ansible 変数を使用して、必要なグループ tendrl_server および gluster_servers でインベントリーファイルを作成します。
3. site.yml Playbook を実行し、Web Administration 環境にアクセスします。

1. tendrl_server: Web Administration サーバーとして機能するマシンが 1 台含まれます。
2. gluster_servers: すべての Red Hat Gluster Storage ノードが含まれます。

1. tendrl-ansible.tendrl-server: インベントリーファイルの tendrl_server グループに属する Web Administration サーバーのタスクが含まれます。

   注記

   このロールおよび変数の詳細は、/usr/share/ansible/roles/tendrl-ansible.tendrl-server/README.mdのパスで利用可能な tendrl-ansible パッケージからの README ファイルを参照してください。

2. tendrl-ansible.tendrl-storage-node: インベントリーファイルの gluster_servers グループに属する Red Hat Gluster Storage ノードのタスクが含まれます。

手順Web Administration のインストール

1. Web Administration サーバーに最新バージョンの Ansible および tendrl-ansible をインストールします。

   # yum install tendrl-ansible

   Copy to Clipboard Toggle word wrap
   注記

   以下の手順を実行する前に、最新の Ansible パッケージを rhel-7-server-ansible-2-rpms チャネルから取得していることを確認します。さらに、Web Administration サーバーの Ansible のバージョンが、ストレージノードで利用可能なものと同じであることを確認します。

   注記

   Web Administration の最新バージョンは、Ansible の最新バージョンと互換性があります。Web Administration は、Ansible 2.5 より前のバージョンと互換性がありません。

2. 2 つの Ansible グループ tendrl_server および gluster_servers で、Ansible インベントリーファイルを作成します。以下の例のように、インベントリーファイル内のすべてのホストに FQDN を使用するようにしてください。

   インベントリーグループの例

   [tendrl_server]
   tendrl.example.com
   
   [gluster_servers]
   
   gl1.example.com
   gl2.example.com
   gl3.example.com
   gl4.example.com

   Copy to Clipboard Toggle word wrap
   注記

   インベントリーファイルの設定方法は、Ansible ドキュメント で Ansible インベントリーファイルの設定を参照してください。

3. 以下の必要な Ansible 変数を、対応する値と共にインベントリーファイルに追加します。

   • etcd_ip_address: etcd インスタンスがリッスンする場所を設定します。
   • etcd_fqdn: Web Administration コンポーネントが etcd に接続できるように設定します。

   • graphite_fqdn: graphiteに接続できるように Web Administration コンポーネントを設定します。

     インベントリー変数の例

     [all:vars]
     
     etcd_ip_address=192.0.2.1
     etcd_fqdn=tendrl.example.com
     graphite_fqdn=tendrl.example.com

     Copy to Clipboard Toggle word wrap
   注記

   詳細は、このインストールワークフローの最後の インベントリー変数の例 を参照してください。

4. 必要に応じて、インベントリーファイルに他の任意の変数を追加します。その他の変数は、Ansible ロールの README ファイル (以下のパスを参照) に記載されています。etcd-tls クライアント認証など、変数に値を指定して、機能を有効または無効にします。詳細な TLS 設定手順は、本ガイドの 第 5 章: TLS 暗号化設定 を参照してください。

   # /usr/share/ansible/roles/tendrl-ansible.tendrl-server/README.md
   # /usr/share/ansible/roles/tendrl-ansible.tendrl-storage-node/README.md

   Copy to Clipboard Toggle word wrap
   注記

   ファイアウォール設定変数はデフォルトで有効になっています。

   注記

   インベントリーファイルの設定の詳細は、インストール時に提供され、次のパスにある README.md ファイルを参照してください。

   # less /usr/share/doc/tendrl-ansible-1.6.3/README.md

   Copy to Clipboard Toggle word wrap

5. インベントリーファイルが格納されている作業ディレクトリーに site.yml Playbook をコピーします。

   # cp /usr/share/doc/tendrl-ansible-1.6.3/site.yml .

   Copy to Clipboard Toggle word wrap

6. prechecks.yml ファイルをインベントリーファイルのディレクトリーにコピーします。

   # cp /usr/share/doc/tendrl-ansible-1.6.3/prechecks.yml .

   Copy to Clipboard Toggle word wrap

7. Web Administration サーバーシステムからリモートの Gluster サーバーへのパスワードなしの SSH 接続を設定します。

   注記

   SSHキーベース認証の設定方法は、Red Hat Enterprise Linux システムの管理者ガイド の 鍵ベースの認証の使用 セクションを参照してください。

8. 以下を実行して、パスワードまたは公開鍵の検証を必要とせずに、インベントリーファイルからすべてのノードに SSH 接続できることを確認します。

   # ansible -i <inventory_file> -m ping all

   Copy to Clipboard Toggle word wrap

   例

   # ansible -i <inventory_file> -m ping all
   gl3.example.com | SUCCESS => {
       "changed": false,
       "failed": false,
       "ping": "pong"
   }

   Copy to Clipboard Toggle word wrap
   注記

   上記の例で示すように、Ansible は、すべてのノードについて SUCCESS と pong メッセージを返すはずです。SSH 接続が正常に確立されるまで続行しないでください。

9. Web Administration の最小要件およびセットアップが満たされているかを確認するには、prechecks Playbook を実行します。

   # ansible-playbook -i <inventory_file> prechecks.yml

   Copy to Clipboard Toggle word wrap
   注記

   不足している要件がある場合は、prechecks Playbook により即座に検出されるので、インストールを実行する前に特定の問題に注意を促します。

10. 以下のコマンドを使用して、準備済みの site.yml Playbook を実行し、Web Administration サーバーとストレージノードを設定します。

    # ansible-playbook -i <inventory_file> site.yml

    Copy to Clipboard Toggle word wrap
11. Web Administration 環境にログインします。ログイン手順は、本ガイドの Web Administration へのログイン の章を参照してください。

Gluster ストレージノードで:

1. ストレージノード上の Web Administration サービスをすべて停止して無効にします。
2. Ansible リポジトリーを有効にし、その他の必要なリポジトリーが有効になっていることを確認します。
3. Red Hat Gluster Storage をバージョン 3.5 にアップグレードします。

Web Administration サーバーで:

1. Web Administration サーバーで Red Hat Enterprise Linux をアップグレードします。
2. Gluster 3.5 クラスターをインポートします。

Web Administration サーバーで:

1. すべての Web Administration サービスを停止します。

   1. tendrl-monitoring-integration サービスを停止するには、以下を実行します。

      # systemctl stop tendrl-monitoring-integration

      Copy to Clipboard Toggle word wrap

   2. tendrl-node-agent サービスを停止するには、以下を実行します。

      # systemctl stop tendrl-node-agent

      Copy to Clipboard Toggle word wrap

   3. tendrl-notifier サービスを停止するには、以下を実行します。

      # systemctl stop tendrl-notifier

      Copy to Clipboard Toggle word wrap

   4. tendrl-api サービスを停止するには、以下を実行します。

      # systemctl stop tendrl-api

      Copy to Clipboard Toggle word wrap

   5. etcd サービスを停止するには、以下を実行します。

      # systemctl stop etcd

      Copy to Clipboard Toggle word wrap

   6. carbon-cache サービスを停止するには、次のコマンドを実行します。

      # systemctl stop carbon-cache

      Copy to Clipboard Toggle word wrap

2. Web Administration サーバーですべてのパッケージを更新します。

   # yum update

   Copy to Clipboard Toggle word wrap

3. tendrl-upgrade スクリプトを実行します。

   # tendrl-upgrade

   Copy to Clipboard Toggle word wrap
4. 同じ初期インストール設定で、tendrl-ansible Playbook を実行します。手順は、Web Administration のインストール セクションのステップ 2 から 9 を参照してください。

5. カーネルパッケージの更新が行われたら、サーバーシステムを再起動します。更新が行われない場合は、Web Administration サービスを再起動します。

   # systemctl restart httpd
   # systemctl restart etcd
   # systemctl restart carbon-cache
   # systemctl restart tendrl-node-agent
   # systemctl restart tendrl-monitoring-integration
   # systemctl restart tendrl-notifier
   # systemctl restart tendrl-api

   Copy to Clipboard Toggle word wrap