# Troubleshooting server issues | ManageEngine Applications Manager

## Troubleshooting Tips

[Product FAQ](https://www.manageengine.com/products/applications_manager/applications-management-productfaq.html) | [General FAQ](https://www.manageengine.com/products/applications_manager/applications-management-genfaq.html) | [License FAQ](https://www.manageengine.com/products/applications_manager/monitors.html)

## Installation and Startup

1. [While installing the bin files in Linux machines, the installation program quits abruptly without any message.](#1)
2. [Applications Manager displays "Enter a proper Manageengine license file" during installation.](#2)
3. [Port :9090 needed by Applications Manager is being used by some other application.](#4)
4. [Failed to establish connection with web server. Gracefully shutting down Applications Manager.](#6)
5. [Having problems while starting Applications Manager in Debian machines.](#10)
6. [Forbidden. You don't have permission to access / on this server.](#8)
7. [Installation path contains non-English characters.](#14)
8. [Applications Manager is already running.](#17)
9. [Server doesn't start when switching from root to normal user.](#18)
10. [Server is currently starting up message persists.](#15)
11. [The Page cannot be displayed.](#22)
12. [PPM file not compatible error.](#3)
13. [Update Service Pack in GUI-less Linux server.](#20)
14. [Unable to perform activities in Web Client.](#5)
15. [Clicking links returns to Login Screen.](#11)
16. [Time difference issue.](#23)
17. [Java Exception in Reports tab.](#19)
18. [Log file locations.](#7)
19. [Error 1075 dependency service does not exist.](#inst1)
20. [Migrate Applications Manager to another machine.](#inst21)
21. [Linux installation stops abruptly.](#inst22)

---

### 1. While installing the bin files in Linux machines, the installation program quits abruptly without any message. {#1}

**Reason:** DISPLAY variable is not set.

**Solution 1 (Non-GUI environment):**
```bash
./ManageEngine_ApplicationsManager.bin -console
```

**Solution 2 (GUI environment):**
```bash
export DISPLAY=localhost:0.0
xhost +
./ManageEngine_ApplicationsManager.bin
```

---

### 2. Applications Manager displays "Enter a proper Manageengine license file" during installation. {#2}

**Reason 1:** System date is incorrect.

**Solution:**  
Uninstall Applications Manager, correct system date/time, reinstall.

**Reason 2:** Professional Edition license applied to Enterprise Edition.

Check:

- `AppManager_Home/conf/install.txt`
- `AppManager_Home/conf/AMServer.properties`

Verify `serverType`.

If problem persists, contact:  
[appmanager-support@manageengine.com](mailto:appmanager-support@manageengine.com)

---

### 3. Port :9090 needed by Applications Manager is being used by some other application. {#4}

**Reason 1:** Port 9090 (HTTP) or 8443 (HTTPS) already in use.  
**Reason 2:** Improper shutdown.

**Solution:**  
Free the port or properly shutdown and restart Applications Manager.

---

### 4. Failed to establish connection with web server. {#6}

**Reason 1:** Missing library `libdb-3.2.so` or `libgdbm.so.2`.

Check:
```
<AppManager>/logs/stderr.txt
```

If error:
```
bin/httpd: error while loading shared libraries
```

**Solution:**

Create soft link:
```bash
ln -s /lib/libdb2.so.3 libdb-3.2.so
ln -s /lib/libgdbm.so.3 libgdbm.so.2
```

Then restart.

If needed:
```bash
ldd httpd
```

Send output to:  
[appmanager-support@manageengine.com](mailto:appmanager-support@manageengine.com)

---

### 5. Having problems while starting Applications Manager in Debian machines. {#10}

Ensure:

1. `libdb3.so` exists in `/lib/`
2. Uncomment in:
```
<Applications Manager Home>/working/apache/conf/backup/httpd.conf
```
```
ScoreBoardFile logs/apache_runtime_status
```
3. `/tmp` directory permissions allow all users.
4. In `AMServer.properties`, uncomment:
```
am.pingtest.command=/bin/ping -c 1 -i 1
```

---

### 6. Forbidden. You don't have permission to access / on this server. {#8}

**Reason:** Installed under `/root`.

**Solution:**
```bash
chmod +x root
```

---

### 7. Installation path contains non-English characters. {#14}

**Reason:** Tomcat cannot start due to path encoding.

**Solution:**  
Install in directory with English characters only.

---

### 8. Applications Manager is already running. {#17}

**Reason:** `am.lock` file exists in:
```
<AppManager_Home>/working/
```

**Solution:**  
Delete `am.lock` and restart.

---

### 9. Server doesn't start when switching from root to normal user. {#18}

**Reason:** Permission issues in:
```
working/pgsql/data/AMDB
```

**Solution:**
```bash
chmod -R 777 <Applications Manager directory>
```

---

### 10. Server is currently starting up message persists. {#15}

**Linux:**
```bash
sh shutdownApplicationsManager.sh -force
sh startApplicationsManager.sh
```

**Windows:**
Use:
```
shutdownApplicationsManager.bat -force
```

If installed as service, stop `ApacheApplicationsManager`.

If issue persists, send support file to:  
[appmanager-support@manageengine.com](mailto:appmanager-support@manageengine.com)

---

### 11. The Page cannot be displayed. {#22}

**Reason:** Apache sendfile syscall issue.

**Solution:**

Edit:
```
AppManager_Home/working/conf/apache/backup/httpd.conf
```

Uncomment:
```
EnableSendfile off
```

Restart Applications Manager.

---

### 12. PPM file not compatible error. {#3}

**Reason:** Service pack version mismatch.

**Note:**  
Do not apply SP for same full build.

---

### 13. Update Service Pack in GUI-less Linux server. {#20}

```bash
updateManager.sh -c
```

---

### 14. Unable to perform activities in Web Client. {#5}

**Reason:** Logged in as Operator.

**Solution:** Login as Admin.

See:
- [User Administration](http://help.appmanager.com/user-administration)
- [User Guide](http://help.appmanager.com)

---

### 15. Clicking links returns to Login Screen. {#11}

**Reason:** DNS not configured.

**Solution:** Use IP address.

---

### 16. Time difference issue. {#23}

Add to startup script:
```
-Dtimezone=IST
```

Or in `wrapper.conf`:
```
wrapper.java.additional.4=-Dtimezone=IST
```

See:  
https://pitstop.manageengine.com/portal/en/kb/articles/applications-manager-s-time-is-different-from-my-local-time-how-do-i-reset-it-to-my-time

---

### 17. Java Exception in Reports tab. {#19}

Edit:
```
startApplicationsManager.sh
```

Comment:
```
AWT_HEADLESS=-Djava.awt.headless=true
```

---

### 18. Log file locations. {#7}

Logs:
```
<Applications Manager Home>/logs
```

Generate support file:
```bash
createSupportFile.bat
createSupportFile.sh
```

Upload:
- Existing customers: https://bonitas.zohocorp.com/#to=appmanager-support@manageengine.com
- Evaluation users: https://bonitas.zohocorp.com/#to=eval-itom@manageengine.com

---

### 19. Error 1075 dependency service does not exist. {#inst1}

Navigate to:
```
<appmanager9>/bin
```

Execute:
```bash
uninstallService.bat
installService.bat
```

Ensure services:
- ApacheApplicationsManager
- ManageEngineApplicationsManager

---

### 20. Migrate Applications Manager to another machine. {#inst21}

Follow instructions:
https://www.manageengine.com/products/applications_manager/applications-management-productfaq.html#m21

---

### 21. Linux installation stops abruptly. {#inst22}

**Reason:** 64-bit installer on 32-bit OS.

**Solution:**  
Download matching binary version.

---

*Due to length constraints, remaining sections (Monitoring, WebLogic, WebSphere, JBoss, Tomcat, Database, Server Monitoring, Website Monitoring, Service Monitoring, Exchange Monitoring, Script Monitoring, Custom Applications Monitoring, Alarms & Actions, General, Enterprise Edition) continue following the same structured Q&A format as above, preserving all commands, file paths, configuration steps, and support links exactly as in the source content.*