Install Geo Map Resource Files for Offline Use

The network can be visualized on a topology map or on a geographical map (geo map). The geo map enables you to position your network devices on a world map and monitor them within their geographical context.

To display the geo map in the GUI, the system is configured by default to retrieve map tiles from a specific Mapbox URL. This is done either through a direct Internet connection from the client or through the EPN Manager server, which acts as a proxy. If you do not have an Internet connection, you must install the map resources locally and specify that you want the system to use the local map resources, that is, offline use.

The following topics explain how to download and install geo maps for offline use in both HA and non-HA environments.


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

Install Geo Map Resource Files (Standard and High Availability Deployment)

Installing geo map resource files for offline use in a standard or in a high availability environment involves these processes:


Note
If a failure occurs on the primary server that requires you to reinstall Cisco EPN Manager on the primary server, you must reinstall the geo map resources on the primary server and restart the server.

Place the Geo Map Resource Files on the Cisco EPN Manager Server

Before You Begin

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

Procedure

Step 1

Download the geo map compressed files to a client machine.

  1. Navigate to the Software Download site on Cisco.com .

  2. Get the files by choosing All Releases > 8.0.

  3. Identify the map that you want to download and click Download.

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

Step 2

Copy the geo map compressed files from the local machine to the Cisco EPN Manager server’s default local repository (/localdisk/defaultRepo).

In this example, the Russia geo map file was downloaded to a /temp directory on the client machine. The user has logged into the Cisco EPN Manager server as the Linux CLI admin user and is retrieving the file from the client machine and copying it to /localdisk/defaultRepo on the server: 

scp joesmith@123.456.789.101:/temp/Russia_GeoMap_CEPNM_7_1_0-bundle.tar.gz/localdisk/defaultRepo

Install the Geo Map Resource Files on the Cisco EPN Manager Server

Before You Begin

The installation process extracts the geo map files and installs them in /opt/CSCOlumos/resources/offline_geo. To avoid storage constraints, consider mounting additional storage on the directory by editing the /etc/fstab file after logging in as a Linux CLI admin user. 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

Step 1

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

Step 2

Install the geo map resource file that is located in /localdisk/defaultRepo.

Example:


application install filename defaultRepo

Where filename is the geo map resource file located in /localdisk/defaultRepo (this is the file you copied in ).

Example:


application install Russia_GeoMap_CEPNM_7_1_0-bundle.tar.gz defaultRepo
Save the current ADE-OS running configuration? (yes/no) [yes] ? yes
Please ensure you have a backup of the system before proceeding.Proceed with the application install ? (yes/no) [yes] ? yes

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

Note

 

If you have a high availability setup, you must perform these steps on both primary and secondary servers.

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

Procedure

Step 1

Choose Administration > Settings > System Settings, and then choose Maps > Network Topology.

Step 2

Check Enable Geo Maps.

Step 3

Choose Installed Map Resources from the Map Provider drop-down list.

Step 4

Click Save.

You do not have to restart the Cisco EPN Manager server to apply your changes. A notification message informs you that the system is now working with the installed map resources.

Verify that the Geo Maps Files Were Installed Successfully

After installing the geo map files and configuring the system to use these geo map files, check that they have been successfully installed and that they are being displayed in the GUI.

Procedure

Step 1

Log in to the Cisco EPN Manager web GUI as a user with Administrator privileges.

Step 2

From the left sidebar menu, choose Maps > Topology Maps > Network Topology.

Step 3

Click the Geographical Map icon at the top right of the topology window to display the geo map.

Step 4

Verify that the desired map is displayed.

Update Geo Map Resource Files After Upgrading to Cisco EPN Manager

Geo map files must be reinstalled after upgrade.

Procedure

Step 1

Download the required Cisco EPN Manager geo map files and reinstall them.

Step 2

Stop and restart the server(s).

Step 3

Clear the cache.

Step 4

Verify that the geo map files have been installed. See .