sys file data-group
sys file data-group(1) BIG-IP TMSH Manual sys file data-group(1)
NAME
data-group - Manages an external data group file.
MODULE
sys file
SYNTAX
Manage the data-group component within the sys file module using the syntax shown in the following sections.
CREATE/MODIFY
create data-group [name]
modify data-group [name]
options:
app-service [[string] | none]
data-group-description [string]
data-group-name [name]
separator [string]
source-path [URL]
type [integer | ip | string ]
edit data-group [ [ [name] | [glob] | [regex] ] ... ]
DISPLAY
list data-group
list data-group [ [ [name] | [glob] | [regex] ] ... ]
DELETE
delete data-group [name]
DESCRIPTION
You can use the data-group component to create, edit, delete, list or modify an external data group file.
EXAMPLES
create data-group new-dg source-path http:/file-server/data-groups/acl.class type string
Downloads the data-group file from the given URL into file-store, creates an external-data-group file named new-dg, and
saves the given URL in the source-path attribute.
create data-group new-dg source-path http:/file-server/data-groups/acl.class type string data-group-name dg data-group-
description "created for rule xyz"
Downloads the data-group file from the given URL into file-store, creates an external-data-group file named new-dg, saves
the given URL in the source-path attribute, and creates an external data group within the ltm data-group module named dg
with the given description.
create data-group new-dg source-path file:/shared/save/Test.cls type ip
Specifies the location of the file on the local disk (use this when the file has already been created on the local disk).
SUPPORTED URL FORMAT
Supported URL schemes are HTTP, HTTPS, FTP, FTPS, and FILE.
OPTIONS
app-service
Specifies the name of the application service to which the object 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
object. Only the application service can modify or delete the object.
checksum
Specifies a cryptographic hash or checksum of the file contents for use in verification of file integrity.
created-by
Specifies the user who originally created the file-object.
create-time
Specifies the time at which the file-object was created.
data-group-description
Specifies the description of the external data group that will be created within the ltm data-group module and
reference the given data group file. This is optional in the create command.
data-group-name
Specifies the name of the external data group that will be created within the ltm data-group module and reference the
given data group file. This is optional in the create command.
last-update-time
Specifies the last time at which the file-object was updated/modified.
mode Specifies the UNIX file permissions mode for the file associated with this file-object as a numerical value.
revision
The latest revision of the file. The revision starts with 1 and gets incremented on each update.
separator
Specifies a separator to use when defining the data group. The default value is :=.
size Specifies the size (in bytes) of the file associated with this file object.
source-path [URL]
This attribute takes a URL, 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 required by the create command.
Possible values for type are:
• integer
• ip
• string
updated-by
Specifies the user who last updated the file-object.
SEE ALSO
create, delete, edit, glob, list, ltm data-group external, 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 2008-2012. All rights reserved.
BIG-IP 2012-05-22 sys file data-group(1)