pitr-ch/katello

Katello integrates open source systems management tools into a single solution for controlling the lifecycle of your machines.

Katello

Full documentation is at http://katello.github.io/katello

About

Katello is a systems life cycle management tool. It allows you to manage hundreds and thousands machines with one click. Katello can pull content from remote repositories into isolated environments, make subscriptions management easier and provide provisioning at scale.

Currently, it is able to handle Fedora and Red Hat Enterprise Linux based systems.

Getting Started

The easiest way to get stable version of Katello up and running is following Katello Wiki Installation Instructions.

If you like living on the edge, go for nightly builds instead.

Found a bug?

That's rather unfortunate. But don't worry! We can help. Just file a bug on our Bugzilla or in Github.

Contributing

See development instructions.

What's included in this repository:

• script - various development scripts
• actual Rails app of Katello

Contact & Resources

• Katello.org
• Wiki
• User mailing list
• Developer mailing list
• IRC Freenode: #katello
• Twitter

Documentation

Documentation is generated with YARD and hosted at http://katello.github.io/katello/. This documentation is intended for developers, user documentation can be found on wiki. Developer documentation contains:

• code documentation
• high level guides to architectures and implementation details
• how-tos

Note: older developer guides can be found on our wiki, they are being migrated.

How to

• to see YARD documentation start Katello server and find the link on "About" page or go directly to http://path.to.katello/url_prefix/yard/docs/katello/frames

  • if it fails run bundle exec yard doc --no-cache first, which will rebuild whole documentation

• see {file:doc/YARDDocumentation.md}

Current documentation

• {file:doc/YARDDocumentation.md}
• {file:doc/Graphs.md}

Debugging

• {file:doc/how_to/add_praise.md Enabling Praise} - raise/exception investigation

Packaging

• {file:doc/how_to/package_new_gem.md How to package new gem}

Other

• {file:doc/katellodb.html DB schema documentation}

• Original Rails generated README {file:doc/RailsReadme}, we may do certain things differently

  • we use doc directory for storing markdown guides instead of a generated documentation

Source

• {Katello::Configuration}
• {Notifications}