0% found this document useful (0 votes)
65 views177 pages

7 4 1 System Configuration Guide DV 1 7

This document provides a summary of the steps to configure Cisco Secure Network Analytics, including: 1. Configuring manager, data node, flow collector, and flow sensor appliances through the first time setup process. 2. Configuring the managed system by registering appliances to the manager and central management. 3. Defining manager failover relationships and initializing the data store. It also outlines additional configuration steps for licensing, user permissions, domains, and integrations.

Uploaded by

rashmi m
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
65 views177 pages

7 4 1 System Configuration Guide DV 1 7

This document provides a summary of the steps to configure Cisco Secure Network Analytics, including: 1. Configuring manager, data node, flow collector, and flow sensor appliances through the first time setup process. 2. Configuring the managed system by registering appliances to the manager and central management. 3. Defining manager failover relationships and initializing the data store. It also outlines additional configuration steps for licensing, user permissions, domains, and integrations.

Uploaded by

rashmi m
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 177

Cisco Secure Network Analytics

System Configuration Guide 7.4.1


Table of Contents
Introduction 11
Overview 11
Audience 11
Installation Requirements 12
Hardware 12
Virtual Edition (VE) Appliances 12
Quick Reference Overview 13
Before You Begin 17
Terminology 17
Abbreviations 17
Configuration Details 18
Downloading Software 18
Password Requirements 18
Licensing 19
TLS 19
Third Party Applications 20
Browsers 20
Host Name 20
Domain Name 20
NTP Server 20
Time Zone 20
Planning Your System Configuration 21
System Configuration Requirements 21
Secure Network Analytics with Data Store 21
Secure Network Analytics without Data Store 22
Secure Network Analytics Hybrid Deployment 22
Appliance Configuration Requirements 24
Connecting to Your Hardware (Physical) Appliances 26

© 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.

Virtual Edition (VE) Appliances


l Virtual Edition Installation: Install your virtual appliances using the Secure Network
Analytics Virtual Edition Installation Guide before you start this configuration.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 12 -
Quick Reference Overview

Quick Reference Overview


For a successful installation, follow these procedures in order. For detailed instructions,
click the procedure link.

Before You Begin and Planning Your System Configuration


Make sure you have all required information to configure your
appliances and deploy Secure Network Analytics with a Data Store or
without a Data Store.

1. Configuring Your Environment Using First Time Setup


l Log In: Log in to each appliance through the console as sysadmin
(password: lan1cope). At the command prompt, type
SystemConfig.
l Flow Collector with Data Store: Log in as root (password:
lan1cope).
l Required Appliances: Manager and Flow Collector are required
for all deployments. For deployments with a Data Store, you also
need to configure Data Nodes (with inter-Data Node
communications).

2. Configuring the Managed System


Use the Appliance Setup Tool to configure each appliance in order so it
is managed by your Manager. You will also create a Data Store domain
or Non-Data Store domain for your appliances.
l Appliance Setup Tool: In your address field of your browser, type
https:// followed by the IP address of the appliance.
l Log In: admin
l Password: lan411cope
l Sysadmin and Root Password Default: lan1cope

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 13 -
Quick Reference Overview

Configure your appliances in order. Check the Central Management


inventory and confirm each appliance status is Connected (or
Data Store Not Initialized) before you start configuring the next
appliance in your cluster.
1. Primary Manager (Central Management)
2. Data Nodes
3. Flow Collector 5000 Series Database
4. Flow Collector 5000 Series Engine
5. All Other Flow Collectors
6. UDP Directors
7. Flow Sensors
8. Secondary Manager

3. Defining a Manager Failover Relationship


l This step is required if you've configured a primary Manager and a
secondary Manager.
l Use Failover to establish a failover pair between two Managers so
that one of them serves as a backup console to the other.
l Follow the instructions in the Secure Network Analytics Failover
Configuration Guide.

5. Installing v7.4.1 Patches


l Download the latest v7.4.1 patches from your Cisco Smart
Account on Cisco Software Central at
https://software.cisco.com.
l Follow the instructions in the patch readme file to install each
patch.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 14 -
Quick Reference Overview

5. Initializing the Data Store


Required for Data Store deployments only.
1. Log in to your Manager appliance console (SystemConfig) as
root.
2. Select Data Store > SSH.
3. Select Data Store > Initialization.

6. Installing the Desktop Client


Required for Non-Data Store deployments only.
l Desktop Client requires a 64-bit operating system. It cannot run
on a 32-bit operating system or Linux.
l
Log in to your Manager. Click the (Download) icon.

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)

9. Finishing Appliance Configurations


l Flow Sensor Application ID and Payload (required for all Flow
Sensors)
l UDP Director High Availability
l Other optional appliance configurations

© 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.

11. Licensing Secure Network Analytics


l Register your product instance in your Cisco Smart Account at
https://software.cisco.com before the 90-day evaluation period
expires.
l Follow the instructions in the Secure Network Analytics Smart
Software Licensing Guide.

11. Managing Secure Network Analytics


Log in to your Manager and select:
l Host Groups: Configure > Host Group Management.
l Policies: Configure > Policy Management.
l Flow Searches: Analyze > Flow Search
l Reports: Dashboards > Report Builder
l
User Management: (Global Settings) icon > User
Management
l
Instructions: Select the (User) icon > Help from any page.
Also, refer to Managing Your Environment, Investigating Behavior,
and Responding to Threats.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 16 -
Before You Begin

Before You Begin


Before you begin the configuration process, review this guide to understand the process
as well as the preparation, time, and resources you'll need to plan for the configuration.

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

DNS Domain Name System (Service or Server)

dvPort Distributed Virtual Port

ESX Enterprise Server X

GB Gigabyte

IDS Intrusion Detection System

IPS Intrusion Prevention System

ISO International Standards Organization

IT Information Technology

KVM Kernel-based Virtual Machine

MTU Maximum Transmission Unit

NTP Network Time Protocol

TB Terabyte

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 17 -
Before You Begin

Abbreviations Definition

UUID Universally Unique Identifier

VDS vNetwork Distributed Switch

VE Virtual Edition

VLAN Virtual Local Area Network

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:

User Default Password

admin lan411cope

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 18 -
Before You Begin

root lan1cope

sysadmin lan1cope

You will assign the password when you


dbadmin
initialize the Data Store.

You will assign the password when you


readonlyuser
initialize the Data Store.

For remote access to your hardware


appliances, log in to the CIMC. If you
haven't already configured the CIMC,
follow the instructions in the Cisco UCS C-
CIMC admin Series Integrated Management Controller
GUI Configuration Guide.
The default password is password. Make
sure you change it when you first log in.

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

Third Party Applications


Secure Network Analytics does not support installing third party applications on
appliances.

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

Planning Your System Configuration


Before you start the configuration, review the instructions so you understand the planning,
time, and requirements for configuring your appliances in First Time Setup and
configuring them into one managed system in the Appliance Setup Tool.

System Configuration Requirements


Consult with your network architect and administrator to confirm the details of your v7.4.1
Secure Network Analytics deployment. Refer to each section for configuration
requirements:
l Secure Network Analytics with Data Store
l Secure Network Analytics without Data Store
l Secure Network Analytics Hybrid Deployment

Secure Network Analytics with Data Store


In Secure Network Analytics with a Data Store, the Flow Collector sends its telemetry to
the Data Store Data Nodes for storage.
l Number of Data Nodes: The Data Store can include 1 Data Node (Single Data Node
deployment) or 3 or more Data Nodes (Multi-Data Node deployment). A Data Store
with only 2 Data Nodes is not supported.
l Hardware or Virtual: Make sure your Data Nodes are the same type: all hardware or
all Virtual Edition.
l Size: Make sure your Data Nodes Virtual Edition use the same profile size so they
have the same RAM, CPU, and disk space. Refer to the Virtual Appliance Installation
Guide for details.
l Telemetry Ingest: In addition to NetFlow, you can configure telemetry ingest for
NVM flows (Network Visibility Module) and firewall logs.

For a successful configuration, note the following:

1. In First Time Setup, configure your appliances for a Data Store configuration. Make
sure you configure the following appliances:

l Manager: Refer to Configuring a Manager


l Flow Collector: Refer to Configuring a Flow Collector with Data Store
l Data Nodes: Refer to Configuring a Data Node

© 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.

Secure Network Analytics without Data Store


In Secure Network Analytics without a Data Store, the Flow Collector stores its telemetry
locally on the Flow Collector or on the Flow Collector database (5000 Series only).
For a successful configuration, note the following:

1. In First Time Setup, make sure you configure the following appliances:

l Manager: Refer to Configuring a Manager


l Flow Collector: Refer to Configuring a Flow Collector without Data Store

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).

Secure Network Analytics Hybrid Deployment


In Secure Network Analytics with a hybrid configuration, you can configure specific Flow
Collectors to send telemetry to the Data Store Data Nodes for storage, and you can
configure other Flow Collectors to store telemetry locally on the Flow Collector or the
Flow Collector database (5000 Series only).
For a successful configuration, configure your appliances and domains in the following
order:

1. In First Time Setup, configure your appliances without Data Store. Make sure you
configure the following appliances:

l Manager: Refer to Configuring a Manager


l Flow Collector: Refer to Configuring a Flow Collector without Data Store

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

4. Follow the instructions in Adding Data Store to a Non-Data Store Deployment.


You will create a Data Store domain and add Flow Collectors and Data Nodes to it.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 23 -
Planning Your System Configuration

Appliance Configuration Requirements


You need the following information to configure each appliance in First Time Setup. You
will also use this information to configure your appliances into a managed system with the
Appliance Setup Tool.

Configuration Requirement Details Appliance

Assign a routable IP address to the eth0


IP Address
management port.

Netmask

Gateway

A unique host name is required for each


appliance. We cannot configure an
appliance with the same host name as
Host Name
another appliance. Also, make sure each
appliance host name meets the Internet
standard requirements for Internet hosts.

A fully qualified domain name is required


Domain Name for each appliance. We cannot install an
appliance with an empty domain.

DNS Servers Internal DNS server for name resolution

Internal Time server for synchronization


between servers. At least 1 NTP server is
required for each appliance.

NTP Servers 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.

SMTP Mail server to send alerts and


Mail Relay Server
notifications

Flow Collector Required for Flow Collectors only.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 24 -
Planning Your System Configuration

Export Port NetFlow Default: 2055

Required for Data Nodes only.


l Hardware eth2 or bond of eth2 and
eth3
l Virtual eth1

IP Address: You can use the provided IP


address or enter a value that meets the
following requirements for inter-Data
Node communications.
l Non-routable IP Address from the
169.254.42.0/24 CIDR block,
Non-routable IP Address between 169.254.42.2 and
within a private LAN or VLAN 169.254.42.254.
(for inter-Data Node
communication) l First Three Octets: 169.254.42
l Subnet: /24
l Sequential: For ease of
maintenance, select sequential
IP addresses (such as
169.254.42.10, 169.254.42.11, and
169.254.42.12).

Netmask:
The Netmask is hard coded to
255.255.255.0 and cannot be modified.

Required for Secure Network Analytics


with Data Store hardware appliances
only:
eth0 Hardware Connection l Manager 2210
Port
l Flow Collector 4210
l Data Nodes

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 25 -
Planning Your System Configuration

eth0 Hardware Connection Port Options:


l SFP+: SFP+: 10G SFP+/DAC fiber
port for eth0.
l BASE-T: 100Mbs/1GbE/10GbE
BASE-T copper port for eth0.
BASE-T is the default.

Connecting to Your Hardware (Physical) Appliances


Connect to your appliance with Cisco Integrated Management Controller (CIMC), a
keyboard and monitor, or serial cable or serial console. For instructions, refer to the x2xx
Series Hardware Installation Guide.

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.

Connecting to Your Virtual Edition Appliances


1. Connect to your Hypervisor host (virtual machine host).
2. In the Hypervisor host, locate your virtual machine.
3. Confirm the virtual machine is powered on.

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.

Review Resource Requirements to allocate sufficient resources. This step is


critical for system performance.

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

required resources, you assume the responsibility to closely monitor your


appliance resource utilization and increase resources as needed to ensure
proper health and function of the deployment.

4. Access the virtual machine console. Allow the virtual appliance to finish booting up.

Depending on the speed of your VM host, it may take approximately 30 minutes


for all services to boot up.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 27 -
1. Configuring Your Environment Using First Time Setup

1. Configuring Your Environment Using First


Time Setup
Use the following instructions to configure the basic environment for each appliance.
Whether hardware (physical) appliances or Virtual Edition (VE) appliances, you can
configure your appliances in any order in First Time Setup.

Review Planning Your System Configuration before you start these


configuration procedures.

Appliance Configuration Overview

Required
Appliance Instructions for Notes
Data Store

A Manager is required for deployments


Configuring a Manager yes
with Data Store and without Data Store.

You can deploy 1 Data Node (Single


Data Node deployment) or 3 or more
Data Nodes (Multi-Data Node
deployment).
Deploying only 2 Data Nodes is not
supported.
Configuring a Data Node yes Make sure your Data Nodes are all
hardware or all Virtual Edition. Also,
make sure your Data Nodes Virtual
Edition use the same profile size so
they have the same RAM, CPU, and
disk space. Refer to the Virtual
Appliance Installation Guide for details.

The Flow Collector sends its telemetry


Configuring a Flow Collector to the Data Store Data Nodes for
yes
with Data Store storage. You will also confirm telemetry
types to ingest.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 28 -
1. Configuring Your Environment Using First Time Setup

The Flow Collector stores its telemetry


Configuring a Flow Collector locally on the Flow Collector or on the
without Data Store Flow Collector database (5000 Series
only).

Flow Sensors and UDP Directors are


optional.
To install Cisco Telemetry Broker
instead of the UDP Director, finish the
Configuring a Flow Sensor or instructions in this guide to finish your
UDP Director system configuration. Then, follow the
instructions in the Cisco Telemetry
Broker Virtual Appliance Deployment
and Configuration Guide.

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.

2. System Configuration (SystemConfig) opens.


3. Review the failed login attempts information. Select OK to continue.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 29 -
1. Configuring Your Environment Using First Time Setup

4. Review the First Time Setup introduction. Select OK to continue.

© 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.

6. Enter the management interface IP Address (eth0), Netmask, Gateway,


Broadcast, Host Name, and Domain, then select OK to continue.

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.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 31 -
1. Configuring Your Environment Using First Time Setup

7. Confirm your settings. Select Yes to continue.

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

Configuring a Data Node


You can deploy 1 Data Node (Single Data Node deployment) or 3 or more Data Nodes
(Multi-Data Node deployment). Deploying only 2 Data Nodes is not supported.

1. Log in to a Data Node through the console.


l Login: sysadmin
l Default Password: lan1cope
l You will change the default password when you configure the system.
2. System Configuration (SystemConfig) opens.
3. Review the failed login attempts information. Select OK to continue.

4. Review the First Time Setup introduction. Select OK to continue.

© 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

6. Enter the management interface IP Address, Netmask, Gateway, Broadcast, Host


Name, and Domain, then select OK to continue.

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.

7. Confirm your settings. Select Yes to continue.

8. Select OK to confirm your selection. Follow the on-screen prompts.

© 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.

Enter the following:

Field Requirements

Use the provided IP address or enter a value that meets


the following requirements for the eth2 and eth3 interface
for inter-Data Node communications.
l Non-routable IP Address from the 169.254.42.0/24
CIDR block, between 169.254.42.2 and
IP Address 169.254.42.254.
l First Three Octets: 169.254.42
l Subnet: /24
l Sequential: For ease of maintenance, select
sequential IP addresses (such as 169.254.42.10,
169.254.42.11, and 169.254.42.12).

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

10. Select OK to continue.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 37 -
1. Configuring Your Environment Using First Time Setup

11. Confirm your settings. Select Yes to continue.

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.

Configuring a Flow Collector with Data Store


If you configure your Flow Collector for use with the Data Store, the Flow Collector sends
its telemetry to the Data Store Data Nodes for storage. You will also confirm telemetry
types to ingest.

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

1. Log in to the Flow Collector through the console.


l Login: root
l Default Password: lan1cope
l You will change the default password when you configure the system.
2. At the command prompt, type SystemConfig. Press Enter.
3. Review the failed login attempts information. Select OK to continue.
4. Review the First Time Setup Introduction. Select OK to continue.

© 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

7. Select which telemetry types to ingest.

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:

l Network Visibility Module - NVM: If you select Network Visibility Module -


NVM, the Flow Collector will ingest and store NVM flows. Refer to the Cisco
Secure Network Analytics Endpoint License and Network Visibility Module
(NVM) Configuration Guide for more information.
l Firewall Logs: If you select Firewall Logs, the Flow Collector will ingest and
store firewall event logs for Cisco Security Analytics and Logging (On
Premises). Refer to the Security Analytics and Logging: Firewall Event
Integration Guide for more information.

If you configure the Flow Collector to have NetFlow disabled, updating


configuration options, such as altering Exporters, Host Groups, Security Events,
Host Reports, etc., will have no effect.

© 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

9. Confirm your settings. Select Yes to continue.

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.

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.

12. Confirm your settings. Select Yes 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.

Configuring a Flow Collector without Data Store


If you configure your Flow Collector for use without a Data Store, the Flow Collector
stores its telemetry locally on the Flow Collector or on the Flow Collector database (5000
Series only).

1. Log in to the Flow Collector through the console.


l Login: sysadmin
l Default Password: lan1cope
l You will change the default password when you configure the system.
2. System Configuration (SystemConfig) opens.
3. Review the failed login attempts information. Select OK to continue.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 45 -
1. Configuring Your Environment Using First Time Setup

4. Review the First Time Setup introduction. Select OK to continue.

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

7. Enter the management interface IP Address, Netmask, Gateway, Broadcast, Host


Name, and Domain. Select OK to continue.

8. Confirm your settings. Select Yes to continue.

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.

Configuring a Flow Sensor or UDP Director


1. Log in to a Flow Sensor or UDP Director through the console.
l Login: sysadmin
l Default Password: lan1cope
l You will change the default password when you configure the system.
2. System Configuration (SystemConfig) opens.
3. Review the failed login attempts information. Select OK to continue.

4. Review the First Time Setup introduction. Select OK to continue.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 49 -
1. Configuring Your Environment Using First Time Setup

5. Enter the management interface IP Address, Netmask, Gateway, Broadcast, Host


Name, and Domain, then select OK to continue.

6. Confirm your settings. Select Yes to continue.

© 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.

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. - 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:

1. Log in to the appliance console as sysadmin. The default password is lan1cope.

2. Select Advanced > Root Shell.


3. Run the following command:

/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.

Accessing the Appliance


If you cannot access the appliance after it restarts, do the following:

© 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

2. Configuring the Managed System


When you log in to the appliance for the first time, you will use the Appliance Setup Tool
to configure each appliance so it is managed by your Manager.

Preparation
Before you start the configuration, review the instructions so you understand the
appliance configuration order, best practices, and additional requirements.

Appliance Setup Tool Requirements


l Confirm your firewalls and ACLs (Access Control List) will allow access.
l Gather the host name for the appliance and IP addresses for the following:

l appliance
l subnet mask
l default and broadcast gateways
l NTP and DNS servers
l Manager IP address for Central Management

For details, refer to Appliance Configuration Requirements.

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

Secure Network Analytics Domain


When you configure your Manager, you will create a Data Store domain or Non-Data
Store domain for your Secure Network Analytics appliances. When you configure your
other appliances in the Appliance Setup Tool, you will add them to the domain you
created. Refer to Planning Your System Configuration for details.
After you finish your system configuration with your first domain, you can add domains to
your configuration (refer to Domains). If you configure Secure Network Analytics with a
Non-Data Store domain, you can add a Data Store to your deployment after you finish the
system configuration. Follow the instructions in Adding Data Store to a Non-Data Store
Deployment).

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

Appliance Configuration Order


Configure your appliances in the following order, and note the details for each appliance:

Order Appliance Details

Your primary Manager is your Central


Manager.
Make sure the Manager is shown as
Connected before you start configuring
the next appliance in the system.
1. Primary Manager
When you configure your Manager, you
will create a Secure Network Analytics
domain with a Data Store (Data Store
domain) or without a Data Store (Non-
Data Store domain).

Required for Data Store deployments.


Make sure the Data Node appliance
2. All Data Nodes status is Data Store Not Initialized
before you configure the next appliance
in your cluster.

Make sure the database appliance status


is Connected before you start the engine
configuration.
Database and Engine Pair: If you have
more than one database and engine pair,
configure each pair one at a time. For
example, configure pair1 (database1 and
Flow Collector 5000
3. engine1) before you configure pair2
Series Database
(database2 and engine2). In each pair,
confirm the database is shown as
Connected before you start the engine
configuration.
Also, when you configure unique host
names, name each database and engine
pair so you can identify them in Central

© 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.

Make sure the Flow Collector 5000


Flow Collector 5000
4. series database is shown Connected
Series Engine
before you start the engine configuration.

Flow Collectors with Data Store: Make


sure the appliance status is Data Store
Not Initialized before you configure the
next appliance in your cluster.
5. All Other Flow Collectors
Flow Collectors without Data Store:
Make sure the appliance status is
Connected before you configure the
next appliance in your cluster.

Make sure the UDP Director appliance


status is Connected before you
configure the next appliance in your
cluster.
UDP Directors If you are installing Cisco Telemetry
6. (also known as Broker instead of the UDP Director, finish
FlowReplicators) the Secure Network Analytics system
configuration. Then, follow the
instructions in the Cisco Telemetry
Broker Virtual Appliance Deployment and
Configuration Guide.

Make sure your Flow Sensor appliance


7. Flow Sensors status is Connected before you start the
Flow Sensor configuration.

Secondary Manager Make sure the primary Manager


8.
(if used) appliance status is shown as Connected

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 57 -
2. Configuring the Managed System

before you start the secondary Manager


configuration.
The secondary Manager selects itself as
Central Manager. Configure Failover after
all appliances are configured using the
Appliance Setup Tool. Refer to 3.
Defining a Manager Failover
Relationship for details.

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. Log In to the Appliance Setup Tool


Use the following instructions to configure each appliance using the Appliance Setup
Tool.

1. In the address field of your browser, type https:// followed by the IP address of the
appliance.

l Primary Manager: Configure the primary Manager first.


l Connected: Confirm each appliance is Connected or Data Store Not Initialized
before you start configuring the next appliance in your cluster.
l Order: Make sure you configure your appliances in order so they
communicate correctly.

If you cannot access the appliance, refer to Troubleshooting in 1. Configuring


Your Environment Using First Time Setup for instructions.

2. Enter the following credentials to log in:

l User Name: admin


l Password: lan411cope

If this is not a first-time installation, go to Troubleshooting (at the end of this


guide) to change appliance network settings such as host name, network
domain name, or IP address.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 59 -
2. Configuring the Managed System

2. Configure the Appliance


When you log in to the appliance for the first time, the Appliance Setup Tool guides you
through each configuration step.

1. Change Default Password: Enter new passwords for admin, root, and sysadmin.
Click Next to scroll to each user.

Use the following criteria:

l Length: 8 to 256 characters


l Change: Make sure the new password is different from the default password
by at least 4 characters.

User Default Password

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.

2. Management Network Interface: Review the IP address and network interface


fields. Confirm the default settings are correct. Click Next.

l Changes: To change this information, confer with your network administrator


and refer to Troubleshooting.
l IPv6 (optional): To enable IPv6, click IPv6. Check the Enable IPv6 check box
and complete the fields.

© 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.

Field Name Notes

A unique host name is required for each


appliance. If you assign the same host
names to your appliances, they will not
install successfully. Also, make sure each
appliance host name meets the Internet
standard requirements for Internet hosts.
Host Name
Flow Collector 5000 Series Database
and Engine Pair: Name each database
and engine pair with unique host names
that will help you identify the pair in Central
Management. For example, database1 and
engine1, database2 and engine2.

A fully qualified domain name is required


Network Domain
for each appliance.

Manager Domain Enter a domain name for your Secure


(Manager only) Network Analytics deployment.

Data Store Domain: If you configured your


appliances with Data Store in First Time
Setup, select Data Store Domain.
Non-Data Store Domain: If you
Manager Domain Type configured your appliances without Data
(Managers only) Store in First Time Setup, select Non-Data
Store Domain.
After you finish your system configuration
in this guide, you can add domains to your
deployment. Refer to Domains.

IP Address Ranges Select the IP address range for your


(Manager only) Secure Network Analytics network.

© 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.

Add or Delete DNS Servers (optional):

l Add: Click the + icon.


l Delete: Click the check box to select the DNS server. Click the - icon.

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

l Multiple NTP Servers: We recommend setting up multiple NTP servers for


redundancy and accuracy.
l Public Source: pool.ntp.org is a good, public source for NTP.

Add or Delete NTP Servers (optional):

l Add: Click the + icon.


l Delete: Click the check box to select the NTP server. Click the - icon.

6. Your primary Manager is your Central Manager. Add your appliances to Central
Management as follows:

l Managers: If the appliance is a Manager, go to 3. Register the Manager.


l All Other Appliances: If the appliance is not a Manager, go to 4. Add
Appliances to Central Management.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 64 -
2. Configuring the Managed System

3. Register the Manager


1. Review Your Settings: Confirm the appliance information is accurate.
2. Click Apply or Restart and Proceed.

l Follow the on-screen prompts while the appliance restarts.


l Wait a few minutes for your new system settings to take effect. You may need
to refresh the page.

3. Log in to the Manager.


4. The Appliance Setup Tool opens again. Click Continue.
5. On the Register Your Appliance tab, review the IP address and click Save.

l The Manager IP address is detected automatically and cannot be changed.


l This step installs Central Management on the Manager.

6. When the appliance setup is completed, click Go to Dashboard.

7. Click the (Global Settings) icon. Select Central Management.

8. Review the inventory. Confirm the Manager appliance status is shown as


Connected.

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

4. Add Appliances to Central Management


The Appliance Setup Tool continues to guide you through the appliance configuration
with Central Management. Some of the steps may vary depending on the appliance.
Follow the on-screen prompts.

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

4. Enter the login credentials for your primary Manager.


5. Domain: Select your Secure Network Analytics Domain. This the domain you
configured as a Data Store domain or Non-Data Store domain when you registered
the Manager.

l Flow Collectors: Enter the Flow Collection port number. Netflow Default:
2055
l Flow Sensors: Select a Flow Collector.

Selecting your Secure Network Analytics Domain

6. Click Go to Central Management. Go to 5. Confirm Appliance Status.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 66 -
2. Configuring the Managed System

5. Confirm Appliance Status


After you configure an appliance in the Appliance Setup Tool, confirm the appliance
status in Central Management.

1. The Appliance Setup Tool opens to the Central Management inventory, or you can
open it as follows:

l Log in to your primary Manager.


l
Click the (Global Settings) icon. Select Central Management.

2. Review the appliances on the Appliance Manager inventory.

l Confirm the appliance is shown in the inventory.


l Appliance Status: Make sure the primary Manager and each appliance is
shown as Connected before you start configuring the next appliance in your
cluster.
l Data Store Not Initialized: For Flow Collectors and Data Nodes in a Data
Store domain, confirm the appliance status is Data Store Not Initialized. They
will be shown as Connected after you complete the initialization in a later
procedure.
l Type: If a Flow Collector has a Data Store tag, it is configured to send flows to
your Data Store database.

© 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.

3. To configure the next appliance in your system, go to 1. Log In to the Appliance


Setup Tool, and complete the all procedures through 5. Confirm Appliance
Status.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 68 -
3. Defining a Manager Failover Relationship

3. Defining a Manager Failover Relationship


Use Failover Configuration to establish a failover pair between two Managers so that one
of them serves as a backup console to the other. If you have Secure Network Analytics
with a Data Store deployment, it is important to configure Failover before you initialize the
Data Store.
If you do not have a secondary Manager, go to 5. Installing v7.4.1 Patches.
For a successful Failover configuration and operation, review the requirements and follow
the instructions in the Secure Network Analytics Failover Configuration Guide.

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

For a successful configuration and operation, follow the instructions in the


Secure Network Analytics Failover Configuration Guide.

Primary and Secondary Roles


As part of the configuration, you will assign a primary Manager and a secondary Manager.
When you save the configuration, the following occurs:
l Primary Manager: The primary Manager pushes its domain configuration, user
settings, and policies to the secondary Manager. Use the primary Manager to
manage your appliances, change appliance configurations, change passwords,
define alarms, apply policies, and more.
l Secondary Manager: The secondary Manager deletes its configuration, so it can
synchronize with the primary Manager configuration and settings. Also, the
secondary Manager changes to read-only for all users, which means that you will
not have access to sections of the secondary Manager and you cannot retrieve files
from the secondary Manager.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 70 -
5. Installing v7.4.1 Patches

5. Installing v7.4.1 Patches


Install the latest v7.4.1 patches on your appliances.

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

5. Initializing the Data Store


Use System Configuration to initialize your Data Store. You will enable SSH temporarily as
part of this procedure.

Before you start this procedure, add all appliances to your Central Management
inventory.

1. Log in to your Manager appliance console (SystemConfig) as root.


2. From the main menu, select Data Store.
3. Select SSH. Follow the on-screen prompts to enable SSH.
4. Select Initialization from the Data Store menu.
5. Follow the on-screen prompts to initialize the Data Store.

When you exit the Data Store menu, the system restores your previous SSH
settings.

6. Go to the next procedure: 7. Verifying Communications.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 72 -
6. Installing the Desktop Client

6. Installing the Desktop Client


Starting with v7.4.0, the SMC has been renamed to Manager. The SMC is
referred to as Manager within this section.

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

Install the Desktop Client Using Windows


l You must have sufficient rights to install Desktop Client.
l Desktop Client requires a 64-bit operating system. It cannot run on a 32-bit
operating system or Linux.

Use the following instructions to install the Desktop Client using Windows:

1. Log in to your Manager.


2. Click the Download icon.

3. Click the .exe file to begin the installation process.


4. Follow the steps in the wizard to install the Desktop Client.

5. On your desktop, click the Desktop Client icon .


6. In the SMC Server Name field, enter the Manager server name or IP address (IPv4
or IPv6).
7. Enter the Manager user name and password.
8. Follow the on-screen prompts to open the Desktop Client and trust the appliance
identity certificate.

Change the Memory Size From Windows Explorer

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).

1. In Windows Explorer, go to your home directory.


2. Open these folders: AppData > Roaming > Stealthwatch.

You may need to search "Stealthwatch" if the folder is hidden.

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

4. Open the application.vmoptions file using an appropriate editing application to


begin editing. (This file is created after you open the Desktop Client for the first
time.)

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.

Use whole numbers. For example, enter Xmx512m, not Xmx0.5m.

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

Install the Desktop Client Using macOS


l You must have sufficient rights to install Desktop Client.
l Desktop Client requires a 64-bit operating system. It cannot run on a 32-bit
operating system or Linux.

Use the following instructions to install the Desktop Client using macOS:

1. Log in to your Manager.


2. Click the Download icon.

3. Click the .dmg file to begin the installation process.

An icon and folder are displayed on your monitor, as shown below.

4. Drag the Desktop Client icon ( ) into the Application folder.

The icon is added to the Launchpad.

5. On your desktop, click the Desktop Client icon .


6. In the SMC Server Name field, enter the Manager server name or IP address (IPv4
or IPv6).
7. Enter the Manager user name and password.
8. Follow the on-screen prompts to open the Desktop Client and trust the appliance
identity certificate.

Change the Memory Size From Finder

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).

1. In Finder, go to your home directory.


2. Open the Stealthwatch folder.
3. In the Stealthwatch directory, open the folder that contains the
desired Stealthwatch version.
4. Open the application.vmoptions file using an appropriate editing application to
begin editing. (This file is created after you open the Desktop Client for the first
time.)

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.

Use whole numbers. For example, enter Xmx512m, not Xmx0.5m.

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.

Failover Configuration: Log in to your primary Manager and secondary Manager.

2. Review the Flow Collection Trend.

2. Verify the Data Store Database Status


If you did not deploy Secure Network Analytics with a Data Store, go to 3. Run
Reports in Report Builder.

1. In your primary Manager dashboard, click the (Global Settings) icon.


2. Select Central Management.
3. Click the Data Store tab.
4. Confirm the Data Store database status is shown as Up.

If the database status is Down, click the (Ellipsis) icon in the Actions column for
the database. Select Start.

5. Confirm the status for all Data Nodes is shown as Up.

© 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.

3. Run Reports in Report Builder


1. Return to your Security Insight Dashboard.
2. Select the Dashboards menu.
3. Select Report Builder.
4. Click Create New Report.
5. Click the Flow Collection Trend by Flow Collector template.
6. Select the parameters as needed. Click Run.
7. Review the report to confirm your Flow Collectors are receiving flows.
8. If you have a Flow Collector database (5000 Series only) or a Data Store, return to
the Report Builder dashboard and repeat steps 4 through 7 to run the Flow
Database Ingest Trend Report. Confirm the database or Data Store are receiving
flows.

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

9. Finishing Appliance Configurations


Make sure you finish any required configurations for your appliances.

Required Optional
Appliance
Configurations Configurations

Data Compression
Data Node none
Flow Interface Statistics

Flow Collectors none Change NetFlow to sFlow

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

Changing the Flow Settings in a Flow Collector


1. Log in to the Flow Collector.
2. Click Support > Advanced Settings.
3. In the engine_startup_mode field, enter one of the following values:

l Default value from the model file - 0


l NetFlow -1
l sFlow - 2

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.

4. Click Apply and then click OK.


5. Log in to your Manager.
6. Select Configure > Flow Collectors.
7. Enter one of the following numeric values in the Monitor Port field (these are
industry standard default port numbers for NetFlow and sFlow. If your exporters are
configured to use a non-standard port, you must use that port number instead).

l 2055 - NetFlow
l 6343 - sFlow

8. Click Save to save your changes.

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.

Configuring UDP Directors for High Availability (Hardware


Only)
Use the following instructions to configure your UDP Directors as a High Availability pair.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 81 -
9. Finishing Appliance Configurations

High Availability is only available on UDP Director hardware appliances. High


Availability is not available on virtual appliances.

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).

Configuring Forwarding Rules


SSL is used to send messages from the UDP Director to the Manager.

1. Log in to the Manager.

2. Click the (Global Settings) icon. Select UDP Director.

3. Click the Actions menu for the appliance. Select Configure Forwarding Rules.

4. Click Add New Rule.

5. Description: Enter a brief description that identifies the rule.


6. Source IP Address:Port: Type the IP address of the device that sends data to the
UDP Director and the input port number (where the data will be sent).

l Format: Use the syntax [IP address]:[Port Number].

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.

l Combinations: You can add Source IP Address:Port combinations within a


rule by adding them to a new line.

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.

11. Repeat the procedure to add forwarding rules as needed.


12. To set up a High Availability pair, go to Configuring High Availability.

High Availability is only available on UDP Director hardware appliances. High


Availability is not available on virtual appliances.

Configuring High Availability


If you have more than one UDP Director, use the Appliance Admin interface to configure
high availability.

High Availability is only available on UDP Director hardware appliances. High


Availability is not available on virtual appliances.

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.

Primary Node and Secondary Node


The online node is known as the Primary in the pair, while the offline node is the
Secondary. If the Primary node in the pair should fail, the Secondary node takes over and
becomes the Primary.

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.

1. Configure the Primary UDP Director High Availability


1. Log in to the primary UDP Director.
2. Click Configuration > High Availability.

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.

Make sure the Virtual IP Address is the same on both nodes.

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.

Each of the IP addresses--eth0, eth02, eth03--must be on its own separate unicast


subnet.

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.

2. Configure the Secondary UDP Director High Availability

If you selected Node ID 2 in step 4 above, complete the steps below for the
primary UDP Director.

To configure the secondary UDP Director complete the following steps:

1. Log in to the secondary UDP Director.


2. Click Configuration > High Availability.

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

l Sync Ring #1(eth2) Unicast IP Address: Enter a different IP address from


what you configured in this field on the primary, but it must be in the same
subnet as the Sync Ring 1 Unicast address given on the primary.
l Sync Ring #2(eth3) Unicast IP Address: Enter a different IP address from
what you configured in this field on the primary, but it must be in the same
subnet as the Sync Ring 2 Unicast address given on the primary.
l Paired Node Host Name: Enter the host name for the primary UDP Director in
this field.
l Paired Node Sync Ring #1(eth2) IP Address: Enter the Eth2 IP address for
the primary UDP Director in this field.
l Paired Node Sync Ring #1(eth3) IP Address: Enter the Eth3 IP address for
the primary UDP Director in this field.

5. Click Apply to save your changes and to start the clustering services on this
appliance.
6. Click Promote to designate the primary appliance.

Configuring the Flow Sensor


1. Configure the Application ID and Payload
The configuration of a Flow Sensor requires an additional step of configuring the
application ID and payload.

1. Log in to the Flow Sensor Appliance Admin interface.


2. Click Configuration > Advanced Settings.

The Advanced Settings page opens.

3. Select the proper settings for your network:

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.

Allows you to specify whether the Flow Sensor attempts to


Export Applications identify applications before sending data to the collector. In
Identification addition, this setting must be enabled for the following settings to
take affect:

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 86 -
9. Finishing Appliance Configurations

Item Description

Include IPv6 – Allows you to specify whether or not the Flow


Sensor analyzes both IPv4 and IPv6 packets. When this setting is
disabled, the Flow Sensor analyzes only IPv4 packets.

Export HTTPS Header Data – Allows you to specify whether the


Flow Sensor includes header data from HTTPS flows in the data
that it sends to the collector. The data includes the SSL common
name and SSL organization name. This setting requires that the
Flow Type is set to IPFIX. The maximum is 256 bytes.

Export HTTP Header Data – Allows you to specify whether or not


the Flow Sensor includes header data from HTTP flows in the data
that it sends to the collector. When this setting is selected, a
secondary field allows you to specify the maximum length of the
HTTP path (in bytes) that the Flow Sensor includes as part of the
flow data. This setting requires that the Flow Type is set to IPFIX.

Allows you to specify whether the Flow Sensor uses Virtual


Extensible Local Area Network (VXLAN) decapsulation
capabilities. Without VXLAN decapsulation, the Flow Sensor
simply detects VXLAN encapsulated traffic as flows between two
Virtual Tunnel Endpoints (VTEPs). Decapsulation allows for much
Enable VXLAN
richer content by being able to analyze the tunneled traffic and
Decapsulation
thus gain greater insight into the traffic patterns in the network.

The Flow Sensor will only decapsulate VXLAN traffic


which was originally sent to the standard VXLAN port
(4789).

Allows you to specify whether the Flow Sensor uses Generic


Enable GENEVE
Network Virtualization Encapsulation (GENEVE) decapsulation for
Decapsulation
traffic received on its monitoring ports.

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

capabilities to detect the ERSPAN header in packets, and then


decapsulate the header and process the inner packet contents.
You are required to assign the monitoring interface an IP address
to allow termination of the ERSPAN tunnel on the Flow Sensor.
ERSPAN decapsulation is not supported on the FS 4210.

Allows you to specify whether the Flow Sensor uses X-


Forwarded-For (XFF) processing to identify the originating IP
Enable X- address of a client connecting to a web server through an HTTP
Forwarded-For proxy or a load balancer.
Processing
ETA and X-Forwarded-For Processing cannot be
configured together.

Allows you to specify whether the Flow Sensor uses ETA


processing to generate and transmit IDP and SPLT fields to your
Manager.

Enabling ETA increases NetFlow bandwidth usage,


especially when using v9. We recommend using IPFIX for
Enable ETA the Flow Export Format.
Processing
ETA and X-Forwarded-For Processing cannot be
configured together.

ETA cannot be enabled on Dell or PowerEdge Flow


Sensor models.

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.

Monitoring Allows you to specify the following:


Interface Selection l Flow Sensor 4240 - 2 x 40G or 4 x 10G (SFP) interfaces

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 88 -
9. Finishing Appliance Configurations

Item Description

l Flow Sensor 4300 - 2 x 40G/100G or 4 x 10G (SFP)


interfaces

You must be using multiple Flow Collectors and have Load


Balancing enabled for this setting to work properly. Go to the Flow
Sensor and Load Balancer Integration Guide for more information.
This option is only available on the Flow Sensor 4240 and Flow
Sensor 4300.
The default setting for the Flow Sensor 4240 is 2 x 40G while the
default setting for the Flow Sensor 4300 is 2 x 40G/100G.

Allows you to select one of the following settings:

Use single, shared, cache for all monitoring ports –


l Use when asymmetric routing is present.
l Single state table for application and latency calculations.
l Uses less memory.
l Lower overall pps processing rates.
l Results in one NetFlow event created across multiple
interfaces.
l Use only when the Flow Sensor has only two ports and is
Cache Mode connected by a TAP

Use independent caches for each monitoring port –


l Allows deduplication of packets across each Flow Sensor
interface.
l Uses more memory.
l Higher overall pps processing rates.
l Each interface maintains its own latency and application
database.
l Results in a unique NetFlow record for each interface that
sees a given packet.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 89 -
9. Finishing Appliance Configurations

4. Click Apply to save your settings.

2. Configure the Flow Sensor to Identify Applications (optional)


If you want the Flow Sensor to identify applications, configure the following settings:

1. Log in to the Flow Sensor Appliance Admin interface.


2. Click Configuration > Advanced Settings
3. Check the Export Application Identification check box. By default, this option is
not selected.

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.

l Use independent caches for each monitoring port: typically used to


experience better performance and for systems that monitor flows using the
SPAN method.

3. Restart the Appliance


1. Select Operations > Restart Appliance.
2. Confirm the appliance status is Connected in Central Management.

© 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.

Network Visibility Module


If you select and configure Network Visibility Module - NVM, the Flow Collector will ingest
and store NVM flows. Follow the instructions in the Cisco Secure Network Analytics
Endpoint License and Network Visibility Module (NVM) Configuration Guide to complete
the configuration requirements.

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.

Updating Telemetry Settings


If you have an existing Flow Collector ingesting NetFlow or any other telemetry, you can
update your telemetry ingest settings using Flow Collector Advanced Settings. To access
Advanced Settings:

1. Log in to your Flow Collector (formerly known as Appliance Administration (Admin)


interface).
2. Select Support > Advanced Settings.

Each telemetry type has two settings. For more information on configuring
telemetry using Advanced Settings, follow the instructions in the Help. Select
Help > Help.

Cisco Telemetry Broker


Instead of using the UDP Director to send NetFlow to your Flow Collector, you now have
the option to use Cisco Telemetry Broker to ingest network telemetry from many inputs,
transform the telemetry format, and forward that telemetry to one or multiple destinations.

© 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

11. Licensing Secure Network Analytics


Use Cisco Smart Software Licensing to license your Secure Network Analytics appliances
and features. For more information, refer to Smart Licensing on cisco.com.
l Online: To use Smart Licensing and Secure Network Analytics online, please refer
to the Secure Network Analytics Smart Software Licensing Guide. You need Internet
access for this configuration.
l Offline: To discuss your licensing options for closed/airgap networks, contact
Cisco Support.
l Cisco Smart Account: To set up a Cisco Smart Account, register at
https://software.cisco.com or contact your administrator.

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

11. Managing Secure Network Analytics


After you have finished configuring your appliances, the Help provides instructions for
managing your environment, investigating behavior, responding to threats, and more.

To review the instructions, select the (User) icon > Help from any page.

Configuring Host Groups


1. Log in to your Manager.
2. Select Configure > Host Group Management.

Creating and Managing Policies


1. Log in to your Manager.
2. Select Configure > Policy Management.

Building Flow Searches


1. Log in to your Manager.
2. Select Analyze > Flow Search.

Running Reports in Report Builder


1. Log in to your Manager.
2. Select Dashboards > Report Builder.

Managing User Permissions


1. Log in to your Manager.

2. Click the (Global Settings) icon.


3. Select User Management.

Investigating Behavior (Alarms, Security Events, etc.)


For information about investigating alarms, events, hosts, and more, review the
information in Help.

1. Log in to your Manager.


2. Click the (User) icon.
3. Select Help.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 94 -
11. Managing Secure Network Analytics

4. At the top of the page, select the Help menu.


5. Select Investigating Behavior.

Responding to Threats
For policy information, review the information in Help.

1. Log in to your Manager.


2. Click the (User) icon.
3. Select Help.
4. At the top of the page, select the Help menu.
5. Select Responding to Threats.

© 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

Follow the instructions in the Help.

1. Log in to your Manager.

2. Select the (Global Settings) icon >


LDAP User Management.
3. Click the Authentication and
Authorization tab.

4. Select the (User) icon > Help.

Security Assertion Markup Language Refer to the Configuring SAML SSO section
Single Sign-On (SAML SSO) in this guide.

TACACS+ Configuration Guide Refer to the TACACS+ Configuration Guide.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 97 -
Authentication/Authorization

Configuring SAML SSO


Use the following instructions to configure Security Assertion Markup Language Single
Sign-On (SAML SSO). SSO is an authentication process that allows a user to access
multiple applications with one set of credentials.

Support Details
Please note the following configurations are supported or not supported.

Supported Not Supported

Microsoft Active Directory Federation


Cloud Services of Microsoft ADFS
Services (ADFS) for SAML/SSO

On-Premise solutions of Microsoft ADFS Integrated Windows Authentication (IWA)

Additional Proxies External Services

SAML request signing

The Desktop Client is not supported in Data Store deployments.

1. Prepare for Configuration


You need the following information to configure SSO:

Requirement Details

The URL must use the fully qualified domain


Identity Provider URL
name or IPv4 address.

If the IDP URL starts with HTTPS, download


Identity Provider Certificate
the CA certificate.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 98 -
Authentication/Authorization

2. Upload Certificates to the Trust Store


If the Identity Service Provider (IDP) URL starts with HTTPS, add the root CA certificate
to the Manager Trust Store.

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.

3. Configure the Service Provider


1. Log in to the Manager console as root.
2. Type SystemConfig. Press Enter.
3. Select Advanced

© 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.

6. Select IdentityProvider (IDP). Click Continue.


7. Enter the URL where the Identity Provider's configuration file can be downloaded.

Requirements: Enter the fully qualified domain name or IPv4 address.

8. Select DownloadIDP. Follow the on-screen prompts to enable it.


9. Select SaveChanges. Click Continue.

Follow the on-screen prompts to download the IDP configuration file.

10. Select SSO.


11. Review ServiceProvider(SP). Copy the URL. You will use it to configure the identity
provider.

12. Review Status. Confirm it is shown as Ready.

© 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.

7. Select SaveChanges. Click Continue.


8. Exit System Configuration.

5. Configure a Service Provider Proxy (optional)


1. Confirm ssoEnable/Disable is shown as Enabled.
2. Select ServiceProviderProxy.
3. Enter the Fully Qualified Domain Name (FQDN) of the Service Provider Proxy you
want to use.

© 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.

6. Configure the Identity Provider


1. In the address field of your browser, type the Service Provider URL.
2. Download the Service Provider metadata file sp.xml.
3. Configure the Identity Provider with sp.xml.
4. Make sure the outgoing claim type includes the user email address.

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");

7. Add an SSO User


Use the following instructions to add an SSO user. Users are authenticated through/by
the Identity Provider.

1. Log in to the Manager (Web App).


2. Click the Global Settings icon.
3. Select User Management.
4. Select Create > User.

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.

8. Test SAML Login


1. On the Web UI login page, select Log in with SSO.
2. Click the credentials button.
3. Enter the login credentials. The Manager opens to the Security Insight Dashboard.

Troubleshooting

Scenario Notes

Disable SSO Only from System Configuration


Account Lockout
through emergency account access.

Make sure the IDP certificate is uploaded to the


Cannot download IDP XML
Manager Trust Store.

Review the IDP configuration and make sure the


Cannot save IDP configuration data you entered is accurate and doesn't include
any extra spaces. Also, review the IDP event logs.

Download a SAML tracer for your browser. Repeat


Additional Issues the SSO login to review the exchanges between the
IDP and SP.

© 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 Domains and Non-Data Store Domains


l Adding and Configuring Domains
l Deleting a Domain

Data Store Domains and Non-Data Store Domains


When you configure your Manager in the Appliance Setup Tool and set up your system, you
will create a Secure Network Analytics domain with a Data Store (Data Store domain) or
without a Data Store (Non-Data Store domain).

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.

Adding and Configuring Domains


Use the following instructions to add a domain and define the domain settings. You can also
import a Non-Data Store configuration into a new Data Store domain.

l Role Permissions: You need Admin or Configuration Manager roles to configure


domains. Power Analysts can only view the domains.
l Data Store Domains: 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 before you start this procedure.

© 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.

2. Configure the following fields:

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.

If you select this


Then...
method...

Secure Network Analytics creates the domain with the default host
Default
group structure but without any Flow Collectors.

Secure Network Analytics creates the domain and uses the


appropriate configuration, based on the specific domain content you
exported (host group, domain, or both). For information on exporting
XML files containing the domain configuration, refer to the Export
Settings section.

l XML files containing the domain configuration are not


backwards compatible. These files are only compatible within
Import from File the same system version number (for example, from Flow
Collector v7.0 to Manager v7.0).
l You can also import the entire host group configuration using
the Host Group Management page.
l If you need to import interface groups in the Network Devices
branch of the Host Group tree from another domain, use this
option. You must first export the groupings as an XML file to
your local drive.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 105 -
Domains

If you select this


Then...
method...

l None of the Flow Collectors contained in the XML file is


imported.

If you add a Flow Collector to an existing domain, that domain's specific


configuration (policy, alarm severity, services, exporter SNMP, etc.) is applied to
this Flow Collector.

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.

4. To save your configuration, click Add.

Creating a Data Store Domain by Importing an Existing Non-Data Store


Domain Configuration (Optional)
If you are currently on a Non-Data Store domain and you want to add a Data Store domain to
your Secure Network Analytics system for a future expansion into Data Store, you can do so by
importing a Non-Data Store configuration into a new Data Store domain.
When you import a existing domain, you won’t have to re-configure items such as alarms, host
groups, and so on. Importing from an existing domain is like creating a new domain but with an
existing configuration.
If the domain is newly created, then you will have to re-configure your Secure Network
Analytics settings.
Follow the steps below to add a new Data Store domain and import all of its configuration from
your Non-Data Store domain.

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.

2. Configure Domain Settings


1. Complete the following settings for the domain you are adding.

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.

Click inside the Internal AS Numbers field and type your AS


numbers. Separate multiple entries with commas or by pressing
Enter after each entry to place each one on a separate line.
You can assign internal autonomous system (AS) numbers only to
Internal Autonomous domains that contain Flow Collectors When Secure Network
System (AS) Number Analytics encounters traffic containing these numbers in flow
data, it categorizes the traffic as "origin" traffic on the
Autonomous System Traffic document. Origin traffic signifies
traffic from or within your network as opposed to traffic from an
external network that is passing through your network (transit
traffic).

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 107 -
Domains

For information about the Autonomous System Traffic document,


see the "Autonomous System Traffic" topic in the Desktop Client
help.

2. Configure your Export Settings

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.

If you select this


Secure Network Analytics exports this data...
check box...

All of the data listed in "Export the Domain configuration" below. In


Export All
addition, a list of your flow collectors as well as your exporters and
configurations*
their interfaces are also exported.

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.

l Archive hour setting from the Domain Properties dialog.


l All Service definitions. For information about services, see the
"Services" topic in the Desktop Client help.
l All Alarm Configuration settings. For information about
configuring alarms, see the "About Alarm Severities" topic in
the Desktop Client help.
Export the Domain l The entire host group structure, including the host group
configuration* names and IP address ranges. Refer to the Managing and
Configuring Host Groups topic in the Secure Network
Analytics Help for more information.
l All policies. Refer to the Managing Core Policies topic in the
Secure Network Analytics Help for more information.

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.

Exporting a domain is not the same thing as backing up a configuration. To back up


an appliance configuration, refer to Creating an Appliance Configuration Backup

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.

1. Remove Flow Collectors from Central Management


If your domain includes Flow Collectors, remove them from Central Management before you delete
the domain. You can add the Flow Collectors to another domain, but the procedure includes
resetting them to their factory defaults (RFD). For instructions, refer to the following:

1. Removing an Appliance from Central Management


2. Resetting Factory Defaults
3. Adding an Appliance to Central Management

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

2. From the main menu, choose Configure > Domain Properties.


3. Click Delete Domain.

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.

Deleting a Desktop Client Domain


If you are using the Desktop Client in Secure Network Analytics without a Data Store, you can also
delete domains from the Desktop Client.

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

Integrations and Additional Configurations


We have the following additional integrations and configurations available at
https://www.cisco.com/c/en/us/support/security/stealthwatch/products-installation-
and-configuration-guides-list.html. There may be more integrations than the list shown
here.
l Configuring Cisco's ASA for NSEL Export to Stealthwatch
l Customer Success Metrics Configuration Guide
l Enabling Multiple NetFlow Exporters
l Endpoint License and Network Visibility Module (NVM) Configuration Guide
l Flow Sensor and Load Balancer Configuration Guide
l Global Threat Alerts Configuration Guide
l ISE and ISE-PIC Configuration Guide
l Secure Network Analytics and SecureX Integration Guide
l SSL/TLS Certificates Guide for Managed Appliances
l TACACS+ Configuration Guide
l Cisco Security Analytics and Logging (On Premises)

© 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)

Enabling or Disabling Password Reset


Use the following instructions to enable or disable the password reset function. If you
select Enable, passwords can be reset to the default settings using the GRUB command
line interface.

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.

1. Log in to the appliance console as root.


2. Type SystemConfig. Press Enter.
3. Select Security.
4. Select Password Reset.
5. Follow the on-screen prompts to enable or disable password reset.

Resetting Passwords to Default Settings


There are a two ways to reset your passwords to their default settings.
l Admin Password: Use Resetting the Admin Password on the Manager
l Admin, Root, Sysadmin Passwords: Use Resetting Admin, Root, Sysadmin
Passwords to Default.

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

Resetting the Admin Password on the Manager


Use the following instructions to reset your admin password to the default setting on the
Manager. Then, change the appliance password for maximum security.
l Requirements: You need the appliance root password to complete these
instructions.
l Other Users: These instructions reset the admin user to the default password. The
individual user passwords will not be changed.
l Other Appliances: These instructions do not reset the admin password on other
Secure Network Analytics appliances (Flow Collector, Flow Sensor, or
UDP Director).

1. Log in to the appliance console as root.


2. Type rm /lancope/var/smc/config/users/admin/user.xml. Press Enter.
3. Type docker restart smc. Press Enter.
4. Type docker restart nginx. Press Enter.

This will reset admin password to the default value.

5. Exit the appliance console.


6. Go to Changing Passwords to change the admin password from the default. This
step is critical for security.

Resetting Admin, Root, Sysadmin Passwords to Default


Use console access to reset your appliance admin, root, and sysadmin passwords to the
default settings. Then, change the appliance passwords for maximum security.

1. Log in to the appliance console (CIMC or hypervisor).


2. Reboot the appliance.
3. When the console screen reaches the GRUB menu, type "e" to enter edit mode.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 113 -
Passwords

4. Advance the cursor to the second line.

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:

linux /boot/vmlinuz-$kern_ver $kern_args $console_args


pci=reallo\
c=off resetpassword

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 114 -
Passwords

6. Type CTRL-X to resume booting.

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:

l Length: 8 to 256 characters


l Change: Make sure the new password is different from the previous
password by at least 4 characters.

User Default Password

admin lan411cope

root lan1cope

sysadmin lan1cope

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 115 -
Passwords

Changing the Sysadmin Password


1. Log in to the appliance console as sysadmin.
2. Select Security.
3. Select Password.
4. Follow the on-screen prompts to change the sysadmin password.
5. Exit System Configuration.

Changing the Root Password


1. Log in to the appliance console as root.
2. Type SystemConfig. Press Enter.
3. Select Security.
4. Select Password.
5. Follow the on-screen prompts to change the root password.
6. Exit System Configuration.

Changing the Admin Password on the Manager


1. Log in to the Manager as admin.

l URL: https://<IPAddress>
l Login: admin
l Default Password: lan411cope

2. Click the (Global Settings) icon.


3. Select User Management.
4. Locate the admin user in the list.
5. Click the Actions menu. Select Change Password.
6. Follow the on-screen prompts to change the admin password. Use the following
criteria:

l Length: 8 to 256 characters


l Change: Make sure the new password is different from the default password
by at least 4 characters.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 116 -
Passwords

Changing the Admin Password on All Other Appliances


Use the following instructions to change the admin user password on a Data Node, Flow
Collector, Flow Sensor, or UDP Director.

1. Log in to the Appliance Administration interface as admin.

l URL: https://<IPAddress>
l Login: admin
l Default Password: lan411cope

2. Select Manage Users > Change Password.


3. Enter the current password and new password.
4. Click Apply. Follow the on-screen prompts to change the password.
5. To change the admin password on another appliance, repeat steps 1 through 4.

Changing the Data Store Database Passwords


Use System Configuration to change your Data Store database passwords (dbadmin and
readonlyuser). You need to enable SSH temporarily as part of this procedure.

1. Log in to your Manager appliance console (SystemConfig) as root.


2. From the main menu, select Data Store.
3. Select SSH. Follow the on-screen prompts to enable SSH.
4. Select Passwords from the Data Store menu.
5. Follow the on-screen prompts to change the passwords.

Your previous SSH settings are restored when you exit the Data Store menu.

Changing the Flow Collector Database Password (Non-Data


Store Domains)
Use the Database tab on the Central Management page to update your Flow Collector
database password for all Flow Collector databases in a Non-Data Store domain.

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

1. Open Central Management.


2. Click the Database tab.
3. To generate a random password, click the Generate Password button, otherwise
enter your password in the Password and Confirm Password fields.
4. Check the Show Password check box to view your chosen password.
5. Click the Apply Settings button to save your changes.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 118 -
SSL/TLS Appliance Identity and Additional SSL/TLS Client Identities

SSL/TLS Appliance Identity and


Additional SSL/TLS Client Identities
Use SSL/TLS Appliance Identity and Additional SSL/TLS Client Identities to manage your
Secure Socket Layer (SSL) and Transport Layer Security (TLS) Certificates for the
selected appliance. Follow the instructions in the SSL/TLS Certificates for Managed
Appliances Guide for all certificate-related changes.

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.

1. Open Central Management.


2. Click the (Ellipsis) icon for the appliance.
3. Select Edit Appliance Configuration.
4. Select the Appliance tab.
5. To review the appliance identity certificate, go to the SSL/TLS Appliance Identity
section.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 119 -
SSL/TLS Appliance Identity and Additional SSL/TLS Client Identities

To review the client identity certificates, go to the Additional SSL/TLS Client


Identities section.

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.

Adding Appliances to Central Management with Custom


Certificates
Refer to Adding an Appliance to Central Management for more information. 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.

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.

Changing the Host Name, Network Domain Name, or IP


Address
To change the appliance host name, network domain name, or IP address after you've
installed and configured your appliances, follow the instructions in the SSL/TLS
Certificates for Managed Appliances Guide.
As part of the procedure, you will remove the appliance from Central Management
temporarily, and the appliance identity certificate is replaced automatically.

The appliance identity certificate is replaced automatically as part of this


procedure.

If your appliance uses a custom certificate, please contact Cisco Support to


change these settings. Do not use the instructions shown here. Make sure you
have a copy of the custom certificate and private key.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 120 -
SSL/TLS Appliance Identity and Additional SSL/TLS Client Identities

Reviewing Trust Store Certificates


When you add a certificate to an appliance trust store, you are allowing communication
with that identity, whether it is another Secure Network Analytics appliance or an external
service.
l Instructions: Follow the instructions in the SSL/TLS Certificates for Managed
Appliances Guide for all trust store changes.
l Upload Individual Files: If your file includes more than one certificate, upload each
certificate individually to the trust store.

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.

1. Open Central Management.


2. Click the Actions menu for the appliance.
3. Select Edit Appliance Configuration.
4. Select the General tab.
5. Review the Trust Store list.

© 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.

1. Log in to your primary Manager.

2. Click the (Global Settings) icon.


3. Select Central Management.
4. Click the (User) icon. Select Help.
5. Select Appliance Configuration > Threat Feed.

Reviewing Alarms and Security Events


When the Threat Feed is enabled, the Stealthwatch Labs Intelligence Center icon is
shown in the Desktop Client Enterprise tree with an alarms status, and threats are
displayed in their respective host group branches. For more information, refer to the
Desktop Client User Guide or the help.

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)

Central Management (Managing your


Appliances)
Use Central Management to manage your appliances from your primary Manager. We've
included an overview of Central Management here, and details for each section are
available in Help.
l About Central Management: When your appliances are managed by Central
Management, you can review their status and manage the following: edit appliance
configuration, update software, reboot, shut down, and more.
l
Help: To open the Help, click the (User) icon. Select Help.

This section covers the following topics:


l Central Management and Appliance Administration Interface
l Opening Central Management
l Opening Appliance Admin
l Editing the Appliance Configuration
l Viewing Appliance Statistics
l Removing an Appliance from Central Management
l Adding an Appliance to Central Management
l Creating an Appliance Configuration Backup
l Enabling/Disabling SSH

Central Management and


Appliance Administration Interface
When an appliance is managed by Central Management, you will access functions for
your appliance in Central Management and the Appliance Administration interface
(Appliance Admin) as follows:

Central Management Appliance Admin Interface

Edit appliance configuration View system statistics

Review license status (overview)

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 124 -
Central Management (Managing your Appliances)

Back up configuration files Back up database files

View audit logs Create diagnostics packs

Reboot Network Host and IP Lookup

Shut down Packet Capture

Update software Clearing the DNS Cache

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.

Opening Central Management


1. Log in to your primary Manager.

2. Click the (Global Settings) icon.


3. Select Central Management.

Opening Appliance Admin


You can access the Appliance Admin interface through Central Management or by
logging in to the appliance directly.

Opening Appliance Admin through Central Management


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.

Opening Appliance Admin through Direct Login


1. In your browser address bar, type the appliance IP address as follows:

https://<IPAddress>

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 125 -
Central Management (Managing your Appliances)

l Manager: add /Manager/index.html after the IP address.


l For example: https://1.1.1.1/Manager/index.html

2. Press Enter.

Editing the Appliance Configuration


1. On the Central Management Appliance Manager page, click the Actions menu for
the appliance.
2. Select Edit Appliance Configuration.

3. Click the Configuration menu. Select an item from the list.

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.

For instructions, click the User icon.

© 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.

Viewing Appliance Statistics


Hover: For more information about each appliance status, hover your pointer over the
status.
To see system statistics, services, disk usage, and docker services, log in to the
Appliance Admin interface:

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.

Removing an Appliance from Central Management


Use the following instructions to remove an appliance from your Central Manager.

1. On the Central Management Appliance Manager page, click the Actions menu for
the appliance.
2. Select Remove This Appliance.

l Data Store Appliances: Go to Removing Data Store Appliances from


Central Manager for additional requirements.
l Flow Collectors: If you removed a Flow Collector from Central Management,
it is also removed from the domain. You need to reset the factory defaults
(RFD) if you plan to add it to a different domain. Go to Adding an Appliance to
Central Management and Adding an Appliance to Central Management for
instructions.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 127 -
Central Management (Managing your Appliances)

l Config Channel Down: If you're removing the appliance because the


configuration channel is down, go to the Config Channel Down procedure in
Troubleshooting for additional instructions.
l Troubleshooting: If you log in to the Appliance Admin interface and the
appliance is not removed from Central Management, go to the Config Channel
Down procedure in Troubleshooting to remove it using System Configuration.
l Central Management: To add the appliance to a different Central Manager,
use the Appliance Setup Tool.

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.

Removing Data Store Appliances from Central Manager


If you remove Data Store appliances from Central Manager (Manager, Flow Collector,
Data Node), it does not remove them from the Data Store itself. This needs to be manually
cleaned up.
l Managers and Flow Collectors: For Managers and Flow Collectors, you can
remove them from the /lancope/var/services/data-store/config-datastore-
inventory-snapshot directory.
l Data Nodes: Contact Cisco Support for assistance with the removal Data Nodes as
that process is more complicated.

Adding an Appliance to Central Management


Use the Appliance Setup Tool to add an appliance to Central Management. It is important
to review the following:
l Custom Certificates: If your appliance has custom certificates, make sure you save
the identity certificate and certificate chain (root and intermediate) to its own Trust
Store and the Manager Trust Store before you add the appliance to Central
Management. For instructions, refer to the SSL/TLS Certificates for Managed
Appliances Guide.
l Manager Administration Credentials: You need the Manager, user ID and
password to add an appliance to Central Management.
l RFD: If you reset the factory defaults on an appliance, configure the appliance
IP address, host name, and domain before you add it to Central Management (even
if you preserve network settings when you RFD).

© 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.

1. Log in to the appliance.

In your browser address bar, type the appliance IP address as


follows: https://<IPAddress>

2. Rreplace the end of the URL with /lc-ast:

https://<IPAddress>/lc-ast

3. Press Enter.

4. Click Next to scroll to the Central Management tab.


5. IP Address: Enter the Manager/Central Manager IP address.
6. Click Save.
7. Follow the on-screen prompts to enter the Manager administration credentials and
finish the configuration. Depending on the type of appliance, you may need to enter
additional information.

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)

Creating an Appliance Configuration Backup


Use Central Management to back up an appliance configuration.

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).

1. Open Central Management.


2. Click the (Ellipsis) icon for the appliance.
3. Select Support.
4. Select the Configuration Files tab.
5. Select the (User) icon. Follow the instructions in the Help.

To restore an appliance configuration backup, follow the instructions in the Help.

Enabling/Disabling SSH
Use this section to control the ability to access the appliance using SSH (secure shell).
Default: disabled

When SSH is enabled, the system’s risk of compromise increases. It is important


to enable SSH only when you need it. When you are finished using SSH, disable
it.

Open SSH
Use the following instructions to open SSH for a selected appliance.

1. Open Central Management.


2. Click the Actions menu for the appliance.
3. Select Edit Appliance Configuration.
4. Select the Appliance tab.

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)

Creating a Database Backup (Non-Data Store


Domains)
Use the following instructions to back up your Manager and Flow Collector databases. To
back up the Data Store, refer to Creating a Data Store Backup.

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.

This process involves completing the following procedures:

1. Trim the Flow Collector Database


2. Delete the Database Snapshots
3. Back Up to Remote File System
4. Delete the Database Snapshots

1. Trim the Flow Collector Database


The Flow Collector database backup can take multiple days to finish and will slow your
network speed if the database is large. Before you back up your databases, we
recommend trimming the Flow Collector database. This will free the available disk space
for storing flows and reduce the amount of time it takes to back up the database.
The Flow Collector stores the maximum number of days based on the disk space and the
amount of data collected per day. When the maximum (75% of the /lancope/var partition)
is hit, the database will start to delete the oldest data first to allow new data to come in.

1. Review your Database Storage Statistics


Use the following instructions to check your database storage.

1. Log in to the Flow Collector Appliance Admin interface.


2. Select Support > Database Storage Statistics.
3. Review the days stored in Capacity, Flow Data Summary, and CI Event Data
Summary (or Security Event Data Summary).

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 132 -
Creating a Database Backup (Non-Data Store Domains)

2. Trim the Interface Details


The Flow Interface Data is the data related to the interfaces of exporters. Secure Network
Analytics saves flow interface data and flow data.
The Flow Interface default setting causes the system to push out the flow data, so it can
keep all the interface statistics it can. This function uses the Desktop Client as a main tool
which does not apply to Data Store systems. A node may be needed to indicate that the
trimming procedure only applies to Non-Data Store systems.

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.

1. Log in to Desktop Client as the admin user.


2. Locate the Flow Collector in the Enterprise Tree. Click the plus (+) sign to expand
the container.
3. Right-click the Flow Collector. Select Configuration > Properties.
4. In the Flow Collector Properties dialog box, click Advanced.
5. Select the Store flow interface data.
6. Shorten the storage limit. For example, if you set the limit to Up to 7 days, anything
older than 7 days will be lost.
7. Click OK.
8. Wait 5 minutes to proceed to the next steps.

3. Trim Flow Details and CI Event Data


To reduce the size of the Flow Details and CI Event/Details in the Flow Collector database,
contact Cisco Support. This step is optional, and the trimming process takes only a few
minutes to complete, but the process requires guidance.
When you trim the NetFlow, you will specify the number of days to keep Flow Details & CI
Event/Details in the Flow Collector database. Two things will occur with this configuration:
l The database is trimmed down to the number of days you enter.
l The database starts rolling the older data out based on the oldest day but without
trying to save as much as possible.

2. Delete the Database Snapshots


Before you create backup files, make sure you delete any saved snapshots on the
Manager and Flow Collector databases using the following instructions.

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:

/opt/vertica/bin/vsql -U dbadmin -w lan1cope -c "select * from


database_snapshots;"

3. Delete Snapshots (if they exist): Type:

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 134 -
Creating a Database Backup (Non-Data Store Domains)

/opt/vertica/bin/vsql -U dbadmin -w lan1cope -c "select remove_


database_snapshot('StealthWatchSnap1');"

4. Wait until the snapshot folder is removed: Check:

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.

3. Back Up to Remote File System


To back up a database to a remote file system, complete the following steps:
l Space: Make sure the remote file system has enough space to store the database
backup.
l Time: After you back up the database once, subsequent backups will be quicker
because the process backs up only what has changed since the last backup. This
process backs up approximately 0.5 GB to 2 GB of data per minute.

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.

3. Click Configuration > Remote File System.

© 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).

5. Click Apply to place the settings in the configuration file.

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)

8. Click Create Backup. This process may take a long time.

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.

9. Click Close to close the progress window.

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.

4. Delete the Database Snapshots


After you have saved the backup files, use the following instructions to delete the
snapshots on the Manager and Flow Collector databases.

Make sure you delete the Manager and Flow Collector database snapshots. This
step is critical for a successful update.

1. Log in to the Manager or Flow Collector appliance database console as admin.


2. Check for Snapshots: Type:
/opt/vertica/bin/vsql -U dbadmin -w lan1cope -c "select * from
database_snapshots;"

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 137 -
Creating a Database Backup (Non-Data Store Domains)

3. Delete Snapshots (if they exist): Type:


/opt/vertica/bin/vsql -U dbadmin -w lan1cope -c "select remove_
database_snapshot('StealthWatchSnap1');"
4. Wait until the snapshot folder is removed: Check:

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)

Restoring a Database Backup (Non-Data


Store Domains)
Use the following instructions to restore your Manager and Flow Collector databases. To
restore the Data Store, refer to Restoring a Data Store Backup.

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.

Do not interrupt the restoration process after it has begun.

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)

6. Type the root shell password and then press Enter.


7. Run the following command:

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

Data Store Database


If you've configured Secure Network Analytics with a Data Store, you can access the Data
Store tab in Central Management.

Data Store Tab


Use the Data Store tab in Central Management to:
l Status: View the status of your database or any Data Node. For details, refer to
Viewing the Data Store Database Status.
l Start or Stop: You can also start or stop the database or any Data Node. For details,
refer to Viewing the Data Store Database Status.
l Storage Usage: View the current storage usage statistics for your database. You
can also modify retention status for flow interface data. For details, refer to Viewing
Database Retention.
l Update Status: View the status of all Data Nodes during updates. For details, refer
to Monitoring the Data Node Update Status.

Opening the Data Store Tab


1. Log in to your Manager.

2. Click the (Global Settings) icon.


3. Select Central Management.
4. Click the Data Store tab.

Viewing the Data Store Database Status


The Database Control tab page opens when you click the Data Store tab in Central
Management. This tab displays the status of the database and each Data Node.
l Sorting: The Data Nodes on this tab are sorted by their Private LAN IPs by default.
You can re-sort the Data Nodes nodes by clicking the column header by which you
want to sort.
l Status: Under normal conditions, your database and all Data Nodes will show a
status of Up. Your database may be Up but the status of one of your Data Nodes
could be Down. After recovering a failed Data Node, you may see your database
showing as Up but your newly recovered Data Node will be in a "recovering” state.
l Actions Menu: 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. - 141 -
Data Store Database

Make sure you use the Actions menu to start or stop your database (or a Data
Node).

Starting the Database


1. Ensure that the Database Control tab is selected.
2. Click the (Ellipsis) icon in the Actions column for the database.
3. Select Start.
4. Confirm the database status is shown as Up.

Stopping the Database


1. Ensure that the Database Control tab is selected.
2. Click the (Ellipsis) icon in the Actions column for the database.
3. Select Stop.
4. Confirm the database status is shown as Down.

Starting a Data Node


Follow the steps below to start a Data Node.

1. Ensure that the Database Control tab is selected.


2. Find the Data Node you want to start. Click the (Ellipsis) icon in the Actions
column.
3. Select Start to start the Data Node.
4. Confirm the Data Node status is shown as Up.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 142 -
Data Store Database

Stopping a Data Node


Follow the steps below to stop a Data Node.

1. Ensure that the Database Control tab is selected.


2. Find the Data Node you want to stop. Click the (Ellipsis) icon in the Actions
column.
3. Select Stop to stop the Data Node.
4. Confirm the Data Node status is shown as Down.

Reviewing Last Action Results


Only one action may be in progress at any time regardless of the number of users. When
an action is in progress, no other actions can be taken. Once an action has completed, the
completion status will be displayed for all users in a banner at the top of the screen.
Follow the steps below to review last action results.

1. Ensure that the Database Control tab is selected.


2. Click the Last Action Results link at the bottom of the screen. The Action Results
banner will remain on screen until you dismiss it.

Viewing Database Retention


The Database Retention tab answers questions such as:
l How full is my database?
l How much is each telemetry type (NetFlow, NVM, firewall log) contributing to this
fullness?
l How much data was newly stored in my database yesterday?
l What is the total capacity of my database?

All of the charts as well as the Data Storage Statistics section on this page are
updated once per day.

Opening the Data Store - Database Retention Tab


1. Click the (Global Settings) icon.
2. Select Central Management.
3. Click the Data Store tab.
4. Click the Database Retention tab.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 143 -
Data Store Database

Database Fullness Chart


The Database Fullness chart displays the amount of used and free space that exists in
your Data Store database.

Per Telemetry Contribution Chart


The Per Telemetry Contribution chart displays a breakdown of the data that exists in your
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.

Changing the Flow Interface Data Storage


Flow interface statistics provide a more detailed view of flow statistics. They are useful for
troubleshooting and investigating recent flow data by providing multiple vantage points in
the network for a given flow. For example, if a flow is observed on multiple exporters or
multiple interfaces of the same exporter, the details are stored in flow interface statistics.
The Data Store retains data for as long as possible, and the amount of retention time is
determined by your system's ingest rate. Once the Data Store reaches full capacity, it
starts deleting the oldest data automatically.

© 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.

1. In the Store Flow Interface Data section, choose As much as possible or Up to


days (click the up or down arrows to change the number of days).
2. Click Apply Settings.

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.

Monitoring the Data Node Update Status


After initiating an update of your Data Nodes from your Central Management Update
Manager, use the Database Update Status tab to monitor the progress of the database
services update on each Data Node.

Opening the Data Store - Database Update Status Tab


1. Click the (Global Settings) icon.
2. Select Central Management.
3. Click the Data Store tab.
4. Click the Database Update Status tab.

Monitoring the Database Update Status


Each Data Node progresses through a series of states during an update. Click the Data
Store Update Workflow link to see a visual representation of the update process (shown
below).

© 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.

The following image shows the Data Store update workflow.

© 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

Creating a Data Store Backup


Contact Cisco Professional Services for assistance with planning and
implementing these tasks.

To backup your Data Store, complete the following procedures:


1. Estimate Backup Host Storage Requirements
2. Prepare a Backup Host with twice the storage capacity of the backup size.
Install Python v3.7 and rsync v3.0.5 on the backup host.

Use a Linux-based host separate from your Secure Network Analytics


appliances.

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

1. Estimate Backup Host Storage Requirements


1. Log in to your Data Node console as root.

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.

/opt/vertica/bin/vsql -U dbadmin -c "SELECT SUM(used_bytes)


FROM storage_containers;"

3. Multiply the sum by 2 to estimate how much storage space your backup host needs.

2. Prepare a Backup Host


1. Based on the storage requirements you estimated in 1. Estimate Backup Host
Storage Requirements, identify a host running Linux on your network to store the
backup, or deploy a host running Linux with the necessary storage requirements.

Use a Linux-based host separate from your Secure Network Analytics


appliances.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 148 -
Creating a Data Store Backup

2. Log into the backup host console as root.


3. From the command prompt, enter python3 --version and press Enter to see
what version of Python you have installed. You have the following options:

l If Python 3.7 or later is installed, go to step 6.


l Otherwise, install Python 3.7, beginning with step 4.

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:

l If rsync 3.0.5 or later is installed, continue to step 9.


l Otherwise, install rsync 3.0.5. Continue to step 7.

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.

3. Enable Passwordless SSH Access for dbadmin


1. Open port 22/TCP between the backup host and each Data Node for SSH, and port
50000/TCP between the backup host and each Data Node for rsync.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 149 -
Creating a Data Store Backup

2. Review the OpenSSH documentation on ssh-copy-id dbadmin@<hostname> for


more information.
3. Log into the first Data Node as dbadmin by typing the following:

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.

4. Initialize the Backup Directory on the Backup Host


1. Log in to the first Data Node console as root.

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

If you updated the dbadmin password using the setup-sw-datastore-secure-


connectivity script, you must also update the password stored in the pw.ini
backup password file, or your backup fails.

8. Copy the following lines to a plaintext editor:

[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:

l Connect to any Data Node console as root


l Enter su dbadmin
l Enter admintools -t node_map
l Use the node names in the “NODENAME” column for the [Mapping]entries

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

5. Back Up the Data Store Database


You will only need to issue the backup command on one Data Node in order to
back up your entire multi-node database.

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.

Data Store Backup Failure


If your Data Store backup fails, make sure to remove the database snapshot before
attempting another backup. Follow these steps to remove the Data Store database
snapshot.

1. Connect to your Data Store database cluster using vsql.


2. Execute the following command to retrieve a list of your snapshots:

select * from database_snapshots;


3. Replace ‘snapshot_name’ with the name of the snapshot that you want to remove,
then execute the following command:

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

Restoring a Data Store Backup


Contact Cisco Professional Services for assistance with planning and
implementing these tasks.

To backup your Data Store, complete the following procedures:


1. Review the Backup Names and Software Versions
2. Stop the Data Store Database
3. Restore the Data Store from a Backup
4. Start the Data Store
5. Remove the Catalog Snapshot
6. Review the Restored Database

1. Review the Backup Names and Software Versions


1. Confirm the Data Store database backup and the Data Store have identical Data
Node names and the same number of Data Nodes.
2. Confirm the Data Store database backup and the Data Store have the same version
of Secure Network Analytics installed.

We do not support restoring a database to a version that is different from the


backup version.

2. Stop the Data Store Database


1. Log in to your Manager.

2. Click the (Global Settings) icon.


3. Select Central Management.
4. Click the Data Store tab.
5. Locate the Database.
6. Click the (Ellipsis) icon in the Actions column.
7. Select Stop.
8. Keep the Data Store Database Control tab open. You will use it in a later procedure.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 154 -
Restoring a Data Store Backup

3. Restore the Data Store from a Backup


Make sure you run the following commands before and after the database is
restored, for comparison:
/opt/vertica/bin/vsql -U dbadmin -w <password> -c "select*
from partitions;" >/lancope/var/tcpdump/partitions-full-
DBbackup

1. If you updated the dbadmin password using the setup-sw-datastore-secure-


connectivity script, you must also update the password stored in the pw.ini
backup password file, or your restore fails.
2. Identify the Data Node on which you stored the config.ini backup configuration
file, and log into its console as root. Refer to 4. Initialize the Backup Directory on
the Backup Host for details.
3. Enter su - dbadmin and press Enter to run the following commands as the
dbadmin user.
4. From the command prompt, enter vbr --task restore --config-file
config.ini and press Enter to restore the Data Store from the backup host.

4. Start the Data Store


1. Return to the Data Store Database Control Tab in Central Management.
2. Locate the Database.
3. Click the (Ellipsis) icon in the Actions column.
4. Select Start.

5. Remove the Catalog Snapshot


After you restart the Data Store, remove the snapshot named catalog. This snapshot is
not required after the restore resolves, and it prevents Vertica from running retention
management.

1. Log in to your Data Node console as root.


2. Enter su - dbadmin and press Enter to run the following commands as the
dbadmin user.
3. Type the following command, replacing [password] with your dbadmin password,
and then pres Enter. This will remove the catalog snapshot.

/opt/vertica/bin/vsql -U dbadmin -w [password] -c "select


remove_database_snapshot('catalog');"

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 155 -
Restoring a Data Store Backup

6. Review the Restored Database


Make sure you run the following commands before and after the database is
restored, for comparison:
/opt/vertica/bin/vsql -U dbadmin -w <password> -c "select*
from partitions;" >/lancope/var/tcpdump/partitions-full-
DBbackup

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 156 -
Data Store Maintenance

Data Store Maintenance


This section includes the following Data Store topics:
l Enabling Data Compression in the Data Store
l Adding a Data Store Domain
l Adding a Secondary Manager or Flow Collectors after the Data Store is
Initialized
l Adding Data Nodes to the Data Store
l Replacing a Data Node (Hardware Only)

Make sure you review the procedure before you start. Some of the procedures
include contacting Cisco Support for assistance.

Enabling Data Compression in the Data Store


Data compression is enabled by default on new installations for Flow Collectors that are
configured with Data Store. You can use it to reduce bandwidth usage between a Flow
Collector and the Data Store. It is especially helpful in scenarios where the network
bandwidth from a Flow Collector to the Data Store is limited.
By enabling compression, you may reduce this bandwidth by up to 90%. If Data
Compression is disabled, it can be enabled on a per Flow Collector basis. Make the
following configuration changes in the Flow Collector interface to enable compression of
data sent to the Data Store.

1. Log in to the Flow Collector Appliance Admin interface.


2. Click Support > Advanced Settings.
3. In the ingest_enable_compression field, enter one of the following

l 1 - Enable data compression


l 0 - Disable data compression

4. Click Apply and then click OK in the information window.

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

Adding a Data Store Domain


You can add Managers, Flow Collectors, and Data Nodes to an existing Data Store
domain as shown in this section. If you do not have a Data Store domain in your
deployment, follow the instructions in Adding Data Store to a Non-Data Store
Deployment.

Adding a Secondary Manager or Flow Collectors after the


Data Store is Initialized
Use the following instructions to add a secondary Manager or Flow Collector to your Data
Store if you've already initialized the Data Store.
For more information about the secondary Manager and failover configuration, refer to 3.
Defining a Manager Failover Relationship.
If you have existing Flow Collectors that you configured for use without a Data Store, you
need to reset each appliance to factory defaults (RFD) before you can configure them for
use with a Data Store and add them to your deployment.

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.

2. Follow the instructions in 1. Configuring Your Environment Using First Time


Setup and 2. Configuring the Managed System to configure the appliance and
add it to Central Management.
3. Log in to the Manager appliance console as root.
4. Type SystemConfig and press Enter.
5. Select Data Store.
6. Select SSH. Wait while SSH is enabled across your appliances.

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

Adding Data Nodes to the Data Store


Contact Cisco Professional Services for assistance with planning and
implementing these tasks.

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.

Before you Begin


You may want to consider using a maintenance window when expanding your Data Store.
Before expanding your Data Store, all data is distributed evenly across your Data Nodes.
For example, in a three node Data Store, one third of your data resides on each Data
Node. Upon expansion of a Data Store, all data is redistributed evenly across the newly
added nodes. For example, if a 3 node Data Store is expanded to 6 nodes total,
redistribution results in one sixth of the data on each Data Node. When expanding a single
node Data Store to three nodes, data is redistributed one third to each node.
During the operation of redistributing data, the query performance of your Data Store may
be temporarily reduced. The size and duration of the impact is related to the amount of
data which needs to be moved and the bandwidth of your private LAN between Data
Nodes. For example, a hardware Data Store with port bonding could use 20GB of private
LAN bandwidth to move the data. The database will remain operational during the
redistributing of data but we suggest using a maintenance window if you want to minimize
impact to your users.

Procedures
To add Data Nodes to your deployment, complete the following procedures:

1. Create a Data Store Backup


Before you add a Data Node, back up the Data Store. For instructions, refer to Creating a
Data Store Backup for more information.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 159 -
Data Store Maintenance

2. Configure the Data Node and Add it to Central Management


1. Deploy the Data Nodes to your network. For instructions, refer to the x2xx Series
Hardware Appliance Installation Guide, the Secure Network Analytics x3xx Series
Hardware Installation Guide, or the Virtual Edition Appliance Installation Guide.

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.

3. Add Data Nodes to the Data Store


1. Log in to the Manager appliance console as root.
2. Type SystemConfig and press Enter.
3. Select Data Store.
4. Select SSH. Wait while SSH is enabled across your appliances.
5. From the Data Store menu, select New Data Nodes. Follow the on-screen
prompts.

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.

4. Rebalance Data in the Data Store

A rebalance is required after adding additional Data Nodes to the Data Store.
Contact Cisco Support for assistance with this process.

Replacing a Data Node (Hardware Only)


Use the following instructions to prepare a new (spare) Data Node for the following
scenarios:

© 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.

Contact Cisco Professional Services for assistance with planning and


implementing these tasks.

1. Prepare the New (Spare) Data Node


1. Install the new (spare) Data Node appliance in the same rack setup as the existing
Data Node appliances. For installation instructions, refer to the x2xx Series
Hardware Appliance Installation Guide or the Secure Network Analytics x3xx Series
Hardware Installation Guide.

Check the following:

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.

2. Connect the Data Node to power and power on.


3. Upgrade the image on the new Data Node to match the image already running on
the existing Data Nodes. Please contact Cisco Support for assistance.

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.

5. Verify full connectivity by performing the following steps:

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

2. Create a Data Store Backup


For instructions, refer to Creating a Data Store Backup for more information.

3. Contact Cisco Support


Contact Cisco Support to complete the replacement.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 162 -
Adding Data Store to a Non-Data Store Deployment

Adding Data Store to a Non-Data Store


Deployment
Before you use these instructions, make sure you have already installed Secure Network
Analytics with a Non-Data Store domain. For instructions, refer to Planning Your System
Configuration.
After your Non-Data Store deployment has been installed and configured, use the
appropriate instructions to add a Data Store to your Non-Data Store deployment.
l Adding Data Store with an Existing Flow Collector
l Adding Data Store with a New Flow Collector

For Data Store compatibility information, refer to the Secure Network Analytics
Hardware and Software Version Support Matrix.

Adding Data Store with an Existing Flow Collector


The following procedure provides a scenario for re-using your existing Flow Collector.

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

Adding Data Store with a New Flow Collector


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. Deploy and install your hardware or virtual Flow Collector and Data Nodes. Refer to
the x2xx Series Hardware Appliance Installation Guide or the Virtual Edition
Appliance Installation Guide for more information.
4. Run First Time Setup on the Flow Collector, making sure to select Data Store.
5. Add the Flow Collector 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. This assumes you are using a brand new Flow Collector to
add Data Store.
6. Follow the instructions to configure each Data Node in First Time Setup and add
them to Central Management using the Appliance Setup Tool.
7. 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. - 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.

Appliance Status: Data Store Not Initialized


You need to finish your Secure Network Analytics system configuration.
After you add all Managers, Flow Collectors, and Data Nodes to your Central
Management inventory, you need to initialize the Data Store. For instructions, refer to 5.
Initializing the Data Store.

Appliance Status: Data Store Not Configured


If you've added a new Manager, Flow Collector, or Data Node to your Data Store, you
need to finish your system configuration. For instructions, refer to Data Store
Maintenance.

Opening the Appliance Administration Interface


You can access the Appliance Admin interface through Central Management or by
logging in to the appliance directly.
You may need to log in to Appliance Admin if you've removed your Manager from Central
Manager for troubleshooting.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 165 -
Troubleshooting

1. In your browser address bar, type the appliance IP address as follows:

https://<IPAddress>
l Manager: add /Manager/Index.html after the IP address.
l Example: https://xx.xxx.xx.xxx/Manager/index.html

Replacing the 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 with a
certificate from a Certificate Authority, refer to the SSL/TLS Certificates for Managed
Appliances Guide for instructions.

Your certificates are critical for your system’s security. Improperly modifying
your certificates can stop Secure Network Analytics appliance communications
and cause data loss.

Removing Data Store Appliances from Central Manager


If you remove Data Store appliances from Central Manager (Manager, Flow Collector,
Data Node), it does not remove them from the Data Store itself. This needs to be manually
cleaned up.
l Managers and Flow Collectors: For Managers and Flow Collectors, you can
remove them from the /lancope/var/services/data-store/config-datastore-
inventory-snapshot directory.
l Data Nodes: Contact Cisco Support for assistance with the removal Data Nodes as
that process is more complicated.

Changing the Host Name, Network Domain Name, or IP


Address
To change the appliance host name, network domain name, or IP address after you've
installed and configured your appliances, follow the instructions in the SSL/TLS
Certificates for Managed Appliances Guide.
As part of the procedure, you will remove the appliance from Central Management
temporarily, and the appliance identity certificate is replaced automatically.

The appliance identity certificate is replaced automatically as part of this


procedure.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 166 -
Troubleshooting

If your appliance uses a custom certificate, please contact Cisco Support to


change these settings. Do not use the instructions shown here. Make sure you
have a copy of the custom certificate and private key.

Opening Domain Properties


From the main menu, choose Configure > Domain Properties.
For more information, refer to Domains.

Deleting a Desktop Client Domain


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.

Opening the Appliance Setup Tool


Use the following instructions to open the Appliance Setup Tool after you've configured
an appliance.

If you change the host name, network domain name, or IP address using the
Appliance Setup Tool, the appliance identity certificate is replaced automatically.

If your appliance uses a custom certificate, please contact Cisco Support to


change these settings. Do not use the instructions shown here. Make sure you
have a copy of the custom certificate and private key.

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

System Configuration Overview


We've updated System Configuration with a new menu structure. System Configuration
often involves troubleshooting. For assistance, please contact Cisco Support.
l Users: The available menus are determined by whether you log in as root,
sysadmin, or admin.
l SSH: You may need to enable SSH to access a menu.

1. Log in to the appliance console.


2. Type SystemConfig. Press Enter.
3. From the main menu, select a menu:
l Network: To change appliance management port network, trusted hosts, and
network interfaces, select Network.
l Security: To change or reset passwords (refer to Passwords) and manage Syslog
Compliance, select Security.
l Recovery: To remove an appliance from Central Management, reset factory
defaults, create a diag pack, or refresh the image, select Recovery.
l Advanced: To open the root shell, manage the admin user account, configure
Single Sign-On, reboot, or shut down, select Advanced.
l Data Store: This menu is available in Managers configured for use with a Data
Store. Use this menu for enabling SSH, initialization, adding new Managers and
Flow Collectors to the Data Store, adding Data Nodes to the Data Store, and
changing the Data Store database passwords. Refer to Data Store Maintenance
and Passwords for instructions.

Changing the Trusted Hosts


You can use System Configuration to change the trusted hosts list from the appliance
defaults. However, please contact Cisco Support before you change your trusted hosts.

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.

1. Log in to the appliance console as sysadmin.


2. Select Network > Trusted Hosts.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 168 -
Troubleshooting

3. Follow the on-screen prompts to change the Trusted Hosts.

Creating a Diagnostic Pack


Having a diagnostics pack can be invaluable if you need to work with Cisco Support to
troubleshoot an issue. Use the following instructions to create a diagnostics pack for an
individual appliance.

1. Log in to the appliance console as root.


2. Select Recovery.
3. Select Diagnostics Pack.
4. To customize your diagnostics pack, select a menu and click Edit.

Menu Description

Add a file name prefix for your


File Name Prefix diagnostics pack (maximum of 127
characters).

Create a file password for your


diagnostics pack. If you do not create
Password a file password, we will encrypt the
diagnostics pack with the default
method (Cisco key).

Select this option and follow the on-


screen prompts to include a
configuration backup in your
Configuration Backup
diagnostics pack. For more
information about backups, refer to
Backup Configuration Files in the Help.

Edit the diagnostic pack contents by


Modules selecting the specific modules you
want to include.

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

Resetting Factory Defaults


Use the following instructions to reset an appliance to its factory defaults (RFD). To
completely erase data, make sure you reset factory defaults twice.
l RFD twice: To completely erase data, make sure you reset factory defaults twice.
l Back up Configuration: If you plan to restore the appliance configuration, make
sure you save the backup configuration and database backup files. Refer to Backup
Configuration Files (in Central Management) and Backup/Restore Database
(Appliance Admin interface) topics in the Help for details. To restore the backup
after RFD, contact Cisco Support.

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.

1. Log in to the appliance console as sysadmin.


2. Select Recovery > Factory Defaults.
3. Follow the on-screen prompts to reset factory defaults and restart the appliance.

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).

Enabling/Disabling Admin Users


Use the following instructions to enable or disable the default admin account.

1. Log in to the appliance console as sysadmin.


2. Select Advanced.
3. Select Admin User.
4. Follow the on-screen prompts to enable or disable the Admin User account.

© 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

Data Store Deployment Troubleshooting


Hardware Deployment Troubleshooting
For issues with deploying or configuring your appliances, refer to the x2xx Series
Hardware Appliance Installation Guide or the Secure Network Analytics x3xx Series
Hardware Installation Guide for more information.

Virtual Appliance Deployment Troubleshooting


For issues with deploying or configuring your Virtual Edition appliances, refer to the Virtual
Edition Appliance Installation Guide for more information.

First Time Setup and Data Nodes Virtual Edition


If you do not assign two network adapters to your Data Nodes Virtual Edition during the
installation, First Time Setup will fail to resolve because it cannot detect a second network
adapter. This will prevent you from assigning a non-routable IP address for inter-Data
Node communications. Refer to the Virtual Edition Appliance Installation Guide for more
information.

Data Store Troubleshooting


Note that the Data Store reserves up to 40% of the available storage space to maintain the
Data Store. At a maximum, 60% of the total space is available for telemetry storage.

Vertica Analytics Platform does not automatically restart after


a Data Node loses power and reboots
If a Data Node loses power unexpectedly, and you reboot the appliance, the Vertica
Analytics Platform (Vertica) instance on that Data Node may not automatically restart, due
to possible corrupted data. If there are still enough running Data Nodes to allow the Data
Store to continue running, the Data Store continues ingesting data from the Flow
Collectors. However, you need to restart the Data Node as soon as possible, to allow it to
rejoin the Data Store, retrieve missed data from adjacent Data Nodes, and catch up with
the rest of the Data Nodes.
To restart the Data Node, try each of the following methods:
l Start the Data Node on the Central Management > Data Store tab. Refer to Starting
a Data Node for details.

© 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.

1. Log in to your Data Node appliance console as root.


2. Copy the following command and paste it into a text editor:

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:

admintools -t restart_node --hosts=[data-node-ip-address] --


database='sw-datastore' --password="[dbadmin-password]" --force
6. Replace [data-node-ip-address] with your affected Data Node's IP address.
Make sure you use the private IP address shown in the Data Store Tab. Do not use
the eth0 management IP address.
7. Replace [dbadmin-password] with your Data Store dbadmin password.
8. Copy the updated command and paste it into the CLI, then press Enter to force a
restart of Vertica on your affected Data Node. Vertica deletes any corrupted data,
and recovers that data from adjacent Data Nodes.
9. If the system prompts you with Do you want to continue waiting?
(yes/no) [yes], enter yes and press Enter to continue waiting.
Because Vertica restores the affected Data Node's information from adjacent Data
Nodes, if these Data Nodes ingested a large amount of flow traffic while the
affected Data Node was down, it may take a period of time for the affected Data
Node to recover.

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.

Data Store Does Not Start After Power Failure


Review the database status on the Data Store tab in Central Management. You can start
the database or Data Node from there. Refer to Viewing the Data Store Database
Status for details.

© 2023 Cisco Systems, Inc. and/or its affiliates. All rights reserved. - 174 -
Installing Patches and Updating Software

Installing Patches and Updating Software


Make sure you keep Secure Network Analytics up-to-date by installing the latest patches
for your software version. For details and instructions, visit Cisco Software Central.
Software updates are also posted to your Cisco Smart Account at Cisco Software Central.
For a successful update, make sure you follow the instructions in the Secure Network
Analytics Update Guide.

© 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)

© 2023 Cisco Systems, Inc. and/or its affiliates.

All rights reserved.

You might also like