Cisco OER Master Controller Engine Installation Guide, 1.0

Table Of Contents

Cisco OER Master Controller Engine 1.0 Installation Instructions

Documentation Resources

Related Documents

Product Overview

Connecting to the Cisco OER Appliance

Serial

KVM

Power Connection

Installing the Software

Running Setup

Starting Cisco OER Master Controller Engine

Stopping Cisco OER Master Controller Engine

Saving a Configuration

Using a Saved Configuration

Deleting and Installing the Software

Where to go from Here

Obtaining Documentation

Cisco.com

Ordering Documentation

Documentation Feedback

Obtaining Technical Assistance

Cisco Technical Support Website

Submitting a Service Request

Definitions of Service Request Severity

Obtaining Additional Publications and Information

Cisco OER Master Controller Engine 1.0 Installation Instructions

This document provides step-by-step instructions explaining how to install and set up the Cisco Optimized Edge Routing (OER) Master Controller Engine software (Release1.0) on the Cisco CNS 2100 Series Intelligence Engine (Cisco OER appliance).

The information in this document is intended for administrative staff only.

The following topics are discussed in this document:

Documentation Resources

Product Overview

Connecting to the Cisco OER Appliance

Installing the Software

Running Setup

Starting Cisco OER Master Controller Engine

Stopping Cisco OER Master Controller Engine

Saving a Configuration

Using a Saved Configuration

Deleting and Installing the Software

This document does not explain firewall configuration. For firewall and other detailed Platform Applicable Module (PAM) and Platform Applicable Client (PAC) related configuration information, see the Cisco WAN Access Performance Management System - System Administration Guide, 2.1.

Documentation Resources

The following documents provide information about the Cisco OER Master Controller Engine product:

•Documentation Guide for Cisco OER Master Controller Engine 1.0.

•Release Notes for Cisco OER Master Controller Engine 1.0.

•Cisco OER Master Controller Engine 1.0 User Guide.

You can access the Cisco OER documents at the following URL:

www.cisco.com/univercd/cc/td/doc/product/rtrmgmt/oer/1_0

Related Documents

The following documents provide information about the Cisco CNS 2100 Series Intelligence Engine:

•Cisco CNS 2100 Series Intelligence Engine Installation Guide.

•Release Notes for Cisco CNS 2100 Series Intelligence Engine.

•Cisco CNS 2100 Series Intelligence Engine Machine Code License.

•Regulatory Compliance and Safety Information for Cisco CNS 2100 Series Intelligence Engine.

These documents can be found in the accessory kit shipped with your Cisco CNS 2100 Series Intelligence Engine.

Product Overview

The Cisco OER Master Controller Engine software is bundled with Linux onto a CD-ROM. It must be installed on the Cisco CNS 2100 Series Intelligence Engine (Cisco OER appliance).

The Cisco OER appliance has two ports that can be used for access:

•KVM (keyboard/video/mouse)

•Serial

You can connect a PS/2 keyboard, PS/2 mouse, and a VGA monitor, or a dumb terminal, to the Cisco OER appliance.

By default the Cisco OER appliance expects a serial connection.

Connecting to the Cisco OER Appliance

This section provides information about connecting to the Cisco OER appliance:

•Serial

•KVM

•Power

Serial

For a serial connection, connect a serial cable from the communications server, or dumb terminal, to the serial connector at the rear of the Cisco OER appliance. See Figure 4-3 of the Cisco CNS 2100 Series Intelligence Engine Installation Guide.

Dumb Terminal

For a dumb terminal, use a rollover cable, which is bundled with the Cisco OER appliance, as the serial cable to connect to the Cisco OER appliance.

Communications Server

For a Cisco AS2511-RJ communications server, use a straight-through cable, such as CAT5 ethernet cable, to connect to the Cisco OER appliance.

Interface Connector

In both cases, before the serial cable can be connected, the 9-pin to RJ-45 connector, which is bundled with the Cisco OER appliance, should be connected to the serial connector on the Cisco OER appliance.

Serial Setup

The serial configuration setup is:

•9600 baud.

•no parity.

•2 stopbits (1 and 1.5 will work too).

•8 databits.

The suggested terminal display setup is 24 lines and 80 columns.

KVM

For a KVM (Keyboard, Video, and Mouse) connection, connect the single connector end of the C2T cable to the C2T (out) port at the rear of the Cisco OER appliance. See Figure 3-1 and Figure 4-3 of the Cisco CNS 2100 Series Intelligence Engine Installation Guide.

At the opposite end of the C2T cable are the keyboard, video, and mouse connectors. The PS/2 connectors are color-coded, green for mouse, and purple for keyboard.

Power Connection

Connect the power cable from the Cisco OER appliance to a 110VAC power outlet.

Installing the Software

Step 1 Power on the Cisco OER appliance.

Step 2 Insert the Cisco OER Master Controller Engine CD-ROM into the CD drive.

Step 3 Reset the Cisco OER appliance to force the system to start from the CD-ROM.

The software installs automatically. When the install sequence completes, the system automatically ejects the CD-ROM and restarts into Linux from the hard drive.

Running Setup

Respond to each prompt as follows:

localhost.localdomain login: setupEntering Network Appliance Setup for CNS OERType ctrl-c to exitEnter hostname: DNS_or_NIS_hostnameEnter domain name: your.dot.comEnter eth0 IP address: OER_host_ip_addressEnter eth0 network mask: OER_host_maskEnter eth0 default gateway IP address: default_gateway_ip_addressEnter primary DNS server IP address: primary_dns_server_ip_addressEnter secondary DNS server IP address (optional): secondary_dns_server_ip_addressWant to configure Ethernet1 interface? (y/n) yEnter eth1 IP address: second_ip_addressEnter eth1 network mask: mask_for_second_ip_addressEnter eth1 default gateway IP address: ip_address_for_second_default_gatewayEnter root password: *****Enter value again to confirm: *****
The following setup values were specified:Hostname: DNS_or_NIS_hostnameDomain name: your_dot_comIP address for eth0: OER_host_ip_addressNetwork mask for eth0: OER_host_maskDefault gateway IP address for eth0: default_gateway_ip_addressPrimary DNS server IP address: primary_dns_server_ip_addressSecondary DNS server IP address: secondary_dns_server_ip_addressIP address for eth1: second_ip_addressNetwork mask for eth1: mask_for_secondip_addressDefault gateway IP address for eth1: ip_address_for_second_default_gatewayPassword for root: ******
Use these values? (y/n) y
Starting Cisco OER Master Controller Engine

Step 1 Login to the Cisco OER Master Controller Engine as root.

Step 2 Enter the follow command:

/opt/CSCOoer/bin/start.sh

Syntax Description

start.sh [-wp <port>] [-ws <port>] [-wi <port>] [-dp <port>]
[-ipc <port>] [-clear_config] [-clear_data] [-load_cfg [-cfg_dir <dir>]]

Option

Description

-wp <port>

web page port.

-ws <port>

web page secure port (SSL). (Not Supported)

-wi <port>

web server internal port.

-dp <port>

db server port.

-ipc <port>

internal ipc port.

-clear_cfg

deletes the configuration and starts the OER MC as if it is started for the first time.

-clear_data

deletes data from the database. This option should not be exercised unless absolutely desired.

-load_cfg

loads the configuration from a saved configuration files.

-cfg_dir <dir>

used with -load_cfg option. If this option is specified then configuration files are searched in this directory. The complete command would be /opt/CSCOoer/start.sh -load_cfg -cfg_dir <dir>. Otherwise, the default (/opt/CSCOoer/config) directory is used.

-?

command syntax help

Stopping Cisco OER Master Controller Engine

Step 1 Login to the Cisco OER Master Controller Engine as root.

Step 2 Enter:

/opt/CSCOoer/bin/stop.sh

Saving a Configuration

The configuration is stored in the database. It can also be saved as a text file. The script to save a configuration is:

/opt/CSCOoer/bin/save_config.sh [-cfg_dir <dir>]

This scripts creates two files in the /opt/CSCOoer/config/ directory:

•component.txt

•component_properties.txt

If the -cfg_dir <dir> option is specified, then these files are saved in the dir directory. If files already exists, they are over-written.

The script can be executed irrespective of whether the Cisco OER Master Controller Engine is running or not.

Using a Saved Configuration

The script to reload a saved configuration is:

/opt/CSCOoer/bin/start.sh -load_cfg -cfg_dir <dir>

where, <dir> is the directory where the component files have been saved.

The script over-writes the database configuration with the saved configuration in the component.txt and component_properties.txt files.

The script saves the current configuration in the database as old_componet.txt and old_component_properties.txt before over-writing it.

If the -cfg_dir <dir> option is used, the files are searched and created in the dir directory. Otherwise, the default directory (/opt/CSCOoer/config) is used.

Deleting and Installing the Software

Note If you want to save the current configuration, execute the procedure described in "Saving a Configuration" section.

Step 1 Login to the Cisco OER appliance as root.

Step 2 Stop the Cisco OER Master Controller Engine by entering:

/opt/CSCOoer/bin/stop.sh all

Step 3 Remove the current Cisco OER Master Controller Engine software package by entering:

rpm -e CSCOoer

Step 4 Install the new software package by entering:

cd <directory_where_rpm_is>

rpm -i --nodeps <name_of_new_rpm>

Where to go from Here

For information about how to use the Cisco OER Master Controller Engine, see the Cisco OER Master Controller Engine 1.0 User Guide.

Obtaining Documentation

Cisco documentation and additional literature are available on Cisco.com. Cisco also provides several ways to obtain technical assistance and other technical resources. These sections explain how to obtain technical information from Cisco Systems.

Cisco.com

You can access the most current Cisco documentation at this URL:

http://www.cisco.com/univercd/home/home.htm

You can access the Cisco website at this URL:

http://www.cisco.com

You can access international Cisco websites at this URL:

http://www.cisco.com/public/countries_languages.shtml

Ordering Documentation

You can find instructions for ordering documentation at this URL:

http://www.cisco.com/univercd/cc/td/doc/es_inpck/pdi.htm

You can order Cisco documentation in these ways:

•Registered Cisco.com users (Cisco direct customers) can order Cisco product documentation from the Ordering tool:

http://www.cisco.com/en/US/partner/ordering/index.shtml

•Nonregistered Cisco.com users can order documentation through a local account representative by calling Cisco Systems Corporate Headquarters (California, USA) at 408 526-7208 or, elsewhere in North America, by calling 800 553-NETS (6387).

Documentation Feedback

You can send comments about technical documentation to bug-doc@cisco.com.

You can submit comments by using the response card (if present) behind the front cover of your document or by writing to the following address:

Cisco Systems
Attn: Customer Document Ordering
170 West Tasman Drive
San Jose, CA 95134-9883

We appreciate your comments.

Obtaining Technical Assistance

For all customers, partners, resellers, and distributors who hold valid Cisco service contracts, Cisco Technical Support provides 24-hour-a-day, award-winning technical assistance. The Cisco Technical Support Website on Cisco.com features extensive online support resources. In addition, Cisco Technical Assistance Center (TAC) engineers provide telephone support. If you do not hold a valid Cisco service contract, contact your reseller.

Cisco Technical Support Website

The Cisco Technical Support Website provides online documents and tools for troubleshooting and resolving technical issues with Cisco products and technologies. The website is available 24 hours a day, 365 days a year at this URL:

http://www.cisco.com/techsupport

Access to all tools on the Cisco Technical Support Website requires a Cisco.com user ID and password. If you have a valid service contract but do not have a user ID or password, you can register at this URL:

http://tools.cisco.com/RPF/register/register.do

Submitting a Service Request

Using the online TAC Service Request Tool is the fastest way to open S3 and S4 service requests. (S3 and S4 service requests are those in which your network is minimally impaired or for which you require product information.) After you describe your situation, the TAC Service Request Tool automatically provides recommended solutions. If your issue is not resolved using the recommended resources, your service request will be assigned to a Cisco TAC engineer. The TAC Service Request Tool is located at this URL:

http://www.cisco.com/techsupport/servicerequest

For S1 or S2 service requests or if you do not have Internet access, contact the Cisco TAC by telephone. (S1 or S2 service requests are those in which your production network is down or severely degraded.) Cisco TAC engineers are assigned immediately to S1 and S2 service requests to help keep your business operations running smoothly.

To open a service request by telephone, use one of the following numbers:

Asia-Pacific: +61 2 8446 7411 (Australia: 1 800 805 227)
EMEA: +32 2 704 55 55
USA: 1 800 553 2447

For a complete list of Cisco TAC contacts, go to this URL:

http://www.cisco.com/techsupport/contacts

Definitions of Service Request Severity

To ensure that all service requests are reported in a standard format, Cisco has established severity definitions.

Severity 1 (S1)—Your network is "down," or there is a critical impact to your business operations. You and Cisco will commit all necessary resources around the clock to resolve the situation.

Severity 2 (S2)—Operation of an existing network is severely degraded, or significant aspects of your business operation are negatively affected by inadequate performance of Cisco products. You and Cisco will commit full-time resources during normal business hours to resolve the situation.

Severity 3 (S3)—Operational performance of your network is impaired, but most business operations remain functional. You and Cisco will commit resources during normal business hours to restore service to satisfactory levels.

Severity 4 (S4)—You require information or assistance with Cisco product capabilities, installation, or configuration. There is little or no effect on your business operations.

Obtaining Additional Publications and Information

Information about Cisco products, technologies, and network solutions is available from various online and printed sources.

•Cisco Marketplace provides a variety of Cisco books, reference guides, and logo merchandise. Visit Cisco Marketplace, the company store, at this URL:

http://www.cisco.com/go/marketplace/

•The Cisco Product Catalog describes the networking products offered by Cisco Systems, as well as ordering and customer support services. Access the Cisco Product Catalog at this URL:

http://cisco.com/univercd/cc/td/doc/pcat/

•Cisco Press publishes a wide range of general networking, training and certification titles. Both new and experienced users will benefit from these publications. For current Cisco Press titles and other information, go to Cisco Press at this URL:

http://www.ciscopress.com

•Packet magazine is the Cisco Systems technical user magazine for maximizing Internet and networking investments. Each quarter, Packet delivers coverage of the latest industry trends, technology breakthroughs, and Cisco products and solutions, as well as network deployment and troubleshooting tips, configuration examples, customer case studies, certification and training information, and links to scores of in-depth online resources. You can access Packet magazine at this URL:

http://www.cisco.com/packet

•iQ Magazine is the quarterly publication from Cisco Systems designed to help growing companies learn how they can use technology to increase revenue, streamline their business, and expand services. The publication identifies the challenges facing these companies and the technologies to help solve them, using real-world case studies and business strategies to help readers make sound technology investment decisions. You can access iQ Magazine at this URL:

http://www.cisco.com/go/iqmagazine

•Internet Protocol Journal is a quarterly journal published by Cisco Systems for engineering professionals involved in designing, developing, and operating public and private internets and intranets. You can access the Internet Protocol Journal at this URL:

http://www.cisco.com/ipj

•World-class networking training is available from Cisco. You can view current offerings at this URL:

http://www.cisco.com/en/US/learning/index.html

Copyright � 2004 Cisco Systems, Inc. All rights reserved. Cisco, Cisco IOS, Cisco Systems, and the Cisco Systems logo are registered trademarks of Cisco Systems, Inc. or its affiliates in the United States and certain other countries. All other brands, names, or trademarks mentioned in this document or Website are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (0401R)

Option	Description
-wp <port>	web page port.
-ws <port>	web page secure port (SSL). (Not Supported)
-wi <port>	web server internal port.
-dp <port>	db server port.
-ipc <port>	internal ipc port.
-clear_cfg	deletes the configuration and starts the OER MC as if it is started for the first time.
-clear_data	deletes data from the database. This option should not be exercised unless absolutely desired.
-load_cfg	loads the configuration from a saved configuration files.
-cfg_dir <dir>	used with -load_cfg option. If this option is specified then configuration files are searched in this directory. The complete command would be /opt/CSCOoer/start.sh -load_cfg -cfg_dir <dir>. Otherwise, the default (/opt/CSCOoer/config) directory is used.
-?	command syntax help