Command File; Command File Description - Symbol WS5000 Series System Reference Manual

3-2
WS5000 Series Switch System Reference Guide

3.1 Command File

The command file option specifies a valid filename for an ASCII text format file that exists on the TFTP server
and contains site-specific settings for the wireless switch. The command file (see
page 3-7) directs the switch to perform the following remote configuration functions:
• Load a new wireless switch configuration file
• Reconfigure the Ethernet IP, DNS, gateway, and DHCP settings on the switch
• Reconfigure the master and slave Kerberos settings.
• Manually or automatically update Kerberos user database entries, with automatic propagation to the
slave KDC, if present
• Enable or disable "hot standby" mode on the switch
• Optionally provide status and error logging of the automatic configuration operations
• Reconfiguration of Primary and Standby settings
• Reconfiguration of Master and Slave Kerberos settings.
Several site-specific settings are available in the command file. The settings available in the command file
include:
• Automatic installation command event logging
• Automatic installation command file TFTP server
• Automatic installation command file network

3.2 Command File Description

The command file is an ASCII text file that contains case sensitive letters, digits, and the underscore (_)
character. The command file name uses the .sym extension. The command file contains all options necessary
to perform a limited switch configuration or reconfiguration.
When the system parses this file, it ignores any option that it does not understand. The switch keeps the
current configuration for that specific option unchanged. The following lines are considered equivalent.
#<option> <value>
<option> #<value>
<option> #some comment
All values of the command file are case insensitive except for SNMP community strings, domain names,
realms, and filenames. The system converts the hostname value into lowercase even when specified using a
combination of lower/upper case. The command file option items do have to be in any sequential order.
A template of the command file, called cmd_template.sym, is available and located on the WS5000 Wireless
Switch system CD. Copy this file to a local host computer, then edit, save and rename it to serve as a command
file (the .sym extension is required for the command file to be recognized by the wireless switch).
Save the file to the system used to configure the wireless switch. Use the CLI copy tftp system command (see
the copy command on Chapter 8, CLI Command
to the switch.
The command file example shows the configuration of most options (see
Reference) to copy the command file from the host computer
Command File Example on page
Command File Example on
3-7).