Configuration Mode Commands : SteelHead configuration commands : host-label
  
host-label
Configures host label settings.
Syntax
[no] host-label <label-name> {hostname {<hostname> | '<hostname>, . . .'} [subnet {<X.X.X.X/0-32> | <X:X:X::X/0-128>} | 'subnet {<X.X.X.X/0-32> | <X:X:X::X/0-128>} . . .'] | subnet {<X.X.X.X/0-32> | <X:X:X::X/0-128>} | 'subnet {<X.X.X.X/0-32> | <X:X:X::X/0-128>, . . .'} [hostname {<hostname> |'<hostname>, . . .']}
Parameters
<name>
Name of the host label.
• Host labels are case sensitive and can be any string consisting of letters, numbers, the underscore ( _ ), or the hyphen ( - ). There can’t be spaces in host labels. There is no limit on the number of host labels you can configure.
• Entries in a host label can be an IP address, a subnet, or an FQDN (fully qualified domain name).
• To avoid confusion, don’t use a number for a host label.
• Host labels that are used in QoS or in-path rules cannot be deleted.
• Host label changes (that is, adding and removing hostnames inside a label) are applied immediately by the rules that use the host labels that you have modified.
• In RiOS versions 9.16.0 and later host labels are compatible with IPv4 and IPv6.
• RiOS versions 9.2.1 and later include a predefined host label, _cloud-accel-saas_, that detects any IP addresses that carry Cloud Accelerator-enabled SaaS traffic automatically. As SaaS applications are added or deleted, the host label is automatically updated with the list of associated IP addresses. This host label mitigates the requirement that domain rules and cloud acceleration be mutually exclusive. You can use this host label in the in-path  rule auto-discover command.
hostname <hostname> |'<hostname>, . . .>'
Specifies a hostname or a comma-separated list of hostnames for this label. You must enclose comma-separated lists in single quotation marks (').
• Hostnames are case insensitive.
• You can use up to 100 unique hostnames. A hostname can appear in multiple host labels.
• A host label can contain up to 64 subnets and hostnames.
subnet {<X.X.X.X/0-32> | <X:X:X::X/0-128>} | 'subnet {<X.X.X.X/0-32> | <X:X:X::X/0-128>} . . .'
Specifies a subnet for the specified host label or a comma-separated list of subnets. IPv6 and IPv4 subnets are allowed. Use the format X.X.X.X/0-32 for IPv4 or X:X:X::X/0-128 for IPv6 addresses. You must enclose comma-separated lists in single quotation marks (').
Usage
Host labels are names given to lists of hosts (subnets and/or hostnames) that you can specify to streamline configuration when configuring QoS or in-path rules. For example, you can specify host labels to define a set of hosts for which QoS classification and QoS marking rules apply. You can configure a mixture of subnets and hostnames for each label. A maximum of 64 subnets and hostnames per host label is allowed. You can configure a maximum of 100 unique hostnames across all host labels.
Host labels are compatible with auto-discover, passthrough, and fixed target in-path rules. A host label allows one in-path rule to match many destination subnets or hostnames.
Hostnames referenced in a host label are automatically resolved through a DNS query. The system resolves them immediately after you add a new host label or after you edit an existing host label. The system also resolves hostnames automatically, once daily. If you want to resolve a hostname immediately, use the resolve host-labels command.
You can control the refresh period for DNS queries for hostnames using the host-labels refresh-intvl command.
Example
amnesiac (config) # host-label rvbd hostname www.riverbed.com
amnesiac (config) # in-path rule auto-discover dst-host rvbd
Product
SteelHead Interceptor, SteelHead, SteelHead-v, SteelHead-c, Client Accelerator
Related Commands
“In-path and virtual in-path support commands,” “host-labels refresh-intvl,” “resolve host-labels,” show host-label