Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Ohai profiles your system and emits JSON

Octocat-spinner-32 bin Move Ohai Platform Simulation tests to its own directory under spec. January 09, 2014
Octocat-spinner-32 ci Clean up `jenkins_run_tests.bat` December 05, 2013
Octocat-spinner-32 docs update man page April 04, 2014
Octocat-spinner-32 features Disabling the features, pending fixing them up properly January 06, 2009
Octocat-spinner-32 lib Skip v7 plugins when refreshing a v6 plugin April 09, 2014
Octocat-spinner-32 platform_simulation_specs Move Ohai Platform Simulation tests to its own directory under spec. January 09, 2014
Octocat-spinner-32 spec Skip v7 plugins when refreshing a v6 plugin April 09, 2014
Octocat-spinner-32 .gitignore ignore the .bundle directory March 26, 2014
Octocat-spinner-32 .rspec Add Gemfile to simplify development using bundler if needed. Add deve… April 28, 2011
Octocat-spinner-32 .travis.yml Temporarily force rubygems 2.1.x for travis January 02, 2014
Octocat-spinner-32 CHANGELOG.md Update Changelog for OHAI-562 and reformat for release April 09, 2014
Octocat-spinner-32 CONTRIBUTING.md Add a CONTRIBUTING document October 24, 2013
Octocat-spinner-32 CONTRIBUTIONS.md OHAI-558: Add contribution documentation April 01, 2014
Octocat-spinner-32 DOC_CHANGES.md New policy files for OHAI. February 27, 2014
Octocat-spinner-32 Gemfile Unit test for windows kernel plugin. January 16, 2014
Octocat-spinner-32 LICENSE Ohai <3 Sid - Apache 2 License December 02, 2008
Octocat-spinner-32 NOTICE Adding Paul to the Notice file January 20, 2009
Octocat-spinner-32 OHAI_MVPS.md Add OHAI MVPs February 28, 2014
Octocat-spinner-32 README.rdoc update wiki links in README.rdoc October 04, 2011
Octocat-spinner-32 RELEASE_NOTES.md New policy files for OHAI. February 27, 2014
Octocat-spinner-32 Rakefile Update deprecated rake/gempackagetask December 14, 2012
Octocat-spinner-32 ohai.gemspec Lock rake to 10.1.x for ruby 1.8 compat March 26, 2014
README.rdoc

ohai

DESCRIPTION:

Ohai detects data about your operating system. It can be used standalone, but it's primary purpose is to provide node data to Chef.

Ohai will print out a JSON data blob for all the known data about your system. When used with Chef, that data is reported back via node attributes.

Opscode distributes ohai as a RubyGem. This README is for developers who want to modify the Ohai source code. For users who want to write plugins for Ohai, see the wiki:

DEVELOPMENT:

Before working on the code, if you plan to contribute your changes, you need to read the Opscode Contributing document.

You will also need to set up the repository with the appropriate branches. We document the process on the Chef Wiki.

(Substitude 'ohai' for 'chef')

Once your repository is set up, you can start working on the code. We do use BDD/TDD with RSpec, and soon Cucumber for integration/feature testing, so you'll need to get those installed.

ENVIRONMENT:

In order to have a dev environment where you can work on Ohai, you'll need to install a few additional gems after setting up the Git repository.

Install the following RubyGems.

  • rake

  • rspec

  • extlib

  • systemu

  • json

    gem install rake rspec extlib systemu json

Rake Tasks

Ohai has some Rake tasks for doing various things.

rake -T
rake clobber_package  # Remove package products
rake gem              # Build the gem file ohai-$VERSION.gem
rake install          # install the gem locally
rake make_spec        # create a gemspec file
rake package          # Build all the packages
rake repackage        # Force a rebuild of the package files
rake spec             # Run specs

($VERSION is the current version, from the GemSpec in Rakefile)

Spec Testing:

We use RSpec for unit/spec tests.

rake spec

Because ohai gathers system information, and we don't know what kind of system we might be running on (yet), we're moving away from specs for integration testing and to cucumber.

LINKS:

Source:

Tickets/Issues:

(Use the OHAI project)

Documentation:

LICENSE:

Ohai - system information application

Author

Adam Jacob (<adam@opscode.com>)

Copyright

Copyright © 2008 Opscode, Inc.

License

Apache License, Version 2.0

Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Something went wrong with that request. Please try again.