Using a CLI command, Ericsson devices can deliver XML device inventory to the local file system. These XML device files can be transferred to Network Integrity for processing.

See Ericsson SMO CLI, Software Management, Organizer Command Line Interface, User Guide, 2/1553-APR 901 007 for reference.

The cartridge reads the XML device file and produces a physical device hierarchy that represents the discovered device and includes a physical device instance, equipment, and equipment holders. (Physical Ports are not rendered in the XML file and so are not supported.)

Figure 5-1 shows a sample discovered physical device hierarchy. This hierarchy is displayed in the Network Integrity user interface, in the Scan Result Detail page.

This section provides information about dependencies that the XML Reference cartridge has on other entities.

This section provides information about downloading and opening the XML Reference Cartridge files in Design Studio. After you open the files, you can review and extend them.

You can download a ZIP file that contains the individual Design Studio files. You can open these files in Design Studio to review and extend the cartridge ZIP files.

This section provides information about compiling and deploying the XML Reference Cartridge.

To compile and deploy the XML Reference Cartridge:

1. Import projects into Design Studio for Network Integrity.

2. Clean and build the cartridge.

3. Deploy the cartridge.

For more information about deploying and undeploying, see Network Integrity Developer's Guide.

The XML Reference cartridge contains the following actions:

• Discover Ericsson Xml

This section shows a sample XML device file that is provided to the processor.

<?xml version="1.0" encoding="UTF-8"?>
<bulkCmConfigDataFile xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="http://www.3gpp.org/ftp/specs/archive/32_series/32.615#configData ../../../eclipseWorkSpace/XMLReferenceCartridge/schemas/configData.xsd"
   xmlns="http://www.3gpp.org/ftp/specs/archive/32_series/32.615#configData"
   xmlns:xn="http://www.3gpp.org/ftp/specs/archive/32_series/32.625#genericNrm"
   xmlns:in="http://www.3gpp.org/ftp/specs/archive/32_series/32.695#inventoryNrm">
   <fileHeader fileFormatVersion="32.615 V6.3" vendorName="Ericsson AB"/>
   <configData dnPrefix="DC=150.132.36.75,SubNetwork=NRO_RootMo,ManagementNode=ONRM,IRPAgent=ONRM_IrpAgent">
      <xn:SubNetwork id="NRO_RootMo">
         <xn:SubNetwork id="RNC106">
            <xn:ManagedElement id="RNC106">
               <xn:attributes>
                  <xn:managedElementType>RNC</xn:managedElementType>
                  <xn:userLabel>RNC106</xn:userLabel>
                  <xn:vendorName>Ericsson AB</xn:vendorName>
               </xn:attributes>
               <in:InventoryUnit id="1B">
                  <in:attributes>
                     <in:inventoryUnitType>HW</in:inventoryUnitType>
                     <in:vendorUnitFamilyType>SUBRACK</in:vendorUnitFamilyType>
                     <in:vendorUnitTypeNumber>ROJ 605 107/3_R1A</in:vendorUnitTypeNumber>
                     <in:vendorName>Ericsson AB</in:vendorName>
                     <in:serialNumber>X911033101</in:serialNumber>
                     <in:dateOfManufacture>2005-10-22</in:dateOfManufacture>
                     <in:unitPosition>1B</in:unitPosition>
                     <in:manufacturerData>ProductName=CBM,SlotCount=28</in:manufacturerData>
                  </in:attributes>
                  <in:InventoryUnit id="0">
                     <in:attributes>
                        <in:inventoryUnitType>HW</in:inventoryUnitType>
                        <in:vendorUnitFamilyType>FAN</in:vendorUnitFamilyType>
                        <in:vendorUnitTypeNumber>BKV 301 487/1_R3A</in:vendorUnitTypeNumber>
                        <in:vendorName>Ericsson AB</in:vendorName>
                        <in:serialNumber/>
                     </in:attributes>
                  </in:InventoryUnit>
                  <in:InventoryUnit id="1">
                     <in:attributes>
                        <in:inventoryUnitType>HW</in:inventoryUnitType>
                        <in:vendorUnitFamilyType>PIU</in:vendorUnitFamilyType>
                        <in:vendorUnitTypeNumber>ROJ1192108/4_R2B</in:vendorUnitTypeNumber>
                        <in:vendorName>Ericsson AB</in:vendorName>
                        <in:serialNumber>TU87600308</in:serialNumber>
                        <in:dateOfManufacture>2005-12-01</in:dateOfManufacture>
                        <in:unitPosition>1</in:unitPosition>
                        <in:manufacturerData>ProductName=SCB3</in:manufacturerData>
                     </in:attributes>
                  </in:InventoryUnit>
                  <in:InventoryUnit id="2">
                     <in:attributes>
                        <in:inventoryUnitType>HW</in:inventoryUnitType>
                        <in:vendorUnitFamilyType>PIU</in:vendorUnitFamilyType>
                        <in:vendorUnitTypeNumber>ROJ1192109/3_R1B</in:vendorUnitTypeNumber>
                        <in:vendorName>Ericsson AB</in:vendorName>
                        <in:serialNumber>TU87153523</in:serialNumber>
                        <in:dateOfManufacture>2005-10-07</in:dateOfManufacture>
                        <in:unitPosition>2</in:unitPosition>
                        <in:manufacturerData>ProductName=SXB3</in:manufacturerData>
                     </in:attributes>
                  </in:InventoryUnit>
                  <in:InventoryUnit id="3">
                     <in:attributes>
                        <in:inventoryUnitType>HW</in:inventoryUnitType>
                        <in:vendorUnitFamilyType>PIU</in:vendorUnitFamilyType>
                        <in:vendorUnitTypeNumber>ROJ1192109/3_R1B</in:vendorUnitTypeNumber>
                        <in:vendorName>Ericsson AB</in:vendorName>
                        <in:serialNumber>TU87153427</in:serialNumber>
                        <in:dateOfManufacture>2005-10-07</in:dateOfManufacture>
                        <in:unitPosition>3</in:unitPosition>
                        <in:manufacturerData>ProductName=SXB3</in:manufacturerData>
                     </in:attributes>
                  </in:InventoryUnit>
               </in:InventoryUnit>
            </xn:ManagedElement>
         </xn:SubNetwork>
      </xn:SubNetwork>
   </configData>
   <fileFooter dateTime="2006-09-06T08:03:04+02:00"/>
</bulkCmConfigDataFile>

This section provides information about modeling the XML Reference cartridge.

Figure 5-3 shows a Unified Modeling Language (UML) diagram depicting the object relationship.

This section provides 3GPP to Information Model correction information.

		   PhysicalDevice
      EquipmentHolder

		   PhysicalDevice
     Equipment-named Artificial Equipment
      EquipmentHolder

This section provides information about using Design Studio to construct the XML Reference cartridge.

The XML Reference cartridge contains the following specifications:

• EricssonCPPPhysicalDevice

• EricssonCPPEquipment

• EricssonCPPEquipmentHolder

• EricssonXmlFileCollectorProperties

Figure 5-4 shows the discover DiscoverEricssonXml action chain.

In Figure 5-4, the chevrons that correspond to EricssonXmlFileCollector and EricssonXmlFileParser indicate the code-generated processors from Design Studio user input.

• EricssonXmlFileCollector is an instance of the file transfer processor.

• EricssonXmlFileParser is an instance of the file parser processor.

This section provides information about Design Studio extensions to the XML Reference cartridge.

The source code for this cartridge is provided. You can change any part to customize this cartridge to fit your environment.

For more information on extensibility, see Network Integrity Developer's Guide.