Configuration and Discovery

Download this manual as a PDF file

The following sections describe how to configure Pure Storage FlashArrays for monitoring by SL1 using the Pure Storage PowerPack:

Generating a Pure Storage API Token

The Pure Storage PowerPack uses the Pure Storage REST API for collecting configuration and performance data. The Pure API uses port 443; therefore, you must have access to that port. You must also use an API Token, which you can create on the Pure FlashArray and then copy into the Basic/Snippet credential you create that enables SL1 to discover and monitor the FlashArray.

There are two ways to create the API Token:

  • Generate the API token through the Purity user interface (System > Users > Create API Token)
  • Generate the API token through the Purity command line interface (pureadmin create --api-token)

You can also view existing API tokens in the Purity user interface by navigating to System > Users > API Tokens, clicking the gear icon next to the username, and then selecting Show API Token.

After the API Token has been generated, copy and save it for use in the credential.

Testing TCP Port Connectivity

The Pure Storage REST API service runs on TCP port 443 from the primary IP address assigned to the Pure FlashArray. This IP address should be the same one used to access the Purity user interface. To enable SL1 to communicate with the Pure API, your ScienceLogic Data Collector or All-In-One Appliance must have access to TCP port 443.

To test TCP port connectivity, log in to the command line interface of your Data Collector or All-In-One Appliance as the root user and type the following command:

nmap -p 443 10.1.1.10

 

If TCP port 443 is open, the following message displays:

Starting Nmap 5.51 ( http://nmap.org ) at 2015-10-01 18:42 UTC

Nmap scan report for purestorage-001.mydomain.net (204.110.219.37)

Host is up (0.027s latency).

PORT    STATE SERVICE

443/tcp open  https

 

Nmap done: 1 IP address (1 host up) scanned in 0.36 seconds

 

If the port does not appear, or it appears with the state of "filtered", check your firewall settings. If there is a firewall between the ScienceLogic Data Collector or All-In-One Appliance and the Pure Storage REST API, ensure that it can communicate over TCP port 443.

Configuring a Pure Storage Credential

To configure SL1 to monitor Pure Storage, you must first create a Basic/Snippet credential that allows the Dynamic Applications in the Pure Storage PowerPack to connect with the Pure Storage FlashArray. An example Basic/Snippet credential that you can edit for your own use is included in the Pure Storage PowerPack.

To create a Basic/Snippet credential to access Docker hosts and swarms:

  1. Go to the Credentials page (Manage > Credentials).
  2. Locate the example Pure Storage Example credential, click its Actions icon () and select Duplicate. A copy of the credential, called Pure Storage Example copy appears.
  3. Click the Actions icon () for the Pure Storage Example copy credential and select Edit. The Edit Credential page appears:

  1. Supply values in the following fields:
  • Name. Type a new name for the Pure Storage credential.
  • All Organizations. Toggle on (blue) to align the credential to all organizations, or toggle off (gray) and then select one or more specific organizations from the What organization manages this service? drop-down field to align the credential with those specific organizations.

  • Port. Type "443".
  • Timeout(ms). Type a value greater than or equal to "5000".
  • Username. Type your Pure Storage username.
  • Password. Type or paste the Pure Storage API token.
  1. Click Save & Close.

Configuring a Pure Storage Credential in the SL1 Classic User Interface

To configure SL1 to monitor Pure Storage, you must first create a Basic/Snippet credential that allows the Dynamic Applications in the Pure Storage PowerPack to connect with the Pure Storage FlashArray. An example Basic/Snippet credential that you can edit for your own use is included in the Pure Storage PowerPack.

To create a Basic/Snippet credential to access Docker hosts and swarms:

  1. Go to the Credential Management page (System > Manage > Credentials).
  2. Locate the example Pure Storage Example credential, and then click its wrench icon (). The Edit Basic/Snippet Credential modal page appears.

  1. Complete the following fields:
  • Credential Name. Type a new name for the Pure Storage credential.

  • Port. Type "443".
  • Timeout(ms). Type a value greater than or equal to "5000".
  • Username. Type your Pure Storage username.
  • Password. Type or paste the Pure Storage API token.
  1. Click the Save As button.
  2. When the confirmation message appears, click OK.

Discovering Pure Storage Components

To discover and model your Pure Storage FlashArray and component devices for monitoring, you must run a discovery session. Several minutes after the discovery session has completed, the Dynamic Applications in the Pure Storage PowerPack will automatically align to the FlashArray root device. These Dynamic Applications will discover, model, and monitor the remaining Pure Storage components.

To discover Pure Storage components:

  1. On the Devices page () or the Discovery Sessions page (Devices > Discovery Sessions), click the Add Devices button. The Select page appears:

  1. Click the Unguided Network Discovery button. Additional information about the requirements for discovery appears in the General Information pane to the right.
  1. Click Select. The Add Devices page appears:
  2. Complete the following fields:
  • Name. Type a unique name for this discovery session. This name is displayed in the list of discovery sessions on the Discovery Sessions tab.
  • Description. Optional. Type a short description of the discovery session. You can use the text in this description to search for the discovery session on the Discovery Sessions tab.
  • Select the organization to add discovered devices to. Select the name of the organization to which you want to add the discovered devices.

  1. Click Next. The Credentials page of the Add Devices wizard appears:

Image of the Add Devices wizard, page 2

  1. On the Credentials page, locate and select the Basic/Snippet credential you created.
  1. Click Next. The Discovery Session Details page of the Add Devices wizard appears:

Image of the Add Devices wizard, page 2

  1. Complete the following fields:
  • List of IPs/Hostnames. Type the IP address for the Pure Storage FlashArray that you want to discover.

  • Which collector will discover these devices?. Select an existing collector to monitor the discovered devices. Required.
  • Run after save. Select this option to run this discovery session as soon as you click Save and Close.

In the Advanced options section, click the down arrow icon () to complete the following fields:

  • Initial Scan Level. Select 5. Deep discovery.
  • Discover Non-SNMP. Toggle on (blue).
  • Model Devices. Toggle on (blue).

  1. Click Save and Close to save the discovery session. The Discovery Sessions page (Devices > Discovery Sessions) displays the new discovery session.
  2. If you selected the Run after save option on this page, the discovery session runs, and the Discovery Logs page displays any relevant log messages. If the discovery session locates and adds any devices, the Discovery Logs page includes a link to the Device Investigator page for the discovered device.

Discovering Pure Storage Components in the SL1 Classic User Interface

To discover and model your Pure Storage FlashArray and component devices for monitoring, you must run a discovery session. Several minutes after the discovery session has completed, the Dynamic Applications in the Pure Storage PowerPack will automatically align to the FlashArray root device. These Dynamic Applications will discover, model, and monitor the remaining Pure Storage components.

To discover Pure Storage components:

  1. Go to the Discovery Control Panel page (System > Manage > Classic Discovery or System > Manage > Discovery in the classic user interface), and then click the Create button. The Discovery Session Editor page appears.

  1. In the Discovery Session Editor page, complete the following fields:
  • Name. Type a name for your discovery session.

  • IP Address/Hostname Discovery List. Type the IP address for the Pure Storage FlashArray that you want to discover.
  • Other Credentials. Select the Basic/Snippet credential you created for Docker.
  • Initial Scan Level. Select 5. Deep discovery.
  • Detection Method & Port. Select TCP 443 - https.
  • Discover Non-SNMP. Select this checkbox.
  • Model Devices. Select this checkbox.
  1. Optionally, you can enter values in the other fields on this page. For more information about the other fields on this page, see the Discovery & Credentials section.
  2. Click the Save button to save the discovery session, and then close the Discovery Session Editor window.
  3. The discovery session you created displays at the top of the Discovery Control Panel page. Click its lightning-bolt icon () to run the discovery session.
  4. The Discovery Session window appears. When a root device is discovered, click its device icon () to view the Device Properties page for that device.

Manually Aligning Dynamic Applications

To verify that SL1 has automatically aligned the correct Dynamic Applications during discovery:

  1. Go to the Devicespage (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface).
  1. Locate your Pure Storeage FlashArray virtual and click its name.
  2. In the Device Investigator, click the Collections tab. 

  1. The following Dynamic Applications should appear in the list of aligned Dynamic Applications:
  • Pure Storage: Array Capacity Stats

  • Pure Storage: Array Discovery
  • Pure Storage: Array Stats
  • Pure Storage: Controller Config
  • Pure Storage: Drive Config
  • Pure Storage: Hardware Config
  • Pure Storage: Hosts & Groups Config
  • Pure Storage: Message Log Config
  • Pure Storage: Protection Groups Config
  • Pure Storage: Temperature Stats
  • Pure Storage: Volume Discovery

If the Dynamic Applications have not been automatically aligned, you can align them manually. To do so, perform the following steps:

  1. Click the Edit button at the top of the page, then click the Align Dynamic App button.
  2. In the Align Dynamic Application modal, click Choose Dynamic Application.
  3. Locate the Dynamic Application you want to manually align and click Select.
  4. In the Align Dynamic Application modal, de-select the Use Device SNMP Credential box. Click the Choose Credential option that appears.
  5. Select the Basic/Snippet credential you created for Pure Storage and click Select.
  6. Click Align Dynamic App to align the Dynamic Application with the Pure Storage device.
  7. Repeat steps 1-6 as needed to align any additional Dynamic Applications.

Manually Aligning Dynamic Applications in the SL1 Classic User Interface

To verify that SL1 has automatically aligned the correct Dynamic Applications during discovery:

  1. From the Device Properties page (Devices > Classic Devices > wrench icon ()) for the Pure Storage FlashArray, click the Collections tab. The Dynamic Application Collections page appears.

  1. The following Dynamic Applications should appear in the list of aligned Dynamic Applications:
  • Pure Storage: Array Capacity Stats

  • Pure Storage: Array Discovery
  • Pure Storage: Array Stats
  • Pure Storage: Controller Config
  • Pure Storage: Drive Config
  • Pure Storage: Hardware Config
  • Pure Storage: Hosts & Groups Config
  • Pure Storage: Message Log Config
  • Pure Storage: Protection Groups Config
  • Pure Storage: Temperature Stats
  • Pure Storage: Volume Discovery

It can take several minutes after discovery for Dynamic Applications to display on the Dynamic Application Collections page. If the listed Dynamic Applications do not display on this page, try clicking the Reset button.

If the Dynamic Applications have not been automatically aligned, you can align them manually. To do so, perform the following steps:

  1. Go to the Device Properties page (Devices > Classic Devices > wrench icon()) for the Pure Storage FlashArray and click the Collections tab. The Dynamic Application Collections page appears.
  2. On the Dynamic Application Collections page, click the Action button and then select Add Dynamic Application from the menu. The Dynamic Application Alignment page appears.

  1. In the Dynamic Applications field, select a Dynamic Application to align.
  2. In the Credentials field, select the Basic/Snippet credential you created for Pure Storage.
  3. Click the Save button.
  4. Repeat steps 2-5 as needed to align any additional Dynamic Applications.

Viewing Pure Storage Component Devices

In addition to the Devices page, you can view the Pure Storage FlashArray and all of its component devices in the following places in the user interface:

  • The Device Investigator Map page (click Map in the Device Investigator page) displays a map of a particular device and all of the devices with which it has parent-child relationships. Double-clicking any of the listed devices reloads the page to make the selected device the primary device.

  • The Device Components page (Devices > Device Components) displays a list of all root devices and component devices discovered by SL1. The Device Components page displays all root devices and component devices in an indented view, so you can easily view the hierarchy and relationships between child devices, parent devices, and root devices. To view the component devices associated with a Pure Storage FlashArray, find the device and click its plus icon (+).

  • The Component Map page (Classic Maps > Device Maps > Components) allows you to view devices by root node and view the relationships between root nodes, parent components, and child components in a map. This makes it easy to visualize and manage root nodes and their components. SL1 automatically updates the Component Map as new component devices are discovered. The platform also updates each map with the latest status and event information. To view the map for a Pure Storage FlashArray, go to the Component Map page and select the map from the list in the left NavBar. To learn more about the Component Map page, see the section on Maps.

Viewing Pure Storage Component Devices in the SL1 Classic User Interface

In addition to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic SL1 user interface), you can view the Pure Storage FlashArray and all of its component devices in the following places in the user interface:

  • The Device View modal page (Devices > Classic Devices > graph icon > Topology, or Registry > Devices > Device Manager > graph icon > Topology in the classic SL1 user interface) displays a map of a particular device and all of the devices with which it has parent-child relationships. Double-clicking any of the devices listed reloads the page to make the selected device the primary device:

  • The Device Components page (Devices > Device Components) displays a list of all root devices and component devices discovered by SL1 in an indented view, so you can easily view the hierarchy and relationships between child devices, parent devices, and root devices. To view the component devices associated with Pure Storage, find the Pure Storage FlashArray device and click its plus icon (+):

  • The Component Map page (Classic Maps > Device Maps > Components) allows you to view devices by root node and view the relationships between root nodes, parent components, and child components in a map. This makes it easy to visualize and manage root nodes and their components. SL1 automatically updates the Device Component Map as new component devices are discovered. The platform also updates each map with the latest status and event information. To view the map for Pure Storage, go to the Device Component Map page (Views > Device Maps > Components) and select the map from the list in the left NavBar. To learn more about the Device Component Map page, see the section on Views.