Device Data Files Plug-In Notes
Overview
Plug-In Prerequisites
Before You Register This Plug-In
Using the Plug-In Registration Wizard
Uninstalling the Plug-In
You can use the Device Data Files Plug-In to import data directly into the Capacity Reporter database from a data file (in .XML format). Using this plug-in, you can import data gathered from RAID, NAS, or SANSwitch devices.
For details on the .XML file format for each type of device, see the Document Type Definition (DTD) Notes for RAID, NAS, and SANSwitch Devices.
Note: This plug-in does not gather data from the device. You are responsible for populating the .XML file from which the plug-in reads the data into the Capacity Reporter database.
A Capacity Reporter 5.0.1 (or greater) Windows NT/Windows 2000 Agent must be installed on the
computer on which you plan to install the Device Data Files Plug-In.
Back to Contents
Determine the full file name (including path) of the .XML device data file that
represents the
device you want to scan. The Plug-In Registration Wizard prompts
for this information.
Back to Contents
You can run the Plug-In Registration Wizard in one of the following
ways:
- At the end of the plug-in installation, on the Installation
Complete dialog box, select the check box labeled Check this
box to register <device-type> device data files with an SRM Server. The
installation procedure runs the Plug-In Registration Wizard for you before exiting.
- Click the Start button, and then click Programs >
Storage
Resource Manager Plug-In Registration, and select Register <device-type>
device
data files.
Note: You must run the Plug-In
Registration
Wizard once for each unmanaged device, or object, that you
want to
register with the Capacity Reporter Server.
Back to Contents
- Launch the Plug-In Registration Wizard to display the Introduction
dialog box.
- Click Next to display the Registration Function dialog box.
- Select the registration task you want to perform. The following
list describes each registration task:
- Register an unmanaged object - This option registers the
device
as a managed object with the Capacity Reporter Server software. Upon the
successful
completion of this task, the Capacity Reporter Server software knows about
and
manages scans for the object you specified.
- Unregister a managed object - This option removes the
managed
object from the list of managed objects that the Capacity Reporter
Server software knows about and manages.
- Click Next to display the Required Registration Information
dialog box.
You must fill in all the fields in this dialog box before you
can continue to the next step:
- SRM Server Name - Enter the name of the Capacity Reporter Server that manages the Capacity Reporter Agent computer on which you
installed
the Device Data Files Plug-In.
- <device-type> device data file - Enter the full file name (including path) of the
.XML device data file that you want to scan.
- Proxy Agent Name - Enter the name of the Capacity Reporter Agent
computer on which you installed the Device Data Files Plug-In. This
computer
must be a managed computer on the Capacity Reporter Server with
which you
want to register the object. Note that the proxy agent must be able
to
access the device data file.
- SRM Display Name - Enter a name for the device
represented by the
device data file that you want Capacity Reporter reports to
display. This is the name by which the Capacity Reporter Server knows the managed
object, and it is displayed in all Capacity Reporter reports.
This name must be unique for a given device category. For example, there cannot be two
managed objects named MyRAIDbox in the RAID group.
Note: The SRM Display Name must match the "name" element in the ID field of the generated .XML data file for the device. For example, suppose that the .XML file contains the following data:
<ID>
<name>MyDevice</name>
</ID>
In this case, the SRM Display Name field must contain "MyDevice", so that the Capacity Reporter Server can correctly process the data.
This box is automatically filled in with the name you entered in the
<device-type> device data file box. However, you can change or edit
the entry,
if necessary.
- Perform one of the following actions:
- If you want to provide additional information to be included in
Capacity Reporter reports, click Optional Information to display the
Optional Registration Information dialog box. Go to step 6.
- To complete the registration process, click Finish.
Go to step 7.
- In the Optional Registration Information
dialog box,
enter data in the fields you want to fill in, and click OK.
This screen is optional. You do not have to fill in any
fields to proceed.

- Contact information - Enter the contact information for
the unmanaged object being registered (for example, System
Administrator, x555).
- Location information - Enter the geographical location of
the unmanaged object being registered (for example, Data Center,
Building 5).
- Management Server URL - Enter the URL of the management
console
for the unmanaged object being registered.
- Display Text for Management Server URL - Enter the text
to be
displayed in Capacity Reporter reports as the link to the
management
console.
- Help URL - Enter the URL to manuals, troubleshooting
documentation, or a help desk associated with the unmanaged object
being registered.
- Display Text for Help URL - Enter the text to be
displayed in Capacity Reporter reports as the link to the help page.
- Manufacturer URL - Enter the URL of the corporate Web
site for the vendor that produced the unmanaged object being registered.
- Display Text for Manufacturer URL - Enter the text to be
displayed in Capacity Reporter reports as the link to the
manufacturer's Web site.
- When the wizard has finished registering the unmanaged
object, the Registration Command Output dialog box is displayed.

If registration was successfully completed, the text
STATUS=OK
appears in the box. If not, the value following STATUS=
contains text describing the error that occurred. In addition, a more detailed
description of the error is displayed if enough data is available at the time of the
failure.
- Do one of the following:
- If you want to close the Plug-In Registration Wizard, click
Finish.
- If you want to register another unmanaged object, click
Register
Another Object.
- If you successfully registered the RAID device data file, it is located
in the group named RAID Group.
Back to Contents
You can save your registration settings to a file. You
may want
to do this, if you are registering many unmanaged objects of the same
type.
- In the Required Registration Information dialog box, click
Save As to display the Save As dialog box.
- Enter a name for the file and give it an .SVR file extension (for
example, MyRAIDSettings.svr).
If you want to use a specific registration settings file (.SVR) when
registering an unmanaged object, click Load in the Required
Registration Information dialog box, and then select the appropriate
.SVR
file for your plug-in.
Back to Contents
Use the following procedure to unregister a managed object so that it
becomes
unmanaged by the Capacity Reporter Server.
- Launch the Plug-In Registration Wizard.
- In the Registration Function dialog box, select
Unregister a
managed object.
- In the Required Registration Information dialog box, enter
the Object Name that corresponds to the object that you want to
unmanage.
Back to Contents
To remove the plug-in, use the Add/Remove Programs applet in
the Windows
Control Panel on the computer where you installed the plug-in.
To uninstall the plug-in:
- Click the Start button, and then click Settings
->
Control Panel.
- Double-click Add/Remove Programs to display the
Add/Remove
Programs Properties dialog box.
- Select SRM Plug-In for Device Data Files from the list, and
click
Add/Remove to launch the Uninstall Wizard.
- Click Next, and then click Finish to remove the
plug-in
files from the computer.
Note: If you uninstall the Capacity Reporter 5.0.1 (or greater) Agent from a
computer, it automatically removes all plug-ins installed on that
computer.
Back to Contents