System Update Center

ManageEngine ADSelfService Plus Service Packs

Keep your self-service password management secure with the latest ADSelfService Plus updates.

Server Update Process

Available ADSelfService Plus Service Packs

Find your current build number and verify the correct PPM file before executing your environment upgrade.

Current buildUpgrade path to the latest buildSHA256 Value
6500 to 6529- Install the service pack to move to the latest build.ccb85efdedc30f9b21870630749802ed00991238074e972be4f6b0b0f2683fbd
6400 to 6410- Install the service pack to move to build 6500.3e6e83bf0d9ff1742fe952dd52d6383c6cc023890851a88b70cd70ba35c5b4a7
6300 to 6310- Install the service pack to move to build 6400.f11e9c0ee746f99bb01f80583ed0faea128a5fdd19dbe61385ba704f457a8305
6200 to 6221- Install the service pack to move to build 6300.8f69b1d52b13bbdf8f2e574256f03e55fd72c53762c32801094a65a0f4045fb4
6100 to 6123- Install the service pack to move to build 6200.66dee66ba463ecf5ae9cd8430a9b35db9f7e26051161708f9d4bc7eb59effbdc
6000 to 6013- Install the service pack to move to build 6100.5a4b9b41a97abc45f5e725309b009f9d8cae78356d8a4057b63c886ed9be42bf
5800 to 5817- Install the service pack to move to build 6000.a1290bf3041a59a290bb0c5f9e48c42e967f3fa8788bf67c280ac91066b19178
5700 to 5710- Install the service pack to move to build 5800.1b52e075547e2c807260e3fece697ba291abc92c9fc9c75bc8aaf37e1999486a
5600 to 5607- Install the service pack to move to build 5700.3cd66add624796a585a947164b64567b8b5786a9fd328da9c22cae8dc6f48658
5500 to 5521- Install the service pack to move to build 5600.bb49ab27b848054e623aef245be504e50795b8938994f1ac51f60472a14df73f
5400- Install the service pack to move to build 5500.f17af5f6dbfef8f540cbf2ec883a45265253f744f442da21c7452d4bca2911eb
5300 to 5330- Install the service pack to move to build 5400.181d8cee846946c76b1274325f8a109785eae845a26ba836f0d0e8002c3fa19c
5200 to 5208- Install the service pack to move to build 5300.b3c818b1d1c482d61694d8fcdeb22d597b7e9b853efe1d2fe058360de26234db
5100 to 5116- Install the service pack to move to build 5200.0a4647145c12f95d12f37cebb303fdbf7092ae86f535f47c1714b7832c2ba889
5000 to 5041- Install the service pack to move to build 5100.8faea24f8435a564add2639c64b0cfcbe8c2d53754e580a697626efc736f2204

Service Pack Installation Steps

Service Pack Installation Steps:

  • 1 Shut down ADSelfService Plus.
    • If the product runs as an application, click Start > All Programs > ADSelfService Plus > Stop ADSelfService Plus.
    • If the product runs as a Windows service, click Start > Run. In the Run window, type services.msc, and in the window that opens, click stop ManageEngine AdSelfService Plus.
  • 3 Back up ADSelfService Plus.
    • When using the built-in PostgreSQL database:
      • Run the initPgsql.bat file located in <installation_directory>\bin (by default: C:\Program Files\ManageEngine\ADSelfService Plus\bin) from the Command Prompt using the privileges of a domain or local admin account.

        Requirements for running the initPgsql.bat file:

        • Ideally, the service account configured for ADSelfService Plus should be used for this. If the Command Prompt cannot be run with the service account credentials, use another account with administrative privileges to run it. In this case, you'll need to use this admin account to update ADSelfService Plus.
        • Ensure the initPgsql.bat file is not blocked from execution by the Active Directory Group Policy or antivirus software.
      • Run the backupDB.bat file located in <installation_directory>\bin (by default: C:\Program Files\ManageEngine\ADSelfService Plus\bin)
      • Back up ADSelfServicePlus by zipping the contents of the installation directory.
    • When using an external DB (external PgSQL, MSSQL, and MySQL):
      • If you are using an external database server (MS SQL, MySQL, or PostgreSQL), then take a backup of the database also.
      • Back up ADSelfServicePlus by zipping the contents of the installation directory.
      • If you are using a MySQL server and have McAfee antivirus scanning the machine, pause the antivirus software until the update process is complete.
  • 5 Click Browse and select the service pack file.
    (ManageEngine_ADSelfService_Plus_x_x_SP-x_x_x.ppm) that you have downloaded.
  • 6 Click Install. Depending on the amount of data to be migrated, the installation procedure may take a few minutes. Please do not terminate this process prematurely.
    Having problems? Troubleshoot here.
  • 7 Once the service pack is installed, click Close and then Exit to quit the Update Manager.
  • 8 Start ADSelfService Plus.
    • If the product runs as an application, click Start > All Programs > ADSelfService Plus > Start ADSelfService Plus.
    • If the product runs as a Windows service, click Start > Run. Type services.msc, and in the Window that opens, start ManageEngine ADSelfService Plus.

Troubleshooting the ADSelfService Plus installation.

You might encounter the following messages during installation:

  • 1 This Service Pack can be applied only on SP_X_X or later versions. So first update your product to version SP_X_X.

    Reason: The server is running a significantly older version of ADSelfService Plus. Your installation will need updates installed during a few subsequent (major) versions of the product before it will be ready for the latest version.

    Fix: Download and install every major version of ADSelfService Plus until the latest one.

    Steps:

    • If your version of ADSelfService Plus is significantly older than the latest build you might encounter an error such as this while trying to install the latest patch:
    • In this case, you will need to keep updating ADSelfService Plus to the next major version from your current one until the latest build. Note: You will have to reopen the Update Manager application every time you update the current version.

      So, for instance, if you are running version 6013, update to version 6100, then to version 6200, and then finally to version 6207 (the latest build). You can find these patches on the ManageEngine site.

  • 2 IMPORT CERTIFICATE.

    Reason: The server is running an older version of ADSelfService Plus (before version 6201) and cannot connect to the ManageEngine site (blocked port, firewall restrictions, no internet connection, etc). The Update Manager automatically imports the certificate when it is able to connect to the ManageEngine site. However, when it cannot do so, you will need to import the certificate manually.

    Fix: Import the certificate manually.

    Steps:

    • If your version of ADSelfService Plus is older than version 6200, follow all the steps in the section 1 until you have version 6200.
    • Now install the next version. If the server is unable to connect to the ManageEngine site, you might get this pop-up:
    • Since the Update Manager is unable to connect to the ManageEngine site to import the certificate, you will need to import the certificate manually.
    • Steps to import the security certificate manually:
      1. Download the certificate by clicking this link.
      2. Once downloaded, click Import Certificate in the Update Manager to open the Import Certificate wizard.
      3. Now, click Browse and select the downloaded certificate file. Click Import. You should get an information pop-up about the certificate being successfully imported.
      4. Once imported, click Browse in the Update Manager and select the relevant PPM file. (greater than version 6200).
      5. Click Install. Depending on the amount of data to be migrated, the installation procedure may take a few minutes. Please do not terminate the process before completion.
      6. Once the installation is complete, click Close.
      7. Click Exit to quit Update Manager.
      8. Now, start ADSelfService Plus to use the updated build.

Applying a service pack when

  1. Shut down both the primary and standby servers.
  2. Follow steps 3 through 7 given above and apply the service pack, first in the primary server and then in the standby server.
    Note: To identify the primary server, open the fos.conf located in <installation directory>\conf and locate the ha.servertype=MASTER entry.
  3. Start the primary server first and then the standby server.
  1. Shut down both the primary and secondary nodes.
  2. Follow steps 3 through 8 given above and apply the service pack, first in the primary node and then in the secondary nodes.
    Note: To identify the primary node, open the product_detail.conf file located in <installation_directory>\conf and locate the IS_CLUSTER_PRIMARY=true entry.
  3. Start the primary node first and then the secondary nodes.