InsightIQ 4.1.3 Installation Guide · Customer Support Centers. Help with online support For questions specific to EMC Online Support registration or access, email [email protected]

IsilonInsightIQVersion 4.1.3

Installation Guide

Copyright © 2009-2019 Dell Inc. or its subsidiaries. All rights reserved.

Published May 2019

Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND

WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF

MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED

IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.

Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.

Published in the USA.

Dell EMCHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.DellEMC.com

2 InsightIQ 4.1.3 Installation Guide

Introduction to this guide 5About this guide........................................................................................... 6Where to go for support............................................................................... 6

System requirements 7InsightIQ system requirements..................................................................... 8Linux computer requirements....................................................................... 8Virtual machine requirements....................................................................... 9Datastore requirements.............................................................................. 10

Install 13Installing InsightIQ.......................................................................................14

Obtain the installation image.......................................................... 14Install and configure InsightIQ on a virtual machine........................ 14Install InsightIQ on a Linux computer..............................................15

Reinstall InsightIQ....................................................................................... 17

Upgrade 19Upgrade recommendations.........................................................................20Upgrade InsightIQ...................................................................................... 20

Configuration 21Specify a datastore.................................................................................... 22

Specify a local datastore................................................................22Specify an NFS datastore..............................................................22

Log in to the InsightIQ application.............................................................. 22Configuring cluster monitoring................................................................... 23

Monitor a cluster........................................................................... 23

Uninstall 25Uninstall InsightIQ...................................................................................... 26

Chapter 1

Chapter 2

Chapter 3

Chapter 4

Chapter 5

Chapter 6

CONTENTS

InsightIQ 4.1.3 Installation Guide 3

CONTENTS


CHAPTER 1

Introduction to this guide

This section contains the following topics:

l About this guide................................................................................................... 6l Where to go for support.......................................................................................6

Introduction to this guide 5

About this guideThis guide provides installation and upgrade information for InsightIQ.

For compatibility information with other Isilon products, refer to the IsilonSupportability and Compatibility Guide.

Where to go for supportIf you have any questions about EMC Isilon products, contact EMC Isilon TechnicalSupport.

Online Support Live Chat

Create a Service Request

Telephone Support United States: 1-800-SVC-4EMC (800-782-4362)

Canada: 800-543-4782

Worldwide: +1-508-497-7901

For local phone numbers for a specific country, see EMCCustomer Support Centers.

Help with onlinesupport

For questions specific to EMC Online Support registration oraccess, email [email protected].

Support for IsilonSD EdgeIf you are running a free version of IsilonSD Edge, community support through EMCcommunity network is available. However, if you have purchased one or more licensesof IsilonSD Edge, you can contact EMC Isilon Technical Support for assistance,provided you have a valid support contract for the product.

Introduction to this guide


http://www.emc.com/collateral/TechnicalDocument/docu44518.pdf

http://www.emc.com/collateral/TechnicalDocument/docu44518.pdf

https://support.emc.com/servicecenter/liveChat/

https://support.emc.com/servicecenter/createSR/

http://www.emc.com/collateral/contact-us/h4165-csc-phonelist-ho.pdf

http://www.emc.com/collateral/contact-us/h4165-csc-phonelist-ho.pdf

mailto:[email protected]

CHAPTER 2

System requirements


l InsightIQ system requirements.............................................................................8l Linux computer requirements...............................................................................8l Virtual machine requirements...............................................................................9l Datastore requirements...................................................................................... 10

System requirements 7

InsightIQ system requirementsTo run InsightIQ, the environment must meet cluster, licensing, browser, anddatastore requirements.

OneFSThe 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 notsupport.

To use the File System Analytics feature with OneFS versions later than 8.0.0, enablethe NFS service and ports 111, 300, 302, 304, and 2049 on all monitored clusters. TheFile System Analytics feature is enabled by default on OneFS versions 8.0.0 and later.

InsightIQ portEnable the port through which web browsers connect to InsightIQ over HTTPS orHTTP. By default, this setting is port 443 for HTTPS and port 80 for HTTP. Forinformation about modifying this port, see the InsightIQ User Guide.

Web browserYou can access the Isilon InsightIQ application using any of the following browsers:

l Microsoft Edge 42.17134.1.0

l Microsoft Internet Explorer 11.590.17134.0

l Mozilla Firefox v61.0

l Google Chrome v73.0.3683.103

l Apple Safari 12.0.3 (13606.4.5.3.1)

The InsightIQ web application interface is optimized for a screen that is 1,280 pixelswide.

Environment requirementsInstallation and upgrade should be performed on a system with an unmodified /etc/profile.

Linux computer requirementsYou can install InsightIQ on a physical Linux computer.

Hardware requirementsYou can install InsightIQ on a physical Linux system that meets the following hardwarespecifications:

l x86_64 instruction set (Intel 64 or AMD 64)

l 8 GB RAM

l 5-GB free disk space on the operating system (OS) partition

l 70-GB free disk space on either the local computer or an NFS datastore

Operating system requirementsYou can install InsightIQ on Linux systems running the following operating systemversions:

l CentOS 7.6 and RHEL 7.6

System requirements


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.

l At the command prompt of the computer, run the command

cat /etc/*release*

The operating system reports the currently installed version.

To upgrade the CentOS operating system, perform the following step.

l At the command prompt of the computer, run the command

sudo yum upgrade

The operating system upgrades to the latest available version.

Virtual machine requirementsInsightIQ virtual machine requirements and recommendations.

Before you install InsightIQ on a virtual machine, verify that the environment meetsthese 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

InsightIQ 4.1.3

VMware ESXi version 5.5 • • • •

VMware ESXi version 6.0 • • • •

VMware ESXi version 6.5 • •

VMware Workstation (Windows, Linux) • • • •

VMware Fusion (Mac OS) • • • •

For best performance, follow these environment recommendations:

l Allocate at least 8 GB of RAM to the InsightIQ virtual machine. Allocating less than8GB of RAM might significantly degrade the performance of InsightIQ.

l Ensure that the virtual machine disk performance allows for high read/writeaccess.

l Install the InsightIQ virtual machine on a virtualization environment host that isrunning more processes than processors.

l Ensure that the virtual machine is connected to a network that can communicatewith the monitored cluster.

System requirements

Virtual machine requirements 9

Datastore requirementsInsightIQ collects data and stores that information in the datastore. Below are thedatastore requirements based on if the datastore is being stored locally, on a OneFScluster, or on other NFS servers.

Local datastoreIf InsightIQ is installed on a virtual machine, InsightIQ stores the datastore locally on avirtual hard drive that is included on the InsightIQ virtual machine. If InsightIQ isinstalled 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 followingrequirements:

l Ensure that the local drive contains at least 70 GB of free disk space.

l The datastore location cannot contain an existing InsightIQ datastore.

Isilon OneFS datastoreIf you want to store the datastore on an Isilon OneFS system, the cluster must meetthe following requirements:

l Ensure that the directory contains at least 70 GB of free disk space.


l Verify that the Isilon OneFS operating system supports the version of InsightIQ tobe installed.

l Verify that a valid InsightIQ license is activated on the cluster. If you storeInsightIQ data on an Isilon cluster that is not a monitored cluster, it is necessary tolicense InsightIQ for the monitored cluster.

l Verify that the server includes a correctly configured NFS export rule. The exportrule must export the datastore path, and map the root user on the InsightIQ serverto the user account that owns the export on the NFS server.

l Enable read and write access to the export. Isilon OneFS ships with a default NFSexport rule for the /ifs directory that you can use for InsightIQ. If that defaultNFS export has been modified or deleted, create NFS export rule that allows writeaccess for InsightIQ.

Note

Do not place the InsightIQ datastore in a location included in snapshots, as thedatastore has a high chance of becoming corrupted.

Note

Do not apply a quota to the InsightIQ datastore through the SmartQuotas module. Ifyou limit the size of the InsightIQ datastore through a quota, InsightIQ cannot detectthe available space. The datastore might become full before InsightIQ can delete olderdata to make space available for newer data.

Other NFS datastoreIf you want to store the datastore on a different NFS-based server the NFS servermust meet the following requirements:

l Ensure that the directory contains at least 70 GB of free disk space.


System requirements


l Verify that the server includes a correctly configured NFS export rule. The exportrule must export the datastore path, and map the root user on the InsightIQ serverto the user account that owns the export on the NFS server.

l Enable read and write access to the export rule. This configuration allows InsightIQto mount the server and create the necessary directories and files on the server.

l If you want to connect to an NFS datastore over IPv6, confirm that the IPv6addresses are configured for both InsightIQ and the NFS server.

Note

To avoid datastore connection issues, ensure the NFS server is in the same subnet andhas good network connectivity.

Additional information on datastore disk spaceAn adequate amount of disk space must be available for InsightIQ to store data. It isrecommended that you have at least 70 GB of free disk space, but the amount of datathat your specific InsightIQ datastore requires really depends on the number of nodesthat are monitored and the length of time that you want InsightIQ to retain data.

It is recommended that you increase the size of the InsightIQ datastore by 2 GB pernode 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 diskspace. If InsightIQ is unable to free at least 5 GB of datastore disk space, InsightIQstops monitoring the cluster.

Note

There is no maximum size for an InsightIQ datastore. The size of the datastore doesnot significantly affect performance.

System requirements

Datastore requirements 11

System requirements


CHAPTER 3

Install


l Installing InsightIQ.............................................................................................. 14l Reinstall InsightIQ............................................................................................... 17

Install 13

Installing InsightIQThe procedures for installing and setting up InsightIQ depend on whether you areinstalling InsightIQ on a Linux or virtual machine.

Obtain the installation imageThe InsightIQ installation package is available in three compressed file formats. Theinstallation image that you download depends on the environment you use to deployInsightIQ.

Procedure

1. Obtain the InsightIQ installation files, available at https://support.emc.com

l If you install InsightIQ on a Linux computer, download and save theinstallation script in .sh format.

l If you install InsightIQ as a virtual machine and are running VMware ESXi orVMware Workstation 8 or later, download the .ova installation files. Extractthe files to a location where the VMware software can access them. Deploythese files as an Open Virtualization Format (OVF) template.

l If you install InsightIQ as a virtual machine and are not running VMware ESXior VMware Workstation 8 or later, download the installation files in .zipformat. Extract the files to a location where the VMware software canaccess them.

Install and configure InsightIQ on a virtual machineTo install InsightIQ on a virtual machine, follow these steps:

Procedure

1. Add InsightIQ to the virtual machine inventory.

Note

Depending on the virtualization product you are running, modify the networkconfiguration settings to accommodate InsightIQ. For more information, see theapplicable 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

l If InsightIQ can acquire an IP address through DHCP, the address appearson the console.

l If InsightIQ is unable to acquire an IP address through DHCP, the systemprompts you to configure a static IP address.

l If InsightIQ cannot detect an interface, an error message appears andindicates that no interfaces are available.

Install


https://support.emc.com/

5. Configure the virtualization environment and then restart InsightIQ.

6. Configure network settings.

l To configure DHCP networking mode, make a note of the IP address that isdisplayed on the screen. Access InsightIQ by typing this address in a webbrowser.

l If no IP address is displayed, InsightIQ was unable to acquire an IP addressthrough DHCP. Either configure a static IP address, or configure thenetwork 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 andauthentication issues.

Install InsightIQ on a Linux computerTo install InsightIQ on a Linux computer, follow these steps:

Procedure

1. Log in to a Linux computer as the 'administrator' user with sudo privileges. Ifyou 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 theroot 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 thefollowing steps:

a. Edit the sudoers file:

sudo vi /etc/sudoers

b. Under the line ## Allow root to run any commands anywhere, add thefollowing line:

administrator ALL=(ALL) ALL

Install

Install InsightIQ on a Linux computer 15

c. Save the sudoers file.

2. Install InsightIQ by running the following command, where <path> is the filepath of the .sh installation script:

sudo sh <path>

3. Select how InsightIQ will be installed and press Enter:

l Option 1 - Offline. InsightIQ will be installed using the bundled packages.

l Option 2 - Online. InsightIQ will be installed using yum mirrors.(Recommended)

Note

Confirm that the correct repos are enabled for your OS version. For moreinformation on enabling repos, see the documentation for your OS.

Note

If you use the offline method, we recommend you run the sudo yum updatecommand after InsightIQ is finished installing.

4. Enable access to HTTP port 80 or HTTPS port 443.

The default firewall settings of CentOS prevent access through ports 80 and443. To disable the firewall, and allow access to these ports, run the followingcommands:

sudo systemctl disable firewalld

sudo systemctl stop firewalld

Note

Disabling the firewall allows the iiq_restart, iiq_start, and iiq_stop commands tofunction properly.

Note

To enable access to ports 80 and 443 without disabling the firewall, see theoperating system documentation.

5. (Optional) In InsightIQ 4.1.3, if more than one NIC is detected, you will beprompted to select which NIC to use.

Note

If a single NIC is detected, that NIC will be selected automatically.

Install


Reinstall InsightIQReinstall InsightIQ after uninstalling InsightIQ.

Reinstalling InsightIQ in this manner will allow the settings and datastore to persist inthe new instance.

Procedure

1. Obtain the InsightIQ installation script from the InsightIQ product page in .shformat and download the file to the Linux computer or virtual machine.

2. On the Linux computer or virtual machine, reinstall InsightIQ by running thefollowing command, where <path> is the file path of the .sh installation script:

sudo sh <path>

Install

Reinstall InsightIQ 17

https://support.emc.com/products/15208?siteLocale=en_us#dc=us

Install


CHAPTER 4

Upgrade


l Upgrade recommendations................................................................................ 20l Upgrade InsightIQ.............................................................................................. 20

Upgrade 19

Upgrade recommendationsDuring 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 isminimal.

Note

If you are upgrading your OS to Linux 7.6, there is no upgrade path from Linux 6.x toLinux 7.x. You must perform a clean install of the 7.6 OS, which requires a clean installof InsightIQ 4.1.3 as well.

The following table lists the recommended upgrade paths for InsightIQ.

Table 2 Recommended InsightIQ upgrade paths

Upgrade to InsightIQ version

UpgradefromInsightIQversion

4.1.0 4.1.1 4.1.2 4.1.3

4.1.0 • • •

4.1.1 • •

4.1.2 •

Upgrade InsightIQFollow these steps to upgrade your version of InsightIQ:

Procedure

1. Export the InsightIQ datastore to a location that is not on the InsightIQ hostsystem.

Note

If you are upgrading from Linux 6.x to Linux 7.x on the InsightIQ host system,you must export the InsightIQ datastore before you install the new OS.

Note

It is recommended that you confirm the new installation of InsightIQ withdatastore import is working properly prior to shutting down the old version ofInsightIQ.

2. Perform a new installation of InsightIQ. See the installation section of this guidefor more information.

3. Re-configure InsightIQ settings, Ldap, Ldap groups, local users, and user basedreports.

4. Import the InsightIQ datastore.

Upgrade


CHAPTER 5

Configuration


l Specify a datastore............................................................................................ 22l Log in to the InsightIQ application......................................................................22l Configuring cluster monitoring...........................................................................23

Configuration 21

Specify a datastoreInsightIQ collects data and stores that information in the datastore. You must specifya location for the datastore, and the steps depend on whether you want to store datalocally or on an NFS-mounted system. For more information on the differentrequirements, see Datastore requirements.

Specify a local datastoreTo configure InsightIQ to keep the datastore on a local drive, follow these steps:

Procedure

1. Click Local Datastore.

2. Specify the path of the local datastore.

Option Description

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 emptydirectory on the Linux computer.

3. Click Submit.

Specify an NFS datastoreTo configure InsightIQ to keep the datastore on an NFS-mounted system, follow thesesteps:

Note

You can mount a datastore using the NFSv3 protocol. NFSv4 is not supported.

Procedure

1. Click NFS Mounted Datastore.

2. In the Datastore NFS Server field, type the hostname or IP address of theserver or Isilon cluster hosting the datastore.

3. In the Datastore NFS Server Path field, type the absolute path, beginning witha slash mark (/), to the directory on the server or Isilon cluster hosting thedatastore. This field must contain only ASCII characters.

4. Click Submit.

Log in to the InsightIQ applicationYou can log in to the InsightIQ web application through any supported web browser.

Procedure

1. In any supported web browser, connect to the InsightIQ application.

l If you are connecting to InsightIQ through IPv4, specify the address in thefollowing format:

https://<ip-address-or-hostname>

Configuration


l If you are connecting to InsightIQ through an IPv6 address, specify theaddress in the following format:

https://[<ip-address>]

If you are connecting through IPv6 to a hostname, specify the address in thefollowing format:

https://<hostname>

2. In the Username and Password fields, type a valid username and password.

l If you are logging in to an InsightIQ virtual machine, log in through theadministrator account.

l If you are logging in to a Linux computer, log in through any user accountother than root.

3. If the end user license agreement (EULA) appears, review the EULA, click Ihave read and agree to..., and then click Submit.

Configuring cluster monitoringYou can configure InsightIQ to monitor multiple OneFS clusters. The maximum numberof clusters that you can simultaneously monitor varies depending on the resourcesavailable to InsightIQ and the following recommendations:

l It is recommended that each instance of InsightIQ monitor no more than 80 nodes.

l It is recommended that each instance of InsightIQ monitor no more than 8separate clusters.

Note

If you want to monitor additional nodes or clusters, it is recommended that you deployadditional instances of InsightIQ.

Monitor a clusterConfigure InsightIQ to monitor an initial cluster.

Before you begin

l A valid InsightIQ license must be enabled on the OneFS cluster that you want tomonitor. For more information, contact an Isilon OneFS representative.

l Verify that a local user account for insightiq is enabled and configured with apassword on the OneFS cluster that you want to monitor.

Procedure

1. In the InsightIQ web application, click the Settings tab and then MonitoredClusters on the Settings ribbon, and then click Add Cluster.

Note

The first time that you configure InsightIQ, the Add Cluster dialog box mightalready be displayed by default.

Configuration

Configuring cluster monitoring 23

2. In the Add Cluster dialog box, in the Isilon cluster address field, type thehostname, SmartConnect zone name, or IP address of any node in the clusterthat you want to monitor.

In general, it is recommended that you specify a cluster by a SmartConnectzone that includes CPU load-balancing policies. Alternatively, for clusters withhigh usage and file-heat data, you might want to specify the cluster by the IPaddress or by the hostname of a specific node.

Note

It is recommended that you monitor clusters over a LAN connection. Monitoringclusters over a WAN connection can significantly degrade the performance ofInsightIQ.

Note

Specify IPv6 addresses without surrounding brackets. You can connect overIPv6 only if IPv6 addresses are configured for both the InsightIQ instance andthe 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'sinsightiq administrator account.

5. Click OK.

Configuration


CHAPTER 6

Uninstall


l Uninstall InsightIQ..............................................................................................26

Uninstall 25

Uninstall InsightIQUninstalling InsightIQ does not delete InsightIQ data, user settings, live performancereports, generated live performance reports, performance report schedules, or filesystem reports. If you do not delete this data manually, the data is available if youreinstall InsightIQ on the same computer.

Procedure

1. On the Linux or virtual machine, uninstall InsightIQ by running the followingcommand:

sudo yum erase isilon-insightiq

2. (Optional) To delete all InsightIQ user settings, live performance reports,generated live performance reports, performance report schedules, and filesystem reports, delete the /var/cache/insightiq/ folder from the Linux orvirtual machine.

3. Delete the InsightIQ datastore from the Linux computer, virtual machine, orNFS datastore. The path of the local datastore is /datastore on the InsightIQvirtual 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 themonitored cluster. These reports might still be in use by another instance ofInsightIQ. These reports can also be reused when you restart monitoring thecluster with InsightIQ. Delete the contents of the FSA directory only if you arecertain that no other InsightIQ instances are monitoring the cluster and you donot intend to monitor the cluster with InsightIQ later.

Uninstall


Documents

InsightIQ 4.1.3 Installation Guide · Customer Support Centers. Help with online support For questions specific to EMC Online Support registration or access, email [email protected]