AT-DC2552XS Command Line Interface User’s Guide

Layer 2 Data Center Switch

 

Boot Configuration File Commands

 

The boot configuration file commands are summarized in Table 21.

Table 21 Boot Configuration File Commands

Command

Mode

Description

BOOT CONFIG-FILE

Global Configuration

Designates or creates a new boot configuration file (startup-config file) for the switch.

COPY RUNNING-CONFIG

Privileged Exec

Creates a new boot configuration file that contains the current settings of the switch.

COPY RUNNING-CONFIG STARTUP-CONFIG

Privileged Exec

Saves the switch’s current configuration (running-config file) to the boot configuration file (startup-config file).

COPY STARTUP-CONFIG88

Privileged Exec

Saves a configuration file in the switch as the startup configuration file.

ERASE STARTUP-CONFIG

Privileged Exec

Deletes the boot configuration file (startup-config file) and returns the switch to its default settings.

NO BOOT CONFIG-FILE

Global Configuration

Designates the default BOOT.CFG file as the boot configuration file on the switch.

SHOW BOOT

Privileged Exec

Displays the names of the boot configuration file and the configuration file that was used by the switch during the last reset or power cycle.

SHOW STARTUP-CONFIG

Privileged Exec

Displays the contents of the boot configuration file (startup-config file).

WRITE

Privileged Exec

Saves the switch’s current configuration to the boot configuration file (startup-config file).

BOOT CONFIG-FILE

Syntax

boot config-file filename.cfg

Parameter

filename.cfg
Specifies the name of a configuration file as the boot configuration file (startup-config file) on the switch. The filename is case-sensitive and can be from 1 to 28 alphanumeric characters. The extension must be “.cfg.”

Mode

Global Configuration mode

Description

Use this command to designate the boot configuration file (startup-config file) on the switch. The switch uses the boot configuration file designated by this command when the switch is power-cycled or reset. By default, the boot.cfg file is the boot configuration file. To configure the switch with the new boot configuration file, reset the switch with the REBOOT or RELOAD command after entering this command.

When you issue the WRITE or COPY RUNNING-CONFIG STARTUP-CONFIG command, the switch saves the current configuration settings onto the boot configuration file designated by the BOOT CONFIG-FILE command. In addition, when you issue the ERASE STARTUP-CONFIG command, the switch deletes the boot configuration file designated by the BOOT CONFIG-FILE command. See ERASE STARTUP-CONFIG.

To create a new boot configuration file, enter a new filename in the command. The command automatically creates the new file, updates it with the current settings of the switch, and designates it as the boot configuration file.

Confirmation Command

SHOW BOOT.

Example

This example designates a file called “boot2.cfg” as the switch’s boot configuration file:

awplus> enable
awplus# configure terminal
awplus(config)# boot config-file boot2.cfg

COPY RUNNING-CONFIG

Syntax

copy running-config filename..cfg

Parameter

filename.cfg
Specifies a name for the configuration file. The file name is case-sensitive and can be from 1 to 28 alphanumeric characters. The extension must be “.cfg.”

Mode

Privileged Exec mode

Description

Use this command to create a new configuration file. The new configuration file is stored in the file system on the switch, containing the current settings of the switch. Use this command to create a backup copy of the switch’s current configuration (running-config file).

This command does not change the boot configuration file. To designate a different file as the boot configuration file on the switch, refer to BOOT CONFIG-FILE.

Confirmation Command

DIR

Example

This example saves the current configuration settings of the switch as a new boot configuration file called “sw3_backup.cfg”:

awplus> enable
awplus# copy running-config sw3_backup.cfg

COPY RUNNING-CONFIG STARTUP-CONFIG

Syntax

copy running-config startup-config

Parameters

None

Mode

Privileged Exec mode

Description

Use this command to save the switch’s current configuration file (running-config file) onto the boot configuration file (startup-config file). When you enter the command, the switch copies the current parameter settings in the RAM memory into the boot configuration file in the FLASH memory.

This command is equivalent to WRITE.

Parameter changes in the current management session that are not saved by this command or the WRITE command are discarded when you power off or reset the switch.

Example

This example saves the switch’s current configuration settings onto the boot configuration file (startup-config file):

awplus# copy running-config startup-config

COPY STARTUP-CONFIG

Syntax

copy filename..cfg startup-config

Parameter

filename..cfg
Specifies the name of a configuration file in the file system in the switch. The file name is case-sensitive. The extension must be “.cfg.”

Mode

Privileged Exec mode

Description

Use this command to save a configuration file in the file system in the switch as the startup configuration file.

Confirmation Command

DIR

Example

This example saves a configuration file named “sw2_10_12.cfg” as the startup configuration file:

awplus> enable
awplus# copy sw2_10_12.cfg startup-config

ERASE STARTUP-CONFIG

Syntax

erase startup-config

Parameters

None

Mode

Privileged Exec mode

Confirmation Command

DIR

Description

Use this command to delete the startup configuration file, which is specified as the boot configuration file. After entering this command, enter the REBOOT command to reset the switch. The switch restores the default configuration settings.

To resume managing the switch after restoring the default settings, you must establish a local management session from the Console port.

Example

This example deletes the startup configuration file:

awplus> enable
awplus# erase startup-config

erase start-up config? (y/n):y
Deleting..
Successful Operation

NO BOOT CONFIG-FILE

Syntax

no boot config-file

Parameter

None

Mode

Global Configuration mode

Description

Use this command to designate the default boot.cfg file as the boot configuration file (startup-config file). The switch is configured with the default settings after you reboot or reset it.

Example

This example sets the startup configuration file to the default settings:

awplus> enable
awplus# configure terminal
awplus(config)# no boot config-file

SHOW BOOT

Syntax

show boot

Parameter

None

Mode

Privileged Exec mode

Description

Use this command to display the names of the management software and boot configuration file. See Figure 30 for an example of the command output.

 

Figure 30. SHOW BOOT Command

The fields are described in Figure 22.

Table 22 SHOW BOOT Command

Field

Description

Current software

Displays the file name of the management software that is currently loaded on the switch.

Current boot image

Displays the file name of the management software that is loaded on the switch next time the switch reboots.

Default boot config

Displays the name of the default boot configuration file. Always displays “/config/boot.cfg.” When the BOOT-CONFIG-FILE command has never issued on the switch, the switch uses this file to configure itself when rebooting.

Current boot config

Displays the name of the boot configuration file (startup configuration file) currently specified on the switch. The switch uses this file to configure itself next time the switch reboots.

Example

This example displays the names of the management software and boot configuration file:

awplus# show boot

SHOW STARTUP-CONFIG

Syntax

show startup-config

Parameters

None

Modes

Privileged Exec mode

Description

Use this command to display the contents of the boot configuration file. The boot configuration file is the startup configuration file that the switch uses to configure itself when the switch is power-cycled or reset. The startup configuration file is the file that you specify with the BOOT CONFIG-FILE command. By default, the startup configuration file is the boot.cfg file. See Figure 31 for an example of this file.

 

Figure 31. SHOW START-UP CONFIG Command

Example

This example display the contents of the boot configuration file:

awplus# show startup-config

WRITE

Syntax

write

Parameters

None

Mode

Privileged Exec mode

Description

Use this command to save the configuration file (running-config file) stored on the RAM as the startup-config file stored on the NVRAM on the switch.

This command is equivalent to the COPY RUNNING-CONFIG STARTUP-CONFIG, WRITE MEMORY, or WRITE FILE command.

Confirmation Command

SHOW STARTUP-CONFIG

Example

This example saves the running configuration file:

awplus# write