Cisco Cisco Packet Data Gateway (PDG)
StarOS Operation and Configuration
▀ Understanding Configuration Files
▄ VPC-VSM System Administration Guide, StarOS Release 19
34
Understanding Configuration Files
StarOS supports the use of a file or script to modify configurable parameters. Using a file for offline system
configuration reduces the time it takes to configure parameters on multiple systems.
configuration reduces the time it takes to configure parameters on multiple systems.
A StarOS configuration file is an ASCII text file that contains commands and configuration parameters. When you
apply the configuration file, StarOS parses through the file line-by-line, testing the syntax and executing the command.
If the syntax is incorrect, a message is displayed to the CLI and StarOS proceeds to the next command. Lines that begin
with # are considered remarks and are ignored.
apply the configuration file, StarOS parses through the file line-by-line, testing the syntax and executing the command.
If the syntax is incorrect, a message is displayed to the CLI and StarOS proceeds to the next command. Lines that begin
with # are considered remarks and are ignored.
Important:
Pipes ( | ), used with the grep and more keywords, can potentially cause errors in configuration file
processing. Therefore, StarOS automatically ignores keywords with pipes during processing.
Important:
Always save configuration files in UNIX format. Failure to do so can result in errors that prevent
configuration file processing.
The commands and configuration data within the file are organized and formatted just as they would be if they were
being entered at the CLI prompt. For example, if you wanted to create a context called source in the CLI, you would
enter the following commands at their respective prompts:
being entered at the CLI prompt. For example, if you wanted to create a context called source in the CLI, you would
enter the following commands at their respective prompts:
[local]host_name# config
[local]host_name(config)# context source
[wsg]host_name(config-ctx)# end
To create a context called source using a configuration file, you would use a text editor to create a new file that consists
of the following:
of the following:
config
context source
end
There are several important things to consider when using configuration files:
StarOS automatically applies a configuration file at the end of the boot process. After StarOS boots up for the
first time, a configuration file that you have created and that is tailored to your network needs, can be applied.
To make StarOS use your configuration file, modify StarOS boot parameters according to the instructions
located in the StarOS Management Operations chapter.
To make StarOS use your configuration file, modify StarOS boot parameters according to the instructions
located in the StarOS Management Operations chapter.
In addition to being applied during the boot process, you can also apply configuration files manually at any time
by executing the appropriate commands at the CLI prompt. Refer to the instructions in the StarOS Management
Operations chapter.
Operations chapter.