Juniper WLM1200-RMTS User manual

Copyright © 2011, Juniper Networks, Inc. 1
WLM1200-RMTS™User’s Guide

WLM1200-RMTS™ User Guide
2 Contents Copyright © 2011, Juniper Networks, Inc.
WLM1200-RMTS™User Guide
Contents
WLM1200-RMTS Publication Suite
This guide is part of a publications suite that describes the WLM1200-RMTS installation and operation. It is
intended for network administrators or persons responsible for installing and using a WLM1200-RMTS for
managing 802.11-based Wireless LANs (WLANs) using Juniper hardware and software.
The following documents provide information on how to plan, install, configure and manage a
WLM1200-RMTS.
WLM1200-RMTS Hardware Setup Guide — Provides procedures for site preparation, physical
installation and cabling connections.
WLM1200-RMTS Quick Start — This guide provides a description of prerequisite procedures required to
install and begin using RingMaster Appliance hardware and software.
WLM1200-RMTS User’s Guide (this document) — This guide describes the Juniper Networks
WLM1200-RMTS Appliance, which delivers the RingMaster application combined with an Operating
system (OS) on an appliance hardware platform. This appliance eliminates setting up of an execution
environment for a RingMaster Server. By providing an execution environment, this appliance delivers an
assured level of scalability, along with reduced maintenance overhead. After performing basic
configuration to incorporate the appliance into a network, normal maintenance involves installation of
periodic updates from Juniper Networks.
WLM1200-RMTS Publication Suite . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
WLM1200-RMTS Hardware Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Software Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Appliance Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Platform Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Initial RingMaster Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Forgotten Password Recovery . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Web Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

Copyright © 2011, Juniper Networks, Inc. WLM1200-RMTS Publication Suite 3
WLM1200-RMTS™ User Guide
WLM1200-RMTS Hardware Description
The WLM1200-RMTS Appliance is a platform is a server on which to run RingMaster Services software.
This device has the hardware features, OS and RingMaster software required to function as a server for
RingMaster Software.
Processors and RAM
Two Quad-Core Intel Xeon 2.66 GHz CPUs
4 GB RAM
Disk Configuration
Two 250 GB Hard Drives
Hardware Description
WLM1200-RMTS is set up with a dual boot partition scheme. One partition holds the active (running)
system image and the other partition holds the standby (next) system image. An interface provides for
management of these partitions. In order to provide reliability in the case of a disk failure, the system
utilizes disks in a RAID-1 mirroring scheme.
Interfaces
Serial console port
Two 10/100/1000 Base T interfaces
Serial Interface Ethernet Connectors

WLM1200-RMTS™ User Guide
4 Software Description Copyright © 2011, Juniper Networks, Inc.
Software Description
OS
The RingMaster appliance runs on the Linux operating system. The WLM1200-RMTS does not provide
any means of accessing the OS shell to run arbitrary commands.
CLI
A Command Line Interface (CLI) is provided through a serial port. This interface allows configuration of
platform-related settings and is equivalent to that of the platform configuration Web interface. The CLI
provides a subset of the functionality provided by the Web interface. For details, see Using The Command
Line Interface below.
Web
The WLM1200-RMTS supports a Web interface for configuring RingMaster tunables plus a new interface
for configuring platform-related settings like networking, date/time, etc. The RingMaster configuration Web
interface is accessed via HTTPS on port 443. You have the option as to whether or not access control
should be enabled for this interface. The WLM1200-RMTS’s platform configuration Web interface is
accessed via HTTPS on port 8003. Links in both interfaces allow navigation between the two. Access
control is always enabled for the platform configuration Web interface. There are two users — admin and
monitor — defined for the platform settings Web interface.
Image Upgrade
WLM1200-RMTS software is distributed as a single image containing both the OS and the RingMaster
application. The installation procedure is based on an active/standby partitioning scheme where the new
software is setup in the standby partition. The system does not reboot itself as part of an upgrade. The
upgrade sets up the standby partition. You must make upgrades effective by manually rebooting the
system. If anything goes wrong during an installation procedure, the system resorts to running the
previously active partition.
A Web-based mechanism is also provided for you to manually revert to the previously active partition at
any time. If this revert operation is invoked, the state of the RingMaster application (plans and monitoring
database) also reverts to the state at which the previous installation occurred.
Factory Reset
The WLM1200-RMTS supports a CLI-based mechanism to reset the platform and RingMaster application
settings back to default settings. This operation does not affect the executable software running on the
appliance. It resets the configuration to a default state compatible with currently active software. Any
existing RingMaster plans as well as the monitoring database are cleared as part of this operation. All
licensing information is also deleted.
A mechanism is provided to reset the admin password should you forget it. This mechanism is only
provided through the CLI on the serial port. The reset operation does not affect any other platform
configuration other than the password.

Copyright © 2011, Juniper Networks, Inc. Platform Configuration 5
WLM1200-RMTS™ User Guide
Licensing
License Distribution
The WLM1200-RMTS is shipped with a license certificate for 250 APs. You must install and activate the
base license and all additional AP licenses.
Appliance Installation
Complete instructions regarding site preparation, unit unpacking and equipment installation are provided in
the publication WLM1200-RMTS Hardware Setup Guide including information on cabling connections to
the unit from a power source and for networking interfaces.
Platform Configuration
Initial RingMaster Setup
When the WLM1200-RMTS is shipped, RingMaster software is already installed, including the latest OS
and RingMaster software. When powering up for the first time, the only function available to you is the
setup wizard. You use this initial setup wizard to specify basic platform information, such as how to connect
to a network, before appliance functionality is enabled. This wizard is implemented as a CLI-based
mechanism accessible through the appliance’s serial port.
When you connect to this port, you are prompted for the following information:
Hostname
Networking
−Selection of DHCP or static IP
−If static IP
>IP address and netmask
>Default gateway
>IP address of primary name server and domain name
Administrator password — The wizard uses this to set up a user named admin.
Command Line Interface
A command line interface is supported on the appliance’s serial port. The commands supported provide a
subset of the functionality provided by the Web interface.
Specifically, the following is supported:
Networking
Image Upgrade
Factory Reset
Shutdown/Reboot
The one CLI-only function is the factory reset command.

WLM1200-RMTS™ User Guide
6 Using The Command Line Interface Copyright © 2011, Juniper Networks, Inc.
Using The Command Line Interface
The CLI presents a prompt with the platform name, which in our example above is rm200a1.
This prompt looks like this:
rm200a1 >
When in enabled mode, this prompt changes to the following:
rm200a1 #
CLI Commands
The CLI for this device includes a number of commands, as listed below from capture from an
WLM1200-RMTS, showing commands implemented and options for accessing them and getting help
regarding their use.
Login
login as: admin
Trapeze Networks WLM1200-RMTS Platform
Last login: Mon Dec 10 22:33:34 2007 from 172.21.26.220
Trapeze Networks WLM1200-RMTS Platform
Getting Help
rm200a1 # help ?
<cr>
rm200a1 # help
You may request context-sensitive help at any time by pressing '?'
on the command line. This will show a list of choices for the
word you are on, or a list of top-level commands if you have not
typed anything yet.
If "<cr>" is shown, that means that what you have entered so far s a complete command, and you may
press Enter (carriage return) to execute it.
Try the following to get started:
?
show ?
show c?
show clock?
show clock ?
show interfaces ? (from enable mode)
show ? Command
rm200a1 > show ?
bootvarDisplay installed system images and boot parameters
hostsDisplay hostname, DNS configuration, and static host mappings
imagesDisplay information about system images and boot parameters
terminalDisplay terminal parameters
versionDisplay version information for current system image
whoamiDisplay the identity and capabilities of the current user

Copyright © 2011, Juniper Networks, Inc. Using The Command Line Interface 7
WLM1200-RMTS™ User Guide
show bootvar Command
rm200a1 > show bootvar
Installed images:
Partition 1:
ringmaster 6.3.1.0.3 #1-dev 2007-12-10 08:25:40 i386 root@rmabuild:unknown
Partition 2:
ringmaster 6.3.0.0.51 #1-dev 2007-11-27 09:57:16 i386 root@rmbuild:cvs/HEAD
Last boot partition: 1
Next boot partition: 1
No boot manager password is set
show hosts Command
rm200a1 > show hosts
Hostname: rm200a1
Name server: 172.21.129.10 (dynamic)
Name server: 172.21.129.33 (dynamic)
Domain name: trpz.com (dynamic)
IP 127.0.0.1 maps to hostname localhost
IP 127.0.0.1 maps to hostname rm200a1
show terminal Command
rm200a1 > show terminal
CLI current session settings
Terminal width: 80 columns
Terminal length: 24 rows
Terminal type: xterm
show version Command
rm200a1 > show version
Product name: ringmaster
Product release: 6.3.1.0.3
Build ID: #1-dev
Build date: 2007-12-10 08:25:40
Build arch: i386
Built by: [email protected]z.com
Uptime: 46m 5.780s
Product model: rm200
Host ID: 07f98f2901db
System memory: 284 MB used / 3609 MB free / 4041 MB total
Number of CPUs: 8
CPU load averages: 0.01 / 0.03 / 0.00
show whoami Command
rm200a1 > show whoami
Current user: admin

WLM1200-RMTS™ User Guide
8 Using The Command Line Interface Copyright © 2011, Juniper Networks, Inc.
rm200a1 > en
rm200a1 # show ?
bootvar Display installed system images and boot parameters
hosts Display hostname, DNS configuration, and static host mappings
images Display information about system images and boot parameters
interfaces Display detailed running state for all interfaces
ip Display IP-related information
log View event logs
running-config Display commands to recreate current running configuration
terminal Display terminal parameters
version Display version information for current system image
whoami Display the identity and capabilities of the current user
Enable Mode
After you type enable or en at a rm200a1 > prompt, you see a rm200a1 # prompt:
Enable Mode Commands
rm200a1 # ?
configure Enter configuration mode
disable Leave enable mode
email Configure email and event notification via email
exit Log out of the CLI
help View description of the interactive help system
image Manipulate system software images
no Negate or clear certain configuration options
ping Send ICMP echo requests to a specified host
reload Reboot or shut down the system
show Display system configuration or statistics
terminal Set terminal parameters
write Save the running configuration to persistent storage
configure ? Command
rm200a1 # configure ?
terminal Enter configuration mode
show clock Command
rm200a1 # show clock
Time: 23:30:21
Date: 2007/12/10
Time zone: GMT-offset GMT
configure terminal Command
rm200a1 # configure terminal
rm200a1 (config) # show ?
bootvar Display installed system images and boot parameters
hosts Display hostname, DNS configuration, and static host mappings
images Display information about system images and boot parameters
interfaces Display detailed running state for all interfaces
ip Display IP-related information
log View event logs
running-config Display commands to recreate current running configuration
terminal Display terminal parameters
version Display version information for current system image
whoami Display the identity and capabilities of the current user
rm200a1 # email ?
send-test Send test email to all configured event and failure recipients

Copyright © 2011, Juniper Networks, Inc. Using The Command Line Interface 9
WLM1200-RMTS™ User Guide
show image Command
rm200a1 # show image
Images available to be installed:
webimage.tbz
ringmaster 6.3.1.0.3 #1-dev 2007-12-10 08:25:40 i386 root@rmabuild:unknown
Installed images:
Partition 1:
ringmaster 6.3.1.0.3 #1-dev 2007-12-10 08:25:40 i386 root@rmabuild:unknown
Partition 2:
ringmaster 6.3.0.0.51 #1-dev 2007-11-27 09:57:16 i386 root@rmbuild:cvs/HEAD
Last boot partition: 1
Next boot partition: 1
No boot manager password is set.
ping Command
rm200a1 # ping
Usage: ping [-LRUbdfnqrvVaA] [-c count] [-i interval] [-w deadline]
[-p pattern] [-s packetsize] [-t ttl] [-I interface or address]
[-M mtu discovery hint] [-S sndbuf]show ?
Show ?
?
[ -T timestamp option ] [ -Q tos ] [hop1 ...] destination
show ip ? Command
rm200a1 # show ip ?
default-gateway Display the active default route
route Display routing table
rm200a1 # show running-config
##
## Running database "initial"
##
##
## Network interface configuration
##
interface eth0 create
interface eth0 dhcp
interface eth0 display
interface eth0 duplex auto
interface eth0 mtu 1500
no interface eth0 shutdown
interface eth0 speed auto
no interface eth0 zeroconf
##
## Other IP configuration
##
ip host rm200a1 127.0.0.1
hostname rm200a1
show terminal Command
rm200a1 # show terminal
CLI current session settings
Terminal width: 80 columns

WLM1200-RMTS™ User Guide
10 Forgotten Password Recovery Copyright © 2011, Juniper Networks, Inc.
Terminal length: 24 rows
Terminal type: xterm
show version Command
rm200a1 # show version
Product name: ringmaster
Product release: 6.3.1.0.3
Build ID: #1-dev
Build date: 2007-12-10 08:25:40
Build arch: i386
Built by: [email protected]z.com
Uptime: 58m 7.760s
Product model: rm200
Host ID: 07f98f2901db
System memory: 285 MB used / 3606 MB free / 4041 MB total
Number of CPUs: 8
CPU load averages: 0.00 / 0.00 / 0.00
Forgotten Password Recovery
If the administrator of a system forgets the password of the user admin, the following method can be used
to reset the password to the empty password so that the system can be accessed as admin with no
password required. The password can then reset to a secure one via the CLI.
The procedure is as follows:
1. Boot the system to single user and execute a script to reset the admin password in the active
database. If any database corruption is suspected, the script resets the system database to its
initialized default. The admin password is not set in such a database. A system booted to single user
mode does not require a privileged user password. The system can be rebooted by power cycling. It is
assumed the person using this procedure is able to access the system’s console and can see the
entire boot process (this is either over a serial console or the system’s direct console).
2. Once the system is starting to boot, the following GRUB message should be seen (GRUB is the boot
loader for the system):
Grub Loading stage 2...
Press any key to continue.
[This message repeats (once a second) on a new line several times, and if no key is pressed the system
boots normally. You should press a key to enter the GRUB command line]
.
.
.
Press any key to continue.
[Assume the user presses the space key (for example)]
3. Next, you should see the following GRUB text which allows you to select one of the 2 images to be
booted. Choose the desired image by using the arrow keys so that GRUB indicates that the desired
entry will be booted.
GRUB version 0.93 (640K lower / 259536K upper memory)
-------------------------------------------------------------------