3.5.6. Use the Management CLI in Batch Mode
Batch processing allows a number of operation requests to be grouped in a sequence and executed together as a unit. If any of the operation requests in the sequence fail, the entire group of operations is rolled back.
Procedure 3.8. Batch Mode Commands and Operations
Enter batch modeEnter batch mode with the
[standalone@localhost:9999 /] batch [standalone@localhost:9999 / #]Batch mode is indicated by the hash symbol (
#) in the prompt.
Add operation requests to the batchOnce in batch mode, enter operation requests as normal. The operation requests are added to the batch in the order they are entered.Refer to Section 3.5.8, “Use Operations and Commands in the Management CLI” for details on formatting operation requests.
Run the batchOnce the entire sequence of operation requests is entered, run the batch with the
[standalone@localhost:9999 / #] run-batch The batch executed successfully.Refer to Section 3.5.7, “CLI Batch Mode Commands” for a full list of commands available for working with batches.
Batch commands stored in external filesFrequently run batch commands can be stored in an external text file and can either be loaded by passing the full path to the file as an argument to the
batchcommand or executed directly by being an argument to the
run-batchcommand.You can create a batch command file using a text editor. Each command must be on a line by itself and the CLI should be able to access it.The following command will load a
myscript.txtfile in the batch mode. All commands in this file will now be accessible to be edited or removed. New commands can be inserted. Changes made in this batch session do not persist to the
[standalone@localhost:9999 /] batch --file=myscript.txtThe following will instantly run the batch commands stored in the file
[standalone@localhost:9999 /] run-batch --file=myscript.txt
The entered sequence of operation requests is completed as a batch.