Cisco Systems NME-WAE User Manual
Configuring Cisco Access Routers and the
NME-WAE Network Module for ACNS
Deployments
April 14, 2008
This document describes how to configure the Cisco access router and the Cisco Wide Area Application
Engine network module (NME-WAE) for Application and Content Networking System (ACNS)
software deployments.
The WAE network module is a standalone Wide Area Application Engine (WAE) that plugs into a host
Cisco access router. The host router runs Cisco IOS software, while the WAE network module has its
own startup and run-time configurations that are independent of the IOS configuration on the router.
Contents
ACNS software is a Linux-based application that resides on the WAE network module. ACNS software
offers the following content-based services:
• Content caching and hosting
• Proxy services
• Content replication
• Video streaming
The host router and the network module combined provide a router-integrated application platform for
accelerating data-intensive applications.
• Prerequisites for Installing the Cisco WAE Network Modules, page 2
• Restrictions for Cisco WAE Network Modules, page 2
• Cisco WAE Network Module Hardware Description, page 3
• Setting Up Cisco WAE Network Modules and Opening a Session, page 5
• Starting the Cisco WAE Network Module and Displaying Status, page 10
• Command Reference, page 15
Americas Headquarters:
Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA
© 2007-2008 Cisco Systems, Inc. All rights reserved.
Prerequisites for Installing the Cisco WAE Network Modules
• Glossary, page 37
• Related Documentation, page 38
• Obtaining Documentation, Obtaining Support, and Security Guidelines, page 39
Prerequisites for Installing the Cisco WAE Network Modules
The prerequisites for installing the Cisco WAE network module in the access router are as follows:
• Plan software upgrades or downgrades for times when you can take all applications that run on the
host router offline.
• Ensure that you have the appropriate Cisco access router to serve as the host router. The WAE
network module is supported on the following Cisco access routers:
–
2811, 2821, and 2851
–
3725, 3825, and 3845
• Ensure that the router is running IOS Release 12.4(9)T or 12.4(9)T1 (recommended) by using the
show version command.
When minimum release requirements are met, you can change images on either the router or the
network modules without affecting performance.
• For information about installing the NME-WAE, see the Quick Start Guide: Network Modules for
Cisco Access Routers and Cisco Network Modules and Interface Cards Regulatory Compliance and
Safety Information.
• You need the slot and unit numbers for the “Setting Up Network Module Interfaces” section on
page 6 and the “Opening and Closing a Network Module Session” section on page 8. Make a note
of the network module location in the host router:
–
slot—Slot number of the network module in the router chassis. After you install the module,
you can obtain this information from the router show running-config command output.
–
unit—Number of the daughter card on the module. This value is always 0.
• You need an accessible FTP or TFTP file server.
–
Use an FTP file server for installations, backups, and restores.
–
Use a TFTP file server (on the FTP-file-server machine) for boothelper operations to recover
from a failed installation.
Restrictions for Cisco WAE Network Modules
The restrictions for the Cisco WAE network modules are as follows:
• You may perform a software upgrade or downgrade only on an inactive appliance. Plan upgrades or
downgrades for times when you can take all applications that run on the host router out of service
or offline.
• All WAE appliances and network modules that are in your network must be running the same version
of the ACNS software.
• Network module software configurations can only be performed by using a console that connects to
a single serial-port console port on the host router.
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
2
OL-13140-02
Cisco WAE Network Module Hardware Description
Because the network module does not have an external console port, you must configure the network
module by initiating a Telnet session or by initiating a configuration session from the router CLI.
• After initial setup, which requires using router configuration commands, you can configure the
NME-WAE in the same manner as other ACNS devices, with the following exceptions:
–
The NME-WAE cannot serve as a Content Distribution Manager for other ACNS devices.
–
The NME-WAE does not support device mode configuration. The device mode configuration
prompt has been removed from the NME-WAE startup script.
–
Websense URL-filtering is not supported on the NME-WAE.
• ACNS software does not support the following hardware-related features on the network module:
–
USB port
–
Compact Flash utilization LED
–
Software reset button
Cisco WAE Network Module Hardware Description
This section includes the following topics describing the WAE network module hardware:
• Hard Disk and Memory Specifications
• Faceplate and LEDs
• Hardware Interfaces
Hard Disk and Memory Specifications
The NME-WAE ships from the factory with the hardware listed in Tab l e 1 preinstalled.
Table 1 Network Module Hardware
Model Hard Disk Memory
NME-WAE-502-K9 120 GB 1 GB
NME-WAE-522-K9 160 GB 2 GB
Faceplate and LEDs
Figure 1 shows the NME-WAE faceplate and LEDs.
OL-13140-02
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
3
Cisco WAE Network Module Hardware Description
Figure 1 NME-WAE Faceplate and LEDs
NM-WAE-XXX-K9
XXX-XXXXX-XX XX
SHUTDOWN:
GRACEFUL <1 s
IMMEDIATE >4 s
CF
Never remove compact
flash during operation
LINK ACT
GigE
DISK
SYS
USB
NOT
SUPPORTED
Shut down
application
before removing or
power cycling.
EN
170900
CF
Shutdown
CF card
LINK ACT DISK
SYS
EN
CF Not used
Shutdown Press the Shutdown button for greater than 4 seconds to cause an immediate module
shutdown, which may impact file operations that are in progress.
CF card CompactFlash memory card
LINK Status of Gigabit Ethernet link
On—Link is enabled
Off—Link is disabled
ACT Status of Gigabit Ethernet activity
On—Active
Off—Inactive
DISK Status of hard drive activity
On—Active
Off—Inactive
SYS Status of system shutdown
On—System is shut down and ready for host power down
Off—Application is stable
Flashing—System shutdown is in progress
EN Status of the network module
On—Detected by the host IOS software and enabled
Off—Disabled
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
4
OL-13140-02
Hardware Interfaces
The host router and network module use several interfaces for internal and external communication (see
Figure 2). Each interface is configurable by using a IOS-like CLI.
Figure 2 Router and Network Module Interface
2
Router interface to module
3
Module interface to router
Module interface to external link
4
Network Module
Setting Up Cisco WAE Network Modules and Opening a Session
Host Router (Top View)
1
Router interface to external link
231229
Using This
On This Hardware Interface... Configure These Settings...
1 Router interface to external link
Standard router settings Router IOS
(GigabitEthernet slot/0)
2 Router interface to module
(Integrated-Service-Engine slot/0)
3 Module interface to router
(Integrated-Service-Engine slot/0)
4 Module interface to external link
(Integrated-Service-Engine slot/0)
Module IP address and default
gateway router
All other module and ACNS
application settings
All other module and ACNS
application settings
Configuration Interface
command-line interface
NME-WAE network
module command-line
interface
The NME-WAE accepts traffic to be optimized on either its internal or external interface but not on both
interfaces. Configure either the module internal interface to the router (see callout 3 in Figure 2) or the
module external interface (see callout 4 in Figure 2) but not both interfaces.
When using the ACNS Content Distribution Manager GUI for an NME-WAE device, the internal
interface to the router is designated as slot 1, port 0 and the external network interface is designated as
slot 2, port 0, regardless of the physical slot in which the NME-WAE is installed.
Setting Up Cisco WAE Network Modules and Opening a Session
This section contains the following topics:
• Setting Up Network Module Interfaces, page 6
OL-13140-02
• Opening and Closing a Network Module Session, page 8
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
5
Setting Up Cisco WAE Network Modules and Opening a Session
If you lose power or connection during any of the following procedures, the software usually detects the
interruption and tries to recover. If it fails to recover, reinstall the software using the boothelper.
You can configure basic network parameters for the network module by using the CLI, which is
described in this document. For additional configuration instructions, see the ACNS online help that is
included with the software application.
Setting Up Network Module Interfaces
Your first configuration task is to configure the network module interfaces to the host router and to its
external links. You use these interfaces to access the module for installing and configuring the ACNS
software application.
This section includes the following topics:
• Summary Steps
• Detailed Steps
• Examples
The first several steps open the host router CLI to the module. The subsequent steps configure the
interface.
Summary Steps
The network module is referred to as the integrated service engine (ISE) on the IOS CLI.
From the host router CLI, use the following commands:
1. enable
2. configure terminal
3. interface integrated-service-engine slot/0
4. ip address router-side-ip-address subnet-mask
5. service-module ip address module-side-ip-address subnet-mask
or
service-module external ip address module-side-ip-address subnet-mask
6. service-module ip default-gateway gateway-ip-address
7. end
8. copy running-config startup-config
9. show running-config
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
6
OL-13140-02
Detailed Steps
Procedure Command
Step 1
Step 2
Step 3
Step 4
Step 5
Enter privileged EXEC mode on the host router. Enter
your password if prompted.
Enter global configuration mode on the host router.
Enter interface configuration mode for the slot where the
network module resides.
Specify the router interface to the module (see callout 2 in
Figure 2). Arguments are as follows:
• router-side-ip-address subnet-mask—IP address and
subnet mask for the interface.
Specify the IP address for the module interface to the
router (see callout 3 in Figure 2). To configure the
external interface (see callout 4 in Figure 2) instead of the
internal interface, use the second form of the command.
Arguments are as follows:
• module-side-ip-address—IP address for the interface.
• subnet-mask—Subnet mask to append to the IP
address; must be in the same subnet as the host router
subnet specified in Step 4.
Setting Up Cisco WAE Network Modules and Opening a Session
From the host router CLI, perform the following steps:
enable
Example:
Router> enable
configure terminal
Example:
Router# configure terminal
interface integrated-service-engine slot/0
Example:
Router(config)# interface
integrated-service-engine 1/0
ip address router-side-ip-address subnet-mask
Example:
Router(config-if)# ip address 10.0.0.20
255.255.255.0
service-module ip address module-side-ip-address
subnet-mask
or
service-module external ip address
module-side-ip-address subnet-mask
Example:
Router(config-if)# service-module ip address
10.0.0.30 255.255.255.0
Step 6
Step 7
OL-13140-02
Specify the IP address for the default gateway router for
the module. The argument is as follows:
• gateway-ip-address—IP address for the gateway
router.
Return to global configuration mode on the host router.
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
or
Router(config-if)# service-module external ip
address 10.0.0.30 255.255.255.0
service-module ip default-gateway
gateway-ip-address
Example:
Router(config-if)# service-module ip
default-gateway 10.0.0.20
end
Example:
Router(config-if)# end
7
Setting Up Cisco WAE Network Modules and Opening a Session
Procedure Command
Step 8
Step 9
Save the router running configuration.
Display the router running configuration so that you can
verify interface configurations.
Examples
The following partial output from the show running-config command shows how the interfaces are
configured:
interface service-engine1/0
ip address 10.0.0.20 255.255.255.0
service-module integrated-service-engine ip address 10.0.0.30 255.255.255.0
service-module integrated-service-engine ip default-gateway 10.0.0.20
copy running-config startup-config
Example:
Router# copy running-config startup-config
show running-config
Example:
Router# show running-config
Opening and Closing a Network Module Session
Once you have set up your network interfaces, you can open and close a session on the network module.
Opening a session is the equivalent of accessing an ACNS appliance from its console. You can conduct
only one session at a time.
The procedure listed below uses the service-module integrated-service-engine slot/0 session command
to open a session. Alternatively, you can access the network module console by telneting to a specific
port at the network module IP address, depending on the slot where the network module is installed, as
follows:
• slot 1—telnet to port 2066
• slot 2—telnet to port 2130
• slot 3—telnet to port 2194
• slot 4—telnet to port 2258
This section includes the following topics:
• Summary Steps
• Detailed Steps
• Where to go Next
Summary Steps
To open a network module session, use the following commands from the host router CLI:
1. enable
2. service-module integrated-service-engine slot/0 status
3. service-module integrated-service-engine slot/0 session
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
8
OL-13140-02
Detailed Steps
Procedure Command
Step 1
Step 2
Step 3
From the host router CLI, enter privileged EXEC mode on
the host router. Enter your password if prompted.
Display the status of the specified module so that you can
ensure that the module is running (that is, in the steady
state). For details, see the service-module
integrated-service-engine status command.
If the module is not running, start it with one of the startup
commands listed in the “Shutting Down and Starting Up
Cisco WAE Network Modules” section on page 11.
Begin a service module session on the specified module.
Perform one of the following actions:
Setting Up Cisco WAE Network Modules and Opening a Session
Use the following commands from the Network Module Interface
4. Log in to the network module.
5. Perform configuration or other procedures by using the ACNS CLI.
6. Press Control-Shift-6 x.
Use the following command from the host router CLI:
7. service-module integrated-service-engine slot/0 session clear
To open a network module session, perform the following steps:
enable
Example:
Router> enable
service-module integrated-service-engine slot/0
status
Example:
Router# service-module
integrated-service-engine 2/0 status
service-module integrated-service-engine slot/0
session
Step 4
OL-13140-02
• To interrupt the auto-boot sequence and access the
bootloader, quickly type ***.
• To start a configuration session, press Enter.
To use telnet to access the network module, use the second
form of the command.
From the network module interface, log in to the network
module. The default username is admin and the default
password is default.
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
or
telnet module-ip-address port
Example:
Router# service-module
integrated-service-engine 1/0 session
Trying 10.10.10.1, 2066 ... Open
or
Router# telnet 10.10.10.1 2066
Cisco Content Engine Console
Username: admin
Password:
System Initialization Finished.
SE-Module#
9
Starting the Cisco WAE Network Module and Displaying Status
Procedure Command
Step 5
Enter configuration commands on the module as needed.
Configuration command choices are similar to those
commands that are available on the router. Access global
configuration mode by using the configure terminal
command. Enter configuration commands. Then exit global
configuration mode with the exit command and save your
new configuration with the write command.
Step 6
Close the service module session and return to the router
CLI.
The service module session remains active until you clear it
in the next step. While it remains active, you can return to it
from the router CLI by pressing Enter.
Step 7
From the host router CLI, clear the service module session
for the specified module. When prompted to confirm this
command, press Enter.
Example (Configuration):
SE-Module# configure terminal
SE-Module(config)#
.
.
.
SE-Module(config)# exit
SE-Module# write
Press Ctrl-Shift-6 x.
service-module integrated-service-engine slot/0
session clear
Example:
Router# service-module
integrated-service-engine 1/0 session clear
Where to go Next
See the “Starting the Cisco WAE Network Module and Displaying Status” section on page 10 for
information about maintaining and administering the WAE network module.
See the “Command Reference” section on page 15 for a list of new and modified IOS commands used
to configure the WAE network module.
Starting the Cisco WAE Network Module and Displaying Status
This section contains the following topics:
• Accessing the ACNS Software on the Network Module
• Shutting Down and Starting Up Cisco WAE Network Modules, page 11
• Displaying Status and Diagnostic Output, page 12
The tables in these sections list only the most common router and network module commands. The tables
group commands by the configuration mode in which they are available. If the same command is
available in more than one mode, it may act differently in each mode.
To view a complete list of available commands, type ? at the prompt, as shown in the following example:
Router(config-if)# ?
To view a complete list of command keyword options, type ? at the end of the command, as shown in
the following example:
Router# service-module integrated-service-engine ?
10
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
OL-13140-02
Starting the Cisco WAE Network Module and Displaying Status
Accessing the ACNS Software on the Network Module
You can access the ACNS software that runs on the network module by first accessing one of the
following:
• The router IOS command-line interface (CLI) to open a console session to the network module
• The ACNS Content Distribution Manager graphical user interface (GUI)
For details about configuring and maintaining your ACNS network, see the following documents:
• Cisco Application and Content Networking System Software Configuration Guide for Centrally
Managed Deployments
• Cisco Application and Content Networking System Software Configuration Guide for Locally
Managed Deployments
• Cisco Application and Content Networking System Software Command Reference
When using the ACNS Content Distribution Manager GUI for an NME-WAE device, the internal
interface to the router is designated as slot 1, port 0 and the external network interface is designated as
slot 2, port 0, regardless of the physical slot in which the NME-WAE is installed.
Shutting Down and Starting Up Cisco WAE Network Modules
To shut down or start up the network module or the ACNS software that runs on the module, use a
command from the common router and network module commands listed in Table 2.
Be aware of the following command functions:
• Shutdown commands can potentially disrupt service. The command output will display a
confirmation prompt before shutdown occurs. Confirm by pressing Enter or cancel by typing n and
pressing Enter. To prevent the prompt from displaying, use the no-confirm keyword.
• Some commands shut the module or application down and then immediately restart it.
Table 2 Common Shutdown and Startup Commands
Configuration Mode Command Purpose
Router#
Router#
service-module
integrated-service-engine
slot/0 reload
service-module
integrated-service-engine
slot/0 reset
Shuts down the network module operating
system gracefully and then restarts it from
the bootloader.
Resets the hardware on a module. Use this
command only to recover from shutdown or
a failed state.
Caution Using this command does not
provide an orderly software
shutdown and may impact file
operations that are in progress.
OL-13140-02
Router#
service-module
integrated-service-engine
slot/0 session
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
Accesses the specified service engine and
begins a network module configuration
session.
11
Starting the Cisco WAE Network Module and Displaying Status
Table 2 Common Shutdown and Startup Commands (continued)
Configuration Mode Command Purpose
Router#
service-module
integrated-service-engine
slot/0 shutdown
Router#
service-module
integrated-service-engine
slot/0 status
Router#
SE-Module#
SE-Module#
shutdown Shuts down the entire system (both the host
reload Shuts down ACNS gracefully, and then
shutdown Shuts down the ACNS application
Displaying Status and Diagnostic Output
Shuts down the network module operating
system gracefully. Use when removing or
replacing a hot-swappable module during
online insertion and removal (OIR).
Displays configuration and status
information for the network module
hardware and software.
router and the service module) gracefully.
reboots it from the bootloader.
gracefully, and then shuts down the module.
To verify the status of an installation, upgrade, or downgrade, or to troubleshoot problems, use the
commands as needed from the common router and network module commands listed in Tabl e 3.
Many show commands provide keyword options to display diagnostic output on your screen or to send
the output to a file or a URL.
Table 3 Common Verification and Troubleshooting Commands
Configuration Mode Command Purpose
Router#
ping Pings a specified IP address to check
network connectivity (does not accept a
hostname as destination).
Router#
show arp Displays the current Address Resolution
Protocol (ARP) table.
Router#
Router#
show clock Displays the current date and time.
show configuration Displays the current bootloader
configuration as entered by means of the
configure command.
Router#
show controllers
Displays interface debug information.
integrated-service-engine
Router#
show diag Displays standard IOS diagnostic
information including information about the
ACNS software.
Router#
show hardware Displays information about network module
and host router hardware.
Router#
show hosts Displays the default domain name, style of
name lookup, list of name-server hosts, and
cached list of hostnames and addresses.
12
Configuring Cisco Access Routers and the NME-WAE Network Module for ACNS Deployments
OL-13140-02
Loading...