---
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) |
