Table Of Contents

Preface

Preface

---

The Cisco IOS XR Virtual Firewall (VFW) application runs on the Cisco XR 12000 multiservice blade (MSB). A dual-core CPU on the MSB runs the Cisco IOS XR software (standard edge engine code and firewall code) on core 1 and SanOS (Linux) with the Virtual Firewall application code on core 0.

This document describes two command sets that support the Virtual Firewall (VFW) feature:

•The Cisco IOS XR software used to configure the MSB for the virtual firewall and access the VFW application.

•The SanOS (Linux) software used on the VFW application, which is slightly different from the standard Cisco IOS XR software syntax. Refer to "Appendix A: Using the Command-Line Interface on the VFW Application" in Cisco IOS XR Virtual Firewall Configuration Guide for more information.

The preface contains the following sections:

•Changes to This Document

•Intended Audience

•How to Use This Guide

•Related Documentation

•Obtaining Documentation and Submitting a Service Request

•Open Source License Acknowledgements

Changes to This Document

Table 1 lists the technical changes made to this document since it was first printed.

Table 1 Changes to This Document 

Revision	Date	Change Summary
OL-15800-02	August 2008	Example was added in the "VASI Commands on Cisco IOS XR Software" section on page VFR-523. The sleep command was added.
OL-15800-01	June 2008	Initial release of this document.

Intended Audience

This document is intended for the following VFW users:

•Experienced service provider administrators

•Cisco telecommunications management engineers

•Third-party field service technicians who have completed the Cisco IOS XR software training sessions

•Customers who daily use and manage routers running Cisco IOS XR software

How to Use This Guide

This guide is organized as follows:

Section	Description
Virtual Firewall Commands on Cisco IOS XR Software, page 1	Describes the Cisco IOS XR software commands used to configure and integrate a VFW.
Class Map Commands on the Virtual Firewall, page 25	Describes the commands used to configure class maps in the VFW application.
Access Control List Commands on the Virtual Firewall, page 71	Describes the commands used to configure ACLs in the VFW application.
Policy Map Commands on the Virtual Firewall, page 89	Describes the commands used to configure policy maps and attach policy maps to VFW interfaces.
Interface Commands on the Virtual Firewall, page 155	Describes the commands used to configure VFW interfaces.
Virtualization Commands on the Virtual Firewall, page 171	Describes the commands used to configure multiple contexts within the VFW application.
Authentication and Accounting Commands on the Virtual Firewall, page 203	Describes the commands used to configure authentication and accounting on the VFW application.
High Availability Commands on the Virtual Firewall, page 255	Describes the commands used to configure redundancy on the MSBs.
TCP/IP Normalization and IP Reassembly Parameters Commands on the Virtual Firewall, page 285	Describes the commands used to configure TCP/IP normalization and IP reassembly parameters in the VFW application.
Parameter Map Commands on the Virtual Firewall, page 309	Describes the commands used to configure parameter maps in the VFW application.
Terminal and Session Commands on the Virtual Firewall, page 349	Describes the commands used to configure terminal line settings and Telnet and SSH sessions on the VFW application
System and File Management Commands on the Virtual Firewall, page 371	Describes the commands used to configure and view system features and to perform file management on the VFW application.
SNMP Commands on the Virtual Firewall, page 469	Describes the commands used to configure SNMP on the VFW application.
Logging Commands on the Virtual Firewall, page 489	Describes the commands used to configure logging on the VFW application.
VASI Commands on Cisco IOS XR Software, page 523	Describes the commands used to configure VRF-Aware Service Infrastructure (VASI).

Related Documentation

In addition to this document, the VFW documentation set includes the following:

Document Title	Description
Cisco IOS XR Virtual Firewall Configuration Guide	This guide describes how to perform Virtual Firewall (VFW) configuration tasks using Cisco IOS XR software and VFW application commands, including initial setup, remote access, class maps and policy maps, managing the VFW application software, SNMP, system message logging, redundancy, and upgrading your software.
Cisco IOS XR Command Modes Reference	This guide provides information on command-line interface (CLI) commands for the Cisco IOS XR software.
Cisco IOS XR Getting Started Guide	This guide describes how to perform the initial setup and configuration tasks for the Cisco IOS XR software.

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.

Open Source License Acknowledgements

The following acknowledgements pertain to this software license.

OpenSSL/Open SSL Project

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/).

This product includes cryptographic software written by Eric Young (eay@cryptsoft.com).

This product includes software written by Tim Hudson (tjh@cryptsoft.com).

License Issues

The OpenSSL toolkit stays under a dual license, i.e. both the conditions of the OpenSSL License and the original SSLeay license apply to the toolkit. See below for the actual license texts. Actually both licenses are BSD-style Open Source licenses. In case of any license issues related to OpenSSL please contact openssl-core@openssl.org.

OpenSSL License:

© 1998-2007 The OpenSSL Project. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions, and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. All advertising materials mentioning features or use of this software must display the following acknowledgment: "This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/)"

4. The names "OpenSSL Toolkit" and "OpenSSL Project" must not be used to endorse or promote products derived from this software without prior written permission. For written permission, please contact openssl-core@openssl.org.

5. Products derived from this software may not be called "OpenSSL" nor may "OpenSSL" appear in their names without prior written permission of the OpenSSL Project.

6. Redistributions of any form whatsoever must retain the following acknowledgment:

"This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www.openssl.org/)"

THIS SOFTWARE IS PROVIDED BY THE OpenSSL PROJECT "AS IS"' AND ANY EXPRESSED OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE OpenSSL PROJECT OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

This product includes cryptographic software written by Eric Young (eay@cryptsoft.com). This product includes software written by Tim Hudson (tjh@cryptsoft.com).

Original SSLeay License:

© 1995-1998 Eric Young (eay@cryptsoft.com). All rights reserved.

This package is an SSL implementation written by Eric Young (eay@cryptsoft.com).

The implementation was written so as to conform with Netscapes SSL.

This library is free for commercial and non-commercial use as long as the following conditions are adhered to. The following conditions apply to all code found in this distribution, be it the RC4, RSA, lhash, DES, etc., code; not just the SSL code. The SSL documentation included with this distribution is covered by the same copyright terms except that the holder is Tim Hudson (tjh@cryptsoft.com).

Copyright remains Eric Young's, and as such any Copyright notices in the code are not to be removed. If this package is used in a product, Eric Young should be given attribution as the author of the parts of the library used. This can be in the form of a textual message at program startup or in documentation (online or textual) provided with the package.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

3. All advertising materials mentioning features or use of this software must display the following acknowledgement:

"This product includes cryptographic software written by Eric Young (eay@cryptsoft.com)".

The word `cryptographic' can be left out if the routines from the library being used are not cryptography-related.

4. If you include any Windows specific code (or a derivative thereof) from the apps directory (application code) you must include an acknowledgement: "This product includes software written by Tim Hudson (tjh@cryptsoft.com)".

THIS SOFTWARE IS PROVIDED BY ERIC YOUNG "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

The license and distribution terms for any publicly available version or derivative of this code cannot be changed. i.e. this code cannot simply be copied and put under another distribution license [including the GNU Public License].