NodeにSSHで接続し、GridDBのインストールや設定を行います。ノード追加を行うことを支援するテンプレートです。クラスタ構成の接続方式は、マルチキャスト方式に対応しています。GridDBクラスタを新規作成します。GridDBクラスタの設定を取得します。GridDBクラスタの設定を変更します。GridDBクラスタにノードを追加します。本テンプレートはインストールメディアの/misc/ansible-template/ansible-template.zipに含まれています。zipファイルを展開して利用します。zipファイル展開後のファイル構成は以下の通りです。本テンプレートは以下の環境で動作を確認しています。Editionで動作を確認しています。インストール手順インストールの手順を説明します。NodeにSSHで接続できることを確認します。NodeにPythonがインストールされていることを確認します。Ansibleは/usr/bin/pythonを参照します。パスを確認してください。NodeにAnsibleをインストールします。ansibleインストールされたAnsibleのバージョンを確認します。2.X.XAnsibleのホームディレクトリは/etc/ansibleです。パスを確認してください。Nodeでテンプレートファイルansible-template.zipを展開し、Ansibleのホームディレクトリに配置します。Ansible設定ファイルは/etc/ansible/ansible.cfgです。項目名=値の形式で記述します。Documentation』を参照してください。Ansibleの設定は、以下の順番で優先的に適用されます。設定が適用されない場合は各ファイルを確認してください。(ホームディレクトリのファイル)/etc/ansible/ansible.cfg以上でインストールは完了です。初期構築の実行手順ノード3台で構成されるGridDBクラスタを作成する手順を説明します。Nodeのマシン3台を用意します。構築するGridDBのクラスタ名はgriddb_cluster1とします。初期構築とは初期構築は以下のステップで実行されます。Nodeでインベントリファイルを編集します。/etc/ansible/hosts[local]localhost[griddb_cluster1]192.168.0.101192.168.0.102192.168.0.103GridDBのクラスタ名は括弧で囲み、[griddb_cluster1]と指定します。ノード名は192.168.0.101、192.168.0.102、および192.168.0.103と指定します。インベントリファイルの詳細は、インベントリファイルを参照してください。Nodeでplaybookファイルを編集します。初期構築のplaybookファイルは/etc/ansible/initial-construction.ymlです。toshiba.griddbhostsには、インベントリファイルで指定したクラスタ名griddb_cluster1を指定します。Nodeを操作することを許可します。vars_filesには、初期構築の変数定義ファイルvars/initial-construction.ymlを指定します。rolesには、playbookで実行される処理が格納されているtoshiba.griddbを指定します。playbookファイルの詳細は、playbookファイルを参照してください。Nodeで変数定義ファイルを編集します。初期構築の変数定義ファイルは/etc/ansible/vars/initial-construction.ymlです。'/etc/ansible/conf'envにはon-premisesと指定します。griddb_deploy_modeには、マルチキャスト方式multicastを指定します。griddb_package_pathには、GridDBパッケージを配置するディレクトリのパス/home/griddb/5.0.0を指定します。griddb_config_filesには、GridDB設定ファイルを配置するディレクトリのパス/etc/ansible/confを指定します。変数定義ファイルの詳細は、変数定義ファイルを参照してください。GridDBパッケージの配置GridDBパッケージをgriddb_package_pathで指定したディレクトリに配置します。GridDB設定ファイルの配置GridDB設定ファイルを編集し、griddb_config_filesで指定したディレクトリ/etc/ansible/confに配置します。クラスタ定義ファイルの編集クラスタ定義ファイルではクラスタ名を編集します。...clusterNameにgriddb_cluster1を指定します。機能リファレンス』を参照してください。ノード定義ファイルの編集ノード定義ファイルを編集し、メモリ使用量を指定します。...storeMemoryLimitには、初期値の1024MBを指定します。データベース管理者ガイド』を参照してください。起動設定ファイルの編集サービスの起動設定ファイルを編集し、クラスタ名とノードの数を指定します。/etc/ansible/conf/gridstore.confCLUSTER_NAME=griddb_cluster1MIN_NODE_NUM=3CLUSTER_NAMEには、クラスタ名としてgriddb_cluster1を指定します。MIN_NODE_NUMには、ノードの数として3を指定します。運用ツールリファレンス』を参照してください。playbookファイルの実行Ansibleのホームディレクトリで初期構築のplaybookを実行します。設定取得の実行手順ノード3台で構成される既存のGridDBクラスタから設定を取得する手順を説明します。構成で動作しています。設定取得とは設定取得は以下のステップで実行されます。Nodeでインベントリファイルを編集します。/etc/ansible/hosts[local]localhost[griddb_cluster1]192.168.0.101192.168.0.102192.168.0.103GridDBのクラスタ名は括弧で囲み、[griddb_cluster1]と指定します。ノード名は192.168.0.101、192.168.0.102、および192.168.0.103と指定します。インベントリファイルの詳細は、インベントリファイルを参照してください。Nodeでplaybookファイルを編集します。設定取得のplaybookファイルは/etc/ansible/get-setting.ymlです。get-setting.ymlhostsには、インベントリファイルで指定したクラスタ名griddb_cluster1を指定します。Nodeを操作することを許可します。vars_filesには、設定取得の変数定義ファイルvars/get-setting.ymlを指定します。tasksにはplaybookで実行される処理を指定します。settingと指定します。include_roleのnameには、playbookで実行される処理が格納されているtoshiba.griddbを指定します。tasks_fromにはroles/toshiba.griddb/tasks/get-setting.ymlを指定するためにget-setting.ymlと記述します。playbookファイルの詳細は、playbookファイルを参照してください。Nodeで変数定義ファイルを編集します。設定取得の変数定義ファイルは/etc/ansible/vars/get-setting.ymlです。'/etc/ansible/conf_latest'griddb_get_settingには、ノードから取得したGridDB設定ファイルを配置するディレクトリのパス/etc/ansible/conf_latestを指定します。変数定義ファイルの詳細は、変数定義ファイルを参照してください。playbookファイルの実行Ansibleのホームディレクトリで設定取得のplaybookを実行します。GridDB設定ファイルの確認griddb_get_settingで指定したディレクトリ/etc/ansible/conf_latestに、ノードから取得したGridDB設定ファイルが配置されます。設定変更の実行手順ノード3台で構成される既存のGridDBクラスタの設定を変更する手順を説明します。構成で動作しています。設定変更とは設定変更は以下のステップで実行されます。Nodeでインベントリファイルを編集します。/etc/ansible/hosts[local]localhost[griddb_cluster1]192.168.0.101192.168.0.102192.168.0.103GridDBのクラスタ名は括弧で囲み、[griddb_cluster1]と指定します。ノード名は192.168.0.101、192.168.0.102、および192.168.0.103と指定します。インベントリファイルの詳細は、インベントリファイルを参照してください。Nodeでplaybookファイルを編集します。設定変更のplaybookファイルは/etc/ansible/change-setting.ymlです。configure.ymlhostsには、インベントリファイルで指定したクラスタ名griddb_cluster1を指定します。Nodeを操作することを許可します。vars_filesには、設定変更の変数定義ファイルvars/change-setting.ymlを指定します。tasksにはplaybookで実行される処理を指定します。settingと指定します。include_roleのnameには、playbookで実行される処理が格納されているtoshiba.griddbを指定します。tasks_fromにはroles/toshiba.griddb/tasks/configure.ymlを指定するためにconfigure.ymlと記述します。playbookファイルの詳細は、playbookファイルを参照してください。Nodeで変数定義ファイルを編集します。設定変更の変数定義ファイルは/etc/ansible/vars/change-setting.ymlです。'/etc/ansible/conf'griddb_config_filesには、GridDB設定ファイルを配置するディレクトリのパス/etc/ansible/confを指定します。変数定義ファイルの詳細は、変数定義ファイルを参照してください。GridDB設定ファイルの配置GridDB設定ファイルを編集し、griddb_config_filesで指定したディレクトリ/etc/ansible/confに配置します。クラスタ定義ファイルの編集クラスタ定義ファイルではクラスタ名を編集します。...clusterNameにgriddb_cluster1を指定します。機能リファレンス』を参照してください。ノード定義ファイルの編集ノード定義ファイルを編集し、メモリ使用量を指定します。...storeMemoryLimitには、2048MBを指定します。データベース管理者ガイド』を参照してください。起動設定ファイルの編集サービスの起動設定ファイルを編集し、クラスタ名とノードの数を指定します。/etc/ansible/conf/gridstore.confCLUSTER_NAME=griddb_cluster1MIN_NODE_NUM=3CLUSTER_NAMEには、クラスタ名としてgriddb_cluster1を指定します。MIN_NODE_NUMには、ノードの数として3を指定します。運用ツールリファレンス』を参照してください。playbookファイルの実行Ansibleのホームディレクトリで設定変更のplaybookを実行します。ノード追加の実行手順ノード3台で構成される既存のGridDBクラスタにノード1台を追加する手順を説明します。構成で動作しています。追加すると、GridDBクラスタgriddb_cluster1はノード4台構成となります。ノード追加とはノード追加は以下のステップで実行されます。Nodeでインベントリファイルを編集します。/etc/ansible/hosts[local]localhost[griddb_cluster1]192.168.0.101192.168.0.102192.168.0.103192.168.0.104GridDBのクラスタ名は括弧で囲み、[griddb_cluster1]と指定します。ノード名は192.168.0.101、192.168.0.102、192.168.0.103、および192.168.0.104と指定します。インベントリファイルの詳細は、インベントリファイルを参照してください。Nodeでplaybookファイルを編集します。ノード追加のplaybookファイルは/etc/ansible/add-node.ymlです。add-node.ymlhostsには、インベントリファイルで指定したクラスタ名griddb_cluster1を指定します。Nodeを操作することを許可します。vars_filesには、ノード追加の変数定義ファイルvars/add-node.ymlを指定します。tasksにはplaybookで実行される処理を指定します。include_roleのnameには、playbookで実行される処理が格納されているtoshiba.griddbを指定します。tasks_fromにはroles/toshiba.griddb/tasks/detect-cluster-setting.ymlを指定するためにdetect-cluster-setting.ymlと記述します。次に、一時的に追加ノードのグループを作成するための設定を行います。hostsには、new_nodes_for_griddb_cluster1を指定します。Nodeを操作することを許可します。vars_filesには、ノード追加の変数定義ファイルvars/add-node.ymlを指定します。tasksにはplaybookで実行される処理を指定します。include_roleのnameには、playbookで実行される処理が格納されているtoshiba.griddbを指定します。tasks_fromにはroles/toshiba.griddb/tasks/add-node.ymlを指定するためにadd-node.ymlと記述します。playbookファイルの詳細は、playbookファイルを参照してください。Nodeで変数定義ファイルを編集します。ノード追加の変数定義ファイルは/etc/ansible/vars/add-node.ymlです。192.168.0.104griddb_package_pathには、GridDBパッケージを配置するディレクトリのパス/home/griddb/5.0.0を指定します。griddb_config_filesには、GridDB設定ファイルを配置するディレクトリのパス/etc/ansible/confを指定します。extra_nodesには、追加するノード192.168.0.104を指定します。変数定義ファイルの詳細は、変数定義ファイルを参照してください。GridDBパッケージの配置GridDBパッケージをgriddb_package_pathで指定したディレクトリに配置します。GridDB設定ファイルの配置GridDB設定ファイルを編集し、griddb_config_filesで指定したディレクトリ/etc/ansible/confに配置します。クラスタ定義ファイルの編集クラスタ定義ファイルではクラスタ名を編集します。...clusterNameにgriddb_cluster1を指定します。機能リファレンス』を参照してください。ノード定義ファイルの編集ノード定義ファイルを編集し、メモリ使用量を指定します。...storeMemoryLimitには、初期値の1024MBを指定します。データベース管理者ガイド』を参照してください。起動設定ファイルの編集サービスの起動設定ファイルを編集し、クラスタ名とノードの数を指定します。/etc/ansible/conf/gridstore.confCLUSTER_NAME=griddb_cluster1MIN_NODE_NUM=4CLUSTER_NAMEには、クラスタ名としてgriddb_cluster1を指定します。MIN_NODE_NUMには、ノードの数として4を指定します。運用ツールリファレンス』を参照してください。playbookファイルの実行Ansibleのホームディレクトリでノード追加のplaybookを実行します。インベントリファイルとはインベントリファイルにはクラスタ構成を設定します。クラスタ名とクラスタを構成するノード名を指定します。インベントリファイルは、Ansibleのホームディレクトリにhostsというファイル名で配置します。GridDBのクラスタ名は括弧[]で囲みます。複数のクラスタを指定する場合は、クラスタ構成の間を改行します。ノード名はホスト名またはIPアドレスを記述します。複数のノードを指定する場合は、ノードごとに改行します。変数定義ファイルとは変数定義ファイルはplaybookファイルで用いる変数を指定するファイルです。YAML形式で記述します。変数定義ファイルはAnsibleのホームディレクトリのvarsディレクトリに配置します。playbookファイルとはplaybookファイルはAnsibleの設定ファイルです。YAML形式で記述します。playbookファイルはAnsibleのホームディレクトリに配置します。インベントリファイルで指定したクラスタ名を指定します。Nodeを操作することを許可します。変数定義ファイルを指定します。playbookで実行される処理を指定します。playbookで実行される複数の処理を指定します。プロキシを設定します。playbookの実行方法Ansibleのホームディレクトリでplaybookを実行します。<playbook.yml>ansible-playbookコマンドで実行します。オプション-iでインベントリファイルのhostsファイルを指定し、末尾にplaybookファイルを指定して実行します。エラーコードplaybookの実行時に、エラーコードと共にエラーメッセージが出力されることがあります。本テンプレートでは設定値を検証します。エラー原因と解決方法を参照し、設定値を見直してください。envの値が不正です。envの値を見直してください。griddb_deploy_modeの値が不正です。griddb_deploy_modeの値を見直してください。griddb_package_pathが未設定です。griddb_package_pathの値を見直してください。griddb_config_filesが未設定です。griddb_config_filesの値を見直してください。griddb_get_settingが未設定です。griddb_get_settingの値を見直してください。griddb_package_pathに設定されているパスにGridDBパッケージが見つかりません。GridDBパッケージをgriddb_package_pathのパスに配置してください。Documentation』を参照してください。