Skip to main content

Troubleshooting & Reference


Troubleshooting

SymptomLikely CauseFix
java -version shows wrong version or not foundJAVA_HOME or PATH not set correctlyRevisit Step 1, open a new terminal after changes
javac not foundJRE installed instead of JDKReinstall using the JDK download
mvn -version not foundmvn -version not foundRevisit Step 2
Maven build fails with dependency not foundsettings.xml not configured or wrong credentialsRevisit Step 3
Cannot connect to SQL Server from SSMSTCP/IP disabled or port 1433 blockedRevisit Steps 5.2 and 5.5
Application fails to connect to DB at runtimeWrong credentials in database.properties, or TCP/IP not enabledRevisit Steps 5.2 and 9
database.properties not found at runtimeFile placed in wrong directoryConfirm the file is at \src\main\resources\database.properties
Tomcat not found in NetBeansServer not registeredRevisit Step 10.3
NetBeans using wrong JDKJDK 8 not registered as a Java PlatformRevisit Step 10.2
Build succeeds but app doesn't startTomcat configuration issueCheck the NetBeans Output panel for the full stack trace

Reference Links

ResourceURL
Team Resources RepositoryLINK
Stock Project RepositoryLINK
Stock Database Release AssetsLINK
Gitea Maven RegistryLINK
database.properties TemplateLINK
settings.xml TemplateLINK