Professional Documents
Culture Documents
Skypilot Network Administration Guide
Skypilot Network Administration Guide
SkyPilot Trademarks
SkyConnector, SkyControl, SkyExtender, SkyGateway, SkyPilot, SkyPilot Networks, SkyProvision, and the SkyPilot logo are the trademarks and registered trademarks of
SkyPilot Networks, Inc.
GOVERNMENT USE
The following provision applies to United States Government end users. This product is comprised of commercial computer software and commercial computer
software documentation as such terms are used in 48 C.F.R. 12.212 and are provided to the Government (i) for acquisition by or on behalf of civilian agencies,
consistent with the policy set forth in 48 C.F.R. 12.212; or (ii) for acquisition by or on behalf of units of the Department of Defense, consistent with the policies set forth
in 48 C.F.R. 227.7202-1 and 227.7202-3.
Table of Contents
About This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Audience and Purpose . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
How This Guide Is Organized . . . . . . . . . . . . . . . . . . . . . . . . .vii
Conventions Used in This Guide . . . . . . . . . . . . . . . . . . . . . . viii
Chapter 1
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
System Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
About Operations, Administration, and Maintenance (OAM) . . . . . 4
Chapter 2
Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Provisioning Overview . . . . . . . . . .
Provisioning Parameters Overview. . .
Required Provisioning Parameters . . .
Optional Provisioning Parameters . . .
General Provisioning Guidelines . . . .
Manually Provisioning a Device . . . . .
Automatically Provisioning a Network
Chapter 3
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 8
13
15
20
32
32
35
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
42
44
45
46
47
48
Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
Monitoring a Networks Topology by Using SkyControl
Monitoring Alarms . . . . . . . . . . . . . . . . . . . . . . . .
Monitoring Link States . . . . . . . . . . . . . . . . . . . . .
Managing IP Addresses . . . . . . . . . . . . . . . . . . . . .
Using Utilities . . . . . . . . . . . . . . . . . . . . . . . . . . .
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . .
Appendix A
.
.
.
.
.
.
.
Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
Managing Software Images
Managing Customers . . . .
Access Control Lists (ACLs) .
SkyPilot Security Manager .
About the SkyPilot MIB . . .
Reports and Statistics . . . .
Chapter 4
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
52
53
53
54
56
57
Appendix B
Appendix C
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. . 88
. . 91
. . 91
. . 94
. 100
. 103
. 106
. 109
. 112
. 114
. 117
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 124
. 129
. 131
. 136
. 141
Appendix E
.
.
.
.
.
.
.
.
.
.
.
Appendix D
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 144
. 147
. 148
. 153
. 155
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
. 254
. 254
. 260
. 261
. 275
. 276
. 278
Glossary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 279
iv | Table of Contents
Chapter Highlights
Audience and purpose
How this guide is organized
Conventions used in this guide
Administration Guide | v
NOTE
Text Conventions
This guide uses the following text conventions:
Italic is used to introduce new terms.
Bold is used to indicate what you click or type in a graphical user interface (for
example, commands names or text being entered). In examples showing user
interaction with the command-line interface, bold is used to indicate user
input as opposed to command output.
A monospace font is used for code elements (variable names, data values,
function names, and so forth), command lines, scripts, and source code
listings.
Italic-monospace is used for replaceable elements and placeholders
Syntax Conventions
This guide uses the following conventions when showing syntax:
Angle brackets, < and >, enclose mandatory elements. You must enter
these elements. For example:
ping <IP-address>
Square brackets, [ and ], enclose optional elements. You can omit these
elements. For example:
show filter [filter-table-number]
Square brackets are also used to show the current value of parameters in the
output of some commands.
A vertical bar, |, separates choices. For example:
show bridge [cache|port]
1
Introduction
After deploying your SkyPilot network (as described in the Getting Started with the
SkyPilot Network guide), you will need to perform operations, administration, and
maintenance (OAM) tasks to increase performance, stability, and reliability. This
chapter describes these tasks and the tools you use to perform them.
Chapter Highlights
System overview
About operations, administration, and maintenance (OAM)
Administration Guide | 1
System Overview
SkyPilot Networks delivers a wireless, end-to-end broadband solution that
seamlessly supports high-capacity, high-coverage networks. Designed for
managed-access networks and service providers, the SkyPilot network takes
broadband wireless the last mile with a cost-effective, robust infrastructure
solution.
SkyPilot gives carriers an opportunity to expand rapidly into new markets and
extend their offerings to include VoIP and high-bandwidth applications such as
video and location-based services. The SkyPilot solution offers a tipping point for
converting dial-up customers to broadband, and will help drive the growth of
neighborhood hotspots, offering ubiquitous wireless connectivity to local
communities.
Hardware Components
A SkyPilot network includes the following physical components:
SkyGatewayOperates as a base station for your wireless network. It
provides an interface between wired infrastructure and a wireless network of
subscribers who enjoy secure, high-speed access to the Internet or wide area
networks.
A SkyPilot wireless network requires at least one SkyGateway for normal
operations. If desired, you can add additional SkyGateways to increase
network capacity or provide redundancy. The SkyGateway typically resides at
a location that provides easy access to wired infrastructureusually a POP or
data center.
NOTE
2 | Chapter 1 Introduction
through SkyPilots mesh-networking features. SkyExtenders provide a costeffective way to add capacity and balance network loads.
A SkyExtenders Ethernet interface can supply local subscriber service in
addition to wirelessly forwarding data on behalf of other end users.
SkyExtender DualBandCombines SkyPilots long-range, high-capacity
5 GHz mesh backhaul with a high-powered 802.11b/g access point that allows
service providers and municipalities to offer standard Wi-Fi services over great
distances, for targeted hot zones or dense, ubiquitous coverage patterns.
SkyConnectorLinks your subscribers to the SkyPilot wireless network. An
Ethernet interface on the SkyConnector enables connecting to the
subscribers computers or a local area network (via a switch or router).
For information about how the SkyPilot components work together in the various
network topologies, refer to Getting Started with the SkyPilot Network.
Software Components
The software components of a SkyPilot system are:
SkyProvisionA server-based application that automates device
provisioning by enabling devices to get their configuration information from
the SkyPilot EMS server. SkyProvision is also used for updating network node
firmware and for setting device and system configuration options.
SkyControlAn SNMP management system for real-time device
monitoring and management. This software provides a graphical view of your
network topology with at-a-glance updates on topology, routing, and
performance. SkyControl supports both standard and private MIBs.
Third-party applicationsProvided as part of the SkyPilot EMS server
installation. The server package includes open-source versions of FTP, HTTP,
and DHCP servers plus an open-source database for storing device
configuration information. For more information about these third-party
applications, refer to the SkyPilot EMS Installation Guide.
Command-line interfaceA text-based interactive application built into all
SkyPilot devices. This interface enables you to manually provision a device,
retrieve information about the devices status, and do real-time logging.
System Overview | 3
OAM Tasks
A SkyPilot network administrator is usually responsible for the tasks described in
Table 1-1.
Table 1-1. OAM Tasks
Task
Refer To
Creating reports
Troubleshooting
4 | Chapter 1 Introduction
Troubleshooting on page 57
Description
SkyProvision
SkyControl
Command-line
interface
Web-based
command tool
2
Operations
SkyPilot operations tasks include ongoing provisioning and customizing activities.
This chapter describes how to provision SkyPilot devices (either manually or
automatically) and provides guidelines for customizing SkyPilot devices.
Chapter Highlights
Provisioning overview
Provisioning parameters overview
Required provisioning parameters
Optional provisioning parameters
General provisioning guidelines
Manually provisioning a device
Automatically provisioning a network
Administration Guide | 7
Provisioning Overview
Provisioning is the process of customer authorization and service configuration.
When a SkyPilot device is provisioned, it authenticates itself on the network and
downloads the appropriate configuration file containing customer-specific
settings, such as Quality of Service rate limits. This device provisioning is
independent of end-user provisioning, but it can be used to assist with end-user
provisioning by serving IP addresses via DHCP to end-user equipment such as
personal computers and home routers.
Table 2-1 summarizes the steps required to provision a device.
Table 2-1. Device Provisioning Steps
Step
Refer To
Decide whether to
configure the device for
manual or automatic
provisioning.
8 | Chapter 2 Operations
Provisioning Overview | 9
10 | Chapter 2 Operations
Provisioning Overview | 11
12 | Chapter 2 Operations
Mixed Provisioning
If necessary, you can set up a mixed networka SkyPilot network in which
different devices use different provisioning modes. Although a mixed network will
operate normally, individual devices will behave differently depending on the
provisioning mode:
Automatically provisioned devices will establish network links only when
SkyProvision is available to provide configuration information from an EMS
server.
Manually provisioned devices will form network links according to
configuration settings stored in flash memory.
There is no requirement that all devices be configured the same way (automatic
provisioning or any method of manual provisioning). For example, you could use
Command-Line Interface commands to configure or test individual nodes before
adding them to your network.
Req.
Opt.
CLI
acl
auto
buzzer
Web-
Sky-
based
Prov.
Req.
classifier
domain
eth
ip
Web-
Sky-
based
Prov.
manual
netkey
CLI
filter
freq
Opt.
parent
password
power
radar
snmp
timezone
trafficrate
vlan
web
14 | Chapter 2 Operations
Frequency
In order for devices within a SkyPilot network to form links, they must operate on
the same frequencies. You can configure a variety of frequency settings, including
the primary (preferred) frequency, multiple allowed frequencies, and the dwell
time a device waits on its primary frequency before attempting to use a frequency
from its Allow list to achieve successful communications with network nodes.
Which frequencies you can set depends on the device:
SkyGatewayThe frequency over which it will be broadcasting. (For
SkyGateways, this is the primary frequency; the Allow list is ignored.)
SkyExtenders and SkyConnectorsThe primary frequency, as well as the
range of frequencies that the device is allowed to use in its hunting.
SkyExtenders and SkyConnectors dwell on the primary frequency longer than
frequencies in their Allow list.
For manually provisioned devices, you set the frequency by using the set prov
freq command, described on page 190.
For automatically provisioned devices, you modify the frequency settings in the
node profile thats assigned to the device (see Configuring Node Profiles on
page 94).
Domains
A single domain can be defined to encompass your entire SkyPilot network,
including all its nodes. Or domains can be used to segregate a network into two or
more smaller networks, where each smaller network has the same characteristics
as the larger network:
One or more SkyGateways
One or more SkyConnectors
Any number of SkyExtenders (including none)
NOTE
16 | Chapter 2 Operations
For automatically provisioned devices, you use the Domain Maintenance function
within SkyProvision to add, modify, and delete domains (see Configuring
Domains on page 91), and then you apply the domains to node profiles (see
Configuring Node Profiles on page 94).
18 | Chapter 2 Operations
TIP
For a manually provisioned device, you configure its VLAN by using the
command-line interface command (see set prov vlan on page 193) or its
Web-based command tool counterpart (see VLAN Page on page 264).
For automatically provisioned devices, you use SkyProvision to add, modify, and
delete VLANs (see Configuring VLANs on page 103).
Ethernet Interface
A nodes 10/100bT Ethernet interface can be enabled or disabled; and its physical
settings configured for autonegotiation or set to full or half duplex, and its speed
set to 100 or 10.
For SkyExtender-only applications (that is, where there is no subscriber interface),
if you do not plan to connect any devices to a SkyExtenders Ethernet interface,
you may want to disable the Ethernet interface for security reasons.
For SkyConnector-only or combined applications (where a SkyExtender forms
wireless links to SkyConnectors and serves a local customer via the SkyExtenders
Ethernet interface), you can selectively enable or disable the Ethernet interface to
control subscriber access.
For manually provisioned devices, you set the Ethernet interface status by using
the command-line interface command (see set eth on page 172) or its Webbased command tool counterpart (see Ethernet Page on page 267).
For automatically provisioned devices, you use the Node Profile function within
SkyProvision to create profiles with the desired Ethernet interface status (see
Configuring Node Profiles on page 94), and then you apply the node profiles to
specific nodes (see Configuring Nodes on page 100).
SNMP
SNMP (Simple Network Management Protocol) is a standard for gathering
statistical data about network traffic and the behavior of network components.
SNMP uses management information bases (MIBs), which define what information
is available from any manageable network device.
SNMP is an application-layer protocol designed to facilitate the exchange of
management information between network devices. By using SNMP-transported
data (such as packets per second and network error rates), network administrators
can manage network performance, find and solve network problems, and plan for
network growth.
20 | Chapter 2 Operations
NOTE
Although you can disable SNMP for a device, its highly recommended
that you do not. If you disable SNMP for any device, your monitoring
capabilities with SkyControl will be limited, providing an incomplete
picture of your SkyPilot network.
Configuring SNMP
For manually provisioned devices, you configure SNMP by using the commandline interface command (see set snmp on page 196) or its Web-based
command tool counterpart (see SNMP Page on page 266).
For automatically provisioned devices, you use the Node Profile function within
SkyProvision to create profiles with the desired SNMP settings (see Configuring
Node Profiles on page 94), and then you apply the node profiles to specific nodes
(see Configuring Nodes on page 100).
Time Zones
You can specify an NTP (Network Time Protocol) server IP address and set the GMT
offset for accurate time. The NTP server provides the time to NTP clients (SkyPilot
nodes). When a SkyPilot node starts up, it has a default time of January 1, 1970.
Using an NTP server, the node adjusts its time to be synchronized with the NTP
server, which is usually UTC (Coordinated Universal Time) or GMT.
SkyPilot equipment does not display the correct time until an NTP server is
specified. You must either provide an NTP server option in your DHCP
configuration file or set the time zone during provisioning (by using commandline interface or Web-based command tool manual provisioning, or by setting the
time zone in an automatically provisioned nodes node profile).
22 | Chapter 2 Operations
means of prioritizing the transmission of VoIP packets and any other type of
data.
Traffic rate controlsYou can set traffic levels based on subscription rates.
For example, you could create a gold level for fastest service and a silver level
for slower service. The traffic levels are achieved by rate limiting. In
oversubscription conditions the data rates from subscribers will be reduced
proportionally. That is, a user with a 1 Mbps configured rate could be reduced
to 500 Kbps, while a configured rate of 500 Kbps is reduced to 250 Kbps.
QoS classifiersThese are used to classify traffic according to the types of
packets that will be directed to a subscribers high-priority queue, for both
upstream and downstream traffic. All other traffic will be directed to the
subscribers standard (low-priority) queue.
For any given subscriber, this classification mechanism ensures that all
queued high-priority packets are transferred before any queued low-priority
packets. However, the system as a whole transfers packets based on traffic
rate control and fairness criteria, thus ensuring that the low-priority packets of
one subscriber will continue to flow even when high-priority packets are
queued for another subscriber.
NOTE
You are not required to configure traffic rate control or QoS classifiers. By
default (that is, with no QoS classifiers applied), there is no restriction on
the maximum throughput, and no traffic priorities or classifications are
observed.
Configuring QoS
For manually provisioned devices, you configure QoS by using command-line
interface commands (see set classifier on page 170 and set
trafficrate on page 201) or their Web-based command tool counterparts
Description
Name
Upstream Rate
Downstream
Rate
Broadcast Rate
Date Created
(Read-only) Date and time this traffic rate control record was
created.
Date Modified
(Read-only) Date and time this traffic rate control record was
last modified.
Comment
24 | Chapter 2 Operations
QoS Classifiers
Table 2-4 lists the elements that describe QoS Classifiers.
Table 2-4. QoS Classifiers (Page 1 of 3)
Element
Description
Name
IP TOS Low
IP Protocol
Number
IP Source
Address
Description
IP Source Mask
IP Destination
Address
IP Destination
Mask
TCP/UDP Source
Port Start
TCP/UDP Source
Port End
TCP/UDP
Destination Port
Start
TCP/UDP
Destination Port
End
Source MAC
Address
Source MAC
Mask
Destination MAC
Address
Destination MAC
Mask
Ether Type
Protocol of the traffic to filter; for example, IPv4 and IPv6. (For
the complete list of protocols, refer to the IEEE website,
http://standards.ieee.org/regauth/ethertype/eth.txt.)
User Priority
Level Low
26 | Chapter 2 Operations
Description
User Priority
Level High
Date Created
Date Modified
(Read-only) Date and time this QoS classifier record was last
modified.
Comment
Filtering
Filters are used to control user data packet transfer through a SkyPilot network.
The filtering actions are performed on data packets received over the SkyPilot
devices 10/100bT interface. Four protocol fields can be examined. Filtering to
allow or deny packets is applied separately to these protocol fields. If multiple
filters are defined for a given protocol field, the filters are performed in the order in
which theyre listed in the SkyProvision display or command output. The default
filter is always performed last.
Unlike ACLs (access control lists), which examine data destined for a given SkyPilot
node, filters are used to filter all data passing through a given node.
You can configure filters for the following protocol fields:
Ethernet Type Limits the traffic through a node to data of a specific
protocol type. EtherTypes values include the following (refer to the IEEE
website, http://standards.ieee.org/regauth/ethertype/eth.txt, for the current
complete listing):
0x0800
0x0806
0x809b
0x8137
0x8191
0x86dd
IPv4
RP
AppleTalk over Ethernet
IPX
NetBIOS/NetBEUI
IPv6
ICMP
IGMP
TCP
UDP
L2TP
NetBIOS
SNMP
DHCP Client
DHCP Server
Configuring Filters
For manually provisioned devices, you configure filters by using the commandline interface command (see set filter on page 174) or its Web-based
command tool counterpart (see Filters Page on page 268).
For automatically provisioned devices you use SkyProvision, and select Enable in
the nodes node profile Filter field. You must also set the permission to Allow in
the nodes node profile for the corresponding filter. (For more information, see
Configuring Node Profiles on page 94.)
28 | Chapter 2 Operations
EtherType Filters
Table 2-5 lists the elements that describe EtherType filter records.
Table 2-5. EtherType Filters
Element
Description
Name
Protocol
EtherType
Permission
Date Created
Date Modified
(Read-only) Date and time this filter record was last modified.
Comment
IP Protocol Filters
Table 2-6 lists the elements that describe IP protocol filter records.
Table 2-6. IP Protocol Filters (Page 1 of 2)
Element
Description
Name
Protocol
Protocol Number
Permission
Description
Date Created
Date Modified
(Read-only) Date and time this filter record was last modified.
Comment
IP Address Filters
Table 2-7 lists the elements that describe IP address filter records.
Table 2-7. IP Address Filters (Page 1 of 2)
Element
Description
Name
IP Address
Subnet Mask
Type
Permission
30 | Chapter 2 Operations
Description
Date Created
Date Modified
(Read-only) Date and time this filter record was last modified.
Comment
Port Filters
Table 2-8 lists the elements that describe Port filter records.
Table 2-8. Port Filters
Element
Description
Name
Port
Protocol
Type
Date Created
Date Modified
(Read-only) Date and time this filter record was last modified.
Comment
32 | Chapter 2 Operations
If VLANs have been configured for end-user data in the wired network to
which the SkyGateway is connected through its Ethernet interface, VLANs
must be configured on all SkyExtender and SkyConnector devices in order for
end-user data to be appropriately tagged, sent, and received.
If keys have been changed on connected devices, the new netkey must be
manually configured on any device trying to join that network. This is
necessary because the netkey is the basis for determining if a link is trusted,
therefore making it impossible to rely on automated provisioning to supply
this parameter. If default netkeys are used, no change is necessary.
The remaining configuration settings are optional; theyre not required to be set in
order for a device to join the network and pass end-user data. Changes made
during manual provisioning are stored in flash memory, and therefore do not take
effect until the device is restarted.
Procedure Overview
Table 2-9 summarizes the steps required to manually provision a device.
Table 2-9. Manually Provisioning a Device (Page 1 of 2)
Step
Refer To
Decide whether to
provision the device by
the command-line
interface or Web-based
command tool.
Connect a computer to
the device and access the
command-line interface.
Step
Refer To
NOTE
34 | Chapter 2 Operations
upon completion of the devices startup (for SkyGateway) or formation of links (for
SkyExtenders and SkyConnectors). Once the device receives its configuration
information from the server, the device is available to participate in the SkyPilot
network.
Procedure Overview
Table 2-10 summarizes the steps required to automatically provision a network.
Although SkyPilot devices can be provisioned in any order, by following this
sequence you can ensure that devices are able to form links as soon as they come
online.
Table 2-10. Automatically Provisioning a SkyPilot Network (Page 1 of 3)
Step
Refer To
36 | Chapter 2 Operations
Step
Refer To
Provision the
SkyGateway(s).
Step
Refer To
Provision the
SkyExtender(s).
10
11
Provision the
SkyConnector(s).
Provisioning a Device
SkyPilot provisioning is a modular process whereby you add specific configuration
parameter building blocks to the database. Then you create a profilea collection
of configuration parameters which can be assigned to multiple devices that
require common parameter settings. This enables you to easily change a
parameter setting for every device using a common profile, just by changing the
parameter setting once, in that profile. After a profile is changed, every device
inherits the change the next time the device requests its configuration.
38 | Chapter 2 Operations
Automatically provisioned devices receive their configuration files from the EMS
server in the following situations:
Every time the device attempts to form a link
Every time the device reroutes
At a previously configured interval within the devices configuration file
When the reload command is entered from the command line
When an SNMP write occurs on the devices MIB reload variable
Table 2-11 describes the necessary steps to configure a SkyPilot device for
automatic provisioning.
Table 2-11. Configuring a Device for Automatic Provisioning
Step
Description
Refer To
Optionally, configure a
management or data VLAN to
which the device can be
assigned.
This table describes only those SkyProvision functions that are necessary for
enabling a device for automatic provisioning; you can perform many additional
functions using SkyProvision.
40
3
Administration
SkyPilot network administration involves routine management tasks, such as
managing software and customers, configuring security, and creating reports. This
chapter describes these management tasks and directs you to the corresponding
detailed procedures.
Chapter Highlights
Managing software images
Managing customers
Access control lists (ACLs)
SkyPilot security manager
About the SkyPilot MIB
Reports and statistics
Administration Guide | 41
WARNING
TrialThe image has been successfully downloaded but has not yet been
used to form links.
UnbootableThe image either was either partially downloaded or was
determined during startup to be corrupt.
Nodes on a SkyPilot network are able to interoperate using different software
versions, with the following restrictions:
Software versions 1.02p2 and earlier are all compatible with each other.
Software versions 1.1 and later are all compatible with each other.
SkyPilot nodes use anonymous FTP to download new software images. The FTP
server therefore becomes the central repository of software images.
42 | Chapter 3 Administration
Configuring Software
For manually provisioned devices, you configure a devices software by using the
command-line interface commands (see ftpimage on page 159 and set
activeimage on page 167) or their Web-based command tool counterparts
Description
Filename
Date Created
Date Modified
Comment
Description
Name
Schedule Date
Status
Comment
Node Profile
Managing Customers
Customers are individual subscribers, as well as companies with users of their own.
Multiple automatically provisioned SkyPilot nodes can be tied (assigned) to any
given customer (although each node can be assigned to only a single customer).
You can perform searches for existing customers based on any combination of
customer information, including customer ID, first name, last name, company
name, address 1, address 2, city, state/province, postal code, country, daytime
phone, and evening phone. In addition to adding, modifying, and deleting
customers, you can also assign and remove nodes from customers (by modifying
a customer profile).
To manage customer records, you use the Customer Maintenance function within
SkyProvision (see Configuring Customers on page 106).
44 | Chapter 3 Administration
Configuring ACLs
For a manually provisioned device, you configure its ACL by using the commandline interface command (see set acl on page 166) or its Web-based command
tool counterpart (see ACL Page on page 265).
For automatically provisioned devices, you use the Access Control List function
within SkyProvision (see Configuring Access Control Lists (ACLs) on page 112).
ACL Elements
Table 3-3 lists the elements that describe ACL records.
Table 3-3. ACL Elements
Element
Description
Name
IP Address
Subnet Mask
Port
Protocol
Date Created
Date Modified
(Read-only) Date and time this ACL record was last modified.
Comment
46 | Chapter 3 Administration
NOTE
You must not change the spMib.txt file. If you change this file and load
it into a MIB browser, the SkyPilot nodes SNMP operations will not work
properly, and SkyControl will not be able to perform its monitoring
functions.
Performance Thresholds
Performance thresholds are severity level profiles that can be associated with MIB
objects for which data collection tasks are configured. So, for example, you can
specify that when a MIB objects value crosses a threshold level, a threshold event
will be generated and the data will be added to any data collection task having
the corresponding MIB object and threshold.
To configure performance thresholds, you use the Performance Threshold
function within SkyPilot EMS (see Configuring Performance Thresholds on
page 83).
NOTE
After configuring a devices data collection task, you must explicitly start
the task before any of its statistics can be viewed.
To configure data collection tasks, you use the devices Configure Task function
within SkyControl (see Configuring Data Collection Tasks on page 131).
NOTE
Reports put less of a performance load on the EMS server than similar
statistics functions, and so should be used whenever possible.
48 | Chapter 3 Administration
Reports Elements
Table 3-4 lists the elements that describe Reports.
Table 3-4. Reports Elements
Element
Description
Report Name
Type of Report
Type that reflects the time range over which data is collected
and averaged into a single report data point. The endpoint of
the sampling cycle depends on the type of report:
HourlyAt the stroke of the hour
DailyAt midnight
WeeklySaturday at midnight (that is, midnight
between Saturday and Sunday)
MonthlyLast day of the month at midnight (that is, just
before the next month begins)
Performance
Objects
50
4
Maintenance
SkyPilot maintenance tasks include developing monitoring and troubleshooting
strategies. This chapter describes techniques for operating and maintaining your
SkyPilot network, as well as solutions to common troubleshooting issues.
Chapter Highlights
Monitoring a SkyPilot network by using SkyControl
Monitoring alarms
Monitoring link states
Managing IP addresses
Using utilities
Troubleshooting
Administration Guide | 51
MIB II
Ether-Like
Bridge
Filters
For more information about using the SkyPilot MIB, see About the SkyPilot MIB
on page 47. For a complete description of every SkyPilot MIB element, refer to the
SkyPilot MIB file, spMib.txt, located in the
/root/SkyPilot/EMS/client/mibs directory.
52 | Chapter 4 Maintenance
Monitoring Alarms
By monitoring your SkyPilot network alarms, you can take appropriate corrective
action, as well as prevent major network disruptions.
The SkyPilot EMS alarm system provides the capability to configure alarm levels,
set up email notifications, generate reports, and more.
Description
EMS Version
act mgmt
All
act path
All
standby
1.0.0 to 1.0.2p2
standby-o
standby-h
inactive
All
non-opt
All
Monitoring Alarms | 53
Description
EMS Version
pre-auth
All
auth fail
All
prov fail
All
parent
All
child
All
Managing IP Addresses
All SkyPilot devices ship with the default IP address 192.168.0.2, accessible only
from the Ethernet interface. A SkyGateway replaces this default when it performs
DHCP or is explicitly configured with a static IP address. SkyExtenders and
SkyConnectors always make this default IP address available in addition to any IP
address received through DHCP or statically configured. The SkyExtender
DualBand requires two separate IP addresses: the Extender portion (which uses
192.168.0.2) and the Access Point portion (which retains 192.168.0.3 as its default
IP address in addition to any IP received through DHCP or statically configured).
54 | Chapter 4 Maintenance
Using any text editor, open the DHCP configuration file, dhcp.conf (typically
located in the /etc directory).
Using an existing entry as a model, add a new entry for the device you plan to
install, paying particular attention to the new nodes Ethernet MAC address.
Entries look similar to the following:
host cpe0135 {
hardware ethernet 00:0A:DB:00:01:35;
fixed-address 192.168.6.118;
option host-name "cpe0135";
}
During SkyPilot EMS installation, default options that are inherited by all
subsequent entries (such as the above sample and your new entry) are added
at the beginning of the DHCP configuration file.
4
[
[
OK
OK
]
]
Managing IP Addresses | 55
Using Utilities
SkyPilot devices include a number of built-in utilities to help you with
troubleshooting and maintenance tasks:
PingLayer 3 ping utility. Use the command-line interface (see ping on
page 162) or the Web-based command tool (Utilities Pages on page 278).
Node testTwo-way link layer ping test. Use the command-line interface (see
nodetest on page 161) or the Web-based command tool (Utilities Pages
on page 278).
RebootDevice reboot. Use the command-line interface (see reboot on
page 163) or the Web-based command tool (Utilities Pages on page 278).
TraceroutePath trace from the local node to the destination MAC address.
Use the command-line interface (see traceroute on page 251) or the
Web-based command tool (Utilities Pages on page 278).
56 | Chapter 4 Maintenance
Troubleshooting
This section presents procedures for troubleshooting problems of various kinds,
including startup and connectivity, with a SkyPilot device. Each procedure is
presented in a table set up like this (with varying numbers of steps and substeps).
1
Troubleshooting | 57
Power-On Problems
Use the following procedure to troubleshoot the failure of a SkyPilot device to
power on. This procedure applies to any SkyPilot device and to either provisioning
mode (manual or automatic).
Table 4-2. Power-On Troubleshooting (Page 1 of 2)
1
58 | Chapter 4 Maintenance
Check whether the SkyPilot device is connected with the proper cables:
Verify the use of the following
CAT5 twisted-pair cables:
Straight-through cable
between power injector and
the device
Troubleshooting | 59
IP Connectivity Problems
This section addresses device problems related to IP connectivity. It includes the
following subsections for solving problems related to IP connectivity for
SkyGateways (manually and automatically provisioned), as well as SkyExtenders
and SkyConnectors (again, both manually and automatically provisioned):
Manually Provisioned SkyGateway IP Connectivity Problems (the next
section)
Automatically Provisioned SkyGateway IP Connectivity Problems on page 62
SkyExtender and SkyConnector IP Connectivity Problems on page 63
60 | Chapter 4 Maintenance
The primary causes of IP connectivity problems with SkyPilot devices are a failure
to acquire a GPS signal (in the case of a SkyGateway or SkyExtender), the location
of a device on the wrong subnet, and conflicts with VLAN management solutions.
Troubleshooting | 61
62 | Chapter 4 Maintenance
(SkyExtender only) Check whether the device is able to acquire a GPS signal:
Log in to the SkyExtender via
the serial port and observe the
output at startup to verify the
acquisition of a GPS signal.
See Accessing the CommandLine Interface, on page 144, for
instructions on accessing the
command-line interface of a
SkyPilot device.
Troubleshooting | 63
If a management VLAN is
present on the SkyGateway, it
will prevent local network
access to a SkyExtender or
SkyConnector after the device
forms a link with the
SkyGateway.
64 | Chapter 4 Maintenance
Troubleshooting | 65
66 | Chapter 4 Maintenance
Troubleshooting | 67
68 | Chapter 4 Maintenance
Troubleshooting | 69
70 | Chapter 4 Maintenance
Continue this procedure with the steps in the next section for manually
provisioned devices, or with the steps in Failing to Form Links (Automatic
Provisioning) on page 73 for automatically provisioned devices.
Troubleshooting | 71
72 | Chapter 4 Maintenance
If the SkyGateways
configuration parameters do
not match the frequency or
domain settings of the
SkyGateway or SkyExtender its
using to form links, devices will
sever the links before
connections can be made.
Troubleshooting | 73
An incorrect DHCP
configuration will prevent the
device from obtaining its
configuration from the
provisioning server.
74 | Chapter 4 Maintenance
Troubleshooting | 75
76 | Chapter 4 Maintenance
A
SkyPilot EMS Reference
SkyPilot EMS enables you to perform management and monitoring functions,
such as security configuration and alarm monitoring, that arent specific to
SkyProvision or SkyControl. This appendix provides detailed instructions for the
management and monitoring functions.
Appendix Highlights
Using SkyPilot EMS
Managing network security
Configuring performance thresholds
Administration Guide | 77
Enter your user name and password. (The default value for both user name
and password is admin.)
Click Login.
Display pane
Alarm summary
Alarm pane
Menu barContains menus and commands which allow you to set global
network configuration items, as well as manage the windows in the EMS
display pane.
Navigation paneContains a Windows Explorerlike, hierarchical display of
the SkyPilot OAM tools: SkyProvision and SkyControl.
Display paneShows the interface for the SkyPilot OAM tool selected in the
navigation pane. Multiple windows can be shown at one time in the display
pane.
Click Yes.
File Menu
The File menu lets you end a SkyPilot EMS client session. See Stopping the EMS
Client (previous section).
View Menu
The View menu provides you with the ability to refresh the EMS client display (by
clicking View Refresh).
Object Menu
The Object menu provides context-sensitive action choices that change in
response to selecting SkyProvision and SkyControl functions from their respective
navigation trees. For example, expanding the SkyProvision tree and clicking
Customer Maintenance causes the Object menu to change to Customer
Maintenance. Subsequently clicking VLAN causes the Object menu to change
again, this time to VLAN.
Fault Menu
The Fault menu provides access to alarm maintenance, event log, and trap
functions. See Monitoring Alarms on page 53.
Performance Menu
The Performance menu provides access to global data collection and report
configuration functions. See Reports and Statistics on page 48.
Security Menu
The Security menu enables you to manage network security (by clicking
Security Security Manager). See Managing Network Security on page 82.
Tools Menu
The Tools menu offers the following choices:
Look & FeelTo change the display pane appearance.
MIB BrowserTo access to the SkyPilot MIB (Management Information Base),
as well as any other MIBs you have installed. (This function requires prior
installation of SkyControl, as well as the appropriate SkyPilot EMS license.)
TelnetTo open a Telnet connection from your computer to any SkyPilot
device through a serial connection.
MAC Address ReportTo create a report listing all MAC addresses that are
missing from node maintenance or SkyControl.
Alarm Color SettingsTo change the colors used to indicate alarm severity
in the Alarm Summary and Alarm Pane sections of the EMS interface.
Link Status SettingsTo change the color and line style used to show link
status in SkyControl network displays.
Change PasswordTo change the password corresponding to the current
SkyPilot EMS sessions user name.
Window Menu
The Window menu provides standard Windows-based display options:
CascadeTo show all open SkyProvision and SkyControl display pane
windows, cascaded.
Tile HorizontalTo show all open display pane windows, tiled horizontally
(each sized to the display panes current horizontal size).
Tile VerticalTo show all open display pane windows, tiled vertically (each
sized to the display panes current vertical size).
Minimize AllTo minimize all open display pane windows.
Close AllTo close all open display pane windows.
EMS-windowTo make the EMS-window the active display pane window.
Help Menu
The Help menu provides version and copyright information about the SkyPilot
EMS client (by clicking Help About).
NOTE
From the SkyPilot EMS Menu Bar, choose Security Security Manager.
Click Close.
Click New.
Click Save.
Focus returns to the Configure Threshold screen, and your new threshold is
shown in the list of thresholds.
Click Close.
Editing a Threshold
You can edit (modify) any threshold that is not currently tied to a data collection
task object.
To edit a performance threshold:
1
Click the name of the threshold whose settings you want to modify, and then
click Edit.
Click Save.
Focus returns to the Configure Threshold screen.
Click Close.
Deleting a Threshold
You can delete any threshold that is not currently tied to a data collection task
object.
To edit a performance threshold:
1
Click the name of the threshold whose settings you want to delete, and then
click Delete.
SkyPilot EMS displays a Delete Confirmation message.
Click Yes.
Click Close.
86
B
SkyProvision Reference
SkyProvision enables you to configure provisioning parameters for automatically
provisioned devices and to perform administrative functions for your SkyPilot
network. This appendix provides detailed instructions for those provisioning and
administrative functions.
Appendix Highlights
Using SkyProvision
Searching for configured devices
Configuring domains
Configuring node profiles
Configuring nodes
Configuring VLANs
Configuring customers
Configuring SNMP
Configuring access control lists (ACLs)
Configuring QoS
Configuring software images
Administration Guide | 87
Using SkyProvision
SkyProvision is a server-based application that automates device provisioning by
enabling devices to get their configuration information from the SkyPilot EMS
server.
Starting SkyProvision
You access SkyProvision from the SkyPilot EMS Client.
To start SkyProvision:
1
Enter your user name and password. (The default value for both user name
and password is admin.)
Click Login.
(For information about the SkyPilot EMS interface elements, see The SkyPilot
EMS Interface on page 79.)
4
Using SkyProvision | 89
Anchored column
Slider
Action choices
Anchored columnsColumns that are not resizeable and that do not move
when you use the slider or arrows at the bottom of the display. Names of
anchored columns are indicated by bold text in the display pane.
SliderThe bar between the arrows just below the display. Use the slider to
move the columns to the right and left so that you can see all the information.
Action choicesContext-sensitive buttons that let you quickly perform
common actions without using the multiple-level menu commands.
NOTE
From the left pull-down menu, select the device to search for.
Click Apply.
Click Search.
The results are displayed.
Configuring Domains
A single domain can be defined to encompass your entire SkyPilot network,
including all its nodes. Or domains can be used to segregate a network into two or
more smaller networks. Each smaller network has the same characteristics as a
larger SkyPilot network. For more information about domains, see Domains on
page 16. The following sections describe the elements of a domain and explain
how to add, modify, and delete domains.
Domain Elements
Table B-1 lists the elements that describe domains.
Table B-1. Domain Elements (Page 1 of 2)
Element
Description
Name
Domain
Description
Date Created
Date Modified
Comment
Adding a Domain
Once you add a domain, it can be used in any node profile.
To add a domain:
1
Click OK.
Modifying a Domain
You can modify the settings of any domain that is not assigned to any node
profiles.
To modify a domain:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Domain.
SkyProvision displays the Domain screen.
In the display pane, right-click the name of the domain you want to modify
and choose Modify.
Edit the domain elements. For more information, see Domain Elements on
page 91.
Click OK.
Deleting a Domain
You can delete any domain that has no nodes assigned to it.
To delete a domain:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Domain.
SkyProvision displays the Domain screen
Configuring Domains | 93
Select the domain you want to delete by right-clicking its domain name in the
display pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
Click Yes.
Description
Name
Primary Software
Description
Backup Software
Traffic Rate
Control
Frequency
Domain
Timezone
Time zone setting for the node. See Time Zones on page 22.
Ethernet
SNMP
Password
Description
EtherType Filter
IP Protocol Filter
IP Address
Destination Filter
IP Address
Source Filter
Port Destination
Filter
ARP Source
Date Created
Date Modified
(Read-only) Date and time this node profile record was last
modified.
Comment
Refer To
ACL
Classifier
Filters
Filtering on page 27
Frequency
Frequency on page 16
SNMP
VLAN
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Node Profile.
Enter the node profile elements. For more information, see Node Profile
Elements on page 94.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Node Profile.
SkyProvision displays the Node Profile screen.
Select the node profile you want to modify by right-clicking its name in the
display pane and choosing Modify.
Edit the node profile elements. For more information, see Node Profile
Elements on page 94.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Node Profile.
SkyProvision displays the Node Profile screen.
Select the node profile you want to delete by right-clicking its name in the
display pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
Click Yes.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Node Profile.
SkyProvision displays the Node Profile screen.
Select the node profile you want to manage by clicking its name in the display
pane.
Click Attributes.
Click the tab for the attribute element you want to associate with the node
profile. For more information, see Node Profile Attribute Elements on
page 97.
Configuring Nodes
A SkyPilot network node is any SkyPilot device on the mesh network
SkyGateways, SkyExtenders, and SkyConnectors (both indoor and outdoor). The
following sections describe the elements of a node and explain how to add,
modify, and delete nodes.
Node Elements
Table B-4 lists the elements that describe node records.
Table B-4. Node Elements (Page 1 of 2)
Element
Description
MAC Address
Node Type
Hostname
IP Address
Address 1
Address 2
City
Description
State
Postal Code
Country
Node Profile
Customer
Date Created
Date Modified
(Read-only) Date and time this node record was last modified.
Comment
Adding a Node
You can add nodes to your SkyPilot network anytime.
To add a node:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Node.
Enter the node elements. For more information, see Node Elements on
page 100.
Click OK.
Modifying a Node
You can modify a nodes settings anytime.
To modify a node:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Node.
SkyProvision displays the Node screen.
Select the node you want to modify by right-clicking its name in the display
pane and choosing Modify.
Edit the node elements. For more information, see Node Elements on
page 100.
Click OK.
Deleting a Node
You can delete a node from your SkyPilot network anytime.
To delete a node:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Node.
SkyProvision displays the Node screen.
Select the node you want to delete by right-clicking its name in the display
pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
Click Yes.
Configuring VLANs
Virtual Local Area Networks (VLANs or Virtual LANs) are portions of a network
configured as logical topologies defined by software, connected to the same
physical network infrastructure. Devices on separate VLANs of a network behave
as if they are on physically separated networks. VLANs function by logically
segmenting the network into different broadcast domains so that packets are only
switched between ports that are designated for the same VLAN. For more
information about VLANs, see Virtual Local Area Networks (VLANs) on page 17.
The following sections describe the elements of a VLAN and explain how to add,
modify, and delete VLANs.
VLAN Elements
Table B-5 lists the elements that describe VLANs.
Table B-5. VLAN Elements
Element
Description
Name
VLAN
Number from 1 to 4096 used as the VLAN tag for all nodes
within the given VLAN.
VLAN Type
Date Created
Date Modified
Comment
Adding a VLAN
You can add a VLAN to your SkyPilot network anytime.
To add a VLAN:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click VLAN.
Enter the VLAN elements. For more information, see VLAN Elements on
page 104.
Click OK.
Modifying a VLAN
You can modify VLAN configurations anytime.
To modify a VLAN:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click VLAN.
Select the VLAN you want to modify by right-clicking its name in the display
pane and choosing Modify.
SkyProvision displays the Modify VLAN screen.
Edit the VLAN elements. For more information, see VLAN Elements on
page 104.
Click OK.
Deleting a VLAN
You can delete a VLAN from your SkyPilot network anytime.
To delete a VLAN:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click VLAN.
Select the VLAN you want to delete by right-clicking its name in the display
pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
Click Yes.
Configuring Customers
The Customer Maintenance functions allow you to manage customer records in
your SkyPilot network database. (For information about customers, see Managing
Customers on page 44.)
The following sections describe the elements of a customer profile and explain
how to add, modify, and delete customer profiles.
Description
First Name
Last Name
Address 1
Address 2
City
State/Province
Postal Code
Country
Day Phone
Evening Phone
Email
Description
Date Created
Date Modified
Comment
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Customer Maintenance.
SkyProvision displays the Customer Maintenance screen.
Enter the customer profile elements. For more information, see Customer
Profile Elements on page 106.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Customer Maintenance.
SkyProvision displays the Customer Maintenance screen.
Select the customer profile you want to modify by right-clicking its name in
the display pane and choosing Modify.
SkyProvision displays the Modify Customer screen.
Edit the customer profile elements. For more information, see Customer
Profile Elements on page 106.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Customer Maintenance.
SkyProvision displays the Customer Maintenance screen.
Select the customer profile you want to delete by right-clicking its name in
the display pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
Click Yes.
Configuring SNMP
Before you can use SkyControl to monitor an automatically provisioned device,
you must first configure corresponding SNMP parameters. For information about
SNMP, see SNMP on page 20. For information about SkyControl, see Monitoring
a Networks Topology by Using SkyControl on page 52.
Description
Name
Community
String
Type
Date Modified
Comment
Description
Name
IP Address
Port
Date Created
(Read-only) Date and time this SNMP trap receiver record was
created.
Date Modified
(Read-only) Date and time this SNMP trap receiver record was
last modified.
Comment
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click SNMP.
Enter the SNMP parameter elements. For more information, see one of the
following:
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click SNMP.
Select the SNMP parameter you want to modify by right-clicking its name in
the display pane and choosing Modify.
SkyProvision displays the Modify screen corresponding to the SNMP
parameter you selected.
Edit the SNMP parameter elements. For more information, see one of the
following:
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click SNMP.
Select the SNMP parameter you want to delete by right-clicking its name in
the display pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
Click Yes.
Adding an ACL
You can add ACLs anytime.
To add an ACL:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Access Control List.
SkyProvision displays the Access Control List screen.
Enter the ACL elements. For more information, see ACL Elements on
page 46.
Click OK.
Modifying an ACL
You can modify any ACL that is not currently assigned to a node.
To modify an ACL:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Access Control List.
SkyProvision displays the Access Control List screen.
Select the ACL you want to modify by right-clicking its name in the display
pane and choosing Modify.
SkyProvision displays the Modify ACL screen.
Edit the ACL elements. For more information, see ACL Elements on page 46.
Click OK.
Deleting an ACL
You can delete any ACL that is not assigned to a node.
To delete an ACL:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Access Control List.
SkyProvision displays the Access Control List screen.
Select the ACL you want to delete by right-clicking its name in the display
pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
Click Yes.
Configuring QoS
Adding a QoS Classifier Profile
You can add QoS classifier profiles anytime.
To add a QoS classifier profile:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the QoS tree item, and double-click Classifier.
SkyProvision displays the Classifier screen.
Enter the classifier elements. For more information, see QoS Classifiers on
page 25.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the QoS tree item and double-click Classifier.
SkyProvision displays the Classifier screen
Select the QoS classifier profile you want to modify by right-clicking its name
in the display pane and choosing Modify.
Sky Provision displays the Modify Classifier screen.
Edit the QoS classifier elements. For more information, see QoS Classifiers on
page 25.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the QoS tree item, and double-click Classifier.
SkyProvision displays the Classifier screen
Select the QoS classifier profile you want to delete by right-clicking its name in
the display pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
Click Yes.
Adding a Filter
You can add filters anytime.
To add a filter:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Filter.
From the menu bar, choose your-filter Add, where your-filter corresponds
to the filter type you selected.
SkyProvision displays the Add Filter screen corresponding to the filter type
you selected.
Enter the Filter elements. For more information, see one of the following:
Click OK.
Modifying a Filter
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Filter.
Select the filter you want to modify by right-clicking its name in the display
pane and choosing Modify.
SkyProvision displays the Modify screen corresponding to the filter you
selected.
Edit the Filter elements. For more information, see one of the following:
Click OK.
Deleting a Filter
You can delete any filter that is not assigned to a node.
To delete a filter:
1
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item
and double-click Filter.
Select the filter you want to delete by right-clicking its name in the display
pane and choosing Delete.
SkyProvision displays a Delete Confirmation message.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the Software tree item, and double-click Software Maintenance.
SkyProvision displays the Software Maintenance screen.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the Software tree item, and double-click Software Maintenance.
SkyProvision displays the Software Maintenance screen.
Right-click the name of the software image you want to modify, and choose
Modify.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the Software tree item, and double-click Software Maintenance.
SkyProvision displays the Software Maintenance screen.
Right-click the name of the software image you want to delete, and choose
Delete.
SkyControl displays a Delete Confirmation message.
Click Yes.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the Software tree item, and double-click Software Schedule.
SkyProvision displays the Software Schedule screen.
Enter the software schedule elements. For more information, see Software
Schedule Elements on page 44.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the Software tree item, and double-click Software Schedule.
SkyProvision displays the Software Schedule screen.
Right-click the name of the software image you want to modify, and choose
Modify.
Click OK.
In the navigation pane of the SkyPilot EMS, expand the SkyProvision tree item,
expand the Software tree item, and double-click Software Schedule.
SkyProvision displays the Software Schedule screen.
Right-click the name of the software schedule you want to delete, and choose
Delete.
SkyControl displays a Delete Confirmation message.
Click Yes.
122
C
SkyControl Reference
SkyControl enables you to perform administrative and maintenance functions for
your SkyPilot network. This appendix provides detailed instructions for those
administrative and maintenance functions.
Appendix Highlights
Using SkyControl
Viewing your SkyPilot network
Configuring performance thresholds
Configuring data collection tasks
Using reports
Viewing statistics
Using SkyControl
SkyControl is an SNMP management system for real-time device monitoring and
management. This software provides a graphical view of your network topology
with at-a-glance updates on topology, routing, and performance.
Starting SkyControl
You access SkyControl from the SkyPilot EMS Client. If SkyProvision is already
active, then you dont need to start another SkyPilot EMS sessionboth
SkyProvision and SkyControl can be run within a single SkyPilot EMS session.
To access SkyControl:
1
Enter your user name and password. (The default values for both user name
and password are admin.)
Click Login.
The SkyPilot EMS Interface is displayed.
SkyControl Interface
Figure C-1 illustrates the following parts of the SkyControl Interface, including
elements on its display pane:
Map tool barTool bar that is active when there is a monitored domain map
shown in the display pane.
Use the Arrow to lock and unlock a nodes position on the map display.
When the node is unlocked, you can drag it to any position on the map.
Use the Zoom Level buttons to zoom in and out of the map display to any
level. Use the left button for maximum zoom out; use the right button for
maximum zoom in; and use the buttons in between for intermediate
zoom levels. The current zoom level is indicated by the corresponding
buttons highlight.
Use the Magnifying Glass to zoom in and out of the map display by a
single level. (When you use either magnifying glass, the zoom level
highlight changes to show the new zoom level.)
SkyExtender
SkyConnector Outdoor
SkyConnector Indoor
SkyExtender DualBand
Link line
Node icons
Display background
TIP
NOTE
You must separately add the image to every PC on which you run the
EMS Client.
If you dont want to change which nodes and links are shown (including
whether their accompanying labels are shown), youre done with this
procedure.
To change the displays configuration, right-click the domain name whose
display you want to customize, and choose Display Configuration.
Click OK.
NOTE
SkyControl is already polling all devices) or select the device and start its
default task. Likewise, if a nodes IP address changes, you must stop and
restart the polling for that node in order for SkyControl to monitor and
poll the node at its new address.
To view a domain:
1
In the navigation pane, right-click the domain name youre viewing, and
choose Start Polling All Devices.
The nodes within the domain automatically discover one another, and
SkyControl automatically adds node icons to the display, as well as link lines
once the links are formed.
NOTE
To view detailed information about any given node, right-click either the
corresponding node icon or the nodes name in the navigation pane, and
choose Device Details.
Expand the domain tree that contains the device for which you want to
configure a data collection task.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
Right-click the device name for which you want the report, and choose
Configure Task.
SkyControl displays the Configure Task screen.
Click New.
Enter the Task elements. For more information, see Data Collection Tasks on
page 47.
Click OK.
Focus returns to the Configure Task screen, and your new data collection task
is shown in the list of tasks (test_051214 in the following figure).
Click Close.
Expand the domain tree that includes the device that contains the data
collection task you want to modify.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
Right-click the device name for which you want the report, and choose
Configure Task.
SkyControl displays the Configure Task screen.
Click the name of the report whose settings you want to modify, and then
click Edit.
Edit the Task elements. For more information, see Data Collection Tasks on
page 47.
Click OK.
Focus returns to the Configure Task screen.
Click Close.
Expand the domain tree that includes the device containing the data
collection task you want to delete.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
Click the name of the data collection task you want to delete, and then click
Delete.
SkyControl displays a Delete Confirmation message.
Click Yes.
Using Reports
The following sections describe how to add, modify, and delete reports.
Expand the domain tree that contains the device for which you want a report.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
Right-click the device name for which you want the report, and choose
Configure Report.
SkyControl displays the Configure Report screen.
Click New.
SkyControl displays the Create New Report screen.
Enter the Report elements. For more information, see Reports Elements on
page 49.
Click OK.
Focus returns to the Configure Report screen, and your new report is shown in
the list of reports (test-report in the following figure).
Click Close.
Expand the domain tree that contains the device for which you want a report.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
Right-click the device name for which you want the report, and choose
Configure Report.
SkyControl displays the Configure Report screen.
Click the name of the report whose settings you want to modify, and then
click Edit.
SkyControl displays the Edit Report screen.
Edit the Report elements. For more information, see Reports Elements on
page 49.
Click OK.
Focus returns to the Configure Report screen.
Click Close.
Purging a Report
You can set up automatic purging of reports from your system to avoid
unnecessarily filling up disk space. You can specify a different purge frequency for
each type of report (hourly, daily, and so on).
To set up report purging:
1
From the SkyPilot EMS Menu Bar, choose Performance Configure Report
Data Clear Interval.
SkyPilot EMS displays the Configure Report Data Clear Interval screen.
Enter a number to specify the age of data that you want to purge.
Click OK.
Expand the domain tree that contains the device for which you want a report.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
SkyControl displays the Configure Report screen.
Click the name of the report whose settings you want to delete, and then click
Delete.
SkyControl displays a Delete Confirmation message.
Click Yes.
Viewing a Report
To view a report:
1
Expand the domain tree that contains the device for which you want view a
report.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
Right-click the device name for which you want the report, and choose View
Report.
SkyControl displays the View Report screen.
Select the report you want to view and which MIB objects to include, and click
View or Chart.
SkyControl displays the report.
Viewing Statistics
The following sections describe how to view both current and collected statistics.
For information about SkyPilot statistics, see Reports and Statistics on page 48.
Expand the domain tree that contains the device for which you want view a
report.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
Right-click the device name for which you want the report, and choose View
Current Statistics.
SkyControl displays the Current Statistics screen.
Select the data collectors and MIB objects you want to view, and click Start.
SkyControl displays the statistics in real-time, similar to the following:
Expand the domain tree that contains the device for which you want view a
report.
The navigation pane expands (if it is not already expanded) to show the
complete list of devices in the domain.
Right-click the device name for which you want the report, and choose View
Collected Statistics.
SkyControl displays the Collected Statistics screen.
Select the parameters, configure the graph elements (such as the axis
settings), and choose the time frame, and then click any of the following:
D
Command-Line Interface Reference
The Command-Line Interface is a text-based interactive application built into all
SkyPilot devices. This interface enables you to manually provision a device,
monitor and manage a device, and enable real-time logging.
This appendix provides instructions for accessing SkyPilot devices command-line
interface, as well as detailed descriptions of all the commands available through
the command-line interface.
Appendix Highlights
Accessing the command-line interface
Using the command-line interface
Command summary
Provisioning parameters scope
Commands
Prepare a PC or laptop.
Open the network settings panel and assign the computer an IP address from
192.168.0.4 to 192.168.0.254, and a subnet mask of 255.255.255.0. (For
information changing a devices IP address from its default, see Managing IP
Addresses on page 54.)
Log in by entering the password at the command prompt. (Use the default,
public, if you havent changed the password.)
Plug one end of the serial straight-through cable (provided) into the DB-9
adapter and the other end into the RJ-45 serial port under the base of the
SkyGateway or SkyExtender.
Select the COM port you used to physically connect the console to the
device.
Log in by entering the password at the command prompt. (Use the default,
public, if you havent changed the password.)
Command Summary
Tables D-1 and D-2 divide the command set into two groups: the most commonly
used commands followed by those that are more advanced and less frequently
used.
Table D-1. Common Commands (Page 1 of 3)
Command
Description
exit
help
nodetest
ping
reboot
rebootap
Description
set
command-line interface
provProvisioning mode: either manual or automatic;
and flash settings for provisioning parameters
Description
show
on)
freqPrimary frequency for devices, as well as an allow
range of frequencies
intEthernet and RF interfaces information
ipIP address, subnet mask, and default gateway
linkMesh link states and statistics for frequency,
Description
acceptimage
clear
Description
debug
ftpimage
reload
set
software
apwatchdogAccess point watchdog task (SkyExtender
DualBand only)
buzzerSound pitch indicating signal strength
(SkyConnector only)
classifierConfigures QoS classifiers
factoryapAccess point factory settings (SkyExtender
DualBand only)
gpsDevice position and GPS satellite information
Description
show
bridge ports
buzzerSound pitch indicating signal strength
(SkyConnector only)
classifierQoS classifiers
debugDebug status
flashFlash memory status
gpsDevice position and GPS satellite information
(SkyGateway only)
memSystem memory partition blocks and statistics
meshMesh forwarding table, mesh route cost table, or
MAC learning table
netkeyKey that is exchanged as part of the link
formation process
powerPower level of transmit signal (SkyGateway only)
phyerrorsList of PHY errors for the devices radio chip.
processSystem processes
radarRadar detection state (SkyGateway only)
snmpSNMP community strings and trap receivers
spectrumSpectrum analysis
stackStack usage statistics for all tasks
techSnapshot of nodes current configuration and
status
tempTemperature of the devices radio chip
timezoneNTP server IP address, as well as the GMT
spectrum
Description
traceroute
Traces the path from the local node to the destination MAC
verifykey
NOTE
Parameter value changes that can be made only in flash memory (not in
real-time) appear in this reference appendix in the format
set prov <parameter>. Otherwise, they appear in the format
set <parameter>.
Devices
Immediate
Flash
(Real-Time)
acl
all
auto
all
buzzer
SkyConnector only
Devices
Immediate
Flash
(Real-Time)
classifier
all
dhcp
all
domain
all
eth
all
filter
all
freq
all
ip
all
manual
all
netkey
all
parent
non-SkyGateway
devices
password
all
power
SkyGateway only
radar
SkyGateway only
snmp
all
timezone
all
trafficrate
all
vlan
all
web
all
Commands
acceptimage
Sets the specified partitions image state to accepted (which is normally done
automatically by the device). This command bypasses the automated process,
and should be used when youre preprovisioning equipment with known good
images to ensure that the device does not prematurely mark the image
unbootable due to more than 10 reboots or power cycles.
NOTE
Syntax
acceptimage <A | B>
Arguments
A
Example
> acceptimage A
Image accepted.
>
Commands | 155
clear
Clears all counters displays using the show link stats CLI command, or that are
available via SNMP.
Syntax
clear <counters | spectrum>
Arguments
counters
spectrum
all
Example
> clear counters
Clear multi channel max hold statistics.
>
debug
Enables or disables debug logging to standard output (stdout). This command is
available to Telnet clients. However, it is not available when accessing the
command-line interface through a serial connection because debug logging is
always enabled in such cases.
Syntax
debug <on | off | status>
Arguments
on
Enables debugging
off
Disables debugging
status
None
Example
> debug on
debug logging enabled
>
Commands | 157
exit
Terminates the current Telnet session.
Syntax
exit
Arguments
None
Example
> exit
> exitConnection closed by foreign host.
ftpimage
Downloads a software image onto the SkyPilot device. Unlike the automated
provisioning process, which only allows you to download images into the inactive
partition, the ftpimage command lets you download the image into either of
the partitionsA or B (either of which can be specified as the partition that
contains the active image; see set activeimage on page 167). SkyPilot
recommends first downloading new images into the backup partition to avoid
overwriting the active image. You can download software with this command
from any device running an FTP server that is reachable over the network.
Syntax
ftpimage
Arguments
None
login
password
filename
partition
Example
> ftpimage
Enter FTP server IP address: 192.168.4.100
Enter FTP server login [anonymous]:
Enter FTP server password:
Enter filename: SpX8_d040723
Enter destination partition: <A|B>: B
FTP server IP address: 192.168.4.100
FTP server login: anonymous
Filename: SpX8_d040723
Destination partition: B
Are these settings correct? yes, no, quit <y|n|q>: y
>
Commands | 159
help
Displays a description of the each commands function, as well as a synopsisthe
command syntax.
Syntax
help [? | command]
Arguments
?
command
None
Example
> ?
debug
nodetest
Provides a two-way link layer ping test.
Syntax
nodetest <MAC> [packet-count [packet-size]]
Arguments
MAC
packet-count Number of packets to send before terminating the ping test; if no value
Size (in bytes) of the packets to send during the ping test
None
Example
> nodetest 000adb000043
From Me
To Me
| RSSI
#PKT | RSSI
#PKT |
| 20
2 | 19
3 |
| 21
11 | 20
39 |
| 22
29 | 21
48 |
| 23
32 | 22
11 |
| 24
27 |
|
|
|
|
Average and standard deviation calculations
From Me
To Me
Latency
PacketCount
| Ave
22.70 | Ave
20.66 | Ave
12968.39 | LostPacket
| StDev 1.04 | StDev 0.71 | StDev 10375.04 | SuccessPkt
Link Ping results: 100.000%
Successes: 101
0 |
101 |
Misses: 0
Commands | 161
ping
Tests a connection by performing a layer 3 ping test.
Syntax
ping <host> [packet-count [packet-size]]
Arguments
host
packet-count Number of packets to send before terminating the ping test; if no value
Size (in bytes) of the packets to send during the ping test
Example
> ping 192.168.4.188
PING 192.168.4.188: 56 data bytes
64 bytes from sbc405gpr (192.168.4.188): icmp_seq=0.
64 bytes from sbc405gpr (192.168.4.188): icmp_seq=1.
64 bytes from sbc405gpr (192.168.4.188): icmp_seq=2.
----192.168.4.188 PING Statistics---3 packets transmitted, 3 packets received, 0% packet
round-trip (ms) min/avg/max = 0/0/0
>
time=0. ms
time=0. ms
time=0. ms
loss
reboot
Reboots a SkyPilot device.
Syntax
reboot
Arguments
None
Example
> reboot
Commands | 163
rebootap
Reboots a SkyPilot DualBand access point.
Syntax
rebootap
Arguments
None
Example
> rebootap
reload
Reloads a devices configuration file from the server.
Syntax
reload
Arguments
None
Example
> reload
>
Commands | 165
set acl
Adds, deletes, or clears a devices access control list (ACL), in real time.
Syntax
set acl add <subnet> <netmask> <destination> <protocol>
set acl del <row-index>
set acl clear
Arguments
subnet
IP address range to be accessed when using the ACLs specified port and
protocol.
netmask
destination
protocol
row-index
Example
> set acl add 0.0.0.0 0.0.0.0 23 1
> set acl add 192.168.0.0 255.255.0.0 23 1
> show acl
Index IP Address
----- --------------1
0.0.0.0
2
192.168.0.0
Subnet Mask
--------------0.0.0.0
255.255.0.0
Port
----23
23
Protocol
-------TCP
TCP
set activeimage
Specifies which partitions software image to use as the active image.
Syntax
set activeimage <A | B>
Arguments
A
Example
> set activeimage A
activeimage set
>
Commands | 167
set apwatchdog
Enables or disables a SkyExtender DualBands access point watchdog process.
NOTE
Changes you make with the set apwatchdog command take effect
immediately. This setting is not stored in the devices flash memory.
Syntax
set apwatchdog
Arguments
None
Example
> set apwatchdog
>
set buzzer
Sets (in real-time) sound pitch that indicates signal strength (SkyConnector only.
NOTE
To change the devices buzzer setting in its flash memory, use the
set prov buzzer command. The new setting will take effect when the
device is rebooted.
Syntax
set buzzer
Arguments
None
Example
> set buzzer
>
Commands | 169
set classifier
Sets (in real-time) the devices Quality of Service (QoS) classifiers.
NOTE
To change the devices QoS classifier settings in its flash memory, use the
set prov classifier command. The new settings will take effect
when the device is rebooted.
Syntax
set classifier
Arguments
None
Clears a classifier.
Example
> set classifier
Select a Classifier action: quit, add, delete, modify, list, clear
<q|a|d|m|l|c>: l
Rule TOS Low TOS High TOS Mask IP Protocol IP Src Addr IP IP Src
Mask
---- -------- -------- -------- ----------- --------------- -------------1
00010000 11111111 11111111 0x00
Rule IP Dest Addr
IP Dest Mask
Port Src1 Port Src2 Port Dest1
Port Dest2
---- --------------- --------------- --------- --------- --------- ---------1
Rule MAC Src
MAC Src Mask
MAC Dest
MAC Dest
Mask
---- ----------------- ----------------- ----------------- ---------------1
Commands | 171
set eth
Enable or disables the devices 10/100bT Ethernet interface, enables or disables
autonegotiation, and sets speed and duplexity, all in real-time. (By default, the
interface is enabled.)
NOTE
To change the devices Ethernet interface settings in its flash memory, use
the set prov eth command. The new settings will take effect when
the device is rebooted.
Syntax
set eth
Arguments
None
Example
> set eth
Select an Ethernet action: quit, state, negotiation, modify
<q|s|n|m>: m
Select speed [100bT]: 10bT, 100bT <10|100>:
Speed not changed: 100bT.
Select duplexity [f]: full, half <f|h>:
Duplexity not changed: full
Select an Ethernet action: quit, state, negotiation, modify
<q|s|n|m>: s
Select ethernet state [Enabled]: enable, disable <e|d>:
Ethernet state not changed: Enabled
Select an Ethernet action: quit, state, negotiation, modify
<q|s|n|m>: q
>
set factoryap
Resets a SkyExtender DualBands access point to its factory settings.
NOTE
Changes you make with the set factoryap command take effect
immediately. This setting is not stored in the devices flash memory.
Syntax
set factoryap
Arguments
None
Commands | 173
set filter
Sets up a devices packet filtering.
NOTE
Syntax
set filter
Arguments
None
Example
> set filter
Select a Filter action: quit, on, off , add, delete, permissions,
list, clear <q|y|n|a|d|p|l|c>: l
========= The Filter Table is OFF =========
1)
2)
3)
4)
5)
6)
7)
8)
9)
=
=
=
=
=
=
=
=
=
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
Commands | 175
set ip
Sets a manually provisioned devices IP address, subnet mask and default gateway.
Syntax
set ip
Arguments
None
subnet
gateway
Example
> set
Enter
Enter
Enter
>
ip
IP address [0.0.0.0]: 192.168.1.100
subnet mask [0.0.0.0]: 255.255.255.0
default gateway [0.0.0.0]: 192.168.1.1
set log
Defines the verbosity of system log messages that are displayed to the screen.
System log messages are maintained independently for a variety of facilities, and
each facilitys log level can be independently set. By changing the facility log
settings, you can easily troubleshoot all or part of your SkyPilot network.
Syntax
set log <facility | all> <level>
Arguments
facility
prov
auth
hello
linkopt
snmp
shaper
acl
filter
dynmod
all
level
None
No logging
Commands | 177
Example
To see the output of the hello process, you would change the log level of that
process from 1 (its default) to 2, with set log hello 2. With this log level set, a
message similar to the following would be displayed every time a hello message
exchange takes place:
> set log hello 2
> 0x80c760 (spLinkMgr): TS: 12660:10:01:48 0x80c760 (spLinkMgr):
spSystem.c:2200 (SP_HELLO_COMPONENT_ID) me <--- HELLO REQ v0
(...00:00:46, tx'd on ant 5)
set logevents
Defines the log events page size.
Syntax
set logevents pagesize <value>
Arguments
value
Commands | 179
set netkey
Sets (in real-time) the netkey used to authenticate a node on a network. All nodes
that belong to a given network must have the same netkey.
For security, the netkey itself is not accessible to you from the command line.
Therefore, you use a passphrase to manipulate the netkey. The passphrase
functions as a password, and should similarly be kept secret. The passphrase can
be up to 255 printable characters (non-printable and control characters are not
allowed). The passphrase default = SkyPilot Networks, Inc.
NOTE
Changes you make with the set netkey command take effect
immediately. The devices netkey is not stored in flash memory.
Syntax
set netkey
Arguments
None
Prompts you for the new netkey passphrase (a string of letters, numbers
and symbols
Example
> set netkey
Enter network key: ******
Re-enter network key: ******
Successfully set network key.
>
set password
Sets the password (in real-time) used to log in to the devices command-line
interface.
NOTE
Changes you make with the set password command take effect
immediately. The devices password is not stored in flash memory.
Syntax
set password
Arguments
None
Example
> set password
Enter new password: ********
Re-enter password: ********
Password changed.
>
Commands | 181
set power
Sets (in real-time) the SkyGateways transmit power.
NOTE
To change the SkyGateways power setting in its flash memory, use the
set prov power command. The new setting will take effect when the
SkyGateway is rebooted.
Syntax
set power <max | 4a | 2a | 1a | 4p>
Arguments
max
4a
2a
4p
set prov
Sets the devices provisioning mode to manual or automatic (default is automatic),
and for manually provisioned devices, sets any or all of the devices provisioning
parameters. Any changes you make with this command are stored in flash
memory, and do not take effect until the device is rebooted.
Arguments
all
auto
manual
command
None
Same as all.
Commands | 183
Commands | 185
auto
buzzer
classifier
domain
eth
filter
freq
ip
manual
parent
snmp
timezone
web
>
Commands | 187
NOTE
Changes you make with the set prov dhcp command are made to the
settings stored in flash memory, and do not take effect until the device is
rebooted. You cannot change a devices dhcp settings in real-time.
Syntax
set prov dhcp <renew | show>
Arguments
None
NOTE
Changes you make with the set prov domain command are made to
the settings stored in flash memory, and do not take effect until the
device is rebooted. You cannot change a devices domain setting in realtime.
Syntax
set prov domain
Arguments
None
Prompts you for the necessary value. Enter any of the following:
ID
all
None
Examples
> set prov domain
Enter domain ID (1-4096 or all) [ 10]: 1234
Domain ID changed: 1234
>
> set prov domain
Enter domain ID (1-4096 or all) [222]: all
Domain ID changed: 'all'
>
Commands | 189
NOTE
Changes you make with the set prov freq command are made to the
settings stored in flash memory, and do not take effect until the device is
rebooted. You cannot change a devices frequency settings in real-time.
Syntax
set prov freq
Arguments
None
Example
> set prov freq
19 available frequencies are the following:
5745 5750 5755 5760 5765 5770 5775 5780 5785 5790
5795 5800 5805 5810 5815 5820 5825 5830 5835
Select a Frequency action: quit, primary, allow, deny, list,
reqion, dwell time <q|p|a|d|l|r|t>: a
Allow frequency <(from above the list)|'all'>: 5795
Commands | 191
NOTE
Changes you make with the set prov parent command are made to
the settings stored in flash memory, and do not take effect until the
device is rebooted. You cannot change a devices parent settings in realtime.
Syntax
set prov parent <MAC>
Arguments
MAC
Device MAC
NOTE
Changes you make with the set prov vlan command are made to the
settings stored in flash memory, and do not take effect until the device is
rebooted. You cannot change a devices VLAN settings in real-time.
Syntax
set prov vlan <q|e|d|m>
Arguments
q
Example
> set prov vlan
Select a Vlan action: quit, enable, disable,
Select a Vlan action: quit, enable, disable,
Enter data Vlan (1-4096) [10]: 1234
Select a Vlan action: quit, enable, disable,
Enter management Vlan (1-4096) [1234]:
Select a Vlan action: quit, enable, disable,
>
modify
modify
<q|e|d|m>: e
<q|e|d|m>: m
modify
<q|e|d|m>: m
modify
<q|e|d|m>: q
Commands | 193
NOTE
Changes you make with the set prov web command are made to the
settings stored in flash memory, and do not take effect until the device is
rebooted. You cannot change a devices Web settings in real-time.
Syntax
set prov web
Arguments
None
Example
> set prov web
The WebServer is enabled
The End-User Page is enabled
Select an action
1) Toggle WebServer Status
2) Toggle End-User Page Status
3) Enter New Web Login Password
4)Quit
Choose... 1|2|3|4
1
> set prov web
The WebServer is Disabled
The End-User Page is enabled
Select an action
1) Toggle WebServer Status
2) Toggle End-User Page Status
3) Enter New Web Login Password
4)Quit
Choose... 1|2|3|4
1
>
set radar
Sets (in real-time) the SkyGateways radar detection state.
NOTE
To change the SkyGateways radar setting in its flash memory, use the
set prov radar command. The new setting will take effect when the
SkyGateway is rebooted.
Syntax
set radar <on | off>
Arguments
on
off
Commands | 195
set snmp
Sets SNMP community strings and trap receivers, in real-time. By default, no
community strings or trap receivers are configured on a SkyPilot network. For
information about SNMP, see SNMP on page 20.
To use the set snmp command, you select a modification target (for example, r
for a community read-only string), then set a modification action (such as a for
add), and finally enter the configuration setting (such as text for a community
string identifier).
NOTE
To change the devices SNMP settings in its flash memory, use the
set prov snmp command. The new settings will take effect when the
device is rebooted.
Syntax
set snmp <q|w|r|d|m>
Arguments
q
Goes back a prompt level (available at all command levels except the top
level)
Example
> set snmp
Commands | 197
set spectrum
Sets the spectrum analyzer configuration. (For detailed information about the
spectrum analyzer, see the spectrum command, described on page 248.)
Syntax
set spectrum <on | off | single | multi>
Arguments
on
off
single
multi
Example
> set spectrum single
Single channel spectrum settings
--------------------------------Set single channel mode <on | off> [off]: on
Mode changed: Single Channel Mode On
Set max visible rssi: dynamic adjust, rssi value <d | 1-100> [d]: d
Max visible rssi changed: dynamic adjust
Set graph height, number of lines <1-50> [16]:
Graph height not changed.
Set spectrum sleep timer: disable auto off, number of minute <d |
1-60> [5]:
Sleep timer not changed.
Set sampling time in second <1-60> [10]:
Sampling time not changed.
Set self activity filter: disable, enable <d | e> [e]:
Self activity filter setting has not changed.
>
set telnet
Specifies (in minutes) how long a telnet session to the device is allowed to remain
inactive before being terminated.
Syntax
set telnet
Arguments
None
Prompts you for the necessary value. Enter any of the following:
timeout
None
Example
> set telnet
Enter Telnet inactivity timeout or 0 to disable the timeout [30
minute(s)]: 35
This change applies to all active and future Telnet sessions: 35
minute(s)
>
Commands | 199
set timezone
Specifies an NTP (Network Time Protocol) server IP address and sets the GMT
offset for accurate time. An NTP server is required by the SkyPilot network, which
uses it to provide a synchronized time to all SkyPilot nodes. When a SkyPilot node
boots up, it has an initial default time of Jan 1, 1970. Using an NTP server, the node
adjusts its time to be synchronized with the NTP server, which typically is set to
UTC (Coordinated Universal Time) or GMT (Greenwich Mean Time).
For more information about the NTP server, see Ethernet Interface on page 19.
NOTE
To change the devices time zone setting in its flash memory, use the
set prov timezone command. The new setting will take effect when
the device is rebooted.
Syntax
set timezone <q|e|d|m>
Arguments
q
Modifies the NTP server IP address and time zone settings (for which you
will be prompted).
Example
> set timezone
Select a Timezone action: quit, enable, disable,
e
Select a Timezone action: quit, enable, disable,
m
Enter timezone NTP server [0.0.0.0]: 1.2.3.4
Enter timezone offset [0.00]: 10
Select a Timezone action: quit, enable, disable,
m
Enter timezone NTP server [1.2.3.4]:
Enter timezone offset [+10.00]:
Select a Timezone action: quit, enable, disable,
q
>
modify <q|e|d|m>:
modify <q|e|d|m>:
modify <q|e|d|m>:
modify <q|e|d|m>:
set trafficrate
Sets the devices traffic rate controls, in real-time. For more information about
traffic rates, see Quality of Service (QoS) on page 22.
NOTE
To change the devices traffic rate settings in its flash memory, use the
set prov trafficrate command. The new setting will take effect
when the device is rebooted.
Syntax
set trafficrate
Arguments
None
Example
> set trafficrate
Select a Traffic Rate Control Settings action: quit, enable,
disable, modify, clear <q|e|d|m|c>: m
Enter maximum upstream rate (Kbps) 64-10000 [10000]:
Enter maximum downstream rate (Kbps) 64-10000 [10000]:
Enter maximum broadcast rate (Kbps) 64-10000 [10000]:
Select a Traffic Rate Control Settings action: quit, enable,
disable, modify, clear <q|e|d|m|c>: q
>
Commands | 201
show acl
Displays the devices current Access Control List (ACL).
Syntax
show acl
Arguments
None
Example
> show acl
show acl
Index IP Address
Subnet Mask
Port Protocol
----- --------------- --------------- ----- -------1
192.168.4.0
255.255.255.0
161
UDP
>
show bridge
Displays the devices current bridge station cache and port information. Each
SkyPilot node functions as a bridge device, bridging the Ethernet interface with
the RF interface. Traffic originating from the Ethernet interface traverses the bridge
and is then sent out the RF interface. Conversely, traffic originating from the RF
interface traverses the bridge and is then sent out the Ethernet interface.
Syntax
show bridge [cache | port]
Arguments
cache
Lists all the devices bridge station cache entries, which contain MAC
addresses and the associated bridge port from which the MAC address
originates
port
None
Lists both the devices bridge station cache entries and the bridge port
entries
Field Descriptions
Table D-5 describes the fields displayed by the show bridge port command.
Table D-4. Fields Displayed for Bridge Ports
Field
Description
DevName
Num
Interface instance
MuxCookie
Device identifier
Type
Device type
Example
> show bridge
Bridge Station Cache Contents:
MAC Address
Tick
pPortInfo
Commands | 203
show config
Displays the devices current (running) configuration settings, which are result of
the configuration created during provisioning.
The configured primary frequency is the setting at which the node should be
operating. After the node downloads its configuration file, if the current operating
frequency does not match the configured frequency, then the node immediately
switches to the configured frequency.
Arguments
command
None
Commands | 205
show date
Displays the current system date and time.
Syntax
show date
Arguments
None
Example
> show date
FRI AUG 27 02:04:53 2004
show debug
Displays the devices current debug status (identical to the debug status
command).
Syntax
show debug
Arguments
None
Example
> show debug
Debug logging enabled.
>
Commands | 207
show dhcp
Displays the DHCP OFFER options. In order for a node to retrieve its network
management settings, it must perform DHCP negotiation. The node sends a
broadcast DHCP DISCOVER message. In response, the DHCP server sends a
DHCP OFFER message containing the options that the node needs.
If this command displays only the IP address, DHCP server, and FTP server, it
means the node did not receive a DHCP OFFER message.
Syntax
show dhcp
Arguments
None
Field Descriptions
Table D-5 describes the fields displayed by the show dhcp command.
Table D-5. Fields Displayed for DHCP Message Options (Page 1 of 2)
Field
Description
IP address
Layer 3 IP address
Subnet mask
Network mask
Broadcast
address
Default
gateway
Lease duration
Lease binding
Lease renewal
DHCP server
DNS server
Description
FTP server
HTTP server
NTP server
Hostname
Example
> show dhcp
IP address
Subnet mask
Broadcast address
Default gateway
Lease duration
Lease rebinding
Lease renewal
DHCP server
DNS server
FTP server
HTTP server
NTP server
Hostname
>
:
:
:
:
:
:
:
:
:
:
:
:
:
192.168.4.189
255.255.255.0
192.168.4.255
192.168.4.1
172800
150913
86113
192.168.4.100
172.16.1.2
192.168.4.100
192.168.4.103
172.16.1.20
marvin_mgw
Commands | 209
show domain
Displays the devices domain information.
Syntax
show domain
Arguments
None
Example
> show domain
Current Domain
>
:222
show filter
Displays either all filters in the system or a single filter specified as a command
parameter. In addition, the current filtering status is shown.
Syntax
show filter [table-number]
Arguments
table-number Displays only the specified entry in the systems filter table. The table-
Non-numeric
Same as None
Example
> show filter
========= The Filter Table is OFF =========
1) EtherType Table Default Permission
= "ALLOW"
2) IPType Table Default Permission
= "ALLOW"
3) IPaddrSrc Table Default Permission
= "ALLOW"
4) IPaddrDst Table Default Permission
= "ALLOW"
5) UDPSrcPort Table Default Permission
= "ALLOW"
6) UDPDstPort Table Default Permission
= "ALLOW"
7) TCPSrcPort Table Default Permission
= "ALLOW"
8) TCPDstPort Table Default Permission
= "ALLOW"
9) ARPsrcIPaddr Table Default Permission = "ALLOW"
>
Commands | 211
show gps
Displays the devices gps information.
Syntax
show gps <position | signal>
Arguments
position
signal
Example
> show gps position
GPS position
-----------Latitude : 37.381973
Longitude: -121.959969
Altitude : -12.145168
>
show int
Displays information for the Ethernet interface (including statistics), the RF
interface (SPID, IP address, and netmask), or both.
Syntax
show int [eth | rf]
Arguments
eth
rf
None
Field Descriptions
Tables D-6 and D-7 describe the fields shown for Ethernet and RF interfaces.
Table D-6. Fields Displayed for the Ethernet Interface (Page 1 of 2)
Field
Description
Internet
Address
IP address
Broadcast
Address
Broadcast address
Netmask
Ethernet
Address
Maximum
Transfer
Unit
Octets
Received
Octets Sent
Packets
Received
Packets Sent
Commands | 213
Description
Non-unicast
Packets
Received
Non-unicast
Packets Sent
Unicast
Packets
Received
Unicast
Packets Sent
Netmask
Description
SPID
Default
Gateway
PPS received
frames
received
frames sent
CRC errors
decrypt CRC
errors
Michael
errors
Description
RX - wrong
antenna
RX - too
small
RX - wrong
destination
The number frames received not destined for the local node.
RX - no link
RX drops
RX - mblk
events
TX errors
TX
timeouts
memory
events
descriptor
events
netJob
events
tau sync
events
PPS misses
PPS timeouts
discards
Commands | 215
Description
late
responses
no frame
events
busy events
Example
> show int
mirror (unit number 0):
Flags: (0x8063) UP BROADCAST MULTICAST ARP RUNNING
Type: ETHERNET_CSMACD
Internet address: 192.168.4.188
Broadcast address: 192.168.4.255
Netmask 0xffffff00 Subnetmask 0xffffff00
Ethernet address is 00:0a:db:09:52:6c
Metric is 0
Maximum Transfer Unit size is 1500
0 octets received
84 octets sent
0 packets received
2 packets sent
0 non-unicast packets received
0 non-unicast packets sent
0 unicast packets received
2 unicast packets sent
0 input discards
0 input unknown protocols
0 input errors
0 output errors
0 collisions; 0 dropped
Netmask: 255.255.255.0
radio:
SPID: 00:60:b3:09:53:21
Default Gateway: 00:60:b3:09:53:21
7085 PPS received
33066 frames received
31636 frames sent
123 CRC errors
0 decrypt CRC errors
0 Michael errors
0 RX - wrong antenna
0 RX - too small
0 RX - wrong destination
0 RX - no link
0 RX drops
0 RX - mblk events
0 TX errors
2529 TX timeouts
0 memory events
0 descriptor events
0 netJob events
1 tau sync events
42 PPS misses
0 PPS timeouts
0 discards
0 late responses
0 no frame events
0 busy events
>
Commands | 217
show ip
Displays a devices IP address information.
Syntax
show ip
Arguments
None
Example
> show ip
IP Address
Subnet Mask
Default Gateway
>
: 192.168.8.21
: 255.255.255.0
: 192.168.8.1
show ip2mac
Displays mapping table from the devices IP address to connected devices MAC
addresses, in ascending order.
Syntax
show ip2mac [IP]
Arguments
IP
None
Example
> show ip2mac
1) 192.168.8.101 -> 00:0a:db:09:52:73
>
Commands | 219
show link
Displays the link optimization table, the mesh link states, or mesh link statistics.
Link states and statistics include items such as frequency, transmit power, and
modulation (for a complete list, see Tables D-8 and D-9). A mesh link indicates a
link to another SkyPilot network node; it is used to transmit and receive data over
the RF interface.
Syntax
show link [opt| state | stats]
Arguments
opt
state
stats
Field Descriptions
Tables D-8 and D-9 describe the fields shown for link states and statistics,
respectively.
Table D-8. Fields Displayed for Link States (Page 1 of 2)
Field
Description
Node Id
LType
NType
State
LAnt
Local antenna.
RAnt
Remote antenna.
Mod
Local modulation.
Freq
Local frequency.
Description
TxPower
RxGain
Connect Time
Downed Time
First Opt
Time
Num of Opt
Description
Node Id
LType
RSSI
Last RSSI.
LTxMod
RTxMod
TxPow
Transmit power.
RxFrames
TxFrames
RxPackets
TxPackets
RxBytes
Commands | 221
Description
TxBytes
TxRetries
TxRLimit
RxMalformed
RxDuplicate
RxMissed
Queue Drops
RED Drops
TxAborts
Example
> show link
Node Id
LType NType State
RSSI LTxMod RTxMod LAnt RAnt
----------------- ----- ----- --------- ---- ------ ----00:0a:db:00:00:30 data ext
act mgmt 55
54
54
0
3
show link state
Node Id
LType NType State
LAnt RAnt Mod Freq TxPower
RxGain
----------------- ----- ----- --------- ---- ---- --- ---- -----------00:0a:db:00:00:30 data ext
act mgmt 0
3
54 5280 55
3
Node Id
Connect Time
Downed Time
First
Opt Time
Num of Opt
----------------- -------------------- -------------------- ------------------- ---------00:0a:db:00:00:30 AUG 27 2004 02:02:38 AUG 27 2004 02:01:03 AUG 27
2004 02:01:03 1
show link stats
Node Id
LType RSSI LTxMod RTxMod TxPow RxFrames
TxFrames
RxPackets
TxPackets
RxBytes
TxBytes
----------------- ----- ---- ------ ------ ----- ----------- ---------- ----------- ----------- ----------- ----------00:0a:db:00:00:30 data 55 54
54
40
3190
3444
954
963
1434894
1442316
Node Id
Drops RED Drops
Queue
----------------- ----- ----------- ----------- ----------- ---------- ----------- ----------- ----------- ----00:0a:db:00:00:30 data 0
0
2
0
0
0
0
0
>
Commands | 223
show log
Displays the devices current log settings.
For information about log facilities and levels, see set log on page 177.
Syntax
show log
Arguments
None
Example
> show log
Facility
-------system
prov
auth
hello
link
snmp
shaper
acl
filter
dynmod
spectrum
gps
radar
range
apwatchdog
Level
----: 1
: 2
: 1
: 1
: 2
: 1
: 1
: 1
: 1
: 1
: 1
: 1
: 1
: 1
: 1
>
show logevents
Displays the current page size.
Syntax
show logevents pagesize
Arguments
None
Commands | 225
show mac2ip
Displays mapping table from the devices MAC address to connected devices IP
addresses, in ascending order.
Syntax
show mac2ip [MAC]
Arguments
MAC
None
Example
> show mac2ip
1) 00:0a:db:09:52:73 -> 192.168.8.101
>
show mem
Displays detailed statistics about the available and allocated memory in the
system memory partition. Statistics include number of bytes, blocks, and average
block size in both free and allocated memory; and the maximum block size of free
memory.
Syntax
show mem
Arguments
None
Example
> show mem
status
bytes
blocks
avg block max block
------ ---------- --------- ---------- ---------current
free
1650624
60
27510
1474312
alloc
10540064
484
21776
cumulative
alloc
10600448
666
15916
-
Commands | 227
show mesh
Displays the mesh forwarding table, mesh route cost table, MAC learning table, or
all three.
Syntax
show mesh [fwd | route | mac]
Arguments
fwd
Displays the mesh forwarding table, which tells the node how to forward
packets to a destination node based on the immediate next hop.
route
Displays the mesh route cost table, which lists the possible hops the
node can take to reach the mesh SkyGateway. Each hop has an
associated cost, and the node always chooses the hop with the lowest
cost.
mac
Displays the MAC learning table, which represents the host machines
(PCs that are connected to the CPIE by an Ethernet cable, and which are
represented as MAC addresses) and their associated CPE (customer
premise equipment).
None
Displays the forwarding table, the mesh route cost table, and the MAC
learning table
Example
> show mesh route
Mesh Gateway
----------------00:0a:db:01:00:c2
Next Hop
----------------00:0a:db:01:00:c2
>
Cost
-------0
show netkey
Displays the hash of the netkey.
Syntax
show netkey
Arguments
None
Example
> show netkey
64:02:d6:45:58:be
>
Commands | 229
Arguments
None
Example
> show packet stats
--
--
00:0a:db:01:05:67|D
0|
|S
0|
00:0a:db:01:00:75|D
0|
|S
1489|
00:0a:db:01:39:bf|D
0|
|S
0|
00:0a:db:01:16:1f|D
0|
|S
572|
00:0a:db:09:53:b5|D
0|
|S
0|
00:0a:db:00:00:a9|D
0|
|S
1694|
00:0a:db:00:01:38|D
0|
|S
0|
00:0a:db:00:00:4a|D
0|
|S
0|
Subtotal |D
1081|
Subtotal |S
14077236|
------------------------------SPID
|
Shaper
|
00:0a:db:09:52:73|D
0|
|S
0|
Subtotal |D
0|
Subtotal |S
0|
----------------------------------------------------------------------------------------------|
Radio
|
Shaper
|
Bridge
|
Filter
|
Vlan
| Ethernet |
Sum of all SPID |D
1081|D
N/A |D
1225|D
0|D
N/A |D
0|
|S
14077236|S
N/A |S
24259727|S
318634|S
N/A |S
318634|
----------------------------------------------------------------------------------------------Total Packet Drops = 2306
D->Packet Drops;
S->Packet
Successes
>
show phyerrors
Displays a list of PHY errors for the devices radio chip.
Syntax
show phyerrors
Arguments
None
Example
> show phyerrors
PHY Layer Errors:
PHY 0 (Transmit underrun)
PHY 1 (Timing error)
PHY 2 (Illegal parity)
PHY 3 (Illegal rate)
PHY 4 (Illegal length)
PHY 5 (Radar detect)
PHY 6 (Illegal service)
PHY 7 (TX override receive)
PHY 8
PHY 9
PHY 10
PHY 11
PHY 12
PHY 13
PHY 14
PHY 15
PHY 16
PHY 17 (OFDM timing)
PHY 18 (OFDM signal parity)
PHY 19 (OFDM illegal rate)
PHY 20 (OFDM illegal length)
PHY 21 (OFDM power drop)
PHY 22 (OFDM illegal service)
PHY 23 (OFDM restart)
PHY 24
PHY 25 (CCK timing)
PHY 26 (CCK header CRC)
PHY 27 (CCK illegal rate)
PHY 28
PHY 29
PHY 30 (CCK illegal service)
PHY 31 (CCK restart)
>
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
:
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
0
Commands | 231
show process
Displays a list of all running operating system processes.
Syntax
show process
Arguments
None
Field Descriptions
Table D-10 describes the fields shown in response to the show process
command.
Table D-10. Fields Displayed for Processes (Page 1 of 2)
Field
Description
NAME
ENTRY
TID
Process ID.
PRI
Description
STATUS
PC
Program counter.
SP
Stack pointer.
ERRNO
DELAY
Commands | 233
Example
> show process
NAME ENTRY
TID
PRI
STATUS
PC
SP
ERRNO DELAY
---------- ------------ -------- --- ---------- -------- -------- ------ -tExcTask
excTask
efb530
0 PEND
2928ac
efb410
3006b 0
tWdbTask
wdbTask
a08588
3 PEND
236c60
a082e8
3d0002 0
spSchedulerspSchedulerT 5dd2f8 10 PEND
236c60 5dd238
0 0
spTimeTick spTimeTickTa 9fc4a0 55 PEND
237468 9fc380
0 0
spLinkMgr spLinkMgrTas 5d4090 60 PEND
20bffc 5d3ec0
0 0
spSlidingSlspSlidingSlo 5d92d0 65 PEND
20bffc 5d9150
0 0
spRoute
spRouteTaskE
5f27b0 70 PEND
20bffc
5f2620
1c0001 0
tNetTask netTask
eba9d0 90 PEND
236c60 eba8e0
0 0
spCLI
spCli
5e1d68 95 READY
23c354 5e0b68
3d0002 0
tTelnetd telnetd
5df448 100 PEND
236c60 5df0d8
0 0
tDhcpcState1a9ae0
a158f0 105 PEND
237468 a157e0
0 0
tDhcpcReadTdhcpcRead
a14300 105 PEND
236c60
a14050
3d0002 0
tSnmpd
221938
a03708 110 PEND
236c60
a02c58
3d0002 0
spLinkPing spLinkPingTa
5efe90 120 PEND
20bffc
5efce0
1c0001 0
tSnmpTmr 221544
a04970 150 PEND
2928ac a04830
0 0
tLogTask logTask
ef8b48 200 PEND
2928ac ef8a38
0 0
spSystem
spSystemTask
5d69b0 200 DELAY
23bcd0
5d68f0
30065 23
spProvisionspProvisionA
9f7d78 205 PEND
20bffc
9f7af8
1c00010
spAuthenticspAuthManage
5e8330 208 PEND
20bffc
5e7d50
1c0001 0
spTraceRoutespTraceRoute
5e4688 210 PEND
20bffc
5e44e8
1c00010
spTTCPT
spTTCPTCPSer 5ed570 220 PEND
236c60 5ed290
0 0
spTTCPU
spTTCPUDPSer 5eac50 220 PEND
236c60 5eaa20
0 0
spTemperatuspTemperatur 5f3d48 240 DELAY
23bcd0 5f3c78
038
tBridgeAger17f144
a0c980 250 DELAY
23bcd0
a0c8d0
0
>
show prov
Displays all the devices provisioning parameters and their current values.
Command Syntax:
show prov
Arguments
None
Example
> show prov
--
--
=
=
=
=
=
=
=
=
=
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
"ALLOW"
>
Commands | 235
show radar
Displays the devices radar detection mode.
Syntax
show radar
Arguments
None
Example
> show radar
Radar detection
>
: Disable
show reboot
Displays the reason for the devices most recent reboot.
Syntax
show radar
Arguments
None
Example
> show reboot
Reboot reason: Soft Reboot
Details: CLI reboot
>
Commands | 237
show snmp
Displays the devices current snmp settings.
Syntax
show snmp
Arguments
None
Example
> show snmp
Mode
Read-write community strings
Read-only community strings
Trap destinations
:
:
:
:
>
disabled
0
0
0
show spectrum
Runs the spectrum analyzer according to its current settings, and displays the
results. (For detailed information about the spectrum analyzer, see the
spectrum command, described on page 248.)
Syntax
show spectrum
Arguments
None
Example
> show spectrum
Wait for 10 seconds.
( Single Channel 5805Mhz )
( Sampling Time: 10 seconds)
RSSI
61
57
53
49
45 26
22
19
15
11
7
- 3
- :
-------------------------Ant 0 1 2 3 4 5 6 7 All
'X' - Indicates no data collected
'-' - Max hold Rssi
':' - Average Rssi
( Single Channel 5805Mhz )
( Sampling Time: 10 seconds)
Ant
MaxRssi
AvgRssi
MinRssi
-----------------------------------0 |
46
|
1
|
0
|
1 |
8
|
0
|
0
|
2 |
4
|
0
|
0
|
3 |
10
|
4
|
0
|
4 |
7
|
0
|
0
|
5 |
34
|
0
|
0
|
6 |
61
|
1
|
0
|
7 |
11
|
1
|
0
|
all |
61
|
0
|
0
|
>
Commands | 239
show stack
Displays a table of stack memory usage for all processes. Each process is given a
finite amount of stack memory; you can use this command to determine how
much of the stack memory has been used, and perhaps avoid stack overflow. The
display includes the total stack size (SIZE), current number of stack bytes used
(CUR), maximum number of stack bytes used (HIGH), and number of bytes never
used at the top of the stack (MARGIN = SIZE - HIGH).
Syntax
show stack
Arguments
None
Example
> show stack
NAME
ENTRY
TID
SIZE
CUR HIGH MARGIN
------------ ------------ -------- ----- ----- ----- -----tExcTask
excTask
efb530
7984
288
432
7552
tWdbTask
wdbTask
a08588
8176
672
836
7340
spScheduler spSchedulerT 5dd2f8
9984
192
452
9532
spTimeTick
spTimeTickTa 9fc4a0
9984
288
660
9324
spLinkMgr
spLinkMgrTas 5d4090
9984
464 2480
7504
spSlidingSlo spSlidingSlo 5d92d0
9976
384
464
9512
spRoute
spRouteTaskE 5f27b0
9992
400
880
9112
tNetTask
netTask
eba9d0
9984
240 1136
8848
spCLI
spCli
5e1d68
9992 4400 4868
5124
tTelnetd
telnetd
5df448
7984
880
960
7024
tDhcpcStateT 0x00001a9ae0 a158f0
4984
272
336
4648
tDhcpcReadTa dhcpcRead
a14300
4984
688
848
4136
tSnmpd
0x0000221938 a03708
28664 2736 2896 25768
spLinkPing
spLinkPingTa 5efe90
9984
432
912
9072
tSnmpTmr
0x0000221544 a04970
4080
320
464
3616
tLogTask
logTask
ef8b48
4984
272 1428
3556
spSystem
spSystemTask 5d69b0
9984
192
500
9484
spProvisionA spProvisionA 9f7d78
9976
640 1312
8664
spAuthentica spAuthManage 5e8330
14976 1504 8036
6940
spTraceRoute spTraceRoute 5e4688
9984
416
896
9088
spTTCPT
spTTCPTCPSer 5ed570
9992
736 1028
8964
spTTCPU
spTTCPUDPSer 5eac50
9992
560
704
9288
spTemperatur spTemperatur 5f3d48
4984
208
544
4440
tBridgeAger 0x000017f144 a0c980
4080
176
320
3760
INTERRUPT
5000
0
960
4040
show status
Displays the devices current provisioning parameters.
Command Syntax:
show status
Arguments
None
Example
> show status
--
--
==================================================================
Frequency Settings
-----------------Frequency range setting stored in flash is: US high band
Current frequency range setting is: US high band
Current frequency is: 5805
Current valid frequencies are:
5745 5750 5755 5760 5765 5770 5775 5780 5785
Dwell time (minutes): 1
5790
==================================================================
VLAN
---Management : Disabled
Data
: Disabled (P2P Enabled)
VLAN ID
---------VLAN
SNMP
---Mode
Read-write community strings
Read-only community strings
Trap destinations
:
:
:
:
disabled
0
0
0
==================================================================
VLAN
Timezone Settings
----------------Enable
: no
NTP server IP address
: 0.0.0.0
Offset
: 0.00
>
Commands | 241
show tech
Displays the nodes current configuration and status.
Command Syntax:
show tech
Arguments
None
Example
> show tech
-[lines omitted for brevity]
Access Control List
-------------------
--
==================================================================
Filters
------Enable
: no
EtherType dflt permission
IP Protocol dflt permission
IP Address dst dflt permission
IP Address src dflt permission
ARP src dflt permission
Port dst dflt permission
Port src default permission
:
:
:
:
:
:
:
allow
allow
allow
allow
allow
allow
allow
==================================================================
*************** 16) Show Reboot *********************
Reboot reason: Soft Reboot
Details: CLI reboot
>
show temp
Displays the temperature of the devices radio, in both degrees Celsius and
degrees Fahrenheit.
Syntax
show temp
Arguments
None
Example
> show temp
Celsius = 30
Fahrenheit = 87
>
Commands | 243
show timezone
Displays the devices time zone information.
Syntax
show timezone
Arguments
None
Example
> show timezone
Enable
NTP server IP address
Offset
: no
: 0.0.0.0
: 0.00
>
show trafficrate
Displays the devices traffic rate control settings.
Syntax
show trafficrate
Arguments
None
Example
> show trafficrate
Maximum Upstream Rate
Maximum Downstream Rate
Maximum Broadcast Rate
: 10000 kbps
: 10000 kbps
: 10000 kbps
>
Commands | 245
show uptime
Displays the elapsed time (in days, hours, minutes, and seconds) since the device
was last booted.
Syntax
show uptime
Arguments
None
Example
> show uptime
0 days 01:39:18
show vlan
Displays the devices VLAN settings.
Syntax
show vlan
Arguments
None
Example
> show vlan
Management : Disabled
Data
: Disabled (P2P Enabled)
VLAN ID
--------->
Commands | 247
spectrum
Displays full documentation (help) for the SkyPilot spectrum analyzer.
Syntax
spectrum
Arguments
None
Example
> spectrum
--- Spectrum Help --The spectrum analyzer feature consists of two operating modes single channel and multi channel. Single channel focuses on the
current operating channel without disrupting service, showing the
results of every antenna that currently formed links allow for.
Multi channel disables normal functionality and scans through a
specified range of frequencies, displaying the results per antenna.
General Commands
-----------spectrum- Shows this help page.
show spectrum mode- Shows the current running mode.
set spectrum on <single | multi> - Enables the spectrum analyzer in
specified mode.
set spectrum off- Turns off the current spectrum mode.
clear spectrum - Clears the max hold rssi statistics.
show spectrum single - shortcut for spectrum single channel
graph.
show spectrum multi - shortcut for spectrum multi channel graph.
show spectrum - re-runs the last spectrum show graph
command issued.
Single Channel Commands
----------------------show spectrum single graph [seconds]
- shows a single channel graph. Automatically enables single
channel mode if it is not already enabled. The optional
seconds argument is used to set the sampling time.
show spectrum single setting
- shows single channel settings and running statistics.
Multi Channel Commands
----------------------
Commands | 249
traceroute
Traces a path to the destination MAC address, discovering intermediate nodes
along this path.
Syntax
traceroute [MAC]
Arguments
MAC
None
Example
> traceroute 00:0a:db:09:52:73
traceroute to 00:0a:db:09:52:73
>
1 (36) --> 09:52:73 --> (36)
>
Commands | 251
252
E
Web-Based Command Tool Reference
This appendix provides instructions for accessing SkyPilot devices Web-based
command tool interface, as well as detailed descriptions of all the commands
available through this interface.
Appendix Highlights
About the Web-based command tool
Accessing the Web-based command tool
Command Pages
TIP
When you use the Web-based command tool to make changes to devices
provisioning parameter values, the changes are made to the configuration stored
in flash memory. Therefore, you must reboot the device in order for your change
to take effect.
TIP
Prepare a PC or laptop.
Open the network settings panel and assign the computer an IP address from
192.168.0.4 to 192.168.0.254, and a subnet mask of 255.255.255.0. (For
information changing a devices IP address from its default, see Managing IP
Addresses on page 54.)
Confirm that you can communicate with the SkyPilot device by pinging its
address on the subnet.
If the ping is successful, you are ready to connect to the Web-based
command tool (see Starting the Web-Based Command Tool on page 257).
If the ping is unsuccessful, check your connections and confirm the device IP
address before again pinging the device.
Confirm that the SkyPilot device is configured correctly and connected to the
SkyPilot wireless mesh network.
Confirm that you can communicate with the SkyPilot device by pinging the
address you identified in step 2.
If you can ping the IP address of the access point, you are ready to connect to
the Web-based command tool (see Starting the Web-Based Command Tool
on page 257).
If you cannot ping the IP address, check your connections and confirm the
device IP address before again pinging the device.
Open a Web browser, and go to the URL for the SkyPilot devices login page
the devices IP address, followed by the string, /admin.
The Web-based command tool displays the Login screen.
Enter the User Name and Password. The default User Name is admin, and the
default Password is public.
The Web-based command tool displays the Home screen, which shows
detailed information about the SkyPilot device you are accessing.
Link Pages
Link pages provide multiple levels of information about the network links that the
SkyPilot device forms with other devices on the wireless mess network. Link pages
are useful for confirming wireless mesh operations and troubleshooting problems
a device may be experiencing.
NOTE
The Link pages are for monitoring only, and do not provide any
configuration modification options. For a list of possible link states, see
Monitoring Link States on page 53.
Links
The Links page displays a summary of link states established by the SkyPilot node.
To view the Link States (summary) page:
1
Click Links.
The Web-based command tool displays the Links States summary screen. For
each link, the following information is shown: MAC address, link type, node
type, RSSI, and other information related to radio antenna operations.
Link State
The Link State page displays a summary of link states established by the SkyPilot
node.
To view the Link States (detail) page:
1
Link Statistics
The Link Stats page displays a detailed information about a devices active links.
To view the Link Stats (statistics) page:
1
Provisioning Pages
Provisioning pages allow you to view and modify the configuration stored in a
devices flash memory. (Any changes you make will not take effect until the device
is restarted.)
IP Page
Use the IP page to configure the devices static IP address, subnet mask, and
gateway.
To configure IP settings:
1
Click IP.
The Web-based command tool displays the IP screen.
Enter information for any of the configuration items you want to modify.
Click Submit.
Frequency Page
Use the Frequency page to configure the devices frequency settings. (See
Frequency on page 16.)
To configure frequency settings:
1
Click Frequency.
The Web-based command tool displays the Frequency screen.
Enter information for any of the configuration items you want to modify.
Click Submit.
VLAN Page
Use the VLAN page to enable or disable VLANs and to specify the VLAN you want
to use with the SkyPilot device. (See Virtual Local Area Networks (VLANs) on
page 17.)
To configure VLAN settings:
1
Click VLAN.
The Web-based command tool displays the VLAN screen.
Enter information for any of the configuration items you want to modify.
Click Submit.
ACL Page
Use the ACL page to configure access control lists. (For information about ACLs,
see Access Control Lists (ACLs) on page 45.)
To configure ACL settings:
1
Click ACL.
The Web-based command tool displays the ACL screen.
Enter information for any of the configuration items you want to modify.
Click Submit.
SNMP Page
Use the SN MP page to configure SNMP for your SkyPilot devices. For information
about SkyPilot SNMP, see SNMP on page 20. For information about using
SkyControl, see Monitoring a Networks Topology by Using SkyControl on
page 52.
To configure SNMP settings:
1
Click SNMP.
The Web-based command tool displays the SNMP screen.
Enter information for any of the configuration items you want to modify.
Click Submit.
Ethernet Page
Use the Ethernet page to configure the Ethernet interfaces state and
characteristics. (See Ethernet Interface on page 19.)
To configure Ethernet interface settings:
1
Click Ethernet.
The Web-based command tool displays the Ethernet screen.
Enter information for any of the configuration items you want to modify.
Click Submit.
Filters Page
Use the Filters page to set global and individual permissions for any existing filters.
(See Filtering on page 27.)
To configure filter permissions:
1
In the navigation pane, expand the Provisioning tree, and then the Filters
tree.
Click Filters.
The Web-based command tool displays the Filters screen.
Enter information for any of the configuration items you want to modify.
Click Submit.
In the navigation pane, expand the Provisioning tree, and then the Filters
tree.
To delete a filter, enter its index. To add a filter, select the desired options from
the lists.
Click Submit.
In the navigation pane, expand the Provisioning tree, and then the Filters
tree.
To delete a filter, enter its index. To add a filter, select the desired options from
the lists.
Click Submit.
In the navigation pane, expand the Provisioning tree, and then the Filters
tree.
To delete a filter, enter its index. To add a filter, select the desired options from
the lists.
Click Submit.
In the navigation pane, expand the Provisioning tree, and then the Filters
tree.
To delete a filter, enter its index. To add a filter, select the desired options from
the lists.
Click Submit.
QoS Pages
Use the QoS pages to configure global traffic rate controls and traffic rate rules for
your SkyPilot network. (See Quality of Service (QoS) on page 22.)
In the navigation pane, expand the Provisioning tree, and then the QoS tree.
To add a traffic rate control (QoS rule), select the desired options from the lists.
To delete a traffic rate control (QoS rule), enter its index.
Click Submit.
In the navigation pane, expand the Provisioning tree, and then the QoS tree.
Enter the desired rate controls and choose Enabled or Disabled from the
Traffic Rule list.
Click Submit.
Password Page
Use the Password page to change the password used to log in to the devices
Web-based command tool interface.
To change the Web-based command tool password:
1
Click Submit.
Version Pages
Use the Version pages to view the versions of hardware and software on a device,
to add software images to a device, and to specify which partition is the active
partition. See Managing Software Images on page 42.
Version HW Page
The Version HW page displays the devices hardware settings.
To view the Version HW page:
1
Version SW Page
The Version SW page displays the devices software settings.
To view the Version SW page:
1
Click Submit.
Utilities Pages
The Utilities pages provide tools to help you with troubleshooting and
maintenance tasks:
PingLayer 3 ping utility.
Node testTwo-way link layer ping test.
RebootDevice reboot.
TraceroutePath trace from the local node to the destination MAC address.
To use a SkyPilot utility:
1
Click utility, where utility is the page corresponding to the desired task.
The Web-based command tool displays the corresponding utility screen.
Glossary
This Glossary provides a list of terms and definitions relating to SkyPilot. In
addition, definitions of some general network and communications terms are
included.
AP
Access Point. You can specify how much authentication the AP performs.
MAC Media Access Control address. A unique identifier specific to the network
card inside a computer.
MIB Management Information Base.
netkey Shared network key.
NOC Network Operations Center.
OTA Over-the-Air.
PoE Power over Ethernet.
POP
280 | Glossary