Troubleshooting
The table below lists possible problems you may encounter during installation and the suggested solutions.
| Problem | Possible solution |
|---|---|
| AwareIM does not start and displays a message that it cannot create or locate the databases it requires. | 1. If running with a separate database such as MySQL or SQL Server, make sure that the database software is running and there is a valid connection with the database server 2. Make sure that the database settings in the BASServer.props file are correct – see section 1.4 3. If running MySQL – check the output of the AwareIM server. If it contains a message that connections from localhost (or 127.0.0.1) are not allowed, make sure that your MySQL account allows connections from localhost – see MySQL manual for details. 4. Send the logs files located in the AwareIM/STARTUP_LOGS directory to support@awareim.com |
| AwareIM does not start and displays a message that access to the database is denied. | 1. If running with a separate database such as MySQL or SQL Server, make sure that you specify the correct credentials of your database account. |
| AwareIM does not start and displays a message that port 9000 is not available or that another instance of AwareIM is running. | 1. You may have made an unsuccessful attempt to start AwareIM and the previous instance did not shut down properly. Kill all java and javaw processesin memory and re-start AwareIM. This is the most likely reason.2. Port 9000 required by AwareIM is used by some other application. Check availability of your ports and shut down the application using port 9000. Alternatively specify a different port in the BASServer.props file located in the BIN directory of your AwareIM installation (search for 9000 and replace it with an available port number). |
| Tomcat server does not start. | 1. Check that you are not already running an instance of Tomcat server. It is possible that you have made an unsuccessful attempt to run AwareIM and the previous instance did not shut down properly. Kill all java and javaw processes and re-start AwareIM 2. Check output of Tomcat server. If it contains a message “Port already in use” then one or more of the ports required by Tomcat are used by other applications or blocked by firewalls. Make sure that the following ports are available and not blocked: 8080 3. Send the logs files located in the AwareIM/STARTUP_LOGS directory to support@awareim.com |
| Configuration Tool does not start | The settings for the Configuration Tool are specified in the file AwareIM/ConfigTool/eclipse/ConfigTool.iniMake sure the –vm section in this file points to the correct java version |
| AwareIM Control Panel starts successfully but an attempt to run a login screen in the browser fails | 1. This is most likely because port 8080 is blocked by firewalls or used by some other application. Turn off firewalls or re-configure AwareIM to use a different port |