User manual

set forwarding
Chapter 2 Command Descriptions 109
set forwarding
Devices
supported
This command is supported in Digi Cellular Family products only.
Purpose Configures IP routing, or forwarding of IP datagrams, between network
interfaces. IP routing must be enabled to allow the Network Address Table
(NAT) and port forwarding features to work properly.
The “set forwarding” command enables addition of static route entries to
the IP routing table. Static routes instruct the device to route packets for a
known destination host or network, to (through) a router or gateway
different from the default gateway. They explicitly define the next “hop” from
a router for a particular destination. This is sometimes necessary to
communicate with hosts on a different subnet than the Digi device, or to
provide a more direct or efficient route to such hosts than may be provided
by using the default gateway or other routes.
Required
privileges
For Digi Connect products with two or more users, to use this command,
permissions must be set to one of the following:
• For a user to display the forwarding settings:
“set permissions s-router=read”
• For a user to display and set forwarding settings:
“set permissions s-router=rw”
See "set permissions" on page 157 for details on setting user permissions
for commands.
Syntax Set IP forwarding settings
The first option, “ipforwarding,” enables or disables IP forwarding. The
remaining options pertain to static routes.
set forwarding [ipforwarding={on|off}]
[staticrouteindex={1-8}]
[action={add|change|delete}]
[enabled={on|off}]
[net=destination ip address]
[mask=subnet mask]
[gateway=ip address]
[metric={1-16}]
[interface=interface name]
The “staticrouteindex” and “action” options are required for all static route
management commands. To add a new static route entry, all eight of the
above static route options are required.
Note that this command cannot be used to add, change or delete a default
gateway entry: the default gateway is managed internally by the device.