Install an OpenWay Riva Routing Node Mesh Node Base

The OpenWay Riva Routing Node Mesh Node Base (RN-MNB) is the range extender supported in an OpenWay Riva mesh network. It is a piece of network infrastructure that allows the network to extend its coverage by relaying messages from one node to another. In this respect it is very similar to an electric meter in a mesh network, except it does not provide any metering capability. Therefore, in the MDI file it is treated as a non-metering device.

This scenario describes the MDI file requirements for installing an RN-MNB at a service point. This MDI installation file is not required for the RN-MNB to function as a network relay and to send events to Collection Manager. The MDI file is needed however if applications such as Collection Manager and Performance Manager wish to track installation data and visualize the RN-MNB on a map. This can aid in network troubleshooting.

In the XML file, a new service point record is created. A relationship is created between the RN-MNB and the service point at the time set in the DeviceLinkRange element's Start attribute.

In the field, a new RN-MNB is installed at the service point location.

Source of the MDI file

• CIS
• MDM
• For Itron Analytics, the MDI file should always come from OpenWay Operations Center - Collection Manager.

Elements and attributes

For information about the use of special characters, see Special characters.

The following table shows the elements and attributes included in the XML sample.

• Required = This element/attribute is required for this specific scenario. It may not be required in other scenarios.
• Recommended = Itron recommends that you use this element/attribute in this particular scenario.
• Optional = This element/attribute is optional for this scenario and is only required if you want a specific outcome described in the element/attribute definition. To see the element/attribute description, click on the element/attribute in the table or in the XML sample.
• Blank = The application does not use this element and any value in it will be ignored.

Element	Attribute/child element	Collection Manager	Performance Manager	Itron Analytics	Operations Optimizer
SetServicePoint		Required	Required	Required	Required
	ServicePointId	Required	Required Note: This is used to anchor the device to a known point at the time of installation.	Required	Required
	PrimaryCollectionSystem
	PremiseId		Required
	ServicePointStatus			Required	Required
	TimeZone		Required	Required	Required
Address		Recommended		Recommended	Recommended
	StreetAddress	Optional	Optional	Recommended	Recommended
	City	Optional	Optional	Recommended	Recommended
	State	Optional	Optional	Recommended	Recommended
	Zip	Optional	Optional	Recommended	Recommended
	Country			Optional	Optional
	Latitude	Optional	Required	Recommended	Recommended
	Longitude	Optional	Required	Recommended	Recommended
SetNonMeteringDevice		Required	Required
	ChannelNumber	Required (set to 1)	Required (set to 1)	Required. At least one channel must be configured for auto-channel creation. Set the ChannelNumber value to 1 when creating a dummy channel. For more information, see Auto-channel creation.	Required. At least one channel must be configured for auto-channel creation. Set the ChannelNumber value to 1 when creating a dummy channel. For more information, see Auto-channel creation.
	DeviceType	Required	Required	Required	Required
	DeviceId	Required	Required	Required	Required
DeviceLinkRange		Required if the SetDevice element is included in the file.	Required if the SetDevice element is included in the file.	Required if the SetDevice element is included in the file.	Required if the SetDevice element is included in the file.
	Start	Optional	Optional	Optional	Optional
	End	Required if the SetDevice element is included in the file.	Required if the SetDevice element is included in the file.	Required if the SetDevice element is included in the file.	Required if the SetDevice element is included in the file.
ApplicationGroups		Optional	Optional	Optional	Optional
ApplicationGroup		Required when the ApplicationGroups element is included in the MDI file.	Required when the ApplicationGroups element is included in the MDI file.	Required when the ApplicationGroups element is included in the MDI file.	Required when the ApplicationGroups element is included in the MDI file.
	Name	Required when the ApplicationGroups element is included in the MDI file.	Required when the ApplicationGroups element is included in the MDI file.	Required when the ApplicationGroups element is included in the MDI file.	Required when the ApplicationGroups element is included in the MDI file.
SetServicePointGroup		Optional
	GroupId	Optional
	GroupType	Optional

XML sample

<?xml version="1.0" encoding="UTF-8"?>
<MasterDataImport 
	xmlns = "http://www.itron.com/masterdata/2013/03" 
	xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance" 
	xmlns:xsd = "http://www.w3.org/2001/XMLSchema"> 
	<SetServicePoint 
		ServicePointId = "RNMNB1" 
		PrimaryCollectionSystem = "OpenWayRiva" 
		PremiseId = "RNMNBPremise1" 
		ServicePointStatus = "Active" 
		TimeZone = "EasternUS" 
		CommodityType = "Other" 
		EquipmentType = "Repeater"> 
		<Address
			StreetAddress = "4404 N Bland Rd" 
			City = "Raleigh" 
			State = "NC" 
			Zip = "27609" 
			Country = "US" 
			Latitude = "35.84071" 
			Longitude = "-78.61531"/> 
		<SetNonMeteringDevice 
			ChannelNumber = "1" 
			DeviceType = "292" 
			DeviceId = "2.16.840.1.114416.14.510"> 
			<DeviceLinkRange
				End = "EOT" 
				Start = "2018-01-26T09:32:03Z"/> 
			<ApplicationGroups> 
				<ApplicationGroup 
					Name = "AppGrp_MNB"/> 
			</ApplicationGroups> 
		</SetNonMeteringDevice> 
		<SetServicePointGroup 
			GroupId = "RNMNBSector" 
			GroupType = "Sector" 
			GroupName = "RNMNBSector"/> 
	</SetServicePoint> 
</MasterDataImport>