Script doco update

This commit is contained in:
WalkerWatch 2017-06-22 17:18:01 -04:00 committed by Joakim Erdfelt
parent 3aa42d989b
commit 4d2f66a252
1 changed files with 19 additions and 16 deletions

View File

@ -136,7 +136,7 @@ jetty-distribution-{VERSION}/
.... ....
It might seem strange or undesirable to unpack the first portion of the jetty-distribution directory name too. It might seem strange or undesirable to unpack the first portion of the jetty-distribution directory name too.
But starting with Jetty 9.1 the split between `${jetty.home}` and `${jetty.base}` allows for easier upgrades of Jetty itself while isolating your webapp specific configuration. But starting with Jetty 9 the split between `${jetty.home}` and `${jetty.base}` allows for easier upgrades of Jetty itself while isolating your webapp specific configuration.
For more information on the Jetty home and base concepts see the section on managing a Jetty installation <<startup-base-and-home, earlier in this Chapter.>> For more information on the Jetty home and base concepts see the section on managing a Jetty installation <<startup-base-and-home, earlier in this Chapter.>>
The `/opt/jetty/temp` directory is created as a durable place for Jetty to use for temp and working directories. The `/opt/jetty/temp` directory is created as a durable place for Jetty to use for temp and working directories.
@ -156,16 +156,17 @@ While this is still supported, we encourage you to setup a proper `${jetty.base}
# cd /opt/web/mybase/ # cd /opt/web/mybase/
[/opt/web/mybase]# ls [/opt/web/mybase]# ls
[/opt/web/mybase]# java -jar /opt/jetty/jetty-distribution-{VERSION}/start.jar \ [/opt/web/mybase]# java -jar /opt/jetty/jetty-distribution-{VERSION}/start.jar \
--add-to-start=deploy,http,logging --add-to-start=deploy,http,console-capture
WARNING: deploy initialised in ${jetty.base}/start.ini (appended) INFO : webapp transitively enabled, ini template available with --add-to-start=webapp
WARNING: deploy enabled in ${jetty.base}/start.ini INFO : server transitively enabled, ini template available with --add-to-start=server
WARNING: server initialised in ${jetty.base}/start.ini (appended) INFO : security transitively enabled
WARNING: server enabled in ${jetty.base}/start.ini INFO : servlet transitively enabled
WARNING: http initialised in ${jetty.base}/start.ini (appended) INFO : console-capture initialized in ${jetty.base}/start.ini
WARNING: http enabled in ${jetty.base}/start.ini INFO : http initialized in ${jetty.base}/start.ini
WARNING: server enabled in ${jetty.base}/start.ini INFO : deploy initialized in ${jetty.base}/start.ini
WARNING: logging initialised in ${jetty.base}/start.ini (appended) MKDIR : ${jetty.base}/logs
WARNING: logging enabled in ${jetty.base}/start.ini MKDIR : ${jetty.base}/webapps
INFO : Base directory was modified
[/opt/web/mybase]# ls -F [/opt/web/mybase]# ls -F
start.ini webapps/ start.ini webapps/
.... ....
@ -178,10 +179,12 @@ http::
This sets up a single Connector that listens for basic HTTP requests. This sets up a single Connector that listens for basic HTTP requests.
+ +
See the created `start.ini` for configuring this connector. See the created `start.ini` for configuring this connector.
logging:: console-capture::
When running Jetty as a service it is very important to have logging enabled. When running Jetty as a service it is very important to have logging enabled.
This module will enable the basic STDOUT and STDERR capture logging to the `/opt/web/mybase/logs/` directory. This module will enable the basic STDOUT and STDERR capture logging to the `/opt/web/mybase/logs/` directory.
Additionally, the `webapp`, `server`, `security` and `servlet` modules were enabled as they are dependencies for other modules.
See xref:start-jar[] for more details and options on setting up and configuring a `${jetty.base}` directory. See xref:start-jar[] for more details and options on setting up and configuring a `${jetty.base}` directory.
Copy your war file into place. Copy your war file into place.
@ -238,7 +241,7 @@ JAVA_OPTIONS = -Djetty.state=/opt/web/mybase/jetty.state
-Djetty.home=/opt/jetty/jetty-distribution-{VERSION} -Djetty.home=/opt/jetty/jetty-distribution-{VERSION}
-Djetty.base=/opt/web/mybase -Djetty.base=/opt/web/mybase
-Djava.io.tmpdir=/opt/jetty/temp -Djava.io.tmpdir=/opt/jetty/temp
JETTY_ARGS = jetty-logging.xml jetty-started.xml JETTY_ARGS = console-capture.xml jetty-started.xml
RUN_CMD = /usr/bin/java RUN_CMD = /usr/bin/java
-Djetty.state=/opt/web/mybase/jetty.state -Djetty.state=/opt/web/mybase/jetty.state
-Djetty.logs=/opt/web/mybase/logs -Djetty.logs=/opt/web/mybase/logs
@ -246,11 +249,11 @@ RUN_CMD = /usr/bin/java
-Djetty.base=/opt/web/mybase -Djetty.base=/opt/web/mybase
-Djava.io.tmpdir=/opt/jetty/temp -Djava.io.tmpdir=/opt/jetty/temp
-jar /opt/jetty/jetty-distribution-{VERSION}/start.jar -jar /opt/jetty/jetty-distribution-{VERSION}/start.jar
jetty-logging.xml console-capture.xml
jetty-started.xml jetty-started.xml
.... ....
You now have a configured `${jetty.base}` in `/opt/web/mybase` and a jetty-distribution in `/opt/jetty/jetty-distribution-{VERSION}`, along with the service level files necessary to start the service. You now have a configured `${jetty.base}` in `/opt/web/mybase` and a `${jetty.home}` in `/opt/jetty/jetty-distribution-{VERSION}`, along with the service level files necessary to start the service.
Test the service to make sure it starts up and runs successfully. Test the service to make sure it starts up and runs successfully.
@ -268,4 +271,4 @@ USER PID %CPU %MEM VSZ RSS TTY STAT START TIME COMMAND
jetty 2958 5.3 0.1 11179176 53984 ? Sl 12:46 0:00 /usr/bin/java -Djetty... jetty 2958 5.3 0.1 11179176 53984 ? Sl 12:46 0:00 /usr/bin/java -Djetty...
.... ....
You should now have your server running. Try it out You should now have your server running.