Eyeglass Probe Installation guide


Eyeglass for Probe for CA UIM

Installation Guide

About this Document


Purpose

This guide describes how to install and manage the Eyeglass Probe.  The Guide is divided into the following chapters:

  • Introduction

  • Eyeglass Probe Installation

  • Configure Eyeglass Connection to Isilon clusters

  • Configure Eyeglass Connection to Vblocks

  • Eyeglass Probe Administration

Audience

This guide is intended to be used by CA UIM Administrators.

Introduction

Overview

This chapter presents the following topics:

  • System Overview

  • System Requirements

  • Additional Requirements

  • Acronyms

  • References

How to Install Video

Eyeglass Probe Quick Install

System Overview

Eyeglass Probe for CA UIM leverages Eyeglass DR Orchestration platform software to provide a single integration point for CA UIM and native Isilon REST API.  CA UIM with Eyeglass Probe offers alarm and DR status readiness for Isilon multi cluster monitoring of hardware, software and DR readiness.  Vblock devices are monitored for Alarms only.



Eyeglass Probe: This probe provides inventory and alarm collection from Isilon clusters and Vblock’s.

Eyeglass Probe Deployment and Management: Eyeglass Probe is a native UIM probe that is deployed and managed using the UIM Infrastructure Manager.  The UIM Infrastructure Manager connects to an active Hub and allows you to control, configure and manage all robots and probes connected to that hub.  It also provides a probe Archive.  A probe can be deployed to any UIM hub once it has been imported into the Archive.

  • Eyeglass Probe must be installed on a UIM Robot which has IP connectivity to the Eyeglass appliance

For additional documentation on CA UIM, please refer to support.ca.com.

System Requirements Eyeglass  and Probe

UIM

Eyeglass Probe developed using UIM SDK for Java.

Eyeglass Probe was validated using:

Table 1  UIM Validation List

UIM Component

Version

UIM

8.3, 8.4

Eyeglass appliance

1.5.4

UIM Probe

1.558

Isilon

7.2.0.x or 7.2.1.x or 8.0.0.x

Vblock Vision IO

2.6

Vcenter

5.5 >


Eyeglass Probe

The Eyeglass Probe installation has the following System Requirements:

  • Microsoft Windows Server 2008 R2 64 or greater

  • Linux OS supported by UIM

  • Hardware or Virtual Machine with 1 G RAM and Dual Core CPU 32 or 64 bit, 10G for the probe

The Eyeglass Probe requires that the following ports on the server be available:

Table 2 Eyeglass Isilon appliance  Requirements

Item

Minimum

Direct Documentation Link

CPU

4 x vCPU

Link

OS

ESXi > 5.0

Link

Disk

80GB

Link

NIC

1 x 10 Mbps

Link

Firewall Open Ports Isilon cluster to Eyeglass appliance

See here

See here


Table 3 Eyeglass Probe Port Requirements for Vblock

Port

Direction

Protocol

8443

Outbound

https

5672

Outbound

AMQP

443

Outbound

https


Table 4 Eyeglass Probe Port Requirements

Port

Direction

Protocol

37356

outbound

TCP

23458 (default)

inbound

TCP




Table 4 Eyeglass Probe Robot Requirements


Item

Operating Range

Minimum

CPU

NA

1 vCPU

Memory

512MB

512MB

Thread Usage

2-10

2

Handle Usage

2-10

2

Loaded Classes

<15

NA

Heap Memory usage

< 512MB

NA

File Sizes

UIM Robot Manages log file size and rotation, no other files created

NA



Additional Requirements

In order to install and manage Eyeglass Probe probes, a UIM Infrastructure Manager licence is required.  You can download UIM products at www.ca.com.

References

UIM Monitor Server Infrastructure Manager Guide

Eyeglass Probe Installation

Overview

This chapter presents the following topics:

  • Installation Overview

  • Import Eyeglass Probe Probes to UIM Infrastructure Manager Archive

  • Deploy Eyeglass Probe

Video Installation Overview

Eyeglass Probe for CA UIM Quick Start Install

Installation Overview

The installation steps for the Eyeglass Probe are:

  1. Install the Eyeglass appliance

  2. Add Probe license keys to the appliance

  3. Add Isilon clusters to the appliance

  4. Add Vblock license keys to the appliance

  5. Add VBlocks to the appliance

  6. Configure Eyeglass Appliance Probe Authentication Token

  7. Import Eyeglass Probe into UIM Infrastructure Manager Archive.

  8. Deploy Eyeglass probe.

  9. Configure the probe to connect to the eyeglass appliance with the api token

  10. Send test event from Isilon

  11. Monitor Vblock Alarms in UIM once connected.

Install Eyeglass Appliance

  1. The appliance can be installed using the instructions here Eyeglass Isilon Edition Quick Start Guide for Eyeglass

    1. Installs appliance with ip address

    2. Adds license keys

    3. Adds clusters

    4. Add Vblocks

Add Isilon or Vblock probe license keys to the appliance

Overview:  Install license keys, two types exist Isilon monitoring only or DR enhanced keys available with eyeglass DR automation edition for failover and failback automation.

The DR keys will provide DR state information for replicating cluster pairs and failover status, along with RPO status and compliance.

The monitoring only keys will provide event monitoring on Isilon clusters

Vblock monitoring keys will enable monitoring only functions with Vblock and Vision IO and Vcenter.

  1. Use this section to install keys into the eyeglass appliance install keys  

Add Isilon clusters or Vblocks to the appliance

Overview:  This section is covering both DR monitoring and event monitoring license key functionality.


  1. DR license key cluster addition instructions follow this guide http://documentation.superna.net/eyeglass-isilon-edition/quickinstall#TOC-Add-Isilon-Clusters

  2. For event monitoring only login to eyeglass appliance ip address https://x.x.x.x with admin userID and default password 3y3gl4ss

  3. Goto Add Managed Device

    1. Screen Shot 2016-04-08 at 6.56.57 PM.png

    2. Screen Shot 2016-04-08 at 6.57.43 PM.png


    1. Enter cluster management ip address typically the smartconnect subnet ip address for HA ip address management

    2. User name with minimum privileges below

    3. Once done Open Inventory tree icon on the desktop and use Refresh button  (Bottom right).  To verify complete cluster inventory is completed.

    4. Screen Shot 2016-04-08 at 7.10.57 PM.png

    5. If the text shows Adding….  This means it's in progress still or discovery error has occurred.   If Adding persists for more than 10 minutes, then open a support case http://support.superna.net.

    6. If it looks like the screenshot above then you are done.

    7. Adding Vblocks (if licensed)

      1. Enter vblock Vision IO ip user id and password and vcenter ip address and user id and password

      2. Screen Shot 2016-06-29 at 6.50.50 PM.png

      3. Open the Inventory tree and verify its populated with Vblock domains compute, storage, network and management.  Once completed this tree will be populated.

Configure Eyeglass Appliance Probe Authentication Token

Overview

The Eyeglass Probe needs to be configured with an API token created on the Eyeglass appliance monitoring the Isilon clusters used for authentication . To create this token:

  1. Login to Eyeglass appliance with admin user with https://x.x.x.x of the appliance

  2. Open eyeglass main menu to select Eyeglass REST API.  Follow screenshots below to complete token creation steps needed to configure the Probe to authenticate to eyeglass appliance

  3. Screen Shot 2016-03-18 at 7.22.08 AM.png

  4. Screen Shot 2016-03-18 at 7.22.20 AM.png

Screen Shot 2016-03-18 at 7.22.27 AM.png

  1. Done

Configure Eyeglass Firewall for  Probe Service Broker Connection

Overview:  

The Probe running on UIM Robot over the network requires a firewall port opened from the probe to Eyeglass (one direction port opened).  Note if using converged deployment model with co-resident Robot + probe then the firewall must be modified to open default HUB to Robot port of 48000.  

  1. Login to Eyeglass appliance via ssh

  2. Type sudo -s

  3. Enter admin password

  4. Type yast

  5. Arrow down to security and users and arrow to firewall enter

  6. Arrow to Allowed Services

  7. Tab to Advanced option

    1. Screen Shot 2016-04-20 at 4.43.41 PM.png

  8. Enter ports as shown below with the following notes:

    1. Enter 37356 for TCP when Service  Broker port for UIM probe access is required

    2. Also enter port 48000 if you have installed UIM robot onto the eyeglass appliance for converged deployment model where the UIM robot and probe will run on the eyeglass appliance.  Follow Linux Robot install instructions to install a Robot on Eyeglass appliance.

    3. Screen Shot 2016-04-20 at 4.44.26 PM.png

    4. The above image shows both ports setup on the appliance

    5. Click ok, then exit yast settings to save.

    6. Done

Import Eyeglass Probe to UIM Infrastructure Manager Archive

To import Eyeglass Probe to the UIM Infrastructure Manager Archive:

  1. Login to the UIM Infrastructure Manager.

  2. Expand the Archive folder and select the hub which is running the Robot where the probe will be deployed.

Hint:  For the Eyeglass Probe, select the hub which has a Robot that has IP connectivity to the Eyeglass appliance.

  1. The list of existing probes archived on this hub is displayed.  Click on the right mouse button in this main window pane.

  2. Select the Import option in the menu that opens.

Figure 2 UIM Infrastructure Manager Archive Import Package


  1. Select the probe package that you would like to add to the archive and then select the Open button.

Figure 3 UIM Infrastructure Manager Archive Package Selection


  1. The package(s) are added to your archive and appear in the main window pane for the hub.

Figure 4 UIM Infrastructure Manager Archive Package List



Deploy Eyeglass Probe

Prerequisites

There are no prerequisite for installing Eyeglass Probe.

Deploy Eyeglass Probe

To deploy the Eyeglass Probe on a UIM Robot:

  1. Login to the UIM Infrastructure Manager.

  2. Select the Archive where the probe was imported.

  3. Expand the Domains and hub folders until you can see the Robot where the probe will be deployed.

Hint:  For the Eyeglass Probe, the Robot where it is deployed must have IP connectivity to the Eyeglass appliance.

  1. Drag the Eyeglass Probe from the package archive and drop it onto the Robot.

Figure 5 UIM Infrastructure Manager Archive Package List


  1. The Eyeglass Probe is automatically installed but not started until configured.

    1. Screen Shot 2016-04-08 at 6.42.22 PM.png

  2. Configure probe connection to eyeglass appliance from the admin console interface by selecting the Configure... option

  1. Add the information required for the superna eyeglass probe to connect to the superna eyeglass appliance by selecting the service_broker folder in the Raw Configure window:

ipaddress:  Enter the IP address of the superna eyeglass appliance for the probe to connect

port: Enter 37356  (This is the port on which the superna eyeglass is expecting the probe to connect on and should not be changed)

Example:




  1. Add the information required for the superna eyeglass appliance to be able to connect to the superna eyeglass probe in order to pass the alarm and event information by selecting the probe_config folder in the Raw Configure window:

ipaddress:  Enter the IP address of the robot on which the superna eyeglass probe is deployed (default provided but can be overridden)

port: Enter the port on which the probe will be listening for notifications from the superna eyeglass appliance (default provided but can be overridden - port must be outside the port range allocated to Nimsoft)

token: Enter the authentication token generated in previous step Configure Eyeglass Appliance Probe Authentication Token

Example:


  1. After applying the configuration and click ok, the auto probe start should start the probe and attempt a connection to eyeglass appliance.

  2. To verify the probe deployment, select the Robot where the probe was deployed.  You should see the Eyeglass Probe in the list that is displayed with “Yes” in the Active column.


Screen Shot 2016-04-08 at 6.46.32 PM.png

Figure 6 Eyeglass Probe in the UIM Infrastructure Manager Robot Probe List

  1. If the probe does not start and show green with a process ID and port listed in UIM. Then proceed to troubleshooting probe startup section in Troubleshooting section

    1. Its also recommended the eyeglass appliance service broker lists the probe connection.  This can be verified by logging into eyeglass appliance as was done for the add cluster steps.

      1. Then open Service Broker Icon on the desktop

      2. The login registration from entered during probe configuration should be listed with Active state which means a TCP connection is setup with the probe.

      3. If the Probe loses contact with the eyeglass appliance due to network issue the status will change to inactive.

      4. Screen Shot 2016-04-08 at 7.21.21 PM.png

      5. Screen Shot 2016-04-08 at 7.25.38 PM.png

  2. Once this configuration is completed, the superna eyeglas probe will be ready to receive alarms from eyeglass appliance devices monitored once configured in eyeglass.





Configure Eyeglass Probe UIM Group of Isilon  clusters or  Vblocks for monitoring

To configure the Eyeglass Probe clusters managed by Eyeglass displayed in a group:

  1. Log in as an administrator to the UIM UMP.

  2. The UIM UMP home page appears.

  3. Create (Dynamic folder of discovered Clusters by finding device names of Eyeglass appliance ip address)

  4. This will place clusters into a group for all managed Isilon clusters


Eyeglass Probe Administration

Overview

This chapter presents the following topics:  Use the image below for all actions

  1. Start the superna_Eyeglass probe (activate)

  1. Stop the superna_Eyeglass probe (deactivate)

  2. Restart the superna_Eyeglass

  3. Delete the superna_Eyeglass probe

  4. View debug log for startup errors

  5. Screen Shot 2016-04-08 at 7.27.53 PM.png


Troubleshooting section

If the probe fails to start follow these steps

  1. Check Service Broker registration listing in eyeglass appliance (see steps above for checking status)  should show active

    1. Screen Shot 2016-04-08 at 12.18.33 PM.png

  2. View UIM Probe log

    1. Select probe in UIM

    2. Right click for menu and select view log and raise support case or resolve the error from the message

    3. Screen Shot 2016-04-08 at 7.27.53 PM.png

  3. Restart the broker service on eyeglass

    1. Login via ssh as admin to eyeglass appliance

    2. Sudo -s

    3. Enter admin  password

    4. systemctl restart iglsservicebroker



Test Alarm/Event flow to with Isilon Devices UIM

  1. Login to OneFS UI goto Dashboard, Events, Notification Settings

  2. Click Send test event

  3. Open UIM console alarm view and verify the test event appears NOTE: Can take up to 1 minute to appear.


Ċ
Andrew MacKay,
May 30, 2016, 10:03 AM