DCO uses the standard web services to query Data Center Expert for device and sensor related data.

Device Information

To get device information, this information from the DCE web interface /integration/services/ISXCentralDeviceService_v2_0?wsdl is used:

<xsd:complexType name="ISXCDevice"> <xsd:sequence> <xsd:element name="ISXCNamedElement" nillable="true" type="ns2:ISXCNamedElement"/> <xsd:element name="ISXCCommState" nillable="true" type="ns2:ISXCCommState"/> <xsd:element name="ISXCDeviceType" nillable="true" type="ns2:ISXCDeviceType"/> <xsd:element minOccurs="0" name="hostName" nillable="true" type="xsd:string"/> <xsd:element minOccurs="0" name="ipAddress" nillable="true" type="xsd:string"/> <xsd:element name="location" nillable="true" type="xsd:string"/> <xsd:element minOccurs="0" name="modelName" nillable="true" type="xsd:string"/> <xsd:element minOccurs="0" name="modelNumber" nillable="true" type="xsd:string"/> <xsd:element name="parentID" nillable="true" type="xsd:string"/> <xsd:element minOccurs="0" name="serialNumber" nillable="true" type="xsd:string"/> <xsd:element name="ISXCDeviceState" nillable="true" type="ns2:ISXCDeviceState"/> <xsd:element minOccurs="0" name="supplemental" nillable="true" type="xsd:string"/> </xsd:sequence> <xsd:attribute name="isPrivate" type="xsd:boolean"/> </xsd:complexType>

Note The supplemental string is mandatory to understand the nature of the device. For example, for power related devices, phase and bank information is present in the supplemental string used in DCO to create an object of the device. Example of  PDU with 1 phase and 2 banks: <ns2:supplemental>InputPhaseCount="1";OutputPhaseCount="1";BankCount="2"</ns2:supplemental>

Sensor Information

A number of sensors are also used from the DCE web service interface /integration/services/ISXCentralSensorService_v2_0?wsdl

To create an object to be used for the sensors, use:

Note Index is being used to identify which module and phase are reporting data. That means index must be unique across sensorType on a given device It is NOT allowed to have e.g. 2 sensors of the same sensorType reporting same index. For example a single phase rack PDU with 2 banks and reporting phase information as well. Same sensorType having same index: This is NOT allowed <ns2:ISXCElementType>SENSOR</ns2:ISXCElementType> <ns2:id>B717125_nbSNMPEncEC23C4AA_RPDU_OUTPUT_POWER_BANK_1</ns2:id> <ns2:index>1</ns2:index> <ns2:ISXCSensorType>OUTPUT_POWER_WATTS</ns2:ISXCSensorType> <ns2:ISXCElementType>SENSOR</ns2:ISXCElementType> <ns2:id>B717125_nbSNMPEncEC23C4AA_RPDU_PHASE_OUTPUT_POWER_1</ns2:id> <ns2:index>1</ns2:index> <ns2:ISXCSensorType>OUTPUT_POWER_WATTS</ns2:ISXCSensorType> To get the above example right, the phase output power should be reported as OUTPUT_POWER_TOTAL_WATTS (which does not use index). Single phase devices with no banks should only use the OUTPUT_POWER_TOTAL_WATTS sensorType.

From the ISXCSensorType, a subset of the sensors are mapped in DCO for temperature, humidity, and power.

Temperature Sensors

EXTERNAL_TEMPERATURE

SUPPLY_AIR_TEMPERATURE

RETURN_AIR_TEMPERATURE

INTEGRATED_TEMPERATURE

RACK_INLET_TEMPERATURE

UNIT_TEMPERATURE

Humidity Sensors

EXTERNAL_HUMIDITY

SUPPLY_AIR_HUMIDITY

RETURN_AIR_HUMIDITY

INTEGRATED_HUMIDITY

UNIT_HUMIDITY

Power Sensors

OUTPUT_POWER_WATTS

OUTPUT_POWER_TOTAL_WATTS

MODULE_OUTPUT_POWER or MODULE_BREAKER_POWER

Amp Sensors:

MODULE_BREAKER_CURRENT

OUTPUT_CURRENT

OUTPUT_CURRENT_TOTAL

INPUT_CURRENT

 

The SensorType is ignored when using sensor mapping functionality at PDU level.

Tip Power sensors used for Modular PDU / Branch Circuit Monitoring For a modular PDU/Branch Circuit Monitoring, the MODULE_OUTPUT_POWER or MODULE_BREAKER_POWER are the sensors used to get power data from the device.   An example of a modular PDU with 3 phases and 24 breaker modules: At device level, the "supplemental" string is used to specify number of phases and breaker modules.   <ns2:supplemental>InputPhaseCount="3";OutputPhaseCount="3";BankCount="24"</ns2:supplemental> At sensor level, the sensorType is used to specify a modular PDU reporting data and the index is used to identify the phase reporting on a module. In this example breaker module 5, phase 3 (index 5,3): <ns2:ISXCSensorType>MODULE_OUTPUT_POWER</ns2:ISXCSensorType> <ns2:index>b,p</ns2:index> - e.g. <ns2:index>5,3</ns2:index>

Data Collection

The data collected from DCE via the power sensors is Peak and Average data. Peak and Average power data is queried for an interval of one day, 1 time/day. Additionally, peak power data is queried every 5 minutes since last time queried.

We store the data and calculate Peak and Average values based on a setting in the DCO server (10, 20, 30 days).

Summary

The expected values used to specify and map the device in DCO:

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 = Phase number	OUTPUT_POWER_WATTS	UPS or (RM)PDU
3	>1	2 digit = Module, Phase	MODULE_OUTPUT_POWER	Modular PDU
3	-	1 digit = Phase number	OUTPUT_POWER_WATTS

 

Note Supplemental is mandatory and must include phase information PhaseCount references InputPhaseCount and OutputPhaseCount which is expected to be the same number.

DCE exposes information through various web services.

For device information, DCO uses:

getAllDeviceGroups

getDevicesForGroupID

 

For sensor information and data, DCO uses: 

getSensorsByType

getMultipleAverageSensorData

getMultiplePeakSensorData

Verifying DDFs with Soap-UI

The walkthrough below is done with SoapUI 5.4.0. You can download the latest version here: https://www.soapui.org/

When setting up a new project, chose the SOAP project type.

The initial WSDL link should be

http://X.X.X.X/integration/services/ISXCentralDeviceService_v2_0?wsdl for the device endpoint.

http://X.X.X.X/integration/services/ISXCentralSensorService_v2_0?wsdl. for the sensor endpoint.

Where X.X.X.X is ip address for the DCE server.

When prompted for the username and password, provide those used for logging into the DCE server.

Running a request against the DCE server

When running a request against the endpoint, first choose the endpoint in the list, and fold out so you can see the sample request.

Before running the request, you need to setup authentication:

1. Chose 'Basic'
2. Enter in the username and password for the DCE server

Then press play to run the request.

Dependent on the request it might be necessary to fill in a number of parameters.

When you have identified the correct device use the sensor end point to ensure that sensors with the correct type are available.

Running requests to verify sensors with the correct type are available

Getting the sensors for a specific device.

Several of the end point are of interest, this is just an example on one why to do the verification.

Given an ID for a device, all the sensors for the device can be gathered with the getSensorsForDevice request.

Fill in the ID for the device

Check that sensors with the types mentioned in the first part of this document are present. One example for the OUTPUT_POWER_WATTS sensor type is shown below.