Smarts NCM/VoyenceControl: What is a custompackage change? How do I make a custompackage change?

Products

• VMware Smart Assurance

Environment

VMware Smart Assurance - NCM

Resolution

What is a custompackage change in Smarts Network Configuration Manager (Smarts NCM)/VoyenceControl?
How do I make a custompackage change?

What is a custompackage change?

The Smarts NCM/VoyenceControl device server architecture allows local customizations to device drivers and control/data files in a directory separate from the distribution directory.  This enables customers to create modified versions of these files without altering the files distributed with the product. 

By creating copies of the distributed files and making modifications to the copies, customers are insulated from the possibility of having their customizations overwritten during the application of maintenance or future product releases.  This feature is provided through the use of a custompackage directory, which can be searched prior to the device driver package directory distributed with the software. Device drivers or control files found in the custompackage directory take precedence over the same files found in the package directory; if they are absent, the system defaults to using the files from the device driver package directory.

Officially released hot fixes, DSRs, and other driver components will always be installed in the package directory, not in the custompackage directory.

How do I make a custompackage change?

To make a custompackage change, you must duplicate all directory structure and copy the original file you wish to modify under the custompackage directory.

For example:

You need to add a filter to the Cisco IOS Router driver to ignore a particular line when checking synchronization between startup and running configs.  The original file is located at $VOYENCE_HOME/package/pkgxml/CiscoIOSRouter/CiscoIOSRouter.pkg.

1. Copy or create the file(s) and directory structure from the $VOYENCE_HOME/package directory to the $VOYENCE_HOME/custompackage directory:
   
   mkdir $VOYENCE_HOME/custompackage/pkgxml
   mkdir $VOYENCE_HOME/custompackage/pkgxml/CiscoIOSRouter
   cp $VOYENCE_HOME/package/pkgxml/CiscoIOSRouter/CiscoIOSRouter.pkg $VOYENCE_HOME/custompackage/pkgxml/CiscoIOSRouter/CiscoIOSRouter.pkg
   
    
2. Make changes to the file under custompackage.
   
    
3. As root, restart the voyence service to recompile the drivers with your changes (not always necessary, but required more often than not).
   
   /etc/init.d/voyence restart
    

Additional Information

More details on custompackage changes can be found in $VOYENCE_HOME/package/customizationREADME.txt
$VOYENCE_HOME refers to the installation directory of VoyenceControl.  By default this is /opt/voyence or C:\Program Files\VoyenceControl.