WildFly CLI Scripting: Difference between revisions
(18 intermediate revisions by the same user not shown) | |||
Line 2: | Line 2: | ||
* [[WildFly CLI Operations#Subjects|CLI Operations]] | * [[WildFly CLI Operations#Subjects|CLI Operations]] | ||
=Overview= | |||
This article describes various aspects of using CLI as a command-line execution tool - as opposite to an interactive session tool. | |||
=Connection to a Host Controller= | =Connection to a Host Controller= | ||
Line 31: | Line 35: | ||
=Executing Multiple Commands Specified on Command Line= | =Executing Multiple Commands Specified on Command Line= | ||
In order to execute multiple | In order to execute multiple commands (individual commands are assumed not to contain spaces), specify them in a comma separated list at the end of the argument list. ''Spaces are not allowed''. The <tt>--commands</tt> argument optionally precedes it. | ||
After | After the last command in the sequence is executed, the CLI will terminate the session. | ||
Example: | Example: | ||
<pre> | <pre> | ||
jboss-cli.sh -c [-- | jboss-cli.sh -c [--commands=]ls,pwd | ||
</pre> | </pre> | ||
Line 44: | Line 48: | ||
<pre> | <pre> | ||
jboss-cli.sh -c [-- | jboss-cli.sh -c [--commands=]ls,'deploy ./test.war --server-groups=web-frontend' | ||
</pre> | </pre> | ||
Line 67: | Line 57: | ||
</pre> | </pre> | ||
where <tt>/commands.cli</tt> | where <tt>/commands.cli</tt> may contain multiple commands, one per line. Individual commands may contain spaces. Example: | ||
<pre> | <pre> | ||
deploy | pwd | ||
ls | |||
deploy servlet-example.war --force | |||
</pre> | </pre> | ||
= | =Sending Commands into <tt>jboss-cli.sh</tt>'s <tt>stdin</tt>= | ||
< | |||
</ | |||
<tt> | |||
<pre> | <pre> | ||
#!/bin/bash | #!/bin/bash | ||
jboss-cli.sh -c <<EOF | |||
# | |||
# comments are permitted; they should be prefixed by '#' | |||
< | # | ||
batch | batch | ||
#deploy target/playground.war --server-groups=main-server-group | #deploy target/playground.war --server-groups=main-server-group | ||
deploy target/playground.war --force | deploy target/playground.war --force | ||
run-batch | run-batch | ||
EOF | |||
</pre> | </pre> | ||
== | ==Examples== | ||
<blockquote style="background-color: AliceBlue; border: solid thin LightSteelBlue;"> | |||
:https://github.com/NovaOrdis/playground/tree/master/jboss/cli/bash-script-examples<br> | |||
</blockquote> | |||
=Using Variables= | |||
<font color=red>TODO: | |||
* JBoss EAP 6 : using variables in CLI scripts (jboss-cli.sh) https://access.redhat.com/solutions/321513 | * JBoss EAP 6 : using variables in CLI scripts (jboss-cli.sh) https://access.redhat.com/solutions/321513 | ||
Also see [[#Sending_Commands_into_jboss-cli.sh.27s_stdin|Sending Commands into <tt>jboss-cli.sh</tt>'s <tt>stdin</tt>]] above. | |||
I've seen this example, how does it work, how is Host1_Name defined? | I've seen this example, how does it work, how is Host1_Name defined? | ||
Line 151: | Line 103: | ||
</font> | </font> | ||
=<tt>batch</tt>/<tt>run-batch</tt>= | |||
<blockquote style="background-color: #f9f9f9; border: solid thin lightgrey;"> | |||
:[[WildFly_CLI_Concepts#Batch|WildFly CLI Concepts - Batch]] | |||
</blockquote> |
Latest revision as of 14:48, 27 March 2017
Internal
Overview
This article describes various aspects of using CLI as a command-line execution tool - as opposite to an interactive session tool.
Connection to a Host Controller
In order to be able to interact with a host controller, CLI must be connected. For options on how to connect see:
Executing a Single Command
Any word or phrase without white spaces in it is assumed to be a command. The --command argument optionally precedes it.
After a command is executed, the CLI will terminate the session.
Example:
jboss-cli.sh -c [--command=]ls
If a command requires space-separated arguments, command and the arguments should be enclosed is single quotes:
jboss-cli.sh -c [--command=]'deploy ./test.war --server-groups=web-frontend'
Executing Multiple Commands Specified on Command Line
In order to execute multiple commands (individual commands are assumed not to contain spaces), specify them in a comma separated list at the end of the argument list. Spaces are not allowed. The --commands argument optionally precedes it.
After the last command in the sequence is executed, the CLI will terminate the session.
Example:
jboss-cli.sh -c [--commands=]ls,pwd
If a command requires space-separated arguments, command and the arguments should be enclosed is single quotes:
jboss-cli.sh -c [--commands=]ls,'deploy ./test.war --server-groups=web-frontend'
Executing a Sequence of Commands Listed in a File
jboss-cli.sh -c --file=./commands.cli
where /commands.cli may contain multiple commands, one per line. Individual commands may contain spaces. Example:
pwd ls deploy servlet-example.war --force
Sending Commands into jboss-cli.sh's stdin
#!/bin/bash jboss-cli.sh -c <<EOF # # comments are permitted; they should be prefixed by '#' # batch #deploy target/playground.war --server-groups=main-server-group deploy target/playground.war --force run-batch EOF
Examples
Using Variables
TODO:
- JBoss EAP 6 : using variables in CLI scripts (jboss-cli.sh) https://access.redhat.com/solutions/321513
Also see Sending Commands into jboss-cli.sh's stdin above.
I've seen this example, how does it work, how is Host1_Name defined?
/host=$Host1_Name:write-local-domain-controller reload --host=$Host1_Name