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)