How do I migrate my ADManager Plus installation from 32-bit to 64-bit on the same server using the built-in PostgreSQL database?

How do I migrate my ADManager Plus installation from 32-bit to 64-bit on the same server using the built-in PostgreSQL database?

Objective 

This article explains how to migrate ADManager Plus from the 32-bit version to the 64-bit version on the same server. Migrating to the 64-bit version enables better performance, improved memory handling, and compatibility with modern systems. This process involves backing up the existing 32-bit instance, installing the 64-bit version, and restoring the backup to the new instance.

Prerequisites 

  • Latest service pack installed for the 32-bit version of ADManager Plus.  

  • Administrator privileges on the server.   

  • Sufficient disk space for backup and installation.  

Step to follow

Step 1: Upgrade the 32-bit version   

1. Make sure your current 32-bit ADManager Plus installation is updated to the latest version using the appropriate service pack.

Step 2: Backup the database and configuration file 

  1. Stop ADManager Plus:

    • If running as an application, go to Start > All Programs > ADManager Plus > Stop ADManager Plus.

    • If running as a service, press Windows + R, type services.msc, and stop the ManageEngine ADManager Plus service.

  2. Open Command Prompt as an administrator and navigate to C:\<installation directory>\ADManager Plus\bin.

  3. Run the backupDB.bat file to back up the database. This creates a folder named Backup inside the installation directory containing the backup file (e.g., OfflineBackup_20230215191814.ezip).

  4. Navigate to C:\<installation directory>\ADManager Plus\conf.

  5. Make a copy of the customer-config.xml file and save it in a secure location. This file contains important configuration details. 

Step 3: Rename the InstallShield folder 

  1. Open File Explorer, go to View > Show > Hidden items to reveal hidden folders.

  2. Navigate to C:\Program Files(x86)\InstallShield Installation Information.

  3. Locate the folder named {CC00BC3F-40AE-49A7-BA63-FE2F93D20585} and rename it to {CC00BC3F-40AE-49A7-BA63-FE2F93D20585}_bak.

Step 4: Download and install ADManager Plus (64-bit version) 

  1. Download the 64-bit version of your current build from this index by identifying your build number and selecting the matching file.
  2. Install the 64-bit version on the same server as the 32-bit instance.  
  3. Do not start the product after installation.  

Step 5: Restore the configuration file and database backup  

  1. Replace the customer-config.xml file in the new installation directory at <installation dir>\ADManager Plus\conf with the one copied from the old instance.

  2. Copy the database backup file (e.g., OfflineBackup_20230215191814.ezip) from the old instance’s backup folder (<installation dir>\ADManager Plus\backup) to the new instance’s bin folder (<installation dir>\ADManager Plus\bin).

  3. Open Command Prompt as an administrator, navigate to <installation dir>\ADManager Plus\bin.

  4. Run the restoreDB.bat file with the backup file name (e.g., restoreDB.bat OfflineBackup_20230215191814.ezip -p).

  5. When prompted for a password during the restore process:

    • If a ZIP file for the database password was configured earlier under Admin > Security and Privacy > Privacy, enter that password.

    • If no password was set, copy the value from the <crypt> tag in the old instance’s customer-config.xml file and paste it as the password.

Step 6: Start ADManager Plus 

  1. Start ADManager Plus by opening services.msc, locating ManageEngine ADManager Plus in the list, and starting the service.

Tips     

  • Perform the migration in a non-production environment first to validate the process and outcomes.

  • Retain the 32-bit instance until the 64-bit setup has been tested and confirmed to function as expected.

  • Plan the migration during a scheduled maintenance window to minimize potential disruptions.

                  New to ADSelfService Plus?