Andreas Jaeger 696d80d4a8 Add Install Guide

This adds trove-specific contents of the OpenStack Installation Guide
in the trove repo per [1]. A separate change will remove the heat
contents from the OpenStack Installation Guide for Newton per [2].

This is a verbatim import from the content in openstack-manuals with
minimal changes to get content building.

Also adds tox.ini environment for install-guide and adds
openstackdocs-theme to test-requirements.txt.

From lmichaels -- added a statement to the next-steps doc.

[1]
http://specs.openstack.org/openstack/docs-specs/specs/newton/project-specific-installguides.html
[2]
http://specs.openstack.org/openstack/docs-specs/specs/newton/installguide.html
[3] https://review.openstack.org/#/c/314229/

Partially-Implements: blueprint projectspecificinstallguides
Change-Id: Idf8cb90536fd4b4d9a2d0695ef30f498b1283410

2016-06-16 15:48:29 -07:00

3.4 KiB

Raw Blame History

Verify operation

Verify operation of the Database service.

Note

Perform these commands on the node where you installed trove.

Source the admin tenant credentials:
```
$ . admin-openrc
```

Run the trove list command. You should see output similar to this:

$ trove list
+----+------+-----------+-------------------+--------+-----------+------+
| id | name | datastore | datastore_version | status | flavor_id | size |
+----+------+-----------+-------------------+--------+-----------+------+
+----+------+-----------+-------------------+--------+-----------+------+

Add a datastore to trove:

Create a trove image.

Create an image for the type of database you want to use, for example, MySQL, MongoDB, Cassandra.

This image must have the trove guest agent installed.

Upload the image to glance. Example:

$ glance image-create --name "mysqlTest" --disk-format qcow2 \
  --container-format bare \
  --file mysql-5.6.qcow2
+------------------+--------------------------------------+
| Property         | Value                                |
+------------------+--------------------------------------+
| checksum         | 51a8e6e5ff10b08f2c2ec2953f0a8086     |
| container_format | bare                                 |
| created_at       | 2016-04-08T15:15:41Z                 |
| disk_format      | qcow2                                |
| id               | 5caa76dd-f44b-4d01-a3b4-a111e27896be |
| min_disk         | 0                                    |
| min_ram          | 0                                    |
| name             | mysqlTest                            |
| owner            | 0c0bd5e850c24893b48c4cc01e2a7986     |
| protected        | False                                |
| size             | 533790720                            |
| status           | active                               |
| tags             | []                                   |
| updated_at       | 2016-04-08T15:15:51Z                 |
| virtual_size     | None                                 |
| visibility       | private                              |
+------------------+--------------------------------------+

Create a datastore. You need to create a separate datastore for each type of database you want to use, for example, MySQL, MongoDB, Cassandra. This example shows you how to create a datastore for a MySQL database:
```
# su -s /bin/sh -c "trove-manage \
  --config-file /etc/trove/trove.conf \
  datastore_update mysql ''" trove
...
Datastore 'mysql' updated.
```

Update the datastore to use the new image.

This example shows you how to update a MySQL 5.6 datastore:

# su -s /bin/sh -c "trove-manage --config-file /etc/trove/trove.conf \
  datastore_version_update \
  mysql mysql-5.6 mysql glance_image_ID '' 1" trove
...
Datastore version 'mysql-5.6' updated.

Create a database instance.

3.4 KiB Raw Blame History

Verify operation

3.4 KiB

Raw Blame History