diff --git a/_includes/manuals/3.11/1.2_release_notes.md b/_includes/manuals/3.11/1.2_release_notes.md index 218f4adc9f..bc3e74d6f1 100644 --- a/_includes/manuals/3.11/1.2_release_notes.md +++ b/_includes/manuals/3.11/1.2_release_notes.md @@ -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 @@ -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.* diff --git a/_includes/manuals/3.11/2.1_quickstart_installation.md b/_includes/manuals/3.11/2.1_quickstart_installation.md index ac7e91178e..d771ebf6c4 100644 --- a/_includes/manuals/3.11/2.1_quickstart_installation.md +++ b/_includes/manuals/3.11/2.1_quickstart_installation.md @@ -27,6 +27,7 @@ To provide specific installation instructions, please select your operating syst + @@ -121,6 +122,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 7.x repository: @@ -153,7 +174,7 @@ sudo dnf -y install foreman-installer {% endhighlight %}

-
+
{% highlight bash %} sudo apt-get update && sudo apt-get -y install foreman-installer {% endhighlight %} @@ -161,13 +182,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/3.11/2_quickstart_guide.md b/_includes/manuals/3.11/2_quickstart_guide.md index 877cf3ed12..c9ff542365 100644 --- a/_includes/manuals/3.11/2_quickstart_guide.md +++ b/_includes/manuals/3.11/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 20.04 (Focal), amd64 * Ubuntu 22.04 (Jammy), amd64 diff --git a/_includes/manuals/3.11/3.1.1_supported_platforms.md b/_includes/manuals/3.11/3.1.1_supported_platforms.md index 9ca318b53a..9b6ac86fb2 100644 --- a/_includes/manuals/3.11/3.1.1_supported_platforms.md +++ b/_includes/manuals/3.11/3.1.1_supported_platforms.md @@ -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. diff --git a/_includes/manuals/3.11/3.3.2_debian_packages.md b/_includes/manuals/3.11/3.3.2_debian_packages.md index 9eed373032..83d88b9931 100644 --- a/_includes/manuals/3.11/3.3.2_debian_packages.md +++ b/_includes/manuals/3.11/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 20.04 LTS (Focal Fossa), amd64 * Ubuntu Linux 22.04 LTS (Jammy Jellyfish), amd64 @@ -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 diff --git a/_includes/manuals/3.11/3.6_upgrade.md b/_includes/manuals/3.11/3.6_upgrade.md index 9be69877a4..e90d810ce1 100644 --- a/_includes/manuals/3.11/3.6_upgrade.md +++ b/_includes/manuals/3.11/3.6_upgrade.md @@ -38,6 +38,7 @@ To provide specific installation instructions, please select your operating syst + @@ -63,7 +64,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 %} @@ -135,7 +136,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. @@ -149,6 +150,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/ focal {{ page.version }} @@ -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 %}
-
+
{% highlight bash %} systemctl start apache2 foreman.service foreman.socket {% endhighlight %}