From 3c30513b8a54576949b099f1df0f1385304ecb96 Mon Sep 17 00:00:00 2001 From: Evgeni Golov Date: Wed, 23 Oct 2024 08:23:20 +0200 Subject: [PATCH] add Debian 12 (Bookworm) to docs --- .../nightly/2.1_quickstart_installation.md | 27 ++++++++++++++++--- .../manuals/nightly/2_quickstart_guide.md | 1 + .../nightly/3.1.1_supported_platforms.md | 2 ++ .../manuals/nightly/3.3.2_debian_packages.md | 3 +++ _includes/manuals/nightly/3.6_upgrade.md | 13 ++++++--- 5 files changed, 40 insertions(+), 6 deletions(-) diff --git a/_includes/manuals/nightly/2.1_quickstart_installation.md b/_includes/manuals/nightly/2.1_quickstart_installation.md index fd0b2da0f6..1532a6f767 100644 --- a/_includes/manuals/nightly/2.1_quickstart_installation.md +++ b/_includes/manuals/nightly/2.1_quickstart_installation.md @@ -27,6 +27,7 @@ To provide specific installation instructions, please select your operating syst + @@ -100,6 +101,26 @@ echo "deb http://deb.theforeman.org/ plugins {{page.version}}" | sudo tee -a /et {% endhighlight %} +
+

+ Enable Puppet's 8.x repository: +

+ +{% 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 %} + +

Enable the Foreman repositories:

+ +{% 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 %} +
+

Enable Puppet's 8.x repository: @@ -132,7 +153,7 @@ sudo dnf -y install foreman-installer {% endhighlight %}

-
+
{% highlight bash %} sudo apt-get update && sudo apt-get -y install foreman-installer {% endhighlight %} @@ -140,13 +161,13 @@ sudo apt-get update && sudo apt-get -y install foreman-installer #### Running the installer -
+
Ensure that ping $(hostname -f) shows the real IP address, not 127.0.1.1. Change or remove this entry from /etc/hosts if present.
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: -
+
{% highlight bash %} sudo foreman-installer {% endhighlight %} diff --git a/_includes/manuals/nightly/2_quickstart_guide.md b/_includes/manuals/nightly/2_quickstart_guide.md index 84c1cd9337..e0e4c16970 100644 --- a/_includes/manuals/nightly/2_quickstart_guide.md +++ b/_includes/manuals/nightly/2_quickstart_guide.md @@ -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 diff --git a/_includes/manuals/nightly/3.1.1_supported_platforms.md b/_includes/manuals/nightly/3.1.1_supported_platforms.md index 7924aaecff..691ec44186 100644 --- a/_includes/manuals/nightly/3.1.1_supported_platforms.md +++ b/_includes/manuals/nightly/3.1.1_supported_platforms.md @@ -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. diff --git a/_includes/manuals/nightly/3.3.2_debian_packages.md b/_includes/manuals/nightly/3.3.2_debian_packages.md index 48d26019b8..0fe8b40415 100644 --- a/_includes/manuals/nightly/3.3.2_debian_packages.md +++ b/_includes/manuals/nightly/3.3.2_debian_packages.md @@ -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) @@ -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}} ``` diff --git a/_includes/manuals/nightly/3.6_upgrade.md b/_includes/manuals/nightly/3.6_upgrade.md index 0b8f01030f..a7128ad4df 100644 --- a/_includes/manuals/nightly/3.6_upgrade.md +++ b/_includes/manuals/nightly/3.6_upgrade.md @@ -38,6 +38,7 @@ To provide specific installation instructions, please select your operating syst + @@ -62,7 +63,7 @@ Before proceeding, it is necessary to shutdown the Foreman instance. systemctl stop httpd foreman.service foreman.socket dynflow\* {% endhighlight %}
-
+
{% highlight bash %} systemctl stop apache2 foreman.service foreman.socket dynflow\* {% endhighlight %} @@ -134,7 +135,7 @@ dnf upgrade ruby\* foreman\* {% endhighlight %}
-
+
Upgrading from the last release to {{page.version}} has been tested. Updating the packages will upgrade the application and automatically migrate the database. @@ -148,6 +149,12 @@ deb http://deb.theforeman.org/ bullseye {{ page.version }} deb http://deb.theforeman.org/ plugins {{ page.version }} {% endhighlight %}
+
+{% highlight bash %} +deb http://deb.theforeman.org/ bookworm {{ page.version }} +deb http://deb.theforeman.org/ plugins {{ page.version }} +{% endhighlight %} +
{% highlight bash %} deb http://deb.theforeman.org/ jammy {{ page.version }} @@ -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 %}
-
+
{% highlight bash %} systemctl start apache2 foreman.service foreman.socket {% endhighlight %}