ltm data-group external
ltm data-group external(1) BIG-IP TMSH Manual ltm data-group external(1)
NAME
external - Configures an external class.
MODULE
ltm data-group
SYNTAX
Configure the external data-group within the ltm data-group module
using the syntax shown in the following sections.
CREATE/MODIFY
create external [name]
modify external [name]
options:
app-service [[string] | none]
description [string]
external-file-name [ [file name] | none]
separator [string]
source-path [URL]
type [integer | ip | string ]
edit external [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
DISPLAY
list external
list external [ [ [name] | [glob] | [regex] ] ... ]
show [name] external-records
show running-config external
show running-config external [ [ [name] | [glob] | [regex] ] ... ]
options:
all-properties
non-default-properties
one-line
partition
DELETE
delete external [name]
DESCRIPTION
Data groups are lists of data that you define and use with iRules(r)
operators. External data group records are stored in external files
that you manage through the sys file data-group component. Note that
external data groups can be very large, which is one reason why the
groups are saved to external files. For example, a phone company may
store a list of thousands of phone numbers in an external data group.
You should consider using an internal data group when the number of
records is expected to be small.
An external data group acquires its type from the associated data-group
file, which can be a list of IP addresses, strings, or integers.
External data groups are lists that specify:
o A data-group file where records are stored
o A description of the class
There are two ways to configure the external data-group object:
o Create external data-group object, and then specify the source-
path and type of the external-file. In one step the external-file
will be created within the sys file data-group module and external
data-group within the ltm data-group module.
o Create an external-file within the sys file data-group module, and
then create external data-group within the ltm data-group module.
See help sys file data-group for information on creating the data-
group file.
EXAMPLES
create external ext-dg1 external-file-name string.dat description
"created for rule xyz"
Creates an external data group named ext-dg1, with the given
description. The records for the data group are loaded from the
data-group file string.dat previously created in the sys file
data-group component.
create external ext-dg1 description "created for rule xyz" source-path
http:/file-server/data-groups/ip.class type ip
Downloads the data-group file from the given URL into file-store
and creates a data-group file named ext-dg1 within the sys file
data-group module. Creates an external data group named ext-dg1,
with the given description. The records for the data group are
loaded from the data-group file ext-dg1.
create external ext-dg2 source-path file:/shared/save/Test.dat type
string
Creates a data-group file named ext-dg2 within the sys file data-
group module. Creates an external data group named ext-dg2. The
records for the data group are loaded from the data-group file
ext-dg2.
modify external ext-dg2 description "created for rule abc" source-path
file:/shared/save/Test2.dat
Downloads the file from the given URL into file-store and updates
the source-path of data-group file referenced by external data
group ext-dg2. Modifies the description of external data group
ext-dg2.
delete external ext-dg1
Deletes the external data group named ext-dg1. Note: the data-
group file referenced by ext-dg1 is not deleted at this time. If
needed, it should be deleted under sys file data-group component.
show external ext-dg1 external-records Shows a sorted list of external
data group records. Note: We recommend against displaying data-groups
of over two million records due to control-plane resource constraints.
OPTIONS
app-service
Specifies the name of the application service to which the data
group belongs. The default value is none. Note: If the strict-
updates option is enabled on the application service that owns the
object, you cannot modify or delete the data group. Only the
application service can modify or delete the data group.
description
User defined description.
external-file-name
Specifies the data-group file where the records are stored.
Note: Only source-path or external-file-name may be specified for
external data-group configuration item.
regex
Displays the items that match the regular expression. The regular
expression must be preceded by an at sign (@[regular expression])
to indicate that the identifier is a regular expression. See help
regex for a description of regular expression syntax.
separator
Specifies a separator to use when defining the data group. The
default value is :=.
source-path [URL]
This optional attribute takes a URL.
Note: Only source-path or external-file-name may be specified for
external data-group configuration item, for example:
source-path http://file-server/data-groups/AUL_1.cls
source-path https://file-server/data-groups/CNN.x
source-path
ftp://username:password@server/data-groups/latest.class
source-path file:/shared/save/Test.dat
type Specifies the kind of data in the group. This option is acquired
from the data group file. If the external data group is created
with external-file that was previously created within the sys file
data-group module, then type option cannot be modified. If the
external data group is created with source-path option, then type
should be specified. The value for type could be integer or ip or
string.
SEE ALSO
create, delete, edit, glob, list, modify, regex, 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-2012. All rights reserved.
BIG-IP 2016-08-04 ltm data-group external(1)