### set altip

Use the set altip command to

- Configure a serial port or group of serial ports with an IP address

- Display current entries in the altip table

- Remove an entry from the altip table

Digi device/terminal server products use alternate IP addresses to route outbound calls to the correct serial port or group of ports. By associating ports with IP addresses, telnet users on the LAN can use IP addresses, rather than port numbers, to specify a port or range of ports in their telnet calls. An alternate IP address may be specified for each physical serial port on the device/terminal server.

Normal users can use the set altip command to view altip table entries. Root privileges are required to configure and remove altip table entries.

#### Command Syntax

##### Configuration Syntax

Enter the set altip command as shown below to configure altip entries:

`set altip group={port# | group#} ip=ip_addr [save={on|off}]`

##### Display Entry Syntax

Enter the set altip command as shown below to display entries in the altip table:

`set altip [range=range]`

##### Remove Entry Syntax: PortServer TS 8/16

Enter the set altip command as shown below to remove entries from the altip table.

`set altip {rmaltip=on range=range} | {rmaltip=ip_addr}`

##### Remove Entry Syntax: Digi One RealPort, PortServer TS 2/4

Enter the set altip command as shown below to remove entries from the altip table.

`set altip {rm ip=ip_addr} | {rm range=range}`

#### Command Fields

Command Field | Description
group | Specifies a port or group of ports.
ip | Assigns an IP address to the ports or group of ports (hunt group) specified on the group field.
range | Specifies a range of index entries in the altip table.
rmaltip=on | Remove alternate IP addresses specified in range. This option is not supported on Digi One RealPort or PortServer TS 2/4.
rmaltip=ip_addr | Remove specified alternate IP address. This option is not supported on Digi One RealPort or PortServer TS 2/4.
rm | Remove the alternate IP address specified by the ip= term. This option is not supported on PortServer TS 8/16.
rm | Remove the alternate IP addresses specified by the range= term. This option is not supported on PortServer TS 8/16.
save | on - save changes to non-volatile memory. off - do not save changes-- changes will be discarded when the PortServer is rebooted. This option is not supported on PortServer TS 8/16.

#### Command Examples

##### Displaying the Altip Table

In this example, the set altip command displays the entire altip table.

`set altip`

##### Displaying Several Entries

In this example, the set altip command displays altip table entries 1 through 7.

`set altip range=1-7`

##### Configuring an Entry

In this example, the first set altip command configures an alternate IP address for the ports in hunt-group 65. The second set altip command configures an alternate IP address for port 3.

`set altip ip=198.150.150.10 group=65
set altip ip=198.150.150.11 group=3`

##### Removing an IP Address from the Altip Table: PortServer TS 8/16

In this example, the set altip command removes the specified IP address from the altip table.

`set altip rmaltip=198.150.150.10`

##### Removing an IP Address from the Altip Table: Digi One RealPort, PortServer TS 2/4

In this example, the set altip command removes the specified IP address from the altip table.

`set altip rm ip=198.150.150.10`

##### Removing a Range of Entries in the Altip Table: PortServer TS 8/16

In this example, the set altip command removes altip table entries 7 through 14.

`set altip rmaltip=on range=7-14`

##### Removing a Range of Entries in the Altip Table: Digi One RealPort, PortServer TS 2/4

In this example, the set altip command removes altip table entries 1 and 2.

`set altip rm range=1-2`