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 uses 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 enable or disable any quick report?

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

•Can I compare two MIB variables in HUM?

•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?

•What type of notifications are supported in HUM in case of violations?

•Can I do capacity planning with the help of HUM?

•Why is the data purge job taking a long time to complete?

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 uses 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

•CISCO-POWER-EHTHERNET-EXT-MIB

•POWER-EHTHERNET-MIB

•CISCO-RTMON-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. 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, Traps or Syslog 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 and the time of generating Quick Reports from Reports > Report Job Browser > Quick Report Schedule. By default, Quick Reports are generated every hour.

Q. Can I enable or disable any quick report?

A. User Configurable Quick Reports allows you to enable or disable generating any Quick Report and also to change the frequency of report generation. By default, reports are generated every hour and all Quick Reports are enabled.

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 data of the last 24 hours.

Q. Can I compare two MIB variables in HUM?

A. Yes. CiscoWorks HUM allows you to compare the historical trending of two MIB variables in the form of overlay graphs in Quick Reports. Reports that support overlay graph are Interface Error report, Interface Utilization report, and PoE Port Utilization report.

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 time-out 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 v2 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

Q. What type of notifications are supported in HUM in case of violations?

A. CiscoWorks HUM supports E-mails, Traps and Syslog notifications in case there are any Threshold or TrendWatch violations.

Q. Can I do capacity planning with the help of HUM?

A. The TrendWatch feature in HUM ensures that the capacity, performance or utilization of critical resources remains within the defined service level. It also helps in capacity planning.

You can configure TrendWatches through HUM by setting up rules for each MIBvariable or on thresholds, for a specific time period. You can schedule TrendWatches (Immediate, Once, Daily, Weekly, or Monthly) as jobs and you can configure them to send notifications through e-mail, traps and Syslogs.

Q. Why is the data purge job taking a long time to complete?

A. If the HUM view in LMS Portal is opened and the data purge job is running in parallel, then the data purge job will take longer time to complete. This is because the portlets in the LMS Portal page gets refreshed at frequent intervals which uses a lot of memory. It is recommended to close the HUM view in LMS Portal when data purge job is running.

Troubleshooting HUM

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

Table 11-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.
Could not delete the TrendWatches. The Trend Watch is in Running state	You have tried to delete a TrendWatch that is in Running state.	You can delete only a scheduled TrendWatch.
Could not de-activate the TrendWatches. Job is running.	You have tried to de-activate a TrendWatch that is in Running state.	You can de-activate only a scheduled TrendWatch.
Could not create the $1 TrendWatch because the templates associated with this TrendWatch are not available. Delete this TrendWatch and create a new one.	You have tried to create a TrendWatch based on a template that is not available. This template may have been deleted.	Create a new TrendWatch.
Could not create the $1 TrendWatch because the thresholds associated with this TrendWatch are not available. Delete this TrendWatch and create a new one.	You have tried to create a TrendWatch based on a template that is not available. This template may have been deleted.	Create a new TrendWatch.
You cannot schedule multiple jobs to start at the same time. Check the scheduled time for job. You can schedule a maximum of 2 jobs to start at the same time.	You have tried to schedule more than two quick report jobs to run at the same time.	Change the schedule time for the quick report jobs.