User Guide for CiscoWorks Health and Utilization Monitor 1.1.2
Chapter 9 Troubleshooting and FAQ

Table Of Contents

Troubleshooting and FAQs in CiscoWorks HUM

Frequently Asked Questions

Troubleshooting HUM


Troubleshooting and FAQs in CiscoWorks HUM


This chapter provides you the following information for CiscoWorks Health and Utilization Monitor (HUM):

Frequently Asked Questions

Troubleshooting HUM

Frequently Asked Questions

The following section lists the frequently asked questions about HUM.

What is CiscoWorks Health and Utilization Monitor (HUM)?

How many devices can HUM monitor?

How many MIB objects can HUM monitor?

What polling intervals does HUM support?

What MIBs does HUM use to query the device?

What parameters can HUM monitor in a device?

How can I stop a Poller from polling the devices?

Can I create my own custom templates and poll the devices using it?

What does Transient and Permanent failures mean?

What are Missed Cycles?

Can I export a template from HUM to a directory location?

Can I use an external MIB file in HUM?

How can I create a threshold for a MIB variable?

Can I receive alerts or notifications when a threshold rule is violated?

Can I view the complete details of a device from a single report?

Can I configure HUM to send the PDF format of reports as an E-mail?

Can I configure HUM to publish PDF format of reports to a directory location?

Can I set log levels for individual application modules? Where are these log files stored?

Can I change the frequency of Quick Report generation?

Can I generate a report in HUM to view the last 24 hour data? If so, which report should I choose?

Can I generate a report based on templates added in a given Poller?

Can I generate a report in HUM based on MIB variables added in a Poller?

Can I configure the SNMP Poll Settings in HUM?

What type of SNMP support does HUM provide?

Why is the Report Job failing when I select the Add Full Report option?

Why are my Report Jobs taking longer time to run?

Why am I not able to load a new MIB file into HUM?

Q. What is CiscoWorks Health and Utilization Monitor (HUM)?

A. CiscoWorks HUM is a SNMP-based MIB polling application that monitors and historically trends network devices for their availability and utilization levels.

Q. How many devices can HUM monitor?

A. CiscoWorks HUM can monitor up to 1000 devices based on the license used. For license information, see the Installing and Getting Started With CiscoWorks LAN Management Solution.

Q. What polling intervals does HUM support?

A. The following polling intervals are supported in HUM: 1 minute, 5 minutes, 15 minutes, 30 minutes, 60 minutes, 120 minutes, 240 minutes, and 480 minutes.

Q. How many MIB objects can HUM monitor?

A. CiscoWorks HUM can monitor up to 100,000 MIB objects. CiscoWorks HUM can monitor 40,000 MIB objects for one minute polling and 100,000 MIB objects for five minutes polling.

Q. What MIBs does HUM use to query the device?

A. CiscoWorks HUM supports the following Cisco MIBs, by default:

CISCO-ENHANCED-MEMPOOL-MIB

CISCO-ENVMON-MIB

CISCO-MEMORY-POOL-MIB

CISCO-PROCESS-MIB

ENTITY-MIB

OLD-CISCO-CHASSIS-MIB

RFC1213-MIB

IF-MIB

However, you can also compile and use other MIB files into HUM that support Cisco devices. See Load MIB Files.

Q. What parameters can HUM monitor in a device?

A. CiscoWorks HUM can monitor the CPU utilization, memory utilization, interface utilization, interface availability, device availability, interface error rate and environmental temperature in a device using System-defined templates.

Q. How can I stop a Poller from polling the devices?

A. Yes. You can use the Deactivate feature in the Poller Management page to stop a Poller from polling the devices. In this case, the license count on the number of devices to poll is not reduced when you deactivate a Poller.

Q. Can I create my own custom templates and poll the devices using it?

A. Yes. HUM allows you to create user-defined templates by leveraging MIB variables from an existing System-defined template, or by grouping MIB variables from a compiled MIB file. You can use the templates to poll all Cisco devices that support the specific MIB.

Q. What does Transient and Permanent failures mean?

A. Transient is a failure status displayed if the device is down, the SNMP credentials are incorrect, or the SNMP request times out. Permanent is a failure status displayed if the polled MIB variables or instances are not available.

Q. What are Missed Cycles?

A. Missed Cycle occurs if a Poller takes more than the required time to complete polling and miss the scheduled polling cycle.

For instance, if the Polling Interval for a Poller is set as 15 minutes and the first polling cycle starts at 10:00 a.m., the next polling cycle is scheduled to start at 10:15 a.m.

If the polling cycle that started at 10.00 a.m. does not complete before 10:15 a.m., then the next polling cycle will start only at 10:30 a.m. The polling cycle missed at 10:15 is called Missed Cycle.

Q. Can I export a template from HUM to a directory location?

A. Yes. You can export a template to a directory location where the HUM application is installed. The exported file is in XML format. You can export both System-defined templates and User-defined templates. For more information, see Exporting a Template.

Q. Can I use an external MIB file in HUM?

A. Yes. You can use the Load MIB option in HUM to load an external MIB file. HUM compiles this new MIB file. You can use the new MIB file to create user-defined templates. For more information, see, Load MIB Files.

Q. How can I create a threshold for a MIB variable?

A. Threshold is an optimal value set for a MIB variable by the user or the system. You can create and set threshold rules for all devices that are selected for polling.

Threshold rules are set for one MIB variable at a time and you can set many thresholds for each MIB variable. Fore more information, see Creating a Threshold.

Q. Can I receive alerts or notifications when a threshold rule is violated?

A. Yes. CiscoWorks HUM supports triggering of user-specified external commands or scripts against threshold violations. It also provides E-mail notifications when a threshold rule is violated.

Q. Can I view the complete details of a device from a single report?

A. Yes. Device Dashboard report displays the complete details of the device polled using the System-defined and user-defined templates.

Q. Can I configure HUM to send the PDF format of reports as an E-mail?

A. Yes. You can configure HUM to send the PDF format of the report as an E-mail attachment.

You need to enable the E-mail Attachment checkbox and specify the Maximum Attachment size in the System Preferences dialog box (Common Services > Server > Admin > System Preferences) to send the PDF as an E-mail.

If the PDF file size exceeds the Maximum Attachment size, the URL link of the report is sent as an e-mail. You can click the URL link to view the report.

Q. Can I configure HUM to publish PDF format of reports to a directory location?

A. Yes. You can configure a default report publish path to which PDF format of the reports are published.

Q. Can I set log levels for individual application modules? Where are these log files stored?

A. Yes. You can set log levels for all HUM modules. Log files are stored at these locations:

On Windows: NMSROOT\log\, where NMSROOT is the CiscoWorks HUM installation directory.

On Solaris: /var/adm/CSCOpx/log/

Report specific logs are stored under HUMReportJobs under the log directory. For more information, see Set Log Levels.

Q. Can I change the frequency of Quick Report generation?

A. Yes. You can change the frequency of generating Quick Reports using the option, Quick Report Schedule. By default, Quick Reports are generated every hour.

Q. Can I generate a report in HUM to view the last 24 hour data? If so, which report should I choose?

A. Yes. You can use the Quick Reports option in HUM to view the reports on the last 24 hours data.

Q. Can I generate a report based on templates added in a given Poller?

A. Yes. You can use the Poller Reports option to generate reports based on templates added in a given Poller.

Q. Can I generate a report in HUM based on MIB variables added in a Poller?

A. Yes. You can use the Custom Reports option to generate reports on MIB variables added in a Poller.

Q. Can I configure the SNMP Poll Settings in HUM?

A. Yes. HUM allows you to configure polling settings using the Poll Settings option. You can configure the SNMP timeout and SNMP retries based on the device and the network response time.

Q. What type of SNMP support does HUM provide?

A. CiscoWorks HUM supports SNMP v1, SNMP v2c and SNMP v3 (authPriv, authNoPriv and noAuthNoPriv modes). The support of SNMP is decided based on the SNMP credentials configured in the DCR. The choice of using SNMP v3/v2/v1 is decided during instance query.

The support of SNMP v3 authPriv mode is available from LMS 3.0.1. See SNMP Support.

Q. Why is the Report Job failing when I select the Add Full Report option?

A. If you have selected large number of instances to create a full report (includes graphs), the job might fail because of insufficient memory. You can reduce the number of instances and then try creating the report.

Q. Why are my Report Jobs taking longer time to run?

A. If you have added large number of instances and have also selected the Add Full Report option, the report job will generate graphs for each of the selected instances, which will take long time to generate the report. Either you must reduce the number of instances selected or disable the Add Full Report option.

Q. Why am I not able to load a new MIB file into HUM?

A. Either you have tried to load an invalid or corrupted MIB file, or the dependent MIB files are not available in the directory path. Before you load a MIB file, you need to ensure that the MIB file is valid and all the dependent MIB files are available in the same directory path. To view the list of dependent MIB files go to: http://tools.cisco.com/Support/SNMP/do/BrowseMIB.do?local=en&step=2

Troubleshooting HUM

Table 9-1 lists the error messages for HUM workflows.

Table 9-1 Error Messages for HUM Workflows 

Error Message
Probable Cause
Possible Action

You have not entered a Poller name.

Poller Name field is blank.

Enter a Poller name.

You have not selected any instances.

You have not selected device instances from the Available Instances tree.

Select one or more device instances.

The MIB Alias Name field should not be blank.

Alias Name field for the MIB variable is blank. By default, the MIB variable name is shown in the field.

Enter an Alias name.

You can assign a descriptive name as the Alias name for the MIB variable.

After you have named the MIB variable with an Alias name, the variable appears with this Alias name throughout the application.

The MIB Alias name contains invalid characters.

The Alias name for the MIB variable contains invalid characters.

Enter a valid Alias name. Enter a name that contain either alphabets or numerals.

You have not defined a rule.

You have not specified a search criteria in the Advanced Search option.

Use the Advanced Search icon to open the Define Advanced Search Rule window and define a rule for Advanced Search.

Define a search rule by applying the criteria, operator, and search expression.

Threshold Name contains invalid characters.

You have entered invalid characters in the Template Name field.

Enter a valid Threshold name.

The Threshold name can contain a combination of alphabets, numerals and special characters (such as -_.#@&$).

You have entered an invalid E-mail ID.

The format of E-mail ID that you have entered is invalid.

Enter a valid E-mail ID in the format: user@domain.com.

You have selected a To date that is later than the current date.

The To date that you have selected is later than the current date.

Select a To date that is earlier than or the same as the current date.

You have not selected a report.

In the Reports page, you have clicked GO without selecting a report from the drop-down list.

1. Select Reports > Report Management.

The Report page appears.

2. Select a report from the drop-down list in the report type panel and then click GO.

You have selected an invalid Start date.

In the Reports page, you have selected the Start Date that is later than the To and current date.

The Start date should be earlier than the To date and the current date.

You have not selected a template.

You have not selected a template for polling while creating a Poller.

Select a template to poll from the Available Templates list.

You have entered an invalid value.

You have entered a value in the Last field that is less than one day or in fractions of days.

Enter a valid numeric value greater than 0 and less than or equal to 999. You should not enter fractional values.

You have entered an invalid From date and time.

You have selected a From date that is later than the To date.

The From date must always be earlier than the To and the current date.

You have not selected a Poller.

You have not selected a Poller from the Poller Selector.

You must select one or more Pollers from the Poller Selector before clicking the Show MIB Variables button.

You have not selected any devices.

You have not selected a device from the device selector.

You must select one or more devices from the Device Selector before clicking the Show MIB Variables button.

Do not enter more than 100 characters for the Report name.

You have entered more than 100 characters for the Report name.

Enter a Report name with less than or equal to 100 characters.

Enter an OID.

You have not entered OID as the filter string for filtering MIB variables.

Enter an OID as the string to filter the MIB variables.

You have not selected any thresholds.

You have not selected a threshold from the Threshold Selector.

You must select one or more thresholds from the Threshold Selector before before creating a Threshold Violations Report.

Cannot delete these jobs.

You have tried to select and delete one or more jobs that are in Running state.

Select only jobs that are in Scheduled, Successful, Partially Successful, Failed, Missed Start or Suspended states.

You cannot delete jobs that are in Running state.

Select Successful jobs to view output.

You have tried to view the output of Scheduled, Failed or Suspended jobs.

You can view the report output of only Successful or Partially Successful jobs.

You cannot suspend a job that is in a Running state.

You have tried to suspend a job that is in a Running state.

You should suspend only Scheduled jobs.

Cannot connect to the database.

Either the UPMDbEngine process is down or the connection pool is exhausted.

Restart the UPMDbEngine process and retry the same operation after sometime, say 5 minutes.

Job Status Failed

Either:

The JRM process is down or the UPMDbEngine or UPMDbMonitor is down.

Or

Job details are not available for the job. Check for failure reason.

If JRM process is down, restart the JRM process.

If UPMDbEngine or UPMDbMonitor process is down, restart the process.

Create a similar job and try again.

You can select files only from /opt/CSCOpx/hum/templateEx, not from any other location.

You have tried to access some other directory path in the Server Side File Browser during template export.

You are allowed to select files only from the following directory path:

In Windows, $NMSROOT\hum\templateEx

In Solaris, $NMSROOT/hum/templateEx

$NMSROOT is the default CiscoWorks HUM installation directory.

Pollers in Active state are not polling. The Poll Start Time and Poll End Time is not getting updated for the Poller.

You are in ACS mode and the System Identity user is not having the required privileges for running HUM tasks.

For running HUM application tasks, the System Identity user needs to have Super Admin privileges in ACS.

Update the System Identity user with Super Admin privileges and restart the UPMProcess.