Dell InsightIQ 4.3.0.0 Administration Guide

Troubleshooting InsightIQ can fall into many categories, depending on the issue or error you are encountering. The troubleshooting categories below include high-level steps that you can take for resolution.

Confirm the versions

Confirm that the versions of InsightIQ and the monitored cluster are supported.

Virtual machine issues

If InsightIQ does not detect a virtual machine network interface controller during the boot process, shut down the InsightIQ virtual machine. Then, check the settings for the NIC, and ensure that the network type is correct for the virtualization environment. For example, if you reconfigure the NIC to run in bridged mode. If this issue persists, delete the network interface in the virtualization environment, add network interface, and then restart the InsightIQ virtual machine.

Web-application issues

If you cannot log in to the InsightIQ web application, open the InsightIQ virtual machine command-line interface and configure InsightIQ networking to run in DHCP networking mode. Then try accessing the InsightIQ web application through the DHCP-generated IP address. The results can indicate whether the issue is related to the IP address.

If you are unable to access the InsightIQ web application through a web browser, try clearing the browser cache. The browser might be trying to access InsightIQ through an incorrect port. If the issue is still not resolved, try restarting InsightIQ.

Monitored-cluster issues

If InsightIQ cannot connect to the monitored cluster, try to ping the IP address of any node in the cluster. If you cannot ping a cluster node, verify that the node at the specified IP address is operating correctly and that the IP address is valid. If the issue persists, try connecting to a different node in the monitored cluster by the node's hostname or IP address. If the issue persists, configure a SmartConnect zone on the monitored cluster, and then try to connect to that SmartConnect zone instead of a hostname or IP address.

Unlicensed issues

If an Unlicensed error message appears, log in to the monitored cluster and verify that a valid InsightIQ license has been activated on the cluster.

Unauthorized issues

If an Unauthorized error message appears, verify that the local InsightIQ or OneFS Platform API user on the monitored cluster is enabled and is configured with a valid password. Verify that the corresponding InsightIQ user settings in the InsightIQ application match the settings that are configured on the monitored cluster.

NOTE: The local user on the monitored cluster is named InsightIQ.

Datastore issues

If InsightIQ cannot write to the datastore, check the following settings:

• If the InsightIQ datastore is on a Dell PowerScale system, and an NFS datastore permissions error message appears, verify that a valid NFS export is configured on that cluster.
• If the InsightIQ datastore is on a Dell PowerScale system, and an NFS datastore permissions error message appears, verify that the NFS export is configured to grant write access to the root user for the specified InsightIQ virtual machine IP address. InsightIQ connects to the NFS host as the root user.
• If the InsightIQ datastore in on a local machine and a permissions error message appears, verify that the parent directory of the datastore is configured with a permission setting of 755 or higher.
• If InsightIQ cannot write to the datastore, verify that the permissions settings for the datastore directory and for all the files contained in the directory are set at 744 or higher.
• If InsightIQ cannot write to the datastore, verify that the directory's owner and group settings are correctly configured. For an NFS datastore, the owner:group setting must be nobody:nobody. For a local datastore, the owner:group setting must be root:root.

Datastore migration issues

If InsightIQ is migrating data from or to an NFS datastore, and the connection to the NFS datastore is interrupted, InsightIQ stops migrating data until the connection is restored. If this failure occurs, InsightIQ automatically transfers the datastore back to the original datastore location.

Data retrieval issues

If you experience Data Retrieval Delayed errors, consider disabling the retrieval of the specific data set causing the error.

NOTE: The following data sets do not cause a Data Retrieval Delayed error:

• Disk Performance
• IFS Operation Counters
• IFS Usable Capacity
• Job Engine Statistics
• Per File IFS Operation Counters

Memory issues

If a timeout occurs, restart InsightIQ.

NOTE: Many breakouts or data modules applied to a single report might cause InsightIQ to run out of memory.