696d80d4a8
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
92 lines
3.4 KiB
ReStructuredText
92 lines
3.4 KiB
ReStructuredText
.. _trove-verify:
|
|
|
|
Verify operation
|
|
~~~~~~~~~~~~~~~~
|
|
|
|
Verify operation of the Database service.
|
|
|
|
.. note::
|
|
|
|
Perform these commands on the node where you installed trove.
|
|
|
|
#. Source the ``admin`` tenant credentials:
|
|
|
|
.. code-block:: console
|
|
|
|
$ . admin-openrc
|
|
|
|
#. Run the ``trove list`` command. You should see output similar to this:
|
|
|
|
.. code-block:: console
|
|
|
|
$ trove list
|
|
+----+------+-----------+-------------------+--------+-----------+------+
|
|
| id | name | datastore | datastore_version | status | flavor_id | size |
|
|
+----+------+-----------+-------------------+--------+-----------+------+
|
|
+----+------+-----------+-------------------+--------+-----------+------+
|
|
|
|
#. Add a datastore to trove:
|
|
|
|
* `Create a trove image <http://docs.openstack.org/developer/trove/dev/building_guest_images.html>`_.
|
|
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:
|
|
|
|
.. code-block:: console
|
|
|
|
$ 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:
|
|
|
|
.. code-block:: console
|
|
|
|
# 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:
|
|
|
|
.. code-block:: console
|
|
|
|
# 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
|
|
<http://docs.openstack.org/user-guide/create_db.html>`_.
|