Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

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

branch: master

Merge pull request #3999 from daviddavis/temp/20140423115449

Fixes #5413 - Fix content view removal error message
latest commit ea22b824a8
David Davis daviddavis authored April 24, 2014
Octocat-spinner-32 .tx fix paths in .tx/config after git reorganization April 29, 2013
Octocat-spinner-32 app Merge pull request #3999 from daviddavis/temp/20140423115449 April 24, 2014
Octocat-spinner-32 autotest initial commit June 15, 2011
Octocat-spinner-32 ca adding redhat-uep.pem to katello ca October 05, 2011
Octocat-spinner-32 config Fixes #4925,5147,5410 - Centralize provider creation. April 23, 2014
Octocat-spinner-32 db Fixes #5418 - Migration for anonymous providers April 23, 2014
Octocat-spinner-32 deploy Fixes #5164 - fix rpm builds April 24, 2014
Octocat-spinner-32 doc removing symlink to local dynflow March 17, 2014
Octocat-spinner-32 engines Merge pull request #3906 from parthaa/provider-cleanup April 23, 2014
Octocat-spinner-32 lib fixes #5183 - Rename Systems to Content Hosts throughout the UI April 21, 2014
Octocat-spinner-32 locale Translations - Update .po and .pot files for katello. April 05, 2013
Octocat-spinner-32 public Bastion: Adding base inline edit directives and adding them to system… July 08, 2013
Octocat-spinner-32 rel-eng add rubygem-hammer_cli_foreman_tasks to repos February 27, 2014
Octocat-spinner-32 script fixes #4744 - updating copyright to 2014 March 21, 2014
Octocat-spinner-32 spec Merge pull request #3906 from parthaa/provider-cleanup April 23, 2014
Octocat-spinner-32 test Merge pull request #3906 from parthaa/provider-cleanup April 23, 2014
Octocat-spinner-32 vendor Bastion: Adds Grunt task to pick the proper library files for each December 10, 2013
Octocat-spinner-32 yard-template link filenames in module/class doc to github May 09, 2013
Octocat-spinner-32 .gitignore Fix apipie static generation on RPM build time August 06, 2013
Octocat-spinner-32 .rspec initial commit June 15, 2011
Octocat-spinner-32 .rubocop.yml Rubocop: Fixing error by updating gem February 04, 2014
Octocat-spinner-32 .simplecov Setup simplecov in katello March 05, 2013
Octocat-spinner-32 .yardopts Add documentation of db schema June 04, 2013
Octocat-spinner-32 CONTRIBUTING.md Adding a CONTRIBUTING document May 19, 2013
Octocat-spinner-32 Gemfile Engine: Removing old gem files December 06, 2013
Octocat-spinner-32 LICENSE.txt set Markdown as default markup January 16, 2013
Octocat-spinner-32 README.md Fixes #4784: Replaces development setup documentation with references to March 21, 2014
Octocat-spinner-32 config.ru fix yard doc reloading, render only one documentation (:single_librar… January 16, 2013
Octocat-spinner-32 katello.gemspec Update foreman-tasks March 25, 2014
Octocat-spinner-32 rubygem-katello.spec Update foreman-tasks March 25, 2014
README.md

Katello Build Status

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

About

Katello is a systems life cycle management plugin to Foreman. Katello allows you to manage thousands of machines with one click. Katello can pull content from remote repositories into isolated environments, and make subscriptions management a breeze.

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

Development

The recommended way to set up Katello for development to use the katello-devel-installer directly or via katello-deploy.

Test Run

At this point, the development environment should be completely setup and the Katello engine functionality available. To verify this, go to your Foreman checkout:

  1. Start the development server

    cd $GITDIR/foreman
    
    rails s
    
  2. Access Foreman in your browser (e.g. http://<hostname>:3000/)

  3. Login to Foreman (default: admin and changeme)
  4. Create an initial Foreman organization
  5. Navigate to the Katello engine (e.g. http://<hostname>:3000/katello)

Start the background jobs processor

You also will need the delayed_jobs engine to be running to process Katello's async tasks. To start it do:

```bash
cd $GITDIR/foreman

rake jobs:work
```

Reset Development Environment

In order to reset the development environment, all backend data and the database needs to be reset. To reiterate, the following will destroy all data in Pulp, Candlepin and your Foreman/Katello database. From the Foreman checkout run:

rake katello:reset

Found a bug?

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

Contributing

See getting involved.

Contact & Resources

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

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}
Something went wrong with that request. Please try again.