Guest

Cisco NAC Appliance (Clean Access)

Release Notes for Cisco NAC Appliance, Version 4.8(3)

  • Viewing Options

  • PDF (926.2 KB)
  • Feedback
Release Notes for Cisco NAC Appliance, Version 4.8(3)

Table Of Contents

Release Notes for Cisco NAC Appliance,
Version 4.8(3)

Contents

Cisco NAC Appliance Releases

System and Hardware Requirements

Licensing

Hardware Support

Release 4.8(3) and Hardware Platform Support

Cisco NAC Network Module

Release 4.8(3) and Cisco NAC Profiler

Configuring AD SSO

FIPS 140-2 Compliance

Supported Switches for Cisco NAC Appliance

VPN and Wireless Components Supported for Single Sign-On (SSO)

Additional Support Information

Software Compatibility

Release 4.8(3) CAM/CAS Upgrade Compatibility Matrix

Release 4.8(3) CAM/CAS/Agent Compatibility Matrix

Release 4.8(3) Agent Upgrade Compatibility Matrix

Determining the Software Version

New and Changed Information

Enhancements in Release 4.8(3)

Unmanage All Option for Switches

Cisco NAC Windows Agent Version 4.8.3.9

Support for Windows 8

Support for Internet Explorer 10

Mac OS X Agent Version 4.8.3.594

Support for iOS 6

Cisco NAC Web Agent Version 4.8.3.1

Support for Internet Explorer 10 on Windows 7

Support for Microsoft Active Directory

Features Optimized/Removed in Release 4.8(3)

Supported AV/AS Product List Enhancements (Windows Version 91, Mac OS X Version 14)

Cisco NAC Appliance Supported AV/AS Products

Caveats

Open Caveats - Release 4.8(3)

Resolved Caveats - Release 4.8(3)

Resolved Caveats - Cisco NAC Agent Vers 4.8.3.9/Mac OS X Vers 4.8.3.594

New Installation of Release 4.8(3)

Upgrading to Release 4.8(3)

Paths for Upgrading to Release 4.8(3)

Migrating from Customer-Supplied Hardware to Release 4.8(3) on a NAC-3310/3350/3390 Platform

Upgrading an Existing NAC-3310/3350/3390 Platform to Release 4.8(3)

Migrating from a NAC-3310/3350/3390 Platform to Release 4.8(3) on a NAC-3315/3355/3395 Platform

Changes for 4.8(3) Upgrade

Hardware Considerations

Upgrade Changes

Features That May Change With Upgrade

Password Changes

General Preparation for Upgrade

Upgrade Instructions for Standalone Machines

Summary of Steps for Standalone Upgrade

Create CAM DB Backup Snapshot

Download the Upgrade File

Copy the Upgrade File to the CAS/CAM

Run the Upgrade Script on a Release 4.7(x) or 4.8(x) CAM/CAS

Run the Upgrade Script on a Release 4.6(1) CAM/CAS

Upgrade Instructions for HA Pairs

Release 4.8(3) Upgrade Instructions for HA Pairs

Known Issues for Cisco NAC Appliance

Known Issue with CAS-to-CAM Certificate Verification in Internet Explorer

Known Issue with Delayed IP Address Refresh for Windows 7/Vista Clients Running Cisco NAC Agent

Known Issue with Enabling Web Login for Windows 7 Starter Edition Clients

Known Issue with Mass DHCP Address Deletion

Known Issue for VPN SSO Following Upgrade to Release 4.5 and Later

Known Issues with Web Upgrade in Release 4.1(3), 4.1(6), and 4.1(8)

Known Issue with Active HA CAM Web Console Following Failover

Known Issue with Cisco NAC Appliance CAM/CAS Boot Settings

Known Issue with IP Packet Fragmentation Leading to Disconnect Between CAS and Agent

Known Issues with Switches

Known Issues with Cisco 2200/4400 Wireless LAN Controllers (Airespace WLCs)

Known Issue for Windows Vista and IP Refresh/Renew

Known Issue While Upgrading to NAC Appliance Release 4.8(3)

Known Issue with System Center Endpoint Protection

Troubleshooting

Disabling Administrator Prompt for Certificate on IE 8 and 9

Enabling TLSv1 on Internet Explorer Version 6

Windows Vista and Windows 7—IE 7 and IE 8 Certificate Revocation List

HA Active-Active Situation Due to Expired SSL Certificates

Agent AV/AS Rule Troubleshooting

Debug Logging for Cisco NAC Appliance Agents

Generate Cisco NAC Agent Debug Logs

Cisco NAC Web Agent Logs

Generate Mac OS X Agent Debug Log

Creating CAM/CAS Support Logs

Recovering Root Password for CAM/CAS

Troubleshooting SNMP Issues

Troubleshooting CAM/CAS Certificate Issues

Troubleshooting Switch Support Issues

Other Troubleshooting Information

Documentation Updates

Related Documentation

Obtaining Documentation and Submitting a Service Request


Release Notes for Cisco NAC Appliance,
Version 4.8(3)


Document Number OL-26233-01 Revised: July 30, 2013

Contents

These release notes provide the latest cumulative release information for Cisco® NAC Appliance, Release 4.8(3). This document describes new features, changes to existing features, limitations and restrictions ("caveats"), upgrade instructions, and related information. These release notes supplement the Cisco NAC Appliance documentation included with the distribution. Read these release notes carefully and refer to the upgrade instructions prior to installing the software.

Cisco NAC Appliance Releases

System and Hardware Requirements

Software Compatibility

New and Changed Information

Cisco NAC Appliance Supported AV/AS Products

Caveats

New Installation of Release 4.8(3)

Upgrading to Release 4.8(3)

Known Issues for Cisco NAC Appliance

Troubleshooting

Documentation Updates

Obtaining Documentation and Submitting a Service Request

Cisco NAC Appliance Releases

Cisco NAC Appliance Version
Availability

4.8(3) ED

January 18, 2012

4.8(2) ED

May 3, 2011

4.8(1) ED

January 31, 2011

4.8 ED

July 26, 2010



Note Cisco recommends you deploy Cisco NAC Appliance Release 4.8(3) in test network before deploying in a production network.


System and Hardware Requirements

This section describes the following:

Licensing

Hardware Support

Supported Switches for Cisco NAC Appliance

VPN and Wireless Components Supported for Single Sign-On (SSO)

Additional Support Information

Licensing

You must obtain and install Cisco NAC Appliance product licenses for the Clean Access Manager (CAM) and Clean Access Server (CAS) in order for your deployment to function. Install the CAM product license in the CAM License Form to initially access the CAM web admin console. Once you can access the CAM web console, upload the additional CAM HA license or CAS license(s) into the CAM (under Administration > CCA Manager > Licensing) in order to add CASs to the CAM. An OOB CAS license must be present to access the "OOB Management" module of the CAM. The Licensing page displays the types of licenses present after they are added.

Note that both CAM and CAS product licenses are generated based on the eth0 MAC address of the CAM. For High Availability (HA) pairs, you must generate an additional CAM HA license based on the eth0 MAC addresses of both Primary and Secondary CAMs and install it on the CAM whether you are adding a CAM HA pair or CAS HA pair.

For complete details on service contract support, obtaining new and evaluation licenses, legacy licenses and RMA, refer to Cisco NAC Appliance Service Contract / Licensing Support.

Hardware Support

This section contains the following topics:

Release 4.8(3) and Hardware Platform Support

Release 4.8(3) and Cisco NAC Profiler

Supported Switches for Cisco NAC Appliance

Release 4.8(3) and Hardware Platform Support

FIPS Compliant

You can install or upgrade to Cisco NAC Appliance Release 4.8(3) on the following FIPS-compliant Cisco NAC Appliance platforms:

NAC-3315, NAC-3355, and NAC-3395


Note Release 4.8 and 4.7(0) are the only certified FIPS-compliant Cisco NAC Appliance releases.


Non-FIPS

You can install or upgrade to Cisco NAC Appliance Release 4.8(3) on the following Cisco NAC Appliance platforms:

NAC-3315, NAC-3355, and NAC-3395

NAC-3310, NAC-3350, NAC-3390


Note NAC-3310, NAC-3350, and NAC-3390 can be made FIPS-compliant by installing a field-replaceable FIPS card as described in the Cisco NAC Appliance FIPS Card Field-Replaceable Unit Installation Guide.



Note Next generation Cisco NAC Appliance platforms (FIPS or non-FIPS Cisco NAC-3315, NAC-3355, NAC-3395) support fresh installation of Release 4.8(3) or upgrade from Release 4.7(x), or 4.8(x) to Release 4.8(3) only.

If the FIPS card in a CAM/CAS ceases to work correctly, make sure the card operation switch is set to "O" (for operational mode), as described in FIPS and SSH. If the card is still not operational, you will need to RMA the appliance with Cisco Systems and replace it with a new Cisco NAC-3315/3355/3395 platform. Refer to the "Cisco NAC Appliance RMA and Licensing" section of Cisco NAC Appliance Service Contract/Licensing Support for details.


NME-NAC-K9

See Cisco NAC Network Module

Additionally, Cisco NAC Appliance Release 4.8(3) provides substantial changes and enhancements for product hardware support, installation, and upgrade:

A single product installation CD (.ISO) provides the option to perform CD installation on all supported appliance platforms. The installation package detects whether a CAS, CAM or SuperCAM was previously installed along with the software version.

To upgrade your CAM and CAS from Release 4.6(1), or 4.7(x), insert the same Cisco NAC Appliance Release 4.8(3) installation CD-ROM (.ISO) into an existing Cisco NAC Appliance CAM or CAS and perform a "clean" or "graceful" shutdown and reboot for the system. The upgrade option from the CD-ROM automatically prompts you to choose whether you want to do a fresh Install or Upgrade to Release 4.8(3). For more information, see Upgrading to Release 4.8(3) and Known Issues with Web Upgrade in Release 4.1(3), 4.1(6), and 4.1(8).

The installation/upgrade CD does not execute if attempting to launch it on a non-supported platform. Refer to Changes for 4.8(3) Upgrade for additional details.

Legacy customers on non-appliance platforms who wish to upgrade to Release 4.8(3) need to purchase a supported platform to install the Release 4.8(3) software. Refer to Migrating from Customer-Supplied Hardware to Release 4.8(3) on a NAC-3310/3350/3390 Platform for additional details.

See also Features Optimized/Removed in Release 4.8(3) for additional information.


Note You must run the same software version on all CAM/CAS appliances in your network.


Cisco NAC Network Module

The Cisco NAC Network Module for Integrated Services Routers (NME-NAC-K9) is a next generation service module for the Cisco 2811, 2821, 2851, 3825, and 3845 Integrated Services Routers (ISRs) that is supported starting from Cisco NAC Appliance, Release 4.1(2) and later.

In addition to the Cisco 2811, 2821, 2851, 3825, and 3845 Integrated Services Routers (ISRs), Cisco NAC Appliance Release 4.8(3) supports Cisco 2911, 2921, 2951, 3925, and 3945 Integrated Services Routers (ISRs).

The Cisco NAC network module has the same software features as the Clean Access Server on a NAC-3300 series appliance, with the exception of high availability. NME-NAC-K9 does not support failover from one module to another.


Note NME-NAC-K9 supports fresh installation of Cisco NAC Appliance Release 4.8(3) or upgrade from Release 4.6(1) or 4.8(x) to Release 4.8(3) only.



Note Cisco NAC Network Module does not support Wireless Out-of-Band (OOB). The Wireless OOB feature introduced in Release 4.5 only supports Layer 2 OOB Virtual Gateway deployments that require no IP change. The NAC Network Module does not support this topology.

Cisco NAC Network Module supports L3 Wireless Out-of-Band (L3 OOB) introduced in Release 4.8(2)


For further details, including software installation instructions, refer to Getting Started with Cisco NAC Network Modules in Cisco Access Routers.


Note You must run the same software version (e.g. 4.8(3)) on all CAM/CAS appliances and CAS network modules in your network.


Release 4.8(3) and Cisco NAC Profiler

All Cisco NAC Appliance releases are shipped with a default version of the Cisco NAC Profiler Collector component. Cisco NAC Appliance 4.8(3) release is shipped with Collector version 3.1.0.24 by default. When upgrading the NAC Server to a newer Cisco NAC Appliance release, the current version of the Collector is replaced with the default version of the Collector shipped with the Cisco NAC Appliance release. For example, if you are running Release 4.8 and Collector 3.1.1, and you upgrade to NAC 4.8(3), the Collector version gets downgraded to 3.1.0.24. You need to manually upgrade the 3.1.0.24 Collector to 3.1.1 again and configure it after the NAC Server upgrade.

Refer to the Release Notes for Cisco NAC Profiler for software compatibility matrixes and additional upgrade and product information.


Note Cisco NAC Profiler and Cisco NAC Guest Server are not supported in FIPS-compliant deployments in Release 4.7(0) and Release 4.8.


Configuring AD SSO

If there are multiple AD domain controllers and the CAM/CAS are upgraded to the release(not fresh install), perform the following on the CAM.


Step 1 Navigate to /perfigo/control/bin/starttomcat.

Step 2 Search for CATALINA_OPTS.

Step 3 Add -DRMI_READ_TIME_OUT=180000 at the end of CATALINA_OPTS.


Note The above resets the parameter to 3 minutes. This parameter is dependent on the number of domain controllers.


Step 4 Restart the CAM by entering the service perfigo stop and service perfigo start commands.



Note If you are applying this change to an existing HA pair, you must perform the above update on both the HA-Primary and HA-Secondary CAM just as you would upgrade a pair of HA-enabled CAMs.


FIPS 140-2 Compliance


Note Release 4.8 and 4.7(0) are the only certified FIPS-compliant Cisco NAC Appliance releases.


This section describes the following topics:

Overview

Capabilities, Dependencies, and Restrictions

FIPS Compliance in HA Deployments

Trusted Certificates and Private Key Management with FIPS

FIPS and SSH

FIPS and the Cisco NAC Appliance SWISS Protocol

IPSec Considerations with FIPS

FIPS and SNMP Configuration

FIPS and Cisco Secure ACS as RADIUS Authentication Provider

FIPS with VPN SSO

FIPS with AD SSO

Overview

Cisco NAC Appliance Release 4.7(0) introduced Federal Information Processing Standard (FIPS) 140-2 Common Criteria EAL2 compliance for new installations on new Cisco NAC-3315, NAC-3355, and NAC-3395 hardware appliance platforms. Release 4.8 now also offers a field-replaceable FIPS card upgrade for Cisco NAC-3310, NAC-3350, and NAC-3390 platforms. In order to provide FIPS compliance in your Cisco NAC Appliance network, both CAM(s) and CAS(s) must be FIPS compliant.


Note Cisco NAC Profiler and Cisco NAC Guest Server are not supported in FIPS-compliant deployments in Release 4.8 and Release 4.7(0).


To enable FIPS 140-2 compliance in Cisco NAC Appliance, CAMs and CASs must have an encryption card that handles the primary FIPS "level 2" compliance functions and manages private keys for the system.

In Release 4.8 and 4.7(0), if the FIPS card in a Cisco NAC-3315/3355/3395 CAM/CAS ceases to work correctly, make sure the card operation switch is set to "O" (for operational mode), as described in FIPS and SSH. If the card is still not operational, you will need to RMA the appliance with Cisco Systems and replace it with a new Cisco NAC-3315/3355/3395 platform. Refer to the "Cisco NAC Appliance RMA and Licensing" section of Cisco NAC Appliance Service Contract/Licensing Support for details. When you configure the replacement appliance, you must also ensure you configure it with the same master password and have imported any required third-party certificates before connecting the appliance to the network. For more information, see Release 4.8(3) and Hardware Platform Support.


Note Once the FIPS card is Operational on the CAM/CAS, the position of the electromagnetic switch ("O," "M," or "I") on the FIPS card does not impact the performance of the card again until you reboot either the FIPS card or the appliance.


In addition, in order to ensure FIPS compliance across the entire Cisco NAC Appliance network, users must use the latest Cisco NAC Agent version 4.8.0.35 or 4.7.1.15 on client machines connecting to the Cisco NAC Appliance network. Although Cisco NAC Appliance Releases 4.8 and 4.7(0) support other Cisco NAC Appliance Agent versions, users logging in with a different version of the Agent are not FIPS compliant. For more information on the latest Cisco NAC Agent, see Cisco NAC Windows Agent Version 4.8.3.9.


Note Cisco NAC Appliance network administrators managing the CAM/CAS via web console and client machine browsers accessing a FIPS-compliant Cisco NAC Appliance Releases 4.8 and 4.7(0) network require TLSv1 in order to "talk" to the network, which is disabled by default in Microsoft Internet Explorer Version 6. This option is enabled by default in Microsoft Internet Explorer versions 7 and 8 and Mozilla Firefox has not shown this limitation. For details, see Disabling Administrator Prompt for Certificate on IE 8 and 9.


Capabilities, Dependencies, and Restrictions

FIPS 140-2 compliance in Release 4.7(0) introduced the following capabilities, dependencies, and restrictions:

1. Key management in Release 4.7(0) and Release 4.8 is different than in non-FIPS Releases. Both CAM and CAS store their private keys in the FIPS card. This private key is used for all Cisco NAC Appliance PKI-based security solutions (i.e. SSL, SSH, and IPSec). In addition, both the CAM and CAS store a master secret in the card. The master secret is used to secure important data, (like other system passwords) stored in the database or on file systems. For more information, see Trusted Certificates and Private Key Management with FIPS.

2. JSSE (the equivalent of OpenSSL in Java) is used:

a. On the CAM and CAS during JMX publishing

b. On the CAS to send HTTP requests to the CAM when users are logging in

c. On the CAM when using LDAP over SSL for authentication/lookup providers


Note JSSE uses the FIPS card for SSL handshakes and data security.


3. APACHE/MOD_SSL handles HTTP/HTTPS requests from:

a. User client machines to the CAS

b. Administrators when using both the CAM and CAS web consoles

c. The CAS to the CAM when users are logging in


Note MOD_SSL uses the FIPS card during SSL handshakes only. That is, data security is performed outside of the card.


4. IPSec secures:

a. CAM and CAS HA configurations

b. RADIUS authentication calls

c. VPN establishment and maintenance tasks


Note IPSec uses the FIPS card for handshakes only. That is, data security is performed outside of the card.


For more information, see IPSec Considerations with FIPS.

5. SSH—Just like APACHE and IPSec, SSH uses the FIPS card during SSL handshakes only. For more information, see FIPS and SSH.


Note When a FIPS card goes down, existing SSH web sessions still work; however, you cannot initiate any new sessions. You are also unable to initiate new SSH sessions if the FIPS card goes into error mode and/or has been erroneously left in Initialization state. In this case, the CAM/CAS console port is the only access method.


6. JGSS—JGSS is used for Kerberos and ADSSO. JGSS uses the FIPS card for securing data.

7. SNMP V3—SNMP V3 uses the FIPS card for securing data. For more information, see FIPS and SNMP Configuration.

8. SWISS—SWISS uses the FIPS card for securing data. For more information, see FIPS and the Cisco NAC Appliance SWISS Protocol.

9. Cisco WLCs support RADIUS accounting over IPSec using pre-shared-keys (which are not FIPS compliant) for IKE authentication, and do not support Certificate-based IKE authentication (which is FIPS compliant).

10. When AD SSO is configured in the network, Windows XP client machines are not FIPS 140-2 compliant due to XP limitations. You cannot use AES for XP Kerberos, and 3DES encryption is not supported on Windows XP client machines.


Note Windows 2008 Server and the Windows Vista or Windows 7 operating systems are required to support AD SS0 in a FIPS-compliant Cisco NAC Appliance deployment.


11. LDAP—You must use Windows 2008 when performing LDAP lookups using GSSAPI in a FIPS 140-2 compliant deployment.

12. NTP server authentication—The CAM and CAS both use MD5 authentication to verify and authenticate Network Time Protocol (NTP) servers in Cisco NAC Appliance Release 4.8. MD5 is not a FIPS 140-2 compliant protocol, therefore you must disable the NTP authentication feature in Cisco NAC Appliance to ensure your network remains FIPS compliant.

FIPS Compliance in HA Deployments

To support FIPS 140-2 compliance, HA CAMs/CASs automatically establish an IPSec tunnel to ensure all communications between the HA pair appliances remains secure across the network.

Trusted Certificates and Private Key Management with FIPS

In Cisco NAC Appliance Release 4.7(0) and Release 4.8, you can no longer export private keys and you cannot generate CSRs using a FIPS compliant CAM/CAS. To adhere to strict FIPS compliance guidelines, you can only import certificates from trusted third-party resources.

Cisco NAC Appliance uses two types of keys to support FIPS compliance: Private Keys and Shared Master Keys. Both of these key types are managed and stored using the FIPS card installed in the CAM/CAS. During installation, keys are created using the CAM/CAS setup utilities, the keys are then moved to the card for security, and key-generation files and/or directories are then removed from the CAM/CAS.

This enhancement affects the following pages of the CAM web console:

Administration > Clean Access Manager > SSL > x509 Certificate

Administration > Clean Access Manager > SSL > Trusted Certificate Authorities

Administration > Clean Access Manager > SSL > x509 Certification Request

FIPS and SSH

SSH connections between FIPS and non-FIPS CAMs/CASs are supported in Cisco NAC Appliance Release 4.7(0) or Release 4.8. However, if the FIPS card in a CAM/CAS fails (or is inadvertently set to the incorrect operational mode), you cannot use SSH to or from that appliance until the issue with the card is resolved.

You can verify FIPS functionality on a CAM/CAS as follows:

a. Ensure the FIPS card operation switch is set to "O" (for operational mode).

b. Log into the CAM console interface as root.

c. Navigate to the /perfigo/common/bin/ directory.

d. Enter ./test_fips.sh info and verify the following output:

Installed FIPS card is nCipher
Info-FIPS file exists
Info-card is in operational mode
Info-httpd worker is in FIPS mode
Info-sshd up

Note You can also verify whether or not the FIPS card is properly installed and enabled in the Clean Access Manager by looking at the CAM Monitoring > Summary web console page. When FIPS is operational, the following status is displayed:

Installed card in the system: nCipher
System is running in FIPS mode


FIPS and the Cisco NAC Appliance SWISS Protocol

To enhance network security and adhere to FIPS 140-2 compliance, Cisco NAC Appliance encapsulates SWISS communications between client machines and CASs, including Discovery Packet transmission/acknowledgement, authentication, and posture assessment results using the HTTPS protocol.

In addition, the CAS SWISS mechanism has been enhanced to feature a new handler that uses 3DES encryption for SWISS protocol functions. Because of these changes, older versions of Cisco NAC Appliance Agents are not compatible with FIPS-compliant CAMs/CASs in Releases 4.8 and 4.7(0).

IPSec Considerations with FIPS

Cisco NAC Appliance Releases 4.8 and 4.7(0) use IPSec for the following purposes:

CAM and CAS HA pairs (both FIPS and non-FIPS modes)

CAS file synchronization between HA-Primary and HA-Secondary nodes

CAM and CAS RADIUS server authentication calls in FIPS mode

ASA (Adaptive Security Appliance)-CAS in FIPS mode

When setting up your Cisco NAC Appliance to use IPSec, you must ensure you can set up and import certificates and configure IPSec tunnels between Cisco NAC Appliance and your external authentication resources.

For Active Directory, LDAP, and Kerberos functions with FIPS-compliant CAMs/CASs, you must ensure that hosts are running Windows 2008 Server to support secure authentication sessions between external resources and FIPS-compliant appliances.

FIPS and SNMP Configuration

Cisco NAC Appliance Release 4.7(0) and Release 4.8 provide support for SHA-1 and 3DES encryption when configuring SNMP management on a FIPS-compliant CAM.

This enhancement affects the following page of the CAM web console:

OOB Management > Profiles > SNMP Receiver > SNMP Trap

FIPS and Cisco Secure ACS as RADIUS Authentication Provider

You can configure a FIPS 140-2 compliant external RADIUS Authentication Provider type by setting up a secure IPSec tunnel between your Cisco NAC Appliance system and Cisco ACS 4.x in a Windows environment running Windows Server 2003 or 2008.

For specific configuration instructions, see "Add a FIPS 140-2 Compliant RADIUS Auth Provider Using an ACS Server" section of the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3).

FIPS with VPN SSO

You can configure Cisco NAC Appliance to connect to and manage a Cisco ASA VPN Concentrator in a FIPS 140-2 compliant deployment.

For specific configuration instructions, see the "Configure VPN SSO in a FIPS 140-2 Compliant Deployment" section of the Cisco NAC Appliance - Clean Access Server Configuration Guide, Release 4.8(3).

FIPS with AD SSO

To maintain FIPS 140-2 compliance and support AD SSO, you must use 32-bit Windows Server 2008 with KTPass version 6.0.6001.18000, and client machines must run Windows Vista or Windows 7 with Cisco NAC Agent version 4.7.1.15 or version 4.8.0.35 installed. For specific configuration instructions, see the "Configure Active Directory for FIPS 140-2 Compliant AD SSO" section of the Cisco NAC Appliance - Clean Access Server Configuration Guide, Release 4.8(3).

You cannot perform AD SSO in a FIPS-compliant network using Cisco Wireless LAN Controllers because the WLCs do not support IPSec communication with the Cisco NAC Appliance network, so you cannot provide RADIUS SSO capability to users in your FIPS 140-2 compliant environment.

Supported Switches for Cisco NAC Appliance

See Cisco NAC Appliance Switch and Wireless LAN Controller Support for complete details on:

Cisco switch models and Wireless LAN Controllers supported in a Cisco NAC Appliance Wireless OOB environment

All switch models and NME service modules that support Out-of-Band (OOB) deployment

Switches/NMEs that support VGW VLAN mapping

Known issues with switches/WLCs

Troubleshooting information

VPN and Wireless Components Supported for Single Sign-On (SSO)

Table 1 lists VPN and wireless components supported for Single Sign-On (SSO) with Cisco NAC Appliance. Elements in the same row are compatible with each other.

Table 1 VPN and Wireless Components Supported By Cisco NAC Appliance For SSO

Cisco NAC Appliance Version
VPN Concentrator/Wireless Controller
VPN Clients

4.5 and later

Cisco 5500 Series Wireless LAN Controllers

N/A

Cisco WiSM Wireless Service Module for the Cisco Catalyst 6500 Series Switches

N/A

Cisco 2200/4400 Wireless LAN Controllers (Airespace WLCs)1

N/A

Cisco ASA 5500 Series Adaptive Security Appliances, Version 8.0(3)7 or later2

AnyConnect

Cisco ASA 5500 Series Adaptive Security Appliances, Version 8.0(3)7 or later

Cisco SSL VPN Client (Full Tunnel)

Cisco VPN Client (IPSec)

Cisco WebVPN Service Modules for Cisco Catalyst 6500 Series Switches and Cisco 7600 Series Routers

Cisco VPN 3000 Series Concentrators, Release 4.7

Cisco PIX Firewall

1 For additional details, see also Known Issues with Cisco 2200/4400 Wireless LAN Controllers (Airespace WLCs).

2 Release 4.5 and later supports existing AnyConnect clients accessing the network via Cisco ASA 5500 Series devices running release 8.0(3)7 or later. For more information, see the Release Notes for Cisco NAC Appliance, Version 4.1(3), and CSCsi75507.



Note Only the SSL Tunnel Client mode of the Cisco WebVPN Services Module is currently supported.

Cisco WLCs do not support IPSec communication with the Cisco NAC Appliance network, so you cannot provide RADIUS SSO capability to users in your FIPS 140-2 compliant environment.


For further details, see the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3) and the Cisco NAC Appliance - Clean Access Server Configuration Guide, Release 4.8(3).

Additional Support Information

Refer to Support Information for Cisco NAC Appliance Agents, Release 4.5 and Later for additional details related to Windows/Mac OS X/Web Agent support.

Refer to Supported Hardware and System Requirements for Cisco NAC Appliance for additional information on Cisco NAC Appliance hardware platforms and support information for Cisco NAC Appliance 4.1(x) and earlier releases.

Software Compatibility

This section describes software compatibility for releases of Cisco NAC Appliance:

Release 4.8(3) CAM/CAS Upgrade Compatibility Matrix

Release 4.8(3) CAM/CAS/Agent Compatibility Matrix

Release 4.8(3) Agent Upgrade Compatibility Matrix

Release 4.8(3) CAM/CAS Upgrade Compatibility Matrix

Table 2 shows CAM/CAS upgrade compatibility. You can upgrade/migrate your CAM/CAS from the previous release(s) specified to the latest release shown in the same row. When you upgrade your system software, Cisco recommends you upgrade to the most current release available whenever possible.

Table 2 Release 4.8(3) CAM/CAS Upgrade Compatibility Matrix

Clean Access Manager 1
Clean Access Server 1 , 2
Upgrade From:
To:
Upgrade From:
To:

4.8(2)
4.8(1)
4.8
4.7(x)
4.6(1)

4.8(3)

4.8(2)
4.8(1)
4.8
4.7(x)
4.6(1)

4.8(3)

1 Next generation Cisco NAC Appliance platforms (FIPS or non-FIPS Cisco NAC-3315, NAC-3355, NAC-3395) support fresh installation of Release 4.8(3) or upgrade from Release 4.7(x) or 4.8(x) to Release 4.8(3) only. You can also install or upgrade to Release 4.8(3) on the NAC-3310, NAC-3350, and NAC-3390 platforms, but they operate in non-FIPS mode only. NAC-3310, NAC-3350, and NAC-3390 can be made FIPS-compliant by installing a field-replaceable FIPS card as described in the Cisco NAC Appliance FIPS Card Field-Replaceable Unit Installation Guide. See Hardware Support and Changes for 4.8(3) Upgrade for additional details.

2 The Clean Access Server is shipped with a default version of the Cisco NAC Profiler Collector. See Release 4.8(3) and Cisco NAC Profiler for details.


.

Release 4.8(3) CAM/CAS/Agent Compatibility Matrix

Table 3 lists Cisco NAC Appliance Manager/Server/Agent compatibility per supported release. CAM/CAS/Agent versions displayed in the same row are compatible with one another. Cisco recommends that you synchronize your software images to match those shown as compatible in Table 3.

For complete support information, including specific client machine operating systems supported with specific Agent versions, refer to the Support Information for Cisco NAC Appliance Agents, Release 4.5 and Later.

Table 3 Release 4.8(3) CAM/CAS/Agent Compatibility Matrix 

Clean Access Manager 1 , 2
Clean Access
Server 1 , 2
Cisco NAC Appliance Agents 3
Windows
Mac OS X
Web Agent
FIPS 140-2 Compliant 4

4.8
4.7(0)

4.8
4.7(0)

4.8.0.35
4.7.1.15

N/A

N/A

English-Only Server
English-Only Agent

4.8(3)

4.8(3)

4.8.3.9
4.8.2.1
4.8.1.5
4.8.0.35

4.8.3.594
4.8.2.591
4.8.2.590
4.8.1.584
4.8.0.569

4.8.3.1

4.7.4.2
4.7.3.2
4.7.2.10
4.7.1.511
4.7.1.15

4.7.3.522
4.7.2.507
4.7.1.506
4.7.0.2

4.6.2.113

4.6.0.3

1 Next generation Cisco NAC Appliance platforms (FIPS or non-FIPS Cisco NAC-3315, NAC-3355, NAC-3395) support fresh installation of Release 4.8(3) or upgrade from Release 4.7(x) or 4.8(x) to Release 4.8(3) only. You can also install or upgrade to Release 4.8(3) on the NAC-3310, NAC-3350, and NAC-3390 platforms, but they operate in non-FIPS mode only. NAC-3310, NAC-3350, and NAC-3390 can be made FIPS-compliant by installing a field-replaceable FIPS card as described in the Cisco NAC Appliance FIPS Card Field-Replaceable Unit Installation Guide. See Hardware Support and Changes for 4.8(3) Upgrade for additional details.

2 Make sure that both CAM and CAS are of same version.

3 See Enhancements in Release 4.8(3) for details on each version of the Windows/Mac OS X/Web Agents.

4 Release 4.8 and 4.7(0) are the only certified FIPS-compliant Cisco NAC Appliance releases.


Release 4.8(3) Agent Upgrade Compatibility Matrix

Table 4 shows Cisco NAC Appliance Agent upgrade compatibility when upgrading existing versions of the persistent Agents on clients after CAM/CAS upgrade.


Note Auto-upgrade does not apply to the temporal Cisco NAC Web Agent, since it is updated on the CAM under Device Management > Clean Access > Updates > Update.


For complete support information, including specific client machine operating systems supported with specific Agent versions, refer to the Support Information for Cisco NAC Appliance Agents, Release 4.5 and Later.

Table 4 Release 4.8(3) Agent Upgrade Compatibility Matrix

Clean Access Manager 1
Clean Access Server 1
Cisco NAC Appliance Agent 2
Upgrade From Cisco NAC Windows Agent:
To Latest Compatible Cisco NAC Windows Agent:
Upgrade From Cisco Mac OS X Agent
To Latest Compatible Mac OS X Agent

4.8(3)

4.8(3)

4.8.2.1
4.8.1.53, 4
4.8.0.35 3, 4
4.7.4.2
4.7.3.2
4.7.2.10 3, 4
4.7.1.5113 , 4
4.7.1.15 5
4.6.2.113

4.8.3.9

4.8.2.591
4.8.2.590
4.8.1.584
4.8.0.569
4.7.3.522
4.7.2.507
4.7.1.506
4.7.0.2
4.6.0.3

4.8.3.594

1 Next generation Cisco NAC Appliance platforms (FIPS or non-FIPS Cisco NAC-3315, NAC-3355, NAC-3395) support fresh installation of Release 4.8(3) or upgrade from Release 4.7(x) or Release 4.8(x) to Release 4.8(3) only. You can also install or upgrade to Release 4.8(3) on the NAC-3310, NAC-3350, and NAC-3390 platforms, but they operate in non-FIPS mode only. NAC-3310, NAC-3350, and NAC-3390 can be made FIPS-compliant by installing a field-replaceable FIPS card as described in the Cisco NAC Appliance FIPS Card Field-Replaceable Unit Installation Guide. See Hardware Support and Changes for 4.8(3) Upgrade for additional details.

2 See Enhancements in Release 4.8(3) for details on each version of the Windows/Mac OS X/Web Agent.

3 Cisco NAC Agent versions 4.7.1.511, 4.7.2.10, and 4.8.0.35 are the only Cisco NAC Appliance Agents that support Windows 7 operating systems. (Cisco NAC Agent version 4.7.1.511 does not support the Windows 7 Starter Edition operating system.)

4 For checks/rules/requirements, version 4.1.1.0 and later Windows Agents can detect "N" (European) versions of the Windows Vista operating system, but the CAM/CAS treat "N" versions of Vista as their US counterpart.

5 To remain FIPS-compliant, users logging into Cisco NAC Appliance via AD SSO must run Windows Vista or Windows 7 and have Cisco NAC Agent version 4.7.1.15 or 4.8.0.35 installed on their client machine. Windows XP clients cannot perform AD SSO in a FIPS 140-2 compliant network. See FIPS with AD SSO for details.


Determining the Software Version

Clean Access Manager (CAM) Version

SSH or console to the machine and type: cat /perfigo/build

CAM web console: Administration > CCA Manager > Software Upload | Current Version

Clean Access Server (CAS) Version

SSH or console to the machine and type cat /perfigo/build

CAS web console (https://<CAS_eth0_IP_address>/admin):
Administration > Software Upload | Current Version

CAM web console: Device Management > CCA Servers > List of Servers > Manage [CAS_IP] > Misc > Upgrade Logs | Current Version

Cisco NAC Appliance Agent Version (Windows, Mac OS X, Web Agent)

CAM web console: Monitoring > Summary

Agent taskbar menu: right-click About for Agent version; right-click Properties for AV/AS software installed and Discovery Host (used for L3 deployments).

Cisco Clean Access Updates

CAM web console: Device Management > Clean Access > Updates > Summary

New and Changed Information

This section describes enhancements added to the following releases of Cisco NAC Appliance for the Clean Access Manager and Clean Access Server.

Enhancements in Release 4.8(3)

Unmanage All Option for Switches

Cisco NAC Windows Agent Version 4.8.3.9

Support for Windows 8

Support for Internet Explorer 10

Mac OS X Agent Version 4.8.3.594

Support for Mac OS X 10.8

Support for iOS 6

Cisco NAC Web Agent Version 4.8.3.1

Support for Internet Explorer 10 on Windows 7

Support for Microsoft Active Directory

Features Optimized/Removed in Release 4.8(3)

Supported AV/AS Product List Enhancements (Windows Version 91, Mac OS X Version 14)

Unmanage All Option for Switches

In Cisco NAC Appliance release 4.8(3), the option Unmanage All has been included that can be used to change all the managed ports to default port profile that was setup for a switch.

This feature affects the following page in the CAM web console:

OOB Management > Devices > Devices > List > Config[Switch_IP] > Ports > Manage > new Unmanage All option.

Cisco NAC Windows Agent Version 4.8.3.9

Cisco NAC Appliance Release 4.8(3) introduces Cisco NAC Agent version 4.8.3.9.

Refer to Release 4.8(3) CAM/CAS/Agent Compatibility Matrix for additional compatibility details.

For details on Agent functionality, refer to the "Cisco NAC Appliance Agents" chapter of the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3).

Support for Windows 8

Cisco NAC Windows Agent 4.8.3.8 supports Windows 8.

You can download the patch that supports Windows 8 from the following URL:

http://www.cisco.com/cisco/pub/software/portal/select.html?i=!y

Navigate to Security > Access Control and Policy > Network Admission Control > Cisco NAC Appliance (Clean Access) > Cisco NAC Appliance 4.8 > Network Admission Control (NAC) Software Patches.

Download and Install the Patch-CSCud24111-483.tar.gz file.

In Windows 8 Operating System, the Internet Explorer has two modes, Desktop and Metro. In the Metro mode, the ActiveX plugins are restricted. You cannot download NAC Agent in the Metro mode. You must switch to Desktop mode and then launch Internet Explorer to download NAC Agent.

Support for Internet Explorer 10

Cisco NAC Appliance Release 4.8(3) includes support for Internet Explorer 10.

If you are using Internet Explorer 10 on Windows 8 client, refer to the following before downloading the NAC Agent.

Importing Self-Signed Certificate

If customers are using self-signed certificates for CAM, then you need to run Internet Explorer 10 in Administrator mode to install these certificates.

Downloading Cisco NAC Agent

If you are not able to download Cisco NAC agent, check and enable the compatibility mode in Internet Explorer 10.

Enabling ActiveX Control

Cisco NAC appliances installs the Cisco NAC Agent and Web Agent via ActiveX control. In Internet Explorer 10, the option to prompt for ActiveX controls is disabled by default. To enable this option in Internet Explorer 10, perform the following:


Step 1 Go to Tools > Internet Options.

Step 2 Go to the Security tab and click Internet and Custom Level.

Step 3 Under ActiveX Controls and Plugins section, enable Automatic Prompting for ActiveX controls.


Mac OS X Agent Version 4.8.3.594

Cisco NAC Appliance Release 4.8(3) is bundled with Mac OS X Agent version 4.8.3.594.

Cisco Mac OS X Agent version 4.8.3.594 provides updated AV/AS support capabilities on Macintosh client machines as described in Cisco NAC Appliance Supported AV/AS Products.

Support for Mac OS X 10.8

Mac OS X Agent version 4.8.3.594 supports Mac OS X 10.8 "Mountain Lion". You need to download a server patch to enable the support from the following URL:

http://software.cisco.com/download/release.html?mdfid=282855549&flowid=34712&softwareid=282562546&release=4.8.3&relind=AVAILABLE&rellifecycle=&reltype=latest

See Also CSCub01401.

Support for iOS 6

Cisco NAC Appliance Release 4.8(3) includes support for iOS 6.

Cisco NAC Web Agent Version 4.8.3.1

Cisco NAC Appliance Release 4.8(3) introduces Cisco NAC Web Agent version 4.8.3.1.

For details on Agent functionality, refer to the "Cisco NAC Appliance Agents" chapter of the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3).

Support for Internet Explorer 10 on Windows 7

Cisco NAC Appliance Release 4.8(3) supports Internet Explorer 10 on Windows 7. When Internet Explorer 10 is installed on Windows 7, to get full network access, you need to update to March 2013 Hotfix ruleset.

Support for Microsoft Active Directory

Cisco NAC Appliance Release 4.8(3) supports Microsoft Active Directory 2012 server with 2008/2008 R2 and 2012 functional levels.

Cisco NAC Appliance does not support Microsoft Active Directory 2012 server at 2003 functional level for ADSSO. See CSCuh81091.

Features Optimized/Removed in Release 4.8(3)

In Cisco NAC Appliance release 4.8(3), you can use a .tar.gz upgrade process similar to that used for upgrading CAM/CAS appliances in earlier releases of Cisco NAC Appliance (like the process used in Release 4.6(1), 4.7(2), and 4.8) instead of having to perform "in-place" upgrades via an .ISO image on a CD-ROM, as is required to upgrade to Cisco NAC Appliance release 4.7(0) and 4.7(1). For more information, see Upgrading to Release 4.8(3).


Note You cannot use the Release 4.8(3) .ISO CD-ROM to perform an upgrade. You must use the .tar.gz upgrade file method.


Support for Mac OS X 10.4 Removed

In Cisco NAC Appliance Release 4.8(3), support for Mac OS X 10.4 has been removed.

If you are using a client machine with Mac OS X 10.4, you need to upgrade it to Mac OS X 10.5 or later to work with Cisco Mac OS X Agent 4.8.3.594.

Supported AV/AS Product List Enhancements (Windows Version 91, Mac OS X Version 14)

See Cisco NAC Appliance Supported AV/AS Products for the latest AV/AS product charts.

Cisco NAC Appliance Supported AV/AS Products

The Cisco NAC Appliance Supported AV/AS Product List is a versioned XML file distributed from a centralized update server and downloaded to the Clean Access Manager via Device Management > Clean Access > Updates > Update. It provides the most current matrix of supported antivirus (AV) and anti-spyware (AS) vendors and products per version of the Agent, and is used to populate AV/AS Rules and AV/AS Definition Update requirements for Agents that support posture assessment/remediation.

You can access AV and AS product support information from the CAM web console under Device Management > Clean Access > Clean Access Agent > Rules > AV/AS Support Info. For convenience, this section also provides the following summary and product charts. The charts list which product versions support virus or spyware definition checks and automatic update of client virus/spyware definition files via the user clicking the Update button on the Agent.


Note In some cases, the specific AV/AS vendor software requires the user to have administrator privileges on the client machine to enable updates.


Windows 7/Vista/XP

For Windows 7/Vista/XP AV/AS support information on the Cisco NAC Agent (version 4.8.3.9) and Cisco NAC Web Agent (version 4.8.3.1), see the Cisco NAC Appliance Release 4.8(3) Supported Windows AV/AS Products document optimized for UTF-8 character display.

Mac OS X

For Mac OS X AV/AS support information on the Cisco Mac OS X Agent (version 4.8.3.594), see the Cisco NAC Appliance Release 4.8(3) Supported Mac OS X AV/AS Products document optimized for UTF-8 character display.


Note Cisco recommends keeping your Supported AV/AS Product List up-to-date on your CAM (particularly if you have updated the Windows Agent Setup/Patch version or Mac OS Agent) by configuring the Update Settings under Device Management > Clean Access > Updates > Update to Automatically check for updates starting from <x> every <y> hours.



Note Where possible, Cisco recommends using AV Rules mapped to AV Definition Update Requirements when checking antivirus software on clients, and AS Rules mapped to AS Definition Update Requirements when checking anti-spyware software on clients. In the case of non-supported AV or AS products, or if an AV/AS product/version is not available through AV Rules/AS Rules, administrators always have the option of creating their own custom checks, rules, and requirements for the AV/AS vendor (and/or using Cisco provided pc_ checks and pr_rules) through Device Management > Clean Access > Clean Access Agent (use New Check, New Rule, and New File/Link/Local Check Requirement). See the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3) for configuration details.

Note that Clean Access works in tandem with the installation schemes and mechanisms provided by supported AV/AS vendors. In the case of unforeseen changes to underlying mechanisms for AV/AS products by vendors, the Cisco NAC Appliance team will update the Supported AV/AS Product List and/or Agent in the timeliest manner possible in order to support the new AV/AS product changes. In the meantime, administrators can always use the "custom" rule workaround for the AV/AS product (such as pc_checks/pr_ rules) and configure the requirement for "Any selected rule succeeds."


Refer to Enhancements in Release 4.8(3) for additional details on Agent versions in this release.

Caveats

This section describes the following caveats:

Open Caveats - Release 4.8(3)

Resolved Caveats - Release 4.8(3)

Resolved Caveats - Cisco NAC Agent Vers 4.8.3.9/Mac OS X Vers 4.8.3.594


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

http://www.cisco.com/cgi-bin/Support/Bugtool/home.pl

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

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


Open Caveats - Release 4.8(3)

Table 5 List of Open Caveats (Sheet 1 of 36)

DDTS Number
Software Release 4.8(3)
Corrected
Caveat

CSCtr16957

No

Hub detection on CAT 6k switches blocks SNMP threads.

While roaming, random failures happen in OOB authentication. CAM throws an error as "OOB client not found". This happens because the SNMP traps are processed after a long time. As a result, there is no CDL entry for the MAC, and the user has issues while logging in.

Workaround   Force the client to reauthenticate on WLC.

CSCtl02578

No

Nook color logging into web login prompts for agent - Add support.

Nook Color device gets prompted to download the agent when logging into Clean Access web portal. This is due to an issue where Nook presents a browser string that states it is running Mac OS X.

Workaround   

1. Disable the agent requirement for Mac OS X.

2. Add a filter in for the Nook Color device MAC address.

CSCsl75403

No

MAC Agent does not detect VPN interface-fails MAC filters/L3 strict mode.

MAC filter does not work for Mac OS X client machines connected to the network in VPN environment. L3 Strict mode does not allow Mac user to login and throws error message as "Access to network is blocked by the administrator."

Workaround   

1. Use IP based filters for Mac OS X client machines in VPN environment.

2. Disable L3 strict mode on CAS

CSCts87316

No

Cisco NAC Manager affected by CVE-2011-0997

This is a false alarm. CAM and CAS use static IPs only (configured using 'service perfigo config' command). Any change in IP address requires re-configuring the CAM and CAS and that again gives static IP only.

CSCsy45807

No

Mac OS X Agent does not pop-up using EVDO/3G card.

Mac OS X Agent does not send discovery packets and does not pop up a login window when connected to a 3G/EVDO network card.

CSCtb44223

No

Mac Agent gets presented with incorrect login page and providers.

Mac agent is presented with providers from MAC_ALL login page, not MAC_OSX login page.

Workaround   Configure MAC_ALL page identically to MAC_OSX page.

CSCsd03509

No

The Time Servers setting is not updated in HA-Standby CAM web console

After updating the "Time Servers" setting in HA-Primary CAM, the counterpart "Time Servers" setting for the HA-Standby CAM does not get updated in the web console even though the "Time Servers" setting is updated in the HA-Standby CAM database.

Workaround   Reboot the HA-Standby CAM or perform a HA-CAM failover to make the HA-Standby CAM become HA-Active.

CSCsg07369

No

Incorrect "IP lease total" displayed on editing manually created subnets

Steps to reproduce:

1. Add a Managed Subnet having at least 2500+ IP addresses (for example 10.101.0.1/255.255.240.0) using CAM web page Device Management > Clean Access Servers > Manage [IP Address] > Advanced > Managed Subnet.

2. Create a DHCP subnet with 2500+ hosts using CAM web page Device Management > Clean Access Servers > Manage [IP Address] > Network > DHCP > Subnet List > New.

3. Edit the newly created subnet using CAM web page Device Management > Clean Access Servers > Manage [IP Address] > Network > DHCP > Subnet List > Edit.

4. Click Update. The CAM displays a warning informing the administrator that the current IP Range brings IP lease total up to a number that is incorrect. The CAM counts the IP address in the subnet twice, creating the incorrect count.

The issue is judged to be cosmetic and does not affect DHCP functionality.

CSCsg66511

No

Configuring HA-failover synchronization settings on Secondary CAS takes an extremely long time

Once you have configured the Secondary CAS HA attributes and click Update, it can take around 3 minutes for the browser to get the response from the server. (Configuring HA-failover synchronization on the Primary CAS is nearly instantaneous.)

CSCsh77730

No

Agent locks up when greyed out OK button is pressed

The Agent locks up when the client machine refreshes its IP address. This only occurs when doing an IP release/renew, so the CAS must be in an OOB setup.

If the Automatically close login success screen after <x> secs option is enabled and the duration set to 0 (instantaneous) in the Clean Access > General Setup > Agent Login page and the user clicks on the greyed out OK button while the IP address is refreshing, the Agent locks up after refreshing the IP address. The IP address is refreshed and everything else on the client machine works, but the user cannot close the Agent without exiting via the system tray icon, thus "killing" the Agent process.

Workaround   Either uncheck the box or set that timer to a non-zero value. If it is set to anything else, and the user hits the greyed out OK button while the IP is refreshing, then the Agent window closes successfully.

CSCsi07595

No

DST fix will not take effect if generic MST, EST, HST, etc. options are specified

Due to a Java runtime implementation, the DST 2007 fix does not take effect for Cisco NAC Appliances that are using generic time zone options such as "EST," "HST," or "MST" on the CAM/CAS UI time settings.

Workaround   If your CAM/CAS machine time zone setting is currently specified via the UI using a generic option such as "EST," "HST," or "MST." change this to a location/city combination, such as "America/Denver."

Note CAM/CAS machines using time zone settings specified by the "service perfigo config" script or specified as location/city combinations in the UI, such as "America/Denver" are not affected by this issue.

CSCsj46232

No

Agent should NOT pop-up during CAS HA failover

Agent pops up during CAS HA failover. The user ISD still appears in the Online User List and the client machine still appears in the Certified Devices List.

Workaround   The user simply needs to close the Agent dialog and it does not pop up again.

CSCsk55292

No

Agent not added to system tray during boot up

When the Agent is installed on a Windows client, the Start menu is updated and Windows tries to contact AD (in some cases where the AD credentials are expired) to refresh the Start menu.

Due to the fact that the client machine is still in the Unauthenticated role, AD cannot be contacted and an approximately 60 second timeout ensues, during which the Windows taskbar elements (Start menu, System Tray, and Task Bar) are locked. As a result, the Agent displays a "Failed to add Clean Access Agent icon to taskbar status area" error message.

Workaround   There are two methods to work around this issue:

Allow AD traffic through the CAS for clients in the Unauthenticated role.

Try to start the Agent manually after the install and auto load process fails.

CSCsl13782

No

Microsoft Internet Explorer 7.0 browser pop-ups on Windows Vista launched from the Summary Report appear behind the Summary Report window

This is also seen when you click on the Policy link in the Policy window. This issue appears on Vista Ultimate and Vista Home, but is not seen with Firefox or on Internet Explorer versions running in Windows 2000 or Windows XP.

Workaround   You can click on the new item on the Windows status bar to bring the new dialog box or window in front of the Cisco NAC Web Agent Summary report.

Note This problem only happens when a Google tool bar is installed and enabled in Internet Explorer.

CSCsl17379

No

Multiple Agent pop-ups with Multi NIC in L2 Virtual Gateway OOB role-based VLAN

The user sees multiple Agent login dialogs with two or more active NICs on the same client machine pointing to the Unauthenticated network access point (eth1 IP address).

After the first Agent pops up and the user logs in, a second Agent login dialog pops up. If the user logs in to this additional Agent instantiation there are now two entries for the same system with both MAC addresses in the CAM's Certified Device List and Online Users List.

Workaround   The user can manually Disable Agent login pop-up after authentication.

CSCsl40812

No

The Refresh Windows domain group policy after login option is not functioning for Cisco NAC Web Agent

(It is working fine with the Clean Access Agent.)

This scenario was tested configuring a GPO policy for a Microsoft Internet Explorer browser title. The browser was not refreshed as expected after login in using the Web Agent.

CSCsl88429

No

User sees Invalid session after pressing [F5] following Temporary role time-out

When a user presses [F5] or [Refresh] to refresh the web page after the Agent Temporary role access timer has expired, the user sees an "Invalid" session message. If the user then attempts to navigate to the originally requested web address, they are prompted with the web login page again and are able to log in.

CSCsl88627

No

Description of removesubnet has "updatesubnet" in op field

The removesubnet API function description has "updatesubnet" listed in its operations field. The description should read "removesubnet."

CSCsm20254

No

CAS duplicates HSRP packets with Cisco NAC Profiler Collector Modules enabled.

Symptom    HSRP duplicate frames are sent by CAS in Real-IP Gateway with Collector modules enabled. This causes HSRP issues and the default gateway to go down.

Conditions   Real-IP Gateway and Collector modules enabled on a CAS with ETH0 and or ETH1 configured for NetWatch.

Workaround   Do not configure the CAS' ETH0 trusted interface or ETH1 untrusted interface in the NetWatch configuration settings for the CAS Collector. It is not a supported configuration.

CSCsm61077

No

ActiveX/Java applet fails to refresh the IP address on Vista with User Account Control (UAC) turned on

When logged in as a machine admin on Vista and using web login with IP refresh configured, IP address refresh/renew via ActiveX or Java will fail due to the fact that IE does not run as an elevated application and Vista requires elevated privileges to release and renew an IP address.

Workaround   In order to use the IP refresh feature, you will need to:

1. Log into the Windows Vista client as an administrator.

2. Create a shortcut for IE on your desktop.

3. Launch it by right-clicking the shortcut and running it as administrator. This will allow the application to complete the IP Refresh/Renew. Otherwise, the user will need to do it manually via Command Prompt running as administrator.

Note This is a limitation of the Windows Vista OS.

Alternatively, the Cisco NAC Web Agent can be used with no posture requirements enabled.

See also Known Issue for Windows Vista and IP Refresh/Renew.

CSCso49473

No

"javax.naming.CommunicationException" causes no provider list

ADSSO with LDAP Lookup

If the LDAP connection to Active Directory fails during the lookup process (because the lookup takes a long time or the connection is suddenly lost), the Agent does not receive the list of authentication providers from the CAS. As a result, the user is presented with a blank provider list.

LDAP server fails to respond due to network connectivity failure or a long directory search. The failure must occur after communication to the LDAP server has begun.

Note There is no known workaround for this issue.

CSCso50613

No

Mac OS X Agent DHCP refresh fails if dhcp_refresh file does not exist

DHCP refresh will fail with no notice (to the user or to the logs) if the dhcp_refresh file does not exist. The dhcp_refresh tool is required for all versions of Mac OS X Agents, so it always fails if the dhcp_refresh tool is missing regardless the Mac OS version.

Workaround   There are three ways to work around this issue:

1. Reinstalling the Mac OS X Agent automatically reinstalls the missing dhcp_refresh file.

2. Users can sign on to Cisco NAC Appliance via web login. The Java applet installs the dhcp_refresh tool if the Install DHCP Refresh tool into Linux/MacOS system directory option is checked under User Page > Login Page > Edit > General.

3. When using the Apple Migration Assistant, the user can try to include /sbin/dhcp_refresh in the migration list.

CSCsr52953

No

RMI error messages periodically appear for deleted and/or unauthorized CASs in CAM event logs

Clean Access Servers connected to a CAM can periodically appear as "deleted" or "unauthorized" in the CAM event logs even though the CAS is functioning properly and has not experienced any connection issues with the Clean Access Manager. Error message examples are:

"SSL Communication 2008-07-23 00:31:29 SSLManager:authorizing server failed CN=10.201.217.201, OU=Perfigo, O=Cisco Systems, L=San Jose, ST=California, C=US"

"SSL Communication 2008-07-23 00:31:29 RMISocketFactory:Creating RMI socket failed to host 10.201.217.201:java.security.cert.CertificateException: Unauthorized server CN=10.201.217.201, OU=Perfigo, O=Cisco Systems, L=San Jose, ST=California, C=US"

Workaround   

Reboot the CAS and wait for the CAM to re-establish connection.

Reboot the CAM after deleting and removing the CAS from the Authorized CCA Server list using the CAM Device Management > CCA Servers > Authorization admin web console page.

CSCsu47350

No

Invalid version number displayed in CAM backup snapshot web page

When the administrator navigates to another page in the CAM web console during the backup snapshot process, the resulting snapshot version number is invalid.

CSCsu63247

No

DHCP IP refresh not working for some Fedora core 8 client machines

DHCP IP refresh does not work on Fedora core 8 clients logging in to a Layer 3 Real-IP Gateway CAS using the current version of the Java applet. As a result, Fedora core8 clients must use web login to gain access to the Cisco NAC Appliance network.

Note There is no known workaround for this issue

CSCsu78379

No

Bandwidth settings for Receiver CAM roles should not change after Policy Sync

Steps to reproduce:

1. Create role on Master CAM, r1

2. Edit Upstream and Downstream Bandwidth fields of r1 to equal 1Kbps

3. Create role on Receiver CAM, r2

4. Edit Upstream and Downstream Bandwidth fields of r2 to equal 2 Kbps

5. Select role-based Master Policies to Export and perform manual sync

6. Upstream and Downstream Bandwidth fields for role r1 on Receiver CAM are changed to -1 (not 2 Kbps and not 1 Kbps).

Note Receiver's Up/Down Kbps, Mode, Burst should either not change or should be the same as the Master.

CSCsu84848

No

CAM should set the switch port to Authentication VLAN before removing from OUL and DCL

The CAM should set the switch port to the Authentication VLAN before removing the user from Online Users List and Discovered Client List when the Switch or WLC entry is deleted from the CAM.

Workaround   Bounce the switch port to clear the OUL and DCL.

CSCsv18261

No

HA Failover database sync times out in event log after reboot

In Cisco NAC Appliance Release 4.5, the CAM HA database copy function times out when the active CAM fails over and becomes the standby CAM. (Event log entries show that the database copy function times out.) This situation arises when the inactive CAM comes up and attempts to copy the database from the active CAM, but the database is still locked by the [now standby] CAM. This issue is not seen during normal operation and database sync because the entries are copied in real time.

Note In Cisco NAC Appliance releases prior to 4.5, there is no timeout function, and the database sync takes less time to complete because the CAM does not lock the database or verify the copy function.

CSCsv20270

No

Conflicting CAM's eth1 HA heartbeat address with Release 4.5.0 after upgrade

The perfigo service cannot be started on the standby CAM because both the eth1 interface of HA CAMs have the same IP address: either 192.168.0.253 or 192.168.0.254.

This happens in an HA setup when one of the CAMs is upgraded from Release 4.0(x) to 4.5 and the other CAM is fresh CD installed.

Workaround   Change to use the manual setting for eth1 on the fresh CD installed node or re-apply the HA config on the upgraded node.

CSCsv22418

No

CAS service IP not reachable after standby reboot due to race condition

The Active CAS's service IP become unreachable after standby CAS reboot.

In a rare race condition, the standby CAS temporarily becomes active for very short period of time after reboot.

Workaround   

1. Increase the "Heartbeat Timeout" value from the recommended 15 seconds to 30 seconds.

2. Or, run the heartbeat interface on Interface 3 (eth2 or eth3).

CSCsv78301

No

VPN SSO login does not work with VPN in managed subnet after upgrade to Cisco NAC Appliance Release 4.5

Prior to Release 4.5, the Clean Access Server associates the client with the VPN IP address and VPN Concentrator's MAC address after the first login. From there, the SWISS protocol only checks the IP address from the Agent and reports back to the Agent that the client is logged in (regardless of whether the client is connected via Layer 2 or Layer 3).

In Release 4.5, the SWISS protocol checks the MAC address for Layer 2 clients, but the MAC address reported by the Agent (which is the real client MAC address) is different from the one the CAS gets for the client (the VPN concentrator MAC address). As a result, the SWISS protocol tells the Agent that the client machine is not logged in (due to the different MAC addresses recorded) and the Agent launches the login dialog repeatedly, never able to complete login.

Workaround   Remove the subnet making up the client machine address pool from the collection of managed subnets and create a Layer 3 static route on the CAS untrusted interface (eth1) with VPN concentrator's IP address as the gateway for the VPN subnet using the CAM web console Device Management > CCA Servers > Manage [CAS_IP] > Advanced > Static Routes page.

CSCsv92867

No

DB conversion tool (Latin1 to UTF8)-iconv cannot work with &#8224; format

Release 4.5 and earlier Clean Access Managers with foreign characters in the database cannot be upgraded to Release 4.6(1) and later.

Workaround   To upgrade from Release 4.1(6) or 4.5:

Perform a fresh install of Release 4.6(1) or later (recommend).

Remove any foreign characters from the database prior to upgrade.

CSCsw39262

No

Agent cannot be launched when switching between users in Vista

The Cisco NAC Agent does not support Windows Fast User Switching. The effect is that the primary user is the only user that:

Can log into the Clean Access Server and based on the level of authentication will dictate the system's access to the network.

Will see the NAC Agent tray icon.

Will be able to re-authenticate if kicked off the network via the Clean Access Server.

Note This does not impact client machines that are part of a Windows Domain. It also does not impact users who log out before logging in as another user.

Workaround   Logging out the first user or closing the Cisco NAC Agent before Fast Switching eliminates this problem.

CSCsw45596

No

Username text box should be restricted with max no of characters

The Username text box is presently taking the characters such that the total size is ~5kb. It is better to have the upper bound for the Username text box to hold the number of characters that it can take.

CSCsw67476

No

Mac OS X Agent upgrade cannot be restarted once stopped

User is not able to log in again (no agent screen or icon available) when they cancel the Mac OS X Agent upgrade process.

Note This issue has been observed when upgrading from Release 4.5 to 4.6(1) and later.

Workaround   Manually start the agent which then started the upgrade portion.

CSCsw88911

No

Mac Agent freezes on login dialog, but remains operational

The tray icon of a Mac OS X Agent logged into a Cisco NAC Appliance OOB deployment shows Click - Focus then Click again and is hung (looks like logging in).

Workaround   Operationally, everything is running normally (the machine is OOB and logged in per CAM and client) just the user interface is locked up.

CSCsx05054

No

DHCP does not work with IGNORE fallback policy and CAS Failover

If CAS Fallback policy is set to IGNORE and the CAM becomes unreachable from CAS, the CAS blocks all traffic and CAS DHCP stops working.

Workaround   Setting the CAS Fallback policy to "Allow All" or "Block All" solves the issue. Also, if you can ensure that the active CAS does not fail over when CAM is unreachable, this situation should not happen.

CSCsx18496

No

Cisco Log Packager crashes on XP Tablet PC with Restricted User credentials

CSCsx29191

No

Mac OS X Agent has no `APPLE'+TAB presence

When using the Mac OS X Agent, the GUI focus can get lost and is hard to regain. This issue was observed during upgrade.

Workaround   Using hot corners to show all applications. With this tool, users can find the Agent and continue the process.

CSCsx35438

No

Clean Access Manager read timeout reached when deleting many DHCP IPs at once

After upgrading to or installing Release 4.1(8) and deleting hundreds of DHCP IPs at once, the Clean Access Server becomes unmanageable. This issue affects Clean Access Servers configured as a DHCP server on which the administrator tries to delete more than 800 DHCP IPs at once.

Workaround   Please see Known Issue with Mass DHCP Address Deletion.

CSCsx35911

No

Mac OS X Agent does not pop up for login and click-focus does not get user's attention

When the user moves from a non-Cisco NAC Appliance network to a Cisco NAC Appliance network, the Agent login dialog does not automatically appear. Click-focus can resolve the issue, but the is not generally obvious to the user. The result of this issue is that users would likely be stuck in the authentication network and/or assigned to a restricted role for the duration of their session.

Workaround   Click on the upper right icon that is saying click focus and then login.

CSCsx37073

No

Cisco NAC Agent does not pop-up if authentication server name is \\

Steps to reproduce:

1. Create a Kerberos authentication server named \\ in addition to Local DB.

2. Go to Login Page > Content and check Provider Label, Local DB, \\ (def provider).

3. Let the Cisco NAC Agent pop-up. User sees \\ and Local DB as Server options. (This is as expected.)

4. Go to Login Page > Content and uncheck Local DB.

5. Let the Cisco NAC Agent pop-up again. This time, user sees only the \\ Server option. (This is also as expected.)

6. Go to User Management > Auth Servers and delete \\.

7. Close the Cisco NAC Agent window, which does not pop-up again.

Repeat the above steps with authentication server named "myKerberos" instead of \\. The CAM returns a "Clean Access Server is not properly configured. Please contact your administrator if the problem persists" error message.

Workaround   Avoid non-alphabetic naming conventions when configuring authentication servers in Cisco NAC Appliance.

CSCsx45051

No

Agent may proceed with AV/AS auto remediation while it's not supported

For an AV/AS Definition Update Requirement Type with Automatic Remediation Type and Antivirus/Anti-Spyware Vendor Name configured as ANY, when the client fails the requirement, the Agent should automatically launch the AV (or AS) update on the AV product for which the Agent supports live update. If live update is not supported, the Agent should prompt the user to perform manual remediation. With this issue, the Agent may proceed with auto remediation on a product for which the Agent does not support live update. As a result, auto remediation will fail, and the agent will prompt user to do manual remediation.

Note This issue is observed with MS Live One 2.x. Auto Remediation fails when configured for MS Live One 2.x.

Workaround   Remediate AV manually while in the temporary role.

CSCsx49160

No

Cisco NAC Agent shows one less authentication provider if one of the provider names is \

Steps to reproduce:

1. Create a Kerberos authentication server called my_krbr.

2. Create a login page and check the Local DB and my_krbr (def provider) Provider Labels.

3. Let the Cisco NAC Agent pop-up. Both my_krbr (def provider) and the Local DB provider options are available.

4. Go to the list of Authentication Servers and rename my_krbr to \.

5. Go to the Login page. \ appears as the new Kerberos name.

6. Close the Cisco NAC Agent and let it automatically pop-up again.

This time, the authentication provider list only shows Local DB—\ is missing.

Workaround   Avoid non-alphabetic naming conventions when configuring authentication servers in Cisco NAC Appliance.

CSCsx52263

No

NAC Appliances always assume USA keyboard layout

When connected via Keyboard and Monitor, if a keyboard with layout other than US layout is used, the Cisco NAC Appliances do not recognize the keyboard and it is possible to erroneously enter different characters.

Workaround   Use a US layout keyboard or ensure that you know the key mapping if you are connecting a keyboard of different layout.

CSCsy32119

No

Cisco NAC Appliance CAM/CAS need ability to set port speed/duplex manually

There have been instances where switch ports are not negotiating the same as other ports on the same appliance. This is inefficient since the ports in question do not necessarily use the highest possible speed. In addition, there could be collisions, FEC, and errors on a port if there is a mismatch.

Note There is no known workaround for this issue.

CSCsz19346

No

Korean log packager GUI translations/buttons are garbled & some missing

Workaround   Some of the buttons are still readable. Click Collect Data > Locate File and then click Exit.

CSCsz19912

No

Log Packager CiscoSupportReport file shows ##### in place of system info

The system logs created by the log packager are showing ##### instead of actual data, as in the following examples:

04/23/2009 10:49:22 W32Time (ID=0x825a0083): NtpClient# 
'CCAVPN-AD'# DNS ## ### ## ## #### ### ### ### #### #####. 
NtpClient# 15# ## ## #### # ### ### ### # ## ###. ##: ### 
#### ####. (0x80072AF9).
 
        
04/23/2009 10:49:21 W32Time (ID=0x825a0083): NtpClient# 
'CCAVPN-AD'# DNS ## ### ## ## #### ### ### ### #### #####. 
NtpClient# 15# ## ## #### # ### ### ### # ## ###. ##: ### 
#### ####. (0x80072AF9).
 
        

This issue occurs on Japanese, Korean, and Chinese systems using Cisco Log Packager.

Note There is no known workaround for this issue. Log Packager is still functioning, but it is missing some non-critical system troubleshooting information.

CSCsz38970

No

Accessibility: login displays not announced

After you log into Windows, you see the ADSSO display and then the local corporate display. JAWS does not announce the Cisco NAC Agent displays.

Note This issue has been observed in a deployment where JAWS is set to run at system startup.

Workaround   You have to select the Cisco NAC Agent from the taskbar to have the Agent display announced.

CSCsz48847

No

Accessibility: after successful log-in, JAWS is still on Cisco NAC Agent page

JAWS stays on The Cisco NAC Agent window even though no Agent window is displayed.

Workaround   Press the Windows key to go back to the Windows desktop.

CSCsz49147

No

Accessibility: JAWS does not announce installer after upgrade

During upgrade of the Cisco NAC Agent, the MS installer window is not announced.

Note This does not impact the upgrade process.

Workaround   A blind user will need to check the running applications in the Windows taskbar.

CSCsz55538

No

IP refresh message shows up in L3OOBRIP with IP Un-numbered scenario

When L3OOBRIP with IP un-numbered is configured, the IP refresh message shows up even if IP refresh does not happen.

Workaround   In the CAM web console, go to Profiles > SNMP Receiver > Advanced Settings. Enter "0" in the DHCP Release Delay and DHCP Renew Delay fields.

CSCsz83270

No

Agent file download fails at lower speed WAN links between CAS and CAM

When the Agent is uploaded to the CAM, the .tar file gets partially downloaded and removed several times on CAS before it is successfully downloaded and its contents unpacked. As a result the client does not pop-up for a long time for upgrade or fresh install from the Cisco NAC Appliance web login page.

This happens during agent upgrade or download from web page when CAS and CAM are separated by a WAN link (512kbps/256kbps).

Workaround   If agent does not get downloaded for a long time, remove the contents of /perfigo/access/apache/www/perfigo_download to start the download of the file.

Note Problem usually corrects itself after a while, but if it does not, Cisco recommends following this workaround.

CSCsz85892

No

Web login display Guest ID instead of Username

Steps to reproduce:

1. Add a Kerberos auth server named "k1."

2. Enable the Local DB and "k1" providers on the Login Page, and make "k1" the default provider.

3. Open a browser and check that Username is there and "k1" is the default provider.

4. Delete "k1" from the roster of Auth Servers.

5. Open another browser and note that the user name is now "Guest ID."

CSCsz92761

No

CAM GUI and publishing behavior during DB restore

When a CAM snapshot is restored from a database, the CAM web console times out, and once refreshed, shows the associated CAS is offline as a result of triggering a database restoration.

This issue occurs when the CAM and CAS are connected via WAN links (T1/256k/512k) with several CASs experiencing at least 400ms delay.

Note After the CAM completes its parallel connection at the end of the database restoration, it starts to publish to many of the CASs via serial connection.

Workaround   DBrestore happens and CAS do get connected and publishing completed.

CSCta12544

No

Server communication error upon web and Agent login

This issue can occur when a brand new Release 4.5 or later CAS is connected to a CAM pair that has been upgraded from an older release of Cisco NAC Appliance to Release 4.5 or later, resulting in unreliable communication between the CAM HA pair and the new CAS.

CSCta19323

No

Memory for crash kernel message seen during 4.7.0 CD install

The message is benign, it is displayed when memory is not configured/allocated for a crash kernel to aid in crash dump. This is displayed by Red Hat and CentOS 5 releases while booting on any system.

CSCta32189

No

Group mapping cannot be done if Class attribute data is big

When the ASA authenticates the VPN clients using LDAP and when the ASA does LDAP group mapping, the group information is sent in the class attribute of the accounting packet. This information is used by NAC for doing group mapping based on the class attribute, which fails while performing VPN SSO.

CSCta35732

No

Deleting subnet filters causes CASs to disconnect

When you delete the subnet filter one after another from the CAM, the web console slows down and looses connection to the associated CAS.

The CAM connects to all the CASs every few minutes via serial interface and checks for heartbeats. If a CAS goes offline, the CAM tries to connect to the CAS to resume connection. However, the wait time depends on the number of CASs attached to the CAM.

Note After a few minutes, CASs come back online.

CSCta35741

No

Agent not Popping up for First time for TLS not enabled on IE 6.0

If TLS 1.0 is not enabled on Microsoft Internet Explorer browsers when the user launches the Cisco NAC Agent in a FIPS 140-2 compliant network, the Agent dialog/login screen does not appear.

Workaround   The user must Exit the Cisco NAC Agent using the Windows Systray icon and launch the Agent again.

CSCta72210

No

Proxy exception error misleading

If CAS is accessed using proxy server, error message is displayed prompting the user to check the proxy settings of the browser.

CSCta97229

No

Collector Modules show "Stopping" instead of "Stopped" in Profiler UI

This issue happens when the administrator manually stops the Profiler Collector.

Workaround   Services are actually stopped. You can enter service collector status in the CAS CLI to verify the current state.

CSCtb30587

No

Clearing CAM CDL upon intra-subnet roaming keeps client in Access VLAN

This issue has been seen on WLC1 managing AP1 and WLC2 managing AP2 have same SSID with WLANs on both the controllers mapped to interface which are on the same subnet. (Both controllers are running version 6.0.182.0.)

Steps to reproduce:

1. Client is initially associated to AP1. Do a posture validation on the client and client entry is shown on WLC1.

2. Now disable AP1. The client machine is associated to AP2, the client entry is deleted from WLC1, and the client entry is now available only on WLC2. Client is now in Access VLAN and client entry shown on WLC2.

However, the CAM still lists WLC1 IP address with client entry.

3. Clear the CDL and OUL from the CAM. The client still appears in the Access VLAN, has complete access to the internet, and an error appears in the CAM's nac-manager.log file after clearing the CDL and OUL on the CAM.

CSCtb30691

No

Agent pops up from and active wired NIC after user is already authenticated via a wireless NIC in the same client machine

After authenticating using the wireless NIC with a higher preference than the wired NIC on the same client machine, the Agent pops up again, prompting the user to enter authentication credentials. This happens on Windows XP SP3 client machines. (This issue has not been observed in Windows XP SP2.)

Workaround   The problem is caused by a Windows TCP/IP feature called "Dead Gateway Detection." To disable this feature, set the "EnableDeadGWDetect" registry value under HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Tcpip\Parameters to 0, then reboot the client machine.

CSCtb32797

No

LDAP GSSAPI with SSL lookup and authentication fails

The Cisco NAC Appliance network returns the following message:

"Unsupported Ldap Operation ([LDAP: error code 53 - 00002029: LdapErr: DSID-0C09048A, comment: Cannot bind using sign/seal on a connection on which TLS or SSL is in effect, data 0, v1771])"

or

"Naming Error (dcchild.child.2k8.com:636; socket closed)"

Note Microsoft has documented this error on its support site at http://support.microsoft.com/kb/957072. Unfortunately, Windows 2008 server SP2 with the latest Windows updates as of 8/20/09 did not resolve this problem.

Note There is no known workaround for this issue.

CSCtb38026

No

Scripting error with database restore with modified DB snapshot name

If the database snapshot name is altered to include some string after the version number and before the .gz suffix like the following:

08_12_09-23-48_snapshot_VER_4_7_0_A23_upgraded_from_4-1-3.gz

the database restoration process returns a scripting error. This issue is only cosmetic and does not affect the database restore functionality.

Workaround   Do not rename the database snapshot (for identification purposes, for example) after it has been created.

CSCtb55184

No

Web Agent download fails if the CAS IP address in the trusted certificate is different from the CAS domain IP address.

This situation can occur when the CAS is in Layer 2 In-Band Real-IP gateway mode, and IP used for initial SSL cert during install is different from that imported using the web console.

Workaround   Enter service perfigo restart on the CAS to resolve this issue.

CSCtb70199

No

Redirect Blocked Request option shows incorrect page when using filter

User gets redirected to the default Blocked page URL when attempting to access a webpage that is not allowed under their user role's traffic policies instead of a custom page or URL that has been defined by the administrator. This occurs because the user shows up in the certified device list as [device-filter] but does not appear in the online user list.

CSCtb92910

No

Need to reflect all the states of FIPS card in the UI and CLI

Currently, the web console page only reflects whether or not the FIPS card is operational, but states like maintenance or initialization are not reflected.

Workaround   If the CAM Monitoring > Summary page does not show that the FIPS card is operational, assume it is in one of the other states (Maintenance or Initialization). You can also manually verify the electromagnetic switch position ("O," "M," or "I") on the FIPS card, itself when you look at the back of the NAC-3315/3355/3395 chassis.

Note Once the FIPS card is Operational on the CAM/CAS, the position of the electromagnetic switch on the FIPS card does not come into play again until you reboot either the FIPS card or the appliance.

CSCtb98457

No

Posture Assessment requirements for Vista machines results in the user being placed in the temporary role.

This has been observed in Windows Vista Home operating systems running version 4.6.2.113 of the Cisco NAC Agent.

Workaround   Disable compatibility mode for Nacagent.exe. Compatibility mode can be disabled by un-checking (disabling) the "Run this program in compatibility mode for" option in the file properties for NACagent.exe.

CSCtc00668

No

Mac Agent trying to update Avast even though application is up-to-date

Following login, the Mac Agent pops up prompting user to update "ANY" AV.

Workaround   Use one of the following options:

Stop and restart the Mac OS X Agent after installation.

Reboot the client machine.

Make the requirement optional (opens the network up to an old AV definition file version).

CSCtc01957

No

Firefox 3.5.2 Freezes and user cannot enter user credentials

After the applet loads in the Firefox browser, the user login page locks up and the user is unable to enter login credentials.This situation can occur when a user is attempting web login with a FireFox 3.5.2 browser for the very First time.

Workaround   The workaround for this issue is to minimize the Browser or open a new browser window.

CSCtc41408

No

Windows 7 tray icon default should be show icon and notifications

According to Microsoft, there is no way for a program to promote itself by setting the "Show Icon and Notifications" option. This can be done only by the user and only manually. Default behavior is to hide all icons.

Workaround   The Windows 7 client machine user can change this behavior by either drag-and-dropping the hidden icon or by changing the "Show Icon and Notifications" setting.

CSCtc46376

No

Windows WSUS update (Microsoft rules) is not working for KB890830

When a WSUS update is performed on a new installation of Windows 7 (where no updates have been applied), and the No UI option is selected for the requirement, the WSUS update can fail.

The portion of the Windows update that fails to install is the KB890830 update (Windows Malicious Software Removal Tool, http://support.microsoft.com/?kbid=890830). This upgrade must be installed with admin privileges and there is a one time EULA that the user must accept during installation.

After KB890830 is installed, there are monthly updates that are pushed out from Microsoft on patch Tuesday. The subsequent updates of KB890830 do not require admin privileges and they work fine on a client where the user is not a member of the admin group.

If users manually install KB890830 on a client system as a non-admin user using Windows Update, they are prompted for the administrator password and then get the EULA.

Workaround   Ensure new installations of Windows are brought up to date by a user with administrator privileges prior to turning the client machine over to users without administrator privileges.

CSCtc52252

No

Cannot uninstall the Agent using MSI executable with full quiet mode selected

If you open a Command Prompt window and run the MSI install/uninstall commands using the quiet option, the command fails.

Workaround   You must open the Command Prompt window using the "Run as Administrator" option, even if you are administrator on the system.

CSCtc59248

No

The Agent does not launch if IE has never been launched or the CA certificate is not installed

The Cisco NAC Agent login window does not pop up (or takes a long time to pop up) during initial login because:

The CA cert that signs the CAS server cert has not been installed

IE has never been launched before by the user

This problem could also occur when the administrator kicks the user out of the NAC Appliance network after logging in via and OOB session.

Workaround   - Deploy the CA cert that signs the CAS server cert before user loges in and instruct the user to start IE after experiencing this problem.

Note The Cisco NAC Agent running in a Windows 7 environment allows the user to install the CA certificate at initial login.

CSCtc66277

No

IP refresh takes a minute and Agent vanishes after that

This issue can come up in a network where spanning tree merge has been configured on the switch. Configuring portfast minimizes the IP refresh time.

Note Cisco recommends enabling port-fast switch configuration whenever appropriate to do so.

CSCtc68565

No

Web Agent does not launch using ActiveX on a client machine where the administrator UAC is "default"

When using Windows 7 as a local machine administrator and a proxy server, Internet Explorer places the CAS into the intranet settings category, which automatically disables "Protected Mode."

Workaround   Enable "Protected Mode" in Internet Explorer for intranet sites.

CSCtc84563

No

Clean Access Agent does not register dynamic DNS after authentication

Computers running the Clean Access Agent register with dynamic DNS upon system startup, but they are not re-registered after they are moved to the production VLAN upon successful authentication and posture assessment.

Workaround   Manually issue "ipconfig /register"

CSCtc86765

No

The Cisco NAC Agent does not pop up in a VPN environment upon re-connecting to the VPN server

This issue has been observed when power cycling a SOHO (Small office home office) DSL/Cable modem router, thus terminating the VPN connection.

Workaround   Exit and re-launch the Cisco NAC Agent.

CSCtc90896

No

For McAfee Total Protection 5.0, you need to change firewall setting

AV definition file update for McAfee Total Protection 5.0 does not work with the default McAfee firewall settings.

Workaround   For AV definition file update to work for McAfee Total Protection 5.0, you need to change the McAfee firewall setting from "Untrusted Network" to "Trusted Network" or "Custom" and allow the McAfee program to access the update site.

CSCtc90964

No

Inaccuracy in AV/AS support info

Latest Virus Definition version/date for Selected Vendor under AV/AS support info does not display the updated version/date for some AV/AS vendors.

CSCtc91616

No

Inconsistent support for Internationalized characters in usernames

It is unclear if Internationalized characters are supported for uncommon user names in Cisco NAC Appliance. For example, some internationalized characters (like è) are allowed when creating a username on the CAM, but user login fails. Other character sets (like Japanese) also fail when attempting to create the user in the Local DB.

CSCtc92037

No

Mac agent in L2 non-strict mode does not pop up behind NAT router.

With L2 non-strict mode and Mac client behind NAT router, Mac agent does not pop up.

Note There is no known workaround for this issue.

CSCtd04881

No

Serbian web install shows error and installer is English

A popup window appears with an error message in Serbian, which approximately translates to, "Writing error in applied transformation. Recommend to use a valid transformation path."

After clicking OK the installer launches in English, yet the application launches and is fully functional in Serbian.

Note There is no known workaround for this issue.

CSCte55522

No

The Cisco NAC Agent for Release 4.7(2) does not update ZoneAlarm 7.1.078.000 in Windows Vista Ultimate

This particular update works in Windows Vista Ultimate SP0.

Workaround   The user can upgrade to ZoneAlarm Version 8 when running Windows Vista Ultimate SP1.

CSCte64337

No

Unexpected switch to UDP discovery mechanism

There are unexpected SSM events found in the Agent log. These events are caused by unexpected switch to UDP discovery after SwissUdpExchange starts sending Swiss requests.

CSCte76636

No

L3 MAC unable to refresh on Vista (32-bit/64-bit) w/ UAC w/o port bounce

Windows Vista users are not able to get an IP address from the DHCP pool for the access VLAN with web login or web agent.

Workaround   Run the browser (Internet Explorer or Firefox) as administrator.

CSCtf02702

No

After deleting and re-adding a CAS, the CAM web console displays that AD SSO is started

This issue does not impact Cisco NAC Appliance functionality. After deleting and re-adding a CAS, the administrator must also reboot the CAS. Once you reboot the CAS (or perform "service perfigo restart"), everything works as designed.

Workaround   Restart the CAS to avoid this symptom appearing.

CSCtf69345

No

Agent reports incorrect update details for McAfee 8.7.0i on Win7 x64

NAC Agent reports incorrect McAfee virus definition update date and version, while McAfee shows the right date.

This occurs because Windows registry is blocked with permissions issue and prevents McAfee from overwriting the appropriate date and version information to registry.

Workaround   Perform the following steps:

1. Uninstall McAfee.

2. Delete the following key and sub keys from registry:
HKEY_LOCAL_MACHINE\SOFTWARE\McAfee

3. Re-install McAfee and confirm that the entry is recorded in the registry with proper details.

4. Perform updates in McAfee.

5. Verify that both NAC Agent and McAfee show the same dates and definition versions.

CSCtf99678

No

Enable OOB logoff msg for Windows not grayed out in Firefox browser

The Enable OOB logoff for Windows NAC Agent and Mac OS X Agent checkbox is not grayed out in Mozilla Firefox version 3.5.8, even with the "Use 'WINDOWS_ALL' settings for this OS version" option checked.

Note This issue appears in Mozilla Firefox and has not been observed in other browser types.

CSCtg01263

No

Invalid provider name seen between multi-NIC transition with OOB Logoff

This problem is happening because while the role based (with IP refresh) wired NIC is transition from logged in, through IP refresh on logout, then the wireless NIC has the better metric so the wireless side responds, once the ip is refreshed on the wired side an invalid provider is seen and then wired login continues normally.

CSCtg06599

No

IP refresh on Win 7 after successful auth is very slow

After a successful login, it takes 1-4 minutes for a machine to complete the IP refresh. This happens with Windows 7 and Vista machines moving from authentication to access networks (with an IP address change).

This occurs because the Network Connectivity Status Indicator, which is part of the Network Location Awareness in Windows, tries to reach the msftncsi.com web page while performing IP refresh. If it is not able to reach this website, then Microsoft takes longer to sense the machine's status and results in slower applications that require internet access.

For more information, see Known Issue with Delayed IP Address Refresh for Windows 7/Vista Clients Running Cisco NAC Agent.

CSCtg39044

No

Running Internet Explorer in offline more effects Cisco NAC Agent auto-upgrade function

When users access the network via Internet Explorer in offline mode, the Cisco NAC Agent auto-upgrade function does not work correctly for Agent versions 4.7.2.10 and earlier. The login session appropriately prompts the user to upgrade the Agent, but clicking OK brings up the login screen instead of launching the Agent installer.

CSCtg45522

No

Delay in Agent logging out in Vista 64-bit

Found that after authentication when click logout on a Vista 64bit machine, it takes a while before CAM receives the logout message and hence client takes a while to switch back from access to auth.

CSCtg45741

No

IP address release takes a while in Windows 7 32-bit using taskbar logout option

IP release takes a long time to complete on Windows 7 32-bit clients for Cisco NAC Agent. As a result, the delay between release and renew is around 50sec.

CSCtg45753

No

Cisco NAC Agent won't pop-up with multi-NIC same metric /auth/discovery 404

This issue can occur when Agent runs on a client machine with two NICs using the same metric. (For example, the wired interface has NAC, while the wireless interface has no NAC.)

Note This was observed on 100MB wired and 300MB wireless interfaces where the wireless speed signal dropped close to 100 resulting in two NICs with the same metric.

CSCtg57758

No

Error in Mac OS X Agent while editing Filters

CSCtg61995

No

Mac OS X Agent SWISS discovery back-off algorithm

When Mac Agent is not connected to a NAC network, the Agent will never give up on trying to contact the last known CASes. It will continuously send UDP SWISS packet every ~17 seconds forever.

CSCtg65859

No

The Cisco NAC Agent is not able to logout in an OOB deployment

When the user performs web login and then launches the NAC Agent (or closes the NAC Agent dialog window if already launched), and then tries to log out using the NAC Agent in an OOB environment, the NAC Agent is not able to log out. This happens because OOB Logoff is not supported for Web Agent login.

Workaround   Use the Cisco NAC Agent to log in to such networks.

CSCtg69836

No

HTML Canned Report Missing AV gives blank report, but is ok for PDF

CSCth00256

No

Cert error seen on Mac Agent during login on multinic setup

After importing self-signed certificate in the trusted Root CA on Mac OSX client machine, while logging in using wireless, a message pops up stating that the certificate is incorrect.

Workaround   When the Agent login fails for the first time and the Agent pops up again, try logging in again by entering user credentials and user should be able to login.

CSCth17804

No

VPN SSO presents a blank Cisco NAC Agent login dialog

Following a VPN disconnect, the client machine renegotiates for VPN to connect through the network and the user is presented with a blank Agent login dialog.

CSCth60233

No

Windows IP Refresh not working properly after user logoff

This issue has been observed on both Windows XP and Vista client machines—the Agent is not releasing the IP address.

Workaround   Manually refresh the IP address on the client machine.

CSCth61503

No

Duplicate kernel status message appears during CD installation

The "Memory for crash kernel (0x0 to 0x0) not within permissible range" message appears twice in a row during CD installation.

CSCth73166

No

Remediation and login screens are still displayed after network change

The Agent displays these screens indefinitely (or until the remediation timer expires) after removing the network cable or changing networks while the Agent login or remediation screens are active.

Workaround   Click Cancel on the login page or click Complete on the remediation screen.

CSCth73774

No

McAfee Virus scan 14.0 remediation fails

This issue has been observed during client remediation of McAfee VirusScan 14.0.

Workaround   Set McAfee to automatically update during the time the user is logged in. (The user can also manually update while logged in or while in the Agent Temporary role.)

CSCth85390

No

Certificate dialog appears multiple times when certificate is not valid

Workaround   Ensure valid certificates are available on the client machine.

CSCth85833

No

The Cisco NAC Agent tool-tip indicates logged-in long after VPN disconnect

This issue has been observed performing VPN SSO via the Cisco NAC Agent on Windows 7 client machines.

Note This issue has no impact on system functionality.

CSCth88009

No

The Mac OS X Agent's Popup Login Window option does not work during SSO

CSCth98219

No

Agent appears when user is logged in via restricted network access role

When a user logs into an Out-of-Band network and accepts Restricted network access after failing a mandatory requirement. the Cisco NAC Agent appears a second time (and continues to appear each time) when the user either logs in again without remediating, or closes the Agent login dialog.

Workaround   The Cisco NAC Appliance administrator can manually add text to the Restricted Access dialog box advising the user to iconize the Agent and must perform manual remediation. Once the user remediates the client machine, they can double-click the Agent icon and log in again.

CSCti03955

No

The Agent login dialog becomes unresponsive when the Temporary role timer runs out

This situation can occur if the Temporary role timer expires during a long remediation like WSUS or AV/AS update.

Workaround   To avoid this issue, make sure the Temporary role timer is set to a value that will not expire during "worst case" remediations.

Note If this problem occurs, users can clear the NAC Agent login dialog by selecting Exit from the Cisco NAC Agent systray icon or rebooting the client machine. If the user chooses to Exit, the user must also then manually launch the Cisco NAC Agent again.

CSCti35086

No

Disable Fast SSID change for NAC Wireless OOB setup

Wireless clients without the Cisco NAC Agent installed can associate to a "guest" WLAN where NAC is not enabled.

When FAST SSID Change is enabled globally on a Wireless LAN Controller, wireless clients (without the Cisco NAC Agent installed can then disassociate from the "guest" WLAN and immediately associate to the corporate WLAN (where NAC functionality is enabled), resulting in the client machine being placed directly into the network Access VLAN without being redirected to the Quarantine role.

Workaround   Disable the Fast SSID function on the Wireless LAN Controller.

CSCti68556

No

Device MAC address is not added to the filter

Under Device Management > Clean Access > General Setup > Web Login, if Exempt certified devices from web login requirement by adding to MAC filters is checked for MAC_ALL OS, the client MAC address fails to get added to Filters list.

CSCtj07399

No

Clean Access Mac Agent doesn't always recognize AV Definition Updated

When Mac OSX user is connecting to Clean Access without AV installed, the Agent detects that the user fails the check. It detects when the Anti Virus is installed. But, when the Anti Virus signatures are updated, it is not detected by the Agent.

Workaround   Restart the Agent after the AV installation and AV definition requirements have been met and then the user is authenticated.

CSCtj10001

No

NAC Agent GUI pops up on unmanaged port

The NAC Agent may popup on an unmanaged port with the following message:

"Unable to process out-of-band login request from MAC Add ## IPAddress] reason: [IP] port [Gi2/0/30] is not managed"

Workaround   Apply an ACL to the client VLAN blocking UDP 8905 and 8906 to the CAS.

CSCtj53399

No

Clean Access Server can bridge traffic in RIP mode

There are intermittent issues in which traffic is bridged across a Clean Access Server in RIP mode. Despite being in routed mode, the CAS bridges traffic on the native VLAN, arriving to the CAS untagged.

Workaround   Explicitly configure the native VLAN on the switch interface connected to the CAS to a disabled / unused VLAN.

CSCtj59983

No

Exporting reports behavior inconsistent with filters

When trying to export reports from Clean Access, using any criteria except "is" or "is not" provides false results. The GUI shows the correct results when using any criteria, but the export option downloads all the records and the filter is not applied.

Workaround   Use the "is" or "is not" criteria while exporting the reports.

CSCtj65580

No

DHCP Requests Fail After Failover to Secondary CAM

In HA setup, when DHCP is working failover to secondary, DHCP Requests are not sent or answered through CAS.

CSCtk13370

No

HTC Pure and Blackberry 9700 detected as Windows_All

The HTC Pure and Blackberry 9700 are detected as Windows_All. These phones are not able to run the NAC Agent, so they should be detected as ALL.

Workaround   Add the MAC addresses of the phones to the MAC filter list to exempt the phones from NAC.

CSCtk57221

No

CDL timer getting killed when configured CAS status is down

Certified Device List timer on CAM may fail to start at configured time causing no certified devices to get cleared. Once this problem occurs the timer will no longer run and hence the certified devices will not be cleared until one of the following workarounds is performed.

Workaround   Perform any one of the following:

Re-edit the timer to set a new start time and it should kick in again at that point, but the issue may likely re-occur.

Delete the disconnected CAS from the CAM.

CSCtk65718

No

Need procedure for adding RMA unit with OOB setup

When replacing RMA (stand by unit), active unit must be rebooted as part of the replacement procedure. Some clients may get in access VLAN or auth VLAN depending on prior setting of the switch. When CAM becomes active, clients will not be placed in correct VLAN that are in the access VLAN already. This occurs when both CAMs are down.

Workaround   Perform the following:

Reboot the switch to which the clients are attached.

Bounce the ports of the effect clients and the switch.

Clear the dynamic MAC address on the switches.

CSCtl06228

No

Abnormal behavior when "Restricted Network Access" is clicked

In OOB deployment, while downloading the NAC Agent, when the "Restricted Network Access" button is clicked, the NAC Agent keeps on popping up showing the following message:

"You have only restricted network access"

CSCtl11411

No

Redirect delay setting does not take effect when using Web Agent

Advanced SNMP setting "Redirection Delay with bouncing" does not take effect for clients running the web agent and performing posture assessment. This can cause the clients to get redirected to a "Page cannot be displayed" message after logging in if the setting under the user role is set to redirect to a URL.

Workaround   

Disable Posture assessment and use the normal web login process.

Switch to no port-bouncing in the profile and let the web client release and renew the IP address. This switches over to the redirection delay without bouncing timer and the web client will not move on to that step until it releases and renews the IP address of the client.

CSCtl42765

No

CAM Admin group policies missing option for "Reporting" page

If the Admin users are setup to have read-only access to any configuration, but need to allow them to run Reports from the Monitoring > Reports page, there is no method available to configure this option.

Workaround   

The Reporting page access is controlled by the "CCA Servers" option under Device Management. So to minimize the permissions given, and still be able to run Reports, the following configuration will work.

Create an Admin Group with "view only" for all the Clean Access Servers options, and under Module Features set everything to "read only" except for the option "CCA Servers:". Set that to "add-edit".

As long as the individual CASs themselves are set to "view only" the users cannot delete or make any changes to them, but they would be able to perform two admin-like operations on the CAM with this permission set.

1) Add a new Clean Access Server.

2) Enable/Change CCA Server Authorization.

CSCtl59461

No

CAM shows old AV dates even with latest checks set

Even if the CAM Updates are pulling down the latest Checks & Rules, the CAM still shows the latest definition dates for many vendors like AVG, Microsoft, McAfee, and Symantec

Workaround   Perform a clean update which deletes all Cisco checks and re-downloads all of them from the server. The Update number will be the same, but the correct dates will be stored in the CAM. To perform a clean update, in the CAM web console, navigate to Device Management > Clean Access > Updates > Update and click Clean Update.

CSCtl85558

No

Nessus scanning doesn't finish completely and doesn't generate logs

When Nessus scanning is enabled for web-logins, the scan is not completed and no logs are generated in the NAC.

Workaround   Instead of Nessus scanning, web agent can be used.

CSCtl86020

No

Certificate details showing up blank when viewed from CCA device

When the subject line of the certificate contains certain alphanumeric characters, the NAC GUI does not detect them correctly and the certificate details are shown as blank when viewed through the GUI. The functionality of the certificate is not affected, but details are not displayed properly.

Workaround   View the details using openssl command line tool.

CSCtn17223

No

DHCP Option 82 not correctly returned by NAC DHCP Server

DHCP Snooping will not work with the NAC Server acting as a DHCP Server. The switch is seen adding option 82 to the Discover and Offer, but the NAC Server does not add option 82 to the lease and does not return option 82 in the Offer.

Workaround   Use a third party DHCP server instead of using the NAC Server.

CSCtn32436

No

Enable User Activity Logging causes load spike on CAM

When "Enable User Activity Logging" is enabled the CAM's postmaster process causes the load on the CAM to raise to the point where users are no longer able to login.

Workaround   Disable the "Enable User Activity Logging" and reboot the manager for the load to become normal.

CSCtn90845

No

After upgrading from 4.8 to 4.8(1), the Failover tab no longer displays the warning if heartbeat timeout is less than the Link-detect timer. This warning was displayed prior to the releases 4.8.

CSCtn93513

No

Restricted VLAN IPs are not NACed correctly

When the "Restrict range to VLAN ID" option is checked, the CAS is not NACing requests for IPs from users in the wrong VLAN.

CSCto25245

No

Running AV/AS canned reports gets hung for ever and stops HA sync

Canned reports for AV/AS information hang and crash HA.

CSCto49390

No

NAC Agent 4.8.1.5 takes long time to login

NAC Agent 4.8.1.5 takes long time to login when used with Symantec Endpoint Protection, v11

CSCto54241

No

OUL is not updated when mac-move trap hits the CAM.

This is only a cosmetic issue as the CAM kicks the user off on the correct port.

CSCto55879

No

Unable to extract CAM backups on 4.8

Not able to extract the Manager database from the tar.gz backup file produced by utilizing the "Create Snapshot" option.

CSCto76408

No

When CA eTrust PestPatrol Anti-Spyware 8.x is updated, the definitions are not detected.

Workaround   Reboot the client system and re-initialize the PestPatrol software.

CSCto91195

No

CAM syslog stops sending messages after being heavily loaded

When a large amount of data (> 200k) is sent to syslog, the Manager stops sending data. It does not recover from this situation on its own and requires a restart of services to restore syslogging.

Workaround   

Manual restart of service on the Manager restores syslogging.

If the issue is triggered by a large purge of the CDL, configure the Manager to clear 60 or fewer CDL entries per minute. This can be done within the Certified Device List Timer by setting to clear the oldest 60 devices every minute, until all matching devices are cleared.

CSCtj81255

No

Two MAC addresses detected on neighboring switch of ACS 1121 Appliance.

Symptom    Two MAC addresses are detected on the switch interface connected to an ACS 1121 Appliance although only one interface is connected on the ACS 1121 Server eth 0.

Conditions   Only one Ethernet interface, eth 0 is connected between ACS and Switch.

Workaround   Disable BMC (Baseboard Management Controller) feature using BIOS setup.


Caution To help prevent a potential network security threat, Cisco strongly recommends physically disconnecting from the Cisco NAC console management port when you are not using it. For more details, see http://seclists.org/fulldisclosure/2011/Apr/55, which applies to the Cisco ISE, Cisco NAC Appliance, and Cisco Secure ACS hardware platforms.

CSCub01401

No

Mac OS X Agent fails to get installed for Mac OS X 10.8 client, when MAC App Store and identified developers is selected in the Security & Privacy Preference settings.

Workaround   In the Security & Privacy Preference settings, select Allow from Anywhere.

CSCuh81091

No

NAC ADSSO - 2012 server with 2003 functional level is not supported

Cisco NAC Appliance does not support Microsoft Active Directory 2012 server at 2003 functional level for ADSSO.

CSCui06972

No

NAC ADSSO is not happening in 4.8.3 server

AD SSO does not function with Microsoft Active Directory 2003 server.


Resolved Caveats - Release 4.8(3)

Refer to Enhancements in Release 4.8(3) for additional information.

Table 6 List of Resolved Caveats (Sheet 1 of 8)

DDTS Number
Software Release 4.8(3)
Corrected
Caveat

CSCtd14712

Yes

CAS info missing from new Active CAM when master secret different

When the master secret is different on two CAMs in an HA deployment, some critical CAS information may be missing on the secondary (standby) node.

Workaround   Restore the correct master secret on the incorrect CAM.

CSCtn47794

Yes

VLANDetectWithoutUI does not function on initial boot.

VLANDetectWithoutUI parameter allows VLAN detection to continue running when NACAgentUI.exe is closed or the user logs off.

Workaround   Bounce the port or log into the system to allow user level VLAN detect to function.

CSCtn19754

Yes

Client cannot log in, despite being present in CAS OOB OUL.

OOB users may randomly fail to connect to the network. Device is not in CDL or OUL of the CAM, however remains in the OUL of the CAS.

Workaround   Rebooting the active CAS clears the devices from the CAS OUL.

CSCtl83172

Yes

Logging failure in CCA Manager.

When Clean Access Manager is running all logging at "TRACE", logging stops in /perfigo/control/tomcat/logs.

Workaround   Restart the CAM.

CSCtl24190

Yes

Messages in CAS console when upgrading from 4.7.3 to 4.8.1

While upgrading NAC version 4.7(3) to 4.8(1), the following message is displayed in the CAS web console:

"value missing in 'icmp type' directive"

Note The upgrade happens successfully, and the messages can be ignored.

CSCtc97878

Yes

CCA CAS can fail to commit large policy list to click.

When Cisco Clean Access environment is configured with several rules in the user roles, a threshold may be reached where traffic is blocked at the CAS that is specifically allowed in the rules. This can result in undesired and unpredictable behavior.

Workaround   Reduce the number of rules configured in the user roles and/or summarize them.

CSCso15754

Yes

ClamXAV updates are not getting detected for first time.

ClamX AV Live update may not work for the first time if there is a "ClamXav install" failing requirement before the live update while performing the remediation.

Workaround   The user may need to click on the remediation button twice when the user sees these two failing requirement in the assessment report table after the login authentication. Another workaround is to use one requirement instead of two. ClamxAV update rule normally contains both install and update checks. Thus, admin does not need to create two separated requirements.

CSCtr39586

Yes

CAS continuously in sync-ing state after CAM failover.

During scheduled restart of CAS, the CAS hangs while synchronizing with the CAM.

Workaround   Restart CAS server.

CSCtq74462

Yes

CAS cannot block CAM configuration update even if SSKEY mis-match occurs.

When SSKEY mis-match occurs between CAM and CAS, CAS should deny configuration updates from CAM. But CAS accepts the configuration updates from all CAMs, even if the CAM DB is not updated with the SSKEY.

Workaround   When the CAS configuration is updated with mis-matched SSKEY, manually remove the CAM that is not updated with the right SSKEY.

CSCtq10755

Yes

Directory Traversal in CCA.

Cisco Network Admission Control (NAC) Manager contains a directory traversal vulnerability that may allow an unauthenticated attacker to obtain system information.

Workaround   There are no workarounds to mitigate this vulnerability. Cisco released free software updates that address this vulnerability.

CSCtl97116

Yes

CAM recovering from heartbeat loss can publish empty click tables to CAS.

If due to network latency issues, two CAMs reach an Active-Active state (because each CAM thinks the other CAM is dead and goes active) then the previously secondary CAM (CAM-B) starts to publish information to the CASes (Click table information such as VLAN Mapping information is one such item). Before it can finish publishing this information, CAM-A is able to detect that CAM-B is up and tries to perform a database sync on CAM-B by locking its DB. On CAM-B, this locking affects the publishing that is in progress, and many "No database connections" are written to the log. Due to an erroneous code segment CAM-B publishes an empty vlan_map list to the CASes.

Workaround   Stop perfigo service on the standby CAM and start the service again.

CSCti68556

Yes

Device mac address is not added to the filter.

Customer running NAC 4.7.2(VGW/OOB/L2) and checks for Exempt certified devices from web login requirement by adding to MAC filters under Device Management/Clean Access/General for IPOD it does not add the MAC address to filter list.

Workaround   Enhancement made for OOB. Now with the exempt option check, the user's MAC address is added in device filter for OOB.

CSCtn32436

Yes

Enable User Activity Logging causes load spike on CAM.

During "Enable User Activity Logging" the postmaster process tries to make calls to the database for every user that authenticates to clean access. This causes the load on the CAM to spike to a point where the CAM is unable to authenticate users.

Workaround   Query posture report and log to UAL, so that posture assessment report is separated from UAL.

CSCtr97672

Yes

Clients are not able to get out on the network seems as if the unauth traffic policies are not allowing the correct traffic.

When static routes are configured you have to enter them using the decimal format. Entering the /nn notation causes the traffic policies fail to publish to the CAS.

Workaround   Remove the /nn entries and enter the decimal format. If running in HA mode, stop services on the standby, remove the /nn static routes form the active and replace them with their decimal equivalent. Reboot the active CAS and once it comes back up verify network is restored. Then start services on the standby. Failover and verify connectivity through standby CAS.

CSCtr94191

Yes

Managed subnets missing after upgrade to 4.8.2.

Managed subnets are missing after an upgrade to 4.8.2, if you try to re-add them you get a failed to add to database message. Also if you run showstate.sh you see the following incorrect entry: Column subnet_gateway from DB table home_subnet_info is missing or is not type character varying(64). DB schema verification failed!

Workaround   Contact Cisco TAC to fix the database.

CSCtr91526

Yes

iPads/iPods being detected as ALL after upgrade

After upgrading, iPods/iPads are no longer detected as Mac_All, but they are now detected as All. They need to be detected as Mac_All to support previous rules/login pages created by users.

CSCtr84555

Yes

Traffic policies fail to publish to CAS appliances.

Traffic policies fail to reach the CAS which causes irregular traffic patterns for clients behind the clean access network. Modifying the traffic policies to permit all traffic does not change the behavior of the traffic traversing through the CAS.

Workaround   Contact Cisco TAC to fix the database.

CSCtk00650

Yes

Defining AV def "ANY", server sending down not supported value.

Intego X6 definitions are not correctly matched even though the product is up to date. This is only seen when using any virus definition for Mac computers.

Workaround   Set up an AV Rule to look specifically for Intego X6 definitions.

CSCtk13370

Yes

HTC Pure and Blackberry 9700 detected as Windows_All

The HTC Pure and Blackberry 9700 are detected as Windows_All. These phones are not able to run the NAC Agent, so they should be detected as ALL.

Workaround   Add the MAC addresses of the phones to the MAC filter list to exempt the phones from NAC.

CSCtl83172

Yes

Logging failure in CCA manager.

Logging stops in /perfigo/control/tomcat/logs. Clean Access Manager running all logging at TRACE.

Workaround   Restart CAM.

CSCtn83657

Yes

CAS - OUL JSP throwing an exception.

The JSP to list OUL on CAS throws exception.

Workaround   None.

CSCtn89835

Yes

CAM should send SNMP SET only to ports not matching the actual configuration.

When it comes to bigger switches (for example, c6509 with multiple modules), CAM creates a large amount of unneeded traffic (SNMP SET for all the ports) and sometime it even fails to complete due to the number of ports it needs to go through. The CAM behavior should be to send the SNMP SET only for those ports that in the switch configuration are different from what configured through the CAM's GUI.

CSCtn93513

Yes

Restricted VLAN IPs are not NACed correctly.

Where "Restrict range to VLAN ID" is checked, the CAS is not NACing requests for IPs from users in the wrong VLAN.

CSCto25245

Yes

Running AV& AS canned reports gets hung for ever and stops HA sync

This is caused by large sized reports.

CSCto42040

Yes

NAC Incremental CDL timer throws ArrayIndexOutOFBounds exception

Configuring a gradual CDL clear on the NAC Manager (where you set the timer to clear a certain number of devices every minute) can cause the timer clear to fail. The nac_manager.log support file shows a error message. Also the CDL timer will not kick off on any subsequent scheduled time if the above event occurs.

Workaround   

1. Set the CDL timer to clear all devices at once.

2. Set the gradual clear to clear less than 60 devices per minute.

CSCto54241

Yes

OUL not updated after mac move trap.

When clients are plugged in behind IP phones the mac move feature allows them access to network correctly. The OUL for the user is not updated with the most recent port from which they are accessing the network.

Workaround   None. The customer needs to login to the switch and resolve the client's MAC address as an extra step in the troubleshooting process.

CSCto88332

Yes

Intermittent DHCP failure

DHCP intermittently fails under load. The CAS drops the DHCP requests.

Workaround   Off load DHCP to another CAS for load balancing or to another DHCP server altogether.

CSCtq54440

Yes

Https redirect through CAS fails with 403 forbidden error.

When accessing an HTTPS site CAS is not redirecting to the login page, but returns a 403 forbidden error.

Workaround   

1. Browse to any http resource initially and go to the desired https site after login and or remediation.

2. Browse to https://cas_ip/auth page initially, once authenticated and remediated, user can browse any of the corporate https resources.

CSCtr07636

Yes

Web GUI locked when Radius session fails to timeout.

When a admin user is configured with Radius server as authentication server and user tries to login, session is hung when there is no reply from Radius server.

Workaround   Reboot the CAM.

CSCtb70199

Yes

Redirect Blocked Request option shows incorrect page when using filter.

CAM has a custom block URL/html defined under a user role under the "Redirect Blocked Requests to" option. If the user logs in with the agent, they get put in that role, and get added to the CDL and OUL and that block page appears if they go elsewhere that is not allowed in their role. However, if the user uses a MAC filter they only get added to the CDL (as [device-filter]) and not to the OUL at all. They don't get the custom Redirect Blocked Requests code and get the default block page.

Workaround   None.

CSCtl11411

Yes

Redirect delay setting does not take effect when using Web Agent.

Advanced SNMP setting "Redirection Delay with bouncing" does not take effect for clients running the web agent and performing posture assessment. This can cause clients to get redirected to a "Page cannot be displayed" message after logging in if the setting under the user role is set to redirect to a URL (or to the original page).

Workaround   

1. Disable Posture assessment and just use the normal web login process.

2. Switch to no port-bouncing in the profile and let the web client release and renew the IP address. This switches over to the redirection delay without bouncing timer and the web client will move on to that step until it releases and renews the IP address of the client.

CSCtn17223

Yes

DHCP Option 82 not correctly returned by NAC DHCP Server.

DHCP Snooping will not work with the NAC Server acting as a DHCP Server. The switch is seen adding option 82 but the NAC Server does not add option 82 to the lease and does not return option 82 in the Offer.

Workaround   Use a 3rd party DHCP server instead of using the NAC Server.

CSCtn88160

Yes

CAM not allowing user to login after some exceptions.

The exceptions are from snmp4j library. The error is null pointer exception and in snmp4j.pendingrequest.run method. After the exception, there are lot of "Timer already cancelled" messages and user can not login. When the user saves the switch profile in the GUI, CAM starts functioning again smoothly.

Workaround   Use 1.11 release of snmp4j.

CSCtl71787

Yes

Windows Phone 7 recognized as Windows XP/2000.

Windows Phone 7 is recognized incorrectly as a Windows XP/2000 machine. Users with these phones are prompted to download the NAC agent, and are allowed into the network.

Workaround   Filter the phone to the correct role by MAC address.

CSCtv20903

Yes

iPhones/iPads failing on OS=ALL in Clean Access

After upgrading, iPods/iPads are no longer detected as Mac_All, but they are now detected as All. They need to be detected as Mac_All to support previous rules/login pages created by users.

Login fails for iPhones/iPads/iPods with the following error:

"NAC Agent/Web Agent has been configured. Access allowed from Windows and MAC clients only"

The OS is detected correctly as MAC_ALL in User Page, but even if "Require use of Agent" is unchecked in the Clean Access > General Setup > Agent Login page, the above error is displayed.

Workaround   The All OS can be configured to not require the agent. After this, change the rules that were previously on All OS to Windows_All, so that Windows users are still prompted to install the agent.

CSCtc80598

Yes

Option to Unmanage ALL Ports of a given switch

Need to have an option to unmanage all the ports in a switch.

The option Unmanage All has been included in NAC Appliance Release 4.8(3). Refer to Unmanage All Option for Switches.

CSCtr78270

Yes

Modified user-agent string fails stack signature check

It is possible to bypass the clean access requirement by modifying the user agent string in Mozilla browser, by setting the string to "iphone-os". The user gets full access to the network.

Workaround   Disable iPhone access to the network.

CSCtu13612

Yes

SNMP linkup/down and WoL causing MAC address learning issues

When Wake on LAN is enabled and SNMP Link Up/Down traps are used, while using the option "Do not bounce port to generate Linkup trap if MAC address query failed", CAM fails to read the MAC Address.

Workaround   Use MAC Address Notification traps.

CSCtu30985

Yes

Importing filters causes errors to be displayed

When adding over 300 filter entries on the CAM, the following error is displayed

An Error Occurred:

ConnectorClient not connected to RMI Connector Server

Workaround   Try to add 100 entries at a time.

CSCua09429

Yes

Include support for Windows 8 on NAC Appliance.

CSCto49390

Yes

NAC Agent 4.8.1.5 takes long time to login when used with Symantec Endpoint Protection, version 11.

CSCub23095

Yes

NAC Manager SQL Injection Vulnerability.

Workaround   Security advisory cisco-sa-20130417-nac has been released. You can download the following patch to fix this issue:

http://software.cisco.com/download/release.html?mdfid=282855549&flowid=34712&softwareid=282573326&release=4.8.3&relind=AVAILABLE&rellifecycle=&reltype=latest


Resolved Caveats - Cisco NAC Agent Vers 4.8.3.9/Mac OS X Vers 4.8.3.594

Refer to Enhancements in Release 4.8(3) for additional information.

Table 7 List of Resolved Caveats (Sheet 1 of 2)

DDTS Number
Cisco NAC Agent Version 4.8.3.9/Mac OS X Version 4.8.3.594
Corrected
Caveat

CSCtr32896

Yes

Webagent's check for requirements never ends.

Webagent check appears to be going in a never ending process on Windows-7 Enterprise and the scan does not complete. Not seen with NAC agent on the same machine.

CSCtb30416

Yes

VLAN detect does not work if Nortel VPN client is installed.

NAC Agent VLAN change detection does not work if Nortel VPN client is installed and the client does not have to be running (no VPN tunnel).

Workaround   Uninstall Nortel VPN Client.

CSCth93573

Yes

Agent UI crash.

Agent UI crashed with the following message: Faulting application nacagentui.exe, version 4.8.0.32, faulting module nacagent.dll, version 4.8.0.32, fault address 0x000847d0.

Workaround   Restart the agent and log back in.

CSCtl91166

Yes

File check with download remediation fails.

CCA Agent File check fails when file exists.

Workaround   None.

CSCtn14600

Yes

Clicking the "X" may hang the agent.

When the NW disruption notification screen is displayed, and the user clicks the Close (x) button, instead of the "OK" button, then it results in the Agent being in the "hang" state as the discovery will not occur.

Workaround   Restart the Agent.

CSCtn08809

Yes

Integrate uninstall script/application into Mac Agent

Currently there is no automated method for uninstalling the Macintosh Cisco NAC Agent.

Workaround   You can uninstall the Mac OS X Agent by running the uninstall script as follows:

Open the navigator pane and navigate to <local drive ID> > Applications.

Highlight and right-click the CCAAgent icon to bring up the selection menu.

Choose Show Package Contents and double-click NacUninstall.

This will uninstall the Agent on Mac OS X.

CSCtq08418

Yes

Unknown User Error: Regression Bug Introduced by CSCtg97488 fix.

Users get "unknown user" error.

Workaround   Use Agent 4.8.0 or Agent versions before 4.8.1.5.

CSCts35334

Yes

CCA Agent Downloading Optional Language Packs.

On certain OS' when the CAM is using a WSUS requirement pointing to Microsoft Servers to install only Critical Updates, optional language packs are being installed during remediation.

Workaround   None.

CSCtt93822

Yes

AV/AS handling should use more than ProductID for identification.

AS definition check fails on the system if MS Security Essentials and Windows Defender are installed.

Workaround   None.

CSCty39040

Yes

VLAN Detect doesn't detect network interface, NAC Agent 4.8.3

When a client having 4.8.3 Agent is connected to a NAC 4.8.2 Appliance, it is not authenticated properly. VLAN Detect is not detecting the network interface.

CSCtz23958

Yes

ENH: NAC agent in L3-OOB is not compatible with Citrix VPN Client

When VLAN Detect is enabled, Citrix VPN connections do not connect if NAC agent is running on PC.

Workaround   

If clients are not behind IP phones, then disable VLAN Detect.

Close NAC Agent from the taskbar, before connecting to VPN. This requires the traffic to VPN endpoint to be enabled in unauthenticated role.


New Installation of Release 4.8(3)

The following steps summarize how to perform new CD software installation of Release 4.8(3) on supported Cisco NAC Appliance hardware platforms (see Release 4.8(3) and Hardware Platform Support for additional support details).

To upgrade on an existing Cisco NAC Appliance, refer to the instructions in Upgrading to Release 4.8(3).


Note The click in the NAC is configured with default settings like default priority, CPU usage etc. The driver loop of the click thread uses the full CPU whenever other processes are idle. The CPU usage of click can reach 99%. As the thread runs with default priority, other processes like tomcat can take over whenever requests come for them. The high CPU usage of click will not lead to any performance issues.


For New Installation:

With Release 4.8(3), installation occurs in two phases:

1. The software is installed from the CD, and when complete, the CD is ejected from the appliance.

2. The admin logs in and performs the initial configuration.


Step 1 If you are going to perform a new installation but are running a previous version of Cisco NAC Appliance, Cisco recommends backing up your current Clean Access Manager installation and saving the snapshot on your local computer, as described in General Preparation for Upgrade.

Step 2 Follow the instructions on your welcome letter to obtain product license files for your installation. See Licensing for details. (If you are evaluating Cisco Clean Access, visit http://www.cisco.com/go/license/public to obtain an evaluation license.)

Step 3 Install the latest version of Release 4.8(3) on each Clean Access Server and Clean Access Manager, as follows:

a. Log in to the Cisco Software Download Site at http://www.cisco.com/public/sw-center/index.shtml. You will likely be required to provide your CCO credentials.

b. Navigate to Security > Access Control and Policy > Network Admission Control > Cisco NAC Appliance > Cisco NAC Appliance 4.8.

c. Download the latest Release 4.8(3) .ISO image (e.g. nac-4.8_3-K9.iso) and burn the image as a bootable disk to a CD-R.


Note Cisco recommends burning the .ISO image to a CD-R using speeds 10x or lower. Higher speeds can result in corrupted/unbootable installation CDs.


d. Insert the CD into the CD-ROM drive of each installation server, and follow the instructions in the auto-run installer.

Step 4 After software installation, access the Clean Access Manager web admin console by opening a web browser and typing the IP address of the CAM as the URL. The Clean Access Manager License Form will appear the first time you do this to prompt you to install your FlexLM license files.

Step 5 Install a valid FlexLM product license file for the Clean Access Manager (either evaluation, starter kit, or individual license).

Step 6 At the admin login prompt, login with the web console username and password you configured when you installed the Clean Access Manager.

Step 7 In the web console, navigate to Administration > CCA Manager > Licensing to install any additional license files for your CASs, CAM HA pairs or CAS HA pairs. You must install the CAS license to add the CASs to the CAM and an OOB CAS license to enable OOB features on the CAM.

Step 8 Perform initial configuration of your CAM/CAS according to the instructions in the Cisco NAC Appliance Hardware Installation Guide, Release 4.8.

For additional information on configuring your deployment, including adding the CAS(s) to the CAM, refer to the following guides:

Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3)

Cisco NAC Appliance - Clean Access Server Configuration Guide, Release 4.8(3)



Note As of Release 4.7(0), Cisco NAC Appliance no longer contains the "www.perfigo.com" Certificate Authority in the .ISO or upgrade image. Administrators requiring the "www.perfigo.com" CA in the network must manually import the CA from a local machine following installation or upgrade to Release 4.8.

In order to establish the initial secure communication channel between a CAM and CAS, you must import the root certificate from each appliance into the other appliance's trusted store so that the CAM can trust the CAS's certificate and vice-versa.



Note Clean Access Manager 4.8(3) is bundled with version 4.8.3.9 of the Cisco NAC Agent and version 4.8.3.594 of the Mac OS X Agent.



Note Cisco NAC Appliances assume the keyboard connected to be of US layout for both direct and IP-KVM connections. Use a US layout keyboard or ensure that you know the key mapping if you are connecting a keyboard of different layout.


Upgrading to Release 4.8(3)


Note To upgrade from Cisco NAC Appliance Release 4.1(8) or earlier to Release 4.8(3), you must first upgrade your system to Release 4.6(1), 4.7(x), or 4.8 and then upgrade to Release 4.8(3).


This section provides instructions for how to upgrade your existing supported Cisco NAC Appliance platform to Release 4.8(3). If you need to perform a new CD software installation, refer instead to New Installation of Release 4.8(3).

Refer to the following information prior to upgrade:

Paths for Upgrading to Release 4.8(3)

Changes for 4.8(3) Upgrade

General Preparation for Upgrade

Upgrade Instructions for Standalone Machines

Upgrade Instructions for HA Pairs


Caution During the upgrade process, new users will not be able to log in or authenticate with Cisco NAC Appliance until the Clean Access Server reestablishes connectivity with the Clean Access Manager.


Note Cisco NAC Appliance 4.8(3) release includes Cisco NAC Profiler Collector version 3.1.0.24 by default. When upgrading the CAS to a newer Cisco NAC Appliance release, the current version of the Collector is replaced with the default version of the Collector shipped with the Cisco NAC Appliance release. For example, if you are running Release 4.8 and Collector 3.1.1, and you upgrade to NAC 4.8(3), the Collector version gets downgraded to 3.1.0.24. Refer to the Release Notes for Cisco NAC Profiler for software compatibility matrixes and additional upgrade and product information.


Paths for Upgrading to Release 4.8(3)

Depending on the type of upgrade you are performing, use one of the following sets of guidelines to successfully upgrade your Cisco NAC Appliance release image, Cisco NAC Appliance hardware, or both:

Migrating from Customer-Supplied Hardware to Release 4.8(3) on a NAC-3310/3350/3390 Platform

Upgrading an Existing NAC-3310/3350/3390 Platform to Release 4.8(3)

Migrating from a NAC-3310/3350/3390 Platform to Release 4.8(3) on a NAC-3315/3355/3395 Platform


Note If you are upgrading from an earlier Cisco NAC Appliance release on non-Cisco hardware to a next generation Cisco NAC-3315/2255/3395 platform, you must use the new Cisco Migration Utility available on CCO and follow the migration instructions in Cisco NAC Appliance Migration Guide - Release 4.1(8) to Release 4.7(0) and then upgrade your system(s) to Release 4.8 according to the guidelines in Upgrade Instructions for Standalone Machines.


Migrating from Customer-Supplied Hardware to Release 4.8(3) on a NAC-3310/3350/3390 Platform


Note This procedure only applies to customers upgrading non-Cisco hardware to NAC-3310/3350/3390 platforms.


If you are running the Cisco NAC Appliance software (Release 4.1(x) or earlier) on a non-Cisco NAC Appliance platform, you must purchase Cisco NAC Appliance hardware before you can upgrade your system to Release 4.6(1) or later. You may additionally need to obtain proper FlexLM product licenses. Once you obtain your new Cisco NAC Appliance hardware, Cisco recommends that you:


Step 1 Create a backup snapshot for the current software version you are running (e.g. 4.1(x) or earlier).

Step 2 Download and install the same software version on your new Cisco NAC-3310/3350/3390 platform.

Step 3 Restore the snapshot to your new Cisco NAC Appliance.

Step 4 If necessary (depending on your existing release version), upgrade your appliance to 4.0(x) or 4.1(x) and then to Release 4.6(1) or 4.7(x).


Note If you are upgrading from a much older version of Cisco Clean Access, you may need to perform an interim upgrade to a version that is supported for upgrade to Release 4.8. In this case, refer to the applicable Release Notes for upgrade instructions for the interim release. Cisco recommends to always test new releases on a different system before upgrading your production system.


Step 5 Follow the guidelines in Upgrade Instructions for Standalone Machines or Upgrade Instructions for HA Pairs (depending on your deployment) to upgrade Cisco NAC Appliance from Release 4.6(1), 4.7(x), or 4.8 to Release 4.8(3).

Step 6 Create a backup snapshot of your upgraded system.


Upgrading an Existing NAC-3310/3350/3390 Platform to Release 4.8(3)


Note This procedure only applies to customers upgrading their existing NAC-3310/3350/3390 platforms to Release 4.8(3).


The Release 4.8(3) .ISO installation/upgrade image only supports upgrade from Release 4.6(1), 4.7(x), and 4.8. If you are running an older software version (e.g. Release 4.1(8) or earlier), you must first upgrade your system to one of the supported base releases for Release 4.8(3) upgrade.


Step 1 Ensure you have upgraded to Release 4.6(1), 4.7(x), or 4.8 and create a backup snapshot for your system.

Step 2 Follow the guidelines in Upgrade Instructions for Standalone Machines or Upgrade Instructions for HA Pairs (depending on your deployment) to upgrade Cisco NAC Appliance from Release 4.6(1), 4.7(x), or 4.8 to Release 4.8(3).

Step 3 Create a backup snapshot of your upgraded system.


Migrating from a NAC-3310/3350/3390 Platform to Release 4.8(3) on a NAC-3315/3355/3395 Platform


Note This procedure only applies to customers upgrading from NAC-3310/3350/3390 (non-FIPS) platforms to a next generation (NAC-3315/3355/3395) platform and assumes you are upgrading from Release 4.6(1), 4.7(x), or 4.8 to Release 4.8(3).


If you are running the Cisco NAC Appliance software (Release 4.1(x) or earlier) on a NAC-3310/3350/3390 platform and are planning to upgrade to next generation NAC-3315/3355/3395 hardware you must first upgrade your existing system to Release 4.6(1) or later before shifting to a new hardware platform. You may additionally need to obtain proper FlexLM product licenses for your new hardware before upgrading, as well. Once you obtain your next generation NAC-3315/3355/3395 hardware, Cisco recommends that you:


Step 1 Ensure you have upgraded to Release 4.7(0) and create a backup snapshot for your system.

Step 2 Download and install the same (Release 4.7(0)) software version on your new NAC-3315/3355/3395 platform.

Step 3 Restore the snapshot from your existing NAC-3310/3350/3390 to your new NAC-3315/3355/3395 hardware.

Step 4 Follow the guidelines in Upgrade Instructions for Standalone Machines or Upgrade Instructions for HA Pairs (depending on your deployment) to upgrade Cisco NAC Appliance from Release 4.7(0) to Release 4.8.

Step 5 Create a backup snapshot of your upgraded system.


Changes for 4.8(3) Upgrade

Cisco NAC Appliance Release 4.8(3) is an Early Deployment software maintenance release. Cisco strongly recommends to test new releases on a pilot system prior to upgrading your production system.

If planning to upgrade to Cisco NAC Appliance Release 4.8(3), note the following:

Hardware Considerations

Upgrade Changes

Features That May Change With Upgrade

Password Changes

Hardware Considerations

You can install Cisco NAC Appliance Release 4.8(3) on the following Cisco NAC Appliance platforms:

NAC-3315, NAC-3355, and NAC-3395 (FIPS or non-FIPS mode)


Note Next generation Cisco NAC Appliance platforms (FIPS or non-FIPS Cisco NAC-3315, NAC-3355, NAC-3395) support fresh installation of Release 4.8(3) or upgrade from Release 4.7(x) or 4.8 to Release 4.8(3) only.


NAC-3310, NAC-3350, and NAC-3390 (non-FIPS mode only)

You cannot install any Cisco NAC Appliance release other than Release 4.7(0) or later on the NAC-3315, NAC-3355, and NAC-3395. You cannot upgrade to or install Release 4.6(1) and later on any non-Cisco platform. See Hardware Support for additional details.

If performing CD software installation on a NAC-3310 based appliance which is not reading the software on the CD ROM drive, refer to Known Issue with Cisco NAC Appliance CAM/CAS Boot Settings.

Upgrade Changes


Warning If your previous deployment uses a chain of SSL certificates that is incomplete, incorrect, or out of order, CAM/CAS communication may fail after upgrade to Release 4.6(1) and later. You must correct your certificate chain to successfully upgrade. For details on how to fix certificate errors on the CAM/CAS after upgrade to Release 4.6(1) and later, refer to the How to Fix Certificate Errors on the CAM/CAS After Upgrade Troubleshooting Tech Note.

Starting from Release 4.7(1), the upgrade process now warns the administrator if the uploaded file for a "File Distribution" requirement type in the CAM database exceeds 50MB. If file size is too large, the upgrade process returns a warning to the administrator, aborts, ejects the Release 4.8(3) .ISO CD-ROM, and reboots the appliance. Before attempting to perform the upgrade again, the administrator must manually purge "File Distribution" files larger than 50MB from the database using the CAM Device Management > Clean Access > Clean Access Agent > Requirements > Requirement List web console page, or move the uploaded file to a network server and create a "Link Distribution" requirement to replace the oversized "File Distribution" requirement. (This issue only affects the CAM, thus there are no changes in upgrade behavior on the CAS.)

Starting from Release 4.7(1), the upgrade process now warns the administrator if the total compressed size of the CAM database cannot fit in available memory. If the compressed file size is too large, the upgrade process returns a warning to the administrator, aborts, ejects the Release 4.8(3) .ISO CD-ROM, and reboots the appliance. Before attempting to perform the upgrade again, the administrator must manually purge large files (like large collections of Agent Reports or Event Logs) from the CAM database. Before attempting to perform the upgrade again, the administrator must manually purge large database stores like Agent reports and Event Logs from the database using the CAM Device Management > Clean Access > Clean Access Agent > Reports > Report Viewer and Monitoring > Event Logs > Log Viewer web console pages, respectively. (This issue only affects the CAM, thus there are no changes in upgrade behavior on the CAS.)

The NACAgentCFG.xml Agent configuration XML file packaged with the Cisco NAC Agent is not preserved after upgrading from Release 4.6(1) to 4.8. You must manually re-import the Agent configuration XML file to maintain client machine login behavior.

The Cisco NAC Agent does not support Nessus-based network scanning. Nessus-based network scanning capabilities only apply to web login users and Clean Access Agent (Agent version 4.5.2.0 and earlier) users for whom a combination of client network scanning and Agent login functionality has been configured.

Starting from Release 4.6(1), the CAM no longer manages Clean Access Agent Patch/Upgrade files (CCAAgentUpgrade-4.x.y.z.tar.gz). If you are downgrading or replacing the current version of the Agent on the CAM, be sure you only upload Clean Access Agent installation files (CCAAgentSetup-4.x.y.z.tar.gz or CCAAgentMacOSX-4.x.y.z-k9.tar.gz) from the Cisco Software Download site.

Users without administrator privileges upgrading their Windows client machine from an earlier version of the Clean Access Agent (version 4.5.2.0 and earlier or version 4.1.10.0 and earlier) to the Cisco NAC Agent must have the CCAAgentStub.exe Agent Stub installed on the client machine to facilitate upgrade. (Users with administrator privileges do not need this file.) After successful Cisco NAC Agent installation, the user is not required to have administrator privileges on the client machine, nor is the CCAAgentStub.exe Agent Stub file needed. For more information on Agent Stub installers and requirements/prerequisites, see the appropriate Release Notes for the specific previous version of Cisco NAC Appliance.

Macintosh client machines require the CAS to have a name-based SSL certificate in order to communicate with Cisco NAC Appliance. Note that if you generate or import a new name-based certificate, you must reboot the CAS using the service perfigo reboot or reboot command from the CAS CLI.

When you upgrade the CAM to Release 4.8(3), the installation process prompts you to upgrade the Agent files to the latest Windows Cisco NAC Agent and Mac OS X Agent versions packaged with the CAM software image (e.g. Cisco NAC Agent version 4.8.3.9, and Mac OS X Agent version 4.8.3.594).

Release 4.8(3) includes version 3.1.0.24 of the Cisco NAC Profiler Collector component that resides on the CAS installations. When upgrading CAS appliances (standalone or HA) to Release 4.8, the upgrade script will check the version of the Collector and only upgrade it if version 3.1.0.24 is not already installed. Refer to the Release Notes for Cisco NAC Profiler for software compatibility matrixes and additional upgrade and product information.


Note Cisco NAC Profiler and Cisco NAC Guest Server are not supported in FIPS-compliant deployments in Release 4.8 and Release 4.7(0).


Features That May Change With Upgrade

If you employed any of the previous Windows registry settings to adjust Windows Clean Access Agent behavior on client machines, you must specify the same settings in the XML Agent configuration file to preserve Agent behavior using the Cisco NAC Agent. For more information, see the "Cisco NAC Agent XML Configuration File Settings" section of the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3).

For new installations of Cisco NAC Appliance Release 4.5(1) and later, the CAS Fallback behavior enhancement introduces new default values for the Detect Interval and Detect Timeout settings (20 and 300 seconds, respectively) and requires that the Detect Timeout value be at least 15 times the specified Detect Interval. You can find these settings at Device Management > CCA Servers > Manage [CAS_IP] > Filter > Fallback.
If you are upgrading to Release 4.5(1) and later, however, your existing values for these settings are preserved and you must specify new values for these settings to take advantage of the enhanced CAS Fallback capabilities available in Release 4.5(1).

When upgrading a VPN SSO Cisco NAC Appliance network to Release 4.8, user login does not work properly when the user VPN is part of a managed subnet on the CAS. For more information, see Known Issue for VPN SSO Following Upgrade to Release 4.5 and Later.

Password Changes

To offer increased security against potential unauthorized access to Cisco NAC Appliance, the CAM and CAS root admin password you specify during initial system configuration (when performing fresh install or Release 4.8 or reconfiguring the appliance via service perfigo config) must now meet strong password standards. However, any existing CAM/CAS root passwords are preserved during upgrade.

For new installations of Cisco NAC Appliance, there is no longer a default cisco123 CAM web console password. Administrators must specify a unique password for the CAM web console. However, any existing CAM web console passwords (including the old default cisco123) are preserved during upgrade.

For additional details, see also:

Hardware Support

Known Issues for Cisco NAC Appliance

General Preparation for Upgrade

Cisco strongly recommends you review this section carefully before commencing any Cisco NAC Appliance upgrade.


Caution During the upgrade process, new users will not be able to log in or authenticate with Cisco NAC Appliance until the Clean Access Server reestablishes connectivity with the Clean Access Manager.

Homogenous Clean Access Server Software Support

You must upgrade your Clean Access Manager and all your Clean Access Servers concurrently. The Cisco NAC Appliance architecture is not designed for heterogeneous support (i.e., some Clean Access Servers running 4.8 software and some running 4.6(1) or 4.7(x) software).

Upgrade Downtime Window

Depending on the number of Clean Access Servers you have, the upgrade process should be scheduled as downtime. For minor release upgrades, our estimates suggest that it takes approximately 10 to 20 minutes for the Clean Access Manager upgrade and 10 minutes for each Clean Access Server upgrade. Use this approximation to estimate your downtime window.

Upgrade Clean Access Servers Before Clean Access Manager

Starting with Cisco NAC Appliance Release 4.1(6), the Clean Access Manager and Clean Access Server require encrypted communication. Therefore, you must upgrade CASs before the CAM that manages them to ensure the CASs have the same (upgraded) release when the CAM comes back online and attempts to reconnect to the managed CASs.

If you upgrade the Clean Access Manager by itself, the Clean Access Server (which loses connectivity to the CAM during Clean Access Manager restart or reboot) continues to pass authenticated user traffic only if the CAS Fallback Policy specifies that Cisco NAC Appliance should "ignore" traffic from client machines.

High Availability (Failover) Via Serial Cable Connection

When connecting high availability (failover) pairs via serial cable, BIOS redirection to the serial port must be disabled for Cisco NAC Appliance CAMs/CASs, and for any other server hardware platform that supports the BIOS redirection to serial port functionality.


Note If you are upgrading from a Cisco NAC Appliance release older than Release 4.6(1), this upgrade preparation step does not apply.


Database Backup (Before and After Upgrade)

Cisco recommends creating a manual backup snapshot before and after upgrade of your CAM database. The snapshot contains CAM database configuration and CAS configuration for all CASs added to the CAM's domain. Pre- and post-upgrade snapshots allow you to revert to your previous database should you encounter problems during upgrade and preserves your upgraded database as a baseline after upgrade. Make sure to download the snapshots to another machine for safekeeping. After upgrade, delete all earlier snapshots from the CAM web console as they are no longer compatible.


Warning You cannot restore a CAM database from a snapshot created using a different release. For example, you cannot restore a 4.5(x), 4.6(1), or 4.7(x) database snapshot to a 4.8(3) CAM.

Backup of necessary files

Cisco recommends to backup all the necessary files that are not related to the database configuration from the system before running upgrade. For example, any previous database backups and CAM/CAS log files can be backed up.

Software Downgrade

Once you have upgraded your software to Release 4.8(3), if you wish to revert to your previous version of software, you will need to reinstall the previous version from the CD and recover your configuration based on the backup you performed prior to upgrading to 4.8(3). See Upgrade Instructions for Standalone Machines for additional details.

Passwords

For upgrade via console/SSH, you will need your CAM and CAS root user password.

Upgrade Instructions for Standalone Machines

This section describes how to upgrade standalone (i.e. non-HA) CAM/CAS machines from Release 4.6(1), 4.7(x), or 4.8 to Release 4.8, and only applies to Cisco NAC-3310/3350/3390 or Cisco NAC-3315/3355/3395 platforms. If you have HA CAM/CAS pairs, refer instead to Upgrade Instructions for HA Pairs.

In Cisco NAC Appliance release 4.8(3), you can now use a .tar.gz upgrade process similar to that used for upgrading CAM/CAS appliances in earlier releases of Cisco NAC Appliance (like the process used in Release 4.6(1) and Release 4.7(2)) instead of having to perform "in-place" upgrades via an .ISO image on a CD-ROM, as is required to upgrade to Cisco NAC Appliance release 4.7(0) and 4.7(1).

After you have downloaded and copied the upgrade file to the CAM/CAS, you must use the CAM/CAS CLI to extract the upgrade image files and perform the upgrade procedure as described in:

Run the Upgrade Script on a Release 4.7(x) or 4.8(x) CAM/CAS

Run the Upgrade Script on a Release 4.6(1) CAM/CAS


Note You cannot use the Release 4.8(3) .ISO CD-ROM to perform an upgrade. You must use the .tar.gz upgrade file method.


Review Changes for 4.8(3) Upgrade and General Preparation for Upgrade before proceeding with these upgrade instructions.

Summary of Steps for Standalone Upgrade

The steps to upgrade standalone 4.8(3) systems are as follows:

1. Create CAM DB Backup Snapshot

2. Download the Upgrade File

3. Copy the Upgrade File to the CAS/CAM

4. Run the Upgrade Script on a Release 4.7(x) or 4.8(x) CAM/CAS or Run the Upgrade Script on a Release 4.6(1) CAM/CAS

Create CAM DB Backup Snapshot

This section describes how to back up your current system so that you can retrieve your previous configuration in case there is an issue with the upgrade process.


Note Release 4.8(3) upgrades rewrite the appliance's hard-disk. Therefore, Cisco recommends backing up any non-essential data you may have manually archived (like syslog messages, event logs, etc.) onto another machine before beginning the upgrade process.



Step 1 From the CAM web console, go to the Administration > Backup page.

Step 2 The Snapshot Tag Name field automatically populates with a name incorporating the current time and date (e.g. 05_11_10-15-47_snapshot). You can also either accept the default name or type another.

Step 3 Click Create Snapshot. The CAM generates a snapshot file and adds it to the snapshot list at the bottom of the page. The file physically resides on the CAM machine for archiving purposes. The Version field and the filename display the software version of the snapshot for convenience (e.g. 05_11_10-15-47_snapshot_VER_4_8_0.gz).

Step 4 For backup, download the snapshot to another computer by clicking the Tag Name or the Download button for the snapshot to be downloaded.

Step 5 In the file download dialog, select the Save File to Disk option to save the file to your local computer.

Step 6 After upgrade, delete all earlier snapshots from the CAM web console as they will no longer be compatible.



Note Cisco NAC Appliance creates automatic snapshots before and after software upgrades and failover events, and preserves the last five entries. For further details, see "Database Recovery Tool" in the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8.


Download the Upgrade File

This section describes how to access and download the upgrade file to your local machine.


Step 1 Log in to the Cisco Software Download Site at http://www.cisco.com/public/sw-center/index.shtml. You will likely be required to provide your CCO credentials.

Step 2 Navigate to Security > Endpoint Security > Cisco Network Access Control > Cisco NAC Appliance > Cisco NAC Appliance 4.8.

Step 3 Navigate to the Cisco NAC Appliance 4.8(3) subdirectory, download the latest 4.8(3) upgrade file (depending on the Cisco NAC Appliance release from which you are upgrading), and save this file to the local computer from which you are accessing the CAM web console.:

If upgrading from Release 4.6(1)—download the cca_upgrade-4.8.3-from-4.6.x.tar.gz upgrade file

If upgrading from Release 4.7(x) or 4.8(x)—download the cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz upgrade file


Copy the Upgrade File to the CAS/CAM

This section describes how to copy the upgrade file to the Clean Access Manager and Clean Access Server(s) respectively using WinSCP, SSH File Transfer, or PSCP as described below.

If Using the Release 4.8, Release 4.7(x), or Release 4.6(1) CAM/CAS Web Console


Step 1 Access the CAM software update web console page by navigating to Administration > CCA Manager > Software Upload and/or the CAS software upgrade web console page by navigating to Administration > Software Upload.

Step 2 Click Browse to navigate to the directory on your local machine where you have stored the Release 4.8(3) .tar.gz upgrade file. Depending on the Cisco NAC Appliance release from which you are upgrading, the upgrade image name is one of the following:

If upgrading from Release 4.7(x) or 4.8—download the cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz upgrade file

If upgrading from Release 4.6(1)—download the cca_upgrade-4.8.3-from-4.6.x.tar.gz upgrade file

Step 3 Click Upload. After a brief time, the web console screen automatically refreshes, displaying the newly uploaded Release 4.8(3) upgrade image and the date/time when it was uploaded to the CAM/CAS.


If Using WinSCP or SSH File Transfer


Step 1 Access the CAM via WinSCP or SSH File Transfer.

Step 2 Copy the cca_upgrade-4.8.3-from-4.6.x.tar.gz or cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz file from your local machine to the /store directory on the Clean Access Manager.

Step 3 Access each CAS via WinSCP or SSH File Transfer.

Step 4 Copy the cca_upgrade-4.8.3-from-4.6.x.tar.gz or cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz file from your local machine to the /store directory on each Clean Access Server.


If Using PSCP


Step 1 Open a command prompt on your Windows computer.

Step 2 Cd to the path where your PSCP resides (e.g, C:\Documents and Settings\desktop).

Step 3 Enter the following command to copy the file to the /store directory on the CAM:

pscp cca_upgrade-4.8.3-from-4.6.x.tar.gz root@<ipaddress_manager>:/store
 
   

or

pscp cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz root@<ipaddress_manager>:/store
 
   

Step 4 Enter the following command to copy the file to the /store directory on the CAS (copy to each CAS):

pscp cca_upgrade-4.8.3-from-4.6.x.tar.gz root@<ipaddress_server>:/store
 
   

or

pscp cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz root@<ipaddress_server>:/store
 
   

Run the Upgrade Script on a Release 4.7(x) or 4.8(x) CAM/CAS

This section describes how to untar the upgrade file and run the script to upgrade standalone CAM/CAS machines from release 4.7(x) or 4.8(x) to release 4.8(3). You will need to login with your CAM and CAS root user passwords and access the command line of the CAM or CAS machine using one of the following methods:

Direct console connection using KVM or keyboard/monitor connected directly to the machine

SSH connection

Serial console connection (e.g. HyperTerminal or SecureCRT) from an external workstation connected to the machine via serial cable

When run, the upgrade script automatically determines whether the machine is a Clean Access Manager (CAM) or Clean Access Server (CAS) and executes accordingly.


Note The 4.8(3) upgrade script only executes if the current system is a supported Cisco NAC Appliance platform. Otherwise, the script exits with message "Unable to upgrade, not a recommended hardware platform for 4.8(3)".


Step 1: Upgrade the Release 4.7(x) CAS


Step 1 Connect to the Clean Access Server to upgrade using a console connection, or Putty or SSH.

Step 2 Log in as user root with root password.

Step 3 Change directory to /store:

cd /store
 
   

Step 4 Locate the upgrade file. If you used WinSCP, SSH File Transfer, or PSCP, the upgrade filename is cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz.

ls -l
 
   

Step 5 Extract the contents of the downloaded upgrade file:

tar xzvf cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz 
 
   

The extraction process automatically places the upgrade files and necessary upgrade script in the /cca_upgrade-4.8.3 directory.

Step 6 Change to the /cca_upgrade-4.8.3 directory and execute the upgrade process:

cd cca_upgrade-4.8.3
./UPGRADE.sh 
 
   

Step 7 Wait for the upgrade to complete. This will take several minutes.

Finished upgrading the system to 4.8.3
Upgrade is complete.
Changes require a REBOOT
 
   

Step 8 When upgrade is done, reboot the CAS at the prompt:

reboot
 
   

Step 9 Verify whether or not the upgrade was successful by logging into the CAS CLI and entering the following commands:

cd /perfigo/common/bin/
./showstate.sh | grep INCORRECT
 
   

If you do not see any output from the "grep INCORRECT" portion of the command, then your appliance has been upgraded successfully.

If your system returns any "INCORRECT" statements from the upgrade process, enter ./showstate.sh again to capture the entire upgrade process output (including all CORRECT and INCORRECT entries) and save it to an easily accessible location on your local machine along with your backup snapshot you created in Create CAM DB Backup Snapshot to help debug any upgrade issues.

Step 10 Repeat steps 1 through 9 for each CAS managed by the CAM.



Tip You can run cat /perfigo/build to verify the software version before and after upgrade.


Step 2: Upgrade the Release 4.7(x) or 4.8 CAM


Step 1 Connect to the Clean Access Manager to upgrade using a console connection, or Putty or SSH.

Step 2 Log in as user root with root password.

Step 3 Change directory to /store:

cd /store
 
   

Step 4 Locate the upgrade file. If you used WinSCP, SSH File Transfer, or PSCP, the upgrade filename is cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz.

ls -l
 
   

Step 5 Extract the contents of the downloaded upgrade file:

tar xzvf cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz
 
   

The extraction process automatically places the upgrade files and necessary upgrade script in the /cca_upgrade-4.8.3 directory.

Step 6 Change to the /cca_upgrade-4.8.3 directory and execute the upgrade process:

cd cca_upgrade-4.8.3
./UPGRADE.sh 
 
   

Step 7 When prompted to update the Windows Agent, specify y or n to upgrade the Agent or retain the current Agent version.

Stopping the perfigo service...
Currently installed Windows NAC Agent version is 4.7.1.15. Do you want to change the 
Windows NAC Agent to version 4.8.3.9 (y/n)? [y] y
Currently installed Mac Agent version is 4.7.0.2. Do you want to change the Mac Agent to 
version 4.8.3.594 (y/n)? [y] y
 
   
Going to upgrade the manager rpm
 
   
Windows NAC Agent version updated to 4.8.3.9.
Mac Agent version updated to 4.8.3.594.
 
   

Step 8 Wait for the upgrade to complete. This will take several minutes.

Finished upgrading the system to 4.8.3
Upgrade is complete.
Changes require a REBOOT
 
   

Step 9 When upgrade is done, reboot the CAM at the prompt:

reboot
 
   

Step 10 Verify whether or not the upgrade was successful by logging into the CAM CLI and entering the following commands:

cd /perfigo/common/bin/
./showstate.sh | grep INCORRECT
 
   

If you do not see any output from the "grep INCORRECT" portion of the command, then your appliance has been upgraded successfully.

If your system returns any "INCORRECT" statements from the upgrade process, enter ./showstate.sh again to capture the entire upgrade process output (including all CORRECT and INCORRECT entries) and save it to an easily accessible location on your local machine along with your backup snapshot you created in Create CAM DB Backup Snapshot to help debug any upgrade issues.



Tip You can run cat /perfigo/build to verify the software version before and after upgrade.


Run the Upgrade Script on a Release 4.6(1) CAM/CAS

This section describes how to untar the upgrade file and run the script to upgrade standalone CAM/CAS machines from Release 4.6(1) to Release 4.8(3). If you are upgrading an existing Release 4.7(x) or 4.8 CAM/CAS, see Run the Upgrade Script on a Release 4.7(x) or 4.8(x) CAM/CAS. You need to login with your CAM and CAS root user passwords and access the command line of the CAM or CAS machine using one of the following methods:

Direct console connection using KVM or keyboard/monitor connected directly to the machine

Serial console connection (for example, HyperTerminal or SecureCRT) from an external workstation connected to the machine via serial cable

When run, the upgrade script automatically determines whether the machine is a Clean Access Manager (CAM) or Clean Access Server (CAS) and executes accordingly.


Note The 4.8(3) upgrade script only executes if the current system is a supported Cisco NAC Appliance platform. Otherwise, the script exits with message "Unable to upgrade, not a recommended hardware platform for 4.8(3)".


Step 1: Upgrade the Release 4.6(1) CAS


Step 1 Connect to each machine in the failover pair via console connection (keyboard/monitor/KVM).

Step 2 Log in as user root with root password.

Step 3 Change directory to /store:

cd /store
 
   

Step 4 Locate the upgrade file. If you used WinSCP, SSH File Transfer, or PSCP, the upgrade filename is cca_upgrade-4.8.3-from-4.6.x.tar.gz.

ls -l
 
   

Step 5 Extract the contents of the downloaded upgrade file:

tar xzvf cca_upgrade-4.8.3-from-4.6.x.tar.gz
 
   

The extraction process automatically places the upgrade files and necessary upgrade script in the /cca_upgrade-4.8.3 directory.

Step 6 Change to the /cca_upgrade-4.8.3 directory and execute the upgrade process:

cd cca_upgrade-4.8.3
./UPGRADE.sh 
 
   

Step 7 Specify whether you want to run the upgrade session via direct console connection or over a serial console line.

After setting up the system for upgrade, upgrade will run
in Standard or Serial console as per selection below.
Please choose one of the following actions:
 
   
1) Upgrade over Standard console (monitor and keyboard).
2) Upgrade over Serial console.
3) Upgrade without user interaction.
4) Exit upgrade.
 
   
3
 
   

Note When you perform this upgrade on a Cisco NME-NAC network module, the option to perform the upgrade over the serial console connection is not available.


Step 8 When prompted, enter the Master Secret for the CAS.

The master secret is used to encrypt sensitive data.
Remember to configure all HA pairs with the same secret.
Please enter the master secret:
Please confirm the master secret:
 
   
After reboot, upgrade will proceed without user interaction.
Upgrade will take 20-30 minutes to complete. Once upgrade completes, machine is rebooted 
and will be available for ssh login.
 
   
After logging back in, please check the log at /root/nac-install.log.
If the upgrade is successful, the log file should contain "Upgrade completed 
successfully.".
 
   
nac-upgrade: ready to reboot. Press <ENTER> to reboot
 
   

Note The above text is displayed when you have selected the "Upgrade without user interaction" option in Step 7. For the other options in Step 7, the text may be different. Follow the instructions that appear on the screen to proceed.


Step 9 Press Enter and wait for the upgrade to complete. The time taken for an upgrade depends on both the appliance configuration and database size.

Step 10 After the upgrade is complete, make sure that the appliance is up. Use the ping command to make sure that the appliance is reachable.

ping <appliance IP address>
 
   

Once the appliance is reachable, SSH into the appliance to verify connectivity before proceeding with the set up for the CAM.

Step 11 Verify whether or not the upgrade was successful by logging into the CAS CLI and entering the following commands:

cd /perfigo/common/bin/
./showstate.sh | grep INCORRECT
 
   

If you do not see any output from the "grep INCORRECT" portion of the command, then your appliance has been upgraded successfully.

If your system returns any "INCORRECT" statements from the upgrade process, enter ./showstate.sh again to capture the entire upgrade process output (including all CORRECT and INCORRECT entries) and save it to an easily accessible location on your local machine along with your backup snapshot you created in Create CAM DB Backup Snapshot to help debug any upgrade issues.

Step 12 Repeat steps 1 through 11 for each CAS managed by the CAM.



Tip You can run cat /perfigo/build to verify the software version before and after upgrade.


Step 2: Upgrade the Release 4.6(1) CAM


Note This upgrade procedure automatically updates the Cisco NAC Agent and Mac OS X Agent to the latest versions packaged with the Release 4.8(3) .tar.gz upgrade image.



Step 1 Connect to each machine in the failover pair via console connection (keyboard/monitor/KVM).

Step 2 Log in as user root with root password.

Step 3 Change directory to /store:

cd /store
 
   

Step 4 Locate the upgrade file. If you used WinSCP, SSH File Transfer, or PSCP, the upgrade filename is cca_upgrade-4.8.3-from-4.6.x.tar.gz.

ls -l
 
   

Step 5 Extract the contents of the downloaded upgrade file:

tar xzvf cca_upgrade-4.8.3-from-4.6.x.tar.gz 
 
   

The extraction process automatically places the upgrade files and necessary upgrade script in the /cca_upgrade-4.8.3 directory.

Step 6 Change to the /cca_upgrade-4.8.3 directory and execute the upgrade process:

cd cca_upgrade-4.8.3
./UPGRADE.sh 
 
   

Step 7 Specify whether you want to run the upgrade session via direct console connection or over a serial console line.

After setting up the system for upgrade, upgrade will run
in Standard or Serial console as per selection below.
Please choose one of the following actions:
 
   
1) Upgrade over Standard console (monitor and keyboard).
2) Upgrade over Serial console.
3) Upgrade without user interaction.
4) Exit upgrade.
 
   
3

Note When you perform this upgrade on a Cisco NME-NAC network module, the option to perform the upgrade over the serial console connection is not available.


Step 8 When prompted, enter the Master Secret for the CAM.

The master secret is used to encrypt sensitive data.
Remember to configure all HA pairs with the same secret.
Enter the master secret:
Confirm the master secret:
 
   
After reboot, upgrade proceeds without user interaction.
Upgrade takes 20-30 minutes to complete. Once upgrade completes, machine reboots and is 
available for ssh login.
 
   
After logging back in, please check the log at /root/nac-install.log.
If the upgrade is successful, the log file should contain "Upgrade completed 
successfully.".
 
   
nac-upgrade: ready to reboot. Press <ENTER> to reboot
 
   

Step 9 Press Enter and wait for the upgrade to complete. The time taken for an upgrade depends on both the appliance configuration and database size.

Step 10 After the upgrade is complete, make sure that the appliance is up. Use the ping command to make sure that the appliance is reachable.

ping <appliance IP address>
 
   

Once the appliance is reachable, SSH into the appliance to verify connectivity.

Step 11 Verify whether or not the upgrade was successful by logging into the CAM CLI and entering the following commands:

cd /perfigo/common/bin/
./showstate.sh | grep INCORRECT
 
   

If you do not see any output from the "grep INCORRECT" portion of the command, then your appliance has been upgraded successfully.

If your system returns any "INCORRECT" statements from the upgrade process, enter ./showstate.sh again to capture the entire upgrade process output (including all CORRECT and INCORRECT entries) and save it to an easily accessible location on your local machine along with your backup snapshot you created in Create CAM DB Backup Snapshot to help debug any upgrade issues.



Tip You can run cat /perfigo/build to verify the software version before and after upgrade.


Upgrade Instructions for HA Pairs

In Cisco NAC Appliance release 4.8(3), you can now use a .tar.gz upgrade process similar to that used for upgrading CAM/CAS appliances in earlier releases of Cisco NAC Appliance (like the process used in Release 4.6(1) and Release 4.7(2)) instead of having to perform "in-place" upgrades via an .ISO image on a CD-ROM, as is required to upgrade to Cisco NAC Appliance release 4.7(0) and 4.7(1).

See Release 4.8(3) Upgrade Instructions for HA Pairs to upgrade your HA Pair CAM/CAS appliances.

Release 4.8(3) Upgrade Instructions for HA Pairs

This section describes how to upgrade high-availability (HA) pairs of CAM or CAS servers from Release 4.6(1), 4.7(x), or 4.8 to Release 4.8(3), and only applies to Cisco NAC-3310/3350/3390 or Cisco NAC-3315/3355/3395 platforms. If you have standalone CAM/CAS servers, refer instead to Upgrade Instructions for Standalone Machines.


Note You cannot use the Release 4.8(3) .ISO CD-ROM to perform an upgrade. You must use the .tar.gz upgrade file method.



Note To support FIPS 140-2 compliance, HA CAMs/CASs automatically establish an IPSec tunnel to ensure all communications between the HA pair appliances remains secure across the network.



Warning If you are using serial connection for HA, do not attempt to connect serially to the CAS during the upgrade procedure. When serial connection is used for HA, serial console/login will be disabled and serial connection cannot be used for installation/upgrade.

If you are using serial connection for HA, BIOS redirection to the serial port must be disabled for Cisco NAC Appliance CAMs/CASs, and for any other server hardware platform that supports the BIOS redirection to serial port functionality.

Note If you are changing the master secret for the CAM, ensure that both the CAMs are configured with the same master secret. If the master secret is different, when the standby CAM tries to come up, the perfigo service is stopped. Refer to CSCtd14712 for more details.



Note For additional details on CAS HA requirements, see also Supported Hardware and System Requirements for Cisco NAC Appliance (Cisco Clean Access).


Review Changes for 4.8(3) Upgrade and General Preparation for Upgrade before proceeding with these upgrade instructions.

Upgrading HA-CAM and HA-CAS Pairs

The following steps show the recommended way to upgrade an existing high-availability (failover) pair of Clean Access Managers or Clean Access Servers.


Warning Make sure to carefully execute the following procedure to prevent the CAM database from getting out of sync.

Step 1 Download and save the upgrade file to your local PC, as described in Download the Upgrade File. Be sure you download the correct file, depending upon the existing Cisco NAC Appliance release from which you are upgrading:

If upgrading from Release 4.7(x) or 4.8(x)—download the cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz upgrade file

If upgrading from Release 4.6(1)—download the cca_upgrade-4.8.3-from-4.6.x.tar.gz upgrade file

Step 2 From either a console connection (keyboard/monitor/KVM) or via SSH, connect to the individual IP address of each machine in the failover pair.


Note Do not connect to the Service IP of the pair, as you will lose connection during the upgrade.


Step 3 Copy the upgrade image to each CAM/CAS machines' /store directory as described in Copy the Upgrade File to the CAS/CAM.

Step 4 Login as the root user with the root password.

Step 5 Change directory to /store:

cd /store
 
   

Step 6 Locate the upgrade file. If you used WinSCP, SSH File Transfer, or PSCP, the upgrade filename is cca_upgrade-4.8.3-from-4.6.x.tar.gz or cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz, depending on the Cisco NAC Appliance release from which you are upgrading.

ls -l
 
   

Step 7 Extract the contents of the downloaded upgrade file:

tar xzvf cca_upgrade-4.8.3-from-4.7.x-4.8.x.tar.gz
 
   

or

tar xzvf cca_upgrade-4.8.3-from-4.6.x.tar.gz
 
   

The extraction process automatically places the upgrade files and necessary upgrade script in the /cca_upgrade-4.8.3 directory.

 
   

Step 8 Before proceeding, determine the failover state on each machine by changing directory and running the fostate.sh command on each machine:

cd /perfigo/common/bin/
./fostate.sh 
 
   

The results should be either "My node is active, peer node is standby" or "My node is standby, peer node is active". No nodes should be dead. This should be done on both appliances, and the results should be that one appliance considers itself active and the other appliance considers itself in standby mode. Future references in these instructions that specify "active" or "standby" refer to the results of this test as performed at this time.


Note The fostate.sh command is part of the upgrade script. You can also determine which appliance is active or standby as follows:

Access the web console as described in "Accessing Web Consoles in High Availability Pairs" sections of the "Configuring High Availability" chapter in the Cisco NAC Appliance Hardware Installation Guide, Release 4.8.

SSH to the Service IP of the CAM/CAS pair, and type ifconfig eth0. The Service IP will always access the active CAM or CAS, with the other pair member acting as standby.


Step 9 Stop services on the standby appliance by entering the following command via the console/SSH terminal:

For CAM—service perfigo stop

For CAS—service perfigo maintenance

Step 10 Wait until the standby appliance has suspended services.

Step 11 Change directory and run the fostate.sh command on the active appliance:

cd /perfigo/common/bin/
./fostate.sh 
 
   

Make sure this returns "My node is active, peer node is dead" before continuing.

Step 12 Upgrade the active appliance as follows:

a. Make sure the upgrade package is untarred in the /store directory on the active appliance.

b. From the untarred upgrade directory created on the active appliance (for example cca_upgrade-4.8.3), run the upgrade script on the active appliance:

./UPGRADE.sh
 
   

c. For the CAM only, when prompted to update the Windows Agent, specify y or n to upgrade the Agent or retain the current Agent version.

Choose whether to upgrade Windows Agent to 4.8.3.9 (It's highly recommended to 
upgrade) (y/n)? [y] 
Choose whether to upgrade Mac Agent to 4.8.3.594 (It's highly recommended to upgrade) 
(y/n)? [y] 
 
   

Step 13 After upgrade, stop services on the active appliance by entering the following command via the console/SSH terminal:

service perfigo stop
 
   

Wait till the active appliance suspends services.

Step 14 Restart services on the standby appliance by entering the following command via the console/SSH terminal:

service perfigo start
 
   

Step 15 Upgrade the standby appliance as follows:

a. Make sure the upgrade package is untarred in the /store directory on the standby appliance.

b. Change to the untarred upgrade directory created on the standby appliance:

cd cca_upgrade-4.8.3
 
   

c. Run the upgrade script on the standby appliance:

./UPGRADE.sh
 
   

d. For the CAM only, when prompted to update the Windows Agent, specify y or n to upgrade the Agent or retain the current Agent version.

Choose whether to upgrade Windows Agent to 4.8.3.9 (It's highly recommended to 
upgrade) (y/n)? [y] 
Choose whether to upgrade Mac Agent to 4.8.3.594 (It's highly recommended to upgrade) 
(y/n)? [y] 
 
   

Step 16 Verify whether or not the upgrade was successful by logging into the CLI of each CAM/CAS upgraded in the HA pair and entering the following commands:

cd /perfigo/common/bin/
./showstate.sh | grep INCORRECT
 
   

If you do not see any output from the "grep INCORRECT" portion of the command, then your appliance has been upgraded successfully.

If your system returns any "INCORRECT" statements from the upgrade process, enter ./showstate.sh again to capture the entire upgrade process output (including all CORRECT and INCORRECT entries) and save it to an easily accessible location on your local machine along with your backup snapshot you created in Create CAM DB Backup Snapshot to help debug any upgrade issues.

Step 17 After the upgrade is completed, stop services on the standby appliance by entering the following command via the console/SSH terminal:

service perfigo stop
 
   

Step 18 Reboot the active appliance by entering the following command via the console/SSH terminal:

reboot
 
   

Wait until it is running normally and you are able to connect to the web console.

Step 19 Reboot the standby appliance by entering the following command via the console/SSH terminal:

reboot
 
   

Note There is approximately 2-5 minutes of downtime while the appliances reboot.



Known Issues for Cisco NAC Appliance

This section describes known issues when integrating Cisco NAC Appliance:

Known Issue with CAS-to-CAM Certificate Verification in Internet Explorer

Known Issue with Delayed IP Address Refresh for Windows 7/Vista Clients Running Cisco NAC Agent

Known Issue with Enabling Web Login for Windows 7 Starter Edition Clients

Known Issue with Mass DHCP Address Deletion

Known Issue for VPN SSO Following Upgrade to Release 4.5 and Later

Known Issues with Web Upgrade in Release 4.1(3), 4.1(6), and 4.1(8)

Known Issue with Active HA CAM Web Console Following Failover

Known Issue with Cisco NAC Appliance CAM/CAS Boot Settings

Known Issue with IP Packet Fragmentation Leading to Disconnect Between CAS and Agent

Known Issues with Switches

Known Issues with Cisco 2200/4400 Wireless LAN Controllers (Airespace WLCs)

Known Issue for Windows Vista and IP Refresh/Renew

Known Issue While Upgrading to NAC Appliance Release 4.8(3)

Known Issue with System Center Endpoint Protection

Known Issue with CAS-to-CAM Certificate Verification in Internet Explorer

When launching the CAM web console in Release 4.8(3) using Internet Explorer, you may see a "Choose a digital certificate" pop-up dialog with no options available in the selection window. This pop-up is a result of the way the CAM verifies CAS-to-CAM certificates for communication. If you click OK or Cancel, the dialog disappears and you can continue the web console session normally. If you want to ensure this pop-up does not appear in the future. you can apply the following custom security setting in Internet Explorer:

1. Go to Tools > Internet Options, click on the Security tab, and click Custom Level.

2. Scroll down and enable the Don't prompt for client certificate selection when no certificate or only one certificate exists option.

3. Click OK.


Note This issue is not observed when accessing the CAM with Mozilla Firefox or Google Chrome browsers.


Known Issue with Delayed IP Address Refresh for Windows 7/Vista Clients Running Cisco NAC Agent

The IP address release/renew process for Windows 7 and Windows Vista client machines running Cisco NAC Agent version 4.8.0.x that move from the authentication to access VLAN can take as long as 4 minutes to complete.

This situation can occur when the Network Connectivity Status Indicator, which is part of the Network Location Awareness in Windows, tries to reach the msftncsi.com web page while refreshing the client machines IP address. When the client machine cannot reach this page, Windows 7 and Windows Vista take longer to sense the machine's status, thus slowing down applications requiring internet access.

For reference, see:

http://technet.microsoft.com/en-us/library/cc766017(WS.10).aspx

http://technet.microsoft.com/en-us/library/ee126135(WS.10).aspx

To resolve this issue, open the following sites using host traffic policies in any user roles associated with the client login session (Unauthenticated/Quarantine, Temporary, and standard user login roles):

ncsi.glbdns.microsoft.com equals Microsoft NCSI check

.msftncsi.com ends Microsoft NCSI check

The administrator can also use a utility like Microsoft SMS to pass a registry update disabling this option in the Windows registry on client machines.

See CSCtg06599 for more information.

Known Issue with Enabling Web Login for Windows 7 Starter Edition Clients


Note This known issue applies only to Cisco NAC Agent version 4.7.1.511 and Cisco NAC Web Agent version 4.7.1.504. The latest versions of the Cisco NAC Agent (version 4.7.2.10 and later) and Cisco NAC Web Agent (version 4.7.2.5 and later) support Windows 7 Starter Edition.


Cisco NAC Agent version 4.7.1.511 and Cisco NAC Web Agent version 4.7.1.504 do not support Windows 7 Starter Edition. Client machines with the Windows 7 Starter Edition operating system can only perform web login to verify user credentials when logging into the network via Cisco NAC Appliance Release 4.7(1). The solution to simultaneously provide Cisco NAC Appliance support for web login on Windows 7 Starter Edition client machines as well as Agent login for other Windows operating systems requires the administrator to add a web login page that classifies Windows 7 Starter Edition in a "WINDOWS_ALL" operating system context. To enable web login functions for client machines running Windows 7 Starter Edition:

Users must perform web login using Internet Explorer version 8.0 with ActiveX only (Java Applet is not supported)

The Cisco NAC Appliance administrator must use the CAM Administration > User Pages > Login Page web console page to create a login page for the "WINDOWS_ALL" operating system that:

Requires the "ActiveX Only" Web Client setting

Enables the "Use web client to detect MAC address and Operating System" option to appropriately reflect the Windows 7 Starter Edition operating system on the client machine

Known Issue with Mass DHCP Address Deletion

An issue exists in Release 4.5(1) and later where a Clean Access Server configured to be a DHCP server can become unmanageable if the administrator attempts to delete more than 800 DHCP addresses from the appliance using the Clean Access Manager web console. If you have more than 800 DHCP addresses, Cisco recommends deleting addresses in smaller blocks of no more than 800 addresses at a time.

In addition to ensuring you do not delete more than 800 DHCP addresses at a time, there are two methods to work around this potential issue.

Workaround 1

The DHCP IP delete can be done manually by connecting to the CLI and executing the following commands:

service perfigo stop
rm -f /var/state/dhcp/dhcpd.leases
touch /var/state/dhcp/dhcpd.leases
service perfigo start
 
   

If on an HA system, Cisco strongly recommends taking the CASs offline and performing the commands on both machines simultaneously, taking particular care to issue the service perfigo start on the two appliances at roughly the same time.

Workaround 2

If you experience this problem more than once, Cisco recommends changing the Clean Access Manager timeout value by editing the /perfigo/control/bin/starttomcat file and adding "-DRMI_READ_TIME_OUT=<new value>" to the end of the CATALINA_OPTS options string. (The current default value is 60 seconds, and Cisco does not recommend increasing the timeout value to any more than 300 seconds.) Please note that increasing the read time out value can likely lower the resiliency of WAN deployments, thus reversing the CAM/CAS connectivity improvements introduced when Cisco addressed caveat CSCsw20607 in the Release Notes for Cisco NAC Appliance, Version 4.5(1).


Note In Release 4.6(1) and later, the CAM only allows 60 seconds for a response on remote calls to the CAS. This impacts deleting hundreds of DHCP IPs at once, particularly on slower CAS hardware platforms. Cisco recommends that you do not delete any more than 3 class C address segments at once.


For more information, see CSCsx35438.

Known Issue for VPN SSO Following Upgrade to Release 4.5 and Later

When you upgrade your Cisco NAC Appliance network employing VPN SSO to Release 4.5 and later, user login does not work properly when the user VPN is part of a managed subnet on the CAS.

In Release 4.5 and later, the SWISS protocol checks the MAC address for Layer 2 clients, but the MAC address reported by the Agent (which is the real client MAC address) is different from the one the CAS gets for the client (the VPN concentrator MAC address). As a result, the SWISS protocol tells the Agent that the client machine is not logged in (due to the different MAC addresses recorded) and the Agent launches the login dialog repeatedly, never able to complete login. Prior to Release 4.5, the Clean Access Server associates the client with the VPN IP address and VPN Concentrator's MAC address after the first login. From there, the SWISS protocol only checks the IP address from the Agent and reports back to the Agent that the client is logged in (regardless of whether the client is connected via Layer 2 or Layer 3).

To work around this issue, remove the subnet making up the client machine address pool from the collection of managed subnets and create a Layer 3 static route on the CAS untrusted interface (eth1) with VPN concentrator's IP address as the gateway for the VPN subnet using the CAM web console Device Management > CCA Servers > Manage [CAS_IP] > Advanced > Static Routes page.

Known Issues with Web Upgrade in Release 4.1(3), 4.1(6), and 4.1(8)

In Cisco NAC Appliance Release 4.8, web upgrade is no longer supported and cannot be used to upgrade Cisco NAC Appliances on Release 4.1(3) and later. To upgrade your Cisco NAC Appliances from Release 4.1(3) and later, you must run the upgrade script via the in-place Install/Upgrade CD method, as described in Upgrading to Release 4.8(3).


Note To upgrade from Cisco NAC Appliance Release 4.1(8) or earlier to Release 4.8, you must first upgrade your system to Release 4.6(1), 4.7(0), 4.7(1), or 4.7(2) and then upgrade to Release 4.8.


Known Issue with Active HA CAM Web Console Following Failover

For a brief period following a failover event, the administrator web console for the newly "active" CAM retains the limited menu/submenu options previously available while the machine was still the "standby" CAM.

To manually reproduce this scenario:

1. Configure the HA-CAM failover pair.

2. Issue the service perfigo stop CLI command on both HA-CAMs to stop services.

3. Issue the service perfigo start CLI command on the HA-Standby CAM to restart services.

4. As soon as the service perfigo start command finishes, access the HA-Service IP address in a browser for the administrator web console, enter authentication credentials, and click Login.

5. The CAM HA-Service IP administrator web console displays the limited menu/submenu options previously available while the machine was still the "standby" CAM.

To get the administrator web console to display properly, simply reload (Ctrl-refresh) the CAM HA-Service IP/hostname web page to display the full GUI for the now "active" CAM.

Known Issue with Cisco NAC Appliance CAM/CAS Boot Settings

When performing CD software installation, if a Cisco NAC Appliance CAM/CAS does not read the software on the CD ROM drive, and instead attempts to boot from the hard disk, you will need to configure the appliance BIOS settings to boot from CD ROM before attempting to re-image or upgrade the appliance from CD. For detailed steps, refer to the "Configuring Boot Settings on the Cisco NAC Appliance CAM/CAS" section of the Cisco NAC Appliance Hardware Installation Guide, Release 4.8.

Client machines going across a GRE tunnel in the network are unable to authenticate and the agent does not popup.

Known Issue with IP Packet Fragmentation Leading to Disconnect Between CAS and Agent

TCP traffic between the Agent and CAS can break down if the overall network path MTU is smaller than the MTU needed for the CAS to send unfragmented packets and the packet coming from the CAS to the Agent has the "do not fragment" setting enabled.


Note This scenario has been observed with TCP SSL packets and generally only applies to authentication, posture, and discovery host traffic. This issue does not apply to traffic that is not directed specifically to the CAS/Discovery Host.


To address this issue, apply one of the following solutions to your network:

Set the IP TCP adust-mss for the GRE tunnel according to the guidelines at http://www.cisco.com/en/US/docs/ios/12_2t/12_2t4/feature/guide/ft_admss.html.

Remove the "do not fragment" setting from the packet using a route map, as described in at http://www.cisco.com/en/US/tech/tk827/tk369/technologies_white_paper09186a00800d6979.shtml

Example configuration:

interface FastEthernet0/0
 ip address 10.32.32.101 255.255.255.0
 ip policy route-map removedontfrag
 duplex auto
 speed auto
!
access-list 101 permit tcp host 10.255.253.152 any
access-list 101 permit tcp host 10.255.252.152 any
access-list 101 permit tcp host 1.1.1.1 any
!
route-map removedontfrag permit 10
 match ip address 101
 set ip df 0
 
   
 
   
NOTE: 10.255.253.152 is the trusted IP Address of the CAS
NOTE: 10.255.252.152 is the trusted IP Address of the CAS
NOTE: 1.1.1.1 is the discovery host resolved IP Address.

Known Issues with Switches

For complete details, see Cisco NAC Appliance Switch and Wireless LAN Controller Support.

Known Issues with Cisco 2200/4400 Wireless LAN Controllers (Airespace WLCs)

Due to changes in DHCP server operation with Cisco NAC Appliance Release 4.0(2) and later, networks with Cisco 2200/4400 Wireless LAN Controllers (also known as Airespace WLCs) which relay requests to the Clean Access Server (operating as a DHCP server) may have issues. Client machines may be unable to obtain DHCP addresses. Refer to the "Cisco 2200/4400 Wireless LAN Controllers (Airespace WLCs) and DHCP" section of Cisco NAC Appliance Switch and Wireless LAN Controller Support for detailed instructions.


Note For further details on configuring DHCP options, refer to the applicable version of the Cisco NAC Appliance - Clean Access Server Configuration Guide, Release 4.8(3).



Note This known issue does not affect Wireless Out-of-Band deployments because CASs are only deployed in Virtual Gateway mode, thus the CAS is not configured to perform any DHCP functions.


Known Issue for Windows Vista and IP Refresh/Renew

When logged in as a machine admin on Windows Vista and using web login with IP refresh configured, IP address refresh/renew via ActiveX or Java will fail due to the fact that Internet Explorer does not run as an elevated application and Vista requires elevated privileges to release and renew an IP address.

Workaround

In order to use the IP refresh feature, you will need to:

1. Log into the Windows Vista client as an administrator.

2. Create a shortcut for IE on your desktop.

3. Launch it by right-clicking the shortcut and running it as administrator. This will allow the application to complete the IP Refresh/Renew. Otherwise, the user will need to do it manually via Command Prompt running as administrator. This is a limitation of the Windows Vista OS.

See also CSCsm61077.

Known Issue While Upgrading to NAC Appliance Release 4.8(3)

While upgrading to Cisco NAC Appliance Release 4.8(3), there is a possibility of the existing CAM database containing orphan data. Before upgrading to Cisco NAC Appliance Release 4.8(3), it is recommended to remove the orphan data that may be available in the existing CAM database.

To identify and remove the orphan data:


Step 1 Login to CAM CLI using SSH or Telnet. Go to the /tmp directory.

cd /tmp
 
   

Step 2 Run the following commands in the /tmp directory. The commands store the report IDs from the database tables dm_report_av and dm_report to text files.

psql -h 127.0.0.1 controlsmartdb -U postgres  -A  -q  -c "select distinct report_id from 
dm_report_av order by report_id" > dm_report_av.txt
psql -h 127.0.0.1 controlsmartdb -U postgres  -A  -q  -c "select distinct report_id from 
dm_report order by report_id" > dm_report.txt
 
   

Step 3 Run the following command to get orphan data from the dm_report_av table:

diff -c -b dm_report_av.txt dm_report.txt | grep "^- "

For example, assume that you get the following output after running the above command.

- 169519
- 169520
 
   

The above output means that data with identifiers 169519 and 169520 are available in dm_report_av table but there is no corresponding data in dm_report table. This is the orphan data existing in the dm_report_av table. You must delete this data.


Note If there is no ouput from the above command, the data is correct and there is no need to delete anything.


Step 4 Run the following command to store the report IDs from the dm_report_soft table.

psql -h 127.0.0.1 controlsmartdb -U postgres  -A  -q  -c "select distinct report_id from 
dm_report_soft order by report_id" > dm_report_soft.txt
 
   

Run the following command to get orphan data from the dm_report_soft table.

diff -c -b dm_report_soft.txt dm_report.txt | grep "^- "

For example, assume that you get the following output after running the above command.

- 169519
- 169520
 
   

The above output means that data with identifiers 169519 and 169520 are available in dm_report_soft table but there is no corresponding data in dm_report table. This is the orphan data existing in the dm_report_soft table. You must delete this data.


Note If there is no output from the above command, the data is correct and there is no need to delete anything.


Step 5 To delete the orphan data, run the following commands.


Caution Execute the following commands only if you find orphan data present in the database.

For example, to delete the orphan records with identifiers 169519 and 169520 from the dm_report_av table, run the following command:

psql -h 127.0.0.1 controlsmartdb -U postgres  -A  -q  -c "delete from dm_report_av where 
report_id in (169519,169520)"
 
   

To delete the orphan records with identifiers 169519 and 169520 from the dm_report_soft table, run the following command:

psql -h 127.0.0.1 controlsmartdb -U postgres  -A  -q  -c "delete from dm_report_soft where 
report_id in (169519,169520)"

Known Issue with System Center Endpoint Protection

Previously, the Anti Virus product System Center Endpoint Protection 2012 was recognized by the Compliance Module as System Center Endpoint Protection 2.x. If you are using the updated version of System Center Endpoint Protection 2012 released by Microsoft, then it is detected as Microsoft Security Essential 4.x.

Troubleshooting

This section provides troubleshooting information for the following topics:

Disabling Administrator Prompt for Certificate on IE 8 and 9

Disabling Administrator Prompt for Certificate on IE 8 and 9

Windows Vista and Windows 7—IE 7 and IE 8 Certificate Revocation List

HA Active-Active Situation Due to Expired SSL Certificates

Agent AV/AS Rule Troubleshooting

Debug Logging for Cisco NAC Appliance Agents

Creating CAM/CAS Support Logs

Recovering Root Password for CAM/CAS

Troubleshooting SNMP Issues

Troubleshooting CAM/CAS Certificate Issues

Troubleshooting Switch Support Issues

Other Troubleshooting Information


Note For additional troubleshooting information, see also New Installation of Release 4.8(3).


Disabling Administrator Prompt for Certificate on IE 8 and 9

If no certificates or only one certificate is installed in the personal store in Windows then there is an administrator prompt for certificate in IE9. The prompt can be disabled by setting the option on Internet Explorer.

To disable the prompt:


Step 1 Go to Tools > Internet Options.

Step 2 Click the Security tab. Select a zone to view or change security settings (that the NAC Manager URL falls under).

Step 3 Click Custom level under Security level for this zone.

Step 4 Enable Don't prompt for client certificate selection when no certificates or only one certificate exists.


Enabling TLSv1 on Internet Explorer Version 6

Cisco NAC Appliance network administrators managing the CAM/CAS via web console and client machine browsers accessing a FIPS-compliant Cisco NAC Appliance Release 4.7(0) network require TLSv1 in order to "talk" to the network, which is disabled by default in Microsoft Internet Explorer Version 6.

To locate and enable this setting in IE version 6:


Step 1 Got to Tools > Internet Options.

Step 2 Select the Advanced tab.

Step 3 Scroll down to locate the Use TLS 1.0 option under Security.

Step 4 Click on the checkbox to enable the Use TLS 1.0. option and click Apply.

Step 5 Close the browser and open a new one where the TLS 1.0 option should now be automatically enabled, if necessary.



Note This option is enabled by default in Microsoft Internet Explorer versions 7 and 8 and Mozilla Firefox has not shown this limitation.


Windows Vista and Windows 7—IE 7 and IE 8 Certificate Revocation List


Note In Internet Explorer versions 7 and 8, the "Check for server certificate revocation (requires restart)" checkbox is enabled by default under IE's Tools > Internet Options > Advanced | Security settings.

In Release 4.6(1) and later, you can use the "AllowCRLChecks" attribute in the NACAgentCFG.xml file to turn off Certificate Revocation List (CRL) checking for the Cisco NAC Agent during discovery and negotiation with the CAS. For details, see the "Cisco NAC Agent XML Configuration File Settings" section in the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3).


The "Network error: SSL certificate rev failed 12057" error can occur and prevent login for Clean Access Agent or Cisco NAC Web Agent users in either of the following cases:

1. The client system is using Microsoft Internet Explorer version 7 or 8 and/or the Windows Vista or Windows 7 operating system, and the certificate issued for the CAS is not properly configured with a CRL (Certificate Revocation List).

2. A temporary SSL certificate is being used for the CAS and:

The user has not imported this certificate to the trusted root store.

The user has not disabled the "Check for server certificate revocation (requires restart)" checkbox in IE.

To resolve this issue, perform the following actions:


Step 1 (Preferred) When using a CA-signed CAS SSL certificate, check the "CRL Distribution Points" field of the certificate (including intermediate or root CA), and add the URL hosts to the allowed Host Policy of the Unauthenticated/Temporary/Quarantine Roles. This will allow the Agent to fetch the CRLs when logging in.

Step 2 Or, if continuing to use temporary certificates for the CAS, the user will need to perform ONE of the following actions:

a. Import the certificate to the client system's trusted root store.

b. Disable the "Check for server certificate revocation (requires restart)" checkbox under IE's Tools > Internet Options > Advanced | Security settings.


HA Active-Active Situation Due to Expired SSL Certificates

HA communication for both HA-CAMs and HA-CASs is handled over IPSec tunnels to secure all communications between the two HA pair appliances. This IPSec tunnel is negotiated based on the SSL certificates uploaded to the HA pairs for both CAM and CAS. In case the SSL certificates are not trusted by the two HA peers, have expired, or are no longer valid, the HA heartbeat communication between the two HA pairs breaks down, leading both HA pair appliances to assume the Active HA-Primary) role.

For CASs deployed in VGW mode, this can potentially create a Layer 2 loop that could bring down the network. HA-CAMs with expired or invalid SSL certificates could lead to an Active-Active situation where the database is not synced between the two HA-CAM appliances. Eventually, this situation leads to the CAMs losing all recent configuration changes and/or all recent user login information following an HA-CAM failover event.

As HA communication over IPSec tunnels requires valid SSL certificates on both the CAM and CAS, the CAM-CAS communication also breaks down if the SSL certificate expires on either the CAM or CAS. This situation leads to end user authentications failures and the CAS reverting to fallback mode per CAS configuration.

Administrators can minimize HA appliance Active-Active situations due to expired SSL certificates by using SSL certificates with longer validity periods and/or using serial port connection (if available and not used to control another CAM or CAS) for HA heartbeat. However, when you configure HA-CAMs to perform heartbeat functions over the serial link and the primary eth1 interface fails because of SSL certificate expiration, the CAM returns a database error indicating that it cannot sync with its HA peer and the administrator receives a "WARNING! Closed connections to peer [standby IP] database! Please restart peer node to bring databases in sync!!" error message in the CAM web console.


Note Starting with Cisco NAC Appliance Release 4.7(0), the CAM or CAS generates event log messages to indicate the certificate expiry in addition to the message displayed in the CAM/CAS web console.



Note The self-signed SSL certificate expires after 90 days from the date of generation.


Agent AV/AS Rule Troubleshooting

When troubleshooting AV/AS Rules:

View administrator reports for the Agent from Device Management > Clean Access > Clean Access Agent > Reports

Or, to view information from the client, right-click the Agent taskbar icon and select Properties.

When troubleshooting AV/AS Rules, please provide the following information:

1. Version of CAS, CAM, and Agent (see ).

2. Version of client OS (e.g. Windows XP SP2).

3. Version of Cisco Updates ruleset

4. Product name and version of AV/AS software from the Add/Remove Program dialog box.

5. What is failing—AV/AS installation check or AV/AS update checks? What is the error message?

6. What is the current value of the AV/AS def date/version on the failing client machine?

7. What is the corresponding value of the AV/AS def date/version being checked for on the CAM? (See Device Management > Clean Access > Clean Access Agent > Rules > AV/AS Support Info.)

8. If necessary, provide Agent debug logs as described in Debug Logging for Cisco NAC Appliance Agents.

9. If necessary, provide CAM support logs as described in Creating CAM/CAS Support Logs.

Debug Logging for Cisco NAC Appliance Agents

This section describes how to view and/or enable debug logging for Cisco NAC Appliance Agents. Refer to the following sections for steps for each Agent type:

Generate Cisco NAC Agent Debug Logs

Cisco NAC Web Agent Logs

Generate Mac OS X Agent Debug Log

Copy these event logs to include them in a customer support case.

Generate Cisco NAC Agent Debug Logs

To generate Cisco NAC Agent logs using the Cisco Log Packager utility, refer to the "Create Agent Log Files Using the Cisco Log Packager" section of the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3).

Cisco NAC Web Agent Logs

The Cisco NAC Web Agent version 4.1.3.9 and later can generate logs when downloaded and executed. By default, the Cisco NAC Web Agent writes the log file upon startup with debugging turned on. The Cisco NAC Web Agent generates the following log files for troubleshooting purposes: webagent.log and webagentsetup.log. These files should be included in any TAC support case for the Web Agent. Typically, these files are located in the user's temp directory, in the form:

C:\Document and Settings\<user>\Local Settings\Temp\webagent.log

C:\Document and Settings\<user>\Local Settings\Temp\webagentsetup.log

If these files are not visible, check the TEMP environment variable setting. From a command-prompt, type "echo %TEMP%" or "cd %TEMP%".

When the client uses Microsoft Internet Explorer, the Cisco NAC Web Agent is downloaded to the C:\Documents and Settings\<user>\Local Settings\Temporary internet files directory.

Generate Mac OS X Agent Debug Log

For Mac OS X Agents, the Agent event.log file and preference.plist user preferences file are available under <username> > Library > Application Support > Cisco Systems > CCAAgent.app. To change or specify the LogLevel setting, however, you must access the global setting.plist file (which is different from the user-level preference.plist file).

Because Cisco does not recommend allowing individual users to change the LogLevel value on the client machine, you must be a superuser or root user to alter the global setting.plist system preferences file and specify a different Agent LogLevel.


Note For versions prior to 4.1.3.0, debug logging for the Mac OS X Agent is enabled under <local drive ID> > Library > Application Support > Cisco Systems | CCAAgent.app > Show Package Contents > setting.plist.


To view and/or change the Agent LogLevel:


Step 1 Open the navigator pane and navigate to <local drive ID> > Applications.

Step 2 Highlight and right-click the CCAAgent.app icon to bring up the selection menu.

Step 3 Choose Show Package Contents > Resources.

Step 4 Choose setting.plist.

Step 5 If you want to change the current LogLevel setting using Mac Property Editor (for Mac OS 10.4 and later) or any standard text editor (for Mac OS X releases earlier than 10.4), find the current LogLevel Key and replace the exiting value with one of the following:

Info—Include only informational messages in the event log

Warn—Include informational and warning messages in the event log

Error—Include informational, warning, and error messages in the event log

Debug—Include all Agent messages (including informational, warning, and error) in the event log


Note The Info and Warn entry types only feature a few messages pertaining to very specific Agent events. Therefore, you will probably only need either the Error or Debug Agent event log level when troubleshooting Agent connection issues.



Note Because Apple, Inc. introduced a binary-format .plist implementation in Mac OS 10.4, the .plist file may not be editable by using a common text editor such as vi. If the .plist file is not editable (displayed as binary characters), you either need to use the Mac Property List Editor utility from the Mac OS X CD-ROM or acquire another similar tool to edit the setting.plist file.

Property List Editor is an application included in the Apple Developer Tools for editing .plist files. You can find it at <CD-ROM>/Developer/Applications/Utilities/Property List Editor.app.

If the setting.plist file is editable, you can use a standard text editor like vi to edit the LogLevel value in the file.

You must be the root user to edit the file.



Creating CAM/CAS Support Logs

The Support Logs web console pages for the CAM and CAS allow administrators to combine a variety of system logs (such as information on open files, open handles, and packages) into one tarball that can be sent to TAC to be included in the support case. Refer to "Support Logs" sections of the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3) or Cisco NAC Appliance - Clean Access Server Configuration Guide, Release 4.8(3).

Recovering Root Password for CAM/CAS

Refer to the "Password Recovery" chapter of the Cisco NAC Appliance Hardware Installation Guide, Release 4.8.

Troubleshooting SNMP Issues

To troubleshoot the common errors that occur in SNMP operations, refer to the "Troubleshooting SNMP" section of Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3).

Troubleshooting CAM/CAS Certificate Issues

Refer to the "Troubleshooting Certificate Issues" sections of the Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3) or Cisco NAC Appliance - Clean Access Server Configuration Guide, Release 4.8(3).

Troubleshooting Switch Support Issues

To troubleshoot switch issues, see Cisco NAC Appliance Switch and Wireless LAN Controller Support.

Other Troubleshooting Information

For general troubleshooting tips, see the following Technical Support webpage:

http://www.cisco.com/en/US/products/ps6128/tsd_products_support_series_home.html

Documentation Updates

Table 8 Updates to Release Notes for Cisco NAC Appliance, Release 4.8(3)

Date
Description

4/29/13

Added caveat CSCub23095 to Resolved Caveats - Release 4.8(3)

3/28/13

Added Support for Internet Explorer 10 on Windows 7

1/18/12

Updated the document with the latest NAC Agent 4.8.3.9

Added caveat CSCto49390 to Resolved Caveats - Release 4.8(3)

12/06/12

Updated Support for Windows 8

10/23/12

Added Support for Windows 8 and Support for Internet Explorer 10

09/24/12

Added Support for iOS 6

07/27/12

Added Support for Mac OS X 10.8

06/08/12

Updated the document with the latest NAC Agent 4.8.3.3

Added caveats CSCty39040 and CSCtz23958 to Resolved Caveats - Cisco NAC Agent Vers 4.8.3.9/Mac OS X Vers 4.8.3.594

01/18/12

Release 4.8(3)


Related Documentation

For the latest updates to Cisco NAC Appliance documentation on Cisco.com see: http://www.cisco.com/en/US/products/ps6128/tsd_products_support_series_home.html or simply http://www.cisco.com/go/cca.

Cisco NAC Appliance Hardware Installation Guide, Release 4.8

Cisco NAC Appliance - Clean Access Manager Configuration Guide, Release 4.8(3)

Cisco NAC Appliance - Clean Access Server Configuration Guide, Release 4.8(3)

Getting Started with Cisco NAC Network Modules in Cisco Access Routers

Cisco NAC Appliance FIPS Card Field-Replaceable Unit Installation Guide

Support Information for Cisco NAC Appliance Agents, Release 4.5 and Later

Cisco NAC Appliance Switch and Wireless LAN Controller Support

Cisco NAC Appliance Service Contract / Licensing Support

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, submitting a service request, and gathering additional information, see What's New in Cisco Product Documentation at: http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html.

Subscribe to What's New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.