HP Storage Essentials V5.00.01 user guide (T4283-96012, January 2006)

Storage Essentials 5.00.01 User Guide 455
2. Create a node for your custom reports. This node appears in the tree in Reporting.
a. Create the directory %JBOSS4_DIST%\server\appiq\reports\customTreeNodes if
it doesn't already exist
b. Create an XML file in that directory for your tree node, for example, custom.xml. The
management server uses this file to determine where to put the node for custom reports in the
tree.
c. Use a text editor, such as Notepad, to open the XML file you created in the previous step.
Enter the following into the XML file:
<NODE NAME="CUSTOM" LABEL="Custom" PARENT="SYSTEM"/>
where
• NAME is how reports and other tree nodes refer to this node.
• LABEL is the label that appears in the user interface for the node.
• PARENT is the name of the parent node in the tree (optional). In this case, the Custom
report appears under the SYSTEM node in the tree in Reporting.
3. To populate the tree in Reporting with your custom reports:
a. Create the directory
%JBOSS4_DIST%\server\appiq\reports\definitions\custom if it doesn't
already exist
b. Create an XML file in that directory for your report, for example: CustomHostReport.xml
c. Open the file you created in the previous step in a text editor, such as Notepad. Add the
following information to the file, modifying it for your settings. Refer to files in
%JBOSS4_DIST%\server\appiq\reports\definitions if you need additional
samples.
d. Make sure you use an ID that is not used by any of the existing reports. You have to specify a
title to appear in the tree and the file names for the CLS and CAT files, as shown in the
following example.
<REPORT ID = "9098"
TITLE = "Custom Host Connectivity"
FILE_NAME = "//definitions/custom/Host_Connectivity.cls"
CATALOG_FILE = "//definitions/custom/host.cat"
SUPPORTS_ORGANIZATION_FILTERS = "true">
<TREE_NODE NAME = "CUSTOM" />
<ELEMENT_FUNCTION_CALLBACK NAME = "isHost" />
</REPORT>
where
• REPORT ID is the unique ID for the report.
• TITLE is the name you want to appear for the report in the tree in Reporting.
• FILE_NAME is the file name of the CLS file for the report and its path. In the example, the
CLS file is in the
%JBOSS4_DIST%\server\appiq\reports\definitions\custom directory.
• CATALOG_FILE is the file name of the CAT file for the report and its path. In the
example, the CAT file is in the
%JBOSS4_DIST%\server\appiq\reports\definitions\custom directory.