Table of Contents

Guidelines for Creating and Using Configuration Files
Creating a Configuration File
Downloading Configuration Files to the Switch

Preparing to Download a Configuration File Using TFTP
Configuring the Switch Using a File on a TFTP Server
Configuring the Switch Using a File on a Flash Device

Uploading Configuration Files to a TFTP Server

Preparing to Upload a Configuration File to a TFTP Server
Uploading a Configuration File to a TFTP Server

Clearing the Configuration

Working with Configuration Files

This chapter describes how to work with switch configuration files on the Catalyst 6000 family switches configuration files.

This chapter consists of these sections:

• Guidelines for Creating and Using Configuration Files

• Creating a Configuration File

• Downloading Configuration Files to the Switch

• Uploading Configuration Files to a TFTP Server

• Clearing the Configuration

Guidelines for Creating and Using Configuration Files

Creating configuration files can aid in the configuration of your switch. Configuration files can contain some or all the commands needed to configure one or more switches. For example, you might want to download the same configuration file to several switches that have the same hardware configuration so that they have identical module and port configurations.

Use the following guidelines when creating a configuration file:

• We recommend that you connect through the console port when using configuration files to configure the switch. If you configure the switch from a Telnet session, IP addresses are not changed, and ports and modules are not disabled.

• If no passwords have been set on the switch, you must set them on each switch by entering the set password and set enablepass commands. Enter a blank line after the set password and set enablepass commands. The passwords are saved in the configuration file as clear text.

If passwords already exist, you cannot enter the set password and set enablepass commands because the password verification will fail. If you enter passwords in the configuration file, the switch mistakenly attempts to execute the passwords as commands as it executes the file.

• Certain commands must be followed by a blank line in the configuration file. The blank line is necessary; without the blank line, these commands might disconnect your Telnet session. Before disconnecting a session, the switch prompts you for confirmation. The blank line acts as a carriage return, which indicates a negative response to the prompt and thus retains the Telnet session.

Include a blank line after each occurrence of these commands in a configuration file:

• set interface sc0 ip_addr netmask

• set interface sc0 disable

• set module disable mod_num

• set port disable mod_num/port_num

Creating a Configuration File

When creating a configuration file, you must list commands in a logical way so that the system can respond appropriately. One method of creating a configuration file is as follows:

Step 1 Download an existing configuration from a switch.

Step 2 Open the configuration file in a text editor, such as vi or emacs on UNIX or Notepad on a PC.

Step 3 Extract the portion of the configuration file with the desired commands and save it in a new file. Make sure the file begins with the word begin on a line by itself and ends with the word end on a line by itself.

Step 4 Copy the configuration file to the appropriate TFTP directory on the workstation (usually /tftpboot on a UNIX workstation).

Step 5 Make sure the permissions on the file are set to world-read.

This example shows an example configuration file. This file could be used to set the DNS configuration on multiple switches.

begin
 
!
#dns
set ip dns server 172.16.10.70 primary
set ip dns server 172.16.10.140
set ip dns enable
set ip dns domain corp.com
end

Downloading Configuration Files to the Switch

You can configure the switch using configuration files you create or download from another switch. In addition, you can store configuration files on Flash devices on hardware that supports the Flash file system, and you can configure the switch using a configuration stored on a Flash device.

These sections describe how to configure the switch using configuration files downloaded from a TFTP server or stored on a Flash device:

• Preparing to Download a Configuration File Using TFTP

• Configuring the Switch Using a File on a TFTP Server

• Configuring the Switch Using a File on a Flash Device

Preparing to Download a Configuration File Using TFTP

Before you begin downloading a configuration file using TFTP, do the following:

• Ensure that the workstation acting as the TFTP server is configured properly. On a Sun workstation, make sure that the /etc/inetd.conf file contains this line:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot
 

Make sure that the /etc/services file contains this line:

tftp 69/udp

---

Note You must restart the inetd daemon after modifying the /etc/inetd.conf and /etc/services files. To restart the daemon, either stop the inetd process and restart it, or enter a fastboot command (on the SunOS 4.x) or a reboot command (on Solaris 2.x or SunOS 5.x). Refer to the documentation for your workstation for more information on using the TFTP daemon.

---

• Ensure that the switch has a route to the TFTP server. The switch and the TFTP server must be in the same subnetwork if you do not have a router to route traffic between subnets. Check connectivity to the TFTP server using the ping command.

• Ensure that the configuration file to be downloaded is in the correct directory on the TFTP server (usually /tftpboot on a UNIX workstation).

• Ensure that the permissions on the file are set correctly. Permissions on the file should be world-read.

Configuring the Switch Using a File on a TFTP Server

Use this procedure to configure the switch using a configuration file downloaded from a TFTP server:

Step 1 Copy the configuration file to the appropriate TFTP directory on the workstation.

Step 2 Log into the switch through the console port or a Telnet session.

Step 3 Configure the switch using the configuration file downloaded from the TFTP server with the copy tftp config command. Specify the IP address or host name of the TFTP server and the name of the file to download.

The configuration file downloads and the commands are executed as the file is parsed line-by-line.

This example shows how to configure the switch using a configuration file downloaded from a TFTP server:

Console> (enable) copy tftp config
IP address or name of remote host []? 172.20.52.3
Name of file to copy from []? dns-config.cfg
 
Configure using tftp:dns-config.cfg (y/n) [n]? y
/
Finished network download.  (134 bytes)
>>
>> set ip dns server 172.16.10.70 primary
172.16.10.70 added to DNS server table as primary server.
>> set ip dns server 172.16.10.140
172.16.10.140 added to DNS server table as backup server.
>> set ip dns enable
DNS is enabled
>> set ip dns domain corp.com
Default DNS domain name set to corp.com
Console> (enable)

Configuring the Switch Using a File on a Flash Device

Use this procedure to configure a switch using a configuration file stored on a Flash device in the Flash file system:

Step 1 Log into the switch through the console port or a Telnet session.

Step 2 Locate the configuration file using the cd and dir commands (for more information, see "Working With the Flash File System").

Step 3 Configure the switch using the configuration file stored on the Flash device using the copy file-id config command.

The commands are executed as the file is parsed line-by-line.

This example shows how to configure the switch using a configuration file stored on a Flash device:

Console> (enable) copy slot0:dns-config.cfg config
 
Configure using slot0:dns-config.cfg (y/n) [n]? y
 
Finished network download.  (134 bytes)
>>
>> set ip dns server 172.16.10.70 primary
172.16.10.70 added to DNS server table as primary server.
>> set ip dns server 172.16.10.140
172.16.10.140 added to DNS server table as backup server.
>> set ip dns enable
DNS is enabled
>> set ip dns domain corp.com
Default DNS domain name set to corp.com
Console> (enable)
Console> (enable)

Uploading Configuration Files to a TFTP Server

These sections describe how to upload the running configuration or a configuration file stored on a Flash device to a TFTP server:

• Preparing to Upload a Configuration File to a TFTP Server

• Uploading a Configuration File to a TFTP Server

Preparing to Upload a Configuration File to a TFTP Server

Before you attempt to upload a configuration file to a TFTP server, do the following:

• Ensure that the workstation acting as the TFTP server is configured properly. On a Sun workstation, make sure that the /etc/inetd.conf file contains this line:

tftp dgram udp wait root /usr/etc/in.tftpd in.tftpd -p -s /tftpboot
 

Make sure that the /etc/services file contains this line:

tftp 69/udp

---

Note You must restart the inetd daemon after modifying the /etc/inetd.conf and /etc/services files. To restart the daemon, either stop the inetd process and restart it, or enter a fastboot command (on the SunOS 4.x) or a reboot command (on Solaris 2.x or SunOS 5.x). Refer to the documentation for your workstation for more information on using the TFTP daemon.

---

• Ensure that the switch has a route to the TFTP server. The switch and the TFTP server must be in the same subnetwork if you do not have a router to route traffic between subnets. Check connectivity to the TFTP server using the ping command.

• You might need to create an empty file on the TFTP server before uploading the configuration file. To create an empty file, enter the touch filename command, where filename is the name of the file you will use when uploading the configuration to the server.

• If you are overwriting an existing file (including an empty file, if you had to create one), ensure that the permissions on the file are set correctly. Permissions on the file should be world-write.

Uploading a Configuration File to a TFTP Server

Use this procedure to upload a configuration file from a switch to a TFTP server for storage:

Step 1 Log into the switch through the console port or a Telnet session.

Step 2 Upload the switch configuration to the TFTP server with the copy config tftp command. Specify the IP address or host name of the TFTP server and the destination filename.

The file is uploaded to the TFTP server.

This example shows how to upload the running configuration to a TFTP server for storage:

Console> (enable) copy config tftp
IP address or name of remote host []? 172.20.52.3
Name of file to copy to []? cat6000_config.cfg
 
Upload configuration to tftp:cat6000_config.cfg, (y/n) [n]? y
.....
..........
.......
 
..........
...........
..
/
Configuration has been copied successfully.
Console> (enable)
Console> (enable)

Clearing the Configuration

To clear the configuration on the entire switch, perform this task in privileged mode:

Task	Command
Clear the switch configuration.	clear config all

This example shows how to clear the configuration for the entire switch:

Console> (enable) clear config all
This command will clear all configuration in NVRAM.
This command will cause ifIndex to be reassigned on the next system startup.
Do you want to continue (y/n) [n]? y
........
.............................
 
System configuration cleared.
Console> (enable)
 
 

To clear the configuration on an individual module, perform this task in privileged mode:

Task	Command
Clear the configuration for a specific module.	clear config mod_num

This example shows how to clear the configuration on a specific module:

Console> (enable) clear config 2
This command will clear module 2 configuration.
Do you want to continue (y/n) [n]? y
.............................
Module 2 configuration cleared.
Console> (enable)

Posted: Wed Nov 10 13:08:32 PST 1999
Copyright 1989-1999©Cisco Systems Inc.