Skip to content

Commit 21faf17

Browse files
committed
Update troubleshooting.md
1 parent edd7a03 commit 21faf17

File tree

1 file changed

+7
-5
lines changed

1 file changed

+7
-5
lines changed

docs/recipes/troubleshooting.md

+7-5
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@
2121

2222
This guide is about how to troubleshoot problems with Lucee, including crashes, startup problems etc.
2323

24-
Alas this guide isn't about why the code you are writing isn't working!
24+
Sadly, this guide isn't about why the code you're writing isn't working!
2525

2626
## Logs
2727

@@ -33,11 +33,11 @@ Your Servlet Egine will have it's own logging, as Lucee is distributed with Tomc
3333

3434
Under your Lucee install directory, there will be a `tomcat` folder, inside this folder is a `logs` directory.
3535

36-
The main log file for tomcat is called `catalina-{date}-.log` and this log will contain the startup logs and shutdown logs, plus any exceptions along the way from the Servlet engine.
36+
The main log file for tomcat is called `catalina-{date}-.log` and this log will contain the startup logs and shutdown logs, plus any exceptions along the way from the Servlet engine.
3737

3838
### Lucee Server
3939

40-
Lucee is a Servlet and deploys itself into a directory called `lucee-server`.
40+
Lucee is a Servlet which runs on a Servlet Engine, it deploys itself into a directory called `lucee-server`.
4141

4242
Under this directory is a `context/logs` directory, which contains all the Lucee log file in a default configuration.
4343

@@ -58,13 +58,13 @@ One the initial statup and deployment has got far enough along to haved loaded c
5858

5959
#### Starting Tomcat manually and redirecting logs to console.
6060

61-
A useful technique when debuggin a Lucee Server is start Tomcat manually, in a Terminal, as opposed to auto starting or running as service/dameon.
61+
The best first step when debugging a Lucee Server is start Tomcat manually, in a Terminal, as opposed to auto starting or running as service/dameon.
6262

6363
In the `tomcat/bin` directory, there's a bash/batch file called `catalina.sh` or `catalina.bat` which can be run with the run option, i.e `./cataline.sh run` or `catalina run`
6464

6565
By default, this will show all the `catalina.log` information in the console.
6666

67-
Since Lucee 6.2, you can also redirect all the logging to the console.
67+
Since Lucee 6.2, you can also redirect all the log4j logging to the console. (TODO out.log and err.log!)
6868

6969
On Windows
7070

@@ -93,6 +93,8 @@ Please first check whatever search engine or LLM, you prefer and/or search the [
9393

9494
If you can't find a solution to your problem, please post to the dev forum first and include all the relevant details
9595

96+
Ask youself, if you were assiting someone else with your problem, what questions would you ask when you read your support request before you press send.
97+
9698
- Lucee version, i.e. 6.2.1.188
9799
- Servlet engine, i.e. Tomcat
98100
- Operating system: i.e, Ubuntu 24

0 commit comments

Comments
 (0)