Creating HTML report of ScaleIO cluster using PowerShell

This post is a reference to a small reporting script for ScaleIO environments. The project will generate a brief HTML report of your ScaleIO Ready Node SDS infrastructure (with AMS - Automated Management Services) by making use of ScaleIO Ready Node AMS REST APIs and PowerShell. The report provides information about MDM cluster state, overall cluster capacity, system objects, alerts, and health state of all disks in the cluster. Here the API is available as part of ScaleIO Ready Node AMS. These AMS REST API allows you to query information and perform actions related to ScaleIO software and ScaleIO Ready Node hardware components. To access the API you need to provide AMS username and password. Responses returned by AMS server are formatted in JSON format.

Project reference: https://github.com/vineethac/sio_report

Use case: This script can be used/ leveraged as part of daily cluster health/ stats reporting process, or something similar; so that monitoring Engineers or whoever responsible can have a look at it on a daily basis to make sure everything is healthy and working normal. 

Related references:

Working with ScaleIO REST API using PowerShell - Part 1

Working with ScaleIO REST API using PowerShell - Part 2

Working with ScaleIO REST API using PowerShell - Part 3

Hope this was helpful. Cheers!

Infrastructure testing using Pester - Part 3

In this article, I will explain briefly about how to use Pester to validate your switching infrastructure/ switch configurations. If your switches have incorrect configurations, you will experience several problems like network disconnections, high latency, low throughput, etc. And all these will contribute towards network performance issues. In a hyper-converged infrastructure, incorrect switch configurations will affect both compute and storage performance. So it is very important to make sure your switches are configured in the right way according to best practice recommendations.

Using Pester tests, you can define the expected configuration rules and execute it against your existing switches to verify everything is configured correctly or not.

Here in this example, I will show how to verify the below.

• Networking OS version (here I am using Dell EMC S5048F-ON switch)
• The interfaces are Up (given a range)
• A given set of VLANs are present and Up

Prerequisite PowerShell modules:

• Pester - Version 4.3.1
• Posh-SSH - Version 2.0.2

Note: I am using Powershell 5.1.14393.0

#Collect input 

#Provide interface range to verify status

[int]$Start_port = Read-host "Enter starting switch port number"

[int]$End_port = Read-host "Enter ending switch port number"

#Provide VLANs to verify status

[int[]]$vlans = 20,23

$check_vlans = @{}

#New SSH session to the Switch 

$sw_creds = Get-Credential -Message "Enter switch creds"

Write-Host "Creating new SSH session to Switch."

$SWssh = New-SSHSession -ComputerName 192.168.10.4 -Credential $sw_creds -Force -ConnectionTimeout 300

Write-Host "Collecting configuration details from Switch. This will take few seconds."

Start-Sleep -s 3

Write-Host "Collecting VLAN details from Switch. This will take few seconds."

for ($j=0; $j -lt $vlans.Count; $j++) {

    Write-Host "Collecting details of VLAN $($vlans[$j])"

    $cmd_vlan = "show interfaces vlan $($vlans[$j])"

    $check_vlan = invoke-sshcommand -Command $cmd_vlan -SSHSession $SWssh

    Start-Sleep -s 3

    $check_vlans[$j] = $check_vlan.Output

}

#Collecting networking OS info 

$Networking_OS = Invoke-SSHCommand -SSHSession $SWssh -Command "show system"

Start-Sleep -s 3

#Collecting interface status details

$interface_cmd =  "show interfaces twentyFiveGigE 1/$Start_port-1/$End_port"

$interface_status = Invoke-SSHCommand -SSHSession $SWssh -Command $interface_cmd

Write-Host "Configuration verification started.`n"

Describe "System basic checks" {

    Context "Check networking OS version" {

        It "Should be Dell EMC Networking OS Version : 9.12(1.0)" {

            ($Networking_OS.Output) -match 'Dell EMC Networking OS Version : 9\.12\(1\.0\)\s\s$' | Should be $true

        }

    }

}

$Global:i=1

Describe "Interface checks" {

    for ($i=$Start_port; $i -le $End_port; $i++) {

        Context "Interface should be UP" {

            It "Interface 1/$i should be UP" {

                 $Global:c1 = "twentyFiveGigE 1/$i is up, line protocol is up"

                 $res = ($interface_status.Output) -match $c1

                 $res | should be $true

            }

        }

    }

}

Describe "VLAN checks" {

    for ($j=0; $j -lt $vlans.Count; $j++) {

        Context "Check VLAN $($vlans[$j])" {

             It "Should contain VLAN $($vlans[$j])" {

                  $check = ($check_vlans[$j]) -match '% Error: No such interface'

                  $check | should be $null

                  Write-host $check

             }

             It "VLAN $($vlans[$j]) should be UP" {

                  $tt = "Vlan $($vlans[$j]) is up, line protocol is up"

                  $t3 = ($check_vlans[$j]) -match $tt

                  $t3 | should be $true

             }

        }

    }

}

Remove-SSHSession -SSHSession $SWssh

#Sample output

You can write custom Pester tests according to your switching infrastructure configuration, where you can verify port channels, VLAN membership of switch ports, VLT configuration etc. Hope this was helpful. Cheers!

Working with ScaleIO REST API using PowerShell - Part 3

As you all know disk drives are the most important and basic building blocks of a storage system. In order to ensure data availability, the disk drives in your storage system should always stay healthy. Unhealthy drives not only cause risk to your data but also contribute to degraded performance. In this article, I will show how to query and get disk health-related information in a ScaleIO cluster using REST API and PowerShell. 

Please refer my previous posts for API authentication, token generation and 'Invoke-RestMethod'.

Working with ScaleIO REST API using PowerShell - Part 1

Working with ScaleIO REST API using PowerShell - Part 2

#Query all devices in the ScaleIO cluster

$all_devices = (Invoke-RestMethod -Uri "https://192.168.11.15:443/api/types/Device/instances " -Method Get -Headers $ScaleIOAuthHeaders)  

#Select necessary properties and sort

$all_devices = (Invoke-RestMethod -Uri "https://192.168.11.15:443/api/types/Device/instances " -Method Get -Headers $ScaleIOAuthHeaders) | select sdsId, storagePoolId, name, deviceCurrentPathName, errorState, deviceState, ssdEndOfLifeState, temperatureState, aggregatedState  | sort sdsId | ft -AutoSize

#Sample output

Hope this was helpful. Please refer to ScaleIO 2.5 API reference guide for more details. Cheers!