Script doco update
This commit is contained in:
parent
3aa42d989b
commit
4d2f66a252
|
@ -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.
|
||||||
|
|
Loading…
Reference in New Issue