xStack

®

DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual

22

5

BASIC IP COMMANDS

The Basic IP commands in the Command Line Interface (CLI) are listed (along with the appropriate parameters) in the

following table.

Command

Parameters

create ipif

<ipif_name 12> {<network_address>} <vlan_name 32> { secondary | state [

enable | disable ] | proxy_arp [enable|disable] {local [enable|disable]}}

config ipif

<ipif_name 12> [{ ipaddress <network_address> | vlan <vlan_name 32> | state

[enable|disable] | proxy_arp [enable|disable] {local [enable|disable]}}| bootp |

dhcp | ipv6 ipv6address <ipv6networkaddr> | ip_mtu <value 512-1712> |

dhcpv6_client [enable | disable] | ip_directed_broadcast [enable | disable]]

enable ipif

[<ipif_name 12> | all]

disable ipif

[<ipif_name 12> | all]

enable ipif_ipv6_link_local_auto

[<ipif_name 12> | all]

disable ipif_ipv6_link_local_auto

[<ipif_name 12> | all]

show ipif

{<ipif_name 12>}

show ipif_ipv6_link_local_auto

{<ipif_name 12>}

delete ipif

[<ipif_name 12> {ipv6address <ipv6networkaddr>} | all]

Each command is listed, in detail, in the following sections.

create ipif

Purpose

This command creates a L3 interface.

±

Syntax

create ipif <ipif_name 12> {<network_address>} <vlan_name 32> { secondary | state [

enable | disable ] | proxy_arp [enable|disable] {local [enable|disable]}}

Description

This interface can be configured with IPv4 or IPv6 address. Currently, it has a restriction. An

interface can have only one IPv4 address defined. But it can have multiple IPv6 addresses

defined. Thus, the multinetting configuration of IPv4 must be done through creation of a

secondary interface on the same VLAN, instead of directly configuring multiple IPv4

addresses on the same interface. Configuration of IPv6 address must be done through the

command config ipif.

Note

that for IPv4 case, the multicast routing protocol state in secondary IP interfaces must

follow master IP interface’s state. For example, if dvmrp state in master IP interface is

enabled, the secondary IP interfaces need to be the same.

Parameters

ipif_name

- The name of the interface.

network_address

- IPv4 network address (xxx.xxx.xxx.xxx/xx). It specifies a host address and

length of network mask.

vlan_name

- The name of a vlan.

secondary

- IPv4 secondary interface to be created.

state

- State of interface.

proxy_arp

- Enable/disable of proxy ARP function. It is for IPv4 function. Default: Disabled.

local

- This setting controls whether the system provides the proxy reply for the ARP packets

destined for IP address located in the same interface as the received interface. When proxy

ARP is enabled for an interface, the system will do the proxy reply for the ARP packets

destined for IP address located in a different interface. For ARP packets destined for IP

xStack

®

DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual

23

create ipif

address located in the same interface, the system will check this setting to determine whether

to reply. Default: Disabled.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example usage:

To create an interface Intface_1 on vlan vlan_1.

DGS-3627:admin# create ipif Intface_1 vlan_1

Command: create ipif Intface_1 vlan_1

Success.

DGS-3627:admin#

config ipif

Purpose

Configures the parameters for a L3 interface.

Syntax

config ipif <ipif_name 12> [{ ipaddress <network_address> | vlan <vlan_name 32> |

state [enable|disable] | proxy_arp [enable|disable] {local [enable|disable]}}| bootp |

dhcp | ipv6 ipv6address <ipv6networkaddr> | ip_mtu <value 512-1712> | dhcpv6_client

[enable | disable] | ip_directed_broadcast [enable | disable]]

Description

For IPv4, only the system interface can be specified for the way to get the IP address. If the

mode is set to BOOTP or DHCP, then the IPv4 address will be obtained through the

operation of protocols. The manual configuration of the IP address will be of no use. If you

configures the mode to the BOOTP or DHCP first, and configure IP address later, the mode

will be changed to manual configured mode.

For IPv6, multiple addresses can defined on the

same L3 interface. For IPv4, multi-netting must be done by creation of a secondary interface.

Note that IPv6 address is not allowed to be configured on a secondary interface.

Only the system interface is allowed to set to DHCP mode

Parameters

ipif_name

- The name of the interface.

network_address

- Configures a network on an ipif. The address should specify a host

address and length of network mask. Since an ipif can have only one IPv4 address, the new

configured address will overwrite the original one.

vlan

- Name of the vlan where the IPIF is operated.

proxy_arp

- Enable/disable of proxy ARP function. It is for IPv4 function. Default: Disabled.

local

- This setting controls whether the system provides the proxy reply for the ARP packets

destined for IP address located in the same interface as the received interface. When proxy

ARP is enabled for an interface, the system will do the proxy reply for the ARP packets

destined for IP address located in a different interface. For ARP packets destined for IP

address located in the same interface, the system will check this setting to determine whether

to reply.

bootp

- Use BOOTP to obtain the IPv4 address.

dhcp

- Use DHCP to obtain the IPv4 address.

ipv6networkaddr

- IPv6 network address. The address should specify a host address and

length of network prefix. There can be multiple V6 addresses defined on an interface. Thus,

as a new address is defined, it is added on this ipif.

state

- Enable or disable state of the ipif.

ip_mtu

- Specifies the IP layer mtu. The range is 512-1712. The default setting is 1500 bytes.

dhcpv6

_client - See below:

enable

- Enable the DHCPv6 client state of the interface.

disable

- Disable the DHCPv6 client state of the interface.

ip_directed_broadcast

- See below:

xStack

®

DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual

24

config ipif

enable

- Enabled the IP directed-broadcast state of the interface.

disable

- Disabled the IP directed-broadcast state of the interface.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example usage:

To configure an interface’s IPv4 network address:

DGS-3627:admin# config ipif Intface_1 ipaddress 10.0.0.1/8

Command: config ipif Intface_1 ipaddress 10.0.0.1/8

Success

DGS-3627:admin#

enable ipif

Purpose

Enable the admin state for an interface.

Syntax

enable ipif [<ipif_name 12> | all]

Description

Enable the state for an IPIF.

When the state is enabled, the IPv4 processing will be started when the IPv4 address is

configured on the IPIF. The IPv6 processing will be started when the IPv6 address is

explicitly configured on the IPIF.

Parameters

ipif_name

- Specifies the name of the IP interface used.

all

- Specifies that all the interfaces will be enabled.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example usage:

Enable the state for an interface.

DGS-3627:admin# enable ipif Intface_1

Command: enable ipif Intface_1

Success

DGS-3627:admin#

disable ipif

Purpose

Disables interface’s admin state.

Syntax

disable ipif [<ipif_name 12> | all]

Description

Disables the state for an IP interface.

Parameters

ipif_name

- Specifies the name of the IP interface used.

all

- Specifies that all the interfaces will be disabled.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example usage:

To disable an interface’s state.

xStack

®

DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual

25

DGS-3627:admin# disable ipif Intface_1

Command: disable ipif Intface_1

Success

DGS-3627:admin#

enable ipif_ipv6_link_local_auto

Purpose

Enable the auto configuration of link local address when no IPv6 address is configured.

Syntax

enable ipif_ipv6_link_local_auto [<ipif_name 12> | all]

Description

Enable the auto configuration of link local address when there are no IPv6 addresses

explicitly configured. When an IPv6 address is explicitly configured, the link local address will

be automatically configured, and the IPv6 processing will be started. When there is no IPv6

address explicitly configured, by default, link local address is not configured and the IPv6

processing will be disabled. By enable this automatic configuration, the link local address will

be automatically configured and IPv6 processing will be started.

Parameters

ipif_name

- Specifies the name of the IPv6 interface used.

all

- Specifies that all the interfaces will be enabled.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example usage:

Enable the automatic configuration of link local address for an interface:

DGS-3627:admin# enable ipif_ipv6_link_local_auto Intface_1

Command: enable ipif_ipv6_link_local_auto Intface_1

Success

DGS-3627:admin#

disable ipif_ipv6_link_local_auto

Purpose

Disable the auto configuration of link local address when no IPv6 address are configured.

Syntax

disable ipif_ipv6_link_local_auto [<ipif_name 12> | all]

Description

Disable the auto configuration of link local address when no IPv6 address is explicitly

configured.

Parameters

ipif_name

- Specifies the name of the IPv6 interface used.

all

- Specifies that all the interfaces will be disabled.

Restrictions

Only Administrator and Operator-level users can issue this command.

Example usage:

Disable the automatic configuration of link local address for an interface:

DGS-3627:admin# disable ipif_ipv6_link_local_auto Intface_1

Command: disable ipif_ipv6_link_local_auto Intface_1

Success

DGS-3627:admin#

xStack

®

DGS-3600 Series Layer 3 Gigabit Ethernet Managed Switch CLI Manual

26

show ipif

Purpose

This command is used to display the interface’s information.

Syntax

show ipif {<ipif_name 12>}

Description

To show an interface’s information. Configuration for both IPv4 and IPv6’ addresses will be

displayed.

Parameters

ipif_name

- Specifies the name of the IP interface used.

Restrictions

None.

Example usage:

Show interface’s information:

DGS-3627:admin# show ipif

Command: show ipif

IP Interface

: n6

VLAN Name

: 6

Interface Admin State

: Enabled

DHCPv6 Client State

: Disabled

IPv4 Address

: 192.168.6.105/24 (Manual)

Primary

Proxy ARP

: Disabled

(Local : Disabled)

IP Directed Broadcast

: Disabled

IPv6 Link-Local Address

: FE80::202:3FF:FE03:202/128

IPv6 Global Unicast Address : 3006::105/64 (Manual)

IP MTU

: 1500

DGS-3627:admin#

show ipif_ipv6_link_local_auto

Purpose

Display the link local address automatic configuration state.

Syntax

show ipif_ipv6_link_local_auto {<ipif_name 12>}

Description

Display the link local address automatic configuration state.

Parameters

ipif_name

- Specifies the name of the IP interface used.

Restrictions

None.

Example usage:

Show interface’s information:

DGS-3627:admin# show ipif_ipv6_link_local_auto

Command: show ipif_ipv6_link_local_auto

IPIF : System

Automatic Link Local Address: Enabled.

IPIF : FirstFloor

Automatic Link Local Address: Disabled.

DGS-3627:admin#

delete ipif

Purpose

Delete an interface.