add troubleshooting info for public release

cseppan commented 1 year ago

Tomcat not running

error when starting up the EMF client "Connection refused"
http://localhost:8080/emf/services won't load

database issue

EMF client error: java.lang.ExceptionInInitializerError; sometimes the error is java.lang.NoClassDefFoundError: Could not initialize class gov.epa.emissions.framework.tasks.DebugLevels
http://localhost:8080/emf/services will load
no errors in catalina log

cseppan commented 1 year ago

Default location for Apache Tomcat logs: C:\Program Files\Apache Software Foundation\Tomcat 8.5\logs\

To check if the Tomcat service is running, start by opening the Services app (Start > search for “Services”). In the list of services, look for Apache Tomcat and double click the name to open the Tomcat properties window. Halfway down is a line labeled “Service status”. If the status is Stopped, click the Start button to start Tomcat. At that point, the Service status line should say “Running”.

cseppan commented 1 year ago

Screenshots to add for troubleshooting:

Services App services_app

Apache Tomcat Service apache_tomcat_service

PostgreSQL Service postgresql_service

pgAdmin with EMF database loaded pgadmin_emf_database

USEPA / emf

add troubleshooting info for public release #118