Cisco Prime Infrastructure 3.8 Quick Start Guide
Cisco Prime Infrastructure 3.8 Quick Start Guide
Overview
This section provides basic information about the product and this Guide.
Related Topics
About This Guide, on page 1
Product Overview, on page 1
About Cisco Prime Infrastructure Licensing, on page 1
Product Overview
Prime Infrastructure provides a single integrated solution for comprehensive lifecycle management of the
wired or wireless access, campus, and branch networks, and rich visibility into end-user connectivity and
application performance assurance issues. Prime Infrastructure accelerates the rollout of new services, secure
access and management of mobile devices, making “Bring Your Own Device” (BYOD) a reality for corporate
IT. Tightly coupling client awareness with application performance visibility and network control, Prime
Infrastructure helps ensure uncompromised end-user quality of experience. Deep integration with the Cisco
Identity Services Engine (ISE) further extends this visibility across security and policy-related problems,
presenting a complete view of client access issues with a clear path to solving them.
For:
• An overview of Prime Infrastructure features and benefits, see the latest Cisco Prime Infrastructure Data
Sheets.
• Information about frequently used Prime Infrastructure features, see the latest Cisco Prime Infrastructure
User Guide.
• Information about features intended for administrators, see the latest Cisco Prime Infrastructure
Aministrator Guide.
• Cisco Prime Infrastructure license types and how to order them, see the Cisco Prime Infrastructure
Ordering and Licensing Guide.
• How to apply purchased licenses, see the Cisco Prime Infrastructure Administrator Guide.
Note If your existing Prime Infrastructure is 3.6.x or 3.7.x, and your upgrade path contains 3.4.x or earlier versions,
then you cannot in-line upgrade that server to Prime Infrastructure 3.8 due to security vulnerabilities in the
underlying Red Hat 6 installation. You will need to take a backup of the Prime Infrastructure 3.6.x or 3.7.x
server, deploy a fresh Prime Infrastructure 3.8 server, and restore that backup into the Prime Infrastructure
3.8 server.
VMware Version ESXi 6.0, 6.5, 6.7, ESXi 6.0, 6.5, 6.7, ESXi 6.0, 6.5, 6.7, ESXi 6.0, 6.5, 6.7,
or 7.0 or 7.0 or 7.0 or 7.0
Virtual CPUs1 4 8 16 16
Memory (DRAM) 12 GB 16 GB 16 GB 24 GB
Throughput (Disk IOPS) 200 MB/s 200 MB/s 200 MB/s 320 MB/s
Minimum CPU Speed 2.29 GHz 2.29 GHz 2.29 GHz 2.29 GHz
1
You can configure any combination of sockets and cores, the product of which must equal the number
of virtual CPUs required. For example, if 16 virtual CPUs are required, you can configure 4 sockets
with 4 cores, or 2 sockets with 8 cores, etc.
You can install any of the Prime Infrastructure options as an Open Virtual Appliance (OVA), running under
VMWare ESXi, on your own hardware. If you choose this implementation, the server that you supply must
meet or exceed the requirements shown in the table for the option that you select.
RAID Level 10 10 1, 1, 10 1, 1, 10
RAID (446(bootable), (446(bootable),
1787, 3574 in 1787, 5361 in GB)
GB)
Disk I/O Speed 320 MBps 320 MBps 320 MBps 320 MBps
Concurrent 5 5 5 5
API clients
Note Prime Infrastructure uses the 10G port as eth0 for Cisco DNA Center Appliance. You must perform the
following steps to use the 1G port.
1. Navigate to Compute > BIOS.
2. Select the Conifgure BIOS tab and then the Advanced tab.
3. Expand the LOM and PCle Slots configuration link.
4. Select the Disabled option from PCle Slot:MLOM OptionROM and PCle Slot:MLOM Link Speed
drop-down lists.
5. Perform reboot operation.
6. Install Prime Infrastrucure.
Prime Infrastructure is also available pre-installed on Cisco-supplied hardware as a physical appliance. See
the latest Cisco Prime Infrastructure Appliance Hardware Installation Guide for more information.
For maximum management capacities for each installation option, see How to Scale Prime Infrastructure, on
page 5
Procedure
Step 1 Launch the CIMC web interface (see the section How to Set Up the Appliance in the latest Cisco Prime
Infrastructure Appliance Hardware Installation Guide ).
Step 2 Click the Storage tab, click on the Modular RAID Controller name, click the Virtual Drive tab. .
Step 3 Select the Virtual Drive, then click Edit Virtual Drive.
Step 4 Click OK on the dialog box that appears.
Step 5 In the Write Policy field, select Write Back Good BBU, then click Save Changes.
If you are running ESX on custom hardware that has a RAID controller, we recommend you configure the
following RAID settings to optimize Prime Infrastructure performance and redundancy:
• RAID 10
• RAID cache of at least 2 GB
• Display resolution—Prime Infrastructure supports 1366 x 768 or higher, but we recommend that you set
the screen resolution to 1600 x 900.
Note Due to strict certificate check in Firefox browser, when you have two different Prime Infrastructure server
with same hostname you will get the below error code:
• Failed : Error code: SEC_ERROR_REUSED_ISSUER_AND_SERIAL
To avoid this you can import CA Signed certificate in PI server through admin CLI. See Import CA-Signed
Host Certificates from Ciso Prime Infrastructure 3.8 Admin Guide steps to generate CSR and import CA
signed certificate.
Table 2: Supported Scale for Prime Infrastructure Installation Options (includes Assurance)
Cisco Mobility 1 1 6 10 12 12 12
Services Engine (MSE)
Events Sustained Rate 100 100 300 500 1000 1000 1000
(events per second;
includes syslogs, traps,
and system events)
NetFlow Rate (flows 3000 3000 16,000 40,000 80,000 80,000 80,000
per second)4
Supported Hourly Host 144,000 720,000 2,100,000 6,000,000 12,000,000 12,000,000 12,000,000
Records
Concurrent GUI 5 10 25 50 50 50 50
Clients
Concurrent API (or 2 2 5 5 5 5 5
northbound interface)
Clients
2
Compliance is supported on the Standard, Professional virtual appliance (OVA) and the Gen 2 appliance,
Gen 3 appliance and DNAC Appliance only. It is not supported on: Express, Express Plus, OVAs that
have been resized to Standard or Professional. If you are running Prime Infrastructure on an unsupported
OVA or physical appliance and want to enable Compliance, you must perform a fresh install of the 3.8
Standard or Professional OVA or Gen2 appliance or Gen 3 Appliance or DNAC Appliance, then use
backup/restore to migrate data from your old server to the new server. See Enabling Compliance Services
in the Cisco Prime Infrastructure 3.8 Administrator Guide .
3
Changing Clients are wireless users who are roaming across APs or disassociating and associating to
APs.
4
The NetFlow rate depends on the number of unique clients in the flows. The supported NetFlow rate is
also based on the translated number of hourly host records (or unique combinations of server/client and
applications) per day.
5
If the Compliance violation for the Professional virtual appliance exceeds 80000, the compliance job
will not show any data.
Note When there is a high inflow of data for hosts, it triggers hosts_lt and hosts_mt tables to exceed the default
max record count and retention age. Prime Infrastructure performance might get affected, and the services
might go down while creating the backup file because of disk space issues. To address this issue, you must
reduce the maximum records and age of the retention by 65% of the actual default settings of highly utilized
tables, maximum records, and age.
Note Please ensure to select the Unified APs/Wireless client range within the specified limits mentioned in the
table. If the AP count/Client count exceeds the given limit, Prime Infrastructure will throw an error "PGA
memory used by the instance exceeds PGA_AGGREGATE_LIMIT".
Important We recommend that you maintain an acceptable level of latency between your devices and the Cisco Prime
Infrastructure server. A high latency might result in the server being unable to manage your devices, or the
background tasks running slowly. A typical example of such a scenario is when you have thousands of APs
and multiple Cisco Wireless Controllers managed by Prime Infrastructure across a WAN. In such a situation,
we recommend that you install Prime Infrastructure in a local setup to ensure that the device response time
is not impacted by queries from Prime Infrastructure.
To help you roll out new versions of Prime Infrastructure at your own pace, Operations Center always supports
management of instances of both the current and the very last version of Prime Infrastructure (also known as
“N-1 management”). For example: If you upgrade your Operations Center management server to 3.7, you
can use that server to continue managing Prime Infrastructure 3.6.x instances, as well as upgraded 3.7 Prime
Infrastructure instances.
Note Make sure that you do the following when you are upgrading the Operation Center:
• Remove the managed instances before upgrading the Operation Center.
• Upgrade the Operation Center.
• Re-add the managed instances.
See Physical Appliance Options, on page 3 for physical appliance options and the table under the section
How to Scale Prime Infrastructure, on page 5 for installation option scaling information. For more information,
see Set Up Operations Center in the latest Cisco Prime Infrastructure Administrator Guide.
Data Center Cisco Nexus devices 2500 3000 3000 3000 3000
Switches
VMware vCenters 7 14 14 14 14
VMware Clusters 8 15 15 15 15
Installation Options
Prime Infrastructure provides the following installation options:
• New installation on a virtual machine—See Before You Begin Installation on a Virtual Machine, on
page 10.
• New installation on a physical appliance. Prime Infrastructure comes preinstalled on physical appliances,
or you can install an image on an existing appliance. See Set Up Prime Infrastructure on a Virtual Machine
or Physical Appliance, on page 12.
• Upgrade a previous version of Prime Infrastructure—See How to Upgrade From Previous Releases of
Prime Infrastructure, on page 13.
Note If you are using Esxi 6.5 or later, you can deploy latest ova using Web Client.
Procedure
Step 1 Launch your VMware vSphere Client and connect to the ESXi host or vCenter server.
Step 2 Choose File > Deploy OVF Template.
Step 3 Click Browse to access the location where you have saved the OVA file on your local machine, then click
Next.
Step 4 Verify the details on the OVF template details page, then click Next.
Note We will reserve half of the CPU resources and memory based on your OVA selection.
Step 5 In the End User License Agreement window, click Accept, then click Next.
Step 6 In the Name and Location window, specify:
• In the Name field, enter the name of the new virtual machine.
• In the Inventory Location area, select the appropriate folder. (If the vSphere Client is connected directly
to an ESXi host, this option does not appear.)
Depending on your network speed and the IOPS of the server, the deployment can take a few minutes to
complete.
Procedure
Step 1 If you are using a virtual machine and it is not already powered on, in the VMware vSphere Client, right-click
the deployed virtual appliance and choose Power > Power On.
Step 2 Click the Console tab.
After the server boots up, you’ll see the localhost login prompt.
Tip Keep your Prime Infrastructure password in a safe place. If you forget the password, see the section
How to Recover Administrator Passwords on Virtual Appliances in the latest Cisco Prime
Infrastructure Administrator Guide.
Step 5 When you are done entering these values, you will be prompted for the following parameters:
• High Availability Role Selection—Enter yes at the prompt if you want this installed server to serve as
the secondary server in a high availability implementation. You will be prompted to provide an
authentication key to be used for high availability registration. If you enter no at the prompt, the server
will act as the primary server (standalone) and the installation will proceed with the following prompts:
• Advance Security option— You will be prompted for accessing root shell. Enter Yes at the prompt to
enable root shell access. Enter No to disable root shell access.
• Web Interface Root Password—Enter and confirm the password used for the default root administrator.
This is the account used to log in to the Prime Infrastructure web user interface for the first time and set
up other user accounts.
Step 6 Select Yes to proceed with the installation, or select No to re-enter high availability options.
Step 7 When you are done entering these values, the installer application tests the network configuration parameters
you have entered. If the tests are successful, it begins installing Prime Infrastructure.
Step 8 When the installation is complete, the appliance reboots and you are presented with a login prompt.
Step 9 Log in to the virtual machine using the “admin” username and password that you specified in Step 4.
Step 10 Run the ncs status command (see the section Check Prime Infrastructure Server Status in the latest Cisco
Prime Infrastructure User Guide) to verify that the processes have restarted. You should see the following
process statuses:
• All Processes are up and running.
If your existing Prime Infrastructure is 3.6.x or 3.7.x, and your upgrade path contains 3.4.x or earlier versions,
then you cannot in-line upgrade that server to Prime Infrastructure 3.8 due to security vulnerabilities in the
underlying Red Hat 6 installation. You will need to take a backup of the Prime Infrastructure 3.6.x or 3.7.x
server, deploy a fresh Prime Infrastructure 3.8 server, and restore that backup into the Prime Infrastructure
3.8 server.
Note Setting the hostname using hostnamectl changes the uppercase letters to lowercase. Although Redhat 7 and
CentOS 7 provide hostnamectl to set the hostname permanently, the real hostname will only be lowercase
even if the users specify any uppercase letters.
If you are running multiple versions of Prime Infrastructure from which you want to migrate data, see Migrate
Data From Previous Releases of Prime Infrastructure, on page 17.
Remember that backups can only be restored to a new Prime Infrastructure server that is the same size or
bigger than your previous server. SeeHow to Scale Prime Infrastructure, on page 5.
Before you upgrade from Operations Center 3.6.X or 3.7.x to 3.8, make sure you upgrade any Prime
Infrastructure instances that are managed in Operations Center from Prime Infrastructure 3.6.X or 3.7.x to
Prime Infrastructure 3.8
To back up your data from a previous supported version of Prime Infrastructure, follow these steps:
Procedure
Step 1 If you have not already done so: Set up a remote backup repository for the Prime Infrastructure version you
are currently running. For details, see the section Using Remote Backup Repositories in the latest Cisco Prime
Infrastructure Administrator Guide.
Step 2 Take an application backup of the Prime Infrastructure version you are currently running, and store the backup
in the remote repository. For details, see the section Perform an Immediate Application Backup Using the
CLI in the latest Cisco Prime Infrastructure Administrator Guide.
Step 3 Verify the integrity of the backup as explained in .Before You Migrate Your Data, on page 16
What to do next
You can upgrade Prime Infrastructure using either of the following methods:
• Perform an inline upgrade of existing 3.6.x and 3.7.x system—See How to Perform an Inline Upgrade,
on page 14.
• Restore data from backup on running system—See Before You Migrate Your Data, on page 16.
Procedure
Step 1 Set up a remote backup repository for the Prime Infrastructure version you are currently running. For details,
see the section Use a Remote Backup Repository in the latest Cisco Prime Infrastructure Administrator Guide.
Step 2 Take an application backup of the Prime Infrastructure version you are currently running, and store the backup
in the remote repository. For details, see the section Perform an Immediate Application Backup Using the
CLI in the latest Cisco Prime Infrastructure Administrator Guide.
Step 3 Verify the integrity of the backup as explained in Before You Migrate Your Data.
Step 4 Remove any existing High Availability configuration from your primary Prime Infrastructure server. You
can do this using either of the following options:
• Launch Prime Infrastructure, choose Administration > Settings > High Availability > HA
Configuration, and click Remove. Ensure the configuration mode changes to “HA Not Configured.”
• Ensure the primary server is the active Prime Infrastructure server, go to the admin console on the primary
server and run the ncs ha remove command.
Step 5 Move backup files (all files with the tar.gz extension) from the /localdisk directory to another server and
ensure that /localdisk has 80% free space. For details, see the sections copy and delete commands and show
disks command in the latest Command Reference Guide for Cisco Prime Infrastructure.
Please ensure that /tmp folder has 80% free space for the upgrade to complete successfully.
Step 6 Download the upgrade bundle PI-Upgrade-36x_37x_to_3.8.0.0.310.tar.gz from Cisco.com and verify the
integrity using its checksum listed on Cisco.com.
Step 7 Copy the verified upgrade file to the default repository:
Example:
Where:
• source is the upgrade file’s URL, path and filename (for example:
FTP://<YourFTPServer>/(PI-Upgrade-36x_37x_to_3.8.0.0.310.tar.gz)
• diskis the disk and path to the local defaultRepo.
Step 8 Ensure the current version of Prime Infrastructure is 3.6.x, and 3.7.x.
Step 9 Ensure the local repository (defaultRepo) contains no backup files.
Step 10 Stop the Prime Infrastructure server by entering the command ncs stop
Step 11 It is recommended to run the application upgrade from the console. For a virtual appliance, you can run the
application upgrade from the VM console. For a physical appliance, you can run the application upgrade from
the KVM, VGA, or serial console. (If you are using the serial console, make sure baud rate is configured to
9600
Example:
This step can take several hours to complete, depending on the size of the application database.
Note When you upgrade from Prime Infrastructure version 3.6.x & 3.7.x to 3.8 that uses two NICs,
network outage occurs post the upgrade. This can be avoided by performing the following steps:
You must not add 2 NICs before the first power up of deployment. Also, adding 2 NICs at the same
time is not recommended.
• Login to VMware vSphere.
• Choose the Virtual Machine where the Dual NIC has to be configured.
• Power off the Virtual Machine.
• Choose edit settings and then add the second NIC.
• Turn on the Virtual Machine.
Note When customer runs Virtual Machine with two network interfaces, after installation of the
patch/upgrade, the Prime instance will reboot automatically.
We recommend you to check the network weather the MAC address and network interface match
with each other and manually change if there is a mismatch.
If you are running multiple previous releases of Prime Infrastructure (for example, you are running version
3.6.x or 3.7.x), you must select one version from which to restore data. You cannot restore data from more
than one Prime Infrastructure version. To combine data from multiple Prime Infrastructure versions:
1. Perform the restore operation for one Prime Infrastructure system running a previous Prime Infrastructure
version.
2. Export your device inventory and maps from other Prime Infrastructure systems and import the information
into the Prime Infrastructure 3.6 system.
See Before You Migrate Your Data before you start the following steps to restore your data from Prime
Infrastructure 3.6.x, and 3.7.x to your newly installed Prime Infrastructure 3.8 server:
Procedure
Step 1 Configure the new Prime Infrastructure host to use the same remote backup repository as the old host. For
details, see Use a Remote Backup Repository in the Cisco Prime Infrastructure Administrator Guide.
Step 2 Restore the application backup on the remote repository to the new host, as explained in Restore an Application
Backup in the Cisco Prime Infrastructure Administrator Guide.
Step 3 When the process is complete:
• Instruct users to clear the browser cache on all client machines that accessed an older version of Prime
Infrastructure before they try to connect to the upgraded/restored Prime Infrastructure server.
• If you are using Prime Infrastructure to manage Cisco Wireless LAN Controllers, see Resynchronize
WLC Configurations after Migration, on page 18.
• Synchronize your devices as explained in Synchronize Devices in the Cisco Prime Infrastructure User
Guide.
Step 4 After the new Prime Infrastructure 3.8 server is operational, decommission your previous server.
When you move your data to Prime Infrastructure 3.8, the following Assurance data is not migrated:
• Raw NetFlow information
• Custom NetFlow reports
• Packet capture files
• Processed non-aggregated data, such as PFR data and URLs
5-minute, 1-hour, and 1-day aggregated data is migrated from Prime Infrastructure 3.6.x, and 3.7.x to 3.8.
Procedure
Post-Installation Tasks
Follow the instructions in this section once you have finished installing Prime Infrastructure.
Log in to the Prime Infrastructure User Interface, on page 18
Get Started Using Prime Infrastructure, on page 19
Procedure
Step 1 Launch one of the Supported Browsers (see Understand System Requirements, on page 2) on a different
computer from the one on which you installed and started Prime Infrastructure.
Step 2 In the browser’s address line, enter https://ipaddress, where ipaddress is the IP address of the server on which
you installed Prime Infrastructure. The Prime Infrastructure user interface displays the Login window.
When you access Prime Infrastructure for the first time, some browsers will display a warning that the site is
untrusted. When this happens, follow the prompts to add a security exception and download the self-signed
certificate from the Prime Infrastructure server. After you complete this procedure, the browser will accept
the Prime Infrastructure server as a trusted site in all future login attempts.
Step 3 Enter the root administrator username and password, as specified in Set Up Prime Infrastructure on a Virtual
Machine or Physical Appliance, on page 12
Step 4 Click Login to log in to Prime Infrastructure. The user interface is now active and available for use. The home
page appears.
If any licensing problems occur, a message appears in an alert box. If you have an evaluation license, the
number of days until the license expires is shown. You are also alerted to any expired licenses. You have the
option to go directly to the Administration > Licenses page to address these problems.
Step 5 To ensure system security, choose Administration > Users, Roles & AAA > Change Password to change
the password for the root administrator.
To exit the user interface, close the browser page or click Logout in the top-right corner of the page. Exiting
a Prime Infrastructure user interface session does not shut down Prime Infrastructure on the server.
If a system administrator stops the Prime Infrastructure server during your Prime Infrastructure user interface
session, your session ends, and the browser displays this message: “The page cannot be displayed.” Your
session does not re-associate to Prime Infrastructure when the server restarts. You must start a new Prime
Infrastructure session.
For information about installing the Cisco Plug and Play Application, see the Cisco Plug and Play Application
Solutions Guide.
Users should complete the tasks listed in the chapter Get Started with Prime Infrastructure chapter in the
latest Cisco Prime Infrastructure User Guide . After you complete these tasks, you are ready to start monitoring
and configuring your network.
Reference Information
The following sections provide reference information about Prime Infrastructure and its support options.
• Ports Used by Prime Infrastructure and Assurance, on page 20
20, 21 TCP Bidirectional server/devices FTP transfer of files to and from devices
443 TCP Server to cisco.com To check for software updates between the
Prime Infrastructure server and cisco.com.
443 TCP Prime Infrastructure to Cisco Device, Groups, Maps, CMX migration to DNA
DNA Center server Center.
830 TCP Prime Infrastructure to Device To open the NETCONF port for communication
8080 TCP Devices (Cisco Wireless SSL (HTTPS) port for receiving Wireless Client
Controllers version 8.6 or Health Metrics from WLC devices
higher) to Server
8085 TCP Client to server Used by the Health Monitor process to check
network bandwidth speed between Primary and
Secondary servers, when the user executes
readiness test under High Availability
10022 to TCP Devices to server Range of ports used for passive FTP file
10041 transfers (controller backups, device
configurations, report retrieval, and so on)
110116 TCP Endpoints to server Plain text dispatcher port for the Plug and Play
Gateway
20830 TCP Devices to Coral Coral accepts TDL based telemetry including
AP and client data from devices. (Specific to
17.12 Cisco Catalyst 9800 Wireless
Controllers.)
616177 TCP Server to endpoints SSL port for Java Message Service connections
6
Used when the Plug and Play Gateway is integrated with the Prime Infrastructure server.
7
Used by the Prime Infrastructure Plug And Play Gateway only.
Procedure
Step 1 In the VMware vSphere client, right-click the Prime Infrastructure virtual appliance.
Step 2 Power off the virtual appliance.
Step 3 Click Delete from Disk to remove the Prime Infrastructure virtual appliance.
Adding licenses Administration > Licenses and Licenses and Software Updates in the
Software Updates > Licenses Administrator Guide
Managing Users Administration > Users > Users, User Permissions and Device Access
Roles & AAA in the Administrator Guide
Discovering your network Inventory > Device Management > Add and Organize Devices in the User
Discovery Guide
Setting up virtual domains Administration > Users > Virtual User Permissions and Device Access
Domains in the Administrator Guide
Using monitoring Dashboard > Overview > General Get Started With Cisco Prime
dashboards Infrastructure in the User Guide
Using templates for Configuration > Templates > Create Templates to Automate Device
configuring and monitoring Features & Technologies or Monitor Configuration Changes in the User
> Monitoring Tools > Monitoring Guide
Policies
Viewing alarms Monitor > Monitoring Tools > Monitor Alarms and Events in the User
Alarms and Events Guide
Maintaining device Inventory > Device Management > Manage Device Configuration Files in
configurations Configuration Archive the User Guide
Reconfiguring devices that Configuration > Plug and Play > Use Plug and Play to Deploy New
will be added to your Dashboard Devices in the User Guide
network in the future
Related Documentation
The Cisco Prime Infrastructure Documentation Overview lists all documentation available for Prime
Infrastructure:
Note We sometimes update the documentation after original publication. Therefore, you should also review the
documentation on Cisco.com for any updates.
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: 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)
Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual
addresses and phone numbers. Any examples, command display output, network topology diagrams, and