110 lines
6.5 KiB
XML
110 lines
6.5 KiB
XML
<?xml version="1.0" encoding="UTF-8"?>
|
|
<section xmlns="http://docbook.org/ns/docbook"
|
|
xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
xmlns:xlink="http://www.w3.org/1999/xlink"
|
|
version="5.0"
|
|
xml:id="dashboard_databases">
|
|
<title>Create and manage databases</title>
|
|
<?dbhtml stop-chunking?>
|
|
<para>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.</para>
|
|
<section xml:id="dashboard_create_db_instance">
|
|
<title>Create a database instance</title>
|
|
<formalpara>
|
|
<title>Prerequisites</title>
|
|
<para>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.</para>
|
|
</formalpara>
|
|
<procedure>
|
|
<step>
|
|
<title>Configure a default datastore.</title>
|
|
<para>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.</para>
|
|
<substeps>
|
|
<step>
|
|
<para>Add the following line to <filename>/etc/trove/trove.conf</filename>:</para>
|
|
<programlisting language="ini">default_datastore = <replaceable>DATASTORE_NAME</replaceable></programlisting>
|
|
<para>Replace <replaceable>DATASTORE_NAME</replaceable> with the name that the administrative user set when issuing the <command>trove-manage</command> command to create the datastore. You can use the trove <command>datastore-list</command> command to display the datastores that are available in your environment.</para>
|
|
<para>For example, if your MySQL datastore name is set to <literal>mysql</literal>, your entry would look like this:</para>
|
|
<programlisting language="ini">default_datastore = mysql</programlisting>
|
|
</step>
|
|
<step>
|
|
<para>Restart Database services on the controller node:</para>
|
|
<screen><prompt>#</prompt> <userinput>service trove-api restart</userinput>
|
|
<prompt>#</prompt> <userinput>service trove-taskmanager restart</userinput>
|
|
<prompt>#</prompt> <userinput>service trove-conductor restart</userinput></screen>
|
|
</step>
|
|
</substeps>
|
|
</step>
|
|
<step>
|
|
<title>Verify flavor.</title>
|
|
<para>Make sure an <link linkend="create_db">appropriate flavor exists</link> for the type of database instance you want.</para>
|
|
</step>
|
|
</procedure>
|
|
<formalpara>
|
|
<title>Create database instance</title>
|
|
<para>Once you have configured a default datastore and verified that you have an appropriate flavor, you can create a database instance.</para>
|
|
</formalpara>
|
|
<procedure>
|
|
<step>
|
|
<para>Log in to the dashboard, choose a project, and click <guilabel>Databases</guilabel>.</para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guilabel>Database Instances</guilabel>. This lists the instances that already exist in your environment.</para>
|
|
</step>
|
|
<step>
|
|
<para>Click <guibutton>Launch Instance</guibutton>.</para>
|
|
</step>
|
|
<step>
|
|
<para>In the <guilabel>Launch Database</guilabel> dialog box, specify the following values.</para>
|
|
<informaltable rules="all" width="75%">
|
|
<col width="30%"/>
|
|
<col width="70%"/>
|
|
<thead>
|
|
<tr>
|
|
<th colspan="2" align="center"><guilabel>Details</guilabel></th>
|
|
</tr>
|
|
</thead>
|
|
<tbody>
|
|
<tr>
|
|
<td><para><guilabel>Database Name</guilabel></para></td>
|
|
<td><para>Specify a name for the database instance.</para></td>
|
|
</tr>
|
|
<tr>
|
|
<td><para><guilabel>Flavor</guilabel></para></td>
|
|
<td><para>Select an appropriate flavor for the instance.</para></td>
|
|
</tr>
|
|
<tr>
|
|
<td><para><guilabel>Volume Size</guilabel></para></td>
|
|
<td><para>Select a volume size. Volume size is expressed in GB.</para></td>
|
|
</tr>
|
|
<tr>
|
|
<th colspan="2" align="center">
|
|
<guilabel>Initialize Databases</guilabel></th>
|
|
</tr>
|
|
<tr>
|
|
<td><para><guilabel>Initial Database</guilabel></para></td>
|
|
<td>
|
|
<para>Optionally provide a comma separated list of databases to create, for example:</para>
|
|
<para><literal>database1</literal>, <literal>database2</literal>, <literal>database3</literal></para>
|
|
</td>
|
|
</tr>
|
|
<tr>
|
|
<td><para><guilabel>Initial Admin User</guilabel></para></td>
|
|
<td><para>Create an initial admin user. This user will have access to all the databases you create.</para></td>
|
|
</tr>
|
|
<tr>
|
|
<td><para><guilabel>Password</guilabel></para></td>
|
|
<td><para>Specify a password associated with the initial admin user you just named.</para></td>
|
|
</tr>
|
|
<tr>
|
|
<td><para><guilabel>Host</guilabel></para></td>
|
|
<td><para>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.</para></td>
|
|
</tr>
|
|
</tbody>
|
|
</informaltable>
|
|
</step>
|
|
<step>
|
|
<para>Click the <guibutton>Launch</guibutton> button. The new database instance appears in the databases list.</para>
|
|
</step>
|
|
</procedure>
|
|
</section>
|
|
</section>
|