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.

If your build number isUpdate to build number
6500 to 6525

Download and update to 6526

6400 to 6410

Download and update to 6500

6300 to 6310

Download and update to 6400

6200 to 6221

Download and update to 6300

6100 to 6123

Download and update to 6200

6000 to 6013

Download and update to 6100

5800 to 5817

Download and update to 6000

5700 to 5710

Download and update to 5800

5600 to 5607

Download and update to 5700

5500 to 5521

Download and update to 5600

5400

Download and update to 5500

5300 to 5330

Download and update to 5400

5200 to 5208

Download and update to 5300

5100 to 5116

Download and update to 5200

5000 to 5041

Download and update to 5100

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.