Package org.opennms.upgrade.implementations

Class SnmpInterfaceRrdMigratorOnline

  • All Implemented Interfaces:
    OnmsUpgrade
    public class SnmpInterfaceRrdMigratorOnline
extends AbstractOnmsUpgrade
    The Class RRD/JRB Migrator for SNMP Interfaces Data (Online Version)

    1.12 always add the MAC Address to the snmpinterface table if exist, which is different from the 1.10 behavior. For this reason, some interfaces are going to appear twice, and the data must be merged.

    This tool requires that OpenNMS 1.12 is running for a while to be sure that all the MAC addresses have been updated, and the directories already exist.

    Issues fixed:

    • NMS-6056
    Author:
    Alejandro Galue

    • Constructor Detail

      • SnmpInterfaceRrdMigratorOnline

        public SnmpInterfaceRrdMigratorOnline()
                               throws OnmsUpgradeException
        Instantiates a new SNMP interface RRD migrator online.
        Throws:
        OnmsUpgradeException - the OpenNMS upgrade exception

    • Method Detail

      • getOrder

        public int getOrder()
        Description copied from interface: OnmsUpgrade
        Gets the order.

        In order to execute all the implementations of this interface on a specify order, each implementation must return an integer for this purpose.

        Returns:
        the order

      • getDescription

        public String getDescription()
        Description copied from interface: OnmsUpgrade
        Gets the description.

        This is for informational purposes, and should contain a brief description about what is the purpose of this upgrade class.

        Returns:
        the description

      • requiresOnmsRunning

        public boolean requiresOnmsRunning()
        Description copied from interface: OnmsUpgrade
        Requires OpenNMS running.
        Returns:
        true, if OpenNMS must be running to execute this upgrade or false if OpenNMS must be stopped.

      • preExecute

        public void preExecute()
                throws OnmsUpgradeException
        Description copied from interface: OnmsUpgrade
        Pre-execute

        Runs some checks to ensure that what it would execute() would work. If something is missing, an exception will be thrown

        Execute backups of the JRBs/RRDs if they are going to be modified.

        Throws:
        OnmsUpgradeException - the OpenNMS upgrade exception

      • postExecute

        public void postExecute()
                 throws OnmsUpgradeException
        Description copied from interface: OnmsUpgrade
        Post execute.

        Runs some clean up tasks after executing the execute() method. If something is wrong, an exception will be thrown

        Throws:
        OnmsUpgradeException - the OpenNMS upgrade exception

      • rollback

        public void rollback()
              throws OnmsUpgradeException
        Description copied from interface: OnmsUpgrade
        Rollback.

        Restore the initial state of the OpenNMS files if something went wrong while running the execute() method.

        Must restore the backups of the files if necessary.

        Throws:
        OnmsUpgradeException - the onms upgrade exception

      • execute

        public void execute()
             throws OnmsUpgradeException
        Description copied from interface: OnmsUpgrade
        Execute.

        This is the main method, and this is the one where all the upgrade code must be placed.

        Throws:
        OnmsUpgradeException - the OpenNMS upgrade exception

      • merge

        protected void merge​(File oldDir,
                     File newDir)
              throws Exception
        Merge.
        Parameters:
        oldDir - the old directory
        newDir - the new directory
        Throws:
        Exception - the exception

      • mergeRrd

        protected void mergeRrd​(File source,
                        File dest)
                 throws Exception
        Merge RRDs.
        Parameters:
        source - the source RRD
        dest - the destination RRD
        Throws:
        Exception - the exception

      • mergeJrb

        protected void mergeJrb​(File source,
                        File dest)
                 throws Exception
        Merge JRBs.
        Parameters:
        source - the source JRB
        dest - the destination JRB
        Throws:
        Exception - the exception

      • getNodeDirectory

        protected File getNodeDirectory​(int nodeId,
                                String foreignSource,
                                String foreignId)
        Gets the node directory.
        Parameters:
        nodeId - the node id
        foreignSource - the foreign source
        foreignId - the foreign id
        Returns:
        the node directory