Skip to content

Commit

Permalink
Update DEB install instructions (#383)
Browse files Browse the repository at this point in the history
Adjust text to not mention stable since it is no longer in the repository.
Update codenames and version numbers to those that are currently supported.
Replace usage of apt-key due to deprecation in Debian and Ubuntu [0].
Use signed-by to only use signing key with the Foreman repository.

[0] https://manpages.debian.org/testing/apt/apt-key.8.en.html
  • Loading branch information
jdyb authored Jun 10, 2024
1 parent fa7f44a commit fcad10f
Showing 1 changed file with 15 additions and 11 deletions.
26 changes: 15 additions & 11 deletions doc/installation_deb.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,26 +2,29 @@

#### Step 1: setup apt repositories

For Foreman 1.3 stable the hammer packages are part of your installation repo and you can skip this step.
Since Foreman 1.3 the hammer packages are part of your installation repo.
It is only necessary to setup apt repositories if you are installing Hammer separatly from Foreman.

You can choose from stable or nightly repo. Nightly has more recent version of hammer packages, but it was subject to less testing so there is a highr risk of issues.
You can choose from a specific version or nightly repo.
Nightly has more recent version of hammer packages that have only had limited testing so there is a higher risk of issues.

Choose stable (don't forget to replace "squeeze" with version name of your system)
Here are a few examples for combinations of Linux-distributions and Foreman releases.
Remember to adjust these as necessary, visit http://deb.theforeman.org/ for up to date information.

```bash
echo "deb http://deb.theforeman.org/ squeeze stable" > /etc/apt/sources.list.d/foreman.list
```

or nightly
##### Ubuntu Focal (20.04) with Foreman 3.10

```bash
echo "deb http://deb.theforeman.org/ squeeze nightly" > /etc/apt/sources.list.d/foreman.list
mkdir -p /etc/apt/keyrings
wget -qO- https://deb.theforeman.org/foreman.asc > /etc/apt/keyrings/foreman.asc
echo "deb [signed-by=/etc/apt/keyrings/foreman.asc] http://deb.theforeman.org/ focal 3.10" > /etc/apt/sources.list.d/foreman.list
```

and update the keys
##### Debian Bullseye (11) with Foreman nightly

```bash
wget -q https://deb.theforeman.org/foreman.asc -O- | apt-key add -
mkdir -p /etc/apt/keyrings
wget -qO- https://deb.theforeman.org/foreman.asc > /etc/apt/keyrings/foreman.asc
echo "deb [signed-by=/etc/apt/keyrings/foreman.asc] http://deb.theforeman.org/ bullseye nightly" > /etc/apt/sources.list.d/foreman.list
```

#### Step 2: install hammer core
Expand All @@ -46,3 +49,4 @@ $ apt-get install ruby-hammer-cli-katello
```

To install any other hammer plugin just make sure the appropriate gem is installed and follow with the [configuration](installation.md#configuration).

0 comments on commit fcad10f

Please sign in to comment.