/dell_info

Puppet module that adds Dell specific facts to Facter.

Primary LanguageRuby

Puppet dell_info

Overview

This puppet module adds custom facts aquired by querying https://api.dell.com/. It supports the v4 API.

Module Description

We use this to track the age of our mission critical production servers.

Facts are cached for seven days by default.

Custom facts added, may very based on your warranty details:

      purchase_date => 2011-04-13
      server_age => 2.16 years
      warranty => true
      warranty0_desc => Silver Premium Support
      warranty0_expires => 2014-04-14
      warranty0_type => INITIAL
      warranty1_desc => Next Business Day Support
      warranty1_expires => 2014-04-14
      warranty1_type => EXTENDED
      warranty2_desc => Next Business Day Support
      warranty2_expires => 2012-04-14
      warranty2_type => INITIAL

The warranty fact should be set to warranty => true if any warranties are greater than the current date, and warranty => false if all warranties have expired.

api.dell.com uses API keys. To get one for your use, follow Dell's instructions.

Your API key will first only work on Dell's sandbox api server. You should ask your contact to promote it in their production API.

You can test your key with the sandbox API using the parameter :

class{'dell_info': 
   sandbox => true,
   api_key => "abcde1234"
}

or in hiera :

dell_info::sandbox: true
dell_info::api_key: "abcde1234"

Limitations

  • Currently dell_info only supports Linux based operating systems. We've used it on CentOS, RedHat, Ubuntu and Proxmox (Debian). ** Wouldn't take much to make this work on Windows. Right now I'm using curl instead of net http. Also the cache directory would need to chnage. It's pretty Linux specific right now.
  • Only runs on Dell bare metal servers.
  • Will only query Dell for hardware based servers which have serial numbers Facter can see.

Author

Kevin Wolf kwolf72@gmail.com

V4 and sandbox support : Jonathan Schaeffer jonathan.schaeffer@univ-brest.fr

Support

Please log tickets and issues at the github repository

Release notes

4.1.0

  • Adding warranty_end fact

4.0.0

  • Switching to v4 API, sticking major version to the API version

1.0.1

  • Forgot to increment the version number in the module file.

1.0.0

  • Incrementing the release to scare away less People. This has been working fine for us.

0.0.1

  • Initial release of dell_info. Works for us at this point.