Release Notes for Cisco OER Master Controller Engine, 1.0

Table Of Contents

Release Notes for Cisco OER Master Controller Engine, 1.0

Contents

Introduction

System Requirements

Hardware Supported

Related Documents

Installation Notes

Important Notes

Database Backup and Restore

Database Backup

Database Restore

Notes

Caveats

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

Release Notes for Cisco OER Master Controller Engine, 1.0

Contents

Introduction 1

System Requirements 2

Related Documents 2

Installation Notes 2

Important Notes 3

Database Backup and Restore 3

Caveats 6

Obtaining Documentation 7

Documentation Feedback 8

Obtaining Technical Assistance 8

Obtaining Additional Publications and Information 9

Introduction

Cisco Optimized Edge Routing (OER) allows network administrators to minimize bandwidth costs and engineering operating expenses. Cisco OER enables intelligent network traffic load distribution and dynamic failure detection of data-paths at the Wide Area Network edge, multihoming to the Internet or intranet connectivity.

Cisco OER is configured with an external Cisco CNS 2100 Series Intelligence Engine (Cisco OER Master Controller Engine) to provide enhanced scalability, extended history and a Web-based GUI for configurations and reporting.

System Requirements

The Cisco OER Master Controller Engine requirements include:

•Linux-based Cisco Optimized Edge Routing 1.0 software installed on Cisco CNS 2100 Series Intelligent Engine (Cisco OER Master Controller Engine).

•Cisco IOS upgrade to 12.3(8)T on Cisco IOS-based border routers.

Hardware Supported

Cisco CNS 2100 Series Intelligence Engine.

Related Documents

Note We sometimes update the printed and electronic documentation after original publication. Therefore, you should also review the documentation on Cisco.com for any updates.

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

–Documentation Guide for Cisco OER Master Controller Engine 1.0.

–Cisco OER Master Controller Engine 1.0 Installation Instructions.

–Cisco OER Master Controller Engine 1.0 User Guide.

•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.

Installation Notes

•For a complete description of how to install the Cisco OER Master Controller Engine software, see the Cisco OER Master Controller Engine 1.0 Installation Instructions.

•For a complete description of how to install the Cisco CNS 2100 Series Intelligence Engine, see the Cisco CNS 2100 Series Intelligence Engine Installation Guide.

Important Notes

•If Cost is enabled under resolver priority then make sure that Cost is configured and applied to the Exit (External Interface). Exits which do not have cost configure will not be a candidate when the resolver is making a decision based on cost.

•Troubleshooting log messages prefixed or intermixed with the term SLA means that the Cost Minimization function is executing.

•It is recommended that only one user be logged in to the Cisco OER Master Controller Engine at any given time.

Database Backup and Restore

Backups of theCisco OER 1.0 database can be created without stopping operation of Cisco OER Master Controller Engine. Because Cisco OER 1.0 does not include customized programs to automate database backup and restore processes, they must be achieved manually. Before you start to execute backup or restore, complete these steps:

Step 1 Open a terminal window.

Step 2 Login as root.

Step 3 Execute the following commands:

root@host(~): /bin/bash
root@host(~): DAS_HOME=/opt/CSCOoer
root@host(~): DAS_DB_OPTIONS="uid=DASadmin;pwd=sql;eng=`hostid`DASDBServer;dbn=DASmain"
root@host(~): . $DAS_HOME/bin/env.sh
Database Backup

Before you begin, create a directory named backup at /opt/CSCOoer/ (mkdir $DAS_HOME/ backup).

The backup process creates time-stamped directories under the backup directory. For example, 20040622-112258 represents a backup created on 2004-06-22 at 11:22:58.

Warning It is strongly suggested not to make any configuration changes during backup.

Tip In order to limit the impact of backup on overall system performance, it is recommended that you run backups while the system is not busy.

Note Incremental backups can only be restored on top of full backups (with or without further incremental backups). Therefore, the first backup must always be a full backup.

Full Backup

The first backup should be a full backup.

Examples

root@host(~): mkdir $DAS_HOME/backup
root@host(~): $DAS_HOME/tools/sybase/SYBSsa8/bin/dbbackup -c "$DAS_DB_OPTIONS" $DAS_HOME/backup/`date+"%Y%m%d-%H%M%S"`-Full
Adaptive Server Anywhere Backup Utility Version 8.0.2.4394
Directory "/opt/CSCOoer/backup/20040622-114737" does not exist. Create it? (Y/N) y
(698 of 698 pages, 100% complete)
(232 of 232 pages, 100% complete)
(232 of 232 pages, 100% complete)
(2 of 2 pages, 100% complete)
Database backup completed
Incremental Backup

Subsequent backups can be either full backups or incremental backups. In the case of incremental backups, only the transaction log is saved as the backup.

Warning Whereas the command to create incremental backup also resets the current transaction log, this command can only be executed once for the current date and time, otherwise the existing backup is overwritten.

Examples

root@host(~): $DAS_HOME/tools/sybase/SYBSsa8/bin/dbbackup -t -r -c "$DAS_DB_OPTIONS" $DAS_HOME/backup/`date+"%Y%m%d-%H%M%S"`
Adaptive Server Anywhere Backup Utility Version 8.0.2.4394
Directory "/opt/CSCOoer/backup/20040622-114754" does not exist. Create it? (Y/N) y
(2 of 2 pages, 100% complete)
Transaction log renamed to: 040622AG.log
Database backup completed
Database Restore

Note Database restore can only be executed when Cisco OER 1.0 is NOT running.

Tip It is strongly suggested that you perform a backup of the current database before attempting to restore a previous database backup.

Database restore is achieved by restoring a full backup first, then applying all subsequent incremental backups (transaction logs).

Examples

root@host(~): cd $DAS_HOME/db
root@host(/opt/CSCOoer/db): ls -rlt ../backup/
total 20
drwxr-xr-x 19 root root 4096 Jun 22 10:40 ../
drwxrwxr-x 5 root root 4096 Jun 22 12:17 ./
drwxrwxr-x 2 root root 4096 Jun 22 12:18 20040622-121828-Full/
drwxrwxr-x 2 root root 4096 Jun 22 12:19 20040622-121858/
drwxrwxr-x 2 root root 4096 Jun 22 12:19 20040622-121936/

In the above example, there are three backups which were created earlier. For example, to restore the system to the state as of 2004/06/22 12:19:36, the following backups have to be restored in this exact order:

20040622-121828-Full
20040622-121858
20040622-121936
Examples

root@host(~): cd $DAS_HOME/db
root@host(/opt/CSCOoer/db): ../bin/stop.sh
stop.sh: Tue Jun 22 12:32:22 PDT 2004
root@host(/opt/CSCOoer/db): cp ../backup/20040622-121828-Full/DASmain.db .
root@host(/opt/CSCOoer/db): ../tools/sybase/SYBSsa8/bin/dbsrv8 $DAS_HOME/db/DASmain.db -a ../backup/20040622-121858/DASmain.log

Sybase Adaptive Server Anywhere Network Server Version 8.0.2.4394

*** Copyright information ***

Database recovery in progress
Last checkpoint at Tue Jun 22 2004 12:18
Checkpoint log...
Transaction log: ../backup/20040622-121858/DASmain.log...
Rollback log...
Checkpointing...
Starting checkpoint of "DASmain" (DASmain.db) at Tue Jun 22 2004 12:23
Finished checkpoint of "DASmain" (DASmain.db) at Tue Jun 22 2004 12:23
Recovery complete
Database server stopped at Tue Jun 22 2004 12:23
root@host(/opt/CSCOoer/db): ../tools/sybase/SYBSsa8/bin/dbsrv8 $DAS_HOME/db/DASmain.db -a ../backup/20040622-121936/DASmain.log
Sybase Adaptive Server Anywhere Network Server Version 8.0.2.4394

*** Response compressed ***
Notes

•If an incremental backup is corrupted, you can only restore the database to the incremental backup prior to the corrupted backup.

•If a full backup is corrupted, you can only restore the database using a different full backup and all incremental backups based on this full backup.

Caveats

This section provides information about known problems in this release along with recommended workarounds for each.

Note To review any known problems with other components associated with this product, such as border routers, check for information at the following URL: http://www.cisco.com/univercd/cc/td/doc/product/software/ios123/123relnt/xprn123t/index.htm

Table 1 Cisco OER Master Controller Engine Software

ID

Problem

Workaround

CSCee27059

Cost reports are displayed for an Invalid Exit (Exit that doesn't exist on the border router).

The rollup data is zero and monthly cost is the lowest tier cost, or the fixed cost, based on what is configured.

Delete all invalid exits.

CSCee32862

Internally, policy is unassigned, but is not removed from the configuration. It still shows as the assigned policy.

This happens only if policy is unassigned to an empty learn prefix list (Top Throughput or Top Delay).

Delete the policy and recreate it.

CSCee33447

When the you click on a Cost Minimization method in the menu, the page for Edit Settings for the cost minimization method is shown instead of the Cost Minimization method details page that displays the existing parameters and tiers for the method.

This happens when the you click Edit Settings in the Cost Minimization details page; and instead of either clicking Save or Cancel, you use the Contents Tree Menu to navigate to an item.

After this, if you click any Cost Minimization method, the page for Edit Settings for the Cost Minimization method is shown, instead of the expected page.

You must click Cancel to get back to the Cost Minimization method details page, which allows you to add or delete new tiers.

CSCee34454

Due to time synchronization, the utilization due to observed traffic and controlled traffic during the rollup period is not accurate.

This results in sum of observed and controlled utilization being higher than the actual utilization during the rollup period.

None. This does not impact the functionality of Cost Minimization.

CSCee42009

The accept-lifetime and send-lifetime parameters under key-chain configuration are not supported.

If configured, the key is not usable and the Cisco OER Master Controller Engine cannot communicate with the border router.

Leave accept-lifetime and send-lifetime blank so that life of the key is infinite.

Once lifetime is configured, it can not be removed.

Key should be deleted and added again.

CSCee52696

Under Reports > Unreachable > Passive > details (specific) prefix, the unreachable column shows zero because the value is divided by 10000. However, short-term and long-term values are correct.

Refer to short-term and long-term values.

CSCee74963

Fatal error. Cisco OER Master Controller Engine stops and the following error message is logged:

Fri May 28 14:16:12 2004:OER_MC-0-EMERG Fatal OER error 774543
This is caused when the clock setting on the server is changed while OER is running.

Restart Cisco OER Master Controller Engine.

CSCef20311

Under Configurations > Prefix List, both Top Throughput and Top Delay learned prefixes are cleared when you invoke the Clear Prefixes function.

This occurs regardless of the state (Enabled or Disabled) of either Prefix List.

None.

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

This document is to be used in conjunction with the documents listed in the "Related Documents" section.

Copyright � 2004 Cisco Systems, Inc. All rights reserved.

ID	Problem	Workaround
CSCee27059	Cost reports are displayed for an Invalid Exit (Exit that doesn't exist on the border router). The rollup data is zero and monthly cost is the lowest tier cost, or the fixed cost, based on what is configured.	Delete all invalid exits.
CSCee32862	Internally, policy is unassigned, but is not removed from the configuration. It still shows as the assigned policy. This happens only if policy is unassigned to an empty learn prefix list (Top Throughput or Top Delay).	Delete the policy and recreate it.
CSCee33447	When the you click on a Cost Minimization method in the menu, the page for Edit Settings for the cost minimization method is shown instead of the Cost Minimization method details page that displays the existing parameters and tiers for the method. This happens when the you click Edit Settings in the Cost Minimization details page; and instead of either clicking Save or Cancel, you use the Contents Tree Menu to navigate to an item. After this, if you click any Cost Minimization method, the page for Edit Settings for the Cost Minimization method is shown, instead of the expected page.	You must click Cancel to get back to the Cost Minimization method details page, which allows you to add or delete new tiers.
CSCee34454	Due to time synchronization, the utilization due to observed traffic and controlled traffic during the rollup period is not accurate. This results in sum of observed and controlled utilization being higher than the actual utilization during the rollup period.	None. This does not impact the functionality of Cost Minimization.
CSCee42009	The accept-lifetime and send-lifetime parameters under key-chain configuration are not supported. If configured, the key is not usable and the Cisco OER Master Controller Engine cannot communicate with the border router.	Leave accept-lifetime and send-lifetime blank so that life of the key is infinite. Once lifetime is configured, it can not be removed. Key should be deleted and added again.
CSCee52696	Under Reports > Unreachable > Passive > details (specific) prefix, the unreachable column shows zero because the value is divided by 10000. However, short-term and long-term values are correct.	Refer to short-term and long-term values.
CSCee74963	Fatal error. Cisco OER Master Controller Engine stops and the following error message is logged: `Fri May 28 14:16:12 2004:OER_MC-0-EMERG Fatal OER error 774543` This is caused when the clock setting on the server is changed while OER is running.	Restart Cisco OER Master Controller Engine.
CSCef20311	Under Configurations > Prefix List, both Top Throughput and Top Delay learned prefixes are cleared when you invoke the Clear Prefixes function. This occurs regardless of the state (Enabled or Disabled) of either Prefix List.	None.