Table Of Contents
Command Description Conventions
Command Reference
This appendix summarizes the Wireless LAN Solution Engine's command line interface (CLI) commands. When you make a configuration change using these commands, the system configuration is updated immediately.
This appendix contains the following sections:
•
1. This command is also available in the maintenance image.
•
Using the CLI
You can use the CLI by:
•
•
CLI Conventions
The command-line interface (CLI) uses the following conventions:
•
•
•
Do not confuse the WLSE's CLI with the IOS CLI. Though they are similar, they are not identical.
Command Privileges
Access to CLI commands is controlled by your user account privilege level. Users with privilege level 15 can use all commands. Users with privilege level 0 can use only a subset of the commands. The command descriptions in this appendix are organized by privilege level. For more information about user accounts and privileges, refer to Administering Users.
Checking Command Syntax
The user interface provides several types of responses to incorrect command entries:
•
•
•
In addition, some commands have command-specific error messages that notify you that a command is valid, but that it cannot run correctly.
Command History Feature
The CLI provides a command history feature. To display previously entered commands, press the up arrow key. After pressing the up arrow key, you can press the down arrow key to display the commands in reverse order. To run a command, press the Enter key while the command is displayed on the command line. You can also edit commands before pressing the Enter key.
Help for CLI Commands
You can obtain help using the following methods:
•
•
–
–
The help contains command usage information and syntax.
1. This command is also available in the maintenance image.
2. This command is available only in the maintenance image.
Command Description Conventions
Command descriptions in this document and in the CLI help system use the following conventions:
•
•
•
•
•
Privilege Level 0 Commands
This section describes the privilege level 0 commands.
exit
To log out of the system, use the exit command.
exit
Syntax Description
This command has no arguments or keywords.
Example
The following command logs you out of the system:
exitping
To send ICMP echo_request packets for diagnosing basic network connectivity, use the ping command.
ping [-c count] [-i wait] [-s packetsize] [-n] {hostname | ip-address}
Syntax Description
c Sets the number of echo packets to send.
count Number of echo packets to send.
i Sets the amount of time to wait between sending each packet.
wait Amount of time to wait between sending each packet, in seconds. The default is 1.
s Sets the size of each echo packet.
packetsize The size of each echo packet, in bytes. The default is 56.
hostname Host name of system to ping.
ip-address IP address of system to ping.
n Disables reverse DNS lookup.
Usage Guidelines
To use this command with the hostname argument, DNS must be configured on the system. To force the time-out of a nonresponsive host or to eliminate a loop cycle, press Ctrl-c.
Example
This command sends 4 echo packets to the host otherhost with a wait time of
5 seconds between each packet:ping -c 4 -i 5 209.165.200.224PING 209.165.200.224 (209.165.200.224) from 209.165.201.0 : 56(84) bytes of data.64 bytes from dns-sj1.cisco.com (209.165.200.224): icmp_seq=0 ttl=246 time=16.3 ms64 bytes from dns-sj1.cisco.com (209.165.200.224): icmp_seq=1 ttl=246 time=2.0 ms64 bytes from dns-sj1.cisco.com (209.165.200.224): icmp_seq=2 ttl=246 time=2.1 ms64 bytes from dns-sj1.cisco.com (209.165.200.224): icmp_seq=3 ttl=246 time=2.1 msshow clock
To display the system date and time in Coordinated Universal Time (UTC), use the show clock command.
show clock
Syntax Description
This command has no arguments or keywords.
Usage Guidelines
Use the show clock command to display the system date and time. For more information about the system time, see the section "Setting System Date and Time" in the Installation and Configuration Guide for the Cisco 1105 Wireless LAN Solution Engine.
Example
This command displays the system date and time:
show clock12:43:47 Jun 20 2001Related Commands
clock
ntp server
show domain-name
To display the system domain name, use the show domain-name command.
show domain-name
Syntax Description
This command has no arguments or keywords.
Example
This command displays the system domain name:
show domain-namecisco.comshow interfaces
To display information about the system network interface, use the show interfaces command.
show interfaces
Syntax Description
This command has no arguments or keywords.
Example
This command displays information about system network interfaces:
show interfaceseth0 Link encap:Ethernet HWaddr 00:02:B3:35:FD:CCinet addr:209.165.200.224 Bcast:209.165.201.0 Mask:255.255.255.224UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1RX packets:80309 errors:0 dropped:0 overruns:0 frame:0TX packets:22451 errors:0 dropped:0 overruns:0 carrier:0collisions:0 txqueuelen:100Interrupt:5 Base address:0xef00 Memory:d0c7e000-d0c7ec40Related Commands
interface
show process
To display information about processes running on the system (including the status of the database), use the show process command.
show process [page]
Note
Syntax Description
page Displays command output one screen at a time. Press the Return key to display the next output screen. Press Ctrl-c to exit paged output and return to the command prompt.
Example
This command displays information about processes running on the system:
show process pagePID PPID ELAPSED SZ STARTED TTY COMMAND1 0 4-20:04:35 277 Fri Jun 15 16:54:03 2001 ? init2 1 4-20:04:35 0 Fri Jun 15 16:54:03 2001 ? kflushd3 1 4-20:04:35 0 Fri Jun 15 16:54:03 2001 ? kupdate4 1 4-20:04:35 0 Fri Jun 15 16:54:03 2001 ? kpiod5 1 4-20:04:35 0 Fri Jun 15 16:54:03 2001 ? kswapd6 1 4-20:04:28 0 Fri Jun 15 16:54:10 2001 ? kreiserfsd81 1 4-20:04:25 0 Fri Jun 15 16:54:13 2001 ? kreiserfsd82 1 4-20:04:25 0 Fri Jun 15 16:54:13 2001 ? kreiserfsd83 1 4-20:04:25 0 Fri Jun 15 16:54:13 2001 ? kreiserfsd84 1 4-20:04:25 0 Fri Jun 15 16:54:13 2001 ? kreiserfsd85 1 4-20:04:24 0 Fri Jun 15 16:54:14 2001 ? kreiserfsd199 1 4-20:04:23 290 Fri Jun 15 16:54:15 2001 ? watchdog213 1 4-20:04:23 342 Fri Jun 15 16:54:15 2001 ? idled402 1 4-20:04:17 290 Fri Jun 15 16:54:21 2001 ? syslogd411 1 4-20:04:17 360 Fri Jun 15 16:54:21 2001 ? klogd517 1 4-20:04:15 327 Fri Jun 15 16:54:23 2001 ? crond531 1 4-20:04:15 286 Fri Jun 15 16:54:23 2001 ? inetd540 1 4-20:04:14 585 Fri Jun 15 16:54:24 2001 ? sshd585 1 4-20:04:09 842 Fri Jun 15 16:54:29 2001 ? dmgtd.lnx-----------more-----------show version
To display information about the current software on the system, use the show version command.
show version
Syntax Description
This command has no arguments or keywords.
Example
This command displays the current software on the system:
show versionCopyright (c) 1999-2000 by Cisco Systems, Inc.Build Version (166) Mon Jun 11 16:56:23 PDT 2001Uptime: 4 days 20 hours 6 minsLinux/UID32 version 2.2.16-13bipsec.uid32 (gcc version egcs1traceroute
To display the network route to a specified host and identify faulty gateways, use the traceroute command.
traceroute [-f first_ttl] [-m max_ttl] [-w waittime] host [packetlength]
Syntax Description
-f (Optional) Sets the time-to-live used in the first outgoing probe packet.
first_ttl Time-to-live value of the first outgoing probe packet. The default is 1 hop.
-m (Optional) Sets the maximum time-to-live (maximum number of hops) used in outgoing probe packets.
max_ttl Maximum time-to-live for outgoing probe packets. The default is 30 hops.
-w (Optional) Sets the time to wait for a response to a probe, in seconds.
waittime Time to wait for a response to a probe, in seconds. The default is 5.
host Name or IP address of host to which to connect.
packetlength (Optional) The length of the packet to send, in bytes. The default and minimum value is 40.
Usage Guidelines
Use the traceroute command to trace the network route to a specified host and identify faulty gateways. The command displays a list of the hosts that receive probe packets as they travel to the destination host, in the order that the receiving hosts receive the packets. Asterisks (*) appear as the list entry for hosts that do not respond to probing correctly.
Example
This command displays the network route to the host otherhost with a packet time-to-live value of 2, a wait time of 5 seconds, and 50-byte packets:
traceroute -m 20 -w 10 cisco.com 50traceroute to example.com (209.165.200.224), 20 hops max, 50 byte packets1 ex1.com (209.165.200.225) 0.981 ms 0.919 ms 0.926 ms2 ex2.com (209.165.200.254) 1.528 ms 0.747 ms 0.661 ms3 ex3.com (209.165.200.255) 0.887 ms 0.770 ms 0.744 ms4 ex4.com (209.165.201.0) 0.932 ms 0.789 ms 0.679 ms5 ex5.com (209.165.201.1) 1.066 ms 1.052 ms 0.983 ms6 ex6.com (209.165.201.30) 1.472 ms 1.247 ms 1.847 ms7 ex7.com(209.165.201.31) 1.738 ms 1.424 ms 1.658 ms8 ex8.com (209.165.202.128) 3.728 ms 2.429 ms 2.804 ms9 ex9.com (209.165.202.129) 6.283 ms 5.499 ms 3.285 ms10 ex10.com (209.165.202.158) 9.926 ms 73.463 ms 3.895 ms11 ex11.com (209.165.202.159) 70.967 ms * 47.106 msRelated Commands
ping
Privilege Level 15 Commands
This section describes the privilege level 15 commands. Only users with privilege level 15 can run these commands.
auth
Use the auth command to enable secure remote authentication.
auth {cli | http} {local | tacacs secret server1 [server2] | radius secret server1 [server2] | nt domain pdc [bdc]}
Syntax Description
cli Enables authentication using the Command Line Interface (CLI).
http Enables authentication using Hypertext Transfer Protocol (HTTP).
local Enables local authentication.
tacacs Enables authentication using the Terminal Access Controller Access Control System (TACACS).
radius Enables authentication using Remote Dial-In User Service (RADIUS).
nt Enables authentication from an NT domain controller.
secret Shared secret code of server.
server1 IP address or device name of server from which authentication will occur.
server2 IP address or device name of optional secondary server from which authentication could occur
domain NT domain name.
pdc Name of the Primary Domain Controller (PDC).
bdc Name of the Backup Domain Controller (BDC).
Example
This command enables secure remote authentication from a remote server, using TACACS.
auth http tacacs tr5e43 209.165.200.224backup
Use the backup command to back upthe WLSE.
backup [test]
Syntax Description
test Tests the configured backup hostname, username, password, and directory.
Usage Guidelines
To back up the WLSE, use the backup command. To configure the backup location, use the backupconfig command.
Example
The following command backs up the WLSE:
backupRelated Commands
backupconfig
listbackup
restore
show backupconfig
backupconfig
Use the backupconfig command to set the configuration for all backup and restore operations. To clear the backup and restore configuration information, use the no backupconfig command.
backupconfig {hostname} {username} {password} [directory]
no backupconfig
Syntax Description
hostname Host name or IP address of the host system.
username Username of host system.
password Password of the host system.
directory Path to specific backup directory, if different from user's default directory.
Usage guidelines
To set the configuration for all backup and restore operations, use the backup command.
Example
The following command will configure the backup and restore operations to backup to and restore from host 209.165.200.224, set the username to user1, and set the password to pass:
backupconfig 209.165.200.224 user1 passThe following command clears all backup and restore configuration information:
no backupconfigRelated Commands
backup
listbackup
restore
show backupconfig
cdp
Use the cdp command to configure the Cisco Discovery Protocol
cdp {run [port] | timer seconds | holdtime seconds}
no cdp {run [port] | timer | holdtime}
Syntax Description
run start cdp
timer set cdp packets retransmission time.
holdtime set cdp packet info hold time.
port Ethernet port on which CDP will be enabled. Acceptable values are eth0-15.
seconds amount of time, in seconds, that the system takes to either transmit the cdp packet information or to hold another system's cdp packet information.
Usage Guidelines
Cisco Discovery Protocol (CDP) is a protocol by which one Cisco device can recognize, and be recognized by, another Cisco device. The run command starts the system sending out signals to the other systems. The timer command sets the amount of time, in seconds, that these signals are sent. The holdtime sets the amount of time a system will recognize another system without receiving a signal. For example, if your system's holdtime is set to 30 seconds, and another system that has already been recognized by yours does not send a signal within that
30 seconds, your system will cease to recognize it. If you are using the no cdp command, the timer and holdtime commands set their respective values to the default value.Example
This command sets the cdp packet's retransmission time at 10 seconds.
cdp timer 10This command sets the cdp packet's retransmission to its default time.
no cdp timerclock
To set the system date and time, use the clock command. See the Usage Guidelines before using this command.
clock {set hh:mm:ss month day year}
Syntax Description
set Sets the system clock.
hh:mm:ss Current time (for example, 13:32:00).
month Current month. You can enter full month names or abbreviations that include at least the first 3 characters of the month name (for example, jan, feb, mar).
day Day of the month (for example, 1 to 31).
year Current year (for example, 2000).
Usage Guidelines
When resetting the time, you must stop and restart WLSE services. Otherwise, scheduled configuration and firmware jobs will not run properly. To reset the time:
Step 1
services stopStep 2
Step 3
services startTo set the date and time, use the set option.
If you configure the system to use Network Time Protocol (NTP), you do not need to set the system clock manually using the clock command.When setting the clock, enter the current time in Coordinated Universal Time (UTC).
For more information about the system time, refer to "Setting System Date and Time" in the Installation and Configuration Guide for the Cisco 1105 Wireless LAN Solution Engine.
Example
This command sets the date and time:
clock set 16:00:00 dec 11 2001Tue Dec 11 16:00:00 UTC 2001Related Commands
ntp server
show clock
df
To display the current storage usage on the WLSE, use the df command.
df
Usage Guidelines
This command in primarily intended as a debugging tool for problems with full partitions.
Example
The following command displays the current storage usage on the WLSE:
dfFilesystem Size Used Avail Use% Mounted on/dev/sda12 151M 59M 92M 39% //dev/sda1 49M 2.8M 44M 6% /boot/dev/sda7 985M 24M 911M 3% /extra/dev/sda8 601M 32M 569M 5% /home/dev/sda6 1001M 136M 865M 14% /opt/dev/sda13 9.7G 32M 9.7G 0% /tftpboot/dev/sda9 601M 32M 569M 5% /tmp/dev/sda10 591M 212M 350M 38% /usr/dev/sda5 2.9G 450M 2.5G 15% /varerase config
To erase the configuration in flash memory and reload the software, use the erase config command.
erase config
Syntax Description
This command has no arguments or keywords.
Usage Guidelines
Use this command to erase the configuration in flash memory and reload the WLSE software.
When you enter the command, you are prompted for confirmation. Enter yes to confirm, or press Enter to accept the default response no.
Caution
When the system reboots, you must reconfigure it with the setup program. For information about using the setup program, refer to the Installation and Configuration Guide for the Cisco 1105 Wireless LAN Solution Engine.
Example
This command erases the system configuration:
erase configThis will erase your configuration, return device to factory defaults, and reload the deviceDo you want to continue?[no]:yesfirewall
To implement port filtering on the WLSE, use the firewall command.
firewall eth <0-5> [public | private] | [icmp telnet ssh snmp https 1741]
Syntax Description
eth <0-5> Port to be configured. Acceptable values are eth0-5.
public Denies access via ICMP, Telnet, SNMP, and the HTTP 1741 port.
private Denies no access.
icmp Denies Internet Control Message Protocol (ICMP) ping messages.
telnet Denies incoming Telnet connections.
ssh Denies incoming SSH connections.
snmp Denies incoming SNMP requests.
https Denies all connections to the SSL HTTP port.
1741 Denies all connections to the HTTP 1741 port.
Usage Guidelines
Use the firewall command to implement port filtering on the WLSE. To configure an Ethernet port for secured public access, use the public option. To configure an Ethernet port for local access, via a LAN or VLAN, use the private option. To dissable icmp, Telnet, ssh, snmp, https, or to deny connections to the SSL HTTP port or the HTTP 1741 port, use its corresponding option.
Examples
•
firewall eth0 public ssh 1741•
firewall eth1 privateAn on-site user has full access to the WLSE, but an external user can only access it using a secure connection.
gethostbyname
Use the gethostbyname command to display the IP address of a known domain name.
gethostbyname host
Syntax Description
host Domain name of host.
Example
This command displays the IP address of example.com
gethostbyname example.com209.165.200.224hostname
To change the system hostname, use the hostname command.
hostname name
Syntax Description
name New hostname for the WLSE; the name is case-sensitive and may be from 1 to 22 alphanumeric characters (A-Z, a-z, and 0-9 only).
Example
The following example changes the hostname to sandbox:
hostname sandboximport
To import host files, or to map IP addresses to hostnames, use the import command:
import {host hostname ipaddress} | {hosts ftp-host username password path}
no import {host hostname ipaddress} | {hosts}
Syntax Description
host Maps one IP address to a hostname.
hostname Hostname to map IP address to.
hosts Imports host files from ftp accessible host.
ipaddress IP address to map Hostname to.
password Password used to access ftp accessible host.
path Path to ftp accessible host.
ftp-host IP address of ftp accessible host.
username username use to access ftp accessible host.
Usage Guidelines
To map a single hostname to an IP address, enter the import command as follows
import host hostname ipaddress
To import host files from an external, ftp accessible server, enter the import command as follows:
import hosts ftp-host username password path
To remove an individual IP address from a host file, use the no version of the import command as follows:
no import host hostname ipaddress
To remove an imported host file, use the no version of the import command as follows:
no import hosts
Example
This command imports host files from the ftp accessible server ftpserver_1. Ftpserver_1 has the username admin, the password pass, and the path /ftpserver_1/hosts.
import hosts ftpserver_1 admin pass /ftpserver_1/hostsThis command deletes the hosts imported in the example above:
no import hostsinstall configure
To define the repository that the Wireless LAN Solution Engine uses to install software updates and images, use the install configure command.
install configure {URL URL Value | default | save}
Syntax Description
URL Sets the URL of the repository.
URL Value The URL of the repository. The URL should take the form of http://host:port/path (the path is not a requirement).
default Configures the Wireless LAN Solution Engine to be its own repository. The URL is http://localhost:9851.
save Saves the current configuration in the install.ini file.
Usage Guidelines
The install configure command defines the repository that the Wireless LAN Solution Engine uses. A repository is a remote or local server from where a system can download software updates and images. Only HTTP is supported.
Example
The following command configures the Wireless LAN Solution Engine to use http://209.165.200.22, with port 9851, as a repository:
install configure URL http://209.165.200.224:9851Related Commands
install list
To list software updates and images currently available on the configured repository, use the install list command.
install list [all | full | page | updates]
Syntax Description
all Displays all software updates and images on a configured repository. This command displays the name, the version, the requirements, the type, and a summary of the software.
full Displays only the complete images on a configured repository.This command displays the name, the version, the requirements, the type, and a summary of the image.
page Displays only the names of all software updates and images on a configured repository. All other information is omitted.
updates Displays only the updates on a configured repository. This command displays the name, the version, the requirements, the type, and a summary of the update.
Usage Guidelines
The install list command displays software updates and images currently available on a repository. A repository is a remote or local server from where a system can receive software.
Example
Enter the following command to display a list of all available software updates and images on a configured repository:
install list allName Version Requires Type SummaryEX-1.02 1.02 HSE-1.0 UPDATE Hosting Solution...EX-1.1aR 1.1aR HSE-1.1 UPDATE Hosting Solution...EX-1.1a 1.1a HSE-1.1 UPDATE Hosting Solution...EX-1.0a 1.0a HSE-1.0 UPDATE Hosting Solution...EX-1.0aR 1.0aR HSE-1.0 UPDATE Hosting Solution...EX-1.0-ROB 1.0 HSE-1.0 COMPLETE Hosting Solution...EX-1.0 1.0 HSE-1.0 COMPLETE Hosting Solution...Related Commands
install update
To install a software update or image, use the install update command.
install update package name
Syntax Description
Package Name Name of the software update or image to be installed. To see the names of software updates and images available for installation, use the install list command. For more information, see the "install list" section.
Example
The following command installs the update EX-2.0:
install update EX-2.0Related Commands
interface
To configure an Ethernet interface, use the interface command.
interface eth<0-5> {[up | down] | ipaddress netmask [default-gateway address] [up | down]}
Syntax Description
eth<0-5> Name of the interface port to be configured. Acceptable values are eth0-5.
up Enables the interface (the default).
If you include the ipaddress parameter and want to enable the interface in the same command, either enter the up parameter after ipaddress and its required parameters, or do not specify the up or down parameters (up is the default).
down Disables the interface.
If you include the ipaddress parameter and want to disable the interface in the same command, enter the down parameter after ipaddress and its required parameters.
ipaddress The IP address of the interface.
netmask The netmask of the interface IP address.
default-gateway Changes the IP address of the default gateway that connects the WLSE to the network.
address The gateway IP address.
Default
When you enter the interface command, the interface that you specify is enabled by default. If you want to disable an enabled interface or leave a disabled interface disabled, you must specify the down option.
Usage Guidelines
Use the interface command to configure an Ethernet interface.
If you change the IP address or hostname, follow these steps to ensure that applications using the system can connect to it correctly:
Step 1
# services stop# services startStep 2
Step 3
Example
This command disables the Ethernet 1 interface:
interface eth1 downThis command sets the Ethernet 0 IP address, netmask, and gateway IP address:
interface eth0 209.165.200.224 255.255.255.224 default-gateway 209.165.201.31 upip domain-name
To define a default domain name, use the ip domain-name command. To remove the default domain name, use the no form of the command.
ip domain-name name
no ip domain-name name
Syntax Description
name Domain name (e.g. cisco.com).
Usage Guidelines
Use this command to define a default domain name.
A default domain name allows the system to resolve any unqualified host names. Any IP hostname that does not contain a domain name will have the configured domain name appended to it. If you are using a DNS server, this appended name is resolved by the DNS server, and then added to the host table.
Example
This command defines the default domain name cisco.com:
ip domain-name cisco.comThis command removes the default domain name:
no ip domain-nameRelated Commands
ip name-server
ip name-server
To specify the addresses of up to three name servers for name and address resolution, use the ip name-server command. To remove a name server, use the no form of the command.
ip name-server ip-address
no ip name-server ip-address
Syntax Description
ip-address Name server IP address (maximum of 3).
Usage Guidelines
Use the ip name-server command to point the system to a specific DNS server. You may configure up to three servers.
If you attempt to configure a fourth name server, the following error message appears:
# Name-server table is full.The system must have a functional DNS server configured to function correctly. If it does not, in most cases it will not correctly process requests from management applications that use it. If the system cannot obtain DNS services from the network, Telnet connections to the system will fail or Telnet interaction with the system will become extremely slow.
Example
This command assigns a name server for the system to use for DNS name to address resolution:
ip name-server 209.165.200.224This command disables the name server; the system will not use it for name to address resolution:
no ip name-server 209.165.200.224Related Commands
ip domain-name
listbackup
Use the listbackup command to list all current backups at the configured site.
listbackup
Syntax Description
This command has no arguments or keywords.
Example
The following command lists all current backups at the configured site:
listbackupex1_06042001_170640: Hostname: ex1 Date: 06042001 time: 1700ex1_06052001_124543: Hostname: ex1 Date: 06052001 time: 1243ex1_06052001_155148: Hostname: ex1 Date: 06052001 time: 1558ex1_06202001_145704: Hostname: ex1 Date: 06202001 time: 1454Related Commands
backup
backupconfig
restore
show backupconfig
To debug and test email settings, use the mail command.
mail [to user@host [debug]]
Usage Guidelines
Entering the mail command with no arguments will allow you to read email. Entering the mail command with the arguments listed will allow you to send email.
Syntax Description
to Sends email to the expressed recipient.
user@host Recipient of the email.
debug Debugs any email problems.
Example
The following command sends an email message:
mail to operator@sj_wlseSubject: testThis is a test mail.Cc:
Note
mailcntrl clear
To delete the maillog, sendqueue, or userqueue, use the mailcntrl clear command.
mailcntrl clear {log | sendqueue | userqueue}
Syntax Description
log Clears the WLSE's email log.
sendqueue Clears the WLSE's sendqueue.
userqueue Clears the WLSE's userqueue.
Example
The following command clears the WLSE's email log.
mailcntrl clear logRelated Commands
mailcntrl list
To list the size of the userlog, userqueue, or the sendqueue, use the mailcntrl list command.
mailcntrl list {logsize | sendqueuesize | userqueuesize}
Syntax Description
logsize Size of the mail log.
sendqueuesize Size of the sendqueue.
userqueuesize Size of the userqueue.
Example
The following command displays the size of the WLSE's email log.
mailcntrl list logsizeMail log files total size: 4.0kRelated Commands
mailroute
To forward email to a specified SMTP server, use the mailroute command to specify the server. If no server is specified, the WLSE will use DNS to resolve the correct email server in your local domain. To stop forwarding mail to the SMTP server, use the mailroute command followed by a blank space.
mailroute {hostname | ip-address}
Syntax Description
hostname Host name of an email server.
ip-address IP address of an email server.
Example
The following command forwards email to a server with the hostname mailserver:
mailroute mailservernslookup
To translate a device name to its IP address or an IP address to its device name, use the nslookup command.
nslookup {dns-name | ip-address}
Syntax Description
dns-name Device name of a host on the network.
ip-address IP address of a host on the network.
Example
The following command translates the device name hostname to its IP address:
nslookup hostnameServer: dns.ex1.comAddress: 209.165.200.224Name: ex1.comAddress: 209.165.201.0ntp server
To configure the Network Time Protocol (NTP) and allow the system clock to be synchronized by a time server, use the ntp server command. To disable this function, use the no form of this command.
ntp server ip-address
no ntp server ip-address
Syntax Description
ip-address IP address of the NTP time server providing clock synchronization.
Usage Guidelines
Use the ntp server command to synchronize the system clock with the specified NTP server. If you configure multiple NTP servers, the system will synchronize with the first working NTP server it finds. There is no limit to the number of NTP servers that you can configure.
The ntp server command validates the NTP server that you specify. The possible results are:
•
# 19 Jan 00:43:48 ntpdate[1437]: step time server 209.165.200.224 offset 999.257304•
# 19 Jan 00:43:40 ntpdate[1431]: no server suitable for synchronization foundIn this case, remove the NTP server by using the no form of the command, then configure a valid NTP server.
•
# 19 Jan 00:43:58 ntpdate[1265]: Can't adjust the time of day: Invalid argument.In this case, the ntp server command is entered into the system configuration, but NTP will not function. Follow these steps to remove the command and configure NTP correctly:
Step 1
no ntp server ip-addresswhere ip-address is the IP address of the NTP server.
Step 2
Step 3
ntp server ip-address
Example
This command configures the system to use an NTP server:
ntp server 209.165.201.0This command configures the system to stop using the NTP server:
no ntp server 209.165.201.0Related Commands
clock
reload
To reboot the system, use the reload command.
reload
Syntax Description
This command has no arguments or keywords.
Usage Guidelines
Use the reload command to reboot the system.
You are prompted to verify the reload. Enter yes to confirm or no to cancel the reload.
Caution
Example
This command reboots the system:
reloadRelated Commands
shutdown
reinitdb
To reinitialize the database, use the reinitdb command.
reinitdb
Syntax Description
This command has no arguments or keywords.
Usage Guidelines
The reinitdb command reinitializes the database. This erases all information contained within the database.
Example
This command reinitializes the database:
reinitdbrepository
To configure the Wireless LAN Solution Engine to be a repository server, use the repository command.
repository source URL
Syntax Description
source Sets the location from where the local repository downloads software updates and images.
URL The IP address of an external server containing software updates and images.
Usage Guidelines
The repository command allows the Wireless LAN Solution Engine to be a repository both for itself and for external systems. A repository is a remote or local server from where a system can receive software updates and images.
The repository command only configures the Wireless LAN Solution Engine to be a repository. To configure the Wireless LAN Solution Engine to install software updates and images from this repository, see the "install configure" section.
Example
To configure the Wireless LAN Solution Engine to be a repository, and to download software updates and images from http:// 209.165.200.224, enter the following command:
repository source ftp://209.165.200.224Related Commands
repository add
To transfer software updates and images from a remote server to the Wireless LAN Solution Engine's local repository, use the repository add command.
repository add package
Syntax Description
package Name of the software update or image to be transferred.
Usage Guidelines
The repository add command transfers software updates and images from a remote server to the Wireless LAN Solution Engine's local repository. You will be prompted to enter a username and password if they are needed to access the remote server.
Example
To transfer the update EX_2.0 from an update server to the local repository, enter the following command:
repository add ex_2.0Related Commands
repository delete
To delete software updates and images on the Wireless LAN Solution Engine's local repository, use the repository delete command.
repository delete [package | all]
Syntax Description
all Deletes all software updates and images in the local repository.
package Name of the software update or image to be deleted.
Usage Guidelines
The repository delete command deletes software updates and images on the Wireless LAN Solution Engine's local repository. A repository is a remote or local server from where a system can receive software updates and images.
Example
The following command deletes the update EX_2.0 from the local repository:
repository delete EX_2.0Related Commands
repository list
To list software updates and images on the configured local or remote repository, use the repository list command.
repository list {local | remote} [detail] [page]
Syntax Description
local Lists software updates and packages on the local repository.
remote Lists software updates and packages on a remote repository.
detail Includes details of the software updates and images displayed.
page Displays the software updates and packages on page at a time.
Example
To list the software updates and images available on the configured local repository, with details and one page at a time, enter the following command:
repository list local detail pageRelated Commands
repository server
To start, stop, or view the status of the Wireless LAN Solution Engine's local repository, use the repository server command.
repository server [stop | start | status]
Syntax Description
stop Stops the local repository.
start Starts the local repository.
Status Displays the status of the local repository.
Usage Guidelines
The repository server command starts, stops, or displays the status of the Wireless LAN Solution Engine's local repository. A repository is a remote or local server from where a system can receive software updates and images.
Example
The following command stops the local repository:
repository server stopRelated Commands
restore
Use the restore command to restore a backed up configuration of the WLSE.
restore restore name
Syntax Description
restore name Name of backup to be used to restore the WLSE.
Usage Guidelines
To restore a configuration, use the restore command. If you use the restore command all current domains, roles, users, and discovery configuration information will be erased.
Example
The following command will restore a backed up configuration:
re
