インストールと設定¶
このセクションでは、コントローラーノードに Database サービス (コード名 trove) をインストールおよび設定する方法を説明します。
このセクションは、 Compute、 Image サービス、 Identity サービスがインストールされた動作する OpenStack 環境がすでに準備されていることを前提にしています。
バックアップとリストアを行いたい場合は、 Object Storage も必要です。
データストアをブロックストレージのボリューム上に構成したい場合は、 Block Storage も必要です。
前提条件¶
Database サービスをインストールして設定する前に、データベース、サービスクレデンシャル、API エンドポイントを作成する必要があります。
データベースを作成するには、これらの手順をすべて実行します。
データベースクライアントを使用して、データベースサーバーに root ユーザーとして接続します。
$ mysql -u root -ptrove データベースを作成します。
CREATE DATABASE trove;trove データベースに適切なアクセス権を付与します。
GRANT ALL PRIVILEGES ON trove.* TO 'trove'@'localhost' \ IDENTIFIED BY 'TROVE_DBPASS'; GRANT ALL PRIVILEGES ON trove.* TO 'trove'@'%' \ IDENTIFIED BY 'TROVE_DBPASS';
TROVE_DBPASS は適切なパスワードに置き換えます。
データベースクライアントを終了します。
admin クレデンシャルを読み込み、管理者専用 CLI コマンドへのアクセス権を取得します。
$ source admin-openrc.sh
以下の手順を実行して、サービスクレデンシャルを作成します。
trove ユーザーを作成します。
$ openstack user create --domain default --password-prompt trove User Password: Repeat User Password: +-----------+-----------------------------------+ | Field | Value | +-----------+-----------------------------------+ | domain_id | default | | enabled | True | | id | ca2e175b851943349be29a328cc5e360 | | name | trove | +-----------+-----------------------------------+
admin ロールを trove ユーザーに追加します。
$ openstack role add --project service --user trove admin注釈
このコマンドは何も出力しません。
trove サービスエンティティーを作成します。
$ openstack service create --name trove \ --description "Database" database +-------------+-----------------------------------+ | Field | Value | +-------------+-----------------------------------+ | description | Database | | enabled | True | | id | 727841c6f5df4773baa4e8a5ae7d72eb | | name | trove | | type | database | +-------------+-----------------------------------+
Database サービス API エンドポイントを作成します。
$ openstack endpoint create --region RegionOne \ database public http://controller:8779/v1.0/%\(tenant_id\)s +--------------+----------------------------------------------+ | Field | Value | +--------------+----------------------------------------------+ | enabled | True | | id | 3f4dab34624e4be7b000265f25049609 | | interface | public | | region | RegionOne | | region_id | RegionOne | | service_id | 727841c6f5df4773baa4e8a5ae7d72eb | | service_name | trove | | service_type | database | | url | http://controller:8779/v1.0/%\(tenant_id\)s | +--------------+----------------------------------------------+ $ openstack endpoint create --region RegionOne \ database internal http://controller:8779/v1.0/%\(tenant_id\)s +--------------+----------------------------------------------+ | Field | Value | +--------------+----------------------------------------------+ | enabled | True | | id | 9489f78e958e45cc85570fec7e836d98 | | interface | internal | | region | RegionOne | | region_id | RegionOne | | service_id | 727841c6f5df4773baa4e8a5ae7d72eb | | service_name | trove | | service_type | database | | url | http://controller:8779/v1.0/%\(tenant_id\)s | +--------------+----------------------------------------------+ $ openstack endpoint create --region RegionOne \ database admin http://controller:8779/v1.0/%\(tenant_id\)s +--------------+----------------------------------------------+ | Field | Value | +--------------+----------------------------------------------+ | enabled | True | | id | 76091559514b40c6b7b38dde790efe99 | | interface | admin | | region | RegionOne | | region_id | RegionOne | | service_id | 727841c6f5df4773baa4e8a5ae7d72eb | | service_name | trove | | service_type | database | | url | http://controller:8779/v1.0/%\(tenant_id\)s | +--------------+----------------------------------------------+
コンポーネントのインストールと設定¶
注釈
設定ファイルのデフォルトは、ディストリビューションにより異なります。これらの既存のセクションとオプションを編集するのではなく、追加する必要があるかもしれません。また、設定のスニペットにある 省略 (...) は、保持すべきデフォルトの設定オプションを意味します。
パッケージをインストールします。
# apt-get update # apt-get install python-trove python-troveclient \ python-glanceclient trove-common trove-api trove-taskmanager \ trove-conductor
/etc/trove ディレクトリーで、ファイル trove.conf, trove-taskmanager.conf, trove-conductor.conf を編集し、以下の作業をすべて行います。
以下の設定項目に適切な値を指定します。
[DEFAULT] log_dir = /var/log/trove trove_auth_url = http://controller:5000/v2.0 nova_compute_url = http://controller:8774/v2 cinder_url = http://controller:8776/v1 swift_url = http://controller:8080/v1/AUTH_ notifier_queue_hostname = controller ... [database] connection = mysql://trove:TROVE_DBPASS@controller/trove
各ファイルで以下のオプションを設定し、 Database サービスが RabbitMQ メッセージブローカーを使用するように設定します。
[DEFAULT] ... rpc_backend = rabbit [oslo_messaging_rabbit] ... rabbit_host = controller rabbit_userid = openstack rabbit_password = RABBIT_PASS
api-paste.ini ファイルが /etc/trove に存在することを確認します。
このファイルが存在しない場合は、 ここ からファイルを取得できます。
trove.conf を編集し、以下に示す設定項目に適切な値を設定します。
[DEFAULT] auth_strategy = keystone ... # Config option for showing the IP address that nova doles out add_addresses = True network_label_regex = ^NETWORK_LABEL$ ... api_paste_config = /etc/trove/api-paste.ini ... [keystone_authtoken] ... auth_uri = http://controller:5000 auth_url = http://controller:35357 auth_type = password project_domain_name = default user_domain_name = default project_name = service username = trove password = TROVE_PASS
trove-taskmanager.conf ファイルを編集し、OpenStack Compute サービスと通信するために必要な設定を行います。
[DEFAULT] ... # Configuration options for talking to nova via the novaclient. # These options are for an admin user in your keystone config. # It proxy's the token received from the user to send to nova # via this admin users creds, # basically acting like the client via that proxy token. nova_proxy_admin_user = admin nova_proxy_admin_pass = ADMIN_PASS nova_proxy_admin_tenant_name = service taskmanager_manager = trove.taskmanager.manager.Manager
/etc/trove/trove-guestagent.conf ファイルを編集し、 trove ゲストが OpenStack 環境と通信できるようにします。
rabbit_host = controller rabbit_password = RABBIT_PASS nova_proxy_admin_user = admin nova_proxy_admin_pass = ADMIN_PASS nova_proxy_admin_tenant_name = service trove_auth_url = http://controller:35357/v2.0
インストール手順の最初の方で作成した trove データベースにデータベースを展開します。
# su -s /bin/sh -c "trove-manage db_sync" trove ... 2016-04-06 22:00:17.771 10706 INFO trove.db.sqlalchemy.migration [-] Upgrading mysql://trove:dbaasdb@controller/trove to version latest
注釈
この出力の廃止予定に関するメッセージはすべて無視してください。
インストールの最終作業¶
Ubuntu パッケージにバグがあるため、正しい設定を使うようにサービス定義ファイルを編集します。
具体的には、 /etc/init に移動し、以下のファイルを下記のとおりに編集します。
trove-taskmanager.conf
trove-conductor.conf
(これらのファイルは、上記のインストール手順で編集したファイルとファイル名は同じですが、別の場所にあり、内容も異なっている点に注意してください。)
各ファイルで、以下の行を探します。
exec start-stop-daemon --start --chdir /var/lib/trove \ --chuid trove:trove --make-pidfile \ --pidfile /var/run/trove/trove-conductor.pid \ --exec /usr/bin/trove-conductor -- \ --config-file=/etc/trove/trove.conf ${DAEMON_ARGS}
--config-file が間違って trove.conf を指しています。
trove-taskmanager.conf では、config-file が /etc/trove/trove-taskmanager.conf を指すように変更します。
trove-conductor.conf では、config-file が /etc/trove/trove-conductor.conf を指すように変更します。
Database のサービスを再起動します。
# service trove-api restart # service trove-taskmanager restart # service trove-conductor restart
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.