Using Data-Driven Web Services › Change the Primary IP Address On a Monitored Device

Change the Primary IP Address On a Monitored Device

As an administrator, you want your monitored devices to maintain consistent data, even if the IP address on a device changes. If the IP address on the device changes and you do not update it, a subsequent discovery can create a new monitored device.

Consider the following information before you change the primary IP address:

• If a device has a DNS hostname, when the IP address changes and the old IP address is no longer reachable, the Data Collector instance that monitors the device performs reverse hostname lookup to find and set the device item with the new IP address.
• If you change the primary IP address of a device to an IP address that another devices uses, an error message displays.

Note: If the primary IP address on a monitored device changes, an event is generated on the device.

To change the primary IP address on a monitored device, open a REST client editor or HTTP tool and enter the following criteria:

• URL: http://hostname:port/rest/devices/deviceitemID

  hostname:port

  Specifies the Data Aggregator host name and the port number.

  Default port: 8581

  deviceitemID

  Is the device item identification number for the monitored device for which you are changing the primary IP address.

  Note: An error is returned if you change the IP address to the IP address of an existing monitored device.

• HTTP method: PUT
• Enter the changed primary IP address in the Body tab of the HTTP Request pane.

  For example:

  <Device version="1.0.0">
        <PrimaryIPAddress>IP</PrimaryIPAddress>
  </Device>
  

  IP

  Is the changed primary IP address.

Example: In this example, you change the primary IP address on a monitored device to 1.2.3.4:

<Device version="1.0.0">

      <PrimaryIPAddress>1.2.3.4</PrimaryIPAddress>

</Device>