Updating Network Monitoring After Upgrading the Junos Space Network Management Platform

Overview

After upgrading the Junos Space Network Management Platform, the Network Monitoring configuration files might not contain the configuration file changes for the latest version. During the Junos Space Network Management upgrade process, the Software Install Status window displays a message if there are any configuration files in conflict. You can also access the /var/log/install.log file to view any files that have conflicts. To manually merge files that contain conflicts, you must perform all of the following steps. When the upgrade process encounters no files in conflict, the files are auto-merged and you do not need to perform the following steps.

Step 1: Monitoring the Software Install Status Window for File Conflicts

Check for the following message in the Software Install Status window during the upgrade of the Junos Space Network Management Platform:

When logged in from the Junos Space Network Management Platform command-line interface (CLI), you can also check for file conflicts from the /var/log/install.log file. The following example message from the install.log file shows three files with conflicts that you will need to manually merge to resolve:

Note:

If no files with conflicts are found during the upgrade process, the files are automatically merged, and you do not need to perform any additional steps. Otherwise, you must complete each of the following steps.

Step 2: Identifying Files with Conflicts

If you discovered one or more files with conflicts during the previous step, perform the following steps to identify the files with conflicts:

Log in to the virtual IP (VIP) fabric node.
Stop the Network Monitoring service from the Junos Space Network Management Platform user interface:
1. Select Network Management Platform > Administration > Applications.
  The Applications page appears.
2. Right-click Network Management Platform and click Manage Services. (Alternatively, you can select Network Management Platform and click Manage Services from the Actions menu.)
  The Manage Services page is displayed.
3. Select the Network Monitoring service and click the Stop Service icon.
  The Confirm Stop SNMP Agent dialog box is displayed.
4. Click Yes.
  A status dialog box with a message indicating that the service has stopped is displayed.
5. Click OK.
  A dialog box is displayed confirming that the service has successfully stopped.
6. Click OK.
  You are taken to the Manage Services page.
From the Junos Space Network Management Platform CLI, check the status of the Network Monitoring service by executing the following command:
Junos Space displays the message opennms is stopped.

To re-merge the Network Monitoring configuration files:

From the Junos Space CLI, execute the following command:

Junos Space displays output similar to the following:

Navigate to the /opt/opennms/etc directory and execute the following command:

Most of the files are auto-merged. If any files remain, the status of each file in conflict is displayed under the section “Unmerged paths” and is marked "both modified", as shown in the following example:

For each remaining conflicted file (listed under Unmerged paths) changes that were made to the file are identified with the opening statement "<<<<<< HEAD" and closing statement ">>>>>>> opennms-auto-upgrade/pristine". For example, in the ncs-component.events.xml file shown above, the file changes are marked as follows:

Step 3: Merging Files with Conflicts

After identifying the files with conflicts, you must perform the following steps to manually merge each of the files and resolve all conflicts:

From a VI editor, open the file with conflicts.
Search for the statement "HEAD".
Identify the differences between the two configurations which are contained between the lines <<<<< HEAD and >>>>> opennms-auto-upgrade/pristine.
1. The configuration for the file before the upgrade is contained between the lines <<<<< HEAD and ========.
2. The configuration for the file after the upgrade is contained between the lines ======== and >>>>> opennms-auto-upgrade/pristine.
Save the configuration of the file after the upgrade, and then update it with any user-modified values from the configuration file before the upgrade.
After manually merging configuration file changes, remove each of the following lines from the file:
Save the configuration file.
Repeat steps 2 through 6 for each configuration file with conflicts until all file conflicts in all files are merged.
After all the file conflicts are merged, there should be no occurrence of the following lines:

Step 4: Verifying the Manual Merge Status of Configuration Files

From the Junos Space CLI, execute the following commands to verify that the configuration file changes are merged correctly:

If the file changes were merged correctly, Junos Space displays the following message:

Step 5: Final Steps After Upgrading Network Monitoring

Perform the following steps after upgrading Network Monitoring:

Update permissions of the /opt/opennms directory to 774:
Run the following command to change the ownership of the /opt/opennms directory to opennms:space:

Verify that the opennms.conf file includes the line RUNAS="opennms":

The password of the user “postgres” in the opennms-datasources.xml file will be empty. Set the password to postgres:

Start the Network Monitoring service from the Junos Space user interface:
1. Select Network Management Platform > Administration > Applications.
  The Applications page appears.
2. Right-click Network Management Platform and select Manage Services or select Network Management Platform and click Manage Services from the Actions menu.
  The Manage Services page appears.
3. Select the Network Monitoring service and click the Start Service icon.
  The Confirm Start message appears.
4. Click YES.
If your fabric is running in a multi-node setup, execute the following command to verify that all the modified configuration files are synchronized across the standby node:

ON THIS PAGE