How to move application server from one machine to other?

Description

I have OpsHub Integration Manager installed on one machine. Now, I want to move OpsHub Integration Manager from that machine to other machine. How can I do this migration?

Solution

Assumptions

1. Username and password of old and new database instances is known to you.

2. You have the password of systems users configured in OpsHub Integration Manager.

3. These steps are applicable for same database type, for example, if your OpsHub Integration Manager database is on MySQL, then you can move it to other instance of MySQL (not to any other database type).

4. Make sure your old and new database versions are also same. For example, if your OpsHub Integration Manager is installed on MySQL 5.6, then your new database MySQL instance should also have that same version.

5. Database name of older and newer server is same.

Steps

1. Inactivate all integrations.

1. Stop the OpsHub Integration Manager server.

1. Take application and database backup:

   • Take Application backup. For more information on how to take application backup, refer Application Backup.

   • Take Database backup. For more information on how to take database backup, refer Database Backup.

   • Make sure you have taken application and database backup properly. If you miss this backup and any of the subsequent steps fail, then you won't be able to restore the application.

2. Remove the data of the old instance:

   • After taking database backup, drop the database.

   • Uninstall OpsHub Integration Manager from the older instance.

3. Install the same OpsHub Integration Manager version on the machine where you want to move OpsHub Integration Manager server. During installation, select the database server where you want your OpsHub Integration Manager database. While configuring installation, make sure database name is same as old installation. If your old OpsHub Integration Manager instance database name is custom (other than 'opshub' and 'reportsdb'), then make sure in this new installation the database name remains the same.

• You can refer OpsHub Database Custom Configuration documentation for selecting database name during installation time.

1. If for any reason, installation failed, follow the steps below:

   • See installation fail error and try to resolve it. You can also refer logs to get more error information on this error. Navigate <Install_Folder>/logs folder and see install.log file.

   • Once you find the error and resolve it, re-install the application. First clean the installation folder on which installation failed and then re-install it on the same folder.

   • If you are not able to resolve this error, then send the <Install_Folder>/logs folder to OpsHub Integration Manager support team. Restore application to earlier state until this issue is fixed:

   • Restore applicable folder by following Application Restore documentation.

   • Restore database by following Database Restore documentation.

2. If installation finished successfully, follow the steps below:

• Stop the OpsHub Integration Manager.

• Restore the database(s) from the backup taken from old OpsHub Integration Manager instance/server into the new OpsHub Integration Manager database instance/server. For more information, refer Database Restore.

• Start new OpsHub Integration Manager server.

• Re-enter the password for sync user configured in systems and integration

• Load field mapping and integration to validate connectivity.

1. Now you can activate integrations as per your requirement.