General - How To's

How to configure Desktop Central to make it use MS SQL Server as the database?

Desktop Central extends support for using MS SQL database for storing the configuration and data. This document will explain the steps to configure Desktop Central and MS SQL Server to use MS SQL as the back end database. The following steps can be followed to set up a fresh MS SQL database or migrate data from an existing database to new MS SQL database. For both of these cases, you should first upgrade to Desktop Central build 10 or above versions before following any of these steps.

Important Note:

This document is applicable for the following Migration process,

  • Migration of Desktop Central from MYSQL to MSSQL database.
  • Migration of Desktop Central from PGSQL to MSSQL database.
  • Migration of Desktop Central from one MSSQL server to another.

Note :

  1. Desktop Central Supports MS SQL 2005 or later versions. 
  2. If you are using "Failover Server" contact our support team for migration assistance. 

Change the Database Server to MS SQL

The following steps will explain you, to backup the data from the old server, change the database server and restore the data in the MS SQL database.

  1. Configuring SQL server

    Perform the steps below from the computer where MS SQL Server is installed,

    1. Choose Start --> Run and type services.msc.
    2. Ensure that "SQL Browser" service has been started. If not, start the service.
    3. Open the SQL Server Configuration Manager from the Start menu
    4. Expand SQL Server Configuration Manager (Local) and navigate to SQL Server Network Configuration.
    5. Choose the Instance on which you wish to run the database and check if TCP/IP ports are enabled. If not, right-click on TCP/IP and enable it.
    6. You should restart the SQL Service after you enable TCP/IP. Select SQL Server Services from the left pane, right-click the instance and choose Restart.

      SQL Server Configuration Manager

      Note: Ensure that the you configure Windows firewall to allow access to SQL server. Refer this document for more information.

  2. Migrating the database to SQL server

    From the computer where Desktop Central Server is installed, perform the steps below:

    1. Stop Desktop Central Server
    2. Open command prompt as Administrator
    3. Execute the script changeDBServer.bat available under <Desktop Central Home>/bin directory. This invokes the Database Setup wizard.
    4. Select Database Type as SQL Server
    5. Specify the Host Name where SQL Server is installed
    6. From the list of available instances, select the instance on which you wish to run the database.
    7. You can choose to authenticate the database connection either using Windows Authentication or SQL Server Authentication. Choose the required authentication and provide the credentials.
    8. Click the checkbox to enable NTLM authentication.
    9. Click the check box to "Migrate Data from Existing Database". So that the existing data will be migrated to the MSSQl server.
      Note: This is applicable only if you wanted to migrate your existing database to MS SQL. If you are trying to create a fresh set up, then you can ignore this step.
    10. Click Save to save and complete the SQL Server Configuration. It may be noted that it will take a few minutes to configure the settings on the SQL Server.


      Database Setup Wizard - Windows Authentication

      Fig: Windows Authentication

      Database Setup Wizard - SQL Server Authentication

      Fig: SQL Server Authentication

      Note :

      1. One of the best practise recommended is to, Click Test to check whether a connection could be established with the given credential.
      2. If you get any Error messages such as "Authentication Error", check to verify the correctness of specified credentials.(Do not take a back up of the database again)
      3. This might take several minutes, the size of your database determines the time taken.

Ensure that the collation for the Desktop Central folder in MSSQL database is set as SQL_Latin1_General_CP1_CI_AS if it is not set, follow the steps mentioned below to change the collation.

    1. Go to Desktop Central database.
    2. Right click 'desktopcentral' folder
    3. Click properties to view the database properties of 'desktopcentral'
    4. Under Maintenance select SQL_Latin1_General_CP1_CI_AS from the drop down and click OK.


      5. Start Desktop Central.

    You can start using Desktop Central which has been migrated from the previous location.