## Device Data Files Plug-In Notes

### Contents

Overview

Plug-In Prerequisites

Before You Register This Plug-In

Using the Plug-In Registration Wizard

Uninstalling the Plug-In

### Overview

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.

Notes:

- 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.
- The .XML file must reside on the proxy server that is running the plug-in software.

### Plug-In Prerequisites

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

### Before You Register This Plug-In

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

### Using the Plug-In Registration Wizard

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

#### Registering an Unmanaged Object

1. Launch the Plug-In Registration Wizard to display the Introduction dialog box.

2. Click Next to display the Registration Function dialog box.

3. 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.
4. 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.

5. 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.
6. 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.
7. 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.

8. 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.
9. If you successfully registered the RAID device data file, it is located in the group named RAID Group.

Back to Contents

#### Saving Registration Settings to a File

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.

1. In the Required Registration Information dialog box, click Save As to display the Save As dialog box.
2. 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

#### Unregistering a Managed Object

Use the following procedure to unregister a managed object so that it becomes unmanaged by the Capacity Reporter Server.

1. Launch the Plug-In Registration Wizard.
2. In the Registration Function dialog box, select Unregister a managed object.
3. In the Required Registration Information dialog box, enter the Object Name that corresponds to the object that you want to unmanage.

Back to Contents

### Uninstalling the Plug-In

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:

1. Click the Start button, and then click Settings -> Control Panel.
2. Double-click Add/Remove Programs to display the Add/Remove Programs Properties dialog box.
3. Select SRM Plug-In for Device Data Files from the list, and click Add/Remove to launch the Uninstall Wizard.
4. 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