host-label
Configures host label settings.
Syntax
[no] host-label <name> {hostname {<hostname> |'<hostname>, . . .>'} [subnet <X.X.X.X/XX> | 'subnet <X.X.X.X/XX>, . . .'] | subnet {<X.X.X.X/XX> |'subnet <X.X.X.X/XX>, . . .'} [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. • Host labels aren’t compatible with IPv6. |
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/XX> | 'subnet <X.X.X.X/XX>, . . .' | Specifies an IPv4 subnet for the specified host label or a comma-separated list of IPv4 subnets. Use the format X.X.X.X/XX. You must enclose comma-separated lists in single quotation marks ('). Only IPv4 subnets are allowed. |
Usage
Host labels are names given to lists of hosts (IPv4 subnets and 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 CX, SteelHead EX, SteelHead-v, SteelHead-c
Related Commands