Swap an OpenWay Riva Routing Node ERT Gateway Star

This section explains how to create an MDI file when replacing an OpenWay Riva Routing Node ERT Gateway (RN-EGS) Star with a new one. In this scenario, an existing device is being removed from a service point and a new one is being installed.

In the XML file, the relationship between the existing RN-EGS device and the service point is ended at the time set in the DeviceLinkRange element's Start attribute. The new RN-EGS device's relationship with the service point begins at the same time set in this Start attribute. Because this scenario describes replacing an existing device, the MDI only needs to include the information that is specific to the new device.

Important! When a swap is performed to replace only the device (and not the meter), the elements in the SetDevice element that are not specified will not be retained in the OpenWay Operations Center Collection Manager for the new device. For example, if the ApplicationsGroups sub element was assigned under the original device's SetDevice element but is not specified under the new device's SetDevice element, then the device will not appear in an application group.

In the field, the old RN-EGS device is uninstalled from the service point location and the new RN-EGS device is installed.

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
SetNonMeteringDevice		Required	Required	Required	Required
	ChannelNumber	Required		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
	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.

XML sample

<?xml version="1.0" encoding="utf-8"?>
<MasterDataImport
	xmlns:xsd = "http://www.w3.org/2001/XMLSchema"
	xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance"
	xmlns = "http://www.itron.com/masterdata/2013/03">
	<SetServicePoint
		ServicePointId = "RNEGSSP_445">					
		<SetNonMeteringDevice
			ChannelNumber="1"
			DeviceId="2.16.840.1.114416.18.610"
			DeviceType="293">
			<DeviceLinkRange
				Start="2018-01-26T09:32:03Z"
				End="EOT"/>
			<ApplicationGroups>
				<ApplicationGroup
					Name = "IDC_AppGrp_Gas"/>
			</ApplicationGroups>
		</SetNonMeteringDevice>		
	</SetServicePoint>
</MasterDataImport>