37 lines
3.5 KiB
Markdown
37 lines
3.5 KiB
Markdown
---
|
|
sidebar_position: 7
|
|
title: "Troubleshooting & Reference"
|
|
---
|
|
|
|
# Troubleshooting & Reference
|
|
|
|
---
|
|
|
|
# Troubleshooting
|
|
|
|
| **Symptom** | **Likely Cause** | **Fix** |
|
|
| ------------------------------------------------ | ----------------------------------------------------------------- | ---------------------------------------------------------------- |
|
|
| `java -version` shows wrong version or not found | `JAVA_HOME` or `PATH` not set correctly | Revisit Step 1, open a **new** terminal after changes |
|
|
| `javac` not found | JRE installed instead of JDK | Reinstall using the JDK download |
|
|
| `mvn -version` not found | `mvn -version` not found | Revisit Step 2 |
|
|
| Maven build fails with dependency not found | `settings.xml` not configured or wrong credentials | Revisit Step 3 |
|
|
| Cannot connect to SQL Server from SSMS | TCP/IP disabled or port 1433 blocked | Revisit Steps 5.2 and 5.5 |
|
|
| Application fails to connect to DB at runtime | Wrong credentials in `database.properties`, or TCP/IP not enabled | Revisit Steps 5.2 and 9 |
|
|
| `database.properties` not found at runtime | File placed in wrong directory | Confirm the file is at `\src\main\resources\database.properties` |
|
|
| Tomcat not found in NetBeans | Server not registered | Revisit Step 10.3 |
|
|
| NetBeans using wrong JDK | JDK 8 not registered as a Java Platform | Revisit Step 10.2 |
|
|
| Build succeeds but app doesn't start | Tomcat configuration issue | Check the NetBeans Output panel for the full stack trace |
|
|
|
|
---
|
|
|
|
# Reference Links
|
|
|
|
| **Resource** | **URL** |
|
|
| ------------------------------ | ------------------------------------------------------------------------------------------------------------- |
|
|
| Team Resources Repository | [LINK](http://145.239.66.197:3000/othmane/team-resources) |
|
|
| Stock Project Repository | [LINK](http://145.239.66.197:3000/TrizTech/TrizStockRepository) |
|
|
| Stock Database Release Assets | [LINK](http://145.239.66.197:3000/othmane/team-resources/releases/tag/life_07-04-2026) |
|
|
| Gitea Maven Registry | [LINK](http://145.239.66.197:3000/othmane/-/packages/) |
|
|
| `database.properties` Template | [LINK](http://145.239.66.197:3000/othmane/team-resources/src/branch/main/uses/stock/database.properties) |
|
|
| `settings.xml` Template | [LINK](http://145.239.66.197:3000/othmane/team-resources/src/branch/main/_global/maven/settings.xml.template) |
|