Skip to content

Latest commit

 

History

History
102 lines (71 loc) · 2.52 KB

3.3.2_debian_packages.md

File metadata and controls

102 lines (71 loc) · 2.52 KB
Raw

The Foreman packages should work on the following Debian-based Linux distributions:

Distributions

  • Debian Linux 11 (Bullseye), amd64
  • Ubuntu Linux 20.04 LTS (Focal Fossa), amd64
  • Ubuntu Linux 22.04 LTS (Jammy Jellyfish), amd64

If you encounter any errors during the installation, please file a bug report!

Apt Configuration

Add one of the following lines to your /etc/apt/sources.list (alternatively in a separate file in /etc/apt/sources.list.d/foreman.list):

# Debian Bullseye
deb http://deb.theforeman.org/ bullseye {{page.version}}
# Ubuntu 20.04 Focal
deb http://deb.theforeman.org/ focal {{page.version}}
# Ubuntu 22.04 Jammy
deb http://deb.theforeman.org/ jammy {{page.version}}

You may also want some plugins from the plugin repo (required for the Foreman Installer):

deb http://deb.theforeman.org/ plugins {{page.version}}

The public key for secure APT can be downloaded here

You can add this key with:

wget https://deb.theforeman.org/foreman.asc -O /etc/apt/trusted.gpg.d/foreman.asc

The key fingerprint is

5B7C 3E5A 735B CB4D 6158 29DC 0BDD A991 FD7A AC8A
Foreman Automatic Signing Key (2021) <packages@theforeman.org>

Remember to update your package lists!

apt-get update

Install packages

The packages are split by gem dependencies - there are 13 packages to choose from. These are:

Main package:

  • foreman

Database gems:

  • foreman-postgresql

Optional functionality:

  • foreman-console
  • foreman-debug
  • foreman-dynflow-sidekiq
  • foreman-ec2
  • foreman-journald
  • foreman-libvirt
  • foreman-openstack
  • foreman-ovirt
  • foreman-redis
  • foreman-service
  • foreman-telemetry
  • foreman-vmware

Command line interface:

  • ruby-hammer-cli
  • ruby-hammer-cli-foreman

Installation instructions are:

# Install packages  (adjust additional packages as needed)
apt-get install foreman foreman-postgresql foreman-libvirt

# Copy sample db config to /etc
cp /usr/share/foreman/config/database.yml.example /etc/foreman/database.yml

# Review settings and DB config
vi /etc/foreman/settings.yaml /etc/foreman/database.yml

# Perform initial DB setup
foreman-rake db:migrate
foreman-rake db:seed

The packages should auto-run db:migrate and db:seed if /etc/foreman/database.yml exists. So the initial DB setup is only needed during first install, upgrades should just work.

Upgrade

See upgrade instructions