Edge Documentation

This page identifies issues that you may encounter when running AppBoard/enPortal, and recommends possible solutions where applicable.

This page addresses troubleshooting issues on the AppBoard server. For any issues that take place in the web browser, see the page for AppBoard client troubleshooting.

Issues With Starting the AppBoard Server

• Issue: When executing the startup.bat or startup.sh command, AppBoard fails to start successfully and the URL does not return the AppBoard login page in the browser.
• Resolution: Review the following checklist to see if any of the items are preventing AppBoard from starting:
  • Validate that your server does not have applications already running on the port being used by AppBoard. For detailed instructions on troubleshooting this issue, see Port Conflict JVM Bind Error.
  • Check to see if there is a problem with the AppBoard license file.
    • Make sure there is a file called license.properties in [APPBOARD_HOME]/server/webapps/enportal/WEB-INF/config/license.properties.
    • Open the license.properties file and check the expiration date.
  • Look in the system log files and console output for errors. For more information about the log files, see Log Files.
  • In Windows, if you do not see any error messages in the console, or the console is closing before you can see anything, you can try to run Catalina directly instead of using the startup script. This will sometimes provide additional feedback in the console. To run Catalina directly, do the following:
    • Go to the command line in a console.
    • Navigate to [APPBOARD_HOME]/server/bin
    • Run the following command:

      >catalina.bat run

  • Check for other issues with Tomcat.

When starting AppBoard, always allow enough time for the Tomcat process to fully start up before accessing the login URL in a browser. This may take 1-2 minutes. When re-starting the system, always allow sufficient time for the system to stop before running the start command.

Memory Issues

• Issue: Your system is experiencing lags or performance issues
• Issue: You received the error message “Out of heap space”
• Resolution: Review the following checklist to see where performance can be improved:
  • Consider any latency that exists between the client and the AppBoard server. Run AppBoard in a browser on the server and evaluate whether it performs better than from other locations.
  • Allocate more memory to AppBoard. For more information on allocating additional memory, see Memory Configuration.

• Issue: You received one of the following error messages:

  "Error occurred during initialization of VM"

  "Could not reserve enough space for object heap"

  "Error: Could not create the Java Virtual Machine."

  "Error: A fatal excepion has occurred. Program will exit."

• Resolution: You may not have too much memory allocated to the Java VM for your operating system. For example, you will get this error if you use the default Java Virtual Machine maximum heap size (-Xmx1536m) when running on a 32-bit Windows system. Lower the maximum heap size to an amount that can be handled by the operating system (for example, -Xmx1024m). For more information on this setting, see Memory Configuration.

• Issue: You received the following error message:

  "Can't load AMD 64-bit .dll on a IA 32-bit platform"

• Resolution: You are running the 64-bit Tomcat executable on a 32-bit Windows system. For example, you will get this error if you use the default installation on a 32-bit system. Perform the following steps to fix this issue:
  1. Navigate to [APPBOARD_HOME]/server/bin/windows-x86
  2. Copy the 32-bit Tomcat files from the /windows-x86 folder up one level to the /bin folder:
     1. tcnative-1.dll
     2. tomcat7.exe

Viewing the Console Output

A helpful technique for troubleshooting Windows server issues in AppBoard is being able to save the console output to a file. This is helpful for the following scenarios:

• You want to examine the console output, but the console is closing down quickly when an error occurs
• You want to submit the console output to technical support for review

Perform the following steps to start up AppBoard and save the console output to a file:

1. Create a temporary folder, such as c:\tempdir
2. Go to the command line in a console.
3. Navigate to [APPBOARD_HOME]/server/bin
4. Run the following command:

   >catalina.bat run > c:\tempdir\consoleOutput.txt