Skip to main content
A newer release of this product is available.

vserver services name-service netgroup load

Contributors
Suggest changes

Load netgroup definitions from a URI

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver services name-service netgroup load command loads netgroup definitions from a uniform resource identifier (URI) to a specified Vserver. You can load from a netgroup file at an FTP or a HTTP location (source URI) using the respective protocol.

Before Data ONTAP saves the new netgroup definitions, it checks that the netgroup file does not have any file structure issues, does not contain any syntax errors, and all entries comply with the following rules:

  • A domain name consists of one or more labels separated by periods (.).

  • A hostname is a valid domain name, IPv4 address, or IPv6 address.

  • Valid characters for a label are all alphanumeric characters, underscore (_), and dash (-). A label may not begin or end with a dash.

  • Valid characters for a username are all ASCII printable characters with the exception of whitespace, parentheses, and comma (,).

  • Valid characters for a netgroup name are all alphanumeric characters, underscore (_), and dash (-). A netgroup name may not begin with a dash.

  • A single line in the netgroup file may not exceed 4096 characters.

If the file is found to contain errors, Data ONTAP will issue an error to that effect and netgroup definitions will not be loaded into the specified Vserver. After correcting the error, reload the netgroup file into the specified Vserver.

Parameters

-vserver <vserver name> - Vserver

This parameter specifies the Vserver for which you want to load netgroup definitions.

-source {(ftp|http)://(hostname|IPv4 Address|'['IPv6 Address']')…​} - URI to Load from

This parameter specifies the source URI from which you want to load netgroup definitions. You can load from a URI either using the FTP or the HTTP protocol.

[-foreground {true|false}] - Load Netgroup in the Foreground

This parameter specifies whether the operation runs in the foreground. The default setting is true (the operation runs in foreground). When set to true, the command does not return until the operation completes.

[-skip-hostname-validation <true>] - Skip Hostname Validation (privilege: advanced)

If this parameter is specified, the hostname validation is skipped.

[-skip-file-size-check <true>] - Skip File Size Check Before Download (privilege: advanced)

If this parameter is specified, the file is downloaded without checking the file size. Use this parameter if the server does not supply the file size or does not provide an accurate value. This parameter can also be used to download a file greater than the default 5 MB size limit.

Note If this parameter is specified and the file is very large, the transfer may take a long time or fail due to disk space limitations.
[-skip-file-duplicate-check <true>] - Skip Netgroup File Duplicate Check (privilege: advanced)

If this parameter is specified, the netgroup file is downloaded even if the contents are same as the existing netgroup file. In this case, the existing file will be replaced.

Examples

The following example loads netgroup definitions into a Vserver named vs1 from the file netgroup1 at FTP location ftp://ftp.example.com:

cluster1::> vserver services name-service netgroup load -vserver vs1 -source ftp://ftp.example.com/netgroup1