ControlUp Integration with IGEL

ControlUp can monitor IGEL endpoints via the Linux Data Collectors feature. This exciting combination of ControlUp and IGEL gives administrators the ultimate visibility of their environment. From the actual user to the backend, you can see it all.

Prerequisites

To enable complete integration, ControlUp requires some configuration changes to your IGEL endpoints.

• SSH must be enabled on the endpoints. 
  The restricted “user” account can be used but process disk metrics will not be displayed. We recommend using “root” to display all metrics.
  Note

  If your ControlUp Console is unable to connect to the IGEL device, ensure that you can connect with PuTTY using the same account you have configured for ControlUp. When you connect with PuTTY, you should end at a prompt. If you get disconnected immediately, then the same will happen to ControlUp and the integration will be unsuccessful.
• A ControlUp Monitor Cluster is highly recommended for monitoring your endpoints.
• IGEL OS 10+ with Enterprise Management Pack.
• In the Agent Settings, enable "Allow users to add machines that are running unsupported Linux flavors" 

Installation Guide

The main benefit of integrating your IGEL devices into ControlUp is the ability to monitor and manage your IGEL endpoints from the Real-Time Console. If you use IGEL firmware version 11.04 or below, you need to create a custom partition which is explained in the [Installation for IGEL v11.04 and below guide](#installation-for-igel-v1104-and-below). If you use IGEL 11.05 and above, there is no need to create a custom partition and you can directly add your IGEL appliances into ControlUp. 

Installation for IGEL v11.04 and below

1. Download the ControlUp Integration pack from here.
2. Extract both files, ControlUp.inf and ControlUp.tar.bz2, to your UMS server.
3. On your IGEL UMS server, import the two ControlUp files
   
   To import the ControlUp files: 
   1. Right-click Files and select New file.
      
   2.  In the New file dialog, click ... and navigate to the ControlUp.inf file and click Open.
      
   3. Click OK to upload the file to the UMS server.
      
   4. Repeat Step b + c with the ControlUp.tar.bz2 file.
      
   5. Once you uploaded both files, make sure that both files appear under Files.
      
   4. Create a new Profile and assign it to your IGEL endpoints.
   To create a new profile:
   1. In your UMS console, right-click Profiles and select New Profile. 
      
   2. Provide a profile name and click OK. In our example, we use the profile name ControlUp integration, but you can give it any name you want.
      
   3. In the configuration wizard of your new profile, navigate to System > Firmware Customization > Custom Partition > Partition.
      
   4. Click the icons under Enable Partition, Size, and Mount Point to activate the input controls. Select the Enable Partition checkbox and set the size of the partition to 100M and the Mount Point to /custom. Click Save to apply the configuration.
      
   5. Right-click the profile and select Edit Configuration. 
   6. Under System > Firmware Customization > Custom Partition > Download (1), click theicon.
   7. In the Add wizard, enter the parameters of your download source and click OK.
      Once done, click Save. 
      You are now up and running with monitoring your IGEL devices in ControlUp. The next chapter explains how to add IGEL appliances to ControlUp.

Add IGEL Devices to ControlUp

In this section, we guide you through to process of adding IGEL devices to your Real-Time Console. 

Create a New Linux Data Collector

The first thing you need to create is a Linux Data Collector. 

To create a new Linux Data Collector:

1. Click Linux Data Collector in the Home ribbon. 
2. Under the Machines tab, click the + Add button.
   
3. In the Add Machines wizard, search for your IGEL devices(s) by entering the IP address(es) (1). Click Scan to search for the device. Once found, the device is shown in the list (2). If ControlUp establishes a successful connection to the device, the screen icon appears blue and you can start adding the device by clicking the Add button (3). Click OK to confirm the selection.
   
4. The added machine is shown under Machines as shown in the screenshot below. Click OK to add the listed machines to ControlUp.
   
5. Confirm the popup by clicking Yes. Necessary packages are installed on your IGEL device.
6. Once the installation of the packages is finished, you can start monitoring your IGEL endpoint in ControlUp.
   

   IGEL Management Actions in ControlUp

   We created an initial set of management script actions to use in the Real-Time Console. Right-click your preferred IGEL devices and you can run the following actions:

   Machine Actions:

   • Get Machine Details
   • List assigned profiles
   • Reboot
   • Send Wake Up
   • Shadow Terminal
   • Update configuration from UMS
   
   Session Actions:
   • Get Machine Details
   These script actions are natively integrated into the console when it detects an IGEL operating system. Right-click the name of the IGEL device and select Recommended Actions.
    If you have “Show Recommendations for Non-Stressed Metrics” enabled under the “Display” options, then clicking the “” icon will reveal the Top Recommended Actions menu.