Troubleshooting Tips | ManageEngine ADSelfService Plus

ADSelfService Plus product startup issues

What do you need to know before troubleshooting

You need to have administrator access to ADSelfService Plus.

When you experience an error with ADSelfService Plus, check if these prerequisites are satisfied:
  1. Install ADSelfService Plus as a service
  2. Port availability
  3. Sufficient folder permissions
  4. Remove the .lock file
  5. Sufficient RAM size and database accessibility
  6. Add sites to the local intranet zone

Troubleshooting

Step 1. Install ADSelfService Plus as a service

If ADSelfService Plus is not accessible after rebooting the server, it could be because the product is running as an application and not as a service. Shut down the application and start it as a service.

Shutting down ADSelfService Plus
  1. Open command prompt and redirect it to <Installation folder>\Bin (Location: C:\ManageEngine\ADSelfService Plus\Bin).
  2. Execute stop.bat and shutdown.bat.
Start ADSelfService Plus as a service
  1. Go to Start > select Run > type services.msc.
  2. Navigate to ManageEngine ADSelfService Plus and select Properties.
  3. Go to Logon Tab > choose This Account. Enter your administrative credentials and click OK.
  4. Now, right-click on ManageEngine ADSelfService Plus and select Start.
Important: If you haven't installed ADSelfService Plus as a service, follow the steps below:
Stop ADSelfService Plus (Go to Start > All Programs > ADSelfService Plus > Stop ADSelfService Plus).
Install ADSelfService Plus as a service (Go to Start > All Programs > ADSelfService Plus > NTService > Install ADSelfService Plus as Service).
Configure ADSelfService Plus to run automatically
  1. Go to Start > click Run > type services.msc.
  2. Navigate to ManageEngine ADSelfService Plus and select Properties.
  3. In the window that opens, select the option as automatic.

Step 2. Check port availability

  1. Go to the command prompt and execute netstat -ano | findstr 8888 (8888 is the default port number of ADSelfService Plus).
  2. Check the corresponding PID in the Task Manager. Go to the Task Manager > select View > click Columns > Enable PID.
  3. Click OK.
  4. If the port is used by any other product or process, restart the ADSelfService Plus server.

Step 3. Configure folder permissions

      1. Open command prompt and redirect it to <Installation folder>\Bin (Location: C:\ManageEngine\ADSelfService Plus\Bin).
      2. Execute stopDB.bat and stopADSSP.bat.
      3. Open Task Manager and check whether you have wrapper.exe, mysqNT.exe/ postgres.exe or java.exe.
Note: If any of the wrappers are found under processes kill each process in the above order.
      4. Grant Full Control to the installation folder of ADSelfService Plus and the account configured under Domain Settings\services.msc.
Note: If you have selected Local System account under Log On option in Services.msc, ensure that the credential with which you have logged in to ADSelfService Plus installed machine has full control over the ADSelfService Plus folder.
      5. Restart ADSelfService Plus.

Step 4. Remove the .lock file

If the .lock file in the Bin folder was not removed due to improper server shutdown, follow the steps below:
      1. Open command prompt and redirect it to <Installation folder>\Bin (Location: C:\ManageEngine\ADSelfService Plus\Bin).
      2. Find the .lock and postmaster.pid files in the installation folder of ADSelfService Plus and delete them.
      3. Grant Full Control to the installation folder of ADSelfService Plus and the account configured under Domain Settings\services.msc.
Note: If you have selected Local System account under Log On option in Services.msc, ensure that the credential with which you have logged in to ADSelfService Plus installed machine has full control over the ADSelfService Plus folder.
      4. Restart ADSelfService Plus.

Step 5. Check RAM size and database accessibility

Ensure that ADSelfService Plus has a minimum of two to four GB space in the server instance and that the organization's database is reachable from the server.

Step 6. Adding ADSelfService Plus access URL to the trusted sites.

If sites are not added to the local intranet zone, a blank page might be displayed when admins try to access ADSelfService Plus via a browser.

How to add sites to the Local intranet zone?

The required configuration can be applied in two ways.
  1. Using a group policy
  2. Manual configuration

Method 1: Using a group policy (supported on Google Chrome and Internet Explorer)

  1. Create a new Group Policy Object and navigate to User Configuration → Administrative Templates → Windows Components → Internet Explorer → Internet Control Panel → Security Page → Sites to Zones Assignment list. Select Enable.
  2. Click Show to display the zone assignments. Enter the access URL in Value name and relate it to the trusted sites by entering the number 1 in Value, and then click OK.
  3. Navigate to User Configurations → Administrative Templates → All Settings → Logon options. Select Enable.
  4. From the Logon options list, click Automatic logon only in Intranet zone, and then click OK.

Method 2: Manual configuration

Google Chrome:
  1. Navigate to Settings → Advanced drop-down → System module → Open proxy settings.
  2. Click the Security tab and select the Local intranet icon.
  3. Click the Sites button and proceed to enter the access URL of ADSelfService Plus in the required field, and click Add.
Internet Explorer:
  1. Navigate to Tools → Internet Options → Security.
  2. Click the Security tab and select the Local intranet icon.
  3. Click the Sites button and proceed to enter the access URL of ADSelfService Plus in the required field, and then click Add.
Mozilla Firefox:
  1. Type about:config in the address bar and hit the enter key to display the list of preferences. If there's a warning message displayed, click the I accept the risk button to proceed.
  2. Navigate to the network.automatic-ntlm-auth.trusted-uris preference.
  3. Double-click the preference and enter the access URL of ADSelfService Plus. For example: selfservice-5994:8888
  4. Click OK.
        New to M365 Manager Plus?
        New to M365 Manager Plus?
          New to RecoveryManager Plus?
          New to RecoveryManager Plus?
            New to Exchange Reporter Plus?
            New to Exchange Reporter Plus?
              New to SharePoint Manager Plus?
              New to SharePoint Manager Plus?
                  See all integrations
                  New to ADManager Plus?

                    New to ADSelfService Plus?

                    Start your free trial

                      • Related Articles

                      • Troubleshooting Guide for Common Errors in ADSelfService Plus End User Portal

                        Permission denied. Please contact your administrator. Cause: There are two reasons why this error could occur: End users trying to access any of the self-service features in ADSelfService Plus such as password reset or directory self-update need to ...

                      • How to enable offline MFA in ADSelfService Plus

                        ManageEngine ADSelfService Plus supports offline multi-factor authentication (MFA) for Windows machine logins, User Account Control (UAC) prompt elevation, and Remote Desktop Protocol (RDP) server authentication when the product server is ...

                      • Bind ADSelfService Plus to run on a specific virtual IP address

                        Description You can configure ADSelfService Plus to run on specific IP address. Resolution Step 1: Create a virtual IP Address on the machine where ADSelfService Plus is running. Start → Settings → Control Panel → Open Network connection. Right click ...

                      • Automatically backup the ADSelfService Plus database

                        Description The database used in ADSelfService Plus houses some important information that is crucial for the proper functioning of the tool. As a proactive measure against the loss of data, the ADSelfService Plus application provides you Automatic ...

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

                        Related Products