User guide

set host
124 Chapter 2 Command Descriptions
set host
Device support This command is supported in all devices.
Purpose Configures or displays the host table, containing host name-to-IP address
mappings. The Digi device’s IP component can use the host table and a
DNS server to map host names to IP addresses. These mappings allow
users to identify hosts by user-friendly names, instead of IP addresses.
Using the host table is a convenience only. If you do not configure the host
table or DNS, users identify hosts by IP addresses. If the Digi device can
access a DNS server, there is no reason to configure the host table. The
PortServer TS 8/16 host table can hold up to 64 entries. The host table for
other devices can hold up to 20 entries.
You can configure either of the following:
• A host table and DNS, where the Digi device attempts to satisfy a
request by first searching the host table and then the DNS server.
• Either the host table or DNS.
Required
permissions
The root user can configure host table entries. Normal users can display
host table entries.
Syntax Configure host table
set host ip=ip addr name=host name range=index#-index#
Display host table entries
set host
Options ip=ip addr
The IP address to map to the name specified on the “name” option.
name=host name
The name to map to the IP address specified on the “ip” option.
range=index#-index#
One or a range of index numbers that identify entries in the host table.
Examples Display the entire host table
#> set host
Display an entry in the host table
#> set host range=1
Configure a name-to-IP address mapping
#> set host ip=190.150.150.10 name=server1
See also • "remove" on page 77 to remove entries from the host table.
• "revert" on page 79. The “revert host” option reverts the “set host”
configuration.
• "set config" on page 97 for configuring a Digi device to use a DNS
server.