From 3e3776d64360b314802872ad853605cdf744f08f Mon Sep 17 00:00:00 2001 From: Laurel Michaels Date: Tue, 12 Aug 2014 15:17:35 -0400 Subject: [PATCH] Added trove create via horizon The trove chapter in the user guide did not have a section on how to use horizon to create a database instance. This commit covers how to create a db instance using horizon. This commit is a partial implementation of the blueprint. Change-Id: I7419a59e1b1763298a89e85ffa845a327f87bcae blueprint: user-guide-trove-chapter --- doc/user-guide/ch_dashboard.xml | 2 + .../section_dashboard_databases.xml | 109 ++++++++++++++++++ 2 files changed, 111 insertions(+) create mode 100644 doc/user-guide/section_dashboard_databases.xml diff --git a/doc/user-guide/ch_dashboard.xml b/doc/user-guide/ch_dashboard.xml index b8ac942879..537a8eea73 100644 --- a/doc/user-guide/ch_dashboard.xml +++ b/doc/user-guide/ch_dashboard.xml @@ -32,4 +32,6 @@ + + diff --git a/doc/user-guide/section_dashboard_databases.xml b/doc/user-guide/section_dashboard_databases.xml new file mode 100644 index 0000000000..9976b72cb3 --- /dev/null +++ b/doc/user-guide/section_dashboard_databases.xml @@ -0,0 +1,109 @@ + +
+ Create and manage databases + + The Database service provides scalable and reliable cloud provisioning functionality for both relational and non-relational database engines. Users can quickly and easily use database features without the burden of handling complex administrative tasks. +
+ Create a database instance + + Prerequisites + Before you create a database instance, you need to configure a default datastore and make sure you have an appropriate flavor for the type of database instance you want. + + + + Configure a default datastore. + Because the dashboard does not let you choose a specific datastore to use with an instance, you need to configure a default datastore. The dashboard then uses the default datastore to create the instance. + + + Add the following line to /etc/trove/trove.conf: + default_datastore = DATASTORE_NAME + Replace DATASTORE_NAME with the name that the administrative user set when issuing the trove-manage command to create the datastore. You can use the trove datastore-list command to display the datastores that are available in your environment. + For example, if your MySQL datastore name is set to mysql, your entry would look like this: + default_datastore = mysql + + + Restart Database services on the controller node: + # service trove-api restart +# service trove-taskmanager restart +# service trove-conductor restart + + + + + Verify flavor. + Make sure an appropriate flavor exists for the type of database instance you want. + + + + Create database instance + Once you have configured a default datastore and verified that you have an appropriate flavor, you can create a database instance. + + + + Log in to the dashboard, choose a project, and click Databases. + + + Click Database Instances. This lists the instances that already exist in your environment. + + + Click Launch Instance. + + + In the Launch Database dialog box, specify the following values. + + + + + + Details + + + + + Database Name + Specify a name for the database instance. + + + Flavor + Select an appropriate flavor for the instance. + + + Volume Size + Select a volume size. Volume size is expressed in GB. + + + + Initialize Databases + + + Initial Database + + Optionally provide a comma separated list of databases to create, for example: + database1, database2, database3 + + + + Initial Admin User + Create an initial admin user. This user will have access to all the databases you create. + + + Password + Specify a password associated with the initial admin user you just named. + + + Host + Optionally, allow the user to connect only from this host. If you do not specify a host, this user will be allowed to connect from anywhere. + + + + + + Click the Launch button. The new database instance appears in the databases list. + + +
+