Introduction
64
CopperLink CL2300 User Manual
9
• Configuration File Handling
Introduction
This chapter describes how to upload and download configuration files to and from a CL2300. A configura-
tion file is a batch file of Trinity commands used in the software modules that perform specific functions of the
CL2300. This chapter also describes some aspects of configuration file management. Refer to chapter 8,
59 for more information.
This chapter includes the following sections:
•
Shipping configuration (see page
•
Configuration file handling task list (see page
All Patton devices are shipped with a configuration file installed in the factory, which is stored in their flash
memory.
A configuration file is like a script file containing Trinity commands that can be loaded into the system. Con-
figuration files may also contain only partial configurations. This allows you to keep a library of command
sequences that you may want to use as required. By default, the system automatically loads the shipping config-
uration from the flash memory if no user-specific configuration is defined as the startup configuration.
Changing the current running configuration is possible as follows:
You may change the running configuration interactively. Interactive configuring requires that you access the
CLI by using the
enable
command to enter administrator execution mode. You must then switch to the con-
figuration mode with the command
configure
. Once in configuration mode, enter the configuration com-
mands that are necessary to configure your CL2300.
•
You can also create a new configuration file or modify an existing one offline. You can copy configuration files
from the flash memory to a remote server. Transferring configuration files between the flash memory and a
remote system requires the Trivial File Transfer Protocol (TFTP). The TFTP server must be reachable through
one of the CL2300 network interfaces.
See Chapter 7,
on page 47 for information concerning access to the CLI.
The following sections focus on Trinity memory regions and software components that can be copied within
the memory or uploaded/downloaded between a TFTP server and the memory of the CL2300. Refer to chap-
ter 8,
59 for a brief description of how Trinity uses system memory.
Understanding Configuration Files
Configuration files contain commands that are used to define the functionality of Trinity. During system startup,
the command parser reads the factory or startup configuration file command-by-command, organizes the argu-
ments, and dispatches each command to the command shell for execution. If you use the CLI to enter a com-
mand during operation, you alter the running configuration accordingly. In other words, you are modifying a live,
in-service system configuration.
, shows the characteristics of a configuration file. It is stored on a TFTP server in the file
myconfig.cfg
for later download. The command syntax used to enter commands with the CLI and add commands in config-
uration files is identical. For better comprehension, you can add comments in configuration files. To add a line
with a comment to your configuration file, simply begin the line with the hash (#) character. The command
parser skips everything after the hash character to the end of the line.