Repository files navigation

Full documentation is athttps://www.theforeman.org/plugins/katello/

Katello is a systems life cycle managementplugin toForeman. Katello allows you to managethousands of machines with one click. Katello can pull contentfrom remote repositories into isolated environments, and make subscriptionsmanagement a breeze.

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

The most common way to set up Katello for development is to useforklift.This will set up a virtual machine with the Katello codebase checked out.Please use the forklift documentation found in the repository for howto get started with forklift.

If you have questions about or issues with deploying a development environment, feel free to askfor assistance in #theforeman-dev IRC channel on libera.chat or via thecommunity forum

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/foremanbundleexec foreman start

2. Access Foreman in your browser (e.g.https://<hostname>/). Note that while Rails will listen on port 3000, the dev installer will set up a reverse proxy so HTTPS on port 443 will work.

3. The first time you do this, you will need to accept the self-signed certificate on port 3808 by first visitinghttps://<hostname>:3808

4. Login to Foreman (default:admin andchangeme)

5. If you go tohttps://<hostname>/about and view the "Plugins" tab, you should see a "Katello" plugin listed.

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

That's rather unfortunate. But don't worry! We can help. Just file a bugin our project tracker.

See thedeveloper documentation.

See theannotation docs for more information.

• theforeman.org
• Discourse Forum
• Archived mailing lists:
  • Foreman User Mailing List
  • Foreman Developer mailing list

Most of our documentation (both for users and developers) can be found attheforeman.org.