isilon insightiq installation guide...modified or deleted, create nfs export rule that allows write...

Isilon InsightIQVersion 4.1.3

Installation GuideFebruary 2020

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

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 Technologies, Dell, EMC, 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 Isilon InsightIQ 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..............................................................................................16

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

Isilon InsightIQ 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


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

For compatibility information with other Isilon products, refer to the Isilon Supportability andCompatibility Guide.

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

Online support l Live Chat

l Create a Service Request

For questions about accessing online support, send an email to [email protected].

Telephonesupport

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

l Canada: 1-800-543-4782

l Worldwide: 1-508-497-7901

l Local phone numbers for a specific country are available at Dell EMCCustomer Support Centers.

CommunityNetwork

The connects you to a central hub of information and experts to help youmaximize your current storage solution. From this site, you can demonstrate products, ask questions, view technical videos, and get the latest productdocumentation.

Info Hubs For the list of info hubs, see the Isilon Info Hubs page on the . Use these infohubs to find product documentation, troubleshooting guides, videos, blogs, andother information resources about the products and features you're interestedin.

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/

mailto:[email protected]

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

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

https://community.emc.com/docs/DOC-44304

CHAPTER 2

System requirements


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


InsightIQ system requirementsTo run InsightIQ, the environment must meet cluster, licensing, browser, and datastorerequirements.

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 NFSservice and ports 111, 300, 302, 304, and 2049 on all monitored clusters. The File System Analyticsfeature 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. Bydefault, this setting is port 443 for HTTPS and port 80 for HTTP. For information about modifyingthis port, see the InsightIQ User Guide.

Web browser

You 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 pixels wide.

Environment requirements

Installation 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 requirements

You 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 requirements

You can install InsightIQ on Linux systems running the following operating system versions:

l CentOS 7.6 and RHEL 7.6

InsightIQ is compatible with any installation packages for these operating systems, including theminimal installation packages.

System requirements


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 meets theserequirements.

Isilon InsightIQ can run on any of the following virtual environments.

Table 1 InsightIQ and VMware Compatibility

Version InsightIQ4.1

InsightIQ4.1.1

InsightIQ4.1.2

InsightIQ4.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 than 8GB ofRAM might significantly degrade the performance of InsightIQ.

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

l Install the InsightIQ virtual machine on a virtualization environment host that is running moreprocesses than processors.

l Ensure that the virtual machine is connected to a network that can communicate with themonitored cluster.

System requirements


Datastore requirementsInsightIQ collects data and stores that information in the datastore. Below are the datastorerequirements based on if the datastore is being stored locally, on a OneFS cluster, or on other NFSservers.

Local datastore

If InsightIQ is installed on a virtual machine, InsightIQ stores the datastore locally on a virtual harddrive 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:

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 datastore

If you want to store the datastore on an Isilon OneFS system, the cluster must meet the followingrequirements:

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 to be installed.

l Verify that a valid InsightIQ license is activated on the cluster. If you store InsightIQ data on anIsilon cluster that is not a monitored cluster, it is necessary to license InsightIQ for themonitored cluster.

l Verify that the server includes a correctly configured NFS export rule. The export rule mustexport the datastore path, and map the root user on the InsightIQ server to the user accountthat owns the export on the NFS server.

l Enable read and write access to the export. Isilon OneFS ships with a default NFS export rulefor the /ifs directory that you can use for InsightIQ. If that default NFS export has beenmodified 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 datastorehas a high chance of becoming corrupted.

Note: Do not apply a quota to the InsightIQ datastore through the SmartQuotas module. If youlimit the size of the InsightIQ datastore through a quota, InsightIQ cannot detect the availablespace. The datastore might become full before InsightIQ can delete older data to make spaceavailable for newer data.

Other NFS datastore

If you want to store the datastore on a different NFS-based server the NFS server must meet thefollowing requirements:

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


l Verify that the server includes a correctly configured NFS export rule. The export rule mustexport the datastore path, and map the root user on the InsightIQ server to the user accountthat owns the export on the NFS server.

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

System requirements


l If you want to connect to an NFS datastore over IPv6, confirm that the IPv6 addresses areconfigured 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 space

An adequate amount of disk space must be available for InsightIQ to store data. It is recommendedthat you have at least 70 GB of free disk space, but the amount of data that your specific InsightIQdatastore requires really depends on the number of nodes that are monitored and the length oftime that you want InsightIQ to retain data.

It is recommended that you increase the size of the InsightIQ datastore by 2 GB per node for eachmonth 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, InsightIQ stopsmonitoring the cluster.

Note: There is no maximum size for an InsightIQ datastore. The size of the datastore does notsignificantly affect performance.

System requirements


System requirements


CHAPTER 3

Install


l Installing InsightIQ................................................................................................................. 14l Reinstall InsightIQ.................................................................................................................. 16


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

Obtain the installation imageAbout this task

The InsightIQ installation package is available in three compressed file formats. The installationimage that you download depends on the environment you use to deploy InsightIQ.

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 the installation scriptin .sh format.

l If you install InsightIQ as a virtual machine and are running VMware ESXi or VMwareWorkstation 8 or later, download the .ova installation files. Extract the files to a locationwhere the VMware software can access them. Deploy these files as an OpenVirtualization Format (OVF) template.

l If you install InsightIQ as a virtual machine and are not running VMware ESXi or VMwareWorkstation 8 or later, download the installation files in .zip format. Extract the files toa location where the VMware software can access them.

Install and configure InsightIQ on a virtual machineAbout this task

To 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 appears on theconsole.

l If InsightIQ is unable to acquire an IP address through DHCP, the system prompts you toconfigure a static IP address.

l If InsightIQ cannot detect an interface, an error message appears and indicates that nointerfaces are available.

5. Configure the virtualization environment and then restart InsightIQ.

Install


https://support.emc.com/

6. Configure network settings.

l To configure DHCP networking mode, make a note of the IP address that is displayed onthe screen. Access InsightIQ by typing this address in a web browser.

l If no IP address is displayed, InsightIQ was unable to acquire an IP address throughDHCP. 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 andauthentication issues.

Install InsightIQ on a Linux computerAbout this task

To install InsightIQ on a Linux computer, follow these steps:

Procedure

1. Log in to a Linux computer as the 'administrator' user with sudo privileges. If you need tocreate the 'administrator' user, follow these sub-steps:

a. Log in to a Linux computer through a user account with sudo access or the root useraccount.

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 followingsteps:

a. Edit the sudoers file:

sudo vi /etc/sudoers

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

administrator ALL=(ALL) ALL

c. Save the sudoers file.

Install


2. Install InsightIQ by running the following command, where <path> is the file path of the .shinstallation 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 and 443. To disablethe 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 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 be prompted toselect which NIC to use.

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

Reinstall InsightIQReinstall InsightIQ after uninstalling InsightIQ.

About this task

Reinstalling InsightIQ in this manner will allow the settings and datastore to persist in the newinstance.

Procedure

1. Obtain the InsightIQ installation script from the InsightIQ product page in .sh format anddownload the file to the Linux computer or virtual machine.

Install


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

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

sudo sh <path>

Install


Install


CHAPTER 4

Upgrade


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


Upgrade recommendationsDuring the upgrade process, InsightIQ is unable to collect data for monitored clusters. It isrecommended that you upgrade InsightIQ at a time when cluster activity is minimal.

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 install ofInsightIQ 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 InsightIQAbout this task

Follow these steps to upgrade your version of InsightIQ:

Procedure

1. 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, youmust 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 of InsightIQ.

2. Perform a new installation of InsightIQ. See the installation section of this guide for moreinformation.

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

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


Specify a datastoreAbout this task

InsightIQ collects data and stores that information in the datastore. You must specify a locationfor 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 datastoreAbout this task

To 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 empty directory onthe Linux computer.

3. Click Submit.

Specify an NFS datastoreAbout this task

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.

Procedure

1. Click NFS Mounted Datastore.

2. In the Datastore NFS Server field, type the hostname or IP address of the server or Isiloncluster hosting the datastore.

3. In the Datastore NFS Server Path field, type the absolute path, beginning with a slashmark (/), to the directory on the server or Isilon cluster hosting the datastore. This fieldmust contain only ASCII characters.

4. Click Submit.

Log in to the InsightIQ applicationAbout this task

You 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.

Configuration


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

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

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

https://[<ip-address>]

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

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 the administratoraccount.

l If you are logging in to a Linux computer, log in through any user account other thanroot.

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

Configuring cluster monitoringAbout this task

You can configure InsightIQ to monitor multiple OneFS clusters. The maximum number of clustersthat you can simultaneously monitor varies depending on the resources available to InsightIQ andthe 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 8 separate 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 to monitor. Formore information, contact an Isilon OneFS representative.

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

Procedure

1. In the InsightIQ web application, click the Settings tab and then Monitored Clusters on theSettings 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


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 tomonitor.

In general, it is recommended that you specify a cluster by a SmartConnect zone thatincludes 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 aspecific node.

Note: It is recommended that you monitor clusters over a LAN connection. Monitoringclusters over a WAN connection can significantly degrade the performance of InsightIQ.

Note: Specify IPv6 addresses without surrounding brackets. You can connect over IPv6only if IPv6 addresses are configured for both the InsightIQ instance and the monitoredcluster.

3. In the InsightIQ user name field, type insightiq.

4. In the InsightIQ user password field, type the password of the OneFS cluster's insightiqadministrator account.

5. Click OK.

Configuration


CHAPTER 6

Uninstall


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


Uninstall InsightIQUninstalling InsightIQ does not delete InsightIQ data, user settings, live performance reports,generated live performance reports, performance report schedules, or file system reports. If youdo not delete this data manually, the data is available if you reinstall InsightIQ on the samecomputer.

Procedure

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 liveperformance reports, performance report schedules, and file system reports, deletethe /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 themonitored 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 InsightIQinstances are monitoring the cluster and you do not intend to monitor the cluster withInsightIQ later.

Uninstall


isilon insightiq installation guide...modified or deleted, create nfs export rule that allows write...

Documents