Dell EMC Isilon InsightIQ
Installation Guide
4.1.4
January 2021
Rev. 1
Notes, cautions, and warnings
NOTE: A NOTE indicates important information that helps you make better use of your product.
CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid
the problem.
WARNING: A WARNING indicates a potential for property damage, personal injury, or death.
© 2009 - 2021 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries.
Other trademarks may be trademarks of their respective owners.
Contents
Chapter 1: Introduction to this guide............................................................................................. 4
About this guide................................................................................................................................................................... 4
Where to go for support.................................................................................................................................................... 4
Chapter 2: System requirements...................................................................................................5
InsightIQ system requirements.........................................................................................................................................5
Linux computer requirements...........................................................................................................................................6
Virtual machine requirements........................................................................................................................................... 6
Datastore requirements......................................................................................................................................................7
Chapter 3: Install.......................................................................................................................... 9
Installing InsightIQ............................................................................................................................................................... 9
Obtain the installation image.......................................................................................................................................9
Install and configure InsightIQ on a virtual machine..............................................................................................9
Install InsightIQ on a Linux computer...................................................................................................................... 10
Reinstall InsightIQ............................................................................................................................................................... 11
Chapter 4: Upgrade......................................................................................................................12
Upgrade recommendations..............................................................................................................................................12
Upgrade InsightIQ.............................................................................................................................................................. 12
Chapter 5: Configuration............................................................................................................. 14
Specify a datastore............................................................................................................................................................14
Specify a local datastore............................................................................................................................................ 14
Specify an NFS datastore.......................................................................................................................................... 14
Log in to the InsightIQ application................................................................................................................................. 14
Configuring cluster monitoring....................................................................................................................................... 15
Monitor a cluster.......................................................................................................................................................... 15
Chapter 6: Uninstall..................................................................................................................... 16
Uninstall InsightIQ.............................................................................................................................................................. 16
Contents
3
1
Introduction to this guide
This section contains the following topics:
Topics:
•
•
About this guide
Where to go for support
About this guide
This guide provides installation and upgrade information for InsightIQ.
For compatibility information with other Isilon products, refer to the Isilon Supportability and Compatibility Guide.
Where to go for support
If you have any questions about EMC Isilon products, contact EMC Isilon Technical Support.
Online support
● Live Chat
● Create a Service Request
For questions about accessing online support, send an email to support@emc.com.
Telephone
support
●
●
●
●
Community
Network
The connects you to a central hub of information and experts to help you maximize your current storage
solution. From this site, you can demonstrate products, ask questions, view technical videos, and get the
latest product documentation.
Info Hubs
For the list of info hubs, see the Isilon Info Hubs page on the . Use these info hubs to find product
documentation, troubleshooting guides, videos, blogs, and other information resources about the products
and features you're interested in.
4
United States: 1-800-SVC-4EMC (1-800-782-4362)
Canada: 1-800-543-4782
Worldwide: 1-508-497-7901
Local phone numbers for a specific country are available at Dell EMC Customer Support Centers.
Introduction to this guide
2
System requirements
This section contains the following topics:
Topics:
•
•
•
•
InsightIQ system requirements
Linux computer requirements
Virtual machine requirements
Datastore requirements
InsightIQ system requirements
To run InsightIQ, the environment must meet cluster, licensing, browser, and datastore requirements.
OneFS
The monitored cluster must be running OneFS 8.0.0 or later.
InsightIQ can be used with clusters that run versions of OneFS earlier than 8.0.1. However, InsightIQ includes features that
OneFS versions earlier than 8.0.1 do not support.
To use the File System Analytics feature with OneFS versions later than 8.0.0, enable the NFS service and ports 111, 300, 302,
304, and 2049 on all monitored clusters. The File System Analytics feature is enabled by default on OneFS versions 8.0.0 and
later.
InsightIQ port
Enable the port through which web browsers connect to InsightIQ over HTTPS or HTTP. By default, this setting is port 443 for
HTTPS and port 80 for HTTP. For information about modifying this port, see the InsightIQ User Guide.
Web browser
You can access the Isilon InsightIQ application using any of the following browsers:
● Google Chrome v87.0.4280.66.
● Microsoft Edge v87.0.664.47
● Apple Safari v13.0.3
● Mozilla Firefox v78.5.0esr (64-bit)
● Microsoft Internet Explorer 11.590.17134.0
The InsightIQ web application interface is optimized for a screen that is 1,280 pixels wide.
Environment requirements
Installation and upgrade should be performed on a system with an unmodified /etc/profile.
System requirements
5
Linux computer requirements
You can install InsightIQ on a physical Linux computer.
Hardware requirements
You can install InsightIQ on a physical Linux system that meets the following hardware specifications:
● x86_64 instruction set (Intel 64 or AMD 64)
● 8 GB RAM
● 5-GB free disk space on the operating system (OS) partition
● 70-GB free disk space on either the local computer or an NFS datastore
Operating system requirements
You can install InsightIQ on CentOS 7.8 or RHEL 7.8.
InsightIQ is compatible with any installation packages for these operating systems, including the minimal installation packages.
To verify the current version of CentOS, perform the following step.
● At the command prompt of the computer, run the command
cat /etc/*release*
The operating system reports the currently installed version.
Virtual machine requirements
InsightIQ virtual machine requirements and recommendations.
Before you install InsightIQ on a virtual machine, verify that the environment meets these requirements.
Isilon InsightIQ can run on any of the following virtual environments.
Table 1. InsightIQ and VMware Compatibility
Version
InsightIQ
4.1
InsightIQ
4.1.1
InsightIQ
4.1.2
VMware ESXi version 5.5
•
•
•
VMware ESXi version 6.0
•
•
•
•
•
•
VMware ESXi version 6.5
VMware ESXi version 6.7
InsightIQ
4.1.3
InsightIQ
4.1.4
•
VMware ESXi version 7.0 / 7.0 Update 1
•
VMware Workstation (Windows, Linux)
•
•
•
•
•
VMware Fusion (Mac OS)
•
•
•
•
•
For best performance, follow these environment recommendations:
● Allocate at least 8 GB of RAM to the InsightIQ virtual machine. Allocating less than 8GB of RAM might significantly degrade
the performance of InsightIQ.
● Ensure that the virtual machine disk performance allows for high read/write access.
● Install the InsightIQ virtual machine on a virtualization environment host that is running more processes than processors.
● Ensure that the virtual machine is connected to a network that can communicate with the monitored cluster.
6
System requirements
Datastore requirements
InsightIQ collects data and stores that information in the datastore. Below are the datastore requirements based on if the
datastore is being stored locally, on a OneFS cluster, or on other NFS servers.
Local datastore
If InsightIQ is installed on a virtual machine, InsightIQ stores the datastore locally on a virtual hard drive that is included on the
InsightIQ virtual machine. If InsightIQ is installed on a Linux system, InsightIQ stores the datastore on the local hard drive.
If you want to store the datastore on a local drive, the drive must meet the following requirements:
● Ensure that the local drive contains at least 70 GB of free disk space.
● The datastore location cannot contain an existing InsightIQ datastore.
Isilon OneFS datastore
If you want to store the datastore on an Isilon OneFS system, the cluster must meet the following requirements:
●
●
●
●
Ensure that the directory contains at least 70 GB of free disk space.
The datastore location cannot contain an existing InsightIQ datastore.
Verify that the Isilon OneFS operating system supports the version of InsightIQ to be installed.
Verify that a valid InsightIQ license is activated on the cluster. If you store InsightIQ data on an Isilon cluster that is not a
monitored cluster, it is necessary to license InsightIQ for the monitored cluster.
● Verify that the server includes a correctly configured NFS export rule. The export rule must export the datastore path, and
map the root user on the InsightIQ server to the user account that owns the export on the NFS server.
● Enable read and write access to the export. Isilon OneFS ships with a default NFS export rule for the /ifs directory that
you can use for InsightIQ. If that default NFS export has been modified or deleted, create NFS export rule that allows write
access for InsightIQ.
NOTE: Do not place the InsightIQ datastore in a location included in snapshots, as the datastore has a high chance of
becoming corrupted.
NOTE: Do not apply a quota to the InsightIQ datastore through the SmartQuotas module. If you limit the size of the
InsightIQ datastore through a quota, InsightIQ cannot detect the available space. The datastore might become full before
InsightIQ can delete older data to make space available for newer data.
Other NFS datastore
If you want to store the datastore on a different NFS-based server the NFS server must meet the following requirements:
● Ensure that the directory contains at least 70 GB of free disk space.
● The datastore location cannot contain an existing InsightIQ datastore.
● Verify that the server includes a correctly configured NFS export rule. The export rule must export the datastore path, and
map the root user on the InsightIQ server to the user account that owns the export on the NFS server.
● Enable read and write access to the export rule. This configuration allows InsightIQ to mount the server and create the
necessary directories and files on the server.
● If you want to connect to an NFS datastore over IPv6, confirm that the IPv6 addresses are configured for both InsightIQ and
the NFS server.
NOTE: To avoid datastore connection issues, ensure the NFS server is in the same subnet and has good network
connectivity.
Additional information on datastore disk space
An adequate amount of disk space must be available for InsightIQ to store data. It is recommended that you have at least 70 GB
of free disk space, but the amount of data that your specific InsightIQ datastore requires really depends on the number of nodes
that are monitored and the length of time that you want InsightIQ to retain data.
System requirements
7
It is recommended that you increase the size of the InsightIQ datastore by 2 GB per node for each month of retained data.
Use the following equation to calculate the minimum size of your specific datastore:
<minimum_datastore_size_in_GB> = 2*<number_of_nodes>*<number_of_months> + 10
NOTE: The +10 at the end of the equation is to cover the recommended 10 GB of free disk space. If InsightIQ is unable to
free at least 5 GB of datastore disk space, InsightIQ stops monitoring the cluster.
NOTE: There is no maximum size for an InsightIQ datastore. The size of the datastore does not significantly affect
performance.
Related tasks
Specify an NFS datastore on page 14
8
System requirements
3
Install
This section contains the following topics:
Topics:
•
•
Installing InsightIQ
Reinstall InsightIQ
Installing InsightIQ
The procedures for installing and setting up InsightIQ depend on whether you are installing InsightIQ on a Linux or virtual
machine.
Related references
InsightIQ system requirements on page 5
Obtain the installation image
The InsightIQ installation package is available in three compressed file formats. The installation image that you download
depends on the environment you use to deploy InsightIQ.
Obtain the InsightIQ installation files, available at https://support.emc.com
● If you install InsightIQ on a Linux computer, download and save the installation script in .sh format.
● If you install InsightIQ as a virtual machine and are running VMware ESXi or VMware Workstation 8 or later, download
the .ova installation files. Extract the files to a location where the VMware software can access them. Deploy these files as
an Open Virtualization Format (OVF) template.
● If you install InsightIQ as a virtual machine and are not running VMware ESXi or VMware Workstation 8 or later, download
the installation files in .zip format. Extract the files to a location where the VMware software can access them.
Install and configure InsightIQ on a virtual machine
To install InsightIQ on a virtual machine, follow these steps:
1. Add InsightIQ to the virtual machine inventory.
NOTE: Depending on the virtualization product you are running, modify the network configuration settings to
accommodate InsightIQ. For more information, see the applicable product documentation.
2. Open the virtualization environment console for InsightIQ.
3. Create a password for the administrator account.
a. Type a password for the administrator account, and then press ENTER.
b. Retype the password for the administrator account, and then press ENTER.
4. Acquire an IP address
● If InsightIQ can acquire an IP address through DHCP, the address appears on the console.
● If InsightIQ is unable to acquire an IP address through DHCP, the system prompts you to configure a static IP address.
● If InsightIQ cannot detect an interface, an error message appears and indicates that no interfaces are available.
5. Configure the virtualization environment and then restart InsightIQ.
6. Configure network settings.
Install
9
● To configure DHCP networking mode, make a note of the IP address that is displayed on the screen. Access InsightIQ by
typing this address in a web browser.
● If no IP address is displayed, InsightIQ was unable to acquire an IP address through DHCP. Either configure a static IP
address, or configure the network to support DHCP.
NOTE: It is recommended that you run InsightIQ in manual networking mode. A DHCP-generated IP address can expire
without warning, causing data collection and authentication issues.
Related references
Virtual machine requirements on page 6
Install InsightIQ on a Linux computer
To install InsightIQ on a Linux computer, follow these steps:
1. Log in to a Linux computer as the 'administrator' user with sudo privileges. If you need to create the 'administrator' user,
follow these sub-steps:
a. Log in to a Linux computer through a user account with sudo access or the root user account.
b. Create a user account with 'administrator' as the name.
sudo useradd administrator
c. Create a password for the user.
sudo passwd administrator
d. Grant the user membership to a privileged group.
sudo usermod -aG wheel administrator
e. Grant the user permission to run any command anywhere by performing the following steps:
i.
Edit the sudoers file:
sudo vi /etc/sudoers
ii. Under the line ## Allow root to run any commands anywhere, add the following line:
administrator ALL=(ALL)
ALL
iii. Save the sudoers file.
2. Install InsightIQ by running the following command, where <path> is the file path of the .sh installation script:
sudo sh <path>
3. Select how InsightIQ will be installed and press Enter:
● Option 1 - Offline. InsightIQ will be installed using the bundled packages.
● Option 2 - Online. InsightIQ will be installed using yum mirrors. (Recommended)
NOTE: Confirm that the correct repos are enabled for your OS version. For more information on enabling repos, see the
documentation for your OS.
NOTE: If you use the offline method, we recommend you run the sudo yum update command after InsightIQ is
finished installing.
4. Enable access to HTTP port 80 or HTTPS port 443.
10
Install
The default firewall settings of CentOS prevent access through ports 80 and 443. To disable the firewall, and allow access to
these ports, run the following commands:
sudo systemctl disable firewalld
sudo systemctl stop firewalld
NOTE: Disabling the firewall allows the iiq_restart, iiq_start, and iiq_stop commands to function properly.
NOTE: To enable access to ports 80 and 443 without disabling the firewall, see the operating system documentation.
5. (Optional) If more than one NIC is detected, you will be prompted to select which NIC to use.
NOTE: If a single NIC is detected, that NIC will be selected automatically.
Related references
Linux computer requirements on page 6
Reinstall InsightIQ
Reinstall InsightIQ after uninstalling InsightIQ.
Reinstalling InsightIQ in this manner will allow the settings and datastore to persist in the new instance.
1. Obtain the InsightIQ installation script from the InsightIQ product page in .sh format and download the file to the Linux
computer or virtual machine.
2. On the Linux computer or virtual machine, reinstall InsightIQ by running the following command, where <path> is the file
path of the .sh installation script:
sudo sh <path>
Install
11
4
Upgrade
This section contains the following topics:
Topics:
•
•
Upgrade recommendations
Upgrade InsightIQ
Upgrade recommendations
During the upgrade process, InsightIQ is unable to collect data for monitored clusters. It is recommended that you upgrade
InsightIQ at a time when cluster activity is minimal.
NOTE: If your InsightIQ host is on Linux 6.x, you must first perform a clean install of the Linux 7.x OS, and then perform a
clean install of InsightIQ, because the latest versions of InsightIQ require at least Linux v7.x, and there is no upgrade path
from Linux 6.x to Linux 7.x.
Table 2. Recommended InsightIQ upgrade paths
Upgrade to InsightIQ version
Upgrade from
InsightIQ 4.1.0
4.1.1
4.1.2
4.1.3
4.1.4
•
•
•
•
•
•
•
•
•
InsightIQ 4.1.1
InsightIQ 4.1.2
InsightIQ 4.1.3
•
Upgrade InsightIQ
Follow these steps to upgrade your version of InsightIQ:
1. Recommended: Export the InsightIQ datastore to a location that is not on the InsightIQ host system.
NOTE:
● If you are upgrading from Linux 6.x to Linux 7.x on the InsightIQ host system, this step is required.
● It is recommended that you confirm the new installation of InsightIQ with datastore import is working properly prior
to shutting down the old version of InsightIQ.
2. Upgrade to RHEL or CentOS 7.8:
NOTE: Do not use the sudo yum update command by itself, as this may update the OS to a version that InsightIQ is
not certified to work on.
● For RHEL 7.x:
sudo yum upgrade --releasever=7.8
● For CentOS 7.x:
sudo yum upgrade --releasever=7.8
You may need to update the location of your vault repository to a server with CentOS 7.8. To see an example, see
https://digitolle.wordpress.com/2017/10/26/how-to-upgrade-centos-to-a-specific-version.
12
Upgrade
● For RHEL 6.x or CentOS 6.x : Perform a clean installation of RHEL 7.8 or CentOS 7.8.
3. Optional: Add the latest security patches:
● For RHEL:
sudo yum -y update --security
● For CentOS:
sudo yum --security update
4. Download the installation script and transfer it to the InsightIQ server, for example, to /home.
5. Use the script to upgrade InsightIQ to 4.1.4:
sudo sh /home/install-insightiq-4.1.4.xx.sh
6. Re-configure InsightIQ settings, LDAP, LDAP groups, local users, and user-based reports.
7. Import the InsightIQ datastore.
Upgrade
13
5
Configuration
This section contains the following topics:
Topics:
•
•
•
Specify a datastore
Log in to the InsightIQ application
Configuring cluster monitoring
Specify a datastore
InsightIQ collects data and stores that information in the datastore. You must specify a location for the datastore, and the
steps depend on whether you want to store data locally or on an NFS-mounted system. For more information on the different
requirements, see Datastore requirements.
Specify a local datastore
To configure InsightIQ to keep the datastore on a local drive, follow these steps:
1. Click Local Datastore.
2. Specify the path of the local datastore.
For a virtual machine
In the Datastore Path field, type /datastore.
For a local drive
In the Datastore Path field, type the path of an empty directory on the Linux computer.
3. Click Submit.
Specify an NFS datastore
To configure InsightIQ to keep the datastore on an NFS-mounted system, follow these steps:
NOTE: You can mount a datastore using the NFSv3 protocol. NFSv4 is not supported.
1. Click NFS Mounted Datastore.
2. In the Datastore NFS Server field, type the hostname or IP address of the server or Isilon cluster hosting the datastore.
3. In the Datastore NFS Server Path field, type the absolute path, beginning with a slash mark (/), to the directory on the
server or Isilon cluster hosting the datastore. This field must contain only ASCII characters.
4. Click Submit.
Related concepts
Datastore requirements on page 7
Log in to the InsightIQ application
You can log in to the InsightIQ web application through any supported web browser.
1. In any supported web browser, connect to the InsightIQ application.
● If you are connecting to InsightIQ through IPv4, specify the address in the following format:
https://<ip-address-or-hostname>
14
Configuration
● If you are connecting to InsightIQ through an IPv6 address, specify the address in the following format:
https://[<ip-address>]
If you are connecting through IPv6 to a hostname, specify the address in the following format:
https://<hostname>
2. In the Username and Password fields, type a valid username and password.
● If you are logging in to an InsightIQ virtual machine, log in through the administrator account.
● If you are logging in to a Linux computer, log in through any user account other than root.
3. If the end user license agreement (EULA) appears, review the EULA, click I have read and agree to..., and then click
Submit.
Configuring cluster monitoring
You can configure InsightIQ to monitor multiple OneFS clusters. The maximum number of clusters that you can simultaneously
monitor varies depending on the resources available to InsightIQ and the following recommendations:
● It is recommended that each instance of InsightIQ monitor no more than 80 nodes.
● It is recommended that each instance of InsightIQ monitor no more than 8 separate clusters.
NOTE: If you want to monitor additional nodes or clusters, it is recommended that you deploy additional instances of
InsightIQ.
Monitor a cluster
Configure InsightIQ to monitor an initial cluster.
On the OneFS cluster that you want to monitor, you must have the following:
● A valid InsightIQ license must be enabled.
● A local user account for insightiq must be enabled, configured with a password, and within the System Zone.
1. In the InsightIQ web application, click the Settings tab and then Monitored Clusters on the Settings ribbon, and then
click Add Cluster.
NOTE: The first time that you configure InsightIQ, the Add Cluster dialog box might already be displayed by default.
2. In the Add Cluster dialog box, in the Isilon cluster address field, type the hostname, SmartConnect zone name, or IP
address of any node in the cluster that you want to monitor.
In general, it is recommended that you specify a cluster by a SmartConnect zone that includes CPU load-balancing policies.
Alternatively, for clusters with high usage and file-heat data, you might want to specify the cluster by the IP address or by
the hostname of a specific node.
NOTE: It is recommended that you monitor clusters over a LAN connection. Monitoring clusters over a WAN connection
can significantly degrade the performance of InsightIQ.
NOTE: Specify IPv6 addresses without surrounding brackets. You can connect over IPv6 only if IPv6 addresses are
configured for both the InsightIQ instance and the monitored cluster.
3. In the InsightIQ user name field, type insightiq.
4. In the InsightIQ user password field, type the password of the OneFS cluster's insightiq administrator account.
5. Click OK.
Related references
InsightIQ system requirements on page 5
Configuration
15
6
Uninstall
This section contains the following topics:
Topics:
•
Uninstall InsightIQ
Uninstall InsightIQ
Uninstalling InsightIQ does not delete InsightIQ data, user settings, live performance reports, generated live performance
reports, performance report schedules, or file system reports. If you do not delete this data manually, the data is available if you
reinstall InsightIQ on the same computer.
1. On the Linux or virtual machine, uninstall InsightIQ by running the following command:
sudo yum erase isilon-insightiq
2. Optional: To delete all InsightIQ user settings, live performance reports, generated live performance reports, performance
report schedules, and file system reports, delete the /var/cache/insightiq/ folder from the Linux or virtual machine.
3. Delete the InsightIQ datastore from the Linux computer, virtual machine, or NFS datastore. The path of the local datastore
is /datastore on the InsightIQ virtual machine.
4. To remove FSA reports from a monitored cluster, delete the contents of the /ifs/.ifsvar/modules/fsa directory on
the cluster.
NOTE: Deleting the contents of the FSA directory delete all FSA reports stored on the monitored cluster. These reports
might still be in use by another instance of InsightIQ. These reports can also be reused when you restart monitoring the
cluster with InsightIQ. Delete the contents of the FSA directory only if you are certain that no other InsightIQ instances
are monitoring the cluster and you do not intend to monitor the cluster with InsightIQ later.
16
Uninstall