engine_setup.md

1. Follow standard Katello development instructions that include installing Katello via RPM and switching to git

2. Check out the engine branch (if you haven't already)

3. Clone Foreman beside Katello, such that:

    workspace/
    worksapce/foreman
    workspace/katello
   

4. cd foreman

5. Create local Gemfile - vim bundler.d/katello.local.rb

    #gem 'katello', :path => '../katello'
    gem 'facter'
    gem 'puppet'
   

6. Copy config/settings.yaml.example and config/database.yml.example to config/settings.yaml and config/database.yml

7. bundle install

8. rake db:create db:migrate

9. enable Katello - vim bundler.d/katello.local.rb

    gem 'katello', :path => '../katello'
   

10. bundle install

11. rake db:migrate db:seed

12. rails s

13. Login to Foreman

14. Create initial Foreman organization

15. Navigate to Katello page

To reset environment:

1. cd katello/

2. ./script/katello-reset-dbs

3. disable Katello - vim bundler.d/katello.local.rb

    #gem 'katello', :path => '../katello'
   

4. rake db:drop && rake db:create && rake db:migrate

5. enable Katello - vim bundler.d/katello.local.rb

    gem 'katello', :path => '../katello'
   

6. bundle

7. rake db:migrate

8. rake db:seed