How to move the ADSelfService Plus installation from one server to another?

Description

Situations may arise in which you may want to move ADSelfService Plus from one server to another. This article will guide you through the migration process.

Resolution

Note: Please upgrade ADSelfService Plus to the latest build using the Service Pack before migration. And, do not uninstall ADSelfService Plus from the old machine until the new installation works fine.

Step 1: Identify the database

• Navigate to <install_dir>/conf (By default: C:\ManageEngine\ADSelfService Plus\conf)
• Open database_params.conf file in a text editor and identify the database that is being used by ADSelfService Plus in your environment
• If the database is PostgreSQL, then continue with Step 2
• If the database is MySQL or MS SQL, then contact ADSelfService Plus support for further guidance

Step 2: Back-up the database from old server

• Stop ADSelfService Plus
  • Start --> All Programs --> ADSelfService Plus --> Stop ADSelfService Plus
  • In case you have installed ADSelfService Plus as a NT Service, stop the service (Start --> Run --> type Services.msc --> Stop ManageEngine ADSelfService Plus)
• Start the Command Prompt as an administrator (right-click Command Prompt and select 'Run as Administrator')
• Navigate to <Installation_Dir\bin> folder (By default: C:\ManageEngine\ADSelfService Plus\bin)
• Now execute the command backupDB.bat. This will back-up the database.
• A folder named Backup will be created at ADSelfService Plus installation directory (By default: C:\ManageEngine\ADSelfService Plus\Backup) and it will contain the DB backup in compressed file format (eg: 081224-1547.zip)

Step 3 (Optional): Back-up patch files if any

• Take a copy of the Patch folder present in ADSelfService Plus installation directory (By default: C:\ManageEngine\ADSelfService Plus)

Step 4: Restore the database in the new server

• Install ADSelfService Plus on the new server. Its version (and build no.) should be the same as the one that you have been using on the old server.

Note: In case you want to continue with the older version of ADSelfService Plus and not able to find the older build of ADSelfService Plus, then contact ADSelfService Plus support for assistance.

• Stop ADSelfService Plus
  • Start --> All Programs --> ADSelfService Plus --> Stop ADSelfService Plus
  • In case you have installed ADSelfService Plus as a NT Service, stop the service (Start --> Run --> type Services.msc --> Stop ManageEngine ADSelfService Plus)
• (Optional) Paste the Patch folder under the ADSelfService Plus installation directory (By default: C:\ManageEngine\ADSelfService Plus) if you have followed Step 3
• Copy and paste the compressed file (ZIP) under the <Installation_Dir>\bin (By default: C:\ManageEngine\ADSelfService Plus\bin) folder
• Start the Command Prompt as an administrator (right-click Command Prompt and select 'Run as Administrator')
• Navigate to <Installation_Dir>\bin folder (By default: C:\ManageEngine\ADSelfService Plus\bin)
• Now, execute the following command:

restoreDB.bat compressed_file_name.zip
Eg: restoreDB.bat 081224-1547.zip

• Start ADSelfService Plus