Specifications

Book Title
Ridgeline Concepts and Solutions Guide
314
The OID folder
Device images used for display in inventory and on topology maps, are kept in the extreme.war/gifs
directory, under directories named by the OID of the device.
There are typically three files in these subdirectories:
● DeviceView.gif, the image (front panel or front and back panel) displayed in the Inventory
window.
● MapView.gif, the small image that appears in the topology maps.
● DeviceInfo.txt, a file that defines the device type, fallback OID (the OID of the next higher level),
and other information.
The
DeviceInfo.txt file must always be present. The two gif files may or may not be present; if they
are not, the gif file specified for the parent OID is used. In fact, for the 3Com SuperStacker II 1100
(directory
OID_43.10.27.4.1.2.1), only the DeviceView image is provided. For the MapView image,
the generic 3COM image provided in the parent OID directory (
OID_43).
The
DeviceInfo.txt must contain at a minimum the following tags:
<?xml version="1.0"?>
<ConfigFile>
<FallbackOID> Parent SysOID </FallbackOID>
<DeviceType> Device Name </DeviceType>
</ConfigFile>
For the 3Com SuperStacker II 1100 (OID_43.10.27.4.1.2.1) the DeviceInfo.txt file contains these
entries:
<?xml version="1.0"?>
<ConfigFile>
<FallbackOID>43</FallbackOID>
<DeviceType>3Com Super Stack II Switch 1100 24-port</DeviceType>
</ConfigFile>
The DeviceInfo.txt file for the parent, OID_43 contains the following entries:
<?xml version="1.0"?>
<ConfigFile>
<FallbackOID>UnknownDevice</FallbackOID>
<DeviceType>Generic 3Com</DeviceType>
</ConfigFile>
Depending on the type of device, other information may also be included. In general, features like Port
Location (the ability to click on a port to view port statistics) are not supported for third-party devices.
The dpsimages.zip File
The dpsimages.zip file contains the images used in Ridgeline inventory windows.
If you are adding a completely new device or device type with its own unique image, you must add
that image to this file.
The image itself can be the same as the
MapView.gif image you added into the OID folder (see “The
OID folder” on page 314) but it must be named to match the name specified in the
imageIconsFileName tag in the XML file for the device or device type (see Table 9, “Attributes Used in
an ATL File” on page 312.