View source for Manage MS SQL Databases

__FORCETOC__

In this tutorial we will show how to create and manage MSSQL Databases and their respective users in WCP.

= Navigate to MSSQL Database Section =
<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>
<br />
[[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>

<br />

<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 ''''MS SQL'''' icon under the ''''Databases'''' section.</p>
<br />
[[file:wcp_mssql_icon.png]]
<br /><br />
</li>
</ol>

<br />

==Add MS SQL Database==
<br /><br />
<ol>

<li>If you don't have any existing databases then skip to step 3, as you'll automatically be on the '''new database''' screen. 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.
<br />
[[file:wcp_add_db_bttn.png]]
<br /><br />

</li>

<li><p>You will now be asked for the below database information to be created:</p>
<br />
[[file:wcp_mssql_add_db.png]]
<br /><br />

<p>'''MSSQL Version:''' This '''MSSQL Version''' field will show the server that your MS SQL database will be created on, along with the version of MS SQL 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 MS SQL 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>'''''Note'':''' ''If you do select a pre-existing user then the 'username' and 'password' fields will disappear.''</p>
<p>'''Username:''' Enter the username you wish to create that you'll use to login to the MS SQL database.</p>
<p>'''Password:''' Enter the password for the new MS SQL user that you are creating. You'll use this password to login to the MS SQL database user.</p>
<p>'''Default Collation:''' In the 'Default Collation' drop-down menu, select the default collation for this database. Our default collation is usually sufficient, and you likely won't need to change it. If you're unsure, you'll need to consult with your application developer.</p>
<p>'''Recovery Model:''' A recovery model is a database property that controls how transactions are logged, whether the transaction log requires (and allows) backing up, and what kinds of restore operations are available. In the '''Recovery Model''' drop-down menu, you can set your recovery model to either 'Full' or 'Simple'. We recommend keeping this as 'Simple' to prevent large log files that can cause the database to fill up. We have backups on our shared servers for MS SQL if needed so setting to 'Simple' would be our recommendation.</p>
<p>'''ColdFusion DataSource:''' This checkbox option is only visible if your site resides on a ColdFusion server. Selecting the checkbox will automatically create a data source (DSN) within ColdFusion Admin with the configuration details of the database you're creating. After selecting the checkbox a field will appear which you can enter the name of the data source that you'll call within your sites application (code).</p>
<br /><br />

</li>

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

==Update MS SQL Database Settings==
<br /><br />

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

<li><p>If you have databases on multiple database servers, you may need to click on the pencil icon next to the related MS SQL database server (you should see a list of databases on each database server in order to differentiate). Now to update an existing MS SQL database click on the pencil icon next to the MS SQL database that you would like to manage.</p>
<br />
[[file:wcp_edit_database.png]]
<br /><br /><br />

</li>

<li><p>You should now have the option to update the following:</p>
<br />
[[file:wcp_edit_mssql_database.png]]
<br /><br />

<p>'''Database Size:''' Use this drop-down to change your database's maximum size.</p>
<p>'''Default Collation:''' Use this drop-down to change your databases default collation for tables. A collation is a set of rules for comparing characters in a character set. The application developer for the site should know which collation is needed, which if not the pre-set default collation of '''SQL''Latin1_General_CP1_CI_AS_''' would probably be best.</p>
<p>'''Recovery Model:''' Use this drop-down to change the way transaction logs are stored for the database. Keep in mind that setting this option to 'Full' can cause the transaction logs for the database to become full which would result in the database being non-functional until the logs were shrunk or more space was allocated to the database.</p>
<p>'''''Note:''' Please also note that we keep backups for databases already for shared servers. Depending on the add-ons you have selected for backups we may have database backups for VPS servers as well.''</p>
<p>'''Database Owner (DBO):''' Use this drop-down to change which user is the owner of the database. The database owner has special permissions, which commonly is needed for any updates to the database via a sites application or even by logging into the database with tools such as SQL Server Management Studio.</p>
<p>'''''Note:''' If you login successfully to an application but cannot see the database then it's usually a sign that the user you're connected with is not set as the DBO.''</p>
<br />
</li>

<li><p>Double check the values you have selected, then click the ''''Save'''' button to finish modifying this MS SQL database.</p></li></ol>

==Add an MSSQL User==
<br /><br />

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

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

<p>'''''Note:''' If you have databases on multiple database servers, you may need to click on the pencil icon next to the related MS SQL database server first (you should see a list of databases on each database server in order to differentiate).''</p></li>
<li><p>You should now see the below requested fields for the new MS SQL user:</p>
<br />
[[file:wcp_mssql_new_user_info.png]]
<br /><br />

<p>'''Username:''' ''Enter the name of the new MS SQL user you would like to add.''</p>
<p>'''Password:''' ''Enter the password for the new MS SQL user you would like to add.''</p>
<p>'''Permissions:''' ''The 'Permissions' section allows you to choose which databases the MS SQL user has access to. Select the checkbox for each database this user should have basic permissions to.''</p>
<p>'''''Note:''' The user does not automatically get assigned as DBO, which most task in MS SQL requires the user to be set as, so you'll have to follow the instructions in the above section ''''Update MS SQL Database Settings''''.''</p>
</li>
<br /><br />

<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>

===Updating MSSQL User Password &amp; Permissions===
<br /><br />

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

<li><p>Click on the pencil icon next to the user.</p>
<br />
[[file:wcp_edit_db_user.png]]
<br /><br />

<p>'''''Note:''' If you have databases on multiple database servers, you may need to click on the pencil icon next to the related MS SQL database server first (you should see a list of databases on each database server in order to differentiate).''</p></li>
<li><p>Now you will be able to update the MS SQL users password and / or permissions.</p>
<br />
[[file:wcp_edit_mssql_user_info.png]]
<br /><br />

<ul>
<li><p>To update your password enter in the newly desired password into the ''''Password'''' field. Passwords must:</p></li>
<ul>
<li>Be at least 6 characters long</li>
<li>Have a lowercase letter</li>
<li>Have a uppercase letter</li>
<li>Have a number</li>
<li>Have a symbol</li>
</ul>
<br />

<li><p>You may update this user's default database by selecting the new default database in the drop-down menu next to ''''Default Database''''.</p></li>
<br />

<li><p>The permissions section allows you to select the checkbox next to each database you wan the user to have basic permissions to. Please note that most MS SQL database functions and applications require that the user be set as the DBO, which you'll have to do through the above section for [[#Update_MS_SQL_Database_Settings| Updating Database Settings]].</p></li></ul>
</li>
<br /><br />

<li><p>Double check the values you have entered, then click the ''''Save'''' button.</p></li></ol>

[[Category:WCP_(Windows_based_Control_Panel)]]