7 4 1 System Configuration Guide DV 1 7
7 4 1 System Configuration Guide DV 1 7
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. -2-
CIMC Access 26
Connecting to Your Virtual Edition Appliances 26
1. Configuring Your Environment Using First Time Setup 28
Appliance Configuration Overview 28
Configuring a Manager 29
Configuring a Data Node 33
Configuring a Flow Collector with Data Store 38
Configuring a Flow Collector without Data Store 45
Configuring a Flow Sensor or UDP Director 49
Troubleshooting 52
Certificate Error 52
Accessing the Appliance 52
2. Configuring the Managed System 54
Preparation 54
Appliance Setup Tool Requirements 54
Managed Appliances 54
Manager Failover 54
Secure Network Analytics Domain 55
Best Practices 55
Appliance Configuration Order 56
1. Log In to the Appliance Setup Tool 59
2. Configure the Appliance 60
3. Register the Manager 65
4. Add Appliances to Central Management 66
5. Confirm Appliance Status 67
3. Defining a Manager Failover Relationship 69
Data Store 69
Configuring Failover 69
Primary and Secondary Roles 70
5. Installing v7.4.1 Patches 71
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. -3-
5. Initializing the Data Store 72
6. Installing the Desktop Client 73
Install the Desktop Client Using Windows 74
Install the Desktop Client Using macOS 76
7. Verifying Communications 78
1. Review the Flow Collection Trend 78
2. Verify the Data Store Database Status 78
3. Run Reports in Report Builder 79
9. Finishing Appliance Configurations 80
Changing the Flow Settings in a Flow Collector 81
Configuring UDP Directors for High Availability (Hardware Only) 81
Configuring Forwarding Rules 82
Configuring High Availability 83
Primary Node and Secondary Node 83
Requirements 83
1. Configure the Primary UDP Director High Availability 84
2. Configure the Secondary UDP Director High Availability 85
Configuring the Flow Sensor 86
1. Configure the Application ID and Payload 86
2. Configure the Flow Sensor to Identify Applications (optional) 90
3. Restart the Appliance 90
9. Configuring Telemetry 91
Network Visibility Module 91
Firewall Logs 91
Updating Telemetry Settings 91
Cisco Telemetry Broker 91
11. Licensing Secure Network Analytics 93
Evaluation Mode 93
11. Managing Secure Network Analytics 94
Configuring Host Groups 94
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. -4-
Creating and Managing Policies 94
Building Flow Searches 94
Running Reports in Report Builder 94
Managing User Permissions 94
Investigating Behavior (Alarms, Security Events, etc.) 94
Responding to Threats 95
Apps 96
Authentication/Authorization 97
Configuring SAML SSO 98
Support Details 98
1. Prepare for Configuration 98
2. Upload Certificates to the Trust Store 99
3. Configure the Service Provider 99
4. Enable SSO 101
5. Configure a Service Provider Proxy (optional) 101
6. Configure the Identity Provider 102
7. Add an SSO User 102
8. Test SAML Login 103
Troubleshooting 103
Domains 104
Data Store Domains and Non-Data Store Domains 104
Adding and Configuring Domains 104
1. Add a Domain 105
Creating a Data Store Domain by Importing an Existing Non-Data Store Domain
Configuration (Optional) 106
2. Configure Domain Settings 107
Deleting a Domain 109
1. Remove Flow Collectors from Central Management 109
2. Delete a Domain 109
Deleting a Desktop Client Domain 110
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. -5-
Integrations and Additional Configurations 111
Passwords 112
Enabling or Disabling Password Reset 112
Resetting Passwords to Default Settings 112
Resetting the Admin Password on the Manager 113
Resetting Admin, Root, Sysadmin Passwords to Default 113
Changing Passwords 115
Changing the Sysadmin Password 116
Changing the Root Password 116
Changing the Admin Password on the Manager 116
Changing the Admin Password on All Other Appliances 117
Changing the Data Store Database Passwords 117
Changing the Flow Collector Database Password (Non-Data Store Domains) 117
SSL/TLS Appliance Identity and Additional SSL/TLS Client Identities 119
Appliance Identity 119
Client Identity 119
Reviewing Certificates 119
Adding Appliances to Central Management with Custom Certificates 120
Changing the Host Name, Network Domain Name, or IP Address 120
Reviewing Trust Store Certificates 121
Threat Feed 122
Licensing 122
Enabling 122
Reviewing Alarms and Security Events 122
Central Management (Managing your Appliances) 124
Central Management and Appliance Administration Interface 124
Opening Central Management 125
Opening Appliance Admin 125
Opening Appliance Admin through Central Management 125
Opening Appliance Admin through Direct Login 125
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. -6-
Editing the Appliance Configuration 126
Viewing Appliance Statistics 127
Removing an Appliance from Central Management 127
Removing Data Store Appliances from Central Manager 128
Adding an Appliance to Central Management 128
Creating an Appliance Configuration Backup 130
Enabling/Disabling SSH 130
Open SSH 130
Enable SSH 130
Disable SSH 131
Creating a Database Backup (Non-Data Store Domains) 132
1. Trim the Flow Collector Database 132
1. Review your Database Storage Statistics 132
2. Trim the Interface Details 133
3. Trim Flow Details and CI Event Data 134
2. Delete the Database Snapshots 134
3. Back Up to Remote File System 135
4. Delete the Database Snapshots 137
Restoring a Database Backup (Non-Data Store Domains) 139
Overview 139
Restore a Database 139
Data Store Database 141
Data Store Tab 141
Opening the Data Store Tab 141
Viewing the Data Store Database Status 141
Starting the Database 142
Stopping the Database 142
Starting a Data Node 142
Stopping a Data Node 143
Reviewing Last Action Results 143
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. -7-
Viewing Database Retention 143
Opening the Data Store - Database Retention Tab 143
Database Fullness Chart 144
Per Telemetry Contribution Chart 144
Daily Storage 144
Changing the Flow Interface Data Storage 144
Monitoring the Data Node Update Status 145
Opening the Data Store - Database Update Status Tab 145
Monitoring the Database Update Status 145
Creating a Data Store Backup 148
1. Estimate Backup Host Storage Requirements 148
2. Prepare a Backup Host 148
3. Enable Passwordless SSH Access for dbadmin 149
4. Initialize the Backup Directory on the Backup Host 150
5. Back Up the Data Store Database 153
Data Store Backup Failure 153
Restoring a Data Store Backup 154
1. Review the Backup Names and Software Versions 154
2. Stop the Data Store Database 154
3. Restore the Data Store from a Backup 155
4. Start the Data Store 155
5. Remove the Catalog Snapshot 155
6. Review the Restored Database 156
Data Store Maintenance 157
Enabling Data Compression in the Data Store 157
Adding a Data Store Domain 158
Adding a Secondary Manager or Flow Collectors after the Data Store is Initialized 158
Adding Data Nodes to the Data Store 159
Requirements 159
Before you Begin 159
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. -8-
Procedures 159
1. Create a Data Store Backup 159
2. Configure the Data Node and Add it to Central Management 160
3. Add Data Nodes to the Data Store 160
4. Rebalance Data in the Data Store 160
Replacing a Data Node (Hardware Only) 160
1. Prepare the New (Spare) Data Node 161
2. Create a Data Store Backup 162
3. Contact Cisco Support 162
Adding Data Store to a Non-Data Store Deployment 163
Adding Data Store with an Existing Flow Collector 163
Adding Data Store with a New Flow Collector 164
Troubleshooting 165
Appliance Status: Config Channel Down 165
Appliance Status: Data Store Not Initialized 165
Appliance Status: Data Store Not Configured 165
Opening the Appliance Administration Interface 165
Replacing the Appliance Identity 166
Removing Data Store Appliances from Central Manager 166
Changing the Host Name, Network Domain Name, or IP Address 166
Opening Domain Properties 167
Deleting a Desktop Client Domain 167
Opening the Appliance Setup Tool 167
System Configuration Overview 168
Changing the Trusted Hosts 168
Creating a Diagnostic Pack 169
Resetting Factory Defaults 170
Enabling/Disabling Admin Users 170
Data Store Deployment Troubleshooting 172
Hardware Deployment Troubleshooting 172
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. -9-
Virtual Appliance Deployment Troubleshooting 172
First Time Setup and Data Nodes Virtual Edition 172
Data Store Troubleshooting 172
Vertica Analytics Platform does not automatically restart after a Data Node loses
power and reboots 172
Data Store Does Not Start After Power Failure 174
Installing Patches and Updating Software 175
Contacting Support 176
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 10 -
Introduction
Introduction
Overview
Use this guide to configure the following Cisco Secure Network Analytics (formerly
Stealthwatch) hardware and Virtual Edition appliances to one managed system in v7.4.2:
l Cisco Secure Network Analytics Manager (formerly Stealthwatch Management
Console)
l Cisco Secure Network Analytics Data Node
l Cisco Secure Network Analytics Flow Collector
l Cisco Secure Network Analytics Flow Sensor
l Cisco Secure Network Analytics UDP Director
For more information about Secure Network Analytics, refer to the following online
resources:
l Overview:
https://www.cisco.com/c/en/us/products/security/stealthwatch/index.html
l Appliances:
https://www.cisco.com/c/en/us/products/security/stealthwatch/datasheet-
listing.html
l Release Notes: For details, refer to the Release Notes.
Audience
The intended audience for this guide includes network administrators and other personnel
who are responsible for installing and configuring Secure Network Analytics products.
If you prefer to work with a professional installer, please contact your local Cisco Partner
or Cisco Support.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 11 -
Introduction
Installation Requirements
Before you configure Secure Network Analytics into a managed system using this guide,
install your hardware and virtual appliances using the following guides:
Hardware
l Hardware Installation: Install your appliance hardware (physical appliances) using
the Secure Network Analytics x2xx Series Hardware Installation Guide or the Secure
Network Analytics x3xx Series Hardware Installation Guide before you start this
configuration.
l Specifications: Hardware specifications are available on Cisco.com.
l Supported Platforms: To view the supported hardware platforms for each system
version, refer to the Hardware and Software Version Support Matrix on Cisco.com.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 12 -
Quick Reference Overview
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 13 -
Quick Reference Overview
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 14 -
Quick Reference Overview
7. Verifying Communications
l Log in to your Manager. Review the Flow Collection Trend.
l Review the Data Store database status to confirm it us Up.
(Central Management > Data Store tab)
l Run reports in Report Builder to confirm flows are received at the
Flow Collector and Data Store. (Dashboards > Report Builder
> Flow Collection Trend by Flow Collector Report, Flow Database
Ingest Trend Report)
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 15 -
Quick Reference Overview
9. Configuring Telemetry
Required for Data Store deployments with additional telemetry types
enabled.
l NVM Flows: Follow the instructions in the Endpoint License and
Network Visibility Module (NVM) Configuration Guide
l Firewall Logs: Follow the instructions in the Security Analytics
and Logging: Firewall Event Integration Guide and install the app
on your Manager.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 16 -
Before You Begin
Terminology
This guide uses the term “appliance” for any Secure Network Analytics product,
including virtual products such as the Flow Sensor Virtual Edition (VE).
A "cluster" is your group of Secure Network Analytics appliances that are managed by
the Manager.
Abbreviations
The following abbreviations may appear in this guide:
Abbreviations Definition
GB Gigabyte
IT Information Technology
TB Terabyte
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 17 -
Before You Begin
Abbreviations Definition
VE Virtual Edition
VM Virtual Machine
Configuration Details
The Secure Network Analytics system configuration includes the following:
l Requirements: You can configure Secure Network Analytics with a Data Store,
without a Data Store, or as a hypbrid deployment (both Data store and Non-Data
Store domains). Refer to Planning Your System Configuration to review the
appliance configuration and domain requirements.
l Configuration Order: Make sure you configure the appliances following the
instructions in this guide and using the specified order for the Appliance Setup Tool.
l Certificates: Appliances are installed with a unique, self-signed appliance identity
certificate.
l Central Management: You can manage your appliances from the primary
Manager/Central Manager.
Downloading Software
Use Cisco Software Central to download virtual appliance (VE) installation files, patches,
and software update files. Log in to your Cisco Smart Account at
https://software.cisco.com or contact your administrator.
Password Requirements
During the system configuration, you will replace the default passwords and create new
passwords for the following:
admin lan411cope
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 18 -
Before You Begin
root lan1cope
sysadmin lan1cope
Licensing
For licensing Secure Network Analytics, you will use your Smart Account to register your
product instance, manage licenses, run reports, and configure notifications. Log in to your
Cisco Smart Account at https://software.cisco.com or contact your administrator.
When you use Secure Network Analytics in Evaluation mode, you can use selected
features for 90 days. To use Secure Network Analytics with maximum default
functionality, and to add licenses and features to your account, register your product
instance for Smart Software Licensing. Refer to 11. Licensing Secure Network
Analytics for more information.
Make sure you register your product instance before the 90-day evaluation
period expires. When the evaluation period expires, flow collection will stop. To
start flow collection again, register your product instance.
TLS
Secure Network Analytics requires v1.2.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 19 -
Before You Begin
Browsers
Secure Network Analytics supports the latest version of Chrome, Firefox, and Edge.
Host Name
A unique host name is required for each appliance. We cannot configure an appliance
with the same host name as another appliance. Also, make sure each appliance host
name meets the Internet standard requirements for Internet hosts.
Domain Name
A fully qualified domain name is required for each appliance. We cannot install an
appliance with an empty domain.
NTP Server
l Configuration: At least 1 NTP server is required for each appliance.
l Problematic NTP: Remove the 130.126.24.53 NTP server if it is in your list of
servers. This server is known to be problematic and it is no longer supported in our
default list of NTP servers.
Time Zone
All Secure Network Analytics appliances use Coordinated Universal Time (UTC).
l Virtual Host Server: Make sure your virtual host server is set to the correct time.
Make sure the time setting on the virtual host server (where you will be installing
the virtual appliances) is set to the correct time. Otherwise, the appliances may
not be able to boot up.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 20 -
Planning Your System Configuration
1. In First Time Setup, configure your appliances for a Data Store configuration. Make
sure you configure the following appliances:
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 21 -
Planning Your System Configuration
2. In the Manager Appliance Setup Tool, make sure you create a Data Store domain for
your Secure Network Analytics appliances.
3. To enable telemetry ingest for NVM flows and firewall logs, make sure you complete
the additional configuration instructions in 9. Configuring Telemetry.
1. In First Time Setup, make sure you configure the following appliances:
2. In the Manager Appliance Setup Tool, make sure you create a Non-Data Store
domain for your Secure Network Analytics appliances.
After you finish configuring your managed system, you can add a Data Store to your
deployment in the future (for instructions, refer to Adding Data Store to a Non-Data
Store Deployment).
1. In First Time Setup, configure your appliances without Data Store. Make sure you
configure the following appliances:
2. In the Manager Appliance Setup Tool, make sure you create a Non-Data Store
domain for your Secure Network Analytics appliances.
3. Complete all procedures through 9. Finishing Appliance Configurations to finish
your initial system configuration with a Non-Data Store domain.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 22 -
Planning Your System Configuration
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 23 -
Planning Your System Configuration
Netmask
Gateway
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 24 -
Planning Your System Configuration
Netmask:
The Netmask is hard coded to
255.255.255.0 and cannot be modified.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 25 -
Planning Your System Configuration
CIMC Access
For remote access, log in to the CIMC. If you haven't already configured the CIMC, follow
the instructions in the Cisco UCS C-Series Integrated Management Controller GUI
Configuration Guide.
The default password is password. Make sure you change it when you first log in.
If the virtual machine does not power on, and you receive an error message about
insufficient available memory, do one of the following:
l Resources: Increase the available resources on the system where the
appliance is installed. Refer to Resource Requirements in the Virtual Edition
Appliance Installation Guide for details.
l VMware Environment: Increase the memory reservation limit for the
appliance and its resource pool.
If you choose to deploy Cisco Secure Network Analytics appliances without the
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 26 -
Planning Your System Configuration
4. Access the virtual machine console. Allow the virtual appliance to finish booting up.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 27 -
1. Configuring Your Environment Using First Time Setup
Required
Appliance Instructions for Notes
Data Store
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 28 -
1. Configuring Your Environment Using First Time Setup
Configuring a Manager
1. Log in to the Manager through the console.
l Login: sysadmin
l Default Password: lan1cope
l You will change the default password when you configure the system.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 29 -
1. Configuring Your Environment Using First Time Setup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 30 -
1. Configuring Your Environment Using First Time Setup
5. Port Order Configuration for eth0 (Manager 2210 Hardware Only): Choose one
of the following:
l SFP+: Configure your appliance to use a 10G SFP+/DAC fiber port for eth0.
l BASE-T: Configure your appliance to use a 100Mbs/1GbE/10GbE
BASE-T copper port for eth0. BASE-T is the default.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 31 -
1. Configuring Your Environment Using First Time Setup
8. Select OK to confirm your selection. Follow the on-screen prompts to finish the
virtual environment and restart the appliance.
9. Press Ctrl + Alt to exit the console.
10. Repeat all the steps in Configuring a Manager for the next Manager in your system.
If you've configured all Managers in First Time Setup, return to Appliance
Configuration Overview and configure your Flow Collectors and other appliances.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 32 -
1. Configuring Your Environment Using First Time Setup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 33 -
1. Configuring Your Environment Using First Time Setup
5. Port Order Configuration for eth0 (Hardware Only): Choose one of the following:
l SFP+: Configure your appliance to use a 10G SFP+/DAC fiber port for eth0.
l BASE-T: Configure your appliance to use a 100Mbs/1GbE/10GbE
BASE-T copper port for eth0. BASE-T is the default.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 34 -
1. Configuring Your Environment Using First Time Setup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 35 -
1. Configuring Your Environment Using First Time Setup
9. Configure the physical port (eth2) or port channel (eth2 and eth3) for inter-
Data Node communications.
For hardware Data Nodes, configuring an eth2 port for 10G throughput is
sufficient for normal inter-Data Node communication. Creating an LACP
eth2/eth3 bonded port channel for up to 20G throughput enables faster
communication between and among Data Nodes, and quicker Data Node
addition or replacement to the Data Store, as each new Data Node receives
traffic from adjacent Data Nodes to populate its data. Note that LACP port
bonding is the only bonding option available for hardware Data Nodes.
Field Requirements
Netmask 255.255.255.0
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 36 -
1. Configuring Your Environment Using First Time Setup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 37 -
1. Configuring Your Environment Using First Time Setup
12. Follow the on-screen prompts to finish the environment and restart the appliance.
13. Press Ctrl + Alt to exit the console.
14. Repeat all the steps in Configuring a Data Node for the next Data Node in your
system.
l If you've configured all Data Nodes in First Time Setup, go to the next section
and configure your Flow Collectors with Data Store or return to Appliance
Configuration Overview and configure your other appliances.
l If you've configured all appliances in First Time Setup, go to 2. Configuring
the Managed System.
Starting in v7.4.2, you can transition Non-Data Store Flow Collectors to Data
Store Flow Collectors. Refer to Transitioning Non-Data Store Flow Collectors
to Data Store Flow Collectors for more information.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 38 -
1. Configuring Your Environment Using First Time Setup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 39 -
1. Configuring Your Environment Using First Time Setup
5. Do you want to deploy this Flow Collector as part of a Data Store? Select Yes.
After you choose to configure your Flow Collector for use with Data Store, you
cannot change this configuration. Select Yes only if you plan to deploy a Data
Store to your network.
If you need to deploy Secure Network Analytics without a Data Store, do not
follow the instructions in this section. Follow the instructions in Configuring a
Flow Collector without Data Store.
If you select the wrong choice, deploy a new virtual appliance or RFD your
appliance.
6. Select OK to continue.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 40 -
1. Configuring Your Environment Using First Time Setup
l Default: All telemetry types are selected by default. The asterisk (*) indicates
the selected telemetries.
l Deselecting: To deselect a telemetry, select the telemetry type and click it (or
press the space key on your keyboard).
More Information:
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 41 -
1. Configuring Your Environment Using First Time Setup
8. Enter the UDP port for the selected telemetry types. Select OK.
Make sure your telemetry ports are unique. If you configure duplicate
telemetry ports, the ports will be reset to their internal defaults to avoid loss
of flow data. For example, if NetFlow and NVM are exported to the same
telemetry port, each device exporting NVM data will create an exporter on
the Flow Collector and exhaust the exporter resources in the Flow
Collector engine, resulting in loss of flow data.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 42 -
1. Configuring Your Environment Using First Time Setup
10. Port Order Configuration for eth0 (Flow Collector 4210 Hardware Only): Choose
one of the following:
l SFP+: Configure your appliance to use a 10G SFP+/DAC fiber port for eth0.
l BASE-T: Configure your appliance to use a 100Mbs/1GbE/10GbE
BASE-T copper port for eth0. BASE-T is the default.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 43 -
1. Configuring Your Environment Using First Time Setup
11. Enter the management interface IP Address, Netmask, Gateway, Broadcast, Host
Name, and Domain, then select OK to continue.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 44 -
1. Configuring Your Environment Using First Time Setup
13. Select OK to confirm your selection. Follow the on-screen prompts to finish the
virtual environment and restart the appliance.
14. Press Ctrl + Alt to exit the console.
15. Repeat all the steps in Configuring a Flow Collector with Data Store for the next
Flow Collector in your system.
If you've configured all Flow Collectors for Data Store in First Time Setup, return to
Appliance Configuration Overview to configure your other appliances.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 45 -
1. Configuring Your Environment Using First Time Setup
5. Are you sure you want to continue as sysadmin? Select Yes to continue the
configuration without a Data Store.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 46 -
1. Configuring Your Environment Using First Time Setup
Make sure you select Yes. If you need to deploy Secure Network Analytics with a
Data Store, do not follow the instructions in this section. Follow the instructions
in Configuring a Flow Collector with Data Store.
If you select the wrong choice, deploy a new virtual appliance or RFD your virtual
appliance.
6. Confirm that you are deploying Secure Network Analytics without a Data Store.
Select OK to continue.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 47 -
1. Configuring Your Environment Using First Time Setup
9. Select OK to confirm your selection. Follow the on-screen prompts to finish the
virtual environment and restart the appliance.
10. Press Ctrl + Alt to exit the console.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 48 -
1. Configuring Your Environment Using First Time Setup
11. Repeat all steps in Configuring a Flow Collector without Data Store for the next
Flow Collector in your system.
l If you've configured all Flow Collectors without Data Store in First Time Setup,
go to the next section (Configuring a Flow Sensor or UDP Director) or return
to Appliance Configuration Overview to configure other appliances.
l If you've configured all appliances in First Time Setup, go to 2. Configuring
the Managed System.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 49 -
1. Configuring Your Environment Using First Time Setup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 50 -
1. Configuring Your Environment Using First Time Setup
7. Select OK to confirm your selection. Follow the on-screen prompts to finish the
virtual environment and restart the appliance.
8. Press Ctrl + Alt to exit the console.
9. Repeat all steps in Configuring a Flow Sensor or UDP Director to configure the
next Flow Sensor or UDP Director in your system.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 51 -
1. Configuring Your Environment Using First Time Setup
Troubleshooting
Certificate Error
If your VM environment usage is high, there may be a timing error and some events occur
out of order. If you receive the following error that permission is denied due to a
certificate error (.crt), do the following:
/lancope/admin/plugins/update/.98-FIX-SECRET-PERMS.sh
4. Run SystemConfig.
5. Exit System Configuration.
6. Return to Appliance Configuration Overview and complete all steps in the section.
If you cannot access the appliance, please contact Cisco Support.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 52 -
1. Configuring Your Environment Using First Time Setup
1. Log in as root.
2. Run the following commands and confirm the docker containers and services are up
and running:
l docker ps
l systemctl list-units --failed
l systemd-analyze critical-chain
3. Once all docker containers and services are up and running, try the login again. If
you cannot access the appliance, please contact Cisco Support.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 53 -
2. Configuring the Managed System
Preparation
Before you start the configuration, review the instructions so you understand the
appliance configuration order, best practices, and additional requirements.
l appliance
l subnet mask
l default and broadcast gateways
l NTP and DNS servers
l Manager IP address for Central Management
Managed Appliances
As part of the Appliance Setup Tool, you will configure your appliance to be managed by
your primary Manager.
When your appliances are managed by your Manager, you can use Central Management
to edit appliance configurations, update software, reboot, shut down, and more.
Manager Failover
If you have more than one Manager, you can set up a Manager failover pair so that one of
them serves as backup console to the other.
l Use the Appliance Setup Tool to configure each individual Manager.
l Plan which Manager will be primary and secondary.
l Define the Manager failover relationship after you configure both Managers and all
other appliances with the Appliance Setup Tool. Refer to 3. Defining a
Manager Failover Relationship for details.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 54 -
2. Configuring the Managed System
Best Practices
To configure your system successfully, make sure you follow the instructions in this guide.
Make sure you review the following:
l One at a Time: Configure one appliance at a time. Confirm the appliance is
Connected (or Data Store Not Initialized) before you start configuring the next
appliance in your cluster.
l Order: Follow the appliance configuration order.
l Multiple Central Managers: You can configure more than one Central Manager in
your system. However, each appliance can be managed by only one primary
Manager/Central Manager.
l Access: You need administrator privileges to access Central Management.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 55 -
2. Configuring the Managed System
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 56 -
2. Configuring the Managed System
Management.
After you've completed the system
configuration, you can review the
appliance identity certificates in the trust
stores for each pair. Refer to Reviewing
Trust Store Certificates for details.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 57 -
2. Configuring the Managed System
Your system might not have all the appliances shown here.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 58 -
2. Configuring the Managed System
1. In the address field of your browser, type https:// followed by the IP address of the
appliance.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 59 -
2. Configuring the Managed System
1. Change Default Password: Enter new passwords for admin, root, and sysadmin.
Click Next to scroll to each user.
admin lan411cope
root lan1cope
sysadmin lan1cope
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 60 -
2. Configuring the Managed System
The sysadmin and root menus are unavailable if you've already changed the
default passwords during the hardware installation.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 61 -
2. Configuring the Managed System
3. Host Name and Domains: Enter the following information. Click Next.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 62 -
2. Configuring the Managed System
4. DNS Settings: Confirm the default is correct, or enter your domain server IP
address. Click Next.
5. NTP Settings: Confirm the default is correct, or click the Menu icon to select your
network time protocol (NTP) server. Click Next.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 63 -
2. Configuring the Managed System
6. Your primary Manager is your Central Manager. Add your appliances to Central
Management as follows:
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 64 -
2. Configuring the Managed System
Make sure the primary Manager appliance status is shown as Connected before
you start configuring the next appliance in your cluster using the configuration
order and details.
9. To configure the next appliance in your system, return to 1. Log In to the Appliance
Setup Tool and configure the next appliance in your cluster.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 65 -
2. Configuring the Managed System
1. On the Central Management tab, enter the IP address of your primary Manager.
2. Click Save.
3. Follow the on-screen prompts to trust the primary Manager appliance identity
certificate. Click Yes to trust the certificate and allow the appliance to communicate
with the Manager
l Flow Collectors: Enter the Flow Collection port number. Netflow Default:
2055
l Flow Sensors: Select a Flow Collector.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 66 -
2. Configuring the Managed System
1. The Appliance Setup Tool opens to the Central Management inventory, or you can
open it as follows:
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 67 -
2. Configuring the Managed System
Make sure the primary Manager and each appliance is shown as Connected (or
Data Store Not Initialized) before you start configuring the next appliance in your
cluster using the configuration order and details.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 68 -
3. Defining a Manager Failover Relationship
If your primary Manager goes offline, please note that the Managers do not swap
roles automatically. Make sure you change the Manager roles in the order shown
in the Secure Network Analytics Failover Configuration Guide.
Data Store
If you've deployed Secure Network Analytics with a Data Store, make sure you configure
Failover before you initialize the Data Store. If you configure Failover after you've
initialized the Data Store, follow the instructions in the Secure Network Analytics Failover
Configuration Guide to configure the secondary Manager for secure communication with
the Data Store.
Configuring Failover
To configure your Managers as a failover pair, follow the instructions in the Secure
Network Analytics Failover Configuration Guide.
The guide includes details that are critical for a successful configuration, including:
l Certificates: To set up trust between appliances so they can communicate, make
sure you save the correct certificates to the required appliance Trust Stores.
l Backup Files: Back up the appliances before you start the failover configuration.
l Configuration Order: You will configure the secondary Manager for failover before
you configure the primary Manager.
l Changing Roles: If your primary Manager goes offline, make sure you change the
Manager roles in the order shown in the guide. The order is critical, and they do not
swap roles automatically.
l Troubleshooting: Refer to the Secure Network Analytics Failover Configuration
Guide for solutions.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 69 -
3. Defining a Manager Failover Relationship
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 70 -
5. Installing v7.4.1 Patches
1. Download the latest v7.4.1 patches from your Cisco Smart Account on Cisco
Software Central at https://software.cisco.com.
2. Follow the instructions in the patch readme file to install each patch.
3. After you have updated your appliances with the latest patches, go to the next
procedure in this guide:
l Data Store Domains: Follow the instructions in 5. Initializing the Data Store.
l Non-Data Store Domains: Follow the instructions in 6. Installing the
Desktop Client.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 71 -
5. Initializing the Data Store
Before you start this procedure, add all appliances to your Central Management
inventory.
When you exit the Data Store menu, the system restores your previous SSH
settings.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 72 -
6. Installing the Desktop Client
If your Secure Network Analytics system is deployed with only Data Store Flow
Collectors, you will not use the Desktop Client. For a hybrid Data Store/Non-Data
Store system, the Desktop Client will only work with Non-Data Store domains.
The following information applies to installing and using the Desktop Client:
l You can locally install different versions of Desktop Client.
l The Desktop Client includes Stealthwatch terminology such as Stealthwatch
Management Console and SMC (Manager).
l If you want to access multiple versions of Desktop Client, you will need a different
executable file for each Manager.
l If you are using both a primary and a secondary Manager, you will need to log off
one Manager before you can log in to the other Manager.
l You can have different versions of Desktop Client open simultaneously.
l When you update to a later version of Secure Network Analytics, you will need to
install the new version of Desktop Client.
l Use the Web App to monitor and configure your Secure Network Analytics
installation if you deploy a Data Store. The Desktop Client is incompatible with a
Data Store.
Instructions for installing the Desktop Client vary depending on whether you're using
Windows or macOS:
l Install the Desktop Client Using Windows
l Install the Desktop Client Using macOS
You will also change memory size differently, depending on whether you're using
Windows or macOS:
l Change the Memory Size From Windows Explorer
l Change the Memory Size From Finder
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 73 -
6. Installing the Desktop Client
Use the following instructions to install the Desktop Client using Windows:
You can change how much Random Access Memory (RAM) to allocate on your
client computer to run the Desktop Client interface.
Consider a larger memory allocation if you work with many open documents or large data
sets (such as flow queries with over 100k records).
3. In the Stealthwatch directory, open the folder that contains the desired
Stealthwatch version.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 74 -
6. Installing the Desktop Client
Minimum Memory Size (Xms): We recommend that you allocate no less than 512
MB. This number is listed in the third line of the file.
For editors that display the content in one continuous line, refer to the number
highlighted in the image below to see which number represents the minimum
memory size.
Maximum Memory (Xmx): You can allocate up to half the size of your computer's
RAM for the maximum memory size. This number is listed in the fourth line of the
file.
For editors that display the content in one continuous line, refer to the number
highlighted in the image below to see which number represents the maximum
memory size.
l If you notice that the Desktop Client appears to "hang" frequently, try
increasing the memory size.
l If you receive an error message involving Java, try selecting a lower
memory allocation.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 75 -
6. Installing the Desktop Client
Use the following instructions to install the Desktop Client using macOS:
You can change how much Random Access Memory (RAM) to allocate on your
client computer to run the Desktop Client interface.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 76 -
6. Installing the Desktop Client
Consider a larger memory allocation if you work with many open documents or large data
sets (such as flow queries with over 100k records).
Minimum Memory Size (Xms): We recommend that you allocate no less than 512
MB. This number is listed in the third line of the file.
For editors that display the content in one continuous line, refer to the number
highlighted in the image below to see which number represents the minimum
memory size.
Maximum Memory Size (Xmx): You can allocate up to half the size of your
computer's RAM for the maximum memory size. This number is listed in the fourth
line of the file.
For editors that display the content in one continuous line, refer to the number
highlighted in the image below to see which number represents the maximum
memory size.
l If you notice that the Desktop Client appears to "hang" frequently, try
increasing the memory size.
l If you receive an error message involving Java, try selecting a lower
memory allocation.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 77 -
7. Verifying Communications
7. Verifying Communications
1. Review the Flow Collection Trend
1. Log in to your primary Manager.
If the database status is Down, click the (Ellipsis) icon in the Actions column for
the database. Select Start.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 78 -
7. Verifying Communications
If a Data Node status is Down, click the (Ellipsis) icon in the Actions column for
the Data Node. Select Start.
For more information about the Data Store tab, refer to Data Store Database.
For more information about Report Builder, refer to the information in the Help.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 79 -
9. Finishing Appliance Configurations
Required Optional
Appliance
Configurations Configurations
Data Compression
Data Node none
Flow Interface Statistics
High Availability
UDP Directors none (available on hardware
only)
Application ID and
Flow Sensors Identifying Applications
Payload
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 80 -
9. Finishing Appliance Configurations
If the engine_startup_mode field does not appear in the Advanced Settings list,
you can add it at the bottom of the page by using the Add New Option and
Option Value fields.
l 2055 - NetFlow
l 6343 - sFlow
Once the mode switch (NetFlow to sFlow or sFlow to NetFlow) completes, the
following items that are based on flows from the previous mode are cleared:
l Caches: host cache, flow cache, security event cache
l Saved baseline files
You can confirm the mode switch by checking the flow trend graph on the dashboard to
see if flows are being processed under the new mode.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 81 -
9. Finishing Appliance Configurations
l Forwarding Rules: Configure at least one forwarding rule if you're planning to set
up High Availability. Refer to Configuring Forwarding Rules
l High Availability: If you have more than one UDP Director, you can set up a High
Availability pair. Configure at least one forwarding rule if you're planning to set up
High Availability (refer to Configuring High Availability).
3. Click the Actions menu for the appliance. Select Configure Forwarding Rules.
l Range: You can use Classless Inter-Domain Routing (CIDR) notation to enter a
range of IP addresses.
l All: You can type "All" to accept data from any source IP address on this port.
Examples:
l 10.11.16.38:5322
l 192.168.0.0/16:9000
l All:2055
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 82 -
9. Finishing Appliance Configurations
7. Destination IP Address: Enter the IP address of the device receiving data from the
UDP Director.
8. Destination Port Number: Enter the port number for the receiving device.
9. Click Save.
10. Optional: To sync your changes, click Sync.
The UDP Director High Availability (HA) allows a user to configure settings for redundant
UDP Directors. Both nodes are fully redundant, however only one node is online at a time.
If you have high availability configured on your UDP Directors and update Secure
Network Analytics to version 7.4.0 or later, reconfigure high availability after the
update using the instructions below.
For more information about updating Secure Network Analytics, refer to the
Update Guide.
Requirements
l Forwarding Rules: Configure at least one forwarding rule for the UDP Director in
the High Availability system.
l Save the Rules Configuration File: If the UDP Director has already been configured
with rules, export (save the rules configuration file) the UDP Director rules. Then,
import the file to the second UDP Director to ensure that the rules for each match.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 83 -
9. Finishing Appliance Configurations
l Order: Configure the Primary UDP Director and then repeat the configuration on the
Secondary one.
l New or Established: If the both UDP Directors are new, make sure you follow the
procedures for each in this guide. However, if the secondary is already configured
as an appliance on the Secure Network Analytics system, log in to the secondary
UDP Director and configure its High Availability components as described here.
3. Check the Enable High Availability Service check box for the High Availability
Settings.
4. Select your Node ID. If this is a primary UDP Director, select 1. If this a secondary
UDP Director, select 2.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 84 -
9. Finishing Appliance Configurations
5. In the Virtual IP Address field, enter an unused IP adddress that is on the same
subnet as the eth0 interface. Set the Subnet Mask value to the value of the subnet
mask used on the eth0 interface.
6. In the Shared Secret field, type a string for both UDP Directors. (This will be
encrypted for secure transfer.)
7. In the fields for Sync Ring #1 (eth2) Unicast IP Address, enter the IP address and
the subnet mask. (A Unicast IP Address identifies a single network destination.)
8. In the fields for Sync Ring #2 (eth3) Unicast IP Address, enter the IP address and
the subnet mask.
9. In the Paired Node Host Name field, enter the host name for the secondary UDP
Director.
10. In the Paired Node Sync Ring #1(eth2) IP Address field, enter the Eth2 IP address
for the secondary UDP Director.
11. In the Paired Node Sync Ring #1(eth3) IP Address field, enter the Eth3 IP address
for the secondary UDP Director.
12. After reviewing the setting, click Apply to set the configuration.
13. Continue to the next section to configure the second UDP Director of the cluster.
If you selected Node ID 2 in step 4 above, complete the steps below for the
primary UDP Director.
3. Enter the host name for the secondary UDP Director into the Paired Node Host
Name field.
4. Configure all of the parameters on this screen (including any Advanced Parameters
that you may have changed on the first appliance) exactly as you did on the first
appliance with exactly same values for every field except for the following:
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 85 -
9. Finishing Appliance Configurations
5. Click Apply to save your changes and to start the clustering services on this
appliance.
6. Click Promote to designate the primary appliance.
Item Description
Allows you to specify whether the Flow Sensor includes the first
Export Packet
26 bytes of binary payload data in the data that it sends to the
Payload
collector.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 86 -
9. Finishing Appliance Configurations
Item Description
Enable ERSPAN Allows you to specify whether to Flow Sensor uses Encapsulated
Decapsulation Remote Switching Port Analyzer (ERSPAN) decapsulation
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 87 -
9. Finishing Appliance Configurations
Item Description
Allows you to specify whether the Flow Sensor 4000 series can
Enable Load distribute flow data to more than one Flow Collector.
Balancing Use this option if the flow data from the Flow Sensor exceeds the
capacity of one Flow Collector.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 88 -
9. Finishing Appliance Configurations
Item Description
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 89 -
9. Finishing Appliance Configurations
4. If you have more than 1 monitoring NIC, select one of the following options in the
Cache Mode section:
l Use single, shared, cache for all monitoring ports: typically used for
systems that monitor flows using the TAP method.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 90 -
9. Configuring Telemetry
9. Configuring Telemetry
If you've deployed Secure Network Analytics with a Data Store, your Flow Collectors can
ingest multiple types of telemetry simultaneously. You can configure your Flow Collectors
during First Time Setup or, if it is an existing Flow Collector, you can update the telemetry
ingest settings using Flow Collector Advanced Settings.
Firewall Logs
If you select and configure Firewall Logs, the Flow Collector will ingest and store firewall
event logs for Cisco Security Analytics and Logging (On Premises). Follow the
instructions in the Security Analytics and Logging: Firewall Event Integration Guide to
complete the configuration requirements.
App Requirement: If you select and configure Firewall Logs, install the Security Analytics
and Logging (OnPrem) app on your Manager.
Each telemetry type has two settings. For more information on configuring
telemetry using Advanced Settings, follow the instructions in the Help. Select
Help > Help.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 91 -
9. Configuring Telemetry
To install Cisco Telemetry Broker, follow the instructions in the Cisco Telemetry Broker
Virtual Appliance Deployment and Configuration Guide.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 92 -
11. Licensing Secure Network Analytics
Evaluation Mode
When you use Secure Network Analytics in Evaluation mode, you can use selected
features for 90 days. To use Secure Network Analytics with maximum default
functionality, and to add licenses and features to your account, register your product
instance for Smart Software Licensing.
Make sure you register your product instance before the 90-day evaluation
period expires. When the evaluation period expires, flow collection will stop. To
start flow collection again, register your product instance.
l Admin User: To review Smart Licensing status and usage details in your Manager,
log in as the admin user.
l Days Remaining: To review the days remaining in Evaluation Mode, log in to the
Manager as the admin user. Go to Central Management > Smart Licensing.
Review the License Authorization Status.
l Product Instance: The Product Instance Name is the identifier we use for your
Secure Network Analytics product instance, which includes your Manager and
managed appliances.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 93 -
11. Managing Secure Network Analytics
To review the instructions, select the (User) icon > Help from any page.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 94 -
11. Managing Secure Network Analytics
Responding to Threats
For policy information, review the information in Help.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 95 -
Apps
Apps
Secure Network Analytics apps are optional independently releasable features that
enhance and extend the capabilities of Secure Network Analytics.
The release schedule for Secure Network Analytics apps is independent from the normal
Secure Network Analytics upgrade process. Consequently, we can update Secure
Network Analytics apps as needed without having to link them with a core Secure
Network Analytics release. Occasionally, an app that is designed to correspond with a
new release of Secure Network Analytics may not be immediately available for
installation. You may need to wait a few weeks for the newest version of the app.
For the latest Secure Network Analytics apps information, availability, and compatibility,
refer to the following:
l Secure Network Analytics Apps Version Compatibility Matrix
l Secure Network Analytics Apps Release Notes
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 96 -
Authentication/Authorization
Authentication/Authorization
For details about each authentication or authorization configuration with Secure Network
Analytics, refer to the following instructions.
Name Instructions
Security Assertion Markup Language Refer to the Configuring SAML SSO section
Single Sign-On (SAML SSO) in this guide.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 97 -
Authentication/Authorization
Support Details
Please note the following configurations are supported or not supported.
Requirement Details
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 98 -
Authentication/Authorization
If the IDP URL does not start with HTTPS, you can skip this step and go to the
next section, 3. Configure the Service Provider.
Use the following instructions to add the root CA certificate to the Manager Trust Store.
1. On the Central Management Appliance Manager page, click the Actions menu for
the Manager.
2. Select Edit Appliance Configuration.
3. On the Appliance Manager > General tab, locate the Trust Store section.
4. Click Add New.
5. In the Friendly Name field, enter a name for the certificate.
6. Click Choose File. Select the new certificate.
7. Click Add Certificate. Confirm the new certificate is shown in the Trust Store list.
8. Click Apply Settings. Follow the on-screen prompts.
9. Connected: On the Appliance Manager page, make sure the Manager finishes the
configuration changes and the Appliance Status returns to Connected.
Do not force the appliance to reboot while configuration changes are pending.
10. If you have a secondary Manager, repeat this procedure to add the root CA
certificate to the secondary Manager Trust Store.
11. If you have added the root CA certificate to the Manager Trust Stores, go to the next
section.
If you update any meta data on your LDP, you may notice that SSO does not
connect. The meta data needs to be updated. The easiest way to do this is to
simply reboot after updating your new SSO information in the System
Configuration tool.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 99 -
Authentication/Authorization
4. Select SSO.
5. Confirm ssoEnable/Disable is shown as Disabled.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 100 -
Authentication/Authorization
4. Enable SSO
1. Select ssoEnable/Disable.
2. Follow the on-screen prompts to enable SSO.
3. Select CredentialDescription. Click Continue.
4. Enter a description of the SSO service credentials users need to log in.
5. Click OK.
6. Select DownloadIDP. Disable DownloadIDP until you need to save a new SSO
configuration.
l Click Continue.
l Follow the on-screen prompts to disable DownloadIDP.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 101 -
Authentication/Authorization
4. Click OK.
5. Reboot your Manager to complete the proxy configuration process.
l For example: If the Attribute store is the Active Directory, set the outgoing
claim type to the email address for the LDAP Attribute type user ID.
l Microsoft Active Directory Federation Services (ADFS): If the IDP type is
ADFS, confirm the following custom rule is shown:
c:[Type ==
"http://schemas.microsoft.com/ws/2008/06/identity/claims/windowsaccountname"] => issue
(Type = "http://schemas.xmlsoap.org/ws/2005/05/identity/claims/nameidentifier", Issuer
= c.Issuer, Value = c.Value, ValueType = c.ValueType, Properties
["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/format"] =
"urn:oasis:names:tc:SAML:2.0:nameid-format:transient", Properties
["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/namequalifier"] =
"http://<IDP FQDN>/adfs/com/adfs/service/trust", Properties
["http://schemas.xmlsoap.org/ws/2005/05/identity/claimproperties/spnamequalifier"] =
"https://<SMC FQDN>/fedlet");
For instructions, click the User icon. Select Help. For details about adding
users, refer to "Configuring Users."
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 102 -
Authentication/Authorization
5. Complete the fields to create a new user. Configure the user as follows:
l Authentication Service: Select SSO.
l User Name: Enter the first part of the email address for the IDP account. Make
sure the ID is identical to the one that will be used for SSO at login. For
example, for [email protected], enter "name" in this field.
6. Click Save.
7. Confirm the SSO User is shown in User Management.
Troubleshooting
Scenario Notes
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 103 -
Domains
Domains
A domain is a grouping of hosts and other devices that you want to monitor and manage. Flow
Collectors exist within domains, and you can have multiple domains within one Secure
Network Analytics system. Domains are completely independent of other domains, and every
domain contains the Host Group tree. For information about which host groups exist in the
Host Group tree, see Managing and Configuring Host Groups in the Help.
This section includes the following topics:
l Data Store Domain: The Flow Collector sends its telemetry to the Data Store Data
Nodes for storage.
l Non-Data Store Domain: The Flow Collector stores its telemetry locally on the Flow
Collector or on the Flow Collector database (5000 Series only).
l Hybrid Configuration: In Secure Network Analytics with a hybrid configuration, you can
configure a Data Store domain and Non-Data Store domain. When you configure your
Flow Collectors, you can choose which domain they will use, which determines where
they send data.
If you are adding a Data Store domain to a Non-Data Store deployment, review the
instructions in Adding Data Store to a Non-Data Store Deployment.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 104 -
Domains
1. Add a Domain
1. From the menu bar, choose [Current domain name] > Add Domain.
l Domain Name: The name to be assigned to the domain. This name is shown on
the Host Group tree.
l Select Method: Select one of the methods described in the table below to
designate which host group structure you want to use for the domain you are
adding.
Secure Network Analytics creates the domain with the default host
Default
group structure but without any Flow Collectors.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 105 -
Domains
3. Select Add a Domain to select your domain type. A Data Store domain is for Secure
Network Analytics systems that are using a Data Store, and a Non-Data Store domain is
for Secure Network Analytics systems that are not using a Data Store. For details, refer
to Data Store Domains and Non-Data Store Domains.
Check the Configure as a Data Store Domain check box if you are adding a Data Store
domain.
Do not turn on Analytics if you have created more than one Data Store domain as this
will cause Analytics to have sub-optimal performance.
1. Use the Add a Domain drop-down menu to select your Non-Data Store domain.
2. Select Configure > Domain Properties from the top menu.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 106 -
Domains
3. Make sure the Export All configuration radio button is selected. Refer to the
Configuring Domain Settings section below to view a list of the data that is exported.
4. Click the Export button to download the XML file.
5. In the upper left corner of any page, at the left end of the main menu, choose [Current
domain name] > Add Domain.
6. Enter a name for your new domain in the Domain Name field.
7. Click the Select Method drop-down menu and select the Import from File option.
8. Select the XML file you downloaded in step 4.
9. Click the Configure as a Data Store domain check box to select it.
10. Click the Add button to add your new domain.
Setting Description
Domain Name Name for the domain you are currently in.
Allows you to set the time at which each Flow Collector in the
domain clears all counts. You can enter whole numbers between
0 and 23, where 0 is midnight in your local time zone. The local
time zone is indicated to the right of the Archive hour field.
Archive Hour
At the defined time, the Flow Collector resets all index counts to
0. In addition, the Flow Collector saves the log files and Web files
that it has gathered during the preceding 24 hours and then
begins a new day of data collection.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 107 -
Domains
The Export page on the Domain Properties dialog allows you to export specific domain
content. You may want to use the content as a template for any additional domains you
add in the future.
Refer to the following table for information about the available settings.
Export the Host The entire host group definition structure, including the host group
Group configuration* names and IP address ranges. This output does not include policies.
Mitigation alarm actions are only exported when they have been
manually changed from the defaults (set to Not inherited).
* You can use any of the XML files resulting from these commands to replace the host group
configuration. For more information, see the "How to Replace the Host Group Configuration"
topic in the Desktop Client help.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 108 -
Domains
3. Click Export.
Secure Network Analytics saves the corresponding settings in an XML file that is
downloaded to your Downloads folder.
Deleting a Domain
Before you delete a domain, review these instructions to make sure you understand the
requirements.
When you delete a domain, you will lose access to all data that has been collected for
that domain. Make sure you only delete a domain if you no longer need access to the
collected data in it.
If you remove Flow Collectors from Central Management and delete the domain, you will
lose the associated Flow Collector data.
2. Delete a Domain
1. If you first need to access the domain, choose the [Current domain name] from the drop-
down menu.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 109 -
Domains
When you delete a domain, you will lose access to all data that has been collected for
that domain. Make sure you only delete a domain if you no longer need access to the
collected data in it.
Use caution when deciding which Desktop Client domains you want to delete as you will
lose access to all data which has been collected for the domain you are deleting.
Workaround: If you accidentally delete all of your domains in the Desktop Client and lock
yourself out of the Manager Web App, create a new Non-Data Store domain in the
Desktop Client. This will allow you to regain access into the Manager Web App. For
information on creating a domain refer to the Add a Domain topic in the Desktop Client
help.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 110 -
Integrations and Additional Configurations
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 111 -
Passwords
Passwords
You can change passwords as follows:
l Enabling or Disabling Password Reset
l Resetting Passwords to Default Settings
l Changing Passwords
l Changing the Data Store Database Passwords
l Changing the Flow Collector Database Password (Non-Data Store Domains)
If you disable the password reset, and you lose your passwords, you will lose
access to the data saved to your appliance. To access the appliance again, reset
factory defaults and reconfigure it.
After you reset your appliance passwords to the default, make sure you change
them. This step is critical for security. Refer to Changing Passwords for
instructions.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 112 -
Passwords
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 113 -
Passwords
The command line might look slightly different depending on your appliance
version.
5. Type resetpassword after c=off to make the command line look like the following
example:
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 114 -
Passwords
This will reset your admin, root, and sysadmin passwords to their default values.
7. Go to Changing Passwords to change the passwords from the default. This step is
critical for security.
Changing Passwords
Use the following instructions to change your passwords from the default password or a
previous password. Make sure you use the following criteria:
admin lan411cope
root lan1cope
sysadmin lan1cope
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 115 -
Passwords
l URL: https://<IPAddress>
l Login: admin
l Default Password: lan411cope
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 116 -
Passwords
l URL: https://<IPAddress>
l Login: admin
l Default Password: lan411cope
Your previous SSH settings are restored when you exit the Data Store menu.
Make sure you change the default password. When a new Flow Collector is
added to Central Management, the database password automatically updates to
match the current password.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 117 -
Passwords
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 118 -
SSL/TLS Appliance Identity and Additional SSL/TLS Client Identities
Your certificates are critical for your system’s security. Improperly modifying
your certificates can stop Secure Network Analytics appliance communications
and cause data loss. Follow the instructions in the SSL/TLS Certificates for
Managed Appliances Guide for all certificate-related changes.
Appliance Identity
Each Secure Network Analytics version 7.x appliance is installed with a unique, self-
signed appliance identity certificate. To replace the appliance identity certificate, follow
the instructions in the SSL/TLS Certificates for Managed Appliances Guide.
The appliance uses the SSL certificate to verify its identity to other appliances. For
example, when a Manager generates a flow query and communicates to a Flow Collector,
the Manager is authenticated by presenting its server identity certificate. The Flow
Collector checks if this presented server identity certificate is a trusted certificate.
Client Identity
The client identity is used for communication between external services. For details,
follow the instructions in the SSL/TLS Certificates for Managed Appliances Guide.
Reviewing Certificates
Use the following instructions to review the appliance identity certificate or client
certificates for the selected appliance.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 119 -
SSL/TLS Appliance Identity and Additional SSL/TLS Client Identities
Your certificates are critical for your system’s security. Improperly modifying
your certificates can stop Secure Network Analytics appliance communications
and cause data loss. Follow the instructions in the SSL/TLS Certificates for
Managed Appliances Guide for all certificate-related changes.
If your appliance has custom certificates, make sure you save the identity
certificate and certificate chain (root and intermediate) to the Manager Trust
Store before you add the appliance to Central Management. For instructions,
refer to the SSL/TLS Certificates for Managed Appliances Guide.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 120 -
SSL/TLS Appliance Identity and Additional SSL/TLS Client Identities
When you add a certificate to your appliance Trust Store, your appliance trusts
that identity and allows communication with it. Follow the instructions in the
SSL/TLS Certificates for Managed Appliances Guide for all trust store changes.
Use the following instructions to review the certificates saved to the selected appliance
Trust Store.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 121 -
Threat Feed
Threat Feed
The Cisco Secure Network Analytics Threat Feed (formerly Stealthwatch Threat
Intelligence Feed) provides data from the global Threat Feed about threats to your
network. The feed updates frequently and includes IP addresses, port number, protocols,
host names, and URLs known to be used for malicious activity. The following host groups
are included in the feed: command-and-control servers, bogons, and Tors.
Licensing
Add the Threat Feed License to your Cisco Smart Account. For instructions, refer to the
Secure Network Analytics Smart Software Licensing Guide.
Enabling
To enable the feed in Central Management, follow the instructions in the help. Please note
that you will configure the DNS server and firewall as part of the instructions.
Help: To access the Help, right-click the Stealthwatch Labs Intelligence Center
branch and select Configuration > SLIC Threat Feed Configuration. Click Help.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 122 -
Threat Feed
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 123 -
Central Management (Managing your Appliances)
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 124 -
Central Management (Managing your Appliances)
Appliance-specific configurations
If you configure a Flow Collector for Data Store compatibility, the Appliance
Administration interface (Appliance Admin) hides certain functionality. Use
Central Management to configure the Flow Collector and other related tasks.
https://<IPAddress>
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 125 -
Central Management (Managing your Appliances)
2. Press Enter.
or
Click each tab to review each configuration category.
4. Make changes to each configuration section as needed. You can edit more than one
configuration category on each configuration tab.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 126 -
Central Management (Managing your Appliances)
5. Click Apply Settings. Follow the on-screen prompts to save your configuration
changes.
Some changes require a system reboot. If you prefer to wait, you can revert your
changes and edit your configuration settings and reboot later.
The appliance reboots automatically. Do not force the appliance to reboot while
configuration changes are pending. To confirm the appliance status is
Connected, review Central Management > Appliance Manager inventory.
6. Connected: On the Appliance Manager page, make sure the appliance finishes the
configuration changes and the Appliance Status returns to Connected.
1. On the Central Management Appliance Manager page, click the Actions menu for
the appliance.
2. Select View Appliance Statistics.
3. Log in to the Appliance Administration interface.
1. On the Central Management Appliance Manager page, click the Actions menu for
the appliance.
2. Select Remove This Appliance.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 127 -
Central Management (Managing your Appliances)
If your appliance has custom certificates, make sure you save the identity
certificate and certificate chain (root and intermediate) to the Manager Trust
Store before you add the appliance to Central Management. For instructions,
refer to the SSL/TLS Certificates for Managed Appliances Guide.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 128 -
Central Management (Managing your Appliances)
Log in to the appliance console as sysadmin and follow the on-screen prompts to
configure the IP address, host name, and domain. For instructions, refer to your
Secure Network Analytics hardware or Virtual Edition installation guide.
l New Installations: If this is a new installation, make sure you complete the
installation and configure the IP address, host name, and domain before you add it
to Central Management. For instructions, refer to 1. Configuring Your Environment
Using First Time Setup.
If your appliance has custom certificates, make sure you save the identity
certificate and certificate chain (root and intermediate) to the Manager Trust
Store before you add the appliance to Central Management. Refer to the
SSL/TLS Certificates for Managed Appliances Guide.
https://<IPAddress>/lc-ast
3. Press Enter.
8. For more information about the Appliance Setup Tool, refer to 1. Configuring
Secure Network Analytics
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 129 -
Central Management (Managing your Appliances)
Before you back up an appliance, make sure you follow the instructions in the
Help. To back up a Data Store, refer to Creating a Data Store Backup. To back
up a Flow Collector database, refer to Creating a Database Backup (Non-Data
Store Domains).
Enabling/Disabling SSH
Use this section to control the ability to access the appliance using SSH (secure shell).
Default: disabled
Open SSH
Use the following instructions to open SSH for a selected appliance.
Enable SSH
1. Locate the SSH section.
2. To allow SSH access on the appliance, check the Enable SSH check box.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 130 -
Central Management (Managing your Appliances)
3. To allow root access on the appliance, check the Enable Root SSH Access check
box.
4. Click Apply Settings.
5. Follow the on-screen prompts.
Disable SSH
1. To remove SSH access on the appliance, click the Enable SSH check box to clear it.
2. To remove root access on the appliance, click the Enable Root SSH Access check
box to clear it.
3. Click Apply Settings.
4. Follow the on-screen prompts.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 131 -
Creating a Database Backup (Non-Data Store Domains)
Without a backup, you will not be able to recover your files if a problem occurs
during the update process. Make sure you follow the instructions and complete
all procedures for the database backup. Also note that this procedure only
applies to Non-Data Store Flow Collectors. For assistance, contact Cisco
Support.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 132 -
Creating a Database Backup (Non-Data Store Domains)
Backing up this data takes time. If you don't need all of it, shorten the storage limit (for
example: 7 days). Any data older than the limit will be lost.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 133 -
Creating a Database Backup (Non-Data Store Domains)
Use the following instructions to purge the database of the interface statistics data older
than the limit you set, so you can free up the available disk space for storing flows.
Make sure you delete the Manager and Flow Collector database snapshots. This
step is critical for a successful backup.
1. Log in to the Manager and Flow Collector appliance database console as admin.
2. Check for Snapshots: Type:
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 134 -
Creating a Database Backup (Non-Data Store Domains)
ls /lancope/var/database/dbs/sw/v_sw_node0001_data/Snapshots/
If the results are not empty, continue to wait. You may need to wait several minutes
until the folder is removed, depending on the size of the database.
5. Repeat steps 1 through 4 to delete all saved Manager and Flow Collector database
snapshots.
1. Return to the Appliance Admin interface (but do not close the Desktop Client).
2. Determine how much space you will need on the remote file system to store the
database backup as follows:
l Click Home.
l Locate the Disk Usage section.
l Review the Used (byte) column for the /lancope/var file system. You will
need at least this much space plus 15% more on the remote file system to
store the database backup.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 135 -
Creating a Database Backup (Non-Data Store Domains)
4. Complete the fields using the settings for the remote file system where you want to
store the backup files.
The file share uses the CIFS (Common Internet File System) protocol, also known as
SMB (Server Message Block).
If the Apply button is not enabled after you enter the password, click once in a blank
area on the Remote File System page to enable it.
6. Click Test to verify that the appliance and the remote file system can communicate
with each other.
You should see the following message at the bottom of the Remote File System
page when the test is complete.
7. Click Support > Backup/Restore Database. The Backup Database page opens as
shown in the following example.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 136 -
Creating a Database Backup (Non-Data Store Domains)
l After the backup process starts, you can mouse away from the page without
interrupting the process. However, if you click Cancel while the backup is in
progress, you may not be able to resume the backup without restarting the
appliance.
l Follow the on-screen prompts until the backup is completed.
l To view details of the backup process, click View Log.
If you cancel the backup before it finishes, make sure you delete the database
snapshots again. See 4. Delete the Database Snapshots for detailed
instructions.
Make sure you delete the Manager and Flow Collector database snapshots. This
step is critical for a successful update.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 137 -
Creating a Database Backup (Non-Data Store Domains)
ls /lancope/var/database/dbs/sw/v_sw_node0001_data/Snapshots/
If the results are not empty, continue to wait. You may need to wait several minutes
until the folder is removed, depending on the size of the database.
5. Repeat steps 1 through 4 to delete all saved Manager and Flow Collector database
snapshots.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 138 -
Restoring a Database Backup (Non-Data Store Domains)
Overview
We recommend that you contact Cisco Support before restoring a database.
The Restore Database operation will overwrite your current database and configuration
with the contents of the previous backup. Existing network settings are not overwritten.
l Same Version: You cannot use a backup file from a previous version of the Secure
Network Analytics appliance to restore an appliance database. Make sure the
backup file version matches the appliance version.
l Restore Previous Backup: You can use a command line interface to restore a
previous backup of the database. The database that is backed up is the database
that exists in the previously configured remote file system (the file share).
l Default: If you do not specify the name of the database to be restored, the default
name (your system's serial number) will be used.
Restore a Database
The Restore Database operation will overwrite your current database and
configuration with the contents of the previous backup. Existing network settings
are not overwritten.
After the operation has started, you can leave the page ("mouse away"), and the process
will continue without interruption. When you return, the status will be updated.
1. Log into the appliance console as sysadmin to access the root shell.
2. Type sysadmin and then press Enter.
3. When the password prompt appears, type lan1cope and then press Enter.
4. On the System Configuration menu, select Advanced and the press Enter.
5. Select Root Shell and then press Enter.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 139 -
Restoring a Database Backup (Non-Data Store Domains)
cd /var/tmp
nohup doDbRestore -c –q &
To see the switches that are available with this tool, enter this command:
doDbRestore -h
If you do not specify the name of the database to be restored, the default name
(your system's serial number) will be used.
8. To check the status of a restore operation that is in progress, you can display two
files:
/lancope/var/logs/VerticaRestore.log
/lancope/var/logs/DatabaseRestore.log
After the system completes the restore operation, it will reboot and then begin
collecting data.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 140 -
Data Store Database
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 141 -
Data Store Database
Make sure you use the Actions menu to start or stop your database (or a Data
Node).
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 142 -
Data Store Database
All of the charts as well as the Data Storage Statistics section on this page are
updated once per day.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 143 -
Data Store Database
Daily Storage
The Daily Storage section displays the incremental amount of data that was added to your
database on the previous day. By monitoring your daily storage rate, you can evaluate
how quickly your database is filling as well as how much each telemetry type is
contributing to your daily storage accumulation.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 144 -
Data Store Database
Flow interface statistics consume storage at a higher rate, potentially reducing the time
you can retain other important data (such as flow statistics).
Changing the flow interface data storage period here only impacts the NetFlow
portion of the data that is occupying space in your system. The default is 7 days.
You can increase or decrease the retention days as needed.
l When you change the retention to a longer period, wait for the difference of
time to expire before the data being stored corresponds exactly to the
retention settings. Until that time, the data is displayed using the most
reduced (coarsest) resolution available. For example, if you change the
retention from 3 days to 10 days, then you need to wait 7 days before the data
being stored corresponds exactly to the retention settings.
l Your data may be deleted sooner than the retention period you select, due to
critical trimming of data according to disk usage. If you choose to store data
as long as possible, when the Data Store reaches full capacity, the system
starts deleting the oldest data.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 145 -
Data Store Database
For a successful update, follow the update order and instructions in the Cisco
Secure Network Analytics System Update Guide.
Some of the state transitions shown in the image below happen very quickly
during the update process so you may not see them occur during a screen
refresh.
The Database Update Status tab shows the current update status for your Data Nodes.
After you start a software update (upgrade or patch) in Update Manager, use this
Database Update tab to monitor the status of each Data Node to confirm it completes the
update. To see visual representation of the update workflow, click View Diagram.
After the update is completed, go to the Data Store Database to confirm your database
status is Up. For more information, refer to the Update Guide.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 146 -
Data Store Database
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 147 -
Creating a Data Store Backup
3. Enable Passwordless SSH Access for dbadmin.Make sure all Data Nodes can
reach the backup host using passwordless SSH access.
4. Initialize the Backup Directory on the Backup Host
5. Back Up the Data Store Database
2. Copy the following command, paste it into the command line, and press Enter to
connect to the database using vsql and execute the query. Enter your password
when prompted. Note the results.
3. Multiply the sum by 2 to estimate how much storage space your backup host needs.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 148 -
Creating a Data Store Backup
4. Enter sudo apt-get update and press Enter to download updated versions of
packages, including Python. Enter your password when prompted.
5. Enter sudo apt-get install python3.7 and press Enter to install Python 3.7
(modify the command to install a different version).
6. From the command prompt, enter rsync --version and press Enter to see what
version of rsync you have installed. You have the following options:
7. Enter sudo apt-get update and press Enter to download updated versions of
packages, including rsync. Enter your password when prompted.
8. Enter sudo apt-get install rsync and press Enter to install rsync.
9. From the command prompt, enter getent passwd | grep dbadmin and press
Enter to determine if a dbadmin user account exists on this host. You have the
following options:
l If a dbadmin user account exists, the backup host is ready. Continue to 3.
Enable Passwordless SSH Access for dbadmin.
l Otherwise, create a dbadmin user account on this host. Continue to step 10.
10. From the command prompt, enter adduser dbadmin and press Enter to create a
dbadmin user account.
11. Enter passwd dbadmin and press Enter to assign a password to dbadmin.
12. Enter a New password and press Enter to set the dbadmin password. Confirm the
password when prompted.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 149 -
Creating a Data Store Backup
su dbadmin
4. Copy the following command and paste it into a plaintext editor:
ssh-copy-id dbadmin@[hostname] where [hostname] is the backup host's
hostname or IP address.
5. Copy the updated command, paste it into the command prompt, and press Enter to
copy the dbadmin SSH authorized key to the backup host.
6. Copy the following command and paste it into a plaintext editor:
ssh 'dbadmin@[hostname]' where [hostname] is the backup host's hostname
or IP address.
7. Copy the updated command, paste it into the command prompt, and press Enter to
verify that you can log into the remote host's console over SSH without needing a
password from this Data Node.
Note the Data Node you use to initialize the backup directory. You will use the
same Data Node to back up the Data Store database in a later procedure (5.
Back Up the Data Store Database).
2. Enter su - dbadmin and press Enter to run the following commands as the
dbadmin user.
3. Enter ssh [backup-host] where [backup host] is the hostname or ip address of
your backup server. You should be able to log into the backup host's interface as
dbadmin without being prompted for a password. If the backup host prompts you
for a password, check your settings.
4. Enter cd /home/dbadmin and press Enter to change directories.
5. Enter mkdir backups and press Enter to create the backups directory.
6. Enter exit and press Enter to return to the Data Node's command line prompt.
7. Enter vi pw.ini and press Enter to create the pw.ini backup password file, and
edit it.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 150 -
Creating a Data Store Backup
[Passwords]
dbPassword = [dbadmin-password]
9. Update [dbadmin-password] to the Data Store dbadmin password.
10. Copy the updated lines and paste them into the pw.ini backup password file.
11. Press Esc, then enter :wq, then press Enter to exit and save your changes.
12. Enter chmod 640 pw.ini and press Enter to change the pw.ini file permissions
to allow the dbadmin user to read and edit the file.
13. For each node, edit/modify SSHD_OPTS in the /etc/default/ssh file as shown
below. You will have to log in as root to complete this process.
Before:
SSHD_OPTS="-o AllowUsers=root -o AllowUsers=sysadmin -o
Banner=/etc/issue.net -o PermitRootLogin=yes -o
AllowTcpForwarding=no"
After:
SSHD_OPTS="-o AllowUsers=root -o AllowUsers=sysadmin -o
AllowUsers=dbadmin -o Banner=/etc/issue.net -o
PermitRootLogin=yes -o AllowTcpForwarding=yes"
14. Restart the ssh service as follows:
systemctl restart ssh
15. Copy the following lines and paste them into a plaintext editor:
[Mapping]
v_sw_node0001 = backup-host-ip:/home/dbadmin/backups
v_sw_node0002 = backup-host-ip:/home/dbadmin/backups
v_sw_node0003 = backup-host-ip:/home/dbadmin/backups
[Misc]
snapshotName = data_store_backup
passwordFile = /home/dbadmin/pw.ini
enableFreeSpaceCheck = True
retryCount = 2
retryDelay = 1
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 151 -
Creating a Data Store Backup
[Transmission]
encrypt = true
checksum = true
concurrency_backup = 2
concurrency_restore = 2
16. Enter vi config.ini and press Enter to create the config.ini backup
configuration file and edit it.
17. Copy the text you pasted into a plaintext editor in step 15 and paste it into your
config.ini file.
18. Replace backup-host-ip with the backup host's IP address.
19. If the host names under [Mapping] do not match your Data Nodes, update these
host names. To determine your Data Node node names, do the following:
Example:
dbadmin@sdbn-742-10-0-56-133-5:/root$ admintools -t node_map
DATABASE | NODENAME | HOSTNAME
--------------------------------------------------------
sw | v_sw_node0001 | 169.254.42.10
sw | v_sw_node0002 | 169.254.42.12
sw | v_sw_node0003 | 169.254.42.15
20. Ensure that you have an entry for each Data Node if you deployed more than three to
your environment. If you have only a single Data Node, remove the extra [Mapping]
lines leaving only the one line for your single Data Node.
21. Press Esc, then enter :wq, then press Enter to exit and save your changes.
22. Enter vbr -t init -c config.ini and press Enter to initialize the
/home/dbadmin/backups directory on the backup host to receive Data Store
backups.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 152 -
Creating a Data Store Backup
1. As root, log into the console of the Data Node where you initialized the backup host
directory in 4. Initialize the Backup Directory on the Backup Host.
2. Enter su - dbadmin and press Enter to run the following commands as the
dbadmin user.
3. Enter vbr -t backup -c config.ini --debug 3 --dry-run and press Enter
to perform a test of the backup without creating the backup. You have these
options:
l If the backup test resolves successfully, back up the Data Store and continue
to step 4.
l If the backup test fails, a snapshot file may have been created and must be
removed. See Data Store Backup Failure for removal instructions. If the
backup test fails to resolve, review the debug log files in the /tmp/vbr
directory, resolve the root cause, then test the backup again. Contact Cisco
Support for more assistance.
4. Enter vbr -t backup -c config.ini and press Enter to backup the Data Store
to the /home/dbadmin/backups directory on the backup host.
select remove_database_snapshot('snapshot_name');
4. Execute the following command to exit.
\q
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 153 -
Restoring a Data Store Backup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 154 -
Restoring a Data Store Backup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 155 -
Restoring a Data Store Backup
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 156 -
Data Store Maintenance
Make sure you review the procedure before you start. Some of the procedures
include contacting Cisco Support for assistance.
While many of the settings on this page could negatively impact performance if set
incorrectly, enabling data compression can only improve system performance in regards
to data transfer between a Flow Collector and the Data Store.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 157 -
Data Store Maintenance
1. Existing Flow Collector without Data Store: Follow the instructions in Resetting
Factory Defaults.
You can choose to keep or discard your current network settings. If you discard
them, make sure you reconfigure these network settings.
7. From the Data Store menu, select New Appliances. Follow the onscreen prompts.
l After the process completes, check Central Management to confirm that the
appliance status is Connected.
l When you exit the Data Store menu, the system restores your previous SSH
settings.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 158 -
Data Store Maintenance
Requirements
Before you add Data Nodes to your Data Store, review the following requirements:
l The Data Store supports 1 or 3 or more Data Nodes. You can add Data Nodes in
sets of 3.
l If you have a Single-Data Node (1) deployment, you can add 2 Data Nodes to
expand your deployment to a set of 3 Data Nodes (and additional sets of 3).
l A Data Store with only 2 Data Nodes is not supported.
Procedures
To add Data Nodes to your deployment, complete the following procedures:
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 159 -
Data Store Maintenance
Make sure you assign your Data Node Virtual Edition with two network adapters
during the installation. When you start First Time Setup, it will fail to resolve if it
cannot detect a second network adapter, which will prevent you from assigning
a non-routable IP address for inter-Data Node communications.
2. Configure the Data Node in First Time Setup. You will assign a routable (eth0)
management IP address and configure inter-Data Node communications in this
procedure.
3. Add the Data Node to Central Management using the Appliance Setup Tool.
l After the process completes, check Central Management to ensure that the
appliance status is Connected.
l When you exit the Data Store menu, the system restores your previous SSH
settings.
A rebalance is required after adding additional Data Nodes to the Data Store.
Contact Cisco Support for assistance with this process.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 160 -
Data Store Maintenance
l Replacing a Data Node with a spare Data Node with different IP addresses
l Replacing an unresponsive Data Node
l Adding a spare Data Node after an existing Data Node goes down
In all scenarios, you will prepare the new (spare) Data Node and work with Cisco Support
to complete the replacement.
l Ensure that the new Data Node is connected to the same switches/ports.
l Ensure that the new Data Node is in the same VLANs as the private and public
interfaces on the existing Data Nodes.
4. Configure the Data Node in First Time Setup. Assign it the appropriate eth0
management IP and private IP addresses, and confirm it is in the same VLANs as the
existing Data Node eth0 and private IPs.
l Ping from the Manager and all Flow Collectors to the eth0 IP address of the
new Data Node.
l Ping from all existing Data Nodes to the private IP of the new Data Node.
l Ping from the new Data Node to the eth0 management IPs of the Manager and
all Flow Collectors.
l Ping from the new Data Node to the private IP of all existing Data Nodes.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 161 -
Data Store Maintenance
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 162 -
Adding Data Store to a Non-Data Store Deployment
For Data Store compatibility information, refer to the Secure Network Analytics
Hardware and Software Version Support Matrix.
1. Update your appliances to v7.4.1. Follow the instructions in the Secure Network
Analytics Update Guide.
2. Add the Data Store Domain in Secure Network Analytics. Refer to the Creating a
Data Store Domain section in this guide for details.
3. Remove the Flow Collector from Central Manager. If you have a 52xx Flow
Collector, you will also need to remove the Flow Collector database from Central
Manager. See Removing an Appliance from Central Management for more
information.
4. Perform the Resetting Factory Defaults process on the Flow Collector engine and
database.
5. Run First Time Setup on the Flow Collector, making sure to select Data Store.
6. Add the Flow Collector back to Central Manager. If you have a 52xx Flow Collector,
be sure to add the Flow Collector database and Flow Collector engine (in that order)
back to Central Manager.
7. Follow the instructions to configure each Data Node in First Time Setup and add
them to Central Management using the Appliance Setup Tool.
8. Add the appliance to the Data Store. Refer to Adding a Manager or Flow Collectors
after the Data Store is Initialized for more information.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 163 -
Adding Data Store to a Non-Data Store Deployment
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 164 -
Troubleshooting
Troubleshooting
Appliance Status: Config Channel Down
If your Appliance Manager shows Config Channel Down for the appliance status, check
the following:
l Communication Settings: Confirm your network communication settings.
l Trust Stores: Make sure your appliance identity certificates are saved to the correct
Trust Stores. For instructions, refer to the SSL/TLS Certificates for Managed
Appliances Guide.
l Certificates: If you've changed the appliance identity certificate, check the
procedure and confirm your certificates are saved to the correct Trust Stores. For
instructions, refer to the SSL/TLS Certificates for Managed Appliances Guide.
l Removing an Appliance: If you remove an appliance from Central Management
while the configuration channel is down, make sure you also remove the appliance
from System Configuration:
l Log in to the appliance console as sysadmin.
l Type SystemConfig. Press Enter.
l Select Recovery > RemoveAppliance.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 165 -
Troubleshooting
https://<IPAddress>
l Manager: add /Manager/Index.html after the IP address.
l Example: https://xx.xxx.xx.xxx/Manager/index.html
Your certificates are critical for your system’s security. Improperly modifying
your certificates can stop Secure Network Analytics appliance communications
and cause data loss.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 166 -
Troubleshooting
If you change the host name, network domain name, or IP address using the
Appliance Setup Tool, the appliance identity certificate is replaced automatically.
1. In the appliance browser address bar, after the IP address, replace the end of the
URL with /lc-ast:
https://<IPAddress>/lc-ast
2. Press Enter.
3. For more information, refer to 1. Configuring Your Appliances
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 167 -
Troubleshooting
Please contact Cisco Support before you change your trusted hosts.
If you change the trusted hosts list from the defaults, make sure each Secure Network
Analytics appliance is included in the trusted host list for every other Secure Network
Analytics appliance in your deployment. Otherwise, the appliances will not be able to
communicate with each other.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 168 -
Troubleshooting
Menu Description
5. Click Finish. Follow the on-screen prompts to create the diagnostics pack.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 169 -
Troubleshooting
If you reset factory defaults (RFD) on an appliance, all existing data and
configuration information will be deleted and can only be restored if you've made
a backup.
If you reset an appliance to factory defaults, you cannot restore the configuration
using Central Management. For assistance, please contact Cisco Support.
Make sure you RFD each appliance twice to completely erase data.
4. Log in to the appliance console as sysadmin and follow the on-screen prompts to
configure the appliance IP address, host name, and domain. For instructions, refer
to the Configuring Your Environment Using First Time Setup section of this guide.
This step is required even if you preserve network settings when you RFD.
5. Log in to the Appliance Setup Tool and add the appliance to Central Management.
For details, refer to Central Management (Managing your Appliances).
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 170 -
Troubleshooting
5. Repeat these instructions to enable or disable the Admin User account on all
appliances in your Secure Network Analytics cluster.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 171 -
Data Store Deployment Troubleshooting
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 172 -
Data Store Deployment Troubleshooting
l If the Data Node does not start from the Data Store tab, log into the Data Node and
force a manual Vertica restart, which deletes corrupted data and allows Vertica to
properly restart.
For Data Node hardware appliances, you may need to update the Data Node's power
restore policy before it restarts. If the power restore policy is set to Power Off, you must
manually restart the Data Node after power loss. See the UCS C-Series GUI Configuration
Guide for more information on configuring the power restore policy in CIMC.
tail /lancope/var/database/dbs/sw/v_sw_[node_name]_cata-
log/ErrorReport.txt
3. Replace [node_name] with your Data Node name (for example, node0001).
4. Copy the updated command and paste it into the command line interface, then
press Enter to review the most recent entries in the ErrorReport.txt error file. If
the error message notes possible data consistency or data corruption issues,
proceed to the next step to force a Vertica restart.
5. Copy the following command and paste it into a text editor:
10. Review Cisco's recommendations for supplying power to your Data Nodes. Refer to
the x2xx Series Hardware Appliance Installation Guide, the Secure Network
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 173 -
Data Store Deployment Troubleshooting
Analytics x3xx Series Hardware Installation Guide, or the Virtual Edition Appliance
Installation Guide for more information.
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 174 -
Installing Patches and Updating Software
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 175 -
Contacting Support
Contacting Support
If you need technical support, please do one of the following:
l Contact your local Cisco Partner
l Contact Cisco Support
l To open a case by web: http://www.cisco.com/c/en/us/support/index.html
l To open a case by email: [email protected]
l For phone support: 1-800-553-2447 (U.S.)
l For worldwide support numbers:
https://www.cisco.com/c/en/us/support/web/tsd-cisco-worldwide-contacts.html
© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 176 -
Copyright Information
Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its
affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this
URL: https://www.cisco.com/go/trademarks. Third-party trademarks mentioned are the
property of their respective owners. The use of the word partner does not imply a
partnership relationship between Cisco and any other company. (1721R)