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:
- Install ADSelfService Plus as a service
- Port availability
- Sufficient folder permissions
- Remove the .lock file
- Sufficient RAM size and database accessibility
- 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
- Open Command Prompt and redirect it to <Installation folder>\bin (Location: C:\ManageEngine\ADSelfService Plus\bin).
- Execute stopDB.bat and shutdown.bat.
Start ADSelfService Plus as a service
- Go to Start > select Run > type services.msc.
- Navigate to ManageEngine ADSelfService Plus and select Properties.
- Go to Logon Tab > choose This Account. Enter your administrative credentials and click OK.
- 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
- Go to Start > click Run > type services.msc.
- Navigate to ManageEngine ADSelfService Plus and select Properties.
- In the window that opens, select the option as automatic.
Step 2. Check port availability
- Go to the Command Prompt and execute netstat -ano | findstr 8888 (8888 is the default port number of ADSelfService Plus).
- Check the corresponding PID in the Task Manager. Go to the Task Manager > select View > click Columns > Enable PID.
- Click OK.
- If the port is used by any other product or process, restart the ADSelfService Plus server.
1. Open Command Prompt and redirect it to <Installation folder>\bin (Location: C:\ManageEngine\ADSelfService Plus\bin).
2. Execute stopDB.bat and shutdown.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.
- Using a group policy
- Manual configuration
Method 1: Using a group policy (supported on Google Chrome and Internet Explorer)
- 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.
- 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.
- Navigate to User Configurations → Administrative Templates → All Settings → Logon options. Select Enable.
- From the Logon options list, click Automatic logon only in Intranet zone, and then click OK.
Method 2: Manual configuration
Google Chrome:
- Navigate to Settings → Advanced drop-down → System module → Open proxy settings.
- Click the Security tab and select the Local intranet icon.
- Click the Sites button and proceed to enter the access URL of ADSelfService Plus in the required field, and click Add.
Internet Explorer:
- Navigate to Tools → Internet Options → Security.
- Click the Security tab and select the Local intranet icon.
- Click the Sites button and proceed to enter the access URL of ADSelfService Plus in the required field, and then click Add.
Mozilla Firefox:
- 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.
- Navigate to the network.automatic-ntlm-auth.trusted-uris preference.
- Double-click the preference and enter the access URL of ADSelfService Plus. For example: selfservice-5994:8888
- Click OK.