Debugging issues with DCE DDF files in EcoStruxure IT Advisor

[EcoStruxureIT]

Terminology

ITA: EcoStruxure IT Advisor

DCE: Data Center Expert

Device: A physical piece of equipment that we monitor, for example, power, temperature or humidity on.

Sensor: A measuring entity for a device, for example current on phase L1, return air humidity.

Measurement: A specific measurement for a sensor, has a timestamp.

Sensor Mapping (ITA): For power distribution devices there is a feature in ITA where you can take a specific sensor and say which circuit that sensor monitors. This is called sensor mapping
and is not the same as what happens in the DDF files.

Typical steps to verify that the DDF is correct

1. Verify if the device shows up in EcoStruxure IT

Go to Planning > Device Association > Unassociated Devices.

If the devices do not appear in IT Advisor, check the following:
- Verify that the external system configuration points to the correct Data Center Expert server.
- Verify that the device is in Data Center Expert, and verify that you can see the devices using the DCE web services.
- The device types that ITA does not understand are shown with type 'Unknown'. See DCE Sensor Mapping to ITA

2. Verify that temperature and humidity sensors are shown in ITA

The sensors are listed underneath each devices in the Unassociated Devices view. It is not necessary to associate the device to see the temperature and humidity sensors.

ITA_Temperature_sensor_360006791257.png

Only temperature and humidity sensors that have a sensor type in the list below are recognized by ITA.
Temperature sensor types:
EXTERNAL_TEMPERATURE
SUPPLY_AIR_TEMPERATURE
RETURN_AIR_TEMPERATURE
INTEGRATED_TEMPERATURE
RACK_INLET_TEMPERATURE
UNIT_TEMPERATURE

Humidity sensor types:
EXTERNAL_HUMIDITY
SUPPLY_AIR_HUMIDITY
RETURN_AIR_HUMIDITY
INTEGRATED_HUMIDITY
UNIT_HUMIDITY

Note

Normally when you associate a device from the unassociated devices view, the device disappears from the list. The devices however remain in the list if it has related temperature or humidity sensors as they are shown as children in the tree structure.

Note

Temperature and humidity sensors are only shown when the 'Retrieve sensors' checkbox on the second page in the configuration wizard is checked.

ITA_Temperature_sensor_2_360006791257.png

3. Verify that power and amps measurements are shown in ITA

On the device of interest, right-click and choose 'Properties'. In the properties dialogue, unfold the External Systems entry and select the Device subpage.

ITA_Device_properties_360006791257.png

The power and amps measurements should show here. It is not necessary to associate the device to see if the power and amps measurements are recognized.

ITA_Measurement_property_page_360006791257.png

For the measurements to show a number of requirements must be satisfied:

• The DDF file must list the InputPhaseCount and OutputPhaseCount, and they are expected to be the same. Furthermore the BankCount is also needed in some cases.
• The following power sensors are recognised by ITA: 
  • OUTPUT_POWER_WATTS
  • OUTPUT_POWER_TOTAL_WATTS
  • MODULE_OUTPUT_POWER
  • MODULE_BREAKER_POWER
• The following amp sensors are recognized by ITA: 
  • MODULE_BREAKER_CURRENT
  • OUTPUT_CURRENT
  • OUTPUT_CURRENT_TOTAL
  • INPUT_CURRENT
• Make sure that the DDF adheres to the following table

ISXCDevice - Supplemental

ISXCSensor

PhaseCount	BankCount	Index	SensorType	Device example
1	1	Ignored	OUTPUT_POWER_TOTAL_WATTS	rack PDU
1	>1	1 digit = Bank number	OUTPUT_POWER_WATTS	rack PDU with banks
1	-	Ignored	OUTPUT_POWER_TOTAL_WATTS
3	1	1 digit = Bank number	OUTPUT_POWER_WATTS	UPS or (RM)PDU
3	>1	2 digit = Module, Phase	MODULE_OUTPUT_POWER	Modular PDU
3	-	1 digit = Bank number	OUTPUT_POWER_WATTS

 

Example list of power sensors and how ITA understands them

Single phase rack PDU or phase-phase rack PDU, with one bank (PhaseCount: 1, BankCount: 1):

Index	SensorType	Interpretation by ITA
Ignored	OUTPUT_POWER_TOTAL_WATTS	The total power measurement for the rack pdu

Single phase rack PDU or phase-phase rack PDU, with three banks (PhaseCount: 1, BankCount: 3):

Index	SensorType	Interpretation by ITA
1	OUTPUT_POWER_WATTS	The power measurement for the rack pdu's bank 1
2	OUTPUT_POWER_WATTS	The power measurement for the rack pdu's bank 2
3	OUTPUT_POWER_WATTS	The power measurement for the rack pdu's bank 3
Ignored	OUTPUT_POWER_TOTAL_WATTS	Total measurement for the rack pdu

Three phase rack PDU, with one bank (PhaseCount: 3, BankCount: 1):

Index	SensorType	Interpretation by ITA
1	OUTPUT_POWER_WATTS	The power measurement for the rack pdu's bank 1
2	OUTPUT_POWER_WATTS	The power measurement for the rack pdu's bank 2
3	OUTPUT_POWER_WATTS	The power measurement for the rack pdu's bank 3

 Modular PDU (PhaseCount: 3, BankCount: 3):

Index	SensorType	Interpretation by ITA
1.1	MODULE_OUTPUT_POWER	The power measurement for module 1, phase 1
1.2	MODULE_OUTPUT_POWER	The power measurement for module 1, phase 2
1.3	MODULE_OUTPUT_POWER	The power measurement for module 1, phase 3
2.1	MODULE_OUTPUT_POWER	The power measurement for module 2, phase 1
2.2	MODULE_OUTPUT_POWER	The power measurement for module 2, phase 2
2.3	MODULE_OUTPUT_POWER	The power measurement for module 2, phase 3