readme file for cisco prime network 4.1.0.0.4 point patch · jobs for nat units (cisco prime...

24
All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 1 Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch Revised: Jan 8 th , 2015 This document supports the release of the Prime Network 4.1.0.0.4, which is installed on top of Cisco Prime Network 4.1. All changes described in this document apply only to Cisco Prime Network 4.1. Note: Please make sure to review this Point-Patch Test Report for the list of possible issues/caveats EDCS-1471334 (Cisco Internal Only) Note: It is recommended to install the latest Prime Network device package: https://software.cisco.com/download/release.html?mdfid=285956832&flowid=6032 3&softwareid=284186148&release=4.1- DP1409&relind=AVAILABLE&rellifecycle=&reltype=latest Prerequisite: Prime Network 4.1

Upload: others

Post on 27-Apr-2020

15 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 1

Readme File for Cisco Prime Network 4.1.0.0.4

Point Patch

Revised: Jan 8th , 2015

This document supports the release of the Prime Network 4.1.0.0.4, which is installed on

top of Cisco Prime Network 4.1. All changes described in this document apply only to

Cisco Prime Network 4.1.

Note: Please make sure to review this Point-Patch Test Report for the list of possible

issues/caveats –EDCS-1471334 (Cisco Internal Only)

Note: It is recommended to install the latest Prime Network device package:

https://software.cisco.com/download/release.html?mdfid=285956832&flowid=60323&softwareid=284186148&release=4.1-DP1409&relind=AVAILABLE&rellifecycle=&reltype=latest

Prerequisite: Prime Network 4.1

Page 2: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 2

Table of Contents

1 Obtaining the Point Patch 3

2 Point Patch Contents 3

3 Explanation on Contents 3

4 Installing the Point Patch 4

5 Optional – Installing Prime Network Integration Layer patch post the install of PN 4.1 Point Patch 1 8

6 Optional - Prime Network Operations Report Patch Installation 9

7 Verifying the Prime Network Point Patch Installation 11

8 Verifying the Prime Network Integration Layer Patch Installation 13

9 Uninstalling the Prime Network Point Patch 14

10 Verifying the Prime Network Point Patch Uninstalling 17

11 Uninstalling the Integration Layer patch 18

12 Known Caveats – Cisco Prime Network 4.1.0.0.4 Point Patch 19

13 Resolved Caveats – Cisco Prime Network 4.1.0.0.4 Point Patch. 19

14 Bug Resolutions That Require VNE Device Package 23

15 Obtaining Documentation, Support and Security Guidelines 24

Page 3: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 3

1 Obtaining the Point Patch To obtain the Cisco Prime Network 4.1.0.0.4 Point Patch installation, download it from

Cisco.com:

https://software.cisco.com/download/type.html?mdfid=285956832&flowid=60323

2 Point Patch Contents Cisco Prime Network 4.1.0.0.4 Point Patch contains the necessary files and scripts in

support of the following:

Prime Network Patch

Network Configuration Change management (NCCM) Patch

Resolved caveats, identified in Resolved Caveats – Cisco Prime Network Point Patch.

Known caveats, identified in Known Caveats

Cisco Prime Network Installation Guide, 4.1

3 Explanation on Contents Beginning in Prime Network 4.0, the patch delivery process includes several changes that

combine the delivery of fixes and upgrades of multiple components into a single delivery

method. This patch includes the normal patch upgrade for Prime Network that has been

delivered in previous versions. However, the NCCM patches are now being included into

this patch process instead of being delivered and installed separately. With PN 4.0 comes

the introduction of an integration layer (Prime Network Integration Layer) that supports

the ability to have multiple Prime Network domains integrated with Prime Central. The

patch will automatically install the Prime Network Integration Layer patch if the Prime

Network Integration Layer base application exists. With the Cisco Prime Network 4.0

comes the introduction of a new Operations Report Tool. The updates associated with this

tool are also being included in this patch installation.

Note: Not all Point Patches contain updates for Prime Network Integration Layer and

Operations Report Tool.

Page 4: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 4

4 Installing the Point Patch This procedure describes how to install the Cisco Prime Network 4.1.0.0.4 Point Patch on

top of an existing Cisco Prime Network 4.1 installation.

Before You Begin

1. If you are using the LINUX RHCS solution:

Login to the Cisco Prime Network gateway as root user and move the services into

freeze mode, by running:

a) clusvcadm –Z <Prime Network service>

b) clusvcadm –Z <Oracle service>

For example:

clusvcadm –Z ana

clusvcadm –Z oracle_db

2. If you are using Geo HA solution:

a. Unzip the RH_ha.zip from the installation package.

b. Copy the folder RH_ha/perlForHA/PrimeNetwork to /var/adm/cisco/prime-

network/scripts/ha/util/perlForHA directory on all of the gateways of the

system.

c. Set the privilege and ownership of the copied "PrimeNetwork" folder and its

included subfolders and files to the values same as other folders and files in

/var/adm/cisco/prime-network/scripts/ha/util/.

d. Remove the perl folder if exists (owned by root) from /var/adm/cisco/prime-

network/scripts/ha/util on all of the gateways of the system (The SP/PP install

script will create the same perl folder, but this time the perl folder will be

owned by PN user)..

3. Make sure the Cisco Prime Network gateway and units are up and running before

installing the point patch (Except for Unit behind NAT, see next step).

4. If you are using Unit behind NAT please stop the Prime Network application and

remove the current crontab. Enter the following commands on each of the NAT units:

a) networkctl stop

b) crontab -r

5. Copy the Point Patch to a directory outside of the Cisco Prime Network home

directory (as user ‘root’).

Example:

Page 5: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 5

cd /export/home

mkdir 4.1.0.0.4

6. Grant the directory Cisco Prime Network user permission.

Example:

chown <Prime Network-user>:ana 4.1.0.0.4

Notes

The installation process is configured to execute automatic backup of all the files

under the Cisco Prime Network home directory. Creating the backup zip file can take

up to one hour.

You can abort the installation if a backup of the database has not been performed.

You are prompted for a destination path for the backup file and to indicate the

required disk space requirements. This path location cannot be

$PRIME_NETWORK_HOME.

Grant Prime Network user permission to the Cisco Prime Network backup

directory.

The backup file name is appended with the UNIX time stamp of the gateway

machine.

The file format of the backup is PrimeNetworkBackUp_<unix_time>.tar.gz.

We recommend that you install Cisco Prime Network 4.1.0.0.4 Point Patch with the

default option: perl upgrade.pl.

To install the Point Patch without a backup (that is, without the option to rollback, or a

manual rollback), run the upgrade.pl script with the –nobackup option, as follows:

perl upgrade.pl –nobackup

This Point Patch might include database table changes. If you would like the option to

rollback to a previous Cisco Prime Network version, backup the database.

If your setup is installed with an embedded database, see the “Performing a Manual

Backup of an Embedded Database and Cisco Prime Network” section in the Cisco

Prime Network Administrator Guide, 4.1.

The Cisco Prime Network gateway and units restart automatically after the installation

has completed successfully.

Installation Procedure

1. Login to the Cisco Prime Network gateway as Prime Network user.

2. Navigate to the directory in which you placed the Point Patch. (See Before You Begin).

3. To extract the necessary JAR files and Perl scripts, for Prime Network and Operations

Report installation, go to the patch directory location created in Step 5 above and unzip

the file by entering the following command:

Page 6: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 6

Example:

cd /export/home/4.1.0.0.4

unzip Prime_Network4.1.0.0.4.zip –d ./Point-Patch

4. The zip file will contain 2 separate additional zip files. One contains the files

associated with installing the Prime Network patch (same name as original zip file)

and the other for installing patches related to the Operations Report Tool.

Note: Operations Report Tool zip file will exist only if there are updates available to

this Point Patch

1. Prime_Network4.1.0.0.4.zip

2. 4.1_Reports.zip

5. For installing the Prime Network patch, go to the newly created sub directory (ie.

Point-Patch) and unzip the Prime Network Patch zip file:

Example:

cd ./Point-Patch

unzip Prime_Network4.1.0.0.4.zip

6. Navigate to the Prime_Network_upgrade directory:

cd Prime_Network_upgrade

7. Enter one of the following commands, depending on whether or not you want to install

the Point Patch with the option to roll back:

To install the Point Patch and create a backup file, enter:

perl upgrade.pl

To install the Point Patch without creating a backup file, enter:

perl upgrade.pl -nobackup

Page 7: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 7

8. If you are using a Unit behind NAT please restart the crontab, see Restarting Crontab

Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1)

9. During the patch installation, the console output will indicated that the NCCM patch is

being installed, “Upgrading NCCM”.

10. If you observe the following output from the install script “Upgrading Integration

Layer”, then the base Prime Network Integration Layer was previously installed and

the script is upgrading Prime Network Integration Layer patch. If the base Prime

Network Integration Layer is not installed, then no action is taken by the script. The

base Prime Network Integration Layer is required for Suite setups and optional for

Standalone setups (enables MTOSI and 3GPP web service implementations via WS-

SOAP NBI).

11. The script will provide a user prompt “Do you want to proceed (Yes/No)?” Answer

“Yes” to install the Prime Network Integration Layer patch. Answering “No”

continues the installation but does not install the Prime Network Integration Layer

patch.

12. Wait until the Cisco Prime Network gateway is up and running.

13. For installing the Operations Report Tool patch, refer to section Prime Network

Operations Report Tool Installation.

14. To complete the upgrade and ensure successful functioning of the network discovery tool,

run the following command to set the necessary file permissions for the Fping utility:

su root -c '$PRIME_NETWORK_HOME/local/scripts/setFpingPermissions.tcsh'

15. If you are using the LINUX RHCS solution:

Log into the Cisco Prime Network gateway as root user and move the services out of

freeze mode, by running:

clusvcadm –U <Prime Network service>

clusvcadm –U <Oracle service>

Page 8: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 8

5 Optional – Installing Prime Network Integration

Layer patch post the install of PN 4.1 Point

Patch 1 The upgrade script provides the user with the option of installing the Prime Network

Integration Layer patch. To install the Prime Network Integration Layer patch post the

installation of PN 4.1 Point Patch 1, please follow the install procedure specified in the PN

4.1 install guide (Base Install) and then follow these steps for the patch installation:

Note: Not all Point Patches contain updates for Prime Network Integration Layer

Post the Prime Network Integration Layer install; please perform the following steps as the

Prime Network User:

$PRIMEHOME/local/scripts/il-watch-dog.sh disable

itgctl stop

cd ~/.setup/independent/integrationlayer/patch

./patchIntegrationLayer.sh

$PRIMEHOME/local/scripts/il-watch-dog.sh enable

itgctl start

Page 9: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 9

6 Optional - Prime Network Operations Report

Patch Installation Prerequisite - The Reporting tool is an optional installation requirement with Prime

Network 4.1. Please refer to “Installing Prime Network Operations Report” in the Prime

Network 4.1 Installation Guide for details. This reporting tool and associated Infobright

database must be installed on the gateway and unit(s) prior to installing any required

patches for this tool.

Note: Not all Point Patches contain updates for Prime Network Operations Report

If you don’t have Prime Network Operations Report installed or if there is no 4.1

Reports zip file in the point patch, skip to the next section.

You can confirm if the tool is already installed (as a Cisco Prime Network user) by either

checking for the existence of a ~/pentaho directory under $PRIME_NETWORK_HOME,

launching the Operations report tool using https://<gw-ip>:8445/prime-network-

reports/Login or checking to see if the server is listening to the default port: (ie. netstat -

a | grep LISTEN | grep 8445)

Perform the following steps as a Cisco Prime Network user to install the Operations

Report patch:

1. Navigate to the directory in which you placed the Point Patch. (See Before You

Begin.)

2. To extract the necessary JAR files and Perl scripts, for Operations Report installation,

unzip the file by entering the following command:

unzip 4.1_Reports.zip

3. As the PN installation user, run the following commands to start the patch installation:

cd ./4.1_Reports

chmod +x install-reports-patch.sh (makes script executable)

./install-reports-patch.sh (initiates the patch installation)

4. Check the log file for any errors. Both progress and status are printed to the console

and the following log file:

$PRIME_NETWORK_HOME/install-reports.log

5. Once the patch is successfully installed, a restart and refreshing the solution repository

is required. Please follow the instructions detailed below for the Post installation steps.

Page 10: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 10

Post installation steps for Operations Report Patch Install

1. Stop the server using the Pentaho master script

~/pentaho/ctlscript.sh stop

2. Ensure all Pentaho process are killed. Run the command:

ps –ef | grep pentaho

If any process is listed, stop them using kill command:

kill -9 <pid>

3. Start the server using the Pentaho master script:

~/pentaho/ctlscript.sh start

4. Update the solution repository by logging into the Operations Report server

(https://<gw-ip>:8445/prime-network-reports/Login) and performing the following

actions:

> Tools > Refresh > Repository Cache

> Tools > Refresh > Reporting Metadata

Page 11: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 11

7 Verifying the Prime Network Point Patch

Installation This section describes how to verify that Cisco Prime Network 4.1.0.0.4 Point Patch has

been installed successfully, as explained in Section 4, Installing the Point Patch..

This procedure uses the script ~/Main/scripts/checkPatchInstallation.pl to confirm that

the Point Patch has been installed correctly.

Note: Execute the commands from the gateway.

Verification Procedure

1. Enter the following command to determine the version of the Point Patch installed:

checkPatchInstallation.pl -p

The gateway responds with the Point Patch information, such as:

Current patch (in 127.0.0.1): Prime_Network4.1.0.0.4 _PP.jar: patch.jar

2. Enter the following command to determine whether all components of the Point Patch

installed successfully:

checkPatchInstallation.pl Prime_Network4.1.0.0.4_PP.jar

If the installation was successful, information similar to the following is displayed:

Patch Prime_Network4.1.0.0.4_PP.jar correctly installed in the

gateway (127.0.0.1)

Patch Prime_Network4.1.0.0.4_PP.jar correctly installed in the golden

source registry (0.0.0.0)

Patch Prime_Network4.1.0.0.4_PP.jar correctly installed in the unit

<unit IP>

Patch Prime_Network4.1.0.0.4_PP.jar correctly found at the start of

0.out log file

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file

/export/home/pn40/Main/webstart/agentregistryviewer.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file /export/home/pn40/Main/webstart/bosmanage.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file /export/home/pn40/Main/webstart/dcdebugger.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file /export/home/pn40/Main/webstart/eventvision.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file /export/home/pn40/Main/webstart/networkvision.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file

/export/home/pn40/Main/webstart/processdebugger.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file /export/home/pn40/Main/webstart/regedit.jnlp

Page 12: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 12

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file

/export/home/pn40/Main/webstart/sessiondebugger.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file /export/home/pn40/Main/webstart/stresser.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar correctly found as the first

reference on file /export/home/pn40/Main/webstart/workflowstudio.jnlp

Patch Prime_Network4.1.0.0.4_PP.jar's classes files are being called

from this patch on server 127.0.0.1

Patch Prime_Network4.1.0.0.4_PP.jar's xml files are being called from

this patch on server 127.0.0.1

Patch Prime_Network4.1.0.0.4_PP.jar's classes files are being called

from this patch on server <unit IP>

Patch Prime_Network4.1.0.0.4_PP.jar's xml files are being called from

this patch on server <unit IP>

---> Patch Prime_Network4.1.0.0.4_PP.jar correctly installed

If the installation was not successful, messages are displayed that indicate where

problems are located. The final line in the report is:

---> Patch Prime_Network4.1.0.0.4_PP.jar not correctly installed or

at least one warning displayed

Page 13: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 13

8 Verifying the Prime Network Integration Layer

Patch Installation To verify that the Prime Network Integration Layer patch was installed successfully,

execute the following command:

Note: Not all Point Patches contain updates for Prime Network Integration Layer

cd $PRIMEHOME/install/scripts

./version.sh get

To check the logs for errors, go to:

cd $PRIMEHOME/patches/1.1.0.1/

Page 14: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 14

9 Uninstalling the Prime Network Point Patch This procedure describes how to uninstall the Point Patch. Performing an uninstall will

completely remove the Point Patch from the system.

Note: you can uninstall the Point Patch only if it was installed with the backup option,

using the command: perl upgrade.pl –p.

Note: Rolling back the Prime Network Point Patch will also roll back any applied patches

related to other components such as Prime Network Integration Layer, Operation Reports

and CCM.

Rollback Procedure

1. Verify that the gateway and unit workstations can communicate via SSH.

2. Login to Prime Network Administration and disconnect Standby and NAT units from

the gateway using the Administration GUI.

3. Login to the Cisco Prime Network gateway as Prime Network user.

Stop Cisco Prime Network by entering the following commands:

networkctl stop

Note: The above step is only applicable for non-embedded databases. If using an

embedded database, the embdclt script will automatically stop the gateway and units.

4. If you are using GEO HA: On the Remote DB machine, stop the replication:

cd /var/adm/cisco/prime-network/scripts/ha/util/

perl primeha –stop

5. Restore the Cisco Prime Network database alone:

For an embedded database, see the “Restoring an Embedded Database and

Prime Network“ section in the Cisco Prime Network Administrator Guide, 4.1.

Make sure to use the instructions to “Restore Prime Network Embedded

Database Alone“ (i.e. use the ‘emdbctl --restore_db’ command).

For a non-embedded database setup, restore the backed-up database and start

the database services and the listener. The database table structure is changed

during the upgrade. In order for the system to function correctly after a rollback,

the old table structure must be recovered through a database backup.

6. Reinstall the units. This is required prior to running the rollback.pl script in the

subsequent steps.

Page 15: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 15

7. Navigate to the Prime_Network_upgrade directory you created for installing the Point

Patch:

Example:

cd 4.1.0.0.4/Point-Patch/Prime_Network_upgrade

8. As the Cisco Prime Network user, enter the following command on the Cisco Prime

Network gateway only:

perl rollback.pl

Note: Running the rollback.pl script will also restore the Cisco and Non-Cisco Device

driver files associated with Device Package (DP) installations. Therefore, any VNE

device driver files associated with DP installations that occurred after the last backup

procedure will be overwritten. The rollback procedure removes and replaces the entire

contents of the Cisco Prime Network home directory which includes the

~/Main/drivers directory.

9. At the prompt "Are you sure you want to rollback the current Prime Network

installation?" enter yes.

- Writing log to /export/home/network-upgrade/PrimeNetwork_upgrade/rollback-

number.log

- Have you rolled back the database? (yes,no) [default yes]

- Have you reinstalled the units? (Y,N) [default Y]

- Are you sure you want to rollback the current Prime Network installation?

(yes,no)[default yes]

10. At the prompt "Please enter the full path to the backup archive file," enter the location

of the backup archive directory. The rollback.pl script does not delete the backup

archive.

- Please enter the full path to the backup archive file:

Example:

/export/home/4.1.0.0.4/PrimeNetworkBackup/PrimeNetworkBackUp_<unix_time

>.tar.gz

11. The scripts revert the gateway back to its earlier version:

- Removing content of /export/home/network40 [OK]

- Extracting backup archive under /export/home/network40 [OK]

- Removing Standby Units

[OK]

- Starting Prime Network on GW

+ Rollback completed successfully.

Please remember to do the following:

- Re-login as the Prime Network user for environment changes take place

check logs for further information.

- Rollback logs can be found at <logFile>

Page 16: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 16

12. Run the “network-conf –rollback” command on the unit machines.

13. Run "networkctl start" on the unit machines.

14. If you are using GEO HA: From the RH_ha directory (extracted during the install

process of this PP) run the following command as root user:

perl setup_Prime_DR.pl

This will setup the replication between the local and remote sites and copy the db files

to the remote site.

This may be a lengthy process depending on the size of the database.

15. After the rollback to your original Cisco Prime Network 4.1 environment is complete,

reconfigure your user-defined crontabs.

16. For Prime Suite environments, you must run the DMIntegrator.sh script in order for

the Prime Network Version in the Suite Monitoring portlet to be reverted back

successfully.

$PRIME_NETWORK_HOME/prime_integrator/DMIntegrator.sh

Page 17: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 17

10 Verifying the Prime Network Point Patch

Uninstalling This procedure allows you to verify that the Point Patch was uninstalled successfully.

Uninstalling Verification Procedure

1. On the Cisco Prime Network gateway, login as Prime Network user.

2. Navigate to the Main directory.

3. Enter the following command:

./runRegTool.sh -gs 127.0.0.1 get 0.0.0.0 site/mvm/services/bsm/patchjar

You should not see the Point Patch that was removed.

4. Enter the following command:

./runRegTool.sh -gs 127.0.0.1 get 127.0.0.1 site/mvm/services/bsm/patchjar

You should not see the Point Patch that was removed.

5. Enter the following command from the Cisco Prime Network gateway for all the units:

./runRegTool.sh -gs 127.0.0.1 get <unit ip> site/mvm/services/bsm/patchjar

You should not see the Point Patch that was removed.

6. To verify that the Prime_Network4.1.0.0.4_PP.jar file does not exist in any of the

JNLP files, enter the following command:

cat ~/Main/webstart/*.jnlp | grep Prime_Network4.1.0.0.4_PP.jar

The output should be empty.

7. Enter the following command:

find ~/Main/ -name Prime_Network4.1.0.0.4_PP.jar

The output should be empty.

8. Navigate to the logs directory (~/Main/logs).

9. Check the AVM 0 log file by entering the following command:

cat 0.out | grep Prime_Network4.1.0.0.4_PP.jar

The output should be empty.

Page 18: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 18

10. Check the AVM 11 log file by entering the following command:

cat 11.out | grep Prime_Network4.1.0.0.4_PP.jar

The output should be empty.

11 Uninstalling the Integration Layer patch

To uninstall the Prime Network Integration Patch, perform the following steps:

Note: Not all Point Patches contain updates for Prime Network Integration Layer

1. As Prime Network application user log in to PN server and Disable Prime Network

Integration Layer.

$PRIMEHOME/local/scripts/il-watch-dog.sh disable

2. ESB directory will be backed up under patches directory

($PRIMEHOME/patches/<patch-id>/.backup/esb). Copy esb folder and replace

$PRIMEHOME/esb

mv $PRIMEHOME/esb_X $PRIMEHOME/esb_X_backup // Where X is the

instanceId, instanceId can be found by command "itgctl list"

# In case patch-id is 1.1.0.1

cd $PRIMEHOME/patches/1.1.0.1/.backup

cp -fr esb $PRIMEHOME/esb_X

3. Edit version file and change the patch number

vi $PRIMEHOME/install/files/.version

change PATCH=1.1.0.1 to PATCH=0.0.0.0

4. Enable Prime Network Integration Layer

$PRIMEHOME/local/scripts/il-watch-dog.sh enable

Page 19: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 19

12 Known Caveats – Cisco Prime Network 4.1.0.0.4

Point Patch The following caveat has not been fixed in Cisco Prime Network 4.1.0.0.4 Point Patch.

Known Caveats - 4.1.0.0.4 Point Patch Identifier severity Summary

None

13 Resolved Caveats – Cisco Prime Network

4.1.0.0.4 Point Patch. The following caveats have been fixed in Cisco Prime Network 4.1.0.0.4 Point Patch.

Note: Please make sure to review this Point-Patch Test Report for the list of possible

issues/caveats – EDCS-1471334 (Cisco Internal Only)

Resolved Caveats - 4.1.0.0.4 Point Patch Identifier Summary

CSCua67398 JuneDP-Satellite status improper after the it's interface link made down

CSCuf15027 ENH: LDAP need to authenticate users belonging to different subgroups

CSCui05381 Device Proxy support for key based auth requires user to change jars

CSCui35119 NCCM - config restoration fail in device banner

CSCuj27901 CCM - About and splash screen don't show CCM PP or SP version

CSCul08868 BFD syslog events are not correlated to BFD services events

CSCul46808 configurator commands should have urgent priority

CSCum15154 N77-F348XP-23 OIR: LAG down tickets are not cleared

CSCum54365 AVM35 process hangs, TP-tunnel Service Discovery plug-in stops working

CSCum75675 CrossBow device support enhancement

CSCum94855 Tickets with sandglass for missing notification

CSCun08829 AAADiameterRouteTableEntryIrd "equals" method performance issue

CSCun10969 650K message drops every 30 seconds

CSCun19143 Satellite IC port status will not have status populated on VNE

CSCun20899 active and the backup PWs of the same Network PW didn't merged

CSCun22578 Traps are not receiving in PN-CMM integrated Server

CSCun24763 Improving Vision big map performance

CSCun24906 PN: Fan tray out ticket is not cleared and Fan status stay on cleaning

CSCun27884 Association of alarms with VLAN interfaces is incorrect in GUI

CSCun37125 PPM TCA traps can have very long descriptions

CSCun37851 Issue in IntegritySP.creTicketOrArchiveFlaggingEvents throw db exception

Page 20: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 20

CSCun43731 Duplicate not cleared 'Power supply out' alarm with Chassis disconnected

CSCun46951 Associated PWs are not updated in specific scenarios

CSCun49899 Cannot create static link to cloud VNE from port with DWDM

CSCun52409 PN: "octet packets rx tx" Error flood ASR9K AVM log

CSCun67301 Physical interface: LLDP Info is not updating when clicked on Poll now

CSCun79708 Any kind of Notifications are not being sent.

CSCun79722 ASR9K: Missing entries in the LLDP table

CSCun84136 Command manager edit takes long time to save

CSCun84154 Command manager edit fails when Implementation is changed

CSCun84997 ReportsServiceImpl sees null for RegistryManager

CSCun92962 IE8 Blank Execution Parameter screen & loses selected list of devices

CSCun95386 Compliance Audit Page Renders wth "js" error sometimes

CSCun95760 Compliance audit job fails when using SCP protocol

CSCun95894 Deleting the commands in command manager leaves in-progress circle

CSCun95925 User guide has to be updated in creating policy rules example

CSCuo02196 DP1401 - Missing cdp link between subinterfaces of cisco 2811 and ASR1k

CSCuo04758 CCM fails to distribute image to Dragon wave devices using ftp

CSCuo04951 Command Manager-Admin/configurator not able to see other user's jobs

CSCuo14613 Doc: (Install guide)-cluster service freeze content missing.

CSCuo17407 Waiting IRD framework does not work properly.

CSCuo18874 device get stuck in discovery

CSCuo20480 avm monitoring: updatestatus.cgi shows localhost down, always

CSCuo21651 Perform activation jobs in Parallel/Sequential order

CSCuo22221 need guidance on TACACS/+ and Prime Network integration

CSCuo22448 Special character in configuration is failing Config Audit job

CSCuo22457 Thousands of telnet archive registrations are created at once

CSCuo26261 Not able to install PN4.1 May DP over PN4.1 PP1.

CSCuo27878 The 'LSP down' alarms are not cleared at VNE initialization

CSCuo29398 Doc Bug: The Document should be modified for Suite Mode PN-IL Steps

CSCuo32623 PN 4.1 build is not picking up NCCM installer zip

CSCuo34442 Compliance audit generates a wrong violation report

CSCuo34945 Document has to be updated showing the maximum event history

CSCuo36266 PN - Operations Report User Guide mssing explanation on Users permission

CSCuo43702 OAM Admin status change is not getting reflected in Physical Inventory

CSCuo48848 Event trigerred backup is failing with null pointer

CSCuo51570 Config archive setting should not be changed while job is running

CSCuo59495 Doc Bug: Prime Network HA Guide needs change in Geo Support section

CSCuo59978 Satellite Port/Link down not cleared on Chassis connect

CSCuo60826 IE8 - Activate IOS by Image page not rendering properly

CSCuo61487 Archiving non flagging events is freezing event processing

CSCuo68860 BfdSessionCommandHandler adds twice to the waiting list and cause OOM

CSCuo78264 Policy container is outside QOS

CSCuo79249 PN - Performance Graph Cross-launch clarification needed in User Guide

CSCuo85863 Inconsistent reporting of DWDM controller state - AdminDown vs. Down

CSCuo95324 Device not getting modeled when changing polling options

CSCup00076 Install remains on step "Starting Web Server" and does not continue

CSCup02906 adding parsing command for delay all registrations

CSCup21205 Flapping Event application is creating proxy event for traps

CSCup21269 Collector agent is suspended when a Command Script is executing

CSCup26514 Technology change for Satellite Phy Inv not updated on Port Range

Page 21: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 21

change

CSCup28832 port specification is missing for webstart page

CSCup78313 Admin/configurator not able to see other user's jobs

CSCup87393 Audio alarm get broken if ticket gets cleared quickly

CSCup89911 AVM OOM and device slow response due to multiple xml command instances

CSCup94395 PN: Mistakes "Installing the PN-IL" in PN 4.1 Installation Guide

CSCup95413 PN - Installation Guide updates for PNIL

CSCup99687 PN: Webclients are not working after upgrading from 4.1 to 4.1-PP1

CSCuq02423 CCM fails to backup configs from Dragon wave devices using ftp

CSCuq11869 PN - NCCM - Help About is showing SNAPSHOT reference in version

CSCuq31390 unit failover fails in some scenario in PN 4.1

CSCuq42098 PN- Wrong version declaration in installation procedure of PP5

CSCuq70018 user import from ldap ldif file fails, gives null ptr error

CSCuq72556 User scope in CCM operation does not work

CSCuq72593 NullPointerException on validation of satellite links

CSCuq84130 The Device Unreachable erroneously was picked up as a root cause

CSCuq94869 upgrade.pl fails on permissions update

CSCur02707 telnet command in networkvision needs to use the protocol set in the VNE

CSCur08897 Telnet Collector gets Stuck @ Lotem (jcraft)- vne in unsync mode

CSCur16547 Power Supply out service alarm not cleared on module inserted

CSCur20403 False LAG link down on unreachable with LAG interface shutdown

CSCur40812 avm 25 exception Caused by: java.lang.ArrayIndexOutOfBoundsException: 10

CSCur46387 Card down for non-FRU modules is not cleared

CSCur48627 Command Sequence : Add commands filter not selecting the right commands

CSCur48758 NCCM login page show wrong PP version

CSCur53183 Command Manager is extremely slow while creating a new command

CSCur76695 context menu Tools->Telnet needs to be generic named

CSCur77350 PN - Device proxy putty window for telnet come up with wrong prompt

CSCul98786 VRRP MACs should be disregarded from MAC topology.

CSCur01413 VCB: Module template list is empty for some of the module families

CSCuq38311 VNE continuously creats 'mpls te tunnel up' events though status is up

CSCuo35057 Lotem does not close gracefully SSH session at device response timeout

CSCur56341 MAC address limit syslog is not processed properly in ASR 9K

CSCur75646 Exception when see comma in oid in property_value of notfication table

CSCur83592 IE not work with PN 4.1 Application Launch page with hostname in URL

CSCur77764 ASR9001: Fan status is Unknown after chassis disconnected

CSCum50839 PN - Patch installation is not including prime-network-web project

CSCur81636 Port Up events for ICL ports on satellites are not created at VNE init

CSCur81697 Layer 2 tunnel down service alarms are not cleared at VNE init

CSCus08746 AVM25 gets stuck some times during failover scenario's

CSCum80241 Null pointer exception in 100.out

CSCur99852 LACP topology test fails to discover moved or added physical link

CSCur99826 LAG member down alarm is not cleared when member is removed from group

CSCur90050 NullPointerException in LSE DC when label forwarding table changes

CSCur75222 CRS8S: Fan-tray out has not been developed on fan tray OIR

CSCur60531 CPT device Fan&power supply description in vision not matching with MIB

CSCus11423 ArrayIndexOutOfBoundsException during nccm activation

CSCus19697 VRF Routing table cache doesn't get cleanup at all causing OOM

CSCus22634 MPLS TE FRR State Changed to Active not cleared though inventory

Page 22: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 22

updated

CSCus28736 Command Manager Queue Issue(PTP Manager Pool)

Page 23: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 23

14 Bug Resolutions That Require VNE Device

Package The following bug resolutions are contained in this Prime Network Point-Patch. However,

to completely resolve the bug you must also install a VNE Device Package that contains

the associated VNE software fix. The following table describes these bugs and the VNE

Device Package that is required (along with the associated VNE bug). To obtain any

Prime Network patches, contact your Cisco representative.

Identifier Headline Resolved in Required Device Package Onwards (VNE Bug)

CSCun27884 Association of alarms with VLAN interfaces is incorrect in GUI

04.1(00)PP01 04.1(00X)DP1405.00.321

CSCup26514 Technology change for Satellite Phy Inv not updated on Port Range change

04.1(00)PP01 04.1(00X)DP1407.00.401

CSCun20899 active and the backup PWs of the same Network PW didn't merged

04.1(00)PP02 TBD

CSCun46951 Associated PWs are not updated in specific scenarios

04.1(00)PP02 TBD

CSCup02906 adding parsing command for delay all registrations

04.1(00)PP02 04.1(00X)DP1409

CSCuo85863 Inconsistent reporting of DWDM controller state - AdminDown vs. Down

04.1(00)PP02 04.1(00X)DP1411

CSCup89911 AVM OOM and device slow response due to multiple xml command instances

04.1(00)PP02 04.1(00X)DP1409

CSCur46387 Card down for non-FRU modules is not cleared

04.1(00)PP03 04.1(00X)DP1411

CSCur20403 False LAG link down on unreachable with LAG interface shutdown

04.1(00)PP03 04.1(00X)DP1411

CSCur56341

MAC address limit syslog is not processed properly in ASR 9K

04.1(00)PP04 TBD

Page 24: Readme File for Cisco Prime Network 4.1.0.0.4 Point Patch · Jobs for NAT Units (Cisco Prime Network Installation Guide, 4.1) 9. During the patch installation, the console output

All contents are Copyright © 2015 Cisco Systems, Inc. All rights reserved. Page 24

15 Obtaining Documentation, Support and Security

Guidelines For information on obtaining documentation, obtaining support, providing documentation

feedback, security guidelines, and also recommended aliases and general Cisco

documents, see the monthly What's New in Cisco Product Documentation, which also lists

all new and revised Cisco technical documentation, at:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

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.

© 1999-2014 Cisco Systems, Inc. All rights reserved.