The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The following topics provide information and procedures for installing maintenance packs on top of Cisco EPN Manager 2.1 in standard and high availability deployments.
Note Before starting the installation procedure, please review the release notes for important information or issues relating to the installation.
The following sections list the installation paths for each available Cisco EPN Manager 2.1 maintenance pack (MP), based on the version of Cisco EPN Manager you currently have installed:
1. Install Cisco EPN Manager 2.1. See Cisco EPN Manager 2.1 Installation. 2. Install Cisco EPN Manager 2.1.3. See Install Cisco EPN Manager 2.1.x in a Standard Environment (No HA) or Install Cisco EPN Manager 2.1.x in a High Availability Environment. |
|
1. Upgrade to Cisco EPN Manager 2.1. See Upgrade to Cisco EPN Manager 2.1. 2. Install Cisco EPN Manager 2.1.3. See Install Cisco EPN Manager 2.1.x in a Standard Environment (No HA) or Install Cisco EPN Manager 2.1.x in a High Availability Environment. |
|
Install Cisco EPN Manager 2.1.3. See Install Cisco EPN Manager 2.1.x in a Standard Environment (No HA) or Install Cisco EPN Manager 2.1.x in a High Availability Environment. |
|
1. Go to the Software Download site on Cisco.com and check that you have the latest point patch for Cisco EPN Manager 2.1 installed. 2. If you do not have the latest point patch installed, install it before installing Cisco EPN Manager 2.1.3. Installation instructions can be found in the readme file supplied with the patch file. 3. Install Cisco EPN Manager 2.1.3. See Install Cisco EPN Manager 2.1.x in a Standard Environment (No HA) or Install Cisco EPN Manager 2.1.x in a High Availability Environment. |
|
Install Cisco EPN Manager 2.1.3. See Install Cisco EPN Manager 2.1.x in a Standard Environment (No HA) or Install Cisco EPN Manager 2.1.x in a High Availability Environment. |
|
1. Go to the Software Download site on Cisco.com and check that you have the latest point patch for Cisco EPN Manager 2.1.1 installed. 2. If you do not have the latest point patch installed, install it before installing Cisco EPN Manager 2.1.3. Installation instructions can be found in the readme file supplied with the patch file. 3. Install Cisco EPN Manager 2.1.3. See Install Cisco EPN Manager 2.1.x in a Standard Environment (No HA) or Install Cisco EPN Manager 2.1.x in a High Availability Environment. |
|
Install Cisco EPN Manager 2.1.3. See Install Cisco EPN Manager 2.1.x in a Standard Environment (No HA) or Install Cisco EPN Manager 2.1.x in a High Availability Environment. |
|
1. Go to the Software Download site on Cisco.com and check that you have the latest point patch for Cisco EPN Manager 2.1.2 installed. 2. If you do not have the latest point patch installed, install it before installing Cisco EPN Manager 2.1.3. Installation instructions can be found in the readme file supplied with the patch file. 3. Install Cisco EPN Manager 2.1.3. See Install Cisco EPN Manager 2.1.x in a Standard Environment (No HA) or Install Cisco EPN Manager 2.1.x in a High Availability Environment. |
Before installing Cisco EPN Manager 2.1.x, you must perform the following tasks:
If the client is inactive for a certain period of time, you might be automatically logged out. To avoid being logged out during the installation, we recommend that you disable automatic logout of idle users in the system settings, as follows:
Step 1 Go to Administration > Settings > System Settings > General > Server.
Step 2 In the Global Idle Timeout section, uncheck the Logout all idle users check box.
Step 3 Click OK in the displayed message reminding you to save your change to the system settings.
Step 5 Click the gear icon at the top right of the web GUI window, then click My Preferences. Under User Idle Timeout, uncheck the Logout idle user check box.
Step 7 Log out and then log back into Cisco EPN Manager.
Go to Place the Cisco EPN Manager 2.1.x Installation File on the Server.
Follow these steps to install a maintenance pack (Cisco EPN Manager 2.1.x) in a standard environment (no high availability).
1. Make sure you have performed the tasks in Prerequisites for Cisco EPN Manager 2.1.x Installation.
2. Place the Cisco EPN Manager 2.1.x Installation File on the Server.
3. Install Cisco EPN Manager 2.1.x (No HA).
4. Synchronize the Hardware and NTP Clock.
5. Perform an inventory collection for all devices to synchronize them with the database. See Synchronize the Inventory of All Devices with the Database (Existing Deployments Only).
If you are using external authentication and authorization, after installation you must export the user task information to your AAA server in order to pick up the latest updates. See the Cisco Evolved Programmable Network Manager User and Administrator Guide for more information.
This procedure explains how to download the ubf installation file to your local machine, then upload it from your local machine to the Cisco EPN Manager server.
Note You need an account on Cisco.com in order to download the installation file.
Step 1 Make sure you have performed the tasks in Prerequisites for Cisco EPN Manager 2.1.x Installation.
Step 2 Download the required ubf file to your local machine.
a. Go to the Software Download site on Cisco.com .
b. Browse to the relevant release under All Releases on the left, and locate the required maintenance pack file (in the format cepnm2.1-mpx-build xxx .ubf) .
c. Download the file to your local machine.
Step 3 Log into the Cisco EPN Manager web GUI as a user with Administrator privileges.
Step 4 Upload the ubf file from your local machine to the Cisco EPN Manager server.
a. From the left sidebar menu, choose Administration > Licenses and Software Update > Software Update .
b. Click the blue Upload link at the top of the page.
c. In the Upload Update dialog box, click Browse and navigate to the file you downloaded previously.
d. Click OK to upload the file to the server.
After the successful upload of Cisco EPN Manager 2.1.x, the software will appear under the Files tab.
Follow this procedure to install Cisco EPN Manager 2.1.x in a standard environment with no high availability.
Step 1 From the left sidebar, choose Administration > Licenses and Software Update > Software Update .
Step 2 Click the Install button associated with EPN Manager 2.1.x on the Software Update page.
Step 3 Click Yes in the confirmation message pop-up window to proceed with the installation.
Note The server will restart when the installation is complete.
Step 4 If you are asked whether to overwrite an existing file, click Yes .
After successful installation, the status will change to Installed . 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.
b. Run the ncs status command to ensure that, at a minimum, the following services are up and running: Health Monitor, Database, Matlab, NMS, SAM Daemon, DA Daemon, Compliance Engine. Note that for optimal Cisco EPN Manager functionality, all services should be up and running.
Step 6 When the Cisco EPN Manager web GUI is accessible, log in and check that the Maintenance Pack’s status is “Installed” in the Software Update page.
a. From the left sidebar, choose Administration > Licenses and Software Update > Software Update .
b. Verify that EPN Manager Maintenance Pack x is listed as Installed under the Updates tab. Also verify that the ubf file (in the format cepnm2.1-mpx-buildxxx.ubf) is listed in the Files tab and that the In Use status is Yes.
If you have already been using a previous version of Cisco EPN Manager (i.e., this is not a fresh installation), you need to perform a Sync operation on the devices. The Sync operation instructs Cisco EPN Manager to collect device physical and logical inventory and save the information to the database.
Step 1 Choose Monitor > Network Devices .
Step 2 Select all devices, then click Sync .
Follow these steps to install Cisco EPN Manager 2.1.x in a HA environment.
1. Perform the General and HA Installation Prerequisite Tasks.
2. Remove the HA Configuration.
3. Place the Cisco EPN Manager 2.1.x Installation File on the Server (HA Deployment).
4. Install Cisco EPN Manager 2.1.x on Primary and Secondary Servers (HA Deployment).
5. Synchronize the Hardware and NTP Clock.
6. Synchronize the Inventory of All Devices with the Database (Existing Deployments Only).
Note If you are using external authentication and authorization, after installation you must export the user task information to your AAA server in order to pick up the latest updates. See the Cisco EPN Manager 2.0.4 Installation Guide for more information.
Before starting the HA installation, do the following:
1. Perform the tasks in Prerequisites for Cisco EPN Manager 2.1.x Installation on both primary and secondary servers.
Increase the timeout on the primary and secondary servers from 30 minutes to 90 minutes, as follows:
Step 1 Log in as the Linux CLI root user as described in Log In and Out as the Linux CLI Users.
Step 2 Save a backup of the web.xml file located under /opt/CSCOlumos/tomcatSWUpdate/webapps/ROOT/WEB-INF/ by running the following command (one line):
Step 3 In the web.xml file (/opt/CSCOlumos/tomcatSWUpdate/webapps/ROOT/WEB-INF/web.xml), search for the following:
<session-timeout>30</session-timeout>
Step 4 Change the session timeout to 90 minutes:
<session-timeout>90</session-timeout>
Step 5 As the Cisco EPN Manager CLI admin user, manually stop and restart the server:
Step 6 Ensure that all services are up and running by running this command:
Step 1 Make sure you have performed the tasks in Prerequisites for Cisco EPN Manager 2.1.x Installation.
Step 2 Log into the Cisco EPN Manager web GUI on the primary server as a user with Administrator privileges.
Step 3 From the left sidebar, choose Administration > Settings > High Availability .
Step 4 Click HA Configuration on the left.
Step 6 When the remove operation completes, confirm that the Configuration Mode field displays HA Not Configured .
Download Cisco EPN Manager 2.1.x as described in Place the Cisco EPN Manager 2.1.x Installation File on the Server (HA Deployment).
Step 1 Make sure you have removed the HA configuration as described in Remove the HA Configuration.
Step 2 On the primary server, upload the Cisco EPN Manager 2.1.x ubf file. Follow the procedure in Place the Cisco EPN Manager 2.1.x Installation File on the Server.
Step 3 Upload the Cisco EPN Manager 2.1.x ubf file to the secondary server. (You will use the same file that was uploaded and installed on the primary server.)
a. Log into the secondary server’s HM web page by entering the following URL in your browser:
Where serverIP is the IP address or host name of the secondary server.
b. Enter the authentication key and click Login .
c. Click Software Update at the top right of the Health Monitor window to open the Secondary Server Software Update window.
d. Enter the authentication key and click Login .
e. Click the Upload link under the window title, browse to the ubf file, and click OK .
After the successful upload of the ubf file, the file will appear under the Files tab.
Install Cisco EPN Manager 2.1.x on Primary and Secondary Servers (HA Deployment).
This ensures that the compliance server will be up and running on the secondary server after failover.
Step 1 Install Cisco EPN Manager 2.1.x on the primary server and verify the installation, as described in Install Cisco EPN Manager 2.1.x (No HA). After the installation, the primary server automatically restarts and the web GUI will not be accessible for some time.
Step 2 Install Cisco EPN Manager 2.1.x on the secondary server.
a. Log into the secondary server’s HM web page by entering the following URL in your browser:
Where serverIP is the IP address or host name of the secondary server.
b. Enter the authentication key and click Login .
c. Click Software Update at the top right of the Health Monitor window to open the Secondary Server Software Update window.
d. Enter the authentication key and click Login .
e. Click the Install button associated with EPN Manager Maintenance Pack x on the Software Update page.
f. Click Yes in the confirmation message pop-up window to proceed with the installation. On successful installation, the status will change to Installed and the secondary server will restart automatically.
Step 3 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.
b. Run the ncs status command to ensure that, at a minimum, the following services are up and running: Health Monitor, Database, Matlab, NMS, SAM Daemon, DA Daemon, Compliance Engine. Note that for optimal Cisco EPN Manager functionality, all services should be up and running.
c. Once the web GUI is accessible, verify the installation and version in the secondary server’s HM web page. Enter the following URL in your browser:
Where serverIP is the IP address or host name of the secondary server.
– Enter the authentication key and click Login .
– Click Software Update at the top right of the Health Monitor window to open the Secondary Server Software Update window.
– Enter the authentication key and click Login .
– In the Files tab, verify that the MPx ubf file (in the format cepnm2.1-mpx-buildxxx.ubf) is listed and that the In Use status is Yes.
Step 4 Synchronize the hardware and NTP clocks on both the primary and secondary servers as described in Synchronize the Hardware and NTP Clock, then check that the clocks on each server are synchronized with one another.
Step 5 As the Cisco EPN Manager CLI admin user, manually stop and restart the primary and secondary servers:
Step 6 Ensure that all services are up and running by running this command:
Step 7 On the primary server, enable high availability and verify that the primary server’s HA status is Primary Active.
– Log into the Cisco EPN Manager web GUI as a user with Administrator privileges.
– From the left sidebar menu, choose Administration > Settings > High Availability .
– Click HA Configuration 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.
– If you are using virtual IP addressing in your HA setup (if the primary and secondary servers are in the same subnet), check the Enable Virtual IP check box and enter the virtual IP address(es).
– Click Save , then wait until the servers are synchronized.
– Verify that the Configuration Mode is HA Enabled .
b. Verify the primary server’s HA status.
– Click HA Status on the left.
– Check that the Current State Mode displays Primary Active .
Step 8 Verify that the secondary server’s HA status is Secondary Syncing.
a. Log into the secondary server’s HM web page by entering the following URL in your browser:
Where serverIP is the IP address or host name of the secondary server.
b. Enter the authentication key and click Login .
c. Verify that the Current State Mode is Secondary Syncing (with a green check mark).