DESKTOP MANAGEMENT INTERFACE
____________________________
The Desktop Management Interface (DMI) is a standard
framework for managing the information provided by the
components of PC systems. DMI was created by the Desktop
Management Task Force (DMTF). The DMTF is a cooperative,
industry-wide effort formed to bring management, ease of
use, and control to PC systems.
The DMI architecture utilizes a service layer, a local
program that collects information from the components of
the PC system and passes the information to management
applications. The IBM LAN adapter instrumentation
couples the adapter's device driver to the service layer.
-----------------------------------------------------------------------------
*--------------------------------*
*--------------------------------* |
| Management Applications/Agents |-*
*--------------------------------*
*-----------------------------------------------------*
| DMI service layer |
*-----------------------------------------------------*
*---------------------------* *-----------------*
| IBM LAN adapter | | other |-*
| component instrumentation | | component | |
*---------------------------* | instrumentation | |
*-----------------* |
*---------------------------* *-----------------*
| device driver |
*---------------------------*
-----------------------------------------------------------------------------
For additional information about the DMTF or DMI, refer
to URL HTTP://WWW.DMTF.ORG.
LAN ADAPTER INSTRUMENTATION FOR OS/2
The IBM LAN adapter instrumentation is implemented as a
protocol stack in OS/2. Currently, the protocol stack
supports NDIS 2 device drivers. The protocol stack
implementation allows the instrumentation to get and set
attributes for any IBM NDIS 2 device driver without
requiring changes to the device driver. The IBM LAN
adapter instrumentation for OS/2 is on this Diskette
Desktop Management Interface 1
For OS/2 Warp, Version 4, the DMI service layer and its
associated browser and agent applications are contained
in the base OS. For earlier versions of OS/2, the DMI
service layer can be installed separately. Information
about acquiring the DMI service layer and its browser and
agent applications can be found at URL
HTTP://WWW.RALEIGH.IBM.COM/SHA/SHAHOME.HTML. in the
\DMI\OS2 directory.
Automatic Installation
The IBM LAN adapter instrumentation can be installed like
any other protocol stack by using MPTS. Follow these
steps.
1. Start MPTS (double-click the MPTS icon).
2. Select CONFIGURE.
3. Select CONFIGURE again.
4. Select OTHER PROTOCOLS....
5. When prompted for an installation diskette, insert
this Diskette. Change from the default directory of
A:\ to A:\DMI\OS2, and then press ENTER. The files
will be copied to the system.
6. Bind the IBM LAN adapter instrumentation protocol for
the adapters you want managed via DMI, by selecting
ADD. Select OK when you have finished.
7. Exit the MPTS installation process.
NOTE: The installation procedure copies MACDMI2.EXE and
MACDMI.MIF to the \IBMCOM\PROTOCOL directory, which is
not usually in the PATH statement. You must ensure that
these files reside in a directory that is in your PATH.
Manual Installation
The IBM LAN adapter instrumentation can be also be
installed manually by following these steps.
1. Install the executable (MACDMI2.EXE) and its files:
Copy MACDMI2.EXE and MACDMI.MIF to a directory
included in your PATH statement.
2. Install the protocol driver (MACDMI.OS2) and its
files. The following example uses <install_dir> to
represent the install directory.
2
a. Copy MACDMI.OS2, MACDMI.NIF, MDM.MSG and MDMH.MSG
to <install_dir>.
b. Ensure that <install_dir> is in your DPATH state-
ment.
c. Update your CONFIG.SYS file to contain the entry:
DEVICE=C:<install_dir>\MACDMI.OS2
d. Add a section to your system's PROTOCOL.INI file
for the IBM LAN adapter instrumentation
[MACDMI]
DRIVERNAME = MACDMI$
e. Add a bindings entry to the system's PROTOCOL.INI
file to indicate which NDIS 2 drivers you want to
be managed by DMI. An example of a complete
PROTOCOL.INI entry would be:
[MACDMI]
DRIVERNAME = MACDMI$
Bindings = IBMTRP_nif, IBMTRP2_nif
Starting the IBM LAN Adapter Instrumentation
The IBM LAN adapter instrumentation, MACDMI2.EXE, can be
started at an OS/2 command prompt, with the RUN command
in CONFIG.SYS or with the START command. The OS/2 DMI
service layer must be started before the instrumentation.
The first time the instrumentation runs, it will install
the IBM LAN adapter components into the OS/2 service
layer's database. The instrumentation displays messages
indicating the status of the procedure.
If you want to change the LAN adapter that is to be
managed, just go into MPTS and bind the IBM LAN adapter
instrumentation protocol to the adapters you want
managed. The next time the instrumentation is started,
it will install (if necessary) additional LAN adapter
components into the OS/2 service layer's database.
IBM LAN Adapter Instrumentation Messages
Look in LANTRAN.LOG for error messages from MACDMI.OS2.
Use the OS/2 Help Facility to get additional information
on any MDMxxxxx error messages reported by MACDMI2.EXE or
MACDMI.OS2. For example: enter HELP MDM0041.
Desktop Management Interface 3
Managing IBM LAN Adapters Locally
Once the OS/2 DMI service layer and the IBM LAN adapter
instrumentation have been started, the management infor-
mation file (MIF) browser can be used to view and set LAN
adapter attributes. The MIF browser icon is located in
the IBM SystemView Agent folder along with SystemView
Agent documentation. The MIF browser provides a hierar-
chical representation of the groups and attributes of
each manageable component in the system.
LAN ADAPTER INSTRUMENTATION FOR NT
The IBM LAN adapter instrumentation is implemented as a
ring-3 executable program in NT. The executable program
supports NDIS 3 device drivers. The instrumentation
allows users to retrieve attributes for any IBM NDIS 3
device driver without requiring changes to the device
driver. The IBM LAN adapter instrumentation for NT is on
this Diskette
Information about acquiring the Win32 DMI service layer
and its browser and agent applications can be found at
URL HTTP://WWW.RALEIGH.IBM.COM/SHA/SHAHOME.HTML. in the
\DMI\NT directory.
Installation
Copy all the files from A:\DMI\NT to the desired direc-
tory on your system.
Starting the IBM LAN Adapter Instrumentation
The IBM LAN adapter instrumentation for NT, MACDMINT.EXE,
can be started like any other executable file. The NT
DMI service layer must be started before the instrumenta-
tion.
The first time the instrumentation runs it will install
the IBM LAN adapter components into the NT service
layer's database. The instrumentation displays messages
indicating the status of the procedure.
The instrumentation will manage all the LAN adapters in
the system.
4
IBM LAN Adapter Instrumentation Messages
The IBM LAN adapter instrumentation will display messages
on the screen.
Managing IBM LAN Adapters Locally
Once the Win32 DMI service layer and the IBM LAN adapter
instrumentation have been started, the MIF browser can be
used to view LAN adapter attributes. The MIF browser
icon is located in the IBM SystemView Agent folder along
with SystemView Agent documentation. The MIF browser
provides a hierarchical representation of the groups and
attributes of each manageable component in the system.
SNMP MANAGEMENT OF IBM LAN ADAPTERS
The IBM LAN adapters can be managed by any application
using standard SNMP operations. SNMP managment is accom-
plished by utilizing the SNMP agent and DMI subagent sup-
plied with the IBM SystemView Agent. The DMI subagent
translates a MIB variable into the corresponding DMI MIF
attribute. In order to manage the IBM LAN adapters using
SNMP, follow the steps outlined below for the end station
and the manager's station.
These are the files necessary to use SNMP to manage IBM
LAN adapters. The files are all located on this Diskette
in the \DMI\SNMPMGRS directory.
o MACDMI.MAP--mapping file fragment, correlates SNMP
object identifier (OID) to DMI component. Used in
the end station.
o MACDMI.MIB--SNMP MIB file that describes the manage-
able attributes of the IBM LAN adapters. Used by
most SNMP manager platforms.
o MACDMI.DEF--MIB definition file that describes attri-
butes of IBM LAN adapters. Used by NetView for
Windows.
End Station Setup
Add the contents of the MACDMI.MAP file to the existing
entries in the DMISA.MAP mapping file. The mapping file
provides the correlation between the SNMP OID(s) and the
DMI component(s). The mapping file is located in the
directory <sva_path>\BIN\AGENT, where <sva_path> is an
environment variable defined during installation.
Desktop Management Interface 5
NOTE: Some earlier versions of the SystemView Agent
defined the <netview_path> environment variable for
installation.
Start these programs for an OS/2 END STATION: SNMP agent
(SNMPD.EXE), DMI subagent (DMISA.EXE), and the LAN
adapter instrumentation (MACDMI2.EXE).
Start these programs for an NT END STATION: SNMP agent
(SNMPD.EXE), DMI subagent (DMISA32.EXE), and the LAN
adapter instrumentation (MACDMINT.EXE).
Manager Station Setup
The general steps to setup any SNMP management platform
are:
1. Copy the MIB/DEF file to the appropriate directory
(where all the other MIB/DEF files are located).
2. Load or "install" the MIB/DEF file into the manager's
database.
The specific setup instructions for a couple SNMP manage-
ment platforms are described below.
o NetView for AIX
The MIB Browser operates directly on the MIB file
(MACDMI.MIB). Copy MACDMI.MIB to the
\usr\OV\snmp_mibs directory. To load the MIB: start
NetView for AIX, select OPTIONS and then the
LOAD/UNLOAD MIB option.
6
To view the LAN adapter attributes, select TOOLS and
then the MIB BROWSER option. Use the DOWN TREE
option to traverse the MIB tree and locate the LAN
adapter attributes. The path through the MIB tree
is:
internet->private->enterprises->ibm->
ibmArchitecture->ibmDmi->mibsFromMifs->
ibmLanAdapter->dmtfGroups
Click on START QUERY to obtain the value of a MIB
attribute.
o NetView for Windows
The MIB Browser operates on the MIB definition file
(MACDMI.DEF) that defines the structure of the MIB.
The default path for this file is the
<install_dir>\BIN\DEF_FILE directory. The default
<install_dir> is NVWIN.
Copy MACDMI.DEF to the <install_dir>\BIN\DEF_FILE
directory and copy MACDMI.MIB to the
<install_dir>\BIN\MIBS directory.
To view the LAN adapter attributes, use the MIB
Browser function and the LOAD MIB TREE option to load
the MIB definition file (MACDMI.DEF). This will
display the tree of MIB attributes that represent the
LAN adapter. Double-click any MIB attribute to
obtain its value. Double-click a second time to
graph the value; this would be useful for an attri-
bute such as Ring Utilization.
Desktop Management Interface 7
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.