omsa-alert


Nameomsa-alert JSON
Version 0.2.0 PyPI version JSON
download
home_pagehttps://github.com/dsoprea/omsa_alert
SummaryScan OMSA's omreport tool's output for issues
upload_time2018-01-26 10:56:23
maintainer
docs_urlNone
authorDustin Oprea
requires_python
licenseGPL 2
keywords omsa omreport
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            --------
Overview
--------

The Dell OMSA (OpenManage Server Administrator) command-line tools are a suite of stateless tools for querying or reconfiguring your Dell server hardware, including PERC controllers, virtual disks, and physical disks. This tool is able to take "omreport vdisk" and "omreport pdisk" output, check for the existence of problems (non-OK statuses on your physical disks or virtual disks), and take action if it finds anything.

It can send one or more emails or call one or more commands. You can also choose to forward information about the problematic device to one or more commands.

Feel free to submit pull-requests with any missing features that might increase usefulness.


-------
Install
-------

Use PyPI::

    $ pip install omsa_alert


-------
Example
-------

If there's an error::

    $ omreport storage pdisk controller=1 -fmt ssv | oa_check pdisk -e root@localhost -e dustin@localhost
    Notifying: ['root@localhost', 'dustin@localhost']

An example of such an email::

    Return-Path: <omsaalert@localhost>
    X-Original-To: root@localhost
    Delivered-To: root@localhost
    Received: from mlll2664.magicleap.ds (mlll2664.magicleap.ds [IPv6:::1])
        by mlll2664.magicleap.ds (Postfix) with ESMTP id CC8E71720D2C
        for <root@localhost>; Fri, 26 Jan 2018 05:40:48 -0500 (EST)
    Content-Type: text/plain; charset="us-ascii"
    MIME-Version: 1.0
    Content-Transfer-Encoding: 7bit
    Subject: OMSA Reported a Problem
    From: omsaalert@localhost
    To: root@localhost, dustin@localhost
    Message-Id: <20180126104048.CC8E71720D2C@mlll2664.magicleap.ds>
    Date: Fri, 26 Jan 2018 05:40:48 -0500 (EST)

    [
        {
            "Available RAID Disk Space": "0.00 GB (0 bytes)",
            "Bus Protocol": "SAS",
            "Capable Speed": "Not Available",
            "Capacity": "1,862.50 GB (1999844147200 bytes)",
            "Certified": "Not Applicable",
            "Device Write Cache": "Not Applicable",
            "Disk Cache Policy": "Not Applicable",
            "Driver Version": "Not Applicable",
            "Encrypted": "Not Applicable",
            "Encryption Capable": "No",
            "Failure Predicted": "No",
            "Form Factor ": "Not Available",
            "Hot Spare": "No",
            "ID": "0:0:2",
            "ISE Capable": "No",
            "Manufacture Day": "Not Available",
            "Manufacture Week": "Not Available",
            "Manufacture Year": "Not Available",
            "Media": "HDD",
            "Mirror Set ID": "Not Applicable",
            "Model Number": "Not Applicable",
            "Name": "Physical Disk 0:0:2",
            "Negotiated Speed": "Not Available",
            "Non-RAID HDD Disk Cache Policy": "Not Applicable",
            "PCIe Maximum Link Width": "Not Applicable",
            "PCIe Negotiated Link Width": "Not Applicable",
            "Part Number": "Not Available",
            "Part of Cache Pool": "Not Applicable",
            "Power Status": "Not Applicable",
            "Product ID": "WD2001FYYG-01SL3",
            "Progress": "Not Applicable",
            "Remaining Rated Write Endurance": "Not Applicable",
            "Revision": "VR02",
            "SAS Address": "50014EE5AAACA923",
            "Sector Size": "512B",
            "Serial No.": "60012383",
            "State": "Online",
            "Status": "NOT-OK",
            "Sub Vendor": "Not Available",
            "T10 PI Capable": "No",
            "Used RAID Disk Space": "1,862.50 GB (1999844147200 bytes)",
            "Vendor ID": "WD"
        }
    ]

NOTE: This is a contrived example. The disk information is based on a perfectly healthy disk. Real failures will look different.

See the command-line help for full documentation on parameters.


--------
Features
--------

- May send messages to many email recipients.
- May call many separate commands and optionally pass the information for the problematic devices via STDIN.
- Turn on verbosity to print the problem information to the screen (useful with Crontab).
- Will fail with a return-code of (5) when it encounters a problem (by default) unless you tell it not to.


-----
Tests
-----

There is a complete testing suite::

    $ ./test.sh
            

Raw data

            {
    "_id": null,
    "maintainer": "",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "",
    "cheesecake_code_kwalitee_id": null,
    "keywords": "omsa omreport",
    "upload_time": "2018-01-26 10:56:23",
    "author": "Dustin Oprea",
    "home_page": "https://github.com/dsoprea/omsa_alert",
    "github_user": "dsoprea",
    "download_url": "https://pypi.python.org/packages/92/c0/f24396ec0f954513b1aac346e80ebd4895a9420a92460ef448a4625543c9/omsa-alert-0.2.0.tar.gz",
    "platform": "",
    "version": "0.2.0",
    "cheesecake_documentation_id": null,
    "description": "--------\nOverview\n--------\n\nThe Dell OMSA (OpenManage Server Administrator) command-line tools are a suite of stateless tools for querying or reconfiguring your Dell server hardware, including PERC controllers, virtual disks, and physical disks. This tool is able to take \"omreport vdisk\" and \"omreport pdisk\" output, check for the existence of problems (non-OK statuses on your physical disks or virtual disks), and take action if it finds anything.\n\nIt can send one or more emails or call one or more commands. You can also choose to forward information about the problematic device to one or more commands.\n\nFeel free to submit pull-requests with any missing features that might increase usefulness.\n\n\n-------\nInstall\n-------\n\nUse PyPI::\n\n    $ pip install omsa_alert\n\n\n-------\nExample\n-------\n\nIf there's an error::\n\n    $ omreport storage pdisk controller=1 -fmt ssv | oa_check pdisk -e root@localhost -e dustin@localhost\n    Notifying: ['root@localhost', 'dustin@localhost']\n\nAn example of such an email::\n\n    Return-Path: <omsaalert@localhost>\n    X-Original-To: root@localhost\n    Delivered-To: root@localhost\n    Received: from mlll2664.magicleap.ds (mlll2664.magicleap.ds [IPv6:::1])\n        by mlll2664.magicleap.ds (Postfix) with ESMTP id CC8E71720D2C\n        for <root@localhost>; Fri, 26 Jan 2018 05:40:48 -0500 (EST)\n    Content-Type: text/plain; charset=\"us-ascii\"\n    MIME-Version: 1.0\n    Content-Transfer-Encoding: 7bit\n    Subject: OMSA Reported a Problem\n    From: omsaalert@localhost\n    To: root@localhost, dustin@localhost\n    Message-Id: <20180126104048.CC8E71720D2C@mlll2664.magicleap.ds>\n    Date: Fri, 26 Jan 2018 05:40:48 -0500 (EST)\n\n    [\n        {\n            \"Available RAID Disk Space\": \"0.00 GB (0 bytes)\",\n            \"Bus Protocol\": \"SAS\",\n            \"Capable Speed\": \"Not Available\",\n            \"Capacity\": \"1,862.50 GB (1999844147200 bytes)\",\n            \"Certified\": \"Not Applicable\",\n            \"Device Write Cache\": \"Not Applicable\",\n            \"Disk Cache Policy\": \"Not Applicable\",\n            \"Driver Version\": \"Not Applicable\",\n            \"Encrypted\": \"Not Applicable\",\n            \"Encryption Capable\": \"No\",\n            \"Failure Predicted\": \"No\",\n            \"Form Factor \": \"Not Available\",\n            \"Hot Spare\": \"No\",\n            \"ID\": \"0:0:2\",\n            \"ISE Capable\": \"No\",\n            \"Manufacture Day\": \"Not Available\",\n            \"Manufacture Week\": \"Not Available\",\n            \"Manufacture Year\": \"Not Available\",\n            \"Media\": \"HDD\",\n            \"Mirror Set ID\": \"Not Applicable\",\n            \"Model Number\": \"Not Applicable\",\n            \"Name\": \"Physical Disk 0:0:2\",\n            \"Negotiated Speed\": \"Not Available\",\n            \"Non-RAID HDD Disk Cache Policy\": \"Not Applicable\",\n            \"PCIe Maximum Link Width\": \"Not Applicable\",\n            \"PCIe Negotiated Link Width\": \"Not Applicable\",\n            \"Part Number\": \"Not Available\",\n            \"Part of Cache Pool\": \"Not Applicable\",\n            \"Power Status\": \"Not Applicable\",\n            \"Product ID\": \"WD2001FYYG-01SL3\",\n            \"Progress\": \"Not Applicable\",\n            \"Remaining Rated Write Endurance\": \"Not Applicable\",\n            \"Revision\": \"VR02\",\n            \"SAS Address\": \"50014EE5AAACA923\",\n            \"Sector Size\": \"512B\",\n            \"Serial No.\": \"60012383\",\n            \"State\": \"Online\",\n            \"Status\": \"NOT-OK\",\n            \"Sub Vendor\": \"Not Available\",\n            \"T10 PI Capable\": \"No\",\n            \"Used RAID Disk Space\": \"1,862.50 GB (1999844147200 bytes)\",\n            \"Vendor ID\": \"WD\"\n        }\n    ]\n\nNOTE: This is a contrived example. The disk information is based on a perfectly healthy disk. Real failures will look different.\n\nSee the command-line help for full documentation on parameters.\n\n\n--------\nFeatures\n--------\n\n- May send messages to many email recipients.\n- May call many separate commands and optionally pass the information for the problematic devices via STDIN.\n- Turn on verbosity to print the problem information to the screen (useful with Crontab).\n- Will fail with a return-code of (5) when it encounters a problem (by default) unless you tell it not to.\n\n\n-----\nTests\n-----\n\nThere is a complete testing suite::\n\n    $ ./test.sh",
    "lcname": "omsa-alert",
    "name": "omsa-alert",
    "github": true,
    "bugtrack_url": null,
    "license": "GPL 2",
    "github_project": "omsa_alert",
    "summary": "Scan OMSA's omreport tool's output for issues",
    "split_keywords": [
        "omsa",
        "omreport"
    ],
    "author_email": "myselfasunder@gmail.com",
    "urls": [
        {
            "has_sig": false,
            "upload_time": "2018-01-26T10:56:23",
            "comment_text": "",
            "python_version": "source",
            "url": "https://pypi.python.org/packages/92/c0/f24396ec0f954513b1aac346e80ebd4895a9420a92460ef448a4625543c9/omsa-alert-0.2.0.tar.gz",
            "md5_digest": "bdad37f55fecd26ee1c6a994d23d4e46",
            "downloads": 0,
            "filename": "omsa-alert-0.2.0.tar.gz",
            "packagetype": "sdist",
            "path": "92/c0/f24396ec0f954513b1aac346e80ebd4895a9420a92460ef448a4625543c9/omsa-alert-0.2.0.tar.gz",
            "size": 6752
        }
    ],
    "error": "Could not fetch GitHub repository",
    "cheesecake_installability_id": null
}
        
Elapsed time: 0.07244s