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)