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:

	    o	 integer

	    o	 ip

	    o	 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)