Guest

Cisco Security Monitoring, Analysis and Response System

Quick Install and Release Notes for Cisco Security MARS Appliance 4.2.1

Table Of Contents

Quick Install and Release Notes for Cisco Security MARS Appliance 4.2.1

Introduction

New Features

Cisco Security Manager (Security Manager) Policy Lookup Integration

Increased Ease of Deployment via Relayed Syslog Handling Feature

Low-Latency, Real-Time Event Query

XML Incident Notification

Disk Usage via CLI, Events, Inspection Rules, and Reports

Improved Performance of Software Upgrades

Low-End Monitoring Solution: MARS 20R

Distributed Threat Management (DTM) Enhancements

Case Management Enhancements

Using ISS Site Protector to Configure ISS NIDS and HIDS

Miscellaneous Changes and Enhancements

New Vendor Signatures

Upgrade Instructions

Important Upgrade Notes

Upgrade to 4.2.1

Upgrade to 4.1.5

Upgrade to 4.1.4

Upgrade to 4.1.3

Upgrade to 4.1.2(2042)

Upgrade to 4.1.1

Required Upgrade Path

Downloading the Upgrade Package from CCO

Important Notes

Quick Install Notes

Installation Quick Reference

Checklist for Initial Configuration

Caveats

Open Caveats - Release 4.2.1

Resolved Caveats - Release 4.2.1

Resolved Caveats - Releases Prior to 4.2.1

Product Documentation

Obtaining Documentation, Obtaining Support, and Security Guidelines


Quick Install and Release Notes for Cisco Security MARS Appliance 4.2.1


Revised: July 24, 2009, 78-17784-01

These release notes are for use with the Cisco Security Monitoring, Analysis, and Response System (MARS), Version 4.2.1 running on either a Local Controller or on a Global Controller. They provide the following information:

Introduction

New Features

Upgrade Instructions

Important Notes

Quick Install Notes

Caveats

Product Documentation

Obtaining Documentation, Obtaining Support, and Security Guidelines

Introduction

Version 4.2.1 is now available as a patch upgrade to 4.1.5 of your MARS appliance software. Registered SMARTnet users under the can obtain version 4.2.1 from the Cisco support website at:

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

And then click the Download Software link in the Support box on the right side of the MARS product home page.

New Features

In addition to resolved caveats, this release includes the following new features:

Cisco Security Manager (Security Manager) Policy Lookup Integration

Increased Ease of Deployment via Relayed Syslog Handling Feature

Low-Latency, Real-Time Event Query

XML Incident Notification

Disk Usage via CLI, Events, Inspection Rules, and Reports

Improved Performance of Software Upgrades

Low-End Monitoring Solution: MARS 20R

Distributed Threat Management (DTM) Enhancements

Case Management Enhancements

Using ISS Site Protector to Configure ISS NIDS and HIDS

Miscellaneous Changes and Enhancements

New Vendor Signatures

Cisco Security Manager (Security Manager) Policy Lookup Integration

This feature allows you to map a traffic-related syslog message back to the firewall policy that triggered the syslog, thus helping you to fix firewall configuration-related network problems, configuration errors, and to fine-tune existing firewall policies.

Policy lookup is achieved by integrating MARS, the monitoring product and Security Manager, the device management product. The MARS web interface now includes a new Security Manager Policy Table Lookup icon in the session/event display for all syslog events related to traffic. When you click this icon, MARS securely connects to Security Manager, retrieves the policy list, and displays it with the access rule that triggered the traffic syslog selected.

This integration enables policy lookup for the following device types:

Cisco IOS 12.x

Cisco PIX 6.x and 7.0

Cisco Switch-IOS 6.x

Cisco ASA 7.0

Cisco FWSM 2.x


Note This feature is available beginning with MARS 4.2.1 and Security Manager 3.0. In Security Manager 3.1, you can open the MARS web interface.


The following caveats exist for the Security Manager integration:

Reference Number
Description

CSCse03254

Issue: Inconsistent population of CSM icon for ICMP messages

Description: The same events received by MARS can display the Security Manager Policy Table Lookup icon inconsistently between the low-latency, real-time event query and standard queries, such as sessions ranked by time. Specifically, the icon will not appear in the low-latency, real-time query, but it may appear in queries against sessionized events.

This behavior is expected. When MARS receives events, they are parsed, sessionized, written to an event shared buffer, and then written to the database. Because sessionization takes time, sometimes keeping an event in cache for 2 minutes, the low-latency event query displays events right after parsing, but before sessionization. Displaying the event at this point allows the low-latency query to achieve a close to real-time effect. For some events, parsing cannot determine some part of the 5-tuple data, such as a destination address. Later, sessionization later fills in such missing data using configuration data. As a result, the 5-tuple data displayed by the low-latency event query can be different from values stored in the database, which are used to populate the standard queries.

Workaround: None.

CSCse19392

Issue: CSM: Policy query for ICMP traffic

Description: An error can occur with the policy query if you discover a device configuration with Security Manager but do not submit it in Security Manager. The following error message is an example of this issue:

<190>2312080: *May 9 23:50:02.199: %SEC-6-IPACCESSLOGDP: list permit-all permitted icmp 10.2.3.8 -> 10.4.21.2 (0/0), 1 packet

An error occurred while querying policies from Cisco Security Manager. Reason: Failed to retrieve policy information from CSM. Reason: Cisco Security Manager Internal error: Failed to get interfaces in the device!

The device LC2DTM was discovered by CSM without any errors.


Workaround: Before you perform policy queries, verify that all discovered devices have been submitted in Security Manager.

CSCse20041

Issue: CSM policy query icon for NetFlow events

Description: The Security Manager Policy Table Lookup icon displays for NetFlow events even though they are not triggered by an ACL. This extra event data allows you to determine whether there is a policy permitting that traffic, which ensures you are able to tune accordingly.

Note Because this is NetFlow data, it may not match the exact ACL or match multiple ACLs.

Workaround: None.

CSCse20691

Issue: CSM:Policy query icon

Description: The Security Manager Policy Table Lookup icon displays only for those events with 5-tuple event data (source and destination address, protocol, source and destination port). In the MARS web interface, the all matching events query displays the text "session five tuple" for events with no 5-tuple event data. These events will not have a policy query icon.

Workaround: None.


Increased Ease of Deployment via Relayed Syslog Handling Feature

You can rapidly deploy MARS by forwarding messages from existing syslog-ng or Kiwi syslog servers. This feature eliminates the network and device changes required to insert MARS into an operational network. You no longer have to configure each network device to publish its syslog messages directly to MARS, which saves time, avoids device change approval processes, preserves packet processing performance of the network devices, and ensures that daily network operations proceed uninterrupted.


Note Solaris/Linux syslogd is not supported as its message format does not include the host and timestamp information for the device that originates the message.


This relay feature also allows the correlation and inspection of syslog messages from reporting devices, such as those on the DMZ, for which corporate policies might prohibit the existence of or connection to configuration information.

If your network devices already publish syslog messages to syslog-ng or Kiwi syslog servers, simply configure those servers to forward messages to the MARS Appliance and identify the syslog servers in MARS. MARS parses the syslog messages generated by the following devices: Cisco PIX, Cisco IOS, Cisco CatOS, Cisco ASA, Cisco FWSM, Cisco VPN 3000, Cisco Secure ACS, Snort IDS, Juniper/Netscreen firewalls, Solaris, Redhat Linux, and Microsoft Internet Information Server (ISS). For other devices, you can define custom log parsers.

The MARS Appliance can begin processing and storing the events while you define the reporting devices using the MARS web interface. You still must define the reporting device by IP address and device type in MARS to ensure proper event correlation; however, you are not required to configure device to publish syslog messages directly to MARS.

Low-Latency, Real-Time Event Query

MARS can now display incoming raw events in real-time with a real-time event viewer query option. Previous releases of MARS had a real-time event query that sessionized and stored events before displaying them. This could incur delays of at least 2 minutes. The real-time raw event viewer operates in memory and has a 5-second delay. All parsed raw events are passed to the sessionizing module for further analysis.

To access the real-time event viewer, define a new query with All Matching Events, or All Matching Event Raw Messages as the Result Format, then select Raw events as the Real Time parameter.

XML Incident Notification

The new XML incident notification feature enables automated workflow integration with help desk and ticketing systems. XML incident notification is configured as an alert action of a rule. An XML data file is e-mailed to a specified recipient or group when the rule fires.

Based on the published schema (XSD file), you can develop custom parsing scripts to drive your ticketing or help desk system. You can also compress the e-mailed XML data file using gzip compression. XML incident notification benefits are as follows:

The XML data file includes all information related to the incident that can be seen on the web interface, except for Path/Mitigation information

Recipients do not have to log in to MARS to view the incident data

The XML schema definition allows integration of the XML notifications with third-party applications

Disk Usage via CLI, Events, Inspection Rules, and Reports

To address the operational planning needs of storage and archive, MARS 4.2.1 includes two new CLI commands that provide database and disk usage information. It also includes a new event, inspection rule, and report to provide the information and notify the administrators of upcoming purging events.

The two new commands are dbusage, which identifies current database usage and future allocation plans through either unused partitions or purging of oldest data, and diskusage, which displays the amount of disk space available on all partitions.

The new event, CS-MARS DB partition filling up causing the next partition to be purged soon, notifies the administrators when the current partition is 75% full and switching to the next partition will result in data being purged from a previously used partition. The system inspection rule and report allow you to monitor when this event fires. The inspection rule is System Rule: CS-MARS Database Partition Usage, and the report is Resource Utilization: CS-MARS-All Events.

Improved Performance of Software Upgrades

Because MARS relies on frequent signature updates to stay abreast of the most recent known attacks and issues, software updates are an integral part of any operational plan. Even on small appliances that monitor low volume traffic, this upgrade can consume valuable time, both as system downtime and in terms of administrative monitoring and verification.

Beginning with release 4.2.1, the software upgrade uses binary differential updates rather than complete image updates. As a result, both signature update and system patch performance is greatly improved.

Low-End Monitoring Solution: MARS 20R

The MARS 20R provides the same functionality as the MARS 20 with the restriction of accepting only 50 events per second and 1,500 NetFlow flows per second. It is restricted to operate as a standalone Local Controller and cannot be managed by a Global Controller. This entry-level product is positioned as a low-cost replacement for Monitoring Center for Security found in the VMS 2.x suite. However, it is orderable through regular channels. No upgrade option exists for this model.

Distributed Threat Management (DTM) Enhancements

The system parameters controlling the DTM features of MARS now provide improved control and the ability to specify the frequency of synchronization and default action of the N signatures being reported as active on Cisco.com/MySDN. Specific enhancements are as follows:

(Enhancement) Signature Inactivity Interval For Deletion. Users can now specify the time period for which signatures are kept on IOS IPS routers with IPS support before they are deleted. This setting replaces the previous DTM Deletion Interval setting.

(New) Top N Signature Pulling Interval From CCO (default 15 minutes). MARS pulls the CCO Top N signatures each time this interval expires. MARS then pushes these Top N signatures to all DTM-enabled IOS routers. (any IOS router that included in any DTM Rule action).

(New) Top N IPS Signature Action. Applies a global action to the Top N signatures retrieved from CCO. This action is applied only to the CCO Top N Signatures.

(New) Support for NATed IOS IPS devices. Previously, MARS did not support IOS IPS devices that did not reside on a network that was directly connected to the eth0 interface of the MARS Appliance. This feature enables access to IOS IPS devices that reside behind NATed gateways.

(Enhancement) Support for additional signature actions. The notification action for DTM now includes the deny attackers and deny flow actions, which are applied to the signatures published to the IOS IPS routers that are targets of the notification.

Case Management Enhancements

The following enhancements to case management are included in the MARS 4.2.1 release:

The filter, Open Cases, displays all open cases.

In releases before 4.2.1, information was copied to a case when it was closed. This timing allowed the possibility that information might be deleted before the case was closed. Now, information is copied as it is attached to the case.

In releases before 4.2.1, you could e-mail a case to its owner only. Now, you can e-mail a case to anyone who has an account in MARS, and you can select multiple recipients.

The ability to show and hide attachments. In 4.2.1, two view buttons appear on the Case Management page: Show All and Show Included. The default view is Show All, which displays all information associated with the case and is consistent with previous releases. Show Included allows you to display only those attachments that are selected.

In releases before 4.1.5, query results were limited to 100 entries. In release 4.1.5, the limit was increased to 5,000. If the number of results is larger than the paging size, you are presented with a popup window that identifies how many results there are, the paging size, and prompts you to specify how many to display. The upper limit of 5,000 results in a query still exists; however, you can reduce the number of results if the paging size is greater than the number of records.

You can no longer edit a closed case or change the name of the case. You can view, e-mail it, and add a comment.

A general issue with case management still exists where attachments can take while to appear in the case, particularly if that attachement is large. Therefore, if you add something to a case but the attachment does not appear when you review the case, allow some time to pass and try again. It simply takes a while for large attachment to be associated with the case.

Using ISS Site Protector to Configure ISS NIDS and HIDS

MARS supports ISS NIDS and HIDS event retrieval via SNMP. However, when configuring ISS RealSecure sensors (NIDS) and hosts (HIDS), you must configure each active signature to send an alert to the MARS Appliance. This task can be tedious because you must configure each sensor and after each signature upgrade, as an upgrade resets the redirect configuration. You can simplify this task by using the ISS Site Protector management console to define these changes globally and apply them to each sensor.

ISS Site Protector 2.0 allows you to centrally manage SNMP alert destinations, such as the MARS Appliance, for group policies. You can then push these group policies to all desired host and network sensors. For each ISS signature update, you must specify the MARS Appliance as an SNMP alert destination before you apply the downloaded signatures to sensors using Site Protector.


Note The configuration was qualified using an ISS Proventia G100 appliance (NIDS) and Site Protector 2.0 (Management Console).


Miscellaneous Changes and Enhancements

The following changes and enhancements are the result of caveats fixed in the 4.2.1 release:

Feedback button behavior changes. The Feedback button now sends an e-mail to the logged on user, who can forward it to the appropriate support personnel. If the logged on user does not have an e-mail address configured, a pop-up window instructs the user to define one.

Pink Box behavior changes. A pink box appears when a system error in the web interface is detected. In releases before 4.2.1, you could send the error log and related information to Cisco using the Report Error button. In the 4.2.1 release, you can choose to e-mail the error log directly to Cisco TAC. The log can be attached to an existing TAC case, which requires that you provide a valid TAC case number or create a case.

Device version upgrade support. Previously, if you upgraded the software version of a support device, you could not reflect that change in MARS. To do so, you had to delete the old device and then add a new device with the correct software version. In the 4.2.1 release, the Change Version button appears on the Security and Monitoring Devices page, allowing you to identify such changes on defined reporting devices.

Severity of a syslog changed in the originating device. In the 4.2.1 release, MARS ignores the severity of the event in the message while parsing IOS, PIX, and FWSM messages. This enhancement allows you to change the severity of a syslog server without breaking the MARS parser. This change addresses issues defined in CSCpn03044.

Blocked packet from the sensor can now be seen. In releases before 4.2.1, MARS made no indication whether an IPS device blocked a detected attack. In the 4.2.1 release, MARS displays "Block-YES" in IPS raw message if the reporting device blocked the attack. This enhancement allows you to generate reports on the attacks that are blocked by an IPS device. This change addresses issues defined in CSCsb70121.

Discovery of Symantec agents. In the 4.1.4 release, MARS learned, through discovery, of agents managed by Cisco Security Agent and McAfee ePO management consoles. In the 4.2.1 release, this functionality has been extended to the Symantec AntiVirus management console. This change addresses issues defined in CSCsc30044.

Automatically add Reporting IP as part of the SNMP Discovery process. In the 4.2.1 release, MARS defines the Reporting IP of devices discovered during the discovery processes. This change addresses issues defined in CSCsc50789.

Alert if MARS is dropping events. A system inspection rule, System Rule: Resource Issue: CS-MARS, has been defined that alert when the MARS Appliance begins to drop events rather than process them due to system resource limitations, such as exceeding storage capacity, dropped events due to rate limits being exceeded, capacity limitations, and so on. This feature applies to standard events and NetFlow records. Four new event types (found in the Info/HighUsage/CS-MARS group) are included in the rule definition. These event types identify the following:

First dropped event in one hour

Dropped event count in one hour

First dropped NetFlow in one hour

Dropped NetFlow count in the hour

A new System: CS-MARS Issue report, Resource Issues: CS-MARS - All Events, is provided to summarize these notifications. These changes address issues defined in CSCsc33942:

Configurable event summary display on the Summary > Dashboard page. Previously, MARS displayed the last 24 hours of statistical event information. You can now select the interval for displaying summary event results. Choose from the past day, two days, week, month, or year.

New Vendor Signatures

The following table describes the most recent signatures supported for each product or technology:

Product
Signature Version Supported

Cisco IDS 4.1/IPS 5.x

S229

McAfee Entercept HIDS 4.1

Agent Version 40-56

ISS RealSecure Network Sensor 7.0

24.36

ISS RealSecure Server Sensor 7.0

24.36

McAfee IntruShield NIDS 1.8

1.8.75.4

Snort NIDS

2.3.3

Netscreen IDP 2.1

Idp2.1r3 Update 254

Enterasys Dragon 6.x

Latest signatures as of 06-01-2006

Symantec Manhunt

3.4.3 Update 53

Qualys QualysGuard 3.x

Latest Knowledge Base XML file as of 02-07-2005

Common Vulnerabilities and Exposures (CVE) Database

Latest as of 09-08-2005


Upgrade Instructions

The MARS upgrade packages are the primary vehicle for major, minor, and patch software releases. As administrator of the MARS Appliance, you should check the upgrade site weekly for patch upgrades. In addition to addressing high-priority caveats, patch upgrade packages update system inspection rules, event types, and provide the most recent signature support.

For detailed instructions on planning and performing an upgrade or install, refer to Checklist for Upgrading the Appliance Software in the Install and Setup Guide for Cisco Security Monitoring, Analysis, and Response System.

Important Upgrade Notes

To ensure that the upgrade from earlier versions is trouble free, this section contains the notes provided in previous releases according the release number. Please refer to the notes that pertain to the release you are upgrading from and any releases following that one.

Upgrade to 4.2.1

As identified in CSCse17864, CSCse22610 and CSCse22617, the changes in the case management feature requires that you close all cases before upgrading from MARS 4.1.x to 4.2.1. By closing the cases, you ensure that the device, report, and query information is copied to the case, assuming it still exists in the database.

Upgrade to 4.1.5

No important notes exist for the 4.1.4 upgrade.

Upgrade to 4.1.4

No important notes exist for the 4.1.4 upgrade.

Upgrade to 4.1.3

No important notes exist for the 4.1.3 upgrade.

Upgrade to 4.1.2(2042)

The following notes detail changes to the standard upgrade process:

If you completed the 4.1.1 to 4.1.2 (2040) upgrade, verify whether the upgrade failed by entering `pnlog mailto <SMTP server> <sender> <recipient>' at the CLI. This commands mails the MARS Appliance logs to the recipient. Open the e-mailed file attachment, and then open the newest upgrade*.log found in /var/log/. Successful upgrades from 4.1.1 (2022) to 4.1.2 (2040) include the following line:

Opening file: 
/etc/data/secondarytables/reports/Report.0.Resource-Issues--IOS-IPS-DTM---All-Events.x
ml

If you do not see this line, then a problem occurred during the upgrade regardless of whether the version command reports 4.1.2 (2040).

To upgrade from 4.1.1 or a successful or unsuccessful 4.1.2 (2040) to 4.1.2 (2042), download the package, perform the upgrade as defined in Checklist for Upgrading the Appliance Software. If you are upgrading from 4.1.1, you must also execute the following command at the CLI of the upgraded MARS Appliance:

script -b patch_or_04_1_16.sh

The 4.1.2 (2042) image includes an additional command `script' that cleans the database of the data referenced in CSCsc31386. As a result of running the script, the total upgrade process from 4.1.1 to 4.1.2 (2042) may take much longer than previous releases; it depends on the amount of data stored on the MARS Appliance. For a MARS 200, it could double the normal upgrade time to two hours. To determine whether the script is still running, enter the following command and look for `patch_or_04_1_16.sh' anywhere in the output:

sysstatus -n 1 -b

Upgrade to 4.1.1

The following notes relate to changes in your system or configuration as a result of upgrading to MARS 4.1.1.

Prior to the 4.1.1 release, CSA was identified by the device type name Cisco CSA 4.0. As part of an upgrade, any Cisco CSA 4.0 devices were renamed as Cisco CSA 4.x. This new name includes support for Cisco CSA 4.0 and 4.5.

The new case management replaces the Escalate Incident functionality in MARS 3.4.4 and earlier. However, escalated incidents are not converted to cases during the upgrade process. Therefore, you must close all open escalations before upgrading to MARS 4.1.1 (CSCsb52057).

Required Upgrade Path

When upgrading from one software version to another, a prerequisite version is always required. This prerequisite version is the minimum level required to be running on the appliance before you can upgrade to the most recent version. Table 1 identifies the upgrade path that you must follow to reach the minimum level required to upgrade to current version.

Table 1 Upgrade Path Matrix

From Version
Upgrade To1
Upgrade Package

releases prior to 2.5.6

Contact Cisco Support

n/a

2.5.6

3.1.1

pn-3.1.1.pkg

3.1.1

3.2.1

pn-3.2.1.pkg

3.2.1

3.2.2

pn-3.2.2.pkg

3.2.2 or 3.3.2 Beta

3.3.3*

pn-3.3.3.pkg

3.3.3

3.3.4*

pn-3.3.4.pkg

3.3.4

3.3.5*

pn-3.3.5.pkg

3.3.5

3.4.1*

pn-3.4.1.pkg

3.4.1

3.4.2

pn-3.4.2.pkg

3.4.2

3.4.3

pn-3.4.3.pkg

3.4.3

3.4.4

pn-3.4.4.pkg

3.4.4

4.1.1

csmars-4.1.1.pkg

4.1.1

4.1.2 (2042) + script command

csmars-4.1.2.pkg2

4.1.2 (2040) without error

4.1.2 (2042)

csmars-4.1.2.pkg2

4.1.2 (2042)

4.1.3

csmars-4.1.3.pkg

4.1.3

4.1.4

csmars-4.1.4.pkg

4.1.4

4.1.5

csmars-4.1.5.pkg

4.1.5

4.2.1

csmars-4.2.1.pkg

1 An asterisk (*) next to a package name in this column identifies that this upgrade must be performed from the command line, as GUI support was lost with the closing of the upgrade.proteogonetwork.com website.

2 To upgrade from 4.1.1 or 4.1.2 (2040) to 4.1.2(2042), please review the special upgrade notes in the Quick Install and Release Notes for Cisco Security MARS Appliance 4.1.2 (2042).


Downloading the Upgrade Package from CCO

Upgrade images and supporting software are found on the CCO software download pages dedicated to MARS. You can access these pages at the following URLs, assuming you have a valid CCO account and that you have registered your SMARTnet contract number for your MARS Appliance.

Top-level page:

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

And then click the Download Software link in the Support box on the right side of the MARS product home page.

Result; The Download Software page loads.

From this top-level page, you can select one of the following options:

CS-MARS IPS Signature Updates Archives

CS-MARS IPS Signature Updates

CS-MARS Patches and Utilities (supplementary files)

CS-MARS Recovery Software

CS-MARS Upgrade Packages


Note If you are upgrading from a release earlier than those posted on CCO, please contact Cisco support for information on obtaining the required images. Do not attempt to skip releases along the upgrade path.


For information on obtaining a CCO account, see the following URL:

http://www.cisco.com/en/US/applicat/cdcrgstr/applications_overview.html

Important Notes

The following notes apply to the 4.2.1 release:

Do not to use DISTINCT or SAME in queries, and do not run multi-line queries in Release 4.2.1. If you run such a query, the system time outs after 20 minutes without returning any results. The message "Timeout Occurred" appears instead. You can use DISTINCT and SAME in a Query to create a rule with the Query interface.

For Symantec AntiVirus, the Symantec agent hostname (AV client computer name) appears in the "Reported User" column of the event data. Therefore, you can define a query, report or rule related to this agent based on the "Reported User" value.

The False Positive and Query pages (multi-column result format) have changed. You can now query on firing events that triggered false positives within a time interval. Such queries will render events that did not appear on the False Positive page. To ensure performance, the False Positive page only displays false positives from the most recent 10,000 firing events. To view additional false positives, you must perform a query.

Quick Install Notes

It is recommended that users read the Install and Setup Guide for Cisco Security Monitoring, Analysis, and Response System. However, for those users who simply want to get the MARS Appliance up and running, the following two topics, taken from the Install and Setup Guide for Cisco Security Monitoring, Analysis, and Response System, summarize the hardware installation and initial software configuration:

1. Installation Quick Reference

2. Checklist for Initial Configuration

Installation Quick Reference

Table 2 provides an overview of the installation and initial configuration process. Following installation and initial configuration, see the following publications for information on how to use a browser and the HTML interface to fully configure your MARS Appliance to provide the security threat mitigation (STM) services you want from this installation:

User Guide for CS-MARS Local Controller Version 4.2.x

User Guide for CS-MARS Global Controller Version 4.2.x

Table 2 Quick Reference 

Task
References in Install Guide

Use the rack mount kit to install the MARS Appliance in a rack.

Installing the MARS Appliance in a Rack

Connect the MARS Appliance to an AC power source.

Connecting to the AC Power Source

Connect network and console cables.

Connecting Cables

Turn on the appliance.

Powering on the Appliance and Verifying Hardware Operation

Verify initial power up.

Powering on the Appliance and Verifying Hardware Operation

Perform initial configuration of the MARS Appliance.

Checklist for Initial Configuration

Configure the MARS Appliance to monitor reporting devices.

Next Steps


Checklist for Initial Configuration

Initial configuration of the appliance accomplishes several goals:

Introduces the two user interfaces to MARS: the command line interface (CLI) and the web interface.

Licenses the appliance.

Prepares the appliance to monitor and communicate on your network.

Configures the system time so that event correlation works properly.

Ensures the system administrative account is configured properly.

Ensures appliance is running the most recent version of software.

The following checklist describes the tasks required to initially configure your MARS Appliance. Each task might contain several steps; the tasks and steps within should be performed in order. The checklist contains references to the specific procedures used to perform each task.

Task

1. Establish a console connection to the appliance.

Initial configuration requires a console connection to access the CLI. You should establish this connection with the power turned off on the MARS Appliance. Three console connection options exist:

A direct console connection to the appliance using a keyboard and monitor

A standard serial console connection between a computer and the appliance using a terminal emulation package

An Ethernet console connection between a computer and the appliance using a terminal emulation package

After you have chosen and configured your console connection, you must power up the appliance.

Result: The appliance is powered up and you can see the command line prompt through your console connection.

For more information, see:

Establishing a Console Connection

2. Command Line Configuration: Setting the system administrative account's default password and configuring the interfaces.

The command line configuration is separated into three tasks, each task being separated by a reboot of the appliance. The first task involves performing three to four procedures:

Collect the information required to configure the appliance to operate optimally on your network.

Log in to the appliance and change the password associated with the system administrative account (pnadmin).

Configure the eth0 network interface, specifying the default gateway and IP address and network mask pair for that interface.

(Optional) Configure the eth1 network interface, specifying the IP address and network mask pair for that interface.

Each MARS Appliance has two Ethernet interfaces: eth0 and eth1. The eth0 interface is the dedicated interface used for collecting event data and logs from your network. The eth1 interface is intended for use in an out-of-band management (OOBM) network or for a console connection. Therefore, your default gateway and IP address/mask values should focus on the network connections to be used to monitor the data streams of reporting devices, and these settings should be applied to eth0.

Note The MARS Appliance does not allow you to configure both of its interfaces on the same network.

Result: The default password is no longer associated with the system administrative account and the appliance is more secure. Also, the eth0 is configured to communicate on your network. When you complete the IP address configuration changes for either, the appliance reboots.

For more information, see:

Configuring Basic Network Settings at the Command Line

Change the Default Password of the System Administrative Account

Specify the IP address and Default Gateway for the Eth0 Interface

(Optional) Specify the IP Address and Default Gateway for the Eth1 Interface

3. Command Line Configuration.

The second task of the CLI configuration involves setting the hostname of the appliance. The hostname is used to uniquely identify which appliance collects a specific log and which appliance fires an inspection rule. This unique identity is especially important in an environment where Global Controller is running. To complete this task, you must:

Log in to the appliance using the system administrative account and the new password.

Set the hostname of the appliance.

Result: The hostname is configured for the appliance. The appliance reboots.

For more information, see:

Specify the Appliance Hostname

4. Command Line Configuration.

The third and final task of the initial CLI configuration involves specifying those settings that help ensure the integrity of the event correlation and complete your network connection, allowing access to the appliance from other hosts on the network. In other words, after you complete this phase, you can connect to and complete the appliance configuration using a non-console connection from any host on your network. To complete this task, you must:

Log in to the appliance using the system administrative account and the new password.

Set any additional static routes.

Set the clock.

Set the NTP server settings.

Set the DNS domain name.

Connect the appliance to the network (that is, plug in the Cat 5 cables.)

Result: Now you have network connectivity. You can access the CLI interface using an Secure Shell (SSH) client on any host that can reach the appliance, and you can log in to the web interface to complete the initial configuration.

For more information, see:

Specify the Time Settings

Set Up Additional Routes

Completing the Cable Connections

5. Complete initial configuration using the web interface.

After you have completed the cable connections to the MARS Appliance, defined the required network connection settings, and specified any additional default routes, you can start the web interface configuration process. Verify the configuration settings of your browser before configuring the MARS Appliance (see Web Browser Client Requirements).

During this phase, you configure the following:

Appliance license

Zone identification (Global Controller only)

E-mail server identification

DNS addresses

E-mail address for the system administrative account (pnadmin)

TACACS/AAA login prompt settings

Result: You have configured your appliance to communicate on the network, properly correlate events, and issue system e-mails to a monitored e-mail address.

For more information, see:

Completing the Configuration using MARS web interface

Licensing the Appliance

Verifying and Updating Network Settings

Specifying the DNS Settings

Configure E-mail Settings for the System Administrative Account

Configure TACACS/AAA Login Prompts

6. Upgrade the appliance to the most recent software version.

The software version determines the currency of signatures, system inspection rules, features, and bug fixes. An important part of your security solution is ensuring that you maintain the most up-to-date software on the MARS Appliance. This process involves preparing an upgrade strategy and selecting a method, determining your current version, identifying the most recent version, and downloading and applying all intermediate versions of the software.

Result: The appliance is running the most recent version of software.

For more information, see:

Checklist for Upgrading the Appliance Software


Caveats

This section describes the open and resolved caveats with respect to this release.

Open Caveats - Release 4.2.1

Resolved Caveats - Release 4.2.1

Resolved Caveats - Releases Prior to 4.2.1

For your convenience in locating caveats in Cisco's Bug Toolkit, the caveat titles listed in this section are drawn directly from the Bug Toolkit database. These caveat titles are not intended to be read as complete sentences because the title field length is limited. In the caveat titles, some truncation of wording or punctuation may be necessary to provide the most complete and concise description. The only modifications made to these titles are as follows:

Commands are in boldface type.

Product names and acronyms may be standardized.

Spelling errors and typos may be corrected.


Note If you are a registered cisco.com user, view Bug Toolkit on cisco.com at the following website:

http://www.cisco.com/support/bugtools

To become a registered cisco.com user, go to the following website:

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


Open Caveats - Release 4.2.1

The following caveats affect this release.

Reference Number
Description

CSCse56692

Issue: Policy query should not be case sensitive with interface names

Description: The policy table lookup feature in MARS is case sensitive when performing queries that match against interface names, such as outside and Outside. The two names are considered exclusive by MARS, while they are equivalent in Security Manager. As a result, name logged in the syslog event may not match the name in Security Manager. Syslog message lowercase all interface names.

Workaround: Use lowercase for all interface names an in the definition of interface roles in Security Manager.

CSCse56473

Issue: High pnparser CPU usage in processUserInfo thread

Description: One pnparser consumes 99% of the CPU for extended periods of time. As a result, you may notice:

Events continue to be processed and saved into database but reported users contained in events are not extracted.

Therefore, rules/queries/reports that match on reported users in events will not produce correct results.

Workaround: None.

CSCse54808

Issue: The time stamp shown by the pndbusage command is incorrect

Description: Two consecutive uses of the pndbusage command display a different current partition starting time.

Workaround: None.

CSCse53573

Issue: false alarm error in janus_log: corruption in shared buffer

Description: MARS processes use a shared buffer for event and incident data. Data is written in the form of fixed sizes where the size depends on the MARS Appliance model and whether type of shared data. Previously, the maximum size was 100,000, and therefore, an error message such as "corruption in shared buffer: encountered a large (>=100000) length chunk component, currentSize = 220260" would indicate data corruption that results in MARS skipping some events or incidents. However, fixing the defect CSCse24869 increased the maximum size to 300000 and therefore an error printed in the logs for data larger than 100000 is a false alarm as it can legitimately occur.

Workaround: You can safely ignore this error message when it refers to a chunk size smaller than 300,000.

CSCse51438

Issue: No GUI message to indicate a real-time event viewer timeout

Description: The real-time event viewer session will timeout if paused for more than 30 minutes. No error message will appear to indicate that the real-time event viewer is inoperative. Because the MARS login session timeout is also 30 minutes, you are directed to the MARS login screen when you click any GUI control after 30 minutes. After you login to MARS, the behavior is as follows depending on the GUI control you clicked:

Tab—a blank page appears with a URL similar to the following:

https://172.16.16.16/Query/LLRTQueryStop.jsp?requestType=STOP&maxRows=40

Submit button—The default Query Event Data dialog appears.

Resume button —MARS displays the contents of a buffer then stops. The buffer contains the events that were not yet displayed when you clicked Pause.

Restart button—MARS clears the paused display and does not display new events.

Workaround: Click Clear and submit a new real-time event viewer query.

CSCse45884

Issue: Real-Time (raw events) query causes client CPU to go to 100%

Description: At a high rate of incoming events, i.e., 100 events per second, the low latency query page consumes 100% of the CPU on the web interface client.

Workaround: None.

CSCse40803

Issue: Parsing error for FWSM-3-106011

Description: MARS fails to parse the FWSM syslog message "Error Message %FWSM-3-106011: Deny inbound (No xlate) string".

Workaround: None.

CSCse40779, CSCse23051

Issue: Query: Save as report with Mac Addr report criteria throws an Exception

Description: If you create a report using the query type: MAC addresses report, an exception (pink box) occurs.

Workaround: None.

CSCse38565

Issue: Re-importing Symantec AV client CSV doesn't work

Description: If you import Symantec AntiVirus agents into the MARS web interface using the CSV file format and then delete those agents, you cannot re-import them. Attempts to re-import will result in the error, "Error Occurred: Status: DbDevice", and none of the agents will be created.

Workaround: None.

CSCse34600

Issue: CPU utilization is not reported for PIX device

Description: When you select Yes in the Monitor Resource Usage box of the General tab for a PIX device, the CPU utilization is not reported for that device.

Workaround: None.

CSCse34407

Issue: Query Tab > Multi column query returns wrong results.

Description: When running a multi-column (custom column) query for a short duration of time, the results returned might contain a lot more data then actually expected.

Workaround: For correct results, run a regular query inline. In other words, do not choose custom column option for Result Format.

CSCse33688

Issue: no events under Cisco Switch-IOS 12.2

Description: With an IOS switch device, received logs should appear under Cisco Switch-IOS 12.2, However, they are being sorted under Cisco IOS 12.2 instead. In addition, under Management > Event Management, if you select Cisco Switch-IOS 12.2, no events appear.

Workaround: There is no work around to the incorrect sorting. To see the logs received from a Cisco Switch-IOS device, query using Cisco IOS 12.2 instead.

CSCse32591

Issue: dealing with duplicate hostnames in VA import

Description: While importing VA data from any one of the supported devices, MARS does the following:

1. For each device included in the report, MARS checks whether a device with the same name exists in the database.

2. If the device with the same name already exists in the database, then MARS changes the name of the new device according to the convention "devicename (count)", where "count" is the number of devices that exist in the database and have the same "devicename" substring. Using the new "devicename (count)" name, MARS adds the device to the database.

This issue is that when importing data about a given device, such as a router with multiple interfaces, MARS defines multiple, separate devices.

Workaround: None.

CSCse31722

Issue: Cloud toggle only works on first page of reporting devices

Description: You cannot expand or collapse devices within a cloud on pages other than the first page in the Security and Monitor Devices page. If you select this option on the second or later pages, the first page is displayed.

Workaround: None.

CSCse29860

Issue: UTC and GMT time zone missing

Description: In 4.1.5, the UTC standard is no longer available as an option for setting the clock on the MARS Appliance.

Workaround: None.

CSCse23176

Issue: MARS Global Controller not producing alerts when losing Local Controller communication

Description: The Global Controller is not generating alerts when it loses communication with the Local Controller. The user must determine this manually.

Workaround: At the command line on the Global Controller, run pnlog to determine whether the Local Controller is generating "Data timed out errors" or to run tcpdump to verify the Local Controller communication.

CSCse22751

Issue: Case management fails to 'Expand All' for attached report

Description: The Expand All option may not display sub-events that are attached to case. For example, if you attach the results of a batch query for all matching sessions to an existing case, where the results returned more than 5,000 sessions and so only the page displayed was added).

Workaround: None.

CSCse21936

Issue: Daylight savings time affects the custom parser's received time field

Description: The hour string in the parsed value field of user-created templates, shows an hour after the actual log timestamp on and after daylight savings time. (April 2, 2006)

Workaround: None.

CSCse21626

Issue: Clicking activate is not taking effect

Description: After disabling some DTM rules and enabling others, clicking Activate does not effect the changes.

Workaround: If Activate does not work, perform a pnstop and then a pnstart operation at the command line.

CSCse20593

Issue: CSM device type could not be added one time (OK most times)

Description: Rarely, when adding a Cisco Security Manager device type, a run-time scripting error occurs. This issue appears when there is a timeout situation in either the parent or child browser window, or when one window is unexpectedly closed.

Workaround: This issue rarely occurs. To work around the issue, repeat the add operation.

CSCse18865

Issue: scalability issues in My Reports page

Description: If you have a large number of reports (e.g., 70 or more) on the My Reports page, and displaying them takes a long time.

Workaround: None.

CSCse18816

Issue: UI takes 99% CPU, hanging browser and slowing system while expanding all

The client window (Internet Explorer) becomes unresponsive, the cursor state shows the application is processing information and remains in this state for 5+ minutes and/ or Windows marks the browser as 'Not Responding'. This issue occurs when the user clicks the '+' sign or 'Expand All' in the query results page where >1000 events are grouped together based on the query criteria.

Workaround: The following options are available:

Instead of using Expand All, expand one group at a time.

To resolve the hung process. close the client (Internet Explorer) or kill the process using Task Manager and open a new window to re-run the query.

CSCse17936

Issue: 5K Lines Custom Query fails

Description: In some cases, custom query can result in errors on the rendered page, as well as an incomplete page appears. In the known cases, this issue appears to have been the result of using the "raw message" field in the custom query.

Workaround: Removing the raw message column from the Query resolves the issue. This issue does not appear in all custom queries that include the raw message field.

CSCse17864, CSCse22610, CSCse22617

Issue: Device info was lost after migration

Description: Case Management migration from 4.1.x to 4.2.x can result in lost reports, queries, and devices that are associated with open cases.

Workaround: Close all Case Management cases before migrating to 4.2.x. By closing the cases, you ensure that the device, report, and query information is copied to the case, assuming it still exists in the database.

CSCse13038

Issue: CS-MARS - learning of McAfee agents with invalid names

Description: McAfee ePO agents with non-ASCII hostname/character set, that are imported automatically into MARS 4.1.4 and later, will add devices with invalid names. Events reported from such agents may have:

An invalid device name in the reporting device column

Invalid characters in raw message.

This issue is caused by the lack of I18N support in the current MARS release. The following are likely causes of this issue:

Invalid characters in the raw message sent from the ePO agent

ePO agent names that contain some additional text, such as date or time

Workaround: Identify such invalid devices in MARS web interface and delete them periodically.

CSCse11258

Issue: After group is deleted, items under All group not shown

Description: This is a minor/cosmetic defect, as the delete is performed correctly, but the display is incorrect.

Workaround: Click the tab again, or any other selection that leads to a page refresh, to see all items in the All group.

CSCse10945

Issue: Summary Page Graphs Spontaneously Change Displayed Size (w/ multi-head)

Description: Graphs on the Summary Dashboard, Network Status, and My Reports pages can change display sizes when using a multi-head display. This issue can appear on both the Global Controller and Local Controller when the display period is in minutes. The content displayed is correct, however, the size of the display changes.

Workaround: Do not use a multi-head display.

CSCse09127

Issue: Failed load from csv returns incorrect status

Description: When a Load from csv operation fails, no errors are reported. Instead, the status is reported as OK. This issue appears when the user has configured an FTP server that does not allow passive transfer. The symptom is that the status is reported as OK, but there are no devices loaded in the MARS web interface.

Workaround: Other than using an FTP that supports passive transfer, no work around exists.

CSCse03134

Issue: More control is needed over retrieve raw messages and cleanup

Description: Repeated use of the `Retrieve Raw Messages' feature results in the following error message:

ava.io.IOException: No space left on device.

This occurs if `Retrieve Raw Messages' is used excessively within a short period of time.

Workaround: None. These files are cleaned up automatically after 2 weeks time.

CSCse00668

Issue: rule definition changes can lead to empty reports

Workaround: You can avoid this issue by defining a Rule Group for every rule that is to be used in a scheduled report.

CSCse00626

Issue: IP Management device group displays hosts only

Description: The View > Host option on Management >IP Management page filters all devices defined on the Security and Monitor Devices page from the IP Management page, including from Device groups, which in itself is expected behavior. However, this introduces an inconsistency as any type of device can be added to a Device Group through the Edit/Add Group button. After clicking Submit, the group lists only the Host entries, typically a subset of all devices belonging to a group, and this can be confusing to the user.

Workaround: To view the actual contents of a group, Select a device group and click the Edit Group button.

CSCse00251

Issue: process_inlinerep_srv ignores Rule Groups as selection/filtering criteria

Description: Rule groups are ignored as selection criteria in an inline report.

Workaround: You can avoid this issue by defining a Rule Group for every rule that is to be used in a scheduled report.

CSCsd96070

Issue: Data refreshes can take a long time when attempting to view the report data associated with that case.

Description: Due to the issues identified in CSCsd96067, viewing all of the data contained in a case that contains multiple reports can take a long time to load.

By default, reports attached to cases limit their results to 25 per page. Due to each report having its own paging value and the issues identified in CSCsd96067, attempting to view all of the data in each report attached to a case by changing to paging to something larger can take a long time.

Workaround: Limit the number of reports attached to a case and restrict the number of events returned to only that which is required. A general issue with case management exists where attachments can take while to appear in the case, particularly if that attachment is large. Therefore, if you add something to a case but the attachment does not appear when you review the case, allow some time to pass and try again. It simply takes a while for large attachment to be associated with the case.

CSCsd96067

Issue: Report e-mails can become large when selecting the raw message format for all matching events.

Description: Because MARS now allows reports to return up to 5000 events, rather than the previous limit of 1000 events, the report size can be much larger than previously experienced (10-15 MB, depending on the data returned).

Workaround: To avoid this issue, define exact report parameters and restrict the number of events returned to only that which is required.

CSCsd96048

Issue: When using case management, choosing to e-mail case data can generate very large e-mails.

Description: Due to the issues identified in CSCsd96067, choosing to e-mail a case that contains multiple reports can compound the problem of large e-mails.

Workaround: Limit the number of reports attached to a case and restrict the number of events returned to only that which is required.

CSCsd95582

Issue: Both successful/failed mitigation reports show same results

Description: For 4.1.5 release, a query based on either the "CS-MARS Host Mitigation - Failure - All Events" or "CS-MARS Host Mitigation - Success - All Events" report retrieve all events associated with a session, which explains why both report types display both failed and successful raw messages.

Workaround: None.

CSCsd93235, CSCsd10627

Issue: MARS can take up to 1 hour to connect to all IPS devices (when there are 60 or more devices) the first time the process comes up. This issue can appear after a power cycle.

Workaround: None.

CSCsd92285

Issue: MARS does not perform a duplicate IP address check in the Admin > Security and Monitor Devices page

Description: In the 4.1.5 release, MARS does not perform a duplicate IP address check for agents, sensors, and firewalls matching one of the following host-based applications:

CheckPoint Opsec NG FP3

Cisco CSA 4.x

Enterasys Dragon 6.x

Entercept Entercept 2.5

Entercept Entercept 4.0

IntruVert IntruShield 1.5

NetScreen IDP 2.1

Symantec Anti Virus 9.x

As such, avoid using a duplicate IP addresses to prevent event correlation issues with your MARS Appliance. In addition, when you add or edit a new host using the Security and Monitor Devices page, no duplicate IP address checks are performed. Avoid using existing IP address as the host IP address when adding or editing a host.

Workaround: MARS does perform a duplicate IP address check on the IP Management page. We recommend that you add or edit the IP address of hosts using this page and that you add components to such defined hosts using the Security and Monitor Devices page. You must manually avoid the use of duplicate IDs when defining the host-based reporting devices listed above.

CSCsd89457

Issue: Incorrect handling of time range for rules that fire periodically

Description: To reduce false positives, the first time a rule first a time interval of 5 minutes must elapse before events being received can trigger the rule to fire again. After the second time a rule fires, the time interval is extended to 10 minutes. The fire count value is reset to 0 when no event that matches the rule is received within a past window of <time range> seconds.

For rules that fire once every 5 or 10 minutes, events greater than the rule count can accumulate, which is by design. Among these accumulated events, the first <count> number of events in an offset should be within the time range of the rule; however, this is not true and the result is a a higher false positive rate for incidents.

Workaround. None.

CSCsd86896

Issue: When editing the query type, clicking Clear does not work.

Description: When editing a query type, clicking Clear can actually commit changes to the query type definition rather than clearing any changes made by the user.

Workaround: None.

CSCsd84350

Issue: CS-MARS-Cisco Security Manager Integration: Credentials change on Cisco Security Manager side not checked.

Description: This issue exhibits when the following conditions are met:

1. Enter matching Security Manager credentials in MARS to match that in Security Manager server.

2. Query a "traffic log" related event that has the Security Manager icon enabled.

3. Check to see that the access rule lookup is functioning.

4. Go to Security Manager server and through CiscoWorks, delete the user set in MARS from Security Manager server.

5. Do not click any "Test Connectivity" on MARS side after the Security Manager server modification.

6. Again query the "traffic log" related event that has the Security Manager icon enabled.

7. Access rule lookup is still successful though Security Manager credentials is invalid.

Workaround: In the MARS web interface, click Admin > Security and Monitor Devices, and then select the Security Manager device, click Edit and then click Test Connectivity after deleting the Security Manager user, but before performing the access rule lookup. The credentials check is performed and fails the subsequent lookup as it should.

CSCsd84094

Issue: Problems occur when a report definition contains a rule as a selection criteria and the rule definition is later changed.

Description: This issue occurs as each changed rule is provide a new rule ID. The old rule ID is inactivated so that it does not fire, but the report definition points to the stale ID rather than the new ID created when the rule definition was changed. As a result of this stale reference, no results appear for the affected reports even though a new query based on the same criteria returns results.

Workaround: Use rule groups, instead of direct rule reference, in report definitions. The group will always point to the current rule definition instead of pointing to a stale rule definition.

CSCsd79730

Issue: Device Groups created on Global Controller do not show up in Global Controller drop down list of groups

Description: If you define a Device Group in Global Controller, the group is propagated to its monitored Local Controllers, but the new group does not appear in the Select Group list on the Management > IP Management page of the Global Controller web interface.

Workaround: None.

CSCsd74283

Issue: Report results are purged after a fixed time period.

Description: In releases 4.1.4 and earlier, report results were retained in the database for up to 365 days. However, as of 4.1.5, the maximum number of stored report results was increased from 100 to 1,000 for ranking reports and 1,000 to 5,000 for event/session reports. As a result, the retention period was reduced to 3 months for MARS 20 and MARS 50 models and to 6 months for the MARS 100, MARS 200, MARS GC, and MARS GCm models.

Workaround: None.

CSCsd69137

Issue: Default Group in Scheduler need to be made to Run On Demand

Description: The Default Group in Scheduler is currently set to run on 1st day of every month. Any devices/Networks added in the web interface or discovered are automatically added to this group. Thus, this discovery often returns more devices than desired.

The default behavior of this group is such that MARS learns of additional networks through user input and each discovery operation. Therefore, this default scheduled group can progressively discovery new devices via subsequent discoveries.

Workaround: Under Admin > System Setup > Topology/Monitored Device Update Scheduler, edit the Default Discovery Group and change the schedule to Run On Demand Only.

CSCsd69063

Issue: A MARS custom parser cannot parse a reported user field that contains a single quote (') character.

Workaround: None.

CSCsd61749

Issue: pnrestore does not restore some configuration settings

Description: Settings that are specific to the operating system and not configurable within the MARS HTML interface are not stored in the database, and therefore, they are not restored during pnrestore operation.

For example, pnrestore command does not restore static routes or NTP server settings defined at the CLI.

Workaround: Manually re-enter these settings from the command line.

CSCsd53173

Issue: Retrieve raw messages doesn't properly update the progress percentage

Description: When retrieving raw messages using Admin > System Maintenance > Retrieve Raw Messages, a percentage complete is displayed. This interface is not properly updated.

Workaround: Please wait for the task to complete.

CSCsd22832

Issue: Some networks cannot be removed from the IP Management tab of the Management section of the Web interface.

Description: The attempt fails with error message: "You cannot delete this network as it is used in discovery."

The error occurs when trying to delete a network that was added into the MARS automatically during device discovery. Those networks cannot be deleted in currently available versions.

Workaround: None.

CSCsc90480

Issue: MARS Incident notification options are not configurable

Description: Currently when MARS sends out incident notifications via e-mail, you cannot configure the types of links it sends out. As a result, it can send out links that are not reachable/invalid if the DNS name of the MARS Appliance cannot be resolved by the e-mail client.

Workaround: None.

CSCsc59363

Issue: Multi-line rules are difficult to edit.

Description: Editing multi-line rules can be confusing, particularly if you want to remove a line from a rule.

Workaround:

1. In the line above the line that you wish to remove, click on the link taking you to the "Severity" cell.

2. Click Next.

A dialog box appears, prompting whether you are finished defining the rule conditions.

3. Click Yes.

A warning message appears stating that the subsequent lines will be removed from the rule.

4. To remove all lines underneath the selected one, click OK to confirm the warning.

CSCsc50636, CSCsc50652

Issues: pnids50_srv process runs at 99% CPU when pulling large IP Logs

pnids50_srv process reaches 1GB in memory used when pulling IP Logs

These related issues, are specific to pulling IP logs from Cisco IDS/ IPS devices. The symptom is that the pnids50_srv and pnids40_srv services consume the system resources on the MARS Appliance. As an improper configuration of the sensor can significantly degrade the sensor performance as well as that of MARS.

Workaround: Ensure that settings for IP log creation on the sensor limit the size of the IP log (in terms of number of bytes or number of packets captured). Also, verify that IP packet logging is enabled only for signatures of interest and not for all signatures.

In addition, a 100 file maximum is enforced for the log file queue when the MARS is configured to pull IP log files. Therefore, it may not pull every IP log file. In addition, the complete IP Log file may not be pulled, instead, data is pulled from he file starting 5 minutes before the alert was generated through the end of the file.

CSCsc49248

Issue: A drop rule for "inactive reporting device" does not work.

Description: There are six internally generated event types in CS-MARS 4.1.x:

1. Sudden traffic increase event

2. Resource high usage event

3. Inactive reporting device detection event

4. VA integration event

5. Mitigation result event

6. DTM event

Events generated for items 4, 5 and 6 are processed against drop rules. However, items 1, 2 and 3 cannot be dropped as they are not processed against drop rules by design. Items 1, 2 and 3 record the history of what happened on the network and are retained in the database.

Workaround: You can delete the inactive device from CS-MARS or ensure that it is reachable by CS-MARS. For other event types, there is no work around.

CSCsc23874

Issue: Resource Utilization reports are incorrectly available to be run as a query.

Workaround: Do not attempt to run any of the following reports as an On Demand query or to use them as part of a user-defined group:
Resource Utilization:

Bandwidth: Inbound - Top Interfaces Resource

Utilization: CPU - Top Devices Resource

Utilization: Bandwidth: Outbound - Top Interfaces Resource

Utilization: Concurrent Connections - Top Devices Resource

Utilization: Errors: Inbound - Top Interfaces Resource

Utilization: Errors: Outbound - Top Interfaces Resource

Utilization: Memory - Top Devices

CSCsc04484

Issue: The rule or report list on a Local Controller (LC) appears empty after deleting a Global Controller (GC) report or rule group.

1. From the Rules or Reports page in the GC HTML interface, create a rule or report group with some elements in it.

2. Activate to push the group down to the monitored LC.

3. From the Rules or Reports page of a LC HTML interface, select the newly-created GC group in the filter list.

Result: The members of that group are listed.

4. Select the Summary page.

5. Select the Rule or Report page.

Result: The group is still selected as the "filter" for that page

6. Select the Summary page.

7. In the GC HTML interface, delete the rule/report group.

8. Activate to push changes down to the monitored Local Controllers.

9. In the LC HTML interface, navigate back to rule/report page.

Result: The filter list has "All" selected, but no rules or reports appear on the page.

Workaround:

1. Select another option in the filter list, and then All.

Result: The list of all rules/reports appears.

CSCsb80082

Issue: When you remove/delete a Local Controller from a Global Controller, the Local Controller should revert to the Standalone mode. However, if you add the Local Controller to the Global Controller and delete it before you exchange certificates between the two appliances, then the mode does not revert.

Workaround: You can work around this issue by ensuring that you always import the certificate from the Local Controller before you attempt to remove it form in the Global Controller.

CSCsb77550

Issue: Re-importing CSA or Symantec agents fails.

When the user tries to agents from a CSV seed file, the following error message appears:

Error Occurred:
Status: DbDevice

Result: The error message fails.

Workaround: If you import an agent list once, you must manually synchronize the agent list. To re-import the list of agents will not work.

CSCsb71309

Issue: In Cisco Security Monitoring, Analysis and Response System (MARS) release 3.4.4 and earlier, queries that are run from a Global Controller (GC) which have no results returned from any of the attached Local Controllers (LCs) will show up as "In Progress" in the GUI.

This occurs in a GC/LC environment, and only when a global query returns 0 results from every one of the LCs.

Workaround: You may have to wait up to 10 minutes for a GC Query status to be marked as "Finished", after all LCs have finished running the query.

CSCsb67871

Issue: After re-installing a Local Controller, the zone and device data is lost in the Global Controller.

Workaround: Before you re-install (using a Recovery DVD) a Local Controller, you must delete that Local Controller and zone from the managing Global Controller.

CSCsb64587

Issue: After Global Controller restore, the Local Controller certificates are missing.

Workaround: After restoring a Global Controller, you must re-import the certificates of each managed Local Controller before communications are restored.

CSCpn03077

Issue: Global Controller generates a system error when you add a Local Controller that was added already

Workaround: Before adding a Local Controller, verify that you have not previously added it to the Global Controller. If you do encounter this error, restart the GUI by closing your web browser and logging in again.

CSCpn03074

Issue: On the Incidents page of a Global Controller, the View and Show buttons do not work for incidents pushed up from the monitored Local Controllers.

CSCpn03057

Issue: Copied rules have shortened year in front, which is confusing (e.g., 05.04.19) When you duplicate a system rule, the newly created rule has a timestamp appended to it. The date format is unclear, but it is YY.MM.DD.

CSCpn03052

Issue: JBoss 'OutOfMemoryError ' when accessing Management/Event Management tab.

Workaround: Avoid using the 10,000 items per page on the Event Management page.

CSCpn02976

Issue: GC:LC - Communication issues after time zone change. After initial configuration, if you change the timezone of a communication GC:LC, there may be problems with communications between the GC and LC.

Workaround: If you notice that the Local Controller appears offline, verify that at least 10 minutes have passed since the appliances rebooted. Alternatively, you can jump start the communication by navigating to Admin > Local Controller Management in the Global Controller user interface.

CSCpn02973

Issue: Not able to downgrade a Security Analyst to Notification only user. When you define a user account with the Security Analyst role, you cannot downgrade that role to Notification only.

CSCpn02968

Issue: Network group search is not working for "All IP addresses". If you select All IP addresses as the search space, the results may be inconsistent with the expected results.

CSCpn02901

Issue: GC/LC, rule does not display user <cxu> but allows such cfg

Workaround: Avoid using special characters in the keyword search for rules. The list of special characters not supported is as follows:

less-than (<) &lt;

greater than (>) &gt;

ampersand (&) &amp;

CSCpn02883

Issue: Event management search works only for event description. You cannot search on other fields, such as Event ID.

CSCpn02869

Issue: Rules editing: changing entry for select window drop-down list after error message results in the state not being saved.

Workaround: This issue appears when you have attempted to define an invalid rule and an error message appears. For example, while editing a user inspection rule"

1. Click Sources field.

2. Remove all sources.

3. Click Submit.

Result: Dialog box appears and prompts "please select one".

4. In the select window drop-down list, select "All Devices"

Result: Rule submission window appears and contains a blank Sources field.

To work around this issue, click one of the top tabs to cancel your work and redo your edit without submitting an invalid rule (as shown in Step 3).

CSCpn02804, CSCse33172

Issue: Replay History feature not working correctly.

Description: When you configure a query that triggers replay history, the results are usually incorrect. The following cases will trigger a replay history:

a multi-line query that uses AND or Followed By

a query that uses the $ variables, such as $EventType, $Device1, etc.

a query uses NOT EQUAL TO a service

If you define an invalid query, MARS returns a "TimeOut Error" message. You may also receive the error message "Invalid id used in DbClient::retrieve()," depending on the query.

Workaround: None.

CSCpn02688

Issue: Viewing a report on a Global Controller and viewing the corresponding report on the Local Controller may differ in time slightly.

CSCpn02666

Issue: The email sent when a batch query completes may not have data in the graph if the query only returns one result.

CSCpn02656

Issue: Leaving the browser on the Summary page for an extended period of time (several days) may occasionally run into an error.

Workaround: Refresh the page to return to the GUI.

CSCpn02653

Issue: No way to specify "!Keyword" without a good "keyword"

Workaround: Keyword search requires two keywords to use the "NOT" operator. For example, you cannot specify `NOT nimda'; instead, you must specify something like `virus NOT nimda'.

CSCpn02594

Issue: Clicking on the Path/Mitigate link in an incident that was fired from a device that has since been deleted may result in an error.

CSCpn02574

Issue: Having different times on the Global Controller and its associated Local Controllers may cause synchronization problems.

Workaround: Use the CLI to configure NTP or manually set the date and time to be the same on the Global Controller and Local Controllers.

CSCpn02566

Issue: Rebooting the MARS while the box is in the upgrading state may cause system configuration errors.

CSCpn02558

Issue: After adding and deleting an agent or sensor to a host, adding a sensor with the same name and type as the previously deleted one back to that host will not work.

Workaround: Use a different agent/sensor name the second time around.

CSCpn02549

Issue: When viewing report results, clicking on "Edit" or "Clear" in the query summary at the top of the page results in a JavaScript error.

Workaround: Click directly on the "Report type" link to edit the query.

CSCpn02511

Issue: In migrating "Microsoft, Windows, Generic" device type to three new Windows device types, errors in affected OS could affect data migration and cause confusion about appropriate selection.

Workaround: When migrating data, you should make the following mappings for the OS name:

Map "2000" to "Windows 2000"

Map "Windows 2000 Professional Server" to either "Windows 2000 Professional" or "Windows 2000 Server" after verifying the data.

Map "NT" to "Windows NT"

Map "Microsoft Windows NT 4.0" to "Windows NT". Microsoft should be in vendor field and 4.0 should be in version field.

CSCpn02470

Issue: Using passwords with the "," (comma) or "'" (quote) characters may cause problems with loading devices from csv files.

Workaround: Avoid using passwords with these characters for the time being.

CSCpn02414

Issue: Long keyword strings in rules or reports can cause parts of the GUI layout to be pushed out of the browser window's edges.

CSCpn02410

Issue: The MARS stores reported user names in a case-sensitive fashion. Devices that report case-insensitive user names can behave counter-intuitively if they report names inconsistently.

CSCpn02398

Issue: Reserved XML characters are not supported in the Keyword Search on the Rule page

Workaround: Avoid using special characters in the keyword search for rules. The list of special characters not supported is as follows:

less-than (<) &lt;

greater than (>) &gt;

ampersand (&) &amp;

CSCpn02385

Issue: Applying $VAR variables to queries on a Global Controller causes GUI errors and may not return correct results.

CSCpn02383

Issue: An IIS web server cannot be added to the MARS as a generic web server. When configuring the MARS to receive IIS logs, adding generic web server in Reporting Applications does not work.

Workaround: Choose windows operating system under general tab.

CSCpn02333

Issue: After performing a "pnreset -g" (which cleans up the GC data on the LC - a copy will be made of all GC data used by rules and reports while all other GC data will be deleted), the LC still shows the old zone name by which it was monitored from the GC. When adding that LC back to a GC that was re-installed from the recovery DVD, problems can occur if the zone names for the GC and LC do not match the ones used before.

Workaround: Use the same "old" GC name during the GC configuration. Use the same zone names when re-adding LCs to the GC.

CSCpn02251

Issue: After upgrading from a MARS 100e to MARS 100, pnstop and pnstart need to be run for the change to take effect.

CSCpn02177

Issue: Every 22nd reboot, the MARS file system is checked for consistency. This takes time to complete, and happens before connecting to the network. While this is happening, it may appear that the box simply isn't starting.

Workaround: Attach a console to the MARS to verify that checking is happening if the system does not seem to start after a reboot.

CSCpn02175

Issue: Data computed or stored on a standalone MARS while in standalone mode will not be transferred to a GC. Only data computed on an LC that is currently monitored by a GC will be pushed up.

CSCpn02073

Issue: After renaming a cloud, clicking the cloud again causes an error.

Workaround: Refresh the page before clicking a renamed cloud.

CSCpn02061

Issue: Saving CSV files from reports with IE 6 under Windows XP SP2 causes the file to default to an .htm extension, not .csv extension.

Workaround: Select "All types" from the drop-down list while saving, and rename the file to have a .csv extension.

CSCpn02011

Issue: Certain special characters do not work in password fields. The characters are " ' ; (double-quote, single-quote and semi-colon).

Workaround: Use passwords that do not contain these characters.

CSCpn01489

Issue: Query summary doesn't mention "severity" if it's a criterion

When the user configures a batch query with a severity as one of the criteria (Red, Yellow, Green), this criterion doesn't appear in the "query summary" of the batch query page. However, the query is run with the correct criteria. When the results are viewed, the severity can be seen in the query details at the top of the page.

CSCpn01438

Issue: When running batch queries under a high system load and over a time range containing a large amount of data, the batch query might not complete. If the Progress Completed status stays at 0% for an extended period of time (a day), try stopping any other batch queries you have running or stopping and resubmitting your batch query with narrower criteria. If neither of these works, please contact Cisco Support.

CSCpn01416

Issue: Select: Temp paging fix on Notification-SNMP. All pages that display large numbers of items need to have paging implemented.

Workaround: Use the search window to locate desired object.

CSCpn01398

Issue: Unable to shutdown an interface: the customer should be able to shutdown an interface on CLI or GUI.1.

Workaround: Do not connect the second network interface to your network.

CSCpn01382

Issue: When you create a new group (MANAGEMENT > IP Management > Add Group) with a combination of Networks, Devices, and IP addresses and then select that group from the pull-down menu, only the Networks in the group appear, even though the Devices and IP addresses are in the group.

CSCpn01319

Issue: The pnreset command indicates that system will reboot after execution, however the system does not reboot. Also, you may find that the cursor does not return from the command—it is locked in the status indication (a string of periods).

Workaround: Before running the pnreset command, you must disconnect the appliance from the network by unplugging the Ethernet cable from the appliance. Disconnecting it from the network ensures that the cursor will return from the command upon completion. In addition, you must manually reboot the appliance using the reboot command when the cursor returns from the pnreset command.

CSCpn01293

Issue: When administering MARS, it is possible to select an unsupported OS from the pull-down menu when adding or editing a host for logging. If you select an OS that does not contain the string "Microsoft Windows" or "Sun Solaris" when you save the Pull host log or Receive hostlog parameters, (for example, if you select "Sun Cobalt"), then the GUI does not work correctly.

CSCpn01270

Issue: The free-form search may not work for the following devices:

Check Point Opsec NG FP3

Cisco CSA, 4.0

Cisco, IDS, 3.1 and 4.0

ISS, RealSecure, 6.5 and 7.0

Entercept Entercept, 2.5 and 4.0

IntruVert IntruShield, 1.5

CSCpn01219

(re-opened)

Issue: If you create a user in the MARS GUI and select New Provider but do not enter a Pager number, qpage.com fails to run because it has an empty entry, and pnmonitor continually tries to restart the daemon that attempts to access qpage.com.

Resolution: Open each user profile and click Submit to ensure all the required fields are populated.

CSCpn01134

Issue: The cloud name input box accepts invalid characters. To reproduce this behavior, click on the Large Graph link on the Hotspot graph. Click on a cloud. Click Change name and enter invalid characters into the input field (for example, ~!# or ###). Sometimes the page returns an error message such as error: Error: Invalid or No Security Perimeter. The graph rendering fails with the IE status bar message "not well formed, line #:column#".

CSCpn01051

Issue: Logging into a MARS from a non-supported browser and leaving the GUI open will prevent other users from logging into that MARS.

Resolution: If you log in to MARS using a supported browser and see a message saying that your browser is unsupported, please check if another user has logged into the MARS with an unsupported browser and not closed his browser window.

CSCpn01045

Issue: Entering an incorrect IP address or directory path for the data archiving feature will result in a cryptic error message.

Resolution: If you see a message of type "Status: PN-0002: No message for PN-0216" after configuring data archiving, please click "Back to Archiving" and check your IP address and directory.

CSCpn00908

Issue: "Domain" in Configuration page - no use

Workaround: This issue was overcome by other events. This field no longer exists, however, you can specific the e-mail domain on the Configuration page to identify the default domain from which e-mail notifications are delivered by the appliance.

CSCpn00610

Issue: Backend logs can be out of order in the view page because the numbers are reused. Timestamps should be used as report identifiers.

CSCpn00596

Issue: On a freshly installed machine starting to get events and sessions, you can get a negative Data Reduction where there are more sessions than events. This is due to the fact that events are written to the database more frequently than sessions.

Resolution: Wait for some time to pass, as events gradually outnumber sessions this number will become increasingly accurate.

CSCpn00586

Issue: If you are investigating a false positive, and you see a message telling you that a service has crashed, this could be due to vulnerability scanning by the MARS appliance. You may have to re-start the service.

Resolution: It is strongly recommended that you patch the security hole to eliminate this vulnerability.

CSCpn00455

Issue: If clouds are renamed through diagrams, the system might not display those names.

Resolution: Here are some work around steps to rename clouds:

1. Click the cloud you want to rename.

2. Enter in the new name in the text field near the top of the popup window.

3. Click "Change".

4. Once it's done, click "Close".

5. Click the "Large Graph" button in the Hotspot Graph.

6. Return to the Summary page.

CSCpn00293

Issue: When tabbing over three-digit entries in IP fields on the Configuration Information page, the cursor can disappear.

Resolution: Use your mouse to move between fields on this screen when editing IP addresses.

CSCpn00259

Issue: On the Setting Runtime Logging Levels page, if you set the level for GUI to Trace and save, it is saved as Debug.

Resolution: Do not change settings on the Setting Runtime Logging Levels page without a Cisco Support representative.

CSCpn00247

Issue: The automatic time-out feature built into the GUI does not work when the Summary page is left open with automatic refresh selected.

Resolution: Please log out of the system when you are no longer using it.

CSCpn00212

Issue: Diagrams on the Summary pages occasionally do not display.

Resolution: Exit the browser. The next time you log on, the diagrams should have re-drawn.

CSCpn00183

Issue: Adding many devices (more than 20) without activating those devices can cause messy output in the diagrams.

Resolution: Click the Activate button after adding many devices.

CSCpn00173

Issue: Nessus should check pre-NAT address instead of Post-NAT address.

CSCpn00166

Issue: The use of ANY in queries and rules is slightly inconsistent. When selecting ANY in the Query page, if other items are selected at the same time for that field, the ANY is ignored. When selecting ANY on the Rules page, if other items are selected at the same time for that field, the other items are ignored and ANY is the selection.

CSCpn00146

Issue: Identical reports differed by slashes and dashes result in conflicting reports. When you have reports with identical names differing only by slashes (/) and dashes (-), running and viewing the reports causes them to get confused and point at the other.

Resolution: Do not use slashes or dashes in your rule configuration.


Resolved Caveats - Release 4.2.1

The following customer found or previously release noted caveats have been resolved in this release.

Reference Number
Description

CSCse54819

Need to add more annotations to notification schema file

CSCse53491

Anomaly detection: incident should fire but does not

CSCse52649

'pnrestore -m 5' fails to restore late night backup

CSCse52205

janus.conf not upgraded when restoring to an upgraded mars box

CSCse51404

Slow device loading causes processes to be restarted repeatedly

CSCse50303

pn_event_type_range initial value correction

CSCse48719

Pull out a disk. The disk error notification is not received by pnadmin

CSCse47753

Should display OS version and Patch

CSCse47646

JBoss installation allows remote command execution

CSCse47379

Batch query on GC returns no results

CSCse47111

Nowhere to input long description of an event_type_info

CSCse46123

Change made to DNS config from GUI doesn't take effect

CSCse45962

avoid pink-box on the GC Incident page when mapping info is missing

CSCse45895

Real-Time (raw events) blocks and fails to display new events

CSCse45886

postfire lagging behind writing incidents

CSCse45878

Missing 'ANY' option in the OS vendor drop down list

CSCse45846

postfire drops sub-incidents

CSCse45793

Potential for process_event and process_postfire to get out of sync

CSCse45789

Report Group : Batch query reports listed as System Reports.

CSCse44384

3ware controller write cache was turned off

CSCse43729

add desc to service TCP and UDP/5401: "CSA communication

CSCse43576

Case Management attach Networks Ranked by Session report get Pink Box

CSCse43291

Device name not updated in janus.conf on mars20r

CSCse39959

event ID 3002476 does not had a description associate to it

CSCse38778

Device Event Type Vendor Info has bad link for many Cisco devices

CSCse38776

Email of case with multiple 5K reports fails to be received

CSCse38668

System should allow deleting pn_config_sync_log with audit_log_id < 1000

CSCse36971

clicking the icon "q" on display will change the query to sessionized

CSCse36851

GC/LC: reported user became ANY after GC on demand report is pushed to LC

CSCse36639

Java Null pointer exception for LLRTRequest

CSCse35742

Real-Time (raw events) fails to display device name for dynamically created devices.

CSCse35313

DTM: Signature Inactivity Interval for deletion - NEVER option

CSCse34746

"Reported User" condition doesn't work in process_inlinerep_srv reports

CSCse34575

incidents fired by system are not pushed to the GC

CSCse34309

Real-Time (raw events): on Real-Time (raw events) scrolling page, change the default speed to fast mode

CSCse34146

Real-Time (raw events): on select query page, raw events option should be the first one

CSCse34138

Real-Time (raw events): on scrolling page, pause button should be at right side

CSCse33144

HTML Page is directed to null when adding a device with existing IP

CSCse31732

changing raw event query condition will change the query to sessionized

CSCse29259

javaDbImportExport is not consistent for class DbDeviceType

CSCse29185

pnparser crashes with 2k/s pix events when verifiying CSCsd67636

CSCse28847

windows pulling very slow if one server is down/unavailable

CSCse28774

New rule/report group data missing/incorrect on upgraded box

CSCse27195

pnrestore blocked

CSCse26385

popup unclosed after emailing case if attached records are more than 500

CSCse25614

Log Parser does not parse 609001 and 609002 correctly from ASA-PIX

CSCse24791

can't attach big query report from inline submit

CSCse23078

attached incident is lost after data is purged

CSCse23070

view report of query type of detailed NAC report got pink box

CSCse22827

CSM icon should not be displayed on events from unknown reporting devices

CSCse22614

QualysGuard case not handled in False Positive confirmation page

CSCse22578

attached incident info was lost after migration for the open cases

CSCse21965

XML incident notification doesn't include all matched rule offsets

CSCse21955

ACS RADIUS accounting messages get sessionized incorrectly

CSCse21950

Transfer bytes in incident archive files are zero

CSCse21845

Real-Time (raw events) Query: Blank src/dst IP/port columns

CSCse21559

"Reported User" condition doesn't take effect

CSCse21417

View report save from query(event Type ranking) wrong color of 1st rank

CSCse21340

Must update Help --> About --> Documentation URL for 4.2

CSCse20764

CSM: Policy query with test connect failure

CSCse20736

Restart of syslogd is needed on a linux box after configuring it

CSCse20702

Incorrect reporting device showing in the unknown events query

CSCse20691

CSM:Policy query icon

CSCse20493

Symantec AntiVirus Server config guide needs addition of controller's ip

CSCse20312

IDP-side Configuration missing controller's ip address

CSCse20242

mars not processing certain device (routerToLab) syslog messages

CSCse20041

CSM policy query icon for netflow events

CSCse20014

SigTool, EventTypes, going backwards in Add gets pink box

CSCse19472

pndbusage command accepts arguments without complaining

CSCse19392

CSM: Policy query for ICMP traffic

CSCse19203

process memory exceeded and pnesloader was killed on mars20r

CSCse18978

found extra line in updateAK xml file

CSCse18873

The detail report result didn't be added to a case

CSCse18851

pinkbox in case management after show all

CSCse18782

migration doesn't work at all

CSCse18240

DOC: cs-mars doesn't handle vpn paths

CSCse17939

ssh root login incorrectly allowed

CSCse17880

Incorrect service handling in low latency (real time) viewer

CSCse17864

Device info was lost after migration

CSCse17777

5K Query - Pink box in query for all matching sessions

CSCse17403

Configuration can persist on Community Strings and Networks page

CSCse17345

Pink box on GC when viewing devices by zone

CSCse17089

CS-MARS Installation Guide - VGA and Serial Ports swapped in diagram

CSCse16262

Improve msg displayed when click policy icon but CSM configured

CSCse16007

The output of pndbusage shows a wrong timestamp

CSCse15994

The '?' question mark did not trigger the command usage display

CSCse15303

pnarchiver - ORA-01455: converting column overflows integer datatype

CSCse15015

"Query on this ..." icon missing for event type in raw event query.

CSCse14666

Real-Time (raw events): Fails to display five tuple for IDS/IPS/IOSIPS events

CSCse14655

Real-Time (raw events) - displays Trigger packet/ Context Data/ IP Log in wrong format

CSCse14634

low latency real time viewer: alignment of src ip /port and dest ip / port

CSCse13971

Incident archived files could be lost in certain conditions

CSCse13922

Selecting "Raw Events" from RT pulldown erroneously disables widgets.

CSCse13904

low latency real time viewer: restart won't start from now (current time)

CSCse13359

archiver failing to archive report results data

CSCse12452

Mars - legend on graph is off by one color with full size graphs

CSCse11036

Oracle event/session partition purging is incorrect

CSCse10933

Sigtool create report: Filter does not show report created.

CSCse07865

DOC: can't do keyword searches on pix url logs

CSCse07579

Sigtool Vulnerability Add: Cannot perform add.

CSCse07405

Protocol name should match the types we support

CSCse06197

Sigtool System Setup: Default IP address incorrect.

CSCse06051

Null Pointer Exception on Low latency real time viewer when backend ...

CSCse04786

"Realtime viewer temporarily unavailable" Error popup

CSCse04705

pnrestore cannot restore os from other models to MARS20 model

CSCse03448

CS-Mars - special characters not supported in activation key field

CSCse03254

Inconsistent population of CSM icon for ICMP messages

CSCse01818

low latency real time viewer doesn't display all of events

CSCsd96095

Sigtool Event Type Group Add: Leading/Trailing spaces in event group.

CSCsd96070

Case mgmt emails with multiple 5k reports aren't useable

CSCsd96033

Sigtool Event Group Delete: Problem if event not selected.

CSCsd92161

Customer gets pink box in UserConfirmedFalsePositivePage.jsp

CSCsd88081

Customer pink box at URL /Admin/Devices/SubmitDevicePage.jsp

CSCsd87778

[CSIRT] Incidents should link to device name instead of IP in GC

CSCsd86925

Top N signatures are not updated on DTM

CSCsd86719

Raw event query type changed to sessionized after condition is set

CSCsd86706

"Raw Events" displayed when other filter is selected

CSCsd83991

CS-MARS/CSM: Lookup of denial event found different ACL

CSCsd83692

CS-MARS/CSM: Credentials change for CSM not checked.

CSCsd83688

CS-MARS/CSM: Credentials: password change not checked.

CSCsd81330

Processing VPN events before pix events caused unknown event type for pix

CSCsd80458

Error in PnParsedEvent serialization could cause event data corruption

CSCsd79114

Small number of Raw Events are not displayed in real time

CSCsd79072

"Raw Events" selection missing when query is modified again

CSCsd79063

Deleting reports without activating causes inlinerep_srv to stop working

CSCsd78717

Cannot add an IDSM with same reporting IP as switch to a Switch device

CSCsd77422

Sigtool Pattern add: In edit mode if pattern is selected.

CSCsd77402

Sigtool Pattern add: Return from add after problem occurs.

CSCsd77398

Sigtool Pattern add: Save with empty value pattern.

CSCsd76965

Sigtool Appl add: Appl texts disappeared after modifying dev os.

CSCsd76960

Sigtool Appl add: Can't delete device os.

CSCsd76957

Sigtool Appl add: Leading/trailing spaces in Device OS Name.

CSCsd76956

Sigtool Appl add: Device OS "Name" accepts blank input.

CSCsd76932

Sigtool Appl add: Should label mandatory device os vendor field.

CSCsd76007

Device doesn't update its Device type list after new Application add on

CSCsd75950

Sigtool Delete Service Group: Problem after service group deletion.

CSCsd72868

Sigtool Add Event Type Group: spaces in event group type name

CSCsd72169

DOC - LC 4.1 logging emblem instructions are confusing

CSCsd72022

network didn't been added into group

CSCsd71954

Sigtool Add Event Type Group: Problem from empty event type description

CSCsd71897

Sigtool Event Filter by Sev: Sev text missing in Event Types display.

CSCsd71818

Sigtool Event Type Edit: Should prompt duplicate event type name

CSCsd71817

Sigtool Event Type Create: Abbreviations in event map

CSCsd71815

Sigtool Event Type Create: Name mismatch (Event Type vs Event ID)

CSCsd71809

Sigtool Event Type Create: Should prompt duplicate event type name

CSCsd71805

Sigtool Event Type Create: Missing mandatory info should trigger message

CSCsd71794

Sigtool Event Type Create: Cancel button refinement

CSCsd71787

Sigtool Event Type Create: Model/Version choices initially not available

CSCsd70108

Sigtool edit device type: No message when device type can't be saved

CSCsd70087

Sigtool add device type: No message when missing information.

CSCsd70042

Sigtool add device type: No message for device types that can't be added

CSCsd70000

Sigtool device type delete: No message for device that can't be deleted.

CSCsd68896

Sigtool view report group: System Reports emptied after group access.

CSCsd68810

File permissions on two files incorrect

CSCsd67636

pnparser cpu goes 99% in sessionization for traffic of 1 k/sec

CSCsd67492

Sigtool delete rule: "Delete" button is not present.

CSCsd67474

Sigtool rule edit: Edited rule should be saved.

CSCsd65943

process_inlinerep_srv goes to 99% CPU

CSCsd64438

pnparser crashed at 2.5k/s for relayed syslog and stops receiving events

CSCsd63437

Many "false alarm" errors in Rule/Report import into CS-MARS

CSCsd62251

Incorrect parsing for all Windows MSSQL event pushing

CSCsd60252

MS SQL error 18453 should be in "Trust" group

CSCsd59102

rpcclient2 is incorrect in the current CD packages

CSCsd59044

Error in 4.2.1 db schema script

CSCsd54625

SigTool: Editing Event Type doesn't save changes

CSCsd54620

SigTool: Can't delete report

CSCsd54614

SigTool: services don't appear in service group selection window

CSCsd54597

SigTool: System Error when creating new Vulnerability

CSCsd54541

SigTool: Can't create Application

CSCsd54144

A closed case can be re-open.

CSCsd53037

Customer feedback reports pink box adding a user

CSCsd51554

pink box on GC local controller management page

CSCsd49703

Popup a window with all of device names when discovering an IOS device

CSCsd48577

graphgen cannot be started on some MARS boxes

CSCsd48460

TopN: pull interval and URL cannot be retrieved from DB

CSCsd48097

Processes restart continuously if pnparser creates shared buffers first

CSCsd47251

extra space in the name of "DTM_TOPN_SIG_ ACTION" in pn_sys_param table

CSCsd46831

CS-Mars - need to specify exact version support for Check Point firewall

CSCsd35354

Anomaly Profiling does not include denies and other non-pix flow events

CSCsd35158

Should not send feedback to protego-feedback.

CSCsd33735

MARS need remove quotation marks from the ACL name passed to CSM

CSCsd31984

Dam account has default password

CSCsd31972

CS-MARS CLI Privilege Escalation

CSCsd31202

mars internal protocol numbers

CSCsd29152

Password found in shell script

CSCsd28493

View Case document selection doesn't work after e-mail report results

CSCsd28491

View Case document selection doesn't work after e-mail query reports

CSCsd28487

View Case document selection doesn't work after e-mail device info

CSCsd28482

View Case document selection doesn't work after e-mail sessions

CSCsd28393

View Case Document selection doesn't work after e-mail incidents

CSCsd28307

attached incident doesn't be shown in the first e-mail

CSCsd28246

There are two users as pnadmin in "Admin" user group

CSCsd28200

"select All" button doesn't work as expected

CSCsd28192

can't keep selected user group(s), or users

CSCsd27874

e-mail to pnadmin twice if selecting "Admin" user group

CSCsd26018

PnParser uses more than High CPU doing sessionization from FWSM events

CSCsd25395

Fix GUI errors caused by 0 id in report database tables

CSCsd25151

adding indexes to optimize DbClient::retrieveParserDeviceInfo()

CSCsd25144

Need to add CPU check for pnesloader ann mem check for graphgen

CSCsd25027

device list page got pink box when there is no device agent exists

CSCsd24864

GUI Devices add/edit SW Vuln. Assessment Info does not show device name

CSCsd23721

FWSM events parsing error

CSCsd22430

CSM integration: interface name not parse correctly for FWSM events

CSCsd22299

Got "parsing error" in the syslog-ng relayed solaris syslogs

CSCsd20988

An invalid session can be added to the current active case

CSCsd20976

An invalid incident can be added to the current active case

CSCsd20967

The pink box is shown when adding an invalid case

CSCsd15308

ICMP Type not parsed for event PIX-n-106100

CSCsd14963

switch.csv doesn't work

CSCsd13966

case history is located among the attachments, not the last one

CSCsd10764

It's meaningless to attach a session twice or more through gui

CSCsd10754

It's meaningless to attach an incident twice or more though gui

CSCsd10718

It's meaningless to allow attaching a device twice or more through gui

CSCsd09771

A report can be added by not clicking "Add This Report

CSCsd09761

A session can be added by not clicking "Add This Session

CSCsd09745

the changed e-mail subject is back to default value after changing filter

CSCsd09739

Adding device info can't be done if click "more" then "submit

CSCsd09722

Device Info is added by not clicking "Add Device Info

CSCsd09705

Adding an Incident can be done by not clicking "Add This Incident

CSCsd09693

Reference case can't be done right way if I click "more" then "submit

CSCsd09662

Reference case can be done by not clicking "Reference This Case

CSCsd08503

Report - Not Healthy - All Events missing from NAC group

CSCsd00682

MARS needs to handle null value returned from CSM DeviceQuery

CSCsc95485

QualysGuard support: need to add missing part in postfire

CSCsc94043

Include time attribute and value in raw message from IDS/IPS/IOSIPS

CSCsc89884

MARS does not pull log from a windows box if both pull/push are checked

CSCsc87879

CS-MARS - SDEE subscriptions are dropped

CSCsc80185

Unknown Events seen by MARS from PIX and FWSM

CSCsc79646

make GC "Security and Monitor Device" page more robust

CSCsc67926

CSM response parsing error

CSCsc67806

DTM: csdam process syslog sending leaves hanging resources

CSCsc66154

GC rule incidents aren't pushed up after modifying the rule on the LC

CSCsc65845

XML Notification with Incident details

CSCsc59395

ASA parsing gives wrong event types for a few event types

CSCsc57192

Unable to add inline reports to a case

CSCsc54966

fqdn not displayed for some devices on security and monitoring info page

CSCsc50791

MARS needs to provide CSM the interface names for policy query

CSCsc50789

Add Reporting IP to auto discovered devices.

CSCsc50787

MARS needs to provide CSM the ICMP code as part of the policy query

CSCsc50187

Policy display doesn't handle white-spaces in object names properly

CSCsc50175

Some FW inspect syslog messages are not parsed by CS-MARS

CSCsc47258

Need an alert to CS-MARS when current partition is getting full

CSCsc46900

enhance fixed (24 hr) stat values in Summary page to menu

CSCsc46892

a special report for NAC

CSCsc40930

XML parsing for IOS-IPS doesn't include changes/ fixes for IPS 5.x

CSCsc40721

There are several unfunctional buttons in E-mail for Case Mgnt

CSCsc36969

MARS needs to provide CSM 'Action' information from the syslog message

CSCsc36957

MARS needs to provide CSM ACL Name from the syslog message

CSCsc35671

windows pulling could get stuck and block pulling for all other machines

CSCsc34091

Unparsed FWSM 2.3 log messages

CSCsc33942

create alert on dropped event threshold

CSCsc31561

Test connectivity on IOS IPS leads to name change for parent IOS

CSCsc31386

Uninitialized agent_id for unknown reporting device sending netflow

CSCsc30816

NO CSM Access Rule Lookup ICON on the raw message query page

CSCsc30044

Symantec AV Dynamic Agent Creation

CSCsc30033

Windows Application Log Pulling

CSCsc27856

FR - CS-Mars - multiple email addresses for email case button

CSCsc25189

CSM Integration task: paging support for the MARS Policy Query UI

CSCsc24704

Error occurred while querying policies from CSM for ICMP events

CSCsc23631

Scheduled reports with only a != don't work

CSCsc22088

syslog ID 109023 - User must authenticate first - not recognized by MARS

CSCsc22055

syslog ID 313004 - Denied ICMP - not recognized by MARS

CSCsc21724

MARS needs to get SDEE errors in addition to alerts

CSCsc20839

Syslog Relay (Proxy) support in MARS

CSCsc20831

DTM: Current Top N signature pull from CCO

CSCsc20816

IIS Site Protector support

CSCsc08886

Nice to allow user to remove things from Case Management cases

CSCsc07741

If Viewing closed Case, then do refresh, get an email sent

CSCsc07680

CS-Mars - Default Oracle passwords created for SYS and SYSTEM users

CSCsc06218

802.1x GUI host info incorrect

CSCsc06086

Policy Tag from CheckPoint Logs need to be in Raw Message

CSCsc05980

There is a system error when viewing purged data

CSCsc05948

There is a system error when viewing the cases that have data purged

CSCsc05908

The data is lost which is attached in the closed case

CSCsc04637

Closing a Case does not deselect it

CSCsc03230

Not all of query results were added in the case document

CSCsb97824

Seed File load need to support IDS/IPS device type

CSCsb88410

IP to value needs to assign same time value for ACS entries

CSCsb87935

keyword search doesn't work in reports that run in process_inlinerep_srv

CSCsb71298

GC queries less than 10 minutes are always In Progress

CSCsb70130

IDS context information should be displayed after decoding

CSCsb70121

IDS alert vlan id, action information should be in raw message

CSCsb52032

Improved handling of purged data attached to cases

CSCsb23722

Test connectivity failed for a qualys guard device

CSCpn03046

oracle pulling timer modification does not take effect

CSCpn03044

Parser need to ignore the sev number X in PIX_X_YYYYY syslog

CSCpn03041

PIX7.0, parsing error %PIX-4-411001/411002

CSCpn03019

Load Security Device from CSV has invalid device name

CSCpn02623

sudden traffic increase does not process ICMP events

CSCpn02587

CSV for different type of windows

CSCpn02322

Device type / version change for at least a selected set of device(s)

CSCpn00066

New Version of devices


Resolved Caveats - Releases Prior to 4.2.1

For the list of caveats resolved in releases prior to this one, see the following documents:

http://www.cisco.com/en/US/products/ps6241/prod_release_notes_list.html

Product Documentation

For the complete list of documents supporting this release, see the release-specific document roadmap:

Cisco Secure MARS Documentation Guide and Warranty

http://www.cisco.com/en/US/products/ps6241/products_documentation_roadmaps_list.html

Lists document set that supports the MARS release and summarizes contents of each document.

For general product information, see:

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

Obtaining Documentation, Obtaining Support, and Security Guidelines

For information on obtaining documentation, obtaining support, providing documentation feedback, security guidelines, and also recommended aliases and general Cisco documents, 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