View source for Manage MySQL/MariaDB Databases (Windows Environment)

==What is MySQL?==
'''MySQL''' is an available open source Relational Database Management System (RDBMS) that uses SQL (Structured Query Language).

Why is SQL popular? MySQL is one of the easiest languages for adding, accessing and managing content in a database. It is known for its quick query processing, reliability, and easy management. A lot of popular software used by a majority of the internet uses MySQL / MariaDB databases including WordPress (Most blog sites use WordPress), Joomla, osCommerce, phpBB, etc.

==What is MariaDB?==

'''MariaDB''' is a fork of the MySQL database engine. It is developed on by many developers including some of the original MySQL creators of the MySQL Database Engine. It is also a free open-source project available to the public. This is the engine that is used on all of our newer shared database servers for MySQL/MariaDB.

==Manage MySQL/MariaDB Databases via WCP==

Let's go ahead and show how to create and manage MySQL/MariaDB databases via the WCP control panel.
<br /><br />

<ol style="list-style-type: decimal;">
<li><p>First login to your WCP control panel for the account the domain is under: https://wcp.hostek.com</p>
[[file:wcp_url_secure.png]]
<br /><Br />
<p>If you have any issues with logging into WCP then please see our tutorials on [[Forgot_WCP_Password|recovering your password]] if necessary</p></li></ol>

<br />

<ol start="2" style="list-style-type: decimal;">
<li><p>Once logged into WCP if you have multiple domains you may need to select the appropriate domain to manage using the ''''Hosted Domains'''' drop-down in the top-right of the page as shown in the screenshot below:</p>
[[file:wcp_change_domain.png]]
<br /><br />
</li>


<li><p>In your control panel click on the ''''MySQL'''' icon under the ''''Databases'''' section.</p>
[[file:wcp_mysql.png]]
<br /><br />
</li>


<li><p>If you don't have any existing databases then skip to step 3, as you'll automatically be on the 'new database' screen.</p>
<br />

<p>If you do already have existing database(s) then you should see them listed here, along with the server they reside on. Click on the ''''Add Database'''' button to create a new database.</p>
<br />
[[file:mysql_add_db_bttn.png]]
<br /><br />
</li>


<li><p>You will now be asked for the below database information to be created:</p>
<br />

<p>'''Server:''' This '''Server''' field will show the server that your MySQL database will be created on, along with the version of MySQL / MariaDB that the server is using.</p>
<p>'''Database Name:''' Enter the desired database name that you wish to create.</p>
<p>'''User:''' This '''User''' drop-down allows you to select an already existing user if you have a MySQL user that is already on the server that your new database is being created on. If you do not have a pre-existing user or you don't wish to use a pre-existing user then you'll need to fill in the ''username'' and ''password'' fields.</p>
<p>'''Username:''' Enter the username you wish to create that you'll use to login to the MySQL database.</p>
<p>'''Password:''' Enter the password for the new MySQL user that you are creating. You'll use this password to login to the MySQL database user.</p>
<br />
[[file:mysql_add_db.png]]
<br /><br />
</li>


<li><p>When selecting the ''''ColdFusion DataSource'''' checkbox a field will appear for the ''''DataSource Name''''.</p>
<br />
<p>A data source is a saved configuration of database connection information including the Database Name, Username, Password, Port, Server, ect. This is used so you do not have to specify the connection information within your sites code and can instead just reference the singular data source name.</p>
<p>'''Note:''' ''This feature is only viewable if your site resides on a ColdFusion server.''</p>
<p>'''Note:''' ''When selecting this option the database information you create on this page will be stored with the given DataSource Name you provide.''</p>
[[file:mysql_add_dsn_checkbox.png]]
</li>

<br />

<li>Double check the values you have entered, then click the ''''Save'''' button to add this MySQL database.</li>

</ol>
== Managing MySQL Users ==

As you could see in the above section for creating a database you can create a MySQL user during the process of creating a new database. The following steps are for creating MySQL users after the database(s) have already been created and how to manage them.

=== Navigating to MySQL Users ===

<ol style="list-style-type: decimal;">
<br />

<li><p>In your control panel click on the ''''MySQL'''' icon under the ''''Databases'''' section.</p>
[[file:wcp_mysql.png]]
</li><br />

<br />

<li><p>If you have databases that reside on multiple database servers, you may need to click on the pencil icon next to the related MySQL database server (you should see a list of databases on each database server in order to differentiate).</p>
<p>''As shown in the below screenshot we have a database on our MySQL19 server and we have a database on our MySQL20 server, so we would need to click the pencil icon next to the server we wish to manage the users for.''</p>
[[file:mysql_server_dbs.png]]
</li></ol>

<br /><br />

==== Add MySQL User ====
<br />

<ol style="list-style-type: decimal;">

<li><p>Click on the ''''Add User'''' button to a add a new user.</p>
<br />
[[file:add_mysql_user.png]]
<br /><br />
</li>


<li><p>You should now see the below requested fields for the new MySQL user:</p>
<br />

<p>'''Username:''' ''Enter the name of the new MySQL user you would like to add.''</p>
<p>'''Password:''' ''Enter the password for the new MySQL user you would like to add.''</p>
<p>'''Permissions:''' ''The 'Permissions' section allows you to choose which databases the MySQL user has access to, as well as to what type of permissions it will have access to for that database.. for example you can enable the user to ONLY have 'Select' permissions so that the user can only view existing data in the database but not actually update, add, or delete any new content within the database.''</p>
<br />
[[file:mysql_new_user_info.png]]
<br /><br />
</li>
<li><p>Double check the values you have entered, then click the ''''Save'''' button to add this MySQL database user and it's respective permissions.</p></li></ol>

==== Update MySQL User ====
<br />

<ol style="list-style-type: decimal;">
<li><p>Click on the pencil icon next to the MySQL user you wish to edit.</p>
<br />
[[file:edit_mysql_db_user.png]]
<br /><br />
</li>
<li><p>Now you will be able to update the MySQL users password and / or permissions.</p>
[[file:edit_mysql_user_info.png]]
</li>
<br /><br />
<li><p>Double check the values you have entered, then click the ''''Save'''' button to save any changes you've made to the MySQL user.</p></li></ol>

==== Delete MySQL User ====
<br />

<ol>
<li>Click the trash can icon next to the user you wish to delete.</li>
<br />

[[file:wcp_delete_mysql_user.png]]
<br /><br />

<li>You should receive a prompt asking if you are sure you wish to delete the selected user. Click 'OK' to delete, or 'Cancel' to cancel the deletion of the MySQL user.</li></ol>
<br />
[[file:wcp_mysql_userdelete_confirm.png]]
<br /><br />


[[Category:WCP_(Windows_based_Control_Panel)]]