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

Description

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

Steps to migrate your ADSelfService Plus installation

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

If you have enabled high availability in the old machine, click here.

Step 1: Identify the database

• Navigate to the configuration folder - <install_dir>\conf. (By defaul it is in the location: C:\ManageEngine\ADSelfService Plus\conf.
• Open database_params.conf file in a text editor and identify the database that is being used by your ADSelfService Plus installation.
• If the database is PostgreSQL, then proceed with Step 2.
• If the database is MySQL or MS SQL, then contact ADSelfService Plus support team for further guidance.

Step 2: Back up the ADSelfService Plus' database from old machine

• Stop your ADSelfService Plus application/service.
  1. Start → All Programs → ADSelfService Plus → Stop ADSelfService Plus.
  2. In case you have installed ADSelfService Plus as a NT Service, stop the service (Start → Run → type Services.msc → Stop ManageEngine ADSelfService Plus).
  3. Open the Command Prompt as an administrator (right-click Command Prompt and select 'Run as Administrator').
  4. Navigate to <Installation_Dir>\bin folder (By default: C:\ManageEngine\ADSelfService Plus\bin).
  5. Now execute the command backupDB.bat. This will back up the database.
  6. 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 back up in compressed file format (eg: 081224-1547.zip).

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

• Copy the Patch folder present in ADSelfService Plus installation directory (By default: C:\ManageEngine\ADSelfService Plus).

Step 4 (Optional): Back up customized language files if any

• Navigate to <installation directory>\resources and copy the resource folder.

Step 5 (Optional): Back up customized login page and GINA\CP layout if any

• Navigate to <installation directory>\webapps\adssp and copy the html folder and the styles folder.

Step 6 (Optional): Back up SSL certificates if any

If you have enabled HTTPS option for ADSelfService Plus in the old machine, then

• Navigate to the <installation directory>\conf folder and copy the server.xml, web.xml, and SSL keystore(Example: server.keystore)files.

Note: If you do not know the build number of your old ADSelfService Plus installation, contact our support team. 

• Stop ADSelfService Plus
  1. Start → All Programs → ADSelfService Plus → Stop ADSelfService Plus
  2. 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.
• (Optional) Paste the resource folder under the ADSelfService Plus installation directory (By default: C:\ManageEngine\ADSelfService Plus) if you have followed Step 4.
• (Optional) Paste the html and the styles folders in the <installation directory>\webapps\adssp folder if you have followed Step 5.
• (Optional) Paste the server.xml, web.xml, and the SSL  keystore files in the <installation directory>\conf folder if you have followed Step 6.
• Copy and paste the compressed file (ZIP) under the <Installation_Dir>\binstrong> (By default: C:\ManageEngine\ADSelfService Plus\bin) folder
• Open the Command Prompt as an administrator (right-click Command Prompt and select 'Run as Administrator')
• Navigate to <Installation_Dir>\binstrong> 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 

Steps to follow for high availability setup during migration

• Access the ADSelfService Plus web-console after shutting down the primary server. You will automatically be redirected to the standby server.
• Disable High Availability (Navigate to Admin → Product Settings → High Availability) on the standby server.
• Restart the primary and the standby servers.
• Migrate the primary ADSelfService Plus installation from the old machine to the new machine. Find the detailed steps here.
• Once the migration is complete, enable High Availability on the new machine.