Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
docs:1100_inst_guide:0600_troubleshooting [2022/08/21 12:09] – removed - external edit (Unknown date) 127.0.0.1docs:1100_inst_guide:0600_troubleshooting [2025/06/12 03:58] (current) – Change to AwareIM aware_support3
Line 1: Line 1:
 +{{tag>Manuals Installation_Guide}}
 +[<10>]
 +====== 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 <[email protected]> | 
 +^ 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''‎ processes‎in‎ 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 <[email protected]>|
 +^ Configuration Tool does not start | The settings for the Configuration Tool are specified in the file ''AwareIM/ConfigTool/eclipse/ConfigTool.ini''\\  Make 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|