Table of Contents

CiscoEvolvedProgrammableNetworkManager_2_0_2_InstallationGuide.fm

Cisco Evolved Programmable Network Manager 2.0.2 Installation Guide

September 16, 2016

October 20, 2016

Install GeoMap Resources for Offline Use

Related Documentation

: This Supplemental License Agreement (“SLA”) contains additional limitations on the license to the Software provided to Customer under the End User License Agreement between Customer and Cisco. Capitalized terms used in this SLA and not otherwise defined herein shall have the meanings assigned to them in the End User License Agreement. To the extent that there is a conflict among any of these terms and conditions applicable to the Software, the terms and conditions in this SLA shall take precedence.

By installing, downloading, accessing or otherwise using the Software, Customer agrees to be bound by the terms of this SLA. If Customer does not agree to the terms of this SLA, Customer may not install, download or otherwise use the Software.

ADDITIONAL LICENSE RESTRICTIONS:

- Installation and Use. The Software components are provided to Customer solely to install, update, supplement, or replace existing functionality of the applicable Network Management Software product. Customer may install and use the following Software components:

– Cisco Evolved Programmable Network Manager: May be installed on a server in Customer's network management environment.

For each Software license granted, customers may install and run the Software on a single server to manage the number of network devices and codecs specified in the license file provided with the Software, or as specified in the Software License Claim Certificate. Customers whose requirements exceed the network device and codec limits must purchase upgrade licenses or additional copies of the Software. The network device and codec limits are enforced by license registration.

- Reproduction and Distribution. Customers may not reproduce nor distribute the Software.

DESCRIPTION OF OTHER RIGHTS AND LIMITATIONS.

Refer to the Cisco Systems, Inc. End User License Agreement.

Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at 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. (1110R)

Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.

© 2016 Cisco Systems, Inc. All rights reserved.

Installation Overview

Installation Paths for Cisco EPN Manager 2.0.2

The following table lists the mandatory installation paths for Cisco EPN Manager 2.0.2. The following table uses this terminology:

- PP = Point Patch

- Cisco EPN Manager 2.0.1 = Cisco EPN Manager 2.0 Maintenance Pack 1

- Cisco EPN Manager 2.0.2 = Cisco EPN Manager 2.0 Maintenance Pack 2

If you have this deployment:

You must perform these steps to install Cisco EPN Manager 2.0.2:

Cisco EPN Manager is not installed (fresh installation)

3. Install Cisco EPN Manager 2.0.2—Use this document

3. Install Cisco EPN Manager 2.0.2—Use this document

Cisco EPN Manager 2.0 PP1

2. Install Cisco EPN Manager 2.0.2—Use this document

Cisco EPN Manager 2.0 PP2

Install Cisco EPN Manager 2.0.2—Use this document

Cisco EPN Manager 2.0.1

2. Install Cisco EPN Manager 2.0.2—Use this document

Cisco EPN Manager 2.0.1 PP1

Install Cisco EPN Manager 2.0.2—Use this document

Log In and Out as the Linux CLI Users

The Linux CLI has two shell users: One with administrative access (Linux CLI admin user), and another with root access (Linux CLI root user). The following diagram illustrates the flow for logging in as the various CLI users.

.

Before You Begin

.

Procedure

Step 1 To log in as the Linux CLI root user:

CLI admin user.

CLI admin user, log in as the Linux CLI admin user:

c. Log in as the Linux CLI root user:

command to check the current user.

Step 2 To exit:

a. Log out as the Linux CLI root user.

You are now logged in as the Linux CLI admin user.

b. Log out as the Linux CLI admin user:

CLI admin user.

What To Do Next

.

Install Cisco EPN Manager 2.0.2 in a Standard Environment (No HA)

Workflow for Installing Cisco EPN Manager 2.0.2 in a Standard Environment (No HA)

1. Perform the Cisco EPN Manager 2.0.2 Prerequisite Tasks.

2. Download Cisco EPN Manager 2.0.2 (No HA).

3. Install Cisco EPN Manager 2.0.2 (No HA).

4. Synchronize the Hardware and NTP Clock.

5. Synchronize the Inventory of Optical Devices with the Database (Existing Deployments Only).

Perform the Cisco EPN Manager 2.0.2 Prerequisite Tasks

The following tasks are mandatory for Cisco EPN Manager 2.0.2 installations.

Procedure

Step 1 If you have an existing deployment (this is not a fresh installation), perform these tasks:

.

b. If you have used the menu customization feature to adjust what is displayed in the web GUI, move the following file to ensure a smooth Cisco EPN Manager 2.0.2 installation.

Note You do not need to restart Cisco EPN Manager after performing this procedure.

– Start an SSH session and log into the Cisco EPN Manager server as the Linux CLI root user (as described in Log In and Out as the Linux CLI Users).

– Run the following command (this command is one line):

If you receive a “No file found” response, do not be concerned.

Note If you did have customized menus, you will need to re-customize them after the Cisco EPN Manager 2.0.2 installation.

.

What To Do Next

Go to Download Cisco EPN Manager 2.0.2 (No HA).

Note Although this section is directed at standard deployments, this procedure also applies when preparing the primary and secondary servers for installation in an HA environment. For the next step in HA deployments, go to Remove the HA Configuration.

Download Cisco EPN Manager 2.0.2 (No HA)

This procedure explains how to download the required ubf file.

Procedure

Step 1 Make sure you have performed the tasks described in Perform the Cisco EPN Manager 2.0.2 Prerequisite Tasks.

Step 2 Log into the Cisco EPN Manager web GUI as a user with Administrator privileges.

.

(be sure to check the file description).

- If your server has Internet connectivity:

link at the top of the page and log into Cisco.com. Cisco EPN Manager will check for available software updates.

to start the download from Cisco.com to the Cisco EPN Manager server.

- If your server does not have Internet connectivity or you have obtained the ubf file from another source:

– Copy the Cisco EPN Manager 2.0.2 installation file to your client machine.

.

After the successful download or upload of Cisco EPN Manager 2.0.2, the software will appear under the Files tab.

What To Do Next

Go to Install Cisco EPN Manager 2.0.2 (No HA).

Note Although this section is directed at standard deployments, this procedure also applies when downloading the software to the primary server in an HA environment. For the next step in HA deployments, go to Step 3 in Download Cisco EPN Manager 2.0.2 (HA Deployment).

Install Cisco EPN Manager 2.0.2 (No HA)

Procedure

Step 1 Verify that Cisco EPN Manager 2.0 Point Patch 2 is installed on the server.

.

.

is listed.

. It is a requirement for Cisco EPN Manager 2.0.2.

.

button associated with EPN Manager Maintenance Pack 2.0.2 on the Software Update page.

.

Cisco EPN Manager will auto-restart and the Cisco EPN Manager web GUI will not be accessible for some time.

Step 5 Check the status of the Cisco EPN Manager services.

a. Start an SSH session with the Cisco EPN Manager server and log in as the Cisco EPN Manager CLI admin user.

command to ensure that all services are up and running:

Step 6 Once the Cisco EPN Manager web GUI is accessible, log into it and check the version on the Software Update page.

.

is listed as Installed under the Updates tab.

What To Do Next

Go to Synchronize the Hardware and NTP Clock.

Note Although this section is directed at standard deployments, this procedure also applies when installing the software on the primary server in an HA environment. For the next step in HA deployments, go to Step 3 in Install Cisco EPN Manager 2.0.2 on Primary and Secondary Servers (HA Deployment).

Synchronize the Hardware and NTP Clock

command. (Although this section is directed at standard deployments, it is also used to synchronize the clocks on primary and secondary servers in an HA deployment.)

Procedure

Step 1 Log in as the Linux CLI root user as described in Log In and Out as the Linux CLI Users.

Step 2 Check the NTP service status and ensure that NTP has obtained a stable time reference using the following commands. The following includes examples of the output you should see.

a. Ensure that ntpd is running.

b. If ntpd (pid 3290) is not running, start it using the following command:

to ensure it is running.)

c. Ensure that NTP is receiving time from an NTP server.

again. If synchronization does not happen within 10 minutes, contact your system administrator or Cisco support.

Step 3 Synchronize the hardware clock with NTP using the following command:

You should see output similar to the following:

Step 4 Verify that the hardware clock is synchronized with NTP.

Check the output and ensure that the two clocks are synchronized (to at least within a few seconds of each other):

Step 5 (High availability deployments) Do the following:

a. Perform the previous steps on the other server.

b. After performing this procedure on both servers, check the clocks on each servers and ensure they are synchronized with each othe

c. Go to Step 7 in Install Cisco EPN Manager 2.0.2 on Primary and Secondary Servers (HA Deployment) to re-enable high availability.

Step 6 As the Linux CLI admin user, restart the Cisco EPN Manager services.

a. If you are logged in as the Linux CLI root user, switch to the Linux CLI admin user.

b. Switch to the Cisco EPN Manager CLI admin user.

c. Stop and restart the Cisco EPN Manager services.

What To Do Next

If you installed Cisco EPN Manager 2.0.2 on an existing deployment that has optical devices, perform an inventory collection for those devices. See Synchronize the Inventory of Optical Devices with the Database (Existing Deployments Only).

Synchronize the Inventory of Optical Devices with the Database (Existing Deployments Only)

If you are installing Cisco EPN Manager 2.0.2 on top of an existing deployment (in other words, this is not a fresh installation of Cisco EPN Manager) and your deployment includes optical devices, you need to perform a Sync operation on the optical devices. The Sync operation instructs Cisco EPN Manager to collect device physical and logical inventory and save the information to the database.

Procedure

.

.

Install Cisco EPN Manager 2.0.2 in an HA Environment

Workflow for Installing Cisco EPN Manager 2.0.2 in an HA Deployment

1. Perform the Cisco EPN Manager 2.0.2 Prerequisite Tasks.

2. Remove the HA Configuration.

3. Download Cisco EPN Manager 2.0.2 (HA Deployment).

4. Install Cisco EPN Manager 2.0.2 on Primary and Secondary Servers (HA Deployment).

5. Synchronize the Hardware and NTP Clock.

6. Synchronize the Inventory of Optical Devices with the Database (Existing Deployments Only).

Perform the Cisco EPN Manager 2.0.2 Prerequisite Tasks

Perform the steps in Perform the Cisco EPN Manager 2.0.2 Prerequisite Tasks.

Remove the HA Configuration

Procedure

Step 1 Make sure you have performed the tasks described in Perform the Cisco EPN Manager 2.0.2 Prerequisite Tasks.

Step 2 Log into the Cisco EPN Manager web GUI as a user with Administrator privileges.

.

on the left.

.

.

What To Do Next

Download Cisco EPN Manager 2.0.2 as described in Download Cisco EPN Manager 2.0.2 (HA Deployment).

Download Cisco EPN Manager 2.0.2 (HA Deployment)

Before You Begin

- Make sure you have the password (authentication key) that was created when HA was enabled. You will need it to install the patch on the secondary server.

Procedure

Step 1 Make sure you have removed the HA configuration as described in Remove the HA Configuration.

Step 2 On the primary server, upload/download the Cisco EPN Manager 2.0.2 ubf file. Follow the procedure in Download Cisco EPN Manager 2.0.2 (No HA).

Step 3 Upload the Cisco EPN Manager 2.0.2 ubf file to the secondary server:

a. Log into the secondary server’s HM web page by entering the following URL in your browser:

is the IP address or host name of the secondary server.

.

at the top right of the Health Monitor window to open the Secondary Server Software Update window.

.

.

After the successful download or upload of Cisco EPN Manager 2.0.2, the software will appear under the Files tab.

What To Do Next

Install Cisco EPN Manager 2.0.2 as described in Install Cisco EPN Manager 2.0.2 on Primary and Secondary Servers (HA Deployment).

Install Cisco EPN Manager 2.0.2 on Primary and Secondary Servers (HA Deployment)

Before You Begin

- Make sure you have the password (authentication key) that was created when HA was enabled. You will need to install the maintenance pack on the secondary server.

- Make sure no backups are in progress.

Procedure

Step 1 Verify that Cisco EPN Manager 2.0 Point Patch 2 is installed on the primary server.

.

.

is listed.

. It is a requirement for Cisco EPN Manager 2.0.2.

Step 2 Install Cisco EPN Manager 2.0.2 on the primary server as described in Install Cisco EPN Manager 2.0.2 (No HA). That section includes the steps for verifying the installation. After the installation, the primary server automatically restarts and the web GUI will not be accessible for some time.

Step 3 Verify that Cisco EPN Manager 2.0 Point Patch 2 is installed on the secondary server.

.

.

is listed.

. It is a requirement for Cisco EPN Manager 2.0.2.

Step 4 Install Cisco EPN Manager 2.0.2 on the secondary server.

a. Log into the secondary server’s HM web page by entering the following URL in your browser:

is the IP address or host name of the secondary server.

.

at the top right of the Health Monitor window to open the Secondary Server Software Update window.

.

button associated with EPN Manager Maintenance Pack 2.0.2 on the Software Update page.

and the primary server will restart automatically.

Step 5 After the secondary server has restarted, verify the installation on the secondary server.

a. Start an SSH session with the secondary server and log in as the Cisco EPN Manager CLI admin user.

command to ensure that all services are up and running.

is the IP address or host name of the secondary server.

.

at the top right of the Health Monitor window to open the Secondary Server Software Update window.

.

is listed.

Step 6 Synchronize the hardware and NTP clocks on both the primary and secondary servers as described in Synchronize the Hardware and NTP Clock.

Step 7 On the primary server, enable high availability and verify that the primary server’s HA status is Primary Active.

a. Enable high availability.

– Log into the Cisco EPN Manager web GUI as a user with Administrator privileges.

.

on the left, then enter the secondary server’s IP address, the secondary server’s authentication key, and an email address to which Cisco EPN Manager should send HA state change notifications.

, then wait until the servers are synchronized.

.

b. Verify the primary server’s HA status.

on the left.

.

Step 8 Verify that the secondary server’s HA status is Secondary Syncing.

is the IP address or host name of the secondary server.

.

(with a green check mark).

Install GeoMap Resources for Offline Use

Use the Geo Maps feature to position your network devices on a world map and monitor them within their geographical context. There are two ways to import map images:

- Online mode (internet connectivity)—Import maps from the map provider's web site

- Offline mode (no internet connectivity)—Use locally-installed map resources

These topics explain how to download and install Geo Maps for offline use.

Note Geo Map compressed files are very large. We recommend you save the files to a remote repository.

Workflow for Installing Geo Map Resources for Offline Use

1. Download and Copy the Geo Maps Resources to the Cisco EPN Manager Server.

2. Install the Geo Maps Resources on the Cisco EPN Manager Server.

3. Configure the Cisco EPN Manager Server to Use the Installed Map Resources.

Download and Copy the Geo Maps Resources to the Cisco EPN Manager Server

Before You Begin

- If you plan to use a remote repository (because Geo Map files are very large), make sure a remote repository has been configured. For more information, refer to the topics on using remote FTP backup repositories in the Cisco Evolved Programmable Network Manager User and Administrator Guide .

- Make sure SCP is enabled on your client machine and the required ports are open (refer to the Cisco EPN Manager 2.0 Installation Guide ).

This procedure shows you how to download and copy the GeoMaps resources to the default local repository on the Cisco EPN Manager server.

Procedure

Step 1 Download the Geo Maps compressed files to a client machine.

.

.

.

d. Follow the instructions to save the file to the client machine.

Step 2 Copy the Geo Maps compressed files from the local machine to the Cisco EPN Manager server’s default local repository (/localdisk/defaultRepo).

a. Start an SSH session with the secondary server and log in as the Cisco EPN Manager CLI admin user.

b. Log in as the Linux CLI admin user (as described in Log In and Out as the Linux CLI Users).

command uses the following syntax:

Where:

is your username on the client machine

is the IP address of the client machine to which you downloaded the files in Step 1

is the full pathname of the Geo Maps compressed file on the client machine

For example:

What To Do Next

Install the Geo Maps as described in Install the Geo Maps Resources on the Cisco EPN Manager Server.

Install the Geo Maps Resources on the Cisco EPN Manager Server

Before You Begin

The installation process will extract the Geo Maps files and install them in /opt/CSCOlumos/resources/offline_geo. To avoid storage constraints, consider mounting additional storage on the directory (by editing /etc/fstab). If you have high availability and need to mount additional storage, be sure to edit the /etc/fstab file on both the primary and secondary servers.

Procedure

CLI admin user.

Step 2 Install the GeoMaps resource file that is located in /localdisk/defaultRepo.

is the GeoMaps resource file located in /localdisk/defaultRepo (this is the file you copied in Download and Copy the Geo Maps Resources to the Cisco EPN Manager Server). For example:

The installation takes a few minutes to complete depending on the size of the map resources.

Step 3 Verify that the maps were installed successfully by confirming that a directory named geoMaps was created under /opt/CSCOlumos/resources/offline_geo:

Step 5 Instruct your users to clear their browser caches.

Step 6 (High availability deployments) Repeat this procedure on the other server.

What To Do Next

Configure Cisco EPN Manager to use the new Geo Maps as described in Configure the Cisco EPN Manager Server to Use the Installed Map Resources.

Configure the Cisco EPN Manager Server to Use the Installed Map Resources

Procedure

.

.

from the Map Provider drop-down list.

You do not have to restart the Cisco EPN Manager server.

Related Documentation

for information about and links to all of the documentation that is provided with Cisco EPN Manager 2.0 and its maintenance packs.

Note We sometimes update the documentation after original publication. Therefore, you should also review the documentation on Cisco.com for any updates.

Obtaining Documentation and Submitting a Service Request

, which also lists all new and revised Cisco technical documentation, at:

, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSS feeds are a free service.

This document is to be used in conjunction with the documents listed in the “Related Documentation” section.

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. (1110R)

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 other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2016 Cisco Systems, Inc. All rights reserved.