Image and configuration management commands

persist

Syntax

persist {on | off}

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies whether the system preserves system indexes when a save command is executed. During a subsequent boot, the index file is read along with the configuration file. As a result, a number of system indexes are preserved between reboots, including the interface index, and so on. This reduces resynchronizations of the Network Management System (NMS) with the affected network element.

If persist is enabled and the reboot with the appropriate index file fails, SNMP is operationally shut down to prevent the management system from accessing and possibly synchronizing with a partially booted or incomplete network element. To enable SNMP access, enter the config>system>snmp>no shutdown command.

If persist is enabled and the admin save file-url command is executed with an FTP path used as the file-url parameter value, two FTP sessions simultaneously open to the FTP server. The FTP server must be configured to allow multiple sessions from the same login, otherwise, the configuration and index files are not saved correctly.

Note:
  • Persistency files (.ndx) are saved on the same disk as the configuration files and the image files.

  • When a user sets the location for the persistency file, the system checks to ensure that the disk has enough free space. If this there is not enough free space, the persistency does not become active and a trap is generated. Then, it is up to the operator to free adequate disk space. In the meantime, the system performs a space availability check every 30 seconds. As soon as the space is available, the persistency becomes active on the next (30 second) check.

Default

off

Parameters

on

Keyword to preserve the system index when saving the configuration.

off

Keyword to disable the system index saves between reboots.

primary-config

Syntax

primary-config file-url

no primary-config

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the name and location of the primary configuration file.

The system attempts to use the configuration specified in primary-config. If the specified file cannot be located, the system automatically attempts to obtain the configuration from the location specified in secondary-config and then the tertiary-config.

Note:

If an error in the configuration file is encountered, the boot process aborts.

The no form of this command removes the primary-config configuration.

Parameters

file-url

Specifies the primary configuration file location, expressed as a file URL.

Values

file-url

[local-url | remote-url] (up to 180 characters)

local-url

[<cflash-id/> | <usb-flash-id>][file-path]

remote-url

[{ftp://|tftp://} login:pswd@remote-locn/][file-path]

cflash-id

cf1:

usb-flash-id

uf1:

primary-image

Syntax

primary-image file-url

no primary image

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the primary directory location for runtime image file loading.

The system attempts to load all runtime image files configured in the primary-image first. If this fails, the system attempts to load the runtime images from the location configured in the secondary-image. If the secondary image load fails, the tertiary image specified in tertiary-image is used.

The no form of this command removes the primary-image configuration.

Parameters

file-url

Specifies the location-url can be either local (this flash) or a remote FTP server.

Values

file-url

[local-url | remote-url] (up to 180 characters)

local-url

[<cflash-id/> | <usb-flash-id>][file-path]

remote-url

[{ftp://|tftp://} login:pswd@remote-locn/][file-path]

cflash-id

cf1:

usb-flash-id

uf1:

secondary-config

Syntax

secondary-config file-url

no secondary-config

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the name and location of the secondary configuration file.

The system attempts to use the configuration as specified in secondary-config if the primary config cannot be located. If the secondary-config file cannot be located, the system attempts to obtain the configuration from the location specified in the tertiary-config.

If an error in the configuration file is encountered, the boot process aborts.

The no form of this command removes the secondary-config configuration.

Parameters

file-url

Specifies the secondary configuration file location, expressed as a file URL.

Values

file-url

[local-url | remote-url] (up to 180 characters)

local-url

[<cflash-id/> | <usb-flash-id>][file-path]

remote-url

[{ftp://|tftp://} login:pswd@remote-locn/][file-path]

cflash-id

cf1:

usb-flash-id

uf1:

secondary-image

Syntax

secondary-image file-url

no secondary-image

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the secondary directory location for runtime image file loading.

The system attempts to load all runtime image files configured in the primary-image first. If this fails, the system attempts to load the runtime images from the location configured in the secondary-image. If the secondary image load fails, the tertiary image specified in tertiary-image is used.

The no form of this command removes the secondary-image configuration.

Parameters

file-url

Specifies that the file-url can be either local (this local flash) or a remote FTP server.

Values

file-url

[local-url | remote-url] (up to 180 characters)

local-url

[<cflash-id/> | <usb-flash-id>][file-path]

remote-url

[{ftp://|tftp://} login:pswd@remote-locn/][file-path]

cflash-id

cf1:

usb-flash-id

uf1:

tertiary-config

Syntax

tertiary-config file-url

no tertiary-config

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the name and location of the tertiary configuration file.

The system attempts to use the configuration specified in tertiary-config if both the primary and secondary config files cannot be located. If this file cannot be located, the system boots with the factory default configuration.

If an error in the configuration file is encountered, the boot process aborts.

The no form of this command removes the tertiary-config configuration.

Parameters

file-url

Specifies the tertiary configuration file location, expressed as a file URL.

Values

local-url

[<cflash-id/> | <usb-flash-id>][file-path]

cflash-id

cf1:

usb-flash-id

uf1:

remote-url

[{ftp://|tftp://} login:pswd@remote-locn/][file-path]local-url

tertiary-image

Syntax

tertiary-image file-url

no tertiary-image

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the tertiary directory location for runtime image file loading.

The system attempts to load all runtime image files configured in the primary-image first. If this fails, the system attempts to load the runtime images from the location configured in the secondary-image. If the secondary image load fails, the tertiary image specified in tertiary-image is used.

The no form of this command removes the tertiary-image configuration.

Parameters

file-url

Specifies that the location-url can be either local (this flash) or a remote FTP server.

Values

file-url

[local-url | remote-url] (up to 180 characters)

local-url

[<cflash-id/> | <usb-flash-id>][file-path]

remote-url

[{ftp://|tftp://} login:pswd@remote-locn/][file-path]

cflash-id

cf1:

usb-flash-id

uf1:

ping-address

Syntax

ping-address ip-address

no ping-address

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the IP address used for a ping-test after the system boots.

The no form of this command removes the ping-address configuration. Setting a value of 0 also removes the ping-address configuration.

Parameters

ip-address

Specifies an IPv4 address in the form a.b.c.d; for example, 10.1.2.10.

uplinkA-address

Syntax

uplinkA-address ip-address/mask

no uplinkA-address

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the uplink-A address.

The no form of this command sets the uplinkA to use DHCP to get the IP and the show bof value reflects 0 for this parameter.

Parameters

ip-address

Specifies the IP address of the BOF. This address must be unique within the subnet and specified in dotted decimal notation.

Values

a.b.c.d

mask

Specifies the subnet mask length when the IP prefix is specified in CIDR notation. When the IP prefix is specified in CIDR notation, a forward slash (/) separates the ip-address from the mask parameter. The mask parameter indicates the number of bits used for the network portion of the IP address; the remainder of the IP address is used to determine the host portion of the IP address.

Values

1 to 30

uplinkB-address

Syntax

uplinkB-address ip-address/mask

no uplinkB-address

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the uplink-B address.

The no form of this command sets the uplinkB to use DHCP to get the IP, and the show bof value reflects 0 for this parameter.

Parameters

ip-address

Specifies the IP address of the BOF. This address must be unique within the subnet and specified in dotted decimal notation.

Values

a.b.c.d

mask

Specifies the subnet mask length when the IP prefix is specified in CIDR notation. When the IP prefix is specified in CIDR notation, a forward slash (/) separates the ip-address from the mask parameter. The mask parameter indicates the number of bits used for the network portion of the IP address; the remainder of the IP address is used to determine the host portion of the IP address.

Values

1 to 30

uplinkA-autoneg

Syntax

[no] uplinkA-autoneg

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables speed and duplex auto-negotiation on the uplinkA port in the running configuration and the BOF.

The no form of this command disables auto-negotiate on this port.

Note:

The uplinkA-autoneg command is not valid for 10GE ports. Therefore, whenever the user selects 10GE ports as uplinkA-port, the uplinkA-autoneg command is defaulted to no uplinkA-autoneg, speed as uplinkA-speed 10000, and duplex as uplinkA-duplex full, as shown in the following output example.

Example
#uplinkA Port Settings:
    uplinkA-port       1/1/26
    no uplinkA-autoneg
    uplinkA-duplex     full
    uplinkA-speed      10000
    uplinkA-address    0 
    uplinkA-vlan       0

Default

uplinkA-autoneg

uplinkB-autoneg

Syntax

[no] uplinkB-autoneg

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables speed and duplex Auto-negotiation on the uplinkB port in the running configuration and the BOF.

The no form of this command disables auto-negotiate on this port.

Note:

The uplinkB-autoneg command is not valid for 10GE ports. Therefore, whenever the user selects 10GE ports as uplinkB-port, the uplinkB-autoneg command is defaulted to no uplinkB-autoneg, speed as uplinkB-speed 10000, and duplex as uplinkB-duplex full, as shown in the following output example.

Example
#uplinkB Port Settings:
    uplinkB-port       1/1/26
    no uplinkB-autoneg
    uplinkB-duplex     full
    uplinkB-speed      10000
    uplinkB-address    0 
    uplinkB-vlan       0

Default

uplinkB-autoneg

uplinkA-duplex

Syntax

uplinkA-duplex {full | half}

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the duplex mode of the uplinkA port when auto-negotiation is disabled in the running configuration and the BOF.

This command also enables the context to configure the duplex mode of the Ethernet port. If the port is configured to auto-negotiate, this parameter will be ignored.

Note:

The uplinkA-autoneg command is not valid for 10GE ports. Therefore, whenever the user selects 10GE ports as uplinkA-port, the uplinkA-autoneg command is defaulted to no uplinkA-autoneg, speed as uplinkA-speed 10000, and duplex as uplinkA-duplex full, as shown in the following output example.

Example
#uplinkA Port Settings:
    uplinkA-port       1/1/26
    no uplinkA-autoneg
    uplinkA-duplex     full
    uplinkA-speed      10000
    uplinkA-address    0 
    uplinkA-vlan       0

Default

uplinkA-duplex full

Parameters

full

Keyword to set the link to full duplex mode.

half

Keyword to sets the link to half duplex mode.

uplinkB-duplex

Syntax

uplinkB-duplex {full | half}

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the duplex mode of the uplinkB port when auto-negotiation is disabled in the running configuration and the BOF.

This configuration command allows for the configuration of the duplex mode of the Ethernet port. If the port is configured to auto-negotiate, this parameter is ignored.

Note:

The uplinkB-autoneg command is not valid for 10GE ports. Therefore, whenever the user selects 10GE ports as uplinkB-port, the uplinkB-autoneg command defaults to no uplinkB-autoneg, speed as uplinkB-speed 10000, duplex as uplinkB-duplex full, as shown in the following output example.

Example
#uplinkB Port Settings:
    uplinkB-port       1/1/26
    no uplinkB-autoneg
    uplinkB-duplex     full
    uplinkB-speed      10000
    uplinkB-address    0 
    uplinkB-vlan       0

Default

uplinkB-duplex full

Parameters

full

Keyword to set the link to full duplex mode.

half

Keyword to set the link to half duplex mode.

uplinkA-port

Syntax

uplinkA-port port-id

no uplinkA-port

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the primary port to be used for boot up.

The no form of this command removes all uplinkA parameters from the BOF.

Parameters

port-id

Specifies the primary port to be used for boot up in the slot/mda/port format.

uplinkB-port

Syntax

uplinkB-port port-id

no uplinkB-port

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the secondary port to be used for bootup.

The no form of this command removes all uplinkB parameters from the BOF.

Parameters

port-id

Specifies the secondary port to be used for boot up in the slot/mda/port format.

uplinkA-route

Syntax

[no] uplinkA-route ip-address/mask next-hop ip-address

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures an uplinkA static route.

Parameters

ip-address

Specifies the IP address of the BOF. This address must be unique within the subnet and specified in dotted decimal notation.

Values

a.b.c.d

mask

Specifies the subnet mask length when the IP prefix is specified in CIDR notation. When the IP prefix is specified in CIDR notation, a forward slash (/) separates the ip-address from the mask parameter. The mask parameter indicates the number of bits used for the network portion of the IP address; the remainder of the IP address is used to determine the host portion of the IP address.

Values

0 to 32

next-hop ip-address

Specifies the next-hop IP address used to reach the destination.

uplinkB-route

Syntax

[no] uplinkB-route ip-address/mask next-hop ip-address

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures an uplinkB static route.

Parameters

ip-address

Specifies the IP address of the BOF. This address must be unique within the subnet and specified in dotted decimal notation.

Values

a.b.c.d

mask

Specifies the subnet mask length when the IP prefix is specified in CIDR notation. When the IP prefix is specified in CIDR notation, a forward slash (/) separates the ip-address from the mask parameter. The mask parameter indicates the number of bits used for the network portion of the IP address; the remainder of the IP address is used to determine the host portion of the IP address.

Values

0 to 32

next-hop ip-address

Specifies the next-hop IP address used to reach the destination.

uplinkA-speed

Syntax

uplinkA-speed speed

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the speed for the uplinkA when auto-negotiation is disabled in the running configuration and the BOF.

If the port is configured to auto-negotiate, this parameter is ignored.

Note:

The uplinkA-autoneg command is not valid for 10GE ports. Therefore, whenever the user selects 10GE ports as uplinkA-port, the uplinkA-autoneg command defaults to no uplinkA-autoneg, speed as uplinkA-speed 10000, and duplex as uplinkA-duplex full, as shown in the following output example.

Example
#uplinkA Port Settings:
    uplinkA-port       1/1/26
    no uplinkA-autoneg
    uplinkA-duplex     full
    uplinkA-speed      10000
    uplinkA-address    0 
    uplinkA-vlan       0

Default

uplinkA-speed 1000 m/bps

Parameters

10

Keyword to set the link to 10 M/bps speed.

100

Keyword to set the link to 100 M/bps speed.

1000

Keyword to set the link to 1000 M/bps speed.

uplinkB-speed

Syntax

uplinkB-speed speed

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the speed for the uplinkB when auto-negotiation is disabled in the running configuration and the BOF.

If the port is configured to auto-negotiate, this parameter is ignored.

Note:

The uplinkB-autoneg command is not valid for 10GE ports. Therefore, whenever the user selects 10GE ports as uplinkB port, the uplinkB-autoneg command is defaulted to no uplinkB-autoneg, speed as uplinkB-speed 10000, and duplex as uplinkB-duplex full, as shown in the following output example.

Example
#uplinkB Port Settings:
    uplinkB-port       1/1/26
    no uplinkB-autoneg
    uplinkB-duplex     full
    uplinkB-speed      10000
    uplinkB-address    0 
    uplinkB-vlan       0

Default

uplinkB-speed 1000

Parameters

10

Keyword to set the link to 10 M/bps speed.

100

Keyword to set the link to 100 M/bps speed.

1000

Keyword to set the link to 1000 M/bps speed.

uplinkA-vlan

Syntax

uplinkA-vlan 0..4094

no uplinkA-vlan

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies a VLAN ID to be used on uplinkA.

The no form of this command is used to send untagged packets on uplinkA.

Parameters

0...4094

Specifies the VLAN ID.

Values

0 to 4094

uplinkB-vlan

Syntax

uplinkB-vlan 0..4094

no uplinkB-vlan

Context

bof

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies a VLAN ID to be used on uplinkB.

The no form of this command is used to send untagged packets on uplinkB.

Parameters

0..4094

Specifies the VLAN ID.

Values

0 to 4094