Skip to content

Commit

Permalink
add Debian 12 (Bookworm) to docs
Browse files Browse the repository at this point in the history
  • Loading branch information
evgeni authored and ekohl committed Oct 23, 2024
1 parent 74d7990 commit 3c30513
Show file tree
Hide file tree
Showing 5 changed files with 40 additions and 6 deletions.
27 changes: 24 additions & 3 deletions _includes/manuals/nightly/2.1_quickstart_installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ To provide specific installation instructions, please select your operating syst
<option value="el8">Enterprise Linux 8</option>
<option value="el9">Enterprise Linux 9</option>
<option value="debian11">Debian 11 (Bullseye)</option>
<option value="debian12">Debian 12 (Bookworm)</option>
<option value="ubuntu2204">Ubuntu 22.04 (Jammy)</option>
</select>

Expand Down Expand Up @@ -100,6 +101,26 @@ echo "deb http://deb.theforeman.org/ plugins {{page.version}}" | sudo tee -a /et
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_debian12">
<p>
Enable Puppet's 8.x repository:
</p>

{% highlight bash %}
sudo apt-get -y install ca-certificates
cd /tmp && wget https://apt.puppet.com/puppet8-release-bookworm.deb
sudo apt-get install /tmp/puppet8-release-bookworm.deb
{% endhighlight %}

<p>Enable the Foreman repositories:</p>

{% highlight bash %}
sudo wget https://deb.theforeman.org/foreman.asc -O /etc/apt/trusted.gpg.d/foreman.asc
echo "deb http://deb.theforeman.org/ bookworm {{page.version}}" | sudo tee /etc/apt/sources.list.d/foreman.list
echo "deb http://deb.theforeman.org/ plugins {{page.version}}" | sudo tee -a /etc/apt/sources.list.d/foreman.list
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_ubuntu2204">
<p>
Enable Puppet's 8.x repository:
Expand Down Expand Up @@ -132,21 +153,21 @@ sudo dnf -y install foreman-installer
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_debian11 quickstart_os_ubuntu2204">
<div class="quickstart_os quickstart_os_debian11 quickstart_os_debian12 quickstart_os_ubuntu2204">
{% highlight bash %}
sudo apt-get update && sudo apt-get -y install foreman-installer
{% endhighlight %}
</div>

#### Running the installer

<div class="quickstart_os quickstart_os_debian11 quickstart_os_ubuntu2204 alert alert-info">
<div class="quickstart_os quickstart_os_debian11 quickstart_os_debian12 quickstart_os_ubuntu2204 alert alert-info">
Ensure that <code>ping $(hostname -f)</code> shows the real IP address, not 127.0.1.1. Change or remove this entry from /etc/hosts if present.
</div>

The installation run is non-interactive, but the configuration can be customized by supplying any of the options listed in `foreman-installer --help`, or by running `foreman-installer -i` for interactive mode. More examples are given in the [Installation Options](/manuals/{{page.version}}/index.html#3.2.2InstallerOptions) section. Adding `-v` will disable the progress bar and display all changes. To run the installer, execute:

<div class="quickstart_os quickstart_os_none quickstart_os_debian11 quickstart_os_ubuntu2204 quickstart_os_el8 quickstart_os_el9">
<div class="quickstart_os quickstart_os_none quickstart_os_debian11 quickstart_os_debian12 quickstart_os_ubuntu2204 quickstart_os_el8 quickstart_os_el9">
{% highlight bash %}
sudo foreman-installer
{% endhighlight %}
Expand Down
1 change: 1 addition & 0 deletions _includes/manuals/nightly/2_quickstart_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ The installation will require 4GB of memory, see [System Requirements](manuals/{
* Enterprise Linux 8, x86_64
* Enterprise Linux 9, x86_64
* Debian 11 (Bullseye), amd64
* Debian 12 (Bookworm), amd64
* Ubuntu 22.04 (Jammy), amd64

#### Enterprise Linux
Expand Down
2 changes: 2 additions & 0 deletions _includes/manuals/nightly/3.1.1_supported_platforms.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,8 @@ The following operating systems are supported by the installer, have packages an
* Architectures: amd64
* Debian 11 (Bullseye)
* Architectures: amd64
* Debian 12 (Bookworm)
* Architectures: amd64

PostgreSQL version 10 or newer.

Expand Down
3 changes: 3 additions & 0 deletions _includes/manuals/nightly/3.3.2_debian_packages.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,7 @@ The Foreman packages should work on the following Debian-based Linux distributio
#### Distributions

* Debian Linux 11 (Bullseye), amd64
* Debian Linux 12 (Bookworm), amd64
* Ubuntu Linux 22.04 LTS (Jammy Jellyfish), amd64

If you encounter any errors during the installation, [please file a bug report!](/contribute.html#Bugreporting)
Expand All @@ -15,6 +16,8 @@ Add one of the following lines to your */etc/apt/sources.list* (alternatively in
```
# Debian Bullseye
deb http://deb.theforeman.org/ bullseye {{page.version}}
# Debian Bookworm
deb http://deb.theforeman.org/ bookworm {{page.version}}
# Ubuntu 22.04 Jammy
deb http://deb.theforeman.org/ jammy {{page.version}}
```
Expand Down
13 changes: 10 additions & 3 deletions _includes/manuals/nightly/3.6_upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ To provide specific installation instructions, please select your operating syst
<option value="el8">Red Hat Enterprise Linux 8</option>
<option value="el9">CentOS Stream 9 / Red Hat Enterprise Linux 9</option>
<option value="debian11">Debian 11 (Bullseye)</option>
<option value="debian12">Debian 12 (Bookworm)</option>
<option value="ubuntu2204">Ubuntu 22.04 (Jammy)</option>
</select>

Expand All @@ -62,7 +63,7 @@ Before proceeding, it is necessary to shutdown the Foreman instance.
systemctl stop httpd foreman.service foreman.socket dynflow\*
{% endhighlight %}
</div>
<div class="upgrade_os upgrade_os_debian11 upgrade_os_ubuntu2204">
<div class="upgrade_os upgrade_os_debian11 upgrade_os_debian12 upgrade_os_ubuntu2204">
{% highlight bash %}
systemctl stop apache2 foreman.service foreman.socket dynflow\*
{% endhighlight %}
Expand Down Expand Up @@ -134,7 +135,7 @@ dnf upgrade ruby\* foreman\*
{% endhighlight %}
</div>

<div class="upgrade_os upgrade_os_debian11 upgrade_os_ubuntu2204">
<div class="upgrade_os upgrade_os_debian11 upgrade_os_debian12 upgrade_os_ubuntu2204">
Upgrading from the last release to {{page.version}} has been tested. Updating
the packages will upgrade the application and automatically migrate the
database.
Expand All @@ -148,6 +149,12 @@ deb http://deb.theforeman.org/ bullseye {{ page.version }}
deb http://deb.theforeman.org/ plugins {{ page.version }}
{% endhighlight %}
</div>
<div class="upgrade_os upgrade_os_debian12">
{% highlight bash %}
deb http://deb.theforeman.org/ bookworm {{ page.version }}
deb http://deb.theforeman.org/ plugins {{ page.version }}
{% endhighlight %}
</div>
<div class="upgrade_os upgrade_os_ubuntu2204">
{% highlight bash %}
deb http://deb.theforeman.org/ jammy {{ page.version }}
Expand Down Expand Up @@ -213,7 +220,7 @@ Start the application server. This is redundant if you previously ran `foreman-i
systemctl start httpd foreman.service foreman.socket
{% endhighlight %}
</div>
<div class="upgrade_os upgrade_os_debian11 upgrade_os_ubuntu2204">
<div class="upgrade_os upgrade_os_debian11 upgrade_os_debian12 upgrade_os_ubuntu2204">
{% highlight bash %}
systemctl start apache2 foreman.service foreman.socket
{% endhighlight %}
Expand Down

0 comments on commit 3c30513

Please sign in to comment.