Proxim AP-2000 User Manual
179
Using the Command Line Interface (CLI)
CLI Batch File
A CLI Batch file is a user-editable configuration file that provides a user-friendly way to change the AP configuration
through a file upload. The CLI Batch file is an ASCII file that facilitates Auto Configuration because it does not require
the user to access one of the AP’s management interfaces to make configuration changes as is required with the
proprietary TLV format configuration file.
The CLI Batch file does not replace the existing TLV format configuration file, which continues to define the
configuration of the AP.
The CLI Batch file contains a list of CLI commands that the AP will execute. The AP performs the commands in the file
immediately after the file is uploaded to the AP manually or during Auto Configuration.
The AP parses the file and executes the CLI commands. Commands that do not require a reboot take effect
immediately, while commands that require a reboot (typically commands affecting a wireless interface) will take effect
after reboot.
through a file upload. The CLI Batch file is an ASCII file that facilitates Auto Configuration because it does not require
the user to access one of the AP’s management interfaces to make configuration changes as is required with the
proprietary TLV format configuration file.
The CLI Batch file does not replace the existing TLV format configuration file, which continues to define the
configuration of the AP.
The CLI Batch file contains a list of CLI commands that the AP will execute. The AP performs the commands in the file
immediately after the file is uploaded to the AP manually or during Auto Configuration.
The AP parses the file and executes the CLI commands. Commands that do not require a reboot take effect
immediately, while commands that require a reboot (typically commands affecting a wireless interface) will take effect
after reboot.
Auto Configuration and the CLI Batch File
The Auto Configuration feature allows download of the TLV format configuration file or the CLI Batch file. The AP
detects whether the file uploaded is TLV format or a CLI Batch file. If the AP detects a CLI Batch file (a file with
extension .cli), the AP executes the file immediately.
The AP will reboot after executing the CLI Batch file. Auto Configuration will not result in repeated reboots if the CLI
Batch file contains rebootable parameters.
detects whether the file uploaded is TLV format or a CLI Batch file. If the AP detects a CLI Batch file (a file with
extension .cli), the AP executes the file immediately.
The AP will reboot after executing the CLI Batch file. Auto Configuration will not result in repeated reboots if the CLI
Batch file contains rebootable parameters.
CLI Batch File Format and Syntax
The CLI Batch file must be named with a .cli extension to be recognized by the AP. The maximum file size allowed is
100 Kbytes, and files with larger sizes cannot be uploaded to the AP. The CLI commands supported in the CLI Batch
File are a subset of the legal AP CLI commands.
The follow commands are supported:
•
100 Kbytes, and files with larger sizes cannot be uploaded to the AP. The CLI commands supported in the CLI Batch
File are a subset of the legal AP CLI commands.
The follow commands are supported:
•
Set commands
•
Reboot command (the reboot command ignores the argument (time))
•
Passwd command
Each command must be separated by a new line. Refer to Appendix A, CLI Command Reference for detailed
command syntax.
command syntax.
NOTE
The following commands are not supported: Show command, Debug command, Undebug command, Upload
command, Download command, Kill command, and the Exit, Quit, and Done commands.
command, Download command, Kill command, and the Exit, Quit, and Done commands.
Sample CLI Batch File
The following is a sample CLI Batch File:
set sysname system1
set sysloc sunnyvale
set sysctname contact1
set sysctphone 1234567890
set sysctemail email@domain.com
set ipaddr 11.0.0.66
set ipaddrtype static
set ipsubmask 255.255.255.0
set ipgw 11.0.0.1
set wif 4 autochannel disable
set wif 4 mode 1
set syslogstatus enable
set sysloghbstatus enable
set sysloghbinterval 5
set wif 4 netname london
reboot
set sysname system1
set sysloc sunnyvale
set sysctname contact1
set sysctphone 1234567890
set sysctemail email@domain.com
set ipaddr 11.0.0.66
set ipaddrtype static
set ipsubmask 255.255.255.0
set ipgw 11.0.0.1
set wif 4 autochannel disable
set wif 4 mode 1
set syslogstatus enable
set sysloghbstatus enable
set sysloghbinterval 5
set wif 4 netname london
reboot