edit
edit(1) BIG-IP TMSH Manual edit(1)
NAME
edit command - Opens the specified components in an editor.
MODULES
All tmsh modules.
SYNTAX
Use the command edit to create components or modify the configuration
of components using a text editor. To edit a component that resides in
another module, use the full path to the component.
edit [component] [name ... name | all]
edit / [module...module] [component] [name ... name | all]
DESCRIPTION
You can use the command edit to create or modify components in the
auth, cli, gtm, ltm, net, sys and wom modules, and iRules(r).
If you are assigned the role of Administrator, when you use the command
edit, the system starts the vi editor. If you are assigned any other
role, the system starts the pico/nano editor.
The system saves, in a temporary directory, the text file, named data,
that you are editing. When you save the file and close the editor, the
system checks for errors, and then prompts you with an opportunity to
continue editing and resolve any errors.
When you edit an existing component that can have associations, such as
a Global Traffic Manager wide IP that can have pool member
associations. but the component does not currently have associations,
to create the new associations, you must use the full command syntax in
the text file. For the full command syntax for each component, see the
associated man page.
When you edit a component that has associations with components that
are children of the component you are editing, the text file contains a
line for the configuration of the child components that begins with the
command modify, for example: pools modify { [existing pool members
configurations] }. In this case, if you want to add or delete pool
members, you must add additional lines to the text file, for example:
pools delete { [pool members to delete] }.
If you want the text file that opens to contain all of the editable
properties of the component that you want to edit, you must use the
all-properties option at the end of the edit command sequence;
otherwise, only the non-default properties display in the text file.
EXAMPLES
edit / gtm pool a*
From the root module, opens a file in an editor in which you can modify
the configuration of all Global Traffic Manager pools with names that
start with the letter a using the template that displays in the editor.
edit datacenter new_dc
From the gtm module, opens a file in an editor in which you can create
the Data Center named new_dc using the template that displays in the
editor.
edit datacenter a*
From the gtm module, opens a file in an editor in which you can edit
all existing datacenters with names that begin with the letter a.
edit datacenter new_datacenter existing_datacenter
From the gtm module, opens a file in an editor in which you can create
a new datacenter and edit an existing datacenter. Note that when the
file opens, a template displays that you can use to create a new
datacenter followed by the configuration of the existing datacenter.
edit rule rule_1
From the gtm module, opens a file in an editor in which you can create
an iRule named rule_1 using the template that displays in the editor.
When the editor opens, and you are creating or editing an iRule, you
must enclose the iRule syntax in brackets, for example, [ ...iRule...
]. Note that the template includes the brackets.
OPTIONS
all Specifies that you want to modify all of the existing components
of the specified type.
component
Specifies the type of component that you want to create or modify.
module
Specifies the module within which the component resides.
name Specifies a unique name of each component that you want to create
or modify.
SEE ALSO
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 2008-2010, 2012-2013. All rights
reserved.
BIG-IP 2013-03-22 edit(1)