cli transaction
cli transaction(1) BIG-IP TMSH Manual cli transaction(1)
NAME
transaction - Opens batch mode within which you can submit a set of commands as a single transaction.
MODULE
cli
SYNTAX
Use the transaction component within the cli module to open batch mode, enter a series of commands, and then submit the
commands as a single transaction.
CREATE/MODIFY
create transaction
modify transaction
options:
delete [entry_id]
submit transaction [validate-only]
DISPLAY
list transaction
DELETE
delete transaction
DESCRIPTION
tmsh parses each command that you enter in batch mode. If the command passes a syntax check, tmsh saves it as part of the
transaction you are creating and returns a confirmation. After you finish adding commands, you submit the transaction to
change the running configuration of the system. You must run the save config command to save the changes to the stored
configuration files.
If, while creating a transaction, you decide you do not want to change the running configuration, you can delete the
transaction rather than submit it. However, you can recreate a transaction that you have deleted by using the cli history
component.
There are a few commands that you can enter on the command line that the system immediately runs, rather than adding the
commands to a transaction. These commands are list and show. Additionally, tmsh immediately runs the command sequence run
bigpipe, but does not add it to the transaction.
EXAMPLES
The following example shows the commands that you enter from within the ltm module to create and submit a transaction that
creates a Local Traffic Manager pool and virtual server, and then associates the two.
1. Open tmsh batch mode:
create /cli transaction
2. Add a command to the transaction that creates pool1 for the Local Traffic Manager using the default values for a pool:
create pool pool1
3. Add a command to the transaction that creates the virtual server virtual1 for the Local Traffic Manager using the
default values for a virtual server, and associates it with pool1.
create virtual virtual1 pool pool1
4. Display, in a numbered list, the current set of commands in the transaction:
list /cli transaction
Note: You can use the preceding command to determine the entry ID of a command. Then, you can use this ID to remove or
replace a command in the transaction, or to identify a command before which you want to insert another command.
5. Submit the transaction:
submit /cli transaction
OPTIONS
command
Specifies, in quotation marks, the full path to a command to add to or delete from the transaction that you are
creating. You can also replace an existing command with another command or insert a command before a command in the
transaction.
create
Opens batch mode.
delete
Deletes the transaction that you are creating and closes batch mode.
list Displays, in a numbered list, the current set of commands in the transaction that you are creating.
modify
Specifies a previously entered line in the transaction that you want to change. The options are:
delete
Deletes the specified entries from the transaction that you are creating.
entry_id
Specifies the number of a command in the list of commands in the transaction that you want to delete.
submit [validate-only]
Submits the transaction that you are entering and closes batch mode. The transaction is submitted in the context of
the cli admin-partitions settings that are active when the submit command is issued.
validate-only
Validates the configuration changes without putting them in production.
SEE ALSO
cli admin-partitions, create, delete, list, modify, submit, tmsh
COPYRIGHT
No part of this program may be reproduced or transmitted in any form or by any means, electronic or mechanical, including
photocopying, recording, or information storage and retrieval systems, for any purpose other than the purchaser's personal
use, without the express written permission of F5 Networks, Inc.
F5 Networks and BIG-IP (c) Copyright 2009-2013, 2015. All rights reserved.
BIG-IP 2015-06-01 cli transaction(1)