Usage.adoc

Launcher

Usage

java -jar launcher-<version>.jar
    [--config-file file-path]
    [--contextroot context-root]
    [--http-listener port-number]
    [--https-listener port-number]
    [--libraries jar-filepath[,jar-filepath]*]
    [--precompilejsp[=true|=false]]
    --deploy war-file
    [--generate uber-jar-filepath]

java -jar launcher-<version>.jar
    [--config-file file-path]
    --execute subcommand
    subcommand-args...

Options

Name	Description	Default Value
--config-file	Specify the path to configuration file (domain.xml). Do not use --http-listener or --https-listener when using this option.
--contextroot	Specify the context-root.	/
--deploy	Specify the path to WAR file to deploy. This option is mandatory.
--execute	Specify the subcommand to execute.
--generate	Specify the path to uber JAR to generate. When this option is not specified, the application will run automatically.
--http-listener	Specify HTTP port number. Do not use --config-file when using this option.	8080
--https-listener	Specify HTTPS port number. Do not use --config-file when using this option.	8181
--libraries	Specify the paths to JAR files referred from the application. To specify more than one files, use comma (,) as a separator. Files specified in this option will not be included in the generated uber JAR.
--precompilejsp	Specify true to enable JSP precompilation; false to disable.	false

Operands

Name	Description
subcommand-args	Specify options and operands for the subcommand.

Examples

• Example 1: Run an application my-app.war without creating an uber JAR.

$ java -jar launcher-<version>.jar --deploy my-app.war

• Example 2: Create an uber JAR my-uber.jar and run it.

$ java -jar launcher-<version>.jar --deploy my-app.war --generate my-uber.jar
$ java -jar my-uber.jar

• Example 3: Execute the create-file-user subcommand.

$ java -jar launcher-<version>.jar --config-file domain.xml --execute create-file-user --passwordfile password.txt user1