Database Migration Tool

Database Migration Tool

You can use this tool to migrate data between two databases (Postgres to MSSQL and vice versa) as well as between operating systems (Linux to Windows and vice versa).

 

You can perform the following data migration with this tool:

  • Server migration across databases ( Postgres to MSSQL or MSSQL to Postgres )

  • MSSQL database server migration from one database server to another.

 

Possible database migrations

Postgres to Postgres: Data can be migrated between two databases of the same installation as well as different installation.
Postgres to MSSQL: Data can be migrated between two databases of the same installation as well as also different installation.
MSSQL to Postgres: Data can be migrated between two databases of the same installation as well as also different installation.
MSSQL to MSSQL: Data can be migrated between two databases of the same installation as well as different installation.

 

By using the DBM tool, only the table data gets migrated,  files/attachments in the application are not migrated during migration. The files and folders are zipped and placed under supportcenterplus-directory which should be extracted in the destination server in case of migration to a different installation.


Prerequisites

Database configurations details (such as host, port, username, password) of source server and destination server are required.


The server where the migration script (migratedb.bat/sh) is executed will be considered as source DB and source database details will be taken from conf/databaseparams.conf file.

   

Performing database migration   

Steps to be followed in the destination database application:

1.In the case of postgres, from the destination database, execute {build_dir}/bin/run.bat. This will create the destinationdb database with the information available in conf/database_params. You can also modify the destinationdb details by executing bin/changeDBServer.bat.

2.For migration to occur, the destination database should be empty, run {build_dir}/bin/reinitialize.bat. This will empty the destination database.

3.Start the destinationdb server to establish connection from the source. To start the server, run {build_dir}/bin/startDB.bat.

 

Steps to be followed in the source database application:

In the case of mssql, the database will be created while filling destinationdb details in the applet.

4.  From the source application, connect to the destination database by executing {build_dir}/bin/migrateDB.bat. To get destination database server information, a dialog box will be prompted similar to changeDB. The destination database details can be filled from console by running migrateDB.bat --console.




        

        

 

Also the destination database details can be filled in from the console by running migrateDB.bat --console

  • Select 1 if the destination database server type is postgres

  • Select 2 if the destination database server type is mssql.

  • Select 3 to exit.

 

 

 

 

 

Once the given destination details are connected, the type of migration is asked. If you are migrating data from one server to another in a same installation, choose data migration. If you are migrating the data to a different installation, select server migration.

If you choose server migration, the files/attachments backup will be taken as dbMigrationFileBackup.ezip and placed under <supportcenterplus-home>/dbMigrationFileBackup folder, which should be extracted in the destination installation.

 

If you do not select a migration type, by default Data Migration will be selected.

If the file attachment location is configured externally by configuring attachment settings, then the fileattachments folder will not be included in the migration. Since file attachments are not saved in the supportcenterplus directory, they are not included in filebackup. However, if server migration and the file attachments location are not configured externally, then it will be included.

 



Production or Test Setup Confirmation

Once you have selected a migration type, a popup will be shown to confirm whether you want to migrate the data to production or test setup. Click Yes if you want to migrate the data to the production build. If you want to test the migrated data in a test instance, you can click No. You can also Cancel the migration.
 

 

 

 

 

In the case of Postgres, the supported collation type is C in both source and destination servers. If the destination server has a different collation type, then you are prompted to create a database with the default collation type. If the source server has a different collation type, the collation type cannot be modified and hence you are prompted to take backup and restore it in a bundled database in case of migration to the production setup. Migration to the test setup is allowed though.

 

 

 

Once the type of migration is chosen and the production or test setup confirmation is done, the migration starts and the progress bar will be displayed.


 

 

When the database migration is complete, you will get a popup confirming the same.

 

 

On completion of a server migration, the following popup will be displayed, prompting you to extract the zipped files under <supportcenterplus/dbMigrationFileBackup> from the source server to <supportcenterplus> folder on the destination server before the server starts up.



If the file attachments folder is configured externally on the source server, then steps to configuring the same in the destination server will be displayed as well.

 

 

Similarly, if the migration fails, a popup will be displayed informing the same.


    • Related Articles

    • Database Migration

      Migration between Postgres and Microsoft SQL SupportCenter Plus comes bundled with Postgres. From build 14000, the database files generated from the scheduled backup are no longer cross-compatible. However, you can migrate between Postgres and ...
    • Contract Migration Disclaimer

      Rate Type: Rate Type configuration is implemented through Bill Rules and Request & Time Entry additional fields for cost handling Request and Time Entry picklist additional fields will be created with the name "Rate type" with the previously present ...
    • Configuring Database

      In GUI Setups Configuring Database Server SupportCenter Plus is bundled with PostgreSQL database. You can also configure the application to set up MS SQL database. PostgreSQL 1. Go to <SupportCenter_Plus_Home>\bin directory in the command prompt and ...
    • Database Error Codes and Troubleshooting

      The following table provides common database errors and corresponding troubleshooting tips. Error ID   Error Root cause and troubleshooting steps 1000 ERROR_WHILE_GETTING_CONNECTION Root cause: Connection could not be established with the MSSQL ...
    • Rest API

      About REST API Application Programming Interface (API) is used to integrate various applications and facilitate sharing of data between them. The integration can be achieved with any third-party (external) applications or web services that are ...