com.ibm.tivoli.nm.collectors.framework.utils

Class CollectorValidationUtils

java.lang.Object

com.ibm.tivoli.nm.collectors.framework.utils.CollectorValidationUtils

public class CollectorValidationUtils
extends java.lang.Object

Utility class for validating collector data. Any data validation failures will result in a CollectorValidationException being thrown.

Author:

Emlyn Whittick

See Also:

CollectorValidationException

Constructor Summary

Constructors

Constructor and Description
CollectorValidationUtils()

Method Summary

Modifier and Type	Method and Description
static boolean	validateAddressData(java.util.Map<java.lang.String,java.lang.Object> addressData) Validate that the address data provided adheres to the following definition:
static boolean	validateAddresses(NetworkDevice device) Validate all address data associated with a device
static boolean	validateCollectorData(DataStore dataStore) Validate that basic collector data is present and valid
static boolean	validateConnectionData(java.util.Map<java.lang.String,java.lang.Object> connectionData) Validate that the connection data provided adheres to the following definition:
static boolean	validateData(java.util.Map<java.lang.String,java.lang.Object> data, java.util.Set<java.lang.String> validFields, java.lang.String dataType) Validate that given data contains valid fields.
static boolean	validateDataSourceData(DataSource dataSource) Validate the basic data source data is correct
static boolean	validateDeviceData(NetworkDevice device) Validate the data for a given device to ensure that both an ID and unique address (ip attribute) are present
static boolean	validateDevices(DataSource dataSource) Validate basic device data for all devices for a given data source
static boolean	validateEntityData(java.util.Map<java.lang.String,java.lang.Object> entityData) Validate that the entity data provided adheres to the following definition:
static boolean	validateGeographicData(java.util.Map<java.lang.String,java.lang.Object> data) Validate that the geographic data provided adheres to the following definition:
static boolean	validateInterfaceData(java.util.Map<java.lang.String,java.lang.Object> interfaceData) Validate that the interface data provided adheres to the following definition:
static boolean	validateInterfaceID(java.util.Map<java.lang.String,java.lang.Object> data) Validate that the data contains either an interfaceId or a numeric ifIndex attribute
static boolean	validateInterfaces(NetworkDevice device) Validate all interfaces on a given device
static boolean	validateL2VPNData(java.util.Map<java.lang.String,java.lang.Object> vpnData) Validate that the layer 2 VPN data provided adheres to the following definition:
static boolean	validateL3ConnectionData(java.util.Map<java.lang.String,java.lang.Object> connectionData) Validate that the layer 3 connection data provided adheres to the following definition:
static boolean	validateL3VPNData(java.util.Map<java.lang.String,java.lang.Object> vpnData) Validate that the layer 3 VPN data provided adheres to the following definition:
static boolean	validateL3VPNInterfaceData(java.util.Map<java.lang.String,java.lang.Object> vpnInterfaceData) Validate the L3 VPN interface data
static boolean	validateL3VPNRTData(java.lang.String routeTarget, int routeTargetType) Validate the L3 VPN route target data
static boolean	validateLSPData(java.util.Map<java.lang.String,java.lang.Object> lspData) Validate LSP Data
static boolean	validateMobileSwitchingCentreType(java.lang.String mscType) Validate whether a given mobile switching centre type is one of the expected values
static boolean	validateMPLSData(java.util.Map<java.lang.String,java.lang.Object> mplsData) Validate MPLS data
static boolean	validateRanNodeBLocalCellTechnologyType(java.lang.String technologyType) Validate whether a given RAN node B local cell technology type is one of the expected values
static boolean	validateRanTechnologyType(java.lang.String technologyType) Validate whether a given RAN cell technology type is one of the expected values
static boolean	validateRanTransceiverTechnologyType(java.lang.String technologyType) Validate whether a given RAN transceiver technology type is one of the expected values
static boolean	validateRelationshipData(java.util.Map<java.lang.String,java.lang.Object> relationshipData) Validate that the relationship data provided contains all required parameters, such as an identifier for the entity involved in the relationship, such as a device ID or entity name.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

CollectorValidationUtils

public CollectorValidationUtils()

Method Detail

validateAddressData

public static boolean validateAddressData(java.util.Map<java.lang.String,java.lang.Object> addressData)
                                   throws CollectorValidationException

Validate that the address data provided adheres to the following definition:

Attributes:

• ifIndex: Index uniquely identifying the interface within a device. Usually an RFC1213-MIB ifIndex. MUST be specified if interfaceId is not specified.
• interfaceId: A string based unique interface identifier. MUST be specified if ifIndex is not specified.
• ifOperStatus: Operational status of the interface. See RFC1213-MIB ifOperStatus for acceptable values.
• ipAddress: IP (V4) address associated with the interface

Data definition:

 
 <xs:element name="ifIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="interfaceId" type="xs:string" minOccurs="0"/>
 <xs:element name="ifOperStatus" type="xs:integer" minOccurs="1"/>
 <xs:element name="ipAddress" type="xs:string" minOccurs="1"/>
 

Parameters:

addressData - The address data to validate

Returns:

Whether or not the address data is valid

Throws:

CollectorValidationException - The data provided in the addressData map does not match the specified data definition

validateAddresses

public static boolean validateAddresses(NetworkDevice device)
                                 throws CollectorValidationException

Validate all address data associated with a device

Parameters:

device - The device on which all addresses should be validated

Returns:

Whether or not all associated address data is valid on the given device

Throws:

CollectorValidationException - One or more of the addresses are not valid as specified by validateAddressData(Map)

validateCollectorData

public static boolean validateCollectorData(DataStore dataStore)
                                     throws CollectorValidationException

Validate that basic collector data is present and valid

Parameters:

dataStore - The data store to validate

Returns:

Whether or not the data is valid and present

Throws:

CollectorValidationException - The data store is missing a collector name or one of the data sources is not valid as defined by validateDataSourceData(DataSource)

validateConnectionData

public static boolean validateConnectionData(java.util.Map<java.lang.String,java.lang.Object> connectionData)
                                      throws CollectorValidationException

Validate that the connection data provided adheres to the following definition:

Attributes:

• dest: Destination name/IP
• destIfIndex: Destination ifIndex
• destInterfaceId: String based interface identifier. - MUST be specified if destIfIndex is not specified.
• src: Source name/IP
• srcIfIndex: Source ifIndex
• srcInterfaceId: String based interface identifier. MUST be specified if srcIfIndex is not specified.
• extraInfo: (optional) Any freeform data

Data definition:

 
 <xs:element name="dest" type="xs:string" minOccurs="1"/>
 <xs:element name="destIfIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="destInterfaceId" type="xs:string" minOccurs="0"/>
 <xs:element name="src" type="xs:string" minOccurs="0"/>
 <xs:element name="srcIfIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="srcInterfaceId" type="xs:string" minOccurs="0"/>
 
 <xs:element name="extraInfo" minOccurs="0" maxOccurs="1">
 <xs:complexType>
   <xs:sequence>
     <xs:any maxOccurs="unbounded">
   </xs:sequence>
 </xs:complexType>
 </xs:element>
 

Parameters:

connectionData - The connection data to validate

Returns:

Whether or not the connection data is valid

Throws:

CollectorValidationException - The data provided in the connectionData map does not match the specified data definition

validateData

public static boolean validateData(java.util.Map<java.lang.String,java.lang.Object> data,
                                   java.util.Set<java.lang.String> validFields,
                                   java.lang.String dataType)
                            throws CollectorValidationException

Validate that given data contains valid fields. All entity data supports "customData" field.

Parameters:

data - The data (map) to validate

validFields - A list of all the valid fields for that piece of data

dataType - What kind of data we're parsing

Returns:

Whether or not all fields (keys) in the data are one of the valid fields specified

Throws:

CollectorValidationException - The data for the particular dataType as contained in the data map contains a field that is not listed as a valid field

validateDataSourceData

public static boolean validateDataSourceData(DataSource dataSource)
                                      throws CollectorValidationException

Validate the basic data source data is correct

Parameters:

dataSource - The data source to validate

Returns:

Whether or not the basic data source data is valid

Throws:

CollectorValidationException - The data source is missing an ID

validateDeviceData

public static boolean validateDeviceData(NetworkDevice device)
                                  throws CollectorValidationException

Validate the data for a given device to ensure that both an ID and unique address (ip attribute) are present

Parameters:

device - The device to validate

Returns:

Whether or not the basic device data is valid and all required data is present

Throws:

CollectorValidationException - The device data is missing a device ID or unique address

validateDevices

public static boolean validateDevices(DataSource dataSource)
                               throws CollectorValidationException

Validate basic device data for all devices for a given data source

Parameters:

dataSource - The data source for which all devices should be validated

Returns:

Whether or not all devices on the data source pass the validation criteria

Throws:

CollectorValidationException - The data source is null or one of the devices stored on the data source is not valid as defined by validateDeviceData(NetworkDevice)

validateEntityData

public static boolean validateEntityData(java.util.Map<java.lang.String,java.lang.Object> entityData)
                                  throws CollectorValidationException

Validate that the entity data provided adheres to the following definition:

Attributes applicable to both ENITY-MIB and Generic Styles:

• name: The name of the entity. If ENTITY-MIB style is used then it is the equivalent of entPhysicalName.
• descr: Entity description. If ENTITY-MIB style is used then it is the equivalent of entPhysicalDescr.
• alias: Entity alias value. If ENTITY-MIB style is used then it is the equivalent of entPhysicalAlias.
• parentRelPos: The relative position of the entity within the parent. If ENTITY-MIB style is used then it is the equivalent of entPhysicalParentRelPos.
• fwRev: Entity firmware version. If ENTITY-MIB style is used then it is the equivalent of entPhysicalFirmwareRev.
• hwRev: Entity hardware version. If ENTITY-MIB style is used then it is the equivalent of entPhysicalHardwareRev.
• swRev: Entity software version. If ENTITY-MIB style is used then it is the equivalent of entPhysicalSoftwareRev.
• serialNumber: Entity serial number. If ENTITY-MIB style is used then it is the equivalent of entPhysicalSerialNum.
• ifIndex: An optional interface index value representing the interface data associated with entity port data. Specifying this value provides fine control over how Disco associated port entity data with interface data and may improve performance.
• interfaceId: An optional interface id value representing the interface data associated with entity port data. Specifying this value provides fine control over how Disco associated port entity data with interface data and may improve performance.
• extraInfo: (optional) freeform data

Data definition applicable to both ENITY-MIB and Generic Styles:

 
 <xs:element name="name" type="xs:string" minOccurs="1"/>
 <xs:element name="descr" type="xs:string" minOccurs="0"/>
 <xs:element name="alias" type="xs:string" minOccurs="0"/>
 <xs:element name="parentRelPos" type="xs:integer" minOccurs="1"/>
 <xs:element name="fwRev" type="xs:string" minOccurs="0"/>
 <xs:element name="hwRev" type="xs:string" minOccurs="0"/>
 <xs:element name="swRev" type="xs:string" minOccurs="0"/>
 <xs:element name="serialNumber" type="xs:string" minOccurs="0"/>
 <xs:element name="ifIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="interfaceId" type="xs:string" minOccurs="0"/>
 
 <xs:element name="extraInfo" minOccurs="0" maxOccurs="1">
   <xs:complexType>
     <xs:sequence>
       <xs:any maxOccurs="unbounded">
     </xs:sequence>
   </xs:complexType>
 </xs:element>
 
 

Attributes for ENTITY-MIB Style:

• index: See ENTITY-MIB entPhysicalIndex
• class: See ENTITY-MIB entPhysicalClass
• containedIn: See ENTITY-MIB entPhysicalContainedIn
• vendorType: See ENTITY-MIB entPhysicalVendorType

Data definition for ENTITY-MIB Style:

 
 <xs:element name="index" type="xs:integer" minOccurs="1"/>
 <xs:element name="class" type="xs:string" minOccurs="1"/>
 <xs:element name="containedIn" type="xs:integer" minOccurs="1"/>
 <xs:element name="vendorType" type="xs:string" minOccurs="0"/>
 
 

Attributes for Generic Style:

• parent: The name of the parent entity
• cdmType: The enitity type (based on the CDM 'type'). Supported values are:
  • 0 - Other
  • 1 - Unknown
  • 2 - Chassis
  • 3 - Backplane
  • 4 - Slot
  • 5 - Power Supply
  • 6 - Fan
  • 7 - Sensor
  • 8 - Module
  • 9 - Port
  • 10 - Rack

Data definition for ENTITY-MIB Style:

 
 <xs:element name="parent" type="xs:string" minOccurs="1"/>
 <xs:element name="cdmType" type="xs:integer" minOccurs="1"/>
 
 

Parameters:

entityData - The entity-MIB style data to validate

Returns:

Whether or not the entity data is valid

Throws:

CollectorValidationException - The data provided in the entityData map does not match the specified data definition

validateGeographicData

public static boolean validateGeographicData(java.util.Map<java.lang.String,java.lang.Object> data)
                                      throws CollectorValidationException

Validate that the geographic data provided adheres to the following definition:

Attributes:

• locationName: Mandatory name to be assigned to a single geographic location collecting one or more devices.
• longitude: Optional longitude (based on WGS84 standard). Mandatory if latitude is supplied.
• latitude: Optional latitude (based on WGS84 standard). Mandatory if longitude is supplied.
• altitude: Optional altitude (based on WGS84 standard)
• altitudeUnits: Optional units of altitude. Mandatory if altitude is supplied. Valid values are: 'Meters', 'Kilometers', 'Centimeters', 'Feet', 'Yards', 'Miles', 'Inches'
• regionName: Optional name to be assigned to a geographic region collecting one or more geographic locations.

Parameters:

data - The geographic data to validate

Returns:

Whether or not the geographic data is valid

Throws:

CollectorValidationException - The data provided in the data map does not match the specified data definition

validateInterfaceData

public static boolean validateInterfaceData(java.util.Map<java.lang.String,java.lang.Object> interfaceData)
                                     throws CollectorValidationException

Validate that the interface data provided adheres to the following definition:

Attributes:

• ifIndex: See RFC1213 ifIndex. MUST be specified if interfaceId is not specified.
• interfaceId: A string based unique interface identifier. MUST be specified if ifIndex is not specified.
• card: Card number (with port this should uniquely identify the interface)
• port: Port number (with card this should uniquely identify the interface)
• ifOperStatus: See RFC1213 ifOperStatus
• ifAdminStatus: See RFC1213 ifAdminStatus
• ifPhysAddress: See RFC1213 ifPhysAddress
• ifDescr: See RFC1213 ifDescr
• ifName: See RFC1213 ifName
• ifType: See RFC1213 ifType
• isConnected: See RFC1213 isConnected
• ipAddress: See RFC1213 ipAdEntAddr
• netmask: Number of Host bits in the subnet
• subnet: Subnet address
• subnetMask: Subnet mask
• extraInfo: (optional) Any freeform data

Data definition:

 
 <xs:element name="ifIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="interfaceId" type="xs:string" minOccurs="0"/>
 <xs:element name="card" type="xs:integer" minOccurs="0"/>
 <xs:element name="port" type="xs:integer" minOccurs="0"/>
 <xs:element name="ifOperStatus" type="xs:integer" minOccurs="0"/>
 <xs:element name="ifAdminStatus" type="xs:integer minOccurs="0""/>
 <xs:element name="ifPhysAddress" type="xs:integer" minOccurs="0"/>
 <xs:element name="ifDescr" type="xs:string" minOccurs="0"/>
 <xs:element name="ifName" type="xs:string" minOccurs="0"/>
 <xs:element name="ifType" type="xs:integer" minOccurs="0"/>
 <xs:element name="isConnected" type="xs:integer" minOccurs="0"/>
 <xs:element name="ipAddress" type="xs:string" minOccurs="0"/>
 <xs:element name="netmask" type="xs:integer" minOccurs="0"/>
 <xs:element name="subnet" type="xs:string" minOccurs="0"/>
 <xs:element name="subnetMask" type="xs:string" minOccurs="0"/>
 
 <xs:element name="extraInfo" minOccurs="0" maxOccurs="1">
   <xs:complexType>
     <xs:sequence>
       <xs:any maxOccurs="unbounded">
     </xs:sequence>
   </xs:complexType>
 </xs:element>
 
 

Parameters:

interfaceData - Map of data for an interface

Returns:

Whether or not the fields are valid

Throws:

CollectorValidationException - The data provided in the interfaceData map does not match the specified data definition

validateInterfaceID

public static boolean validateInterfaceID(java.util.Map<java.lang.String,java.lang.Object> data)
                                   throws CollectorValidationException

Validate that the data contains either an interfaceId or a numeric ifIndex attribute

Parameters:

data - The data to validate

Returns:

Whether or not the map contains either an interfaceId or ifIndex attribute

Throws:

CollectorValidationException - The data provided does not have a String field interfaceId or an integer field ifIndex

validateInterfaces

public static boolean validateInterfaces(NetworkDevice device)
                                  throws CollectorValidationException

Validate all interfaces on a given device

Parameters:

device - The network device containing the interfaces

Returns:

Whether or not the interface data is valid

Throws:

CollectorValidationException - One or more of the interface data entries is invalid as specified by validateInterfaceData(Map)

validateL2VPNData

public static boolean validateL2VPNData(java.util.Map<java.lang.String,java.lang.Object> vpnData)
                                 throws CollectorValidationException

Validate that the layer 2 VPN data provided adheres to the following definition:

Attributes:

• vpnName: Name of the VPN
• vcId: Circuit Id
• vcType: 0=invalid, 1= framerelay, 2=atm aal5 vcc, 3=atm trans, 4=vlan, 5=Ethernet, 6=hdlc, 7=ppp, 8=cep, 9=atm vcc, 10=atm vpl, 11 vpls
• peerIp: IP address of remote device
• peerIfIndex: Remote interface connected to the service MUST be specified if peerInterfaceid is not specified.
• peerInterfaceId: String based interface identifier. An alternative to peerIfIndex for non-IfIndex supporting devices. MUST be specified if peerIfIndex is not specified.
• localIfIndex: Local interface connected to the service MUST be specified if localInterfaceid is not specified.
• localInterfaceId: String based interface identifier. An alternative to localIfIndex for non-IfIndex supporting devices. MUST be specified if localIfIndex is not specified.
• status: 0=unknown, 1=down, 2=up
• topologyType: 0=invalid, 1=other, 2=bgp ip, 3=bgp layer 2, 4=bgp vpls. 5=l2 circuit, 6=ldp vpls, 7=optical, 8=vp ocx, 9=ccc, 10=atm
• localLabel: Label imposed for local->remote LSP
• peerLabel: Label imposed for remote->local LSP
• extraInfo: (optional) Any freeform data

Data definition:

 
 <xs:element name="vpnName" type="xs:string" minOccurs="1"/>
 <xs:element name="vcId" type="xs:string" minOccurs="1"/>
 <xs:element name="vcType" type="xs:integer" minOccurs="1"/>
 <xs:element name="peerIp" type="xs:string" minOccurs="0"/>
 <xs:element name="peerIfIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="peerInterfaceId" type="xs:string" minOccurs="0"/>
 <xs:element name="localIfIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="localInterfaceId" type="xs:string" minOccurs="0"/>
 <xs:element name="status" type="xs:integer" minOccurs="0"/>
 <xs:element name="topologyType" type="xs:integer" minOccurs="0"/>
 <xs:element name="localLabel" type="xs:integer" minOccurs="1"/>
 <xs:element name="peerLabel" type="xs:integer" minOccurs="1"/>
 
 <xs:element name="extraInfo" minOccurs="0" maxOccurs="1">
   <xs:complexType>
     <xs:sequence>
       <xs:any maxOccurs="unbounded">
     </xs:sequence>
   </xs:complexType>
 </xs:element>
 

Parameters:

vpnData - The Layer 2 VPN data to validate

Returns:

Whether or not the layer 2 VPN data is valid

Throws:

CollectorValidationException - The data provided in the vpnData map does not match the specified data definition

validateL3ConnectionData

public static boolean validateL3ConnectionData(java.util.Map<java.lang.String,java.lang.Object> connectionData)
                                        throws CollectorValidationException

Validate that the layer 3 connection data provided adheres to the following definition:

Attributes:

• dest: Destination name/IP
• destIfIndex: Destination ifIndex
• destInterfaceId: String based interface identifier. - MUST be specified if destIfIndex is not specified.
• src: Source name/IP
• srcIfIndex: Source ifIndex
• srcInterfaceId: String based interface identifier. MUST be specified if srcIfIndex is not specified.
• extraInfo: (optional) Any freeform data

Data definition:

 
 <xs:element name="dest" type="xs:string" minOccurs="1"/>
 <xs:element name="destIfIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="destInterfaceId" type="xs:string" minOccurs="0"/>
 <xs:element name="src" type="xs:string" minOccurs="0"/>
 <xs:element name="srcIfIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="srcInterfaceId" type="xs:string" minOccurs="0"/>
 
 <xs:element name="extraInfo" minOccurs="0" maxOccurs="1">
   <xs:complexType>
     <xs:sequence>
       <xs:any maxOccurs="unbounded">
     </xs:sequence>
   </xs:complexType>
 </xs:element>
 

Parameters:

connectionData - The layer 3 connection data to validate

Returns:

Whether or not the connection data is valid

Throws:

CollectorValidationException - The data provided in the connectionData map does not match the specified data definition

validateL3VPNData

public static boolean validateL3VPNData(java.util.Map<java.lang.String,java.lang.Object> vpnData)
                                 throws CollectorValidationException

Validate that the layer 3 VPN data provided adheres to the following definition:

Attributes:

• vpnName: VPN name
• vrfName: VRF supporting the VPN
• rd: Route distinguisher
• descr: VPN description
• status: VPN status
• importRTs: Imported route targets
• exportRTs: Exported route targets
• interfaces: Associated intefaces (CE facing)
• extraInfo: (optional) freeform data

Data definition:

 
 <xs:element name="vpnName" type="xs:string" minOccurs="0"/>
 <xs:element name="vrfName" type="xs:string" minOccurs="1"/>
 <xs:element name="rd" type="xs:string" minOccurs="1"/>
 <xs:element name="descr" type="xs:string" minOccurs="0"/>
 <xs:element name="status" type="xs:integer" minOccurs="0"/>
 <xs:element name="importRTs" minOccurs="1">
   <xs:complexType>
     <xs:sequence>
       <xs:element name="rt" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
     </xs:sequence>
   </xs:complexType>
 </xs:element>
 <xs:element name="exportRTs" minOccurs="1">
   <xs:complexType>
     <xs:sequence>
       <xs:element name="rt" type="xs:string" minOccurs="0" maxOccurs="unbounded" />
     </xs:sequence>
   </xs:complexType>
 </xs:element>
 

Parameters:

vpnData - The Layer 3 VPN data to validate

Returns:

Whether or not the layer 3 VPN data is valid

Throws:

CollectorValidationException - The data provided in the vpnData map does not match the specified data definition

validateL3VPNInterfaceData

public static boolean validateL3VPNInterfaceData(java.util.Map<java.lang.String,java.lang.Object> vpnInterfaceData)
                                          throws CollectorValidationException

Validate the L3 VPN interface data

Attributes:

• ifIndex: MUST be specified if interfaceId is not specified.
• interfaceId: A string based unique interface identifier. MUST be specified if ifIndex is not specified.
• ceIp: Address of CE connected to ifIndex
• protocol: extual description of PE-CE protocol
• customerName: Customer name
• customerDescr: Customer description

Data definition:

 
 <xs:element name="ifIndex" type="xs:integer" minOccurs="0"/>
 <xs:element name="interfaceId" type="xs:string" minOccurs="0"/>
 <xs:element name="ceIp" type="xs:string" minOccurs="0"/>
 <xs:element name="protocol" type="xs:string" minOccurs="0"/>
 <xs:element name="customerName" type="xs:string" minOccurs="0"/>
 <xs:element name="customerDescr" type="xs:string" minOccurs="0"/>
 
 <xs:element name="extraInfo" minOccurs="0" maxOccurs="1">
   <xs:complexType>
     <xs:sequence>
       <xs:any maxOccurs="unbounded">
     </xs:sequence>
   </xs:complexType>
 </xs:element>
 
 

Parameters:

vpnInterfaceData - The L3 VPN interface data to validate

Returns:

Whether or not the interface data is valid

Throws:

CollectorValidationException - The data provided in the vpnInterfaceData map does not match the specified data definition

validateL3VPNRTData

public static boolean validateL3VPNRTData(java.lang.String routeTarget,
                                          int routeTargetType)
                                   throws CollectorValidationException

Validate the L3 VPN route target data

Parameters:

routeTarget - The route target

routeTargetType - The route target type - 1, 2 or 3

Returns:

Whether or not the route target data is valid

Throws:

CollectorValidationException - The route target type is not one of the expected values (1, 2 or 3)

validateLSPData

public static boolean validateLSPData(java.util.Map<java.lang.String,java.lang.Object> lspData)
                               throws CollectorValidationException

Validate LSP Data

Parameters:

lspData - The LSP data to validate

Returns:

Whether or not the LSP data is valid

Throws:

CollectorValidationException - The data provided in the lspData does not have both a source name (src) or a destination name (dest) attribute

validateMobileSwitchingCentreType

public static boolean validateMobileSwitchingCentreType(java.lang.String mscType)
                                                 throws CollectorValidationException

Validate whether a given mobile switching centre type is one of the expected values

Parameters:

mscType - The mobile switching centre type to validate

Returns:

Whether or not the mobile switching centre type is valid

Throws:

CollectorValidationException - The mobile switching centre type is not one of the expected values

validateMPLSData

public static boolean validateMPLSData(java.util.Map<java.lang.String,java.lang.Object> mplsData)
                                throws CollectorValidationException

Validate MPLS data

Parameters:

mplsData - The MPLS data to validate

Returns:

Whether or not the MPLS data is valid

Throws:

CollectorValidationException - The data provided in the mplsData map does not have an interface ID (ifIndex or interfaceId) attribute

validateRanNodeBLocalCellTechnologyType

public static boolean validateRanNodeBLocalCellTechnologyType(java.lang.String technologyType)
                                                       throws CollectorValidationException

Validate whether a given RAN node B local cell technology type is one of the expected values

Parameters:

technologyType - The RAN node B local cell technology type to validate

Returns:

Whether or not the technology type is valid

Throws:

CollectorValidationException - The RAN node B local cell technology type is not one of the expected values

validateRanTechnologyType

public static boolean validateRanTechnologyType(java.lang.String technologyType)
                                         throws CollectorValidationException

Validate whether a given RAN cell technology type is one of the expected values

Parameters:

technologyType - The RAN technology type to validate

Returns:

Whether or not the technology type is valid

Throws:

CollectorValidationException - The RAN cell technology type is not one of the expected values

validateRanTransceiverTechnologyType

public static boolean validateRanTransceiverTechnologyType(java.lang.String technologyType)
                                                    throws CollectorValidationException

Validate whether a given RAN transceiver technology type is one of the expected values

Parameters:

technologyType - The RAN transceiver technology type to validate

Returns:

Whether or not the technology type is valid

Throws:

CollectorValidationException - The RAN transceiver technology type is not one of the expected values

validateRelationshipData

public static boolean validateRelationshipData(java.util.Map<java.lang.String,java.lang.Object> relationshipData)
                                        throws CollectorValidationException

Validate that the relationship data provided contains all required parameters, such as an identifier for the entity involved in the relationship, such as a device ID or entity name. The relationshipData map must contain enough information to identify the related entity, namely:

• A device ID (m_DeviceId) or entity name (m_EntityName)
• Optionally, one (and only one) of: an interface identifier (m_InterfaceId or m_IfIndex), or a transceiver ID (m_TrxId)

Parameters:

relationshipData - The relationship data to validate

Returns:

Whether or not the relationship data is valid

Throws:

CollectorValidationException