Managing Reporting

The following sections provide procedures for customizing, generating, printing, and exporting the Novell ZENworks Server Management reports:


Managing the Topology Reports

You can generate two types of topology reports: site-level reports and segment-level reports. The site-level reports provide details about the discovered devices on each segment in the Novell ZENworks Server Management site. The segment-level reports provide information about the managed devices on the selected network segment. Note that the NCP Servers report is available only at the site level.

The following section describes how to generate, print, and export a topology report.


Generating a Topology Report

To generate a topology report:

  1. Select the Novell ZENworks Server Management site object, a network segment object, or a Custom Atlas container object.

  2. Click Tools > Reports.

  3. Select the report you want to generate, then click Run Selected Report.

  4. To print the report, click Print icon

  5. To export the report, click Export icon.


Managing the Server Management Health Reports

The server management component provides five standard profiles that you can use to generate health reports. You can set up reports based on these standard profiles or you can customize these profiles or create your own profiles on which to base your reports. For information about the standard health profiles, see About the Health Reports.

This section contains the following tasks:


Customizing a Health Profile

To customize a health profile:

  1. Right-click the Novell ZENworks Server Management site object, then click Properties.

  2. Select the Health Profiles tab.

  3. Select the health profile you want to customize, then click Edit.

    The Edit Profile dialog box is displayed. This dialog box contains a list of the parameters that can be used to calculate the overall health of the device or segment to which the profile is applied.

  4. Specify the directory location to which reports generated using this profile should be published by entering a value in the Publish Directory field.

    To browse for a directory, click the Browse button (...).

  5. Modify the parameters that are used to calculate health by checking or unchecking the In Health Calculation check box next to each parameter. For more information on the parameters that are used in health calculation see, About the Health Reports.

  6. Rank the importance of each trend parameter in calculating health by entering a number in the Weight field for each parameter you checked to include in the health calculation.

    You can enter any whole number in the Weight field. The system will use the weights to determine how important the parameter is in calculating overall health. The larger the number, the more weight the parameter is given in calculating health.

  7. Modify which parameters to render graphically in the health report by checking or unchecking the Show Trend on Report check box next to each parameter.

  8. To save your changes, click OK.


Adding a New Health Profile

To add a new health profile:

  1. Right-click the Novell ZENworks Server Management site object then click Properties.

  2. Select the Health Profiles tab.

  3. Click New.

    The New Profile dialog box is displayed.

  4. Enter a name for the new profile in the Name field.

  5. Select the type of device or segment to which the profile applies from the Type drop-down list then click OK.

    The Edit Profile dialog box is displayed.

  6. Specify the directory location to which reports generated using this profile should be published by entering a value in the Publish Directory field.

    To browse for a directory, click the Browse button (...).

  7. Select the parameters you want to use to calculate health for reports generated using this profile by clicking the In Health Calculation check box next to the appropriate parameters. For more information on the parameters that are used in health calculation see, About the Health Reports.

  8. For each parameter you selected to include in the health calculation, indicate how important the parameter is in calculating overall health by entering a value in the Weight column.

    You can enter any whole number in the Weight field. The system will use the weights to determine how important the parameter is in calculating overall health. The larger the number, the more weight the parameter is given in calculating health.

  9. For each parameter that you want to be represented graphically in associated health reports, click the Show Trend on Report check box.

  10. Click OK.


Creating and Scheduling Health Reports

To create and schedule a health report:

  1. Right-click the container object then click Properties.

  2. Select the Health Reports tab.

  3. Click New.

    The Edit Report dialog box is displayed.

  4. Enter a name for the report in the Name field.

  5. Select the profile to use when generating the report by selecting a value from the Profile drop-down list.

  6. Indicate how often you want to generate the reports by selecting a value from the Period drop-down list.

    You can choose to generate reports daily, weekly, or monthly.

  7. Set the time and date you want the reports generated by selecting or entering the appropriate values in the Start Time, Day of the Week, and/or Day of the Month fields.

    The available fields will depend on the period you selected.

  8. Click OK.

    The report will be generated at the date and time you entered and stored in the directory specified in the associated report profile. For information on viewing the reports, see Viewing and Printing a Health Report.


Editing, Scheduling, and Deleting Health Reports

To edit and schedule a health report:

  1. Right-click the atlas, page, or segment then click Properties.

  2. Select the Health Reports tab.

  3. Click Edit.

    The Edit Report dialog box is displayed. Edit the required information

  4. Click OK.

    IMPORTANT:  If you want to edit the schedule time of the report, it is recommended that you create a new report with the changed schedule time or delete the report.

To delete a health report:

  1. Right-click the atlas, segment, or page then click Properties.

  2. Select the Health Reports tab.

  3. Click Delete.

  4. Click OK.


Viewing and Printing a Health Report

After you create a health report, the report will be automatically generated on the day and time you specified. You can view the reports using a Web browser to open the INDEX.HTM file in the directory that is designated as the publish directory in the associated report profile.

IMPORTANT:  Before you can view the health reports you must install Java*
plug-in 1.3.1_01. You can get this plug-in from Sun Microsystems, Inc.

To view a health report:

  1. Browse to the directory where the health reports for the associated profile are stored.

  2. Use your browser to open the index.htm file.

    The index.htm file is a Java file containing all reports that are stored in the directory. The left column of the index.htm file lists report hierarchy.

  3. Click the plus sign next to the profile that is associated with the reports you want to view.

    The profile object expands to display a list of container objects.

  4. Click the plus sign next to the container object associated with the reports you want to view.

    The object expands to display a list of report names associated with the object.

  5. Click the plus sign next to the report you want to view.

    The object expands to display a list of individual report instances. For example, a report that is scheduled to run daily will have a report instance for each day. The reports are named by date and time. For example, 2000.09.09_11.15.10_PDT is the name assigned to a report generated on September 9, 2000 at 11:15:10 Pacific daylight time.

  6. Click the plus sign next to the report name to display a list of individual report pages.

    The number of individual report pages depends on what report profile you selected and the object where you generated the report. For example, if you generated a report at the segment level using the Ethernet Network profile, there will only be one report page for the segment. If you generated a report at the site level using the Ethernet Network profile, there will be a report page for each Ethernet segment within the site. If you generated a report at the segment level using the Novell NetWare Server profile, there will be a separate report page for each Novell NetWare server on the segment.

  7. Click an individual report page to display the health report in the right frame.

    The top of the report displays statistical information about the segment or server and provides a calculation of overall health. The parameters used to determine overall health are defined in the associated health report profile. The bottom of the profile displays trend graphs depicting the overall performance of the server or segment. See About the Health Reports for a list of the parameters tracked and graphed in each of the standard profiles.

  8. To print the report, click the Print Report button at the bottom of the left frame.


Running a Health Report

Although Health Reports are usually scheduled to run at a specified time of the day, week, or month, you may occasionally want to generate a Health Report on demand. To generate a Health Report on demand:

  1. Right-click the atlas, segment, or page then click Properties.

  2. Select the Health Reports tab.

  3. Select the report you want to generate then click Now.

    The report is saved to the directory specified in the report profile. See Viewing and Printing a Health Report.


Calculating the Overall Health

Overall health is calculated using the following parameters:

  • Attributes selected for health calculation.
  • Associated weights assigned to each attribute.

    You can only associate weights, which are used for health calculations.

  • Values for each attribute

    Yellow threshold (YT), Red threshold (RT), and maximum value (maxValue).

  • Global threshold values

    Global Green threshold (GG) is 100, Global Yellow threshold (GY) is 66, and Global Red threshold (GR) is 33.


Health Calculation

For each of the attribute used in overall health calculation, sample values based on the schedule specified while generating the reports are collected. These sample values are normalized using global thresholds and attribute thresholds, where Global Green is 100, Global Yellow is 66, and Global Red is 33. The global Green range = global Green - global Yellow; the global Yellow range = global Yellow - global Red; and the global Red range = global Red.


Normalization Formula

Normalized Value = Global Threshold - ((value - attribute Threshold))/(attribute Threshold Range) * (Global Range)

if (value > attribute's RED threshold)

global Threshold = global Red

attribute threshold = attribute Red threshold

attribute threshold range = attribute maxValue - attribute Red threshold

global Range = global Red range

if (value > attribute's Yellow threshold)

global threshold = global Yellow

attribute threshold = attribute Yellow threshold

attribute threshold range = attribute Red - attribute Yellow

global range = global Yellow range

if (value > 0)

global threshold - ((value)) / (attribute threshold range) * (global range)

global threshold = global Green

attribute threshold Range = attribute Yellow threshold

global range = global Green range

Each of these may have an associated weight attached to it, which is configured in the respective profiles. Each of these attribute samples is then multiplied by the corresponding weights using the formula:

value = value * attributeWeight / TotalWeight;

where --- value is the particular sample after normalization, attributeWeight is the weight associated with the attribute and the TotalWeight is the total weight of all the attributes used in health calculation.

The other values displayed in Health Reports are based on the following calculations:

  • Minimum Value = minimum of all the values in a given sample
  • Maximum Value = Maximum value of all the values in a given sample
  • Average Value = Sum of all the Values / no of Samples
  • Trend is calculated based on the Slope:

    Slope = (n * sigma icon x *y - sigma icon x * sigma icon y) / (n * sigma icon x * x - sigma icon x * sigma icon x)
       where:
          n = number of samples
          x = time at which these samples were captured
          y = trend values
    if Slope > 0, then the trend is increasing
    if Slope < 0, then the trend is decreasing
    if Slope = 0, then the trend is steady

  • Intercept = (D~ø424 (404 of 406) * y - Slope * D~ø424 (404 of 406) * x) / n
  • Next Week Projection or Next Month Projection Value = Slope * time + Intercept
       where time = Report Schedule Time (time when the report was scheduled) + 7 * 24 * 60 * 60 * 1000 for weekly Projection
  • Report Schedule Time (time when the report was scheduled) + 30 * 24 * 60 * 60 * 1000 for Monthly Projection.

WARNING:  Exporting data in CSV (Comma Separated Value), Character Separated Value, and Tab SeparatedValue(TSV), does not export the complete data. As a workaround the you need to first export data in MS Excel format and then save it in the desired format.

If you export the generated reports in formats other than HTML or DHTML, the correct page numbers are not displayed. The page number is displayed incorrectly as Page -1 of 1, for all pages.