Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Debian 12 support to the Foreman 3.11 manual #2191

Merged
merged 1 commit into from
Oct 31, 2024
+52 −6
Merged

Add Debian 12 support to the Foreman 3.11 manual #2191

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions _includes/manuals/3.11/1.2_release_notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,11 @@ For more details, see https://projects.theforeman.org/issues/37252 and https://p

Foreman 3.10 only supported Enterprise Linux 9 as experimental, but with this release it is fully supported.

#### Running Foreman on Debian 12 is supported

Packages for Debian 12 were built with 3.11.0, but our automated pipelines rely on Puppetserver.
Now that Puppetserver packages for Debian 12 are available, with Foreman 3.11.4 Debian 12 is considered a supported platform.

### Upgrade warnings

#### keycloak-httpd-client-install dropped from Enterprise Linux 9
Expand All @@ -43,6 +48,13 @@ Clients will remain supported.

For more details and discussion, see https://community.theforeman.org/t/drop-support-for-running-on-el8-with-foreman-3-13/38083.

#### Running Foreman on Debian 11 removal in Foreman 3.14

Users are encouraged to upgrade to Debian 12.

Note this is for running Foreman itself.
Clients will remain supported.

### Release notes for 3.11.4
*Packages for Debian 12 were built with 3.11.0, but our automated pipelines rely on Puppetserver.
Now that Puppetserver packages for Debian 12 are available, this can be considered a supported platform.*
Expand Down
27 changes: 24 additions & 3 deletions _includes/manuals/3.11/2.1_quickstart_installation.md
View file
Open in desktop
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="ubuntu2004">Ubuntu 20.04 (Focal)</option>
<option value="ubuntu2204">Ubuntu 22.04 (Jammy)</option>
</select>
Expand Down Expand Up @@ -121,6 +122,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 7.x repository:
Expand Down Expand Up @@ -153,21 +174,21 @@ sudo dnf -y install foreman-installer
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_debian11 quickstart_os_ubuntu2004 quickstart_os_ubuntu2204">
<div class="quickstart_os quickstart_os_debian11 quickstart_os_debian12 quickstart_os_ubuntu2004 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_ubuntu2004 quickstart_os_ubuntu2204 alert alert-info">
<div class="quickstart_os quickstart_os_debian11 quickstart_os_debian12 quickstart_os_ubuntu2004 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_ubuntu2004 quickstart_os_ubuntu2204 quickstart_os_el8 quickstart_os_el9">
<div class="quickstart_os quickstart_os_none quickstart_os_debian11 quickstart_os_debian12 quickstart_os_ubuntu2004 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/3.11/2_quickstart_guide.md
View file
Open in desktop
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 20.04 (Focal), amd64
* Ubuntu 22.04 (Jammy), amd64

Expand Down
2 changes: 2 additions & 0 deletions _includes/manuals/3.11/3.1.1_supported_platforms.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,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/3.11/3.3.2_debian_packages.md
View file
Open in desktop
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 20.04 LTS (Focal Fossa), amd64
* Ubuntu Linux 22.04 LTS (Jammy Jellyfish), amd64

Expand All @@ -16,6 +17,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 20.04 Focal
deb http://deb.theforeman.org/ focal {{page.version}}
# Ubuntu 22.04 Jammy
Expand Down
13 changes: 10 additions & 3 deletions _includes/manuals/3.11/3.6_upgrade.md
View file
Open in desktop
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="ubuntu2004">Ubuntu 20.04 (Focal)</option>
<option value="ubuntu2204">Ubuntu 22.04 (Jammy)</option>
</select>
Expand All @@ -63,7 +64,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_ubuntu2004 upgrade_os_ubuntu2204">
<div class="upgrade_os upgrade_os_debian11 upgrade_os_debian12 upgrade_os_ubuntu2004 upgrade_os_ubuntu2204">
{% highlight bash %}
systemctl stop apache2 foreman.service foreman.socket dynflow\*
{% endhighlight %}
Expand Down Expand Up @@ -135,7 +136,7 @@ dnf upgrade ruby\* foreman\*
{% endhighlight %}
</div>

<div class="upgrade_os upgrade_os_debian11 upgrade_os_ubuntu2004 upgrade_os_ubuntu2204">
<div class="upgrade_os upgrade_os_debian11 upgrade_os_debian12 upgrade_os_ubuntu2004 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 @@ -149,6 +150,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_ubuntu2004">
{% highlight bash %}
deb http://deb.theforeman.org/ focal {{ page.version }}
Expand Down Expand Up @@ -220,7 +227,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_ubuntu2004 upgrade_os_ubuntu2204">
<div class="upgrade_os upgrade_os_debian11 upgrade_os_debian12 upgrade_os_ubuntu2004 upgrade_os_ubuntu2204">
{% highlight bash %}
systemctl start apache2 foreman.service foreman.socket
{% endhighlight %}
Expand Down