XML File Schema

An XML file can import SNMP authentication profiles, device information, or both. This section describes how to create an XML file for use with file-based discovery.
uim901
An XML file can import SNMP authentication profiles, device information, or both. This section describes how to create an XML file for use with file-based discovery.
The XML schema was updated for cm_data_import version 7.6 to support the import of SNMP authentication profiles. While the probe imports XML files using the old schema, we recommend that you migrate to the new schema. Refer to:
  • <UIM_install_directory>/
    probes/service/cm_data_import/
    schema
    - new XML schema definition file and example XML files
  • <UIM_install_directory>/
    probes/service/cm_data_import/
    schema_old_201211
    - previous schema and example files for reference
Note the following parameters.
  • The schema allows you to define subsections for:
    • Devices
    • SmpV1Profiles
    • SnmpV2Profiles (for SNMP V2c profiles)
    • SnmpV3Profiles
  • The definition for V1 and V2 SNMP profiles is the same, but they are placed in the XML file in different sections. The sections identify which are V1 profiles and which are V2 profiles. 
  • Properties in the schema that contain
    minOccurs="1"
    are required.
  • For properties that refer to open enumerations, go to
    <UIM_install_directory>
    \probes\service\cm_data_import\
    schema
    and open either
    usm-openenums.xml
    or
    cm-data-import-openenums.xml
    to view the defined values. Although it is not strictly required, we strongly recommended that you use values defined by the open enumerations.
  • In addition to the subsections listed above, the following top-level properties are available in the CmData section:
Property
Description
DefaultOrigin
Optional
Top-level property that specifies the origin to be assigned to any device that does not have a specified origin.
PasswordsEncrypted
Optional
Top-level property that specifies whether the passwords in SNMP profiles are encrypted. If the value is unspecified or set to false and the XML file includes unencrypted passwords, in the XML file that is saved to the processed directory, the passwords are encrypted and PasswordsEncrypted is set to true. Because UIM uses a custom encryption method, you can let cm_data_import encrypt the passwords for you.  You can copy the XML file from the processed directory in order to use the encrypted passwords in the future.