Revision 241fc39b
Added by Eric Helms about 10 years ago
| README.md | ||
|---|---|---|
|
|
||
|
## Development
|
||
|
|
||
|
The easiest way to set up katello, is to install the latest version of katello
|
||
|
via rpm, and then clone the git code.
|
||
|
|
||
|
Follow the [install steps](https://fedorahosted.org/katello/wiki/Install) from
|
||
|
the Katello Wiki. When you attempt to install the packages, please install the
|
||
|
following:
|
||
|
|
||
|
```bash
|
||
|
# yum install -y katello-all
|
||
|
```
|
||
|
|
||
|
Then, clone this repository into a workspace of your choosing.
|
||
|
|
||
|
### Setup Foreman
|
||
|
|
||
|
Start by cloning Foreman beside your git checkout of Katello such that:
|
||
|
|
||
|
```
|
||
|
workspace/
|
||
|
foreman/
|
||
|
katello/
|
||
|
```
|
||
|
|
||
|
Change directories into the Foreman checkout and copy the sample settings and database files:
|
||
|
|
||
|
```bash
|
||
|
cd foreman
|
||
|
cp config/settings.yaml.example config/settings.yaml
|
||
|
cp config/database.yml.example config/database.yml
|
||
|
```
|
||
|
|
||
|
Edit `config/settings.yaml`:
|
||
|
|
||
|
```yml
|
||
|
:require_ssl: false
|
||
|
# ...
|
||
|
:organizations_enabled: true
|
||
|
```
|
||
|
|
||
|
Ensure you have ```libvirt-devel``` installed:
|
||
|
|
||
|
```bash
|
||
|
sudo yum install libvirt-devel
|
||
|
```
|
||
|
|
||
|
Finally, create the initial database.
|
||
|
|
||
|
```bash
|
||
|
rake db:create
|
||
|
```
|
||
|
|
||
|
### Setup Katello
|
||
|
|
||
|
The Katello setup assumes that you have a previously setup Foreman checkout or have followed the instructions in the Setup Foreman section. The first step is to add the Katello engine and install dependencies:
|
||
|
|
||
|
```bash
|
||
|
cd bundler.d && ln -s ../../katello/doc/katello.local.rb
|
||
|
cd ..
|
||
|
bundle update
|
||
|
```
|
||
|
|
||
|
Now migrate the database and load initial seed data:
|
||
|
|
||
|
```bash
|
||
|
rake db:migrate && rake db:seed
|
||
|
```
|
||
|
|
||
|
If you have set ```RAILS_RELATIVE_URL_ROOT``` in the past then you need to be sure to ```unset``` it and remove it from ```.bashrc``` or ```.bash_profile``` as appropriate.
|
||
|
|
||
|
```bash
|
||
|
unset RAILS_RELATIVE_URL_ROOT
|
||
|
```
|
||
|
|
||
|
Make sure that `use_ssl: false` is set in `config/katello.yml`. (**debatable**)
|
||
|
The recommended way to set up Katello for development to use the [katello-devel-installer](https://github.com/Katello/katello-installer#development-usage) directly or via [katello-deploy](https://github.com/Katello/katello-deploy#development-deployment).
|
||
|
|
||
|
### Test Run
|
||
|
|
||
Also available in: Unified diff
Fixes #4784: Replaces development setup documentation with references to
katello-devel-installer and katello-deploy.