How to Migrate from 32-bit Version of ADSelfService Plus to the ADSelfService Plus 64-bit

Migrating from ADSelfService Plus 32-bit to ADSelfService Plus 64-bit

This article will help you migrate from ADSelfService Plus 32-bit version to the 64-bit version.

Before you begin

  • 32-bit to 64-bit migration is possible only between the same builds. For example, you cannot migrate from a 32-bit version of build 5310 to a 64-bit version of build 5311 or 5309.
  • Please upgrade your 32-bit version of ADSelfService Plus to the latest build using the service pack before migration. This will ensure that the above point does not become an issue.
  • Please take a backup of the ADSelfService Plus directory before you proceed. If you are going to install the 64-bit version in a new machine, then do not uninstall ADSelfService Plus from the old machine until the new installation works fine.

Performing the migration

Step 1: Identify the database

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

Step 2: Back up the database

  1. Stop ADSelfService Plus (Start All ProgramsADSelfService Plus Stop ADSelfService Plus).
  2. In case you have installed ADSelfService Plus as a NT Service, stop the service (StartRun → type Services.mscStop ManageEngine ADSelfService Plus)
  3. Start the Command Prompt as an administrator (right-click Command Prompt and select Run as Administrator).
  4. In the command prompt, change the directory to <Installation_directory>\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). It will contain the database backup in compressed file format (E.g.: 081224-1547.zip)
  7. Take a backup of the whole ADSelfService Plus directory (C:\ManageEngine\ADSelfService Plus)

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

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

  1. Uninstall ADSelfService Plus.
  2. Download and install ADSelfService Plus 64-bit. Its build number should be the same as the 32-bit version you were running.

    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.

  3. Stop ADSelfService Plus. In case you have installed ADSelfService Plus as a NT Service, stop the service.
  4. (Optional) Paste the Patch folder under the ADSelfService Plus installation directory (By default: C:\ManageEngine\ADSelfService Plusif you have followed Step 3.
  5. Copy the customer-config.xml from the <Installation_Dir>\conf (By default: C:\ManageEngine\ADSelfService Plus\conf) folder, rename the file to new-customer-config.xml and place that in the <Installation_Dir>\conf folder of the new installation directory.
  6. Copy and paste the compressed (ZIP) file (from Step 2.f) under the <Installation_Dir>\bin folder (By default: C:\ManageEngine\ADSelfService Plus\bin).
  7. Start the Command Prompt as an administrator.
  8. Navigate to <Installation_Dir>\bin folder (By default: C:\ManageEngine\ADSelfService Plus\bin)
  9. Now, execute the following command:

    restoreDB.bat compressed_file_name.zip -p <password>
    E.g.:
    restoreDB.bat 081224-1547.zip -p <password>

    The password for the database backup file could be one of two types:

    1. Default password: This is the reverse string of the filename. For the filename mentioned above, the password would be "7451-422180".
    2. Admin-configured password: This is the custom password that was configured in the admin portal before creating the database backup. The Change Password For Database Backup Files option under Admin → Connection → General Settings is used for this.

    If you have forgotten the password to the backup file, but have access to the ADSelfService Plus installation directory, the encrypted password can be obtained from the customer-config.xml file (<installation_dir>\conf\customer-config.xml), and you can contact support@adselfserviceplus.com to decrypt it.

    If not, the backup will be inaccessible and a new backup will have to be created.

Step 5: Restore the SSL Certificate

  1. Please take a backup of the "server.xml", "web.xml" and ".keystore/.pfx" files located at <Installation_Dir>\bin\conf folder to restore the certificate and paste them in the respective locations in the new server.
  2. Please copy the "DomainLogin.html" file located at <Installation_Dir>\ManageEngine\ADSelfService Plus\webapps\adssp\html folder from the old installation and paste it in the respective location in the new installation.
  3. Please copy the "images" folder located at <Installation_Dir>\ManageEngine\ADSelfService Plus\webapps\adssp folder from the old installation and paste it in the respective location in the new installation.
  4. Take a copy of the license file "AdventNetLicense.xml" from the old server which is located at <Installation_Dir>\ManageEngine\ADSelfService Plus\lib folder.
  5. Start ADSelfService Plus.

    You should’ve now successfully migrated from the 32-bit version of ADSelfService Plus to the 64-bit.

    If you face any issues in the migration process or have any feedback for improving this article, please let us know by contacting support@adselfserviceplus.com.


        New to ADManager Plus?

          New to ADSelfService Plus?

            • Related Articles

            • How to migrate the ADSelfService Plus installation from one machine to another

              Description This article will guide you through the process for migrating the ADSelfService Plus installation from one machine to another. Important: Before you start the migration process, please update your ADSelfService Plus installation to the ...
            • Migration from PostgreSQL database server to MS SQL

              ADSelfService Plus comes bundled with a PostgreSQL database server to store basic user attributes and enrollment data. It also allows you to migrate from the built-in PostgreSQL to MS SQL. This guide will walk you through the database server ...
            • Configuring high availability in ADSelfService Plus

              ADSelfService Plus utilizes automatic failover to support high availability in case of system and product failures. Essentially, this means that when the ADSelfService Plus service on one machine fails, another instance of ADSelfService Plus running ...
            • Change the default ADSelfService Plus admin password to improve security

              Description By default, ADSelfService Plus has default admin account. This account has all the privileges and access to the ADSelfService Plus admin console. The default admin account uses the word admin as the username and the password. It is highly ...
            • ADSelfService Plus Text Customization

              The Language Customization feature in ADSelfService Plus lets you customize any text in the self-service password reset software that is displayed in the user interface. Tooltips, error messages, buttons, and text fields can be customized to suit ...