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

Last updated on:

In this page

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.

Steps 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.