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)