설치와 설정¶

이 섹션은 컨트롤러 노드에 trove라는 코드 이름을 가진 데이터베이스 서비스를 설치하고 구성하는 방법을 설명합니다.

이 섹션은 적어도 다음 구성요소가 설치되어 동작하는 OpenStack 환경을 이미 가지고 있음을 가정합니다: Compute, 이미지 서비스, Identity.

백업 및 복구를 원하는 경우, Object 스토리지 또한 필요합니다.
데이터저장소를 블록 스토리지 볼륨에 프로비저닝하고자 하는 경우, 블록 스토리지 또한 필요합니다.

선행조건¶

데이터베이스 서비스를 설치 및 구성하기 전에, 데이터베이스, 서비스 credential, 엔드포인트를 생성해야 합니다.

데이터베이스를 생성하기 위하여, 다음 과정을 완료해야 합니다:
- 데이터베이스 액세스 클라이언트를 사용하여 데이터베이스 서버에 root 사용자로 연결합니다:
```
$ mysql -u root -p
```
- trove 데이터베이스를 생성합니다:
```
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_PASS 를 적절한 암호로 변경합니다.
- 데이터베이스 접속 클라이언트를 종료합니다.
admin credential을 소스로 사용하여 관리자 전용 CLI 명령어에 대한 액세스를 갖습니다:
```
$ source admin-openrc.sh
```

서비스 credential을 생성하기 위해, 다음 스텝들을 완료합니다:

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                             |
+-----------+-----------------------------------+

trove 사용자에게 admin role을 추가합니다:
```
$ 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                          |
+-------------+-----------------------------------+

데이터베이스 서비스 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  |
+--------------+----------------------------------------------+

구성요소 설치 및 구성¶

주석

디폴트 구성 파일을 배포판에 따라 달라집니다. 기존 섹션 및 옵션을 변경하는 것 보다는 해당 섹션과 옵션을 추가해야 할 수도 있습니다. 또한 구성 내용 조각 중 생략 (...) 부분은 유지될 필요성이 있는 디폴트 구성 옵션을 가리킵니다.

패키지를 설치하십시오:

# yum install openstack-trove python-troveclient

/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

각 파일에서 다음 옵션을 설정하여 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

주석

출력 중 deprecation 메시지는 무시합니다.

설치 마무리¶

데이터베이스 서비스를 시작하고 시스템 부팅시 시작하도록 설정합니다:

# systemctl enable openstack-trove-api.service \
  openstack-trove-taskmanager.service \
  openstack-trove-conductor.service

# systemctl start openstack-trove-api.service \
  openstack-trove-taskmanager.service \
  openstack-trove-conductor.service