Troubleshoot Anyconnect: Gather Information For Troubleshooting
Troubleshoot Anyconnect: Gather Information For Troubleshooting
Procedure
Step 1 On Windows, navigate to Advanced Window > Statistics > VPN drawer. On Linux, click the Details
button on the user GUI.
Step 2 Choose from the following options, depending upon the packages that are loaded on the client computer.
• Export Stats—Saves the connection statistics to a text file for later analysis and debugging.
• Reset—Resets the connection information to zero. AnyConnect immediately begins collecting new data.
• Diagnostics—Launches the AnyConnect Diagnostics and Reporting Tool (DART) wizard which bundles
specified log files and diagnostic information for analyzing and debugging the client connection.
Troubleshoot AnyConnect
1
Troubleshoot AnyConnect
Run DART to Gather Data for Troubleshooting
Procedure
Note Default is the only option for macOS. You cannot customize which files to include in the bundle.
Note If you select Custom, you can configure which files to include in the bundle, and specify a different
storage location for the file.
Step 4 If DART seems to be taking a long time to gather the default list of files, click Cancel, re-run DART, and
choose Custom selecting fewer files.
Step 5 If you chose Default, DART starts creating the bundle. If you chose Custom, continue following the wizard
prompts to specify logs, preference files, diagnostic information, and any other customizations.
Troubleshoot AnyConnect
2
Troubleshoot AnyConnect
Collect Logs to Gather Data for Install or Uninstall Issues (for Windows)
Collect Logs to Gather Data for Install or Uninstall Issues (for Windows)
If you have an AnyConnect install or uninstall failure, you need to collect logs, because the DART collection
does not have diagnostics for this.
Run the msiexec command in the same directory where you unzipped AnyConnect files:
• For install failures, enter
C:/temp>msiexec /i anyconnect-win-version-pre-deploy-k9.msi /lvx c:/Temp/ac-install.log?
Note For uninstall failures, you should use the MSI specific to the version currently installed.
You can alter the same commands above to capture information about any module on Windows which is not
installing or uninstalling correctly.
E122 Device install failed. Error 2: The system cannot find the file specified.
E154 Class installer failed. Error 2: The system cannot fine the file specified.
Troubleshoot AnyConnect
3
Troubleshoot AnyConnect
AnyConnect Connection or Disconnection Issues
If this is an initial web deployment install, the log file is located in the per-user temp directory:
%TEMP%\anyconnect-win-4.X.xxxxx-k9-install-yyyyyyyyyyyyyy.log.
If an upgrade was pushed from the optimal gateway, the log file is in the following location:
%WINDIR%\TEMP\anyconnect-win-3.X.xxxxx-k9-install-yyyyyyyyyyyyyy.log.
Obtain the most recent file for the version of the client you want to install. The xxx varies depending on the
version, and the yyyyyyyyyyyyyy specifies the date and time of the install.
config terminal
logging enable
logging timestamp
logging class auth console debugging
logging class webvpn console debugging
logging class ssl console debugging
logging class anyconnect console debugging
Troubleshoot AnyConnect
4
Troubleshoot AnyConnect
AnyConnect Not Establishing Initial Connection or Not Disconnecting
2. Attempt an AnyConnect client connection, and when the connect error occurs, cut and paste the log
information from the console into a text editor and save.
3. Type no logging enable to disable logging.
• Obtain Cisco AnyConnect VPN client log from the client computer using the Windows Event Viewer.
1. Choose Start > Run and type eventvwr.msc /s.
2. Locate the Cisco AnyConnect VPN Client in the Applications and Services Logs (of Windows 7)
and choose Save Log File As...
3. Assign a filename, for example, AnyConnectClientLog.evt. You must use the .evt file
format.
• Modify the Windows Diagnostic Debug Utility.
1. Attach the vpnagent.exe process as shown in the WinDbg documentation.
2. Determine if there is a conflict with the IPv6/IPv4 IP address assignments. Look in the event logs
for any idenfied conflicts.
3. If a conflict was identified, add additional routing debugs to the registry of the client computer being
used. These conflicts may appear in the AnyConnect event logs as follows:
4. Enable route debugging on a one-time basis for a connection by adding a specific registry entry
(Windows) or file (Linux and macOS).
• On 32-bit Windows, the DWORD registry value must be
HKEY_LOCAL_MACHINE\SOFTWARE\Cisco\Cisco AnyConnect Secure Mobility
Client\DebugRoutesEnabled
• On Linux or macOS, create a file in the following path using the sudo touch command:
/opt/cisco/anyconnect/debugroutes
Note The key or file is deleted when the tunnel connection is started. The value of the
key or content of the file is not important as the existence of the key or file is
sufficient to enable debugging.
Start a VPN connection. When this key or file is found, two route debug text files
are created in the system temp directory (usually C:\Windows\Temp on Windows
and /tmp on Mac or Linux). The two files (debug_routechangesv4.txt4 and
debug_routechangesv6.txt) are overwritten if they already exist.
Troubleshoot AnyConnect
5
Troubleshoot AnyConnect
AnyConnect Not Passing Traffic
• Verify whether the tunneled default gateway is enabled for the setup. The traditional default gateway is
the gateway of last resort for non-decrypted traffic:
If a VPN client needs to access a resource that is not in the routing table of the VPN gateway, packets
are routed by the standard default gateway. The VPN gateway does not need to have the whole internal
routing table. If you use a tunneled keyword, the route handles decrypted traffic coming from IPsec/SSL
VPN connection. Standard traffic routes to 209.165.200.225 as a last resort, while traffic coming from
the VPN routes to 10.0.4.2 and is decrypted.
• Collect a text dump of ipconfig /all and a route print output before and after establishing a tunnel with
AnyConnect.
• Perform a network packet capture on the client or enable a capture on the ASA.
Note If some applications (such as Microsoft Outlook) do not operate with the tunnel,
ping a known device in the network with a scaling set of pings to see what size
gets accepted (for example, ping -| 500, ping -| 1000, ping -| 1500, and ping -|
2000). The ping results provide clues to the fragmentation issues in the network.
Then you can configure a special group for users who might experience
fragmentation and set the anyconnect mtu for this group to 1200. You can also
copy the Set MTU.exe utility from the old IPsec client and force the physical
adapter MTU to 1300. Upon reboot, see if you notice a difference.
Troubleshoot AnyConnect
6
Troubleshoot AnyConnect
VPN Service Failures
Procedure
Step 1 Check the services under the Windows Administration Tools to ensure that the Cisco AnyConnect VPN Agent
is not running. If it is running and the error message still appears, another VPN application on the workstation
may need disabled or even uninstalled. After taking that action, reboot, and repeat this step.
Step 2 Try to start the Cisco AnyConnect VPN Agent.
Step 3 Check the AnyConnect logs in the Event Viewer for any messages stating that the service was unable to start.
Notice the time stamps of the manual restart from Step 2, as well as when the workstation was booted up.
Step 4 Check the System and Application logs in the Event Viewer for the same general time stamps of any messages
of conflict.
Step 5 If the logs indicate a failure starting the service, look for other information messages around the same time
stamp which indicate one of the following:
• a missing file—reinstall the AnyConnect client from a stand-alone MSI installation to rule out a missing
file.
• a delay in another dependent service—disable startup activities to speed up the workstation’s boot time.
• a conflict with another application or service—determine whether another service is listening on the
same port as the port the vpnagent is using or if some HIDS software is blocking our software from
listening on a port.
Step 6 If the logs do not point directly to a cause, use the trial and error method to identify the conflict. When the
most likely candidates are identified, disable those services (such as VPN products, HIDS software, spybot
cleaners, sniffers, antivirus software, and so on) from the Services panel.
Step 7 Reboot. If the VPN Agent service still fails to start, start turning off services that were not installed by a default
installation of the operating system.
Troubleshoot AnyConnect
7
Troubleshoot AnyConnect
VPN Client Driver Encounters Error (after a Microsoft Windows Update)
If you check the C:\WINDOWS\setupapi.log, you can see the following error:
#W239 The driver signing class list “C:\WINDOWS\INF\certclass.inf” was missing or invalid.
Error 0xfffffbf8: Unknown Error. Assuming all device classes are subject to driver signing
policy.
Solution Check which updates have recently been installed by entering C:\>systeminfo at the command
prompt or checking the C:\WINDOWS\WindowsUpdate.log. Follow the instructions to repair the VPN driver.
Procedure
Driver Crashes
Fix Driver Crashes in VPNVA.sys
Problem VPNVA.sys driver crashes.
Solution Find any intermediate drivers that are bound to the Cisco AnyConnect Virtual Adapter and uncheck
them.
Troubleshoot AnyConnect
8
Troubleshoot AnyConnect
Fix Driver Crashes in vpnagent.exe
Other Crashes
AnyConnect Crashes
Problem You received a “the system has recovered from a serious error” message after a reboot.
Solution Gather the .log and .dmp generated files from the %temp% directory (such as
C:\DOCUME~1\jsmith\LOCALS~1\Temp). Copy the files or back them up. See How to Back Up .log or
.dmp Files.
Procedure
Step 1 Run the Microsoft utility called Dr. Watson (Drwtsn32.exe) from the Start > Run menu.
Step 2 Configure the following and click OK:
Number of Instructions : 25
Number of Errors to Save : 25
Crash Dump Type : Mini
Troubleshoot AnyConnect
9
Troubleshoot AnyConnect
AnyConnect Crashes in vpndownloader (Layered Service Provider (LSP) Modules and NOD32 AV)
Step 3 On the client computer, get the Cisco AnyConnect VPN client log from the Windows Event Viewer by entering
eventvwr.msc /s at the Start > Run menu.
Step 4 Locate the Cisco AnyConnect VPN Client in the Applications and Services Logs (of Windows 7) and choose
Save Log File As... Assign a filename such as AnyConnectClientLog.evt in the .evt file format.
Security Alerts
Microsoft Internet Explorer Security Alert
Problem A security alert window appears in Microsoft Internet Explorer with the following text:
Information you exchange with this site cannot be viewed or changed by others. However,
there is a problem with the site's security certificate. The security certificate was issued
by a company you have not chosen to trust. View the certificate to determine whether you
want to trust the certifying authority.
Solution This alert may appear when connecting to an ASA that is is not recognized as a trusted site. To
prevent this alert, install a trusted root certificate on a client. See Install Trusted Root Certificates on a Client.
Troubleshoot AnyConnect
10
Troubleshoot AnyConnect
Install Trusted Root Certificates on a Client
Solution This security alert may appear when connecting to an ASA that is not recognized as a trusted site.
To prevent this alert, install a trusted root certificate on a client. See Install Trusted Root Certificates on a
Client.
Note You can avoid security certificate warnings in the short term by installing a self-signed certificate as a trusted
root certificate on the client. However, we do not recommend this because of the possibility that a user could
inadvertently configure a browser to trust a certificate on a rogue server and because of the inconvenience to
users of having to respond to a security warning when connecting to your secure gateway.
Procedure
Dropped Connections
Wireless Connection Drops When Wired Connection is Introduced (Juniper
Odyssey Client)
Problem When wireless suppression is enabled on an Odyssey client, the wireless connection drops if a wired
connection is introduced. With wireless suppression disabled, the wireless operates as expected.
Solution Configure the Odyssey Client.
Troubleshoot AnyConnect
11
Troubleshoot AnyConnect
Configure the Odyssey Client
Procedure
Step 1 In Network Connections, copy the name of the adapter as it appears in its connection properties. If you edit
the registry, perform a backup before making any changes and use caution as serious problems can occur if
modified incorrectly.
Step 2 Open the registry and go to HKEY_LOCAL_MACHINE\SOFTWARE\Funk Software,
Inc.\odyssey\client\configuration\options\adapterType\virtual.
Step 3 Create a new string value under virtual. Copy the name of the adapter from Network properties into the registry
portion. The additional registry settings, once saved, are ported over when a customer MSI is created and is
pushed down to other clients.
SVC message: t/s=3/16: Failed to fully establish a connection to the secure gateway (proxy
authentication, handshake, bad cert, etc.).
Solution Uninstall Kaspersky and refer to their forums for additional updates.
Connection to the Host Device Fails (Microsoft Routing and Remote Access
Server)
Problem If you are using RRAS, the following termination error is returned to the event log when AnyConnect
attempts to establish a connection to the host device:
Troubleshoot AnyConnect
12
Troubleshoot AnyConnect
Installation Failures
Solution The third-party load balancer has no insight into the load on the ASA devices. Because the load
balance functionality in the ASA is intelligent enough to evenly distribute the VPN load across the devices,
we recommend using the internal ASA load balancing instead.
Installation Failures
AnyConnect Fails to Download (Wave EMBASSY Trust Suite)
Problem The AnyConnect client fails to download and produces the following error message:
“Cisco AnyConnect VPN Client Downloader has encountered a problem and needs to close.”
Solution Upload the patch update to version 1.2.1.38 to resolve all dll issues.
Incompatibility Issues
Failure to Update the Routing Table (Bonjour Printing Service)
Problem If you are using Bonjour Printing Services, the AnyConnect event logs indicate a failure to identify
the IP forwarding table.
Solution Disable the BonJour Printing Service by typing net stop “bonjour service” at the command prompt.
A new version of mDNSResponder (1.0.5.11) has been produced by Apple. To resolve this issue, a new
version of Bonjour is bundled with iTunes and made available as a separate download from the Apple web
site.
Troubleshoot AnyConnect
13
Troubleshoot AnyConnect
Disable SSL Protocol Scanning
Procedure
Step 1 Go to Protocol Filtering > SSL in the Advanced Setup and enable SSL protocol scanning.
Step 2 Go to Web access protection > HTTP, HTTPS and check Do not use HTTPS protocol checking.
Step 3 Go back to Protocol filtering > SSL and disable SSL protocol scanning.
Solution
• Check the Application, System, and AnyConnect event logs for a relating disconnect event and determine
if a NIC card reset was applied at the same time.
• Ensure that the Venturi driver is up to date. Disable Use Rules Engine in the 6.7 version of the AT&T
Communications Manager.
Troubleshoot AnyConnect
14
Troubleshoot AnyConnect
Performance Issues (Virtual Machine Network Service Drivers)
• Confirm that only one instance of the AnyConnect adapter appears in the Device Manager. If there is
only one instance, authenticate with AnyConnect, and after 5 seconds, manually enable the adapter from
the Device Manager.
• If any suspect drivers have been enabled within the AnyConnect adapter, disable them by unchecking
them in the Cisco AnyConnect VPN Client Connection window.
Troubleshoot AnyConnect
15
Troubleshoot AnyConnect
Known Third-Party Application Conflicts
• Load balancers
• Wave EMBASSY Trust Suite
• Layered Service Provider (LSP) Modules and NOD32 AV
• EVDO Wireless Cards and Venturi Driver
• DSL routers
• CheckPoint and other Third-Party Software such as Kaspersky
• Virtual Machine Network Service Drivers
Troubleshoot AnyConnect
16