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.

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

Correct Foreman 3.13+ release notes #2209

Merged
merged 3 commits into from
Dec 6, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
9 changes: 9 additions & 0 deletions _includes/manuals/3.13/1.2_release_notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,15 @@ Foreman now supports running on Debian 12 (Bookworm).

### Upgrade warnings

#### Running Foreman on Enterprise Linux 8 is not supported anymore

Running Foreman on Enterprise Linux 8 has been deprecated since 3.11 and removed in this release.

Note this is for running Foreman itself.
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 Ubuntu 20.04 (Focal) is not supported anymore

Foreman supports running on Ubuntu 22.04 LTS (Jammy Jellyfish) since 3.11.
Expand Down
31 changes: 2 additions & 29 deletions _includes/manuals/3.13/2.1_quickstart_installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ function update_quickstart_os(select) {
To provide specific installation instructions, please select your operating system:
<select onChange="update_quickstart_os(this);">
<option value="none">-- select operating system --</option>
<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>
Expand All @@ -37,16 +36,6 @@ To provide specific installation instructions, please select your operating syst
<i>No operating system selected.</i>
</div>

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

{% highlight bash %}
sudo dnf -y install https://yum.puppet.com/puppet8-release-el-8.noarch.rpm
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_el9">
<p>
Enable Puppet's 8.x repository:
Expand All @@ -57,14 +46,6 @@ sudo dnf -y install https://yum.puppet.com/puppet8-release-el-9.noarch.rpm
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_el8">
<p>Enable the Foreman repositories:</p>

{% highlight bash %}
sudo dnf -y install https://yum.theforeman.org/releases/{{page.version}}/el8/x86_64/foreman-release.rpm
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_el9">
<p>Enable the Foreman repositories:</p>

Expand All @@ -73,14 +54,6 @@ sudo dnf -y install https://yum.theforeman.org/releases/{{page.version}}/el9/x86
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_el8">
<p>Enable the Foreman module:</p>

{% highlight bash %}
sudo dnf -y module enable foreman:el8
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_debian11">
<p>
Enable Puppet's 8.x repository:
Expand Down Expand Up @@ -147,7 +120,7 @@ echo "deb http://deb.theforeman.org/ plugins {{page.version}}" | sudo tee -a /et
<i>No operating system selected.</i>
</div>

<div class="quickstart_os quickstart_os_el8 quickstart_os_el9">
<div class="quickstart_os quickstart_os_el9">
{% highlight bash %}
sudo dnf -y install foreman-installer
{% endhighlight %}
Expand All @@ -167,7 +140,7 @@ sudo apt-get update && sudo apt-get -y install foreman-installer

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_debian12 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_el9">
{% highlight bash %}
sudo foreman-installer
{% endhighlight %}
Expand Down
1 change: 0 additions & 1 deletion _includes/manuals/3.13/2_quickstart_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ The installation will require 4GB of memory, see [System Requirements](manuals/{

#### Supported platforms

* Enterprise Linux 8, x86_64
* Enterprise Linux 9, x86_64
* Debian 11 (Bullseye), amd64
* Debian 12 (Bookworm), amd64
Expand Down
3 changes: 0 additions & 3 deletions _includes/manuals/3.13/3.1.1_supported_platforms.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
The following operating systems are supported by the installer, have packages and are tested for deploying Foreman:

* Red Hat Enterprise Linux 8
* Architectures: x86_64 only
* Apply all SELinux-related errata.
* Red Hat Enterprise Linux 9
* Architectures: x86_64 only
* Apply all SELinux-related errata.
Expand Down
6 changes: 0 additions & 6 deletions _includes/manuals/3.13/3.3.1_rpm_packages.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@

Foreman is packaged for the following RPM based distributions:

* RHEL and derivatives, version 8
* RHEL and derivatives, version 9

**Note:** The RPM packages are not tested on Rocky Linux or Oracle Linux. The Foreman installation on Rocky Linux or Oracle Linux may or may not work.
Expand All @@ -26,11 +25,6 @@ Under each repo are directories for each distribution, then each architecture.

To set up the repository, foreman-release packages are provided which add a repo definition to `/etc/yum.repos.d`. Install the release RPM and enable the module:

# EL8
dnf -y install https://yum.theforeman.org/releases/{{page.version}}/el8/x86_64/foreman-release.rpm
dnf -y module enable foreman:el8

# EL9
dnf -y install https://yum.theforeman.org/releases/{{page.version}}/el9/x86_64/foreman-release.rpm

### Signing
Expand Down
44 changes: 2 additions & 42 deletions _includes/manuals/3.13/3.6_upgrade.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,6 @@ $(document).ready(function() {
To provide specific installation instructions, please select your operating system:
<select id="upgrade_os" onChange="update_upgrade_os(this);">
<option value="none">-- select operating system --</option>
<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>
Expand All @@ -58,7 +57,7 @@ Before proceeding, it is necessary to shutdown the Foreman instance.
<div class="upgrade_os upgrade_os_none">
<i>No operating system selected.</i>
</div>
<div class="upgrade_os upgrade_os_el8 upgrade_os_el9">
<div class="upgrade_os upgrade_os_el9">
{% highlight bash %}
systemctl stop httpd foreman.service foreman.socket dynflow\*
{% endhighlight %}
Expand All @@ -75,45 +74,6 @@ Now it's time to perform the actual upgrade.
<i>No operating system selected.</i>
</div>

<div class="upgrade_os upgrade_os_el8">
To upgrade an existing Foreman installation, first update with the
appropriate foreman-release package:

{% highlight bash %}
dnf upgrade https://yum.theforeman.org/releases/{{page.version}}/el8/x86_64/foreman-release.rpm
{% endhighlight %}

Clean up the yum metadata cache:

{% highlight bash %}
dnf clean metadata
{% endhighlight %}

If the Ruby 2.5 module was previously enabled, it must be reset:

{% highlight bash %}
dnf -y module reset ruby
{% endhighlight %}

Switch to the PostgreSQL 13 module:

{% highlight bash %}
dnf -y module switch-to postgresql:13
{% endhighlight %}

Enable the Foreman module:

{% highlight bash %}
dnf -y module enable foreman:el8
{% endhighlight %}

Next upgrade all Foreman packages:

{% highlight bash %}
dnf upgrade ruby\* foreman\*
{% endhighlight %}
</div>

<div class="upgrade_os upgrade_os_el9">
To upgrade an existing Foreman installation, first update with the
appropriate foreman-release package:
Expand Down Expand Up @@ -215,7 +175,7 @@ Start the application server. This is redundant if you previously ran `foreman-i
<div class="upgrade_os upgrade_os_none">
<i>*No operating system selected.*</i>
</div>
<div class="upgrade_os upgrade_os_el8 upgrade_os_el9">
<div class="upgrade_os upgrade_os_el9">
{% highlight bash %}
systemctl start httpd foreman.service foreman.socket
{% endhighlight %}
Expand Down
13 changes: 0 additions & 13 deletions _includes/manuals/nightly/1.2_release_notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,8 @@ This section will be updated prior to the next release.

### Headline features

#### Running Foreman on Debian 12 (Bookworm)

Foreman now supports running on Debian 12 (Bookworm).

### Upgrade warnings

#### Running Foreman on Ubuntu 20.04 (Focal) is not supported anymore

Foreman supports running on Ubuntu 22.04 LTS (Jammy Jellyfish) since 3.11.
Running Foreman on Ubuntu 20.04 LTS has been deprecated since 3.12.
Support for running Foreman on Ubuntu 20.04 LTS has been removed.

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

### Deprecations

### Release Notes
Expand Down
31 changes: 2 additions & 29 deletions _includes/manuals/nightly/2.1_quickstart_installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,6 @@ function update_quickstart_os(select) {
To provide specific installation instructions, please select your operating system:
<select onChange="update_quickstart_os(this);">
<option value="none">-- select operating system --</option>
<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>
Expand All @@ -37,16 +36,6 @@ To provide specific installation instructions, please select your operating syst
<i>No operating system selected.</i>
</div>

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

{% highlight bash %}
sudo dnf -y install https://yum.puppet.com/puppet8-release-el-8.noarch.rpm
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_el9">
<p>
Enable Puppet's 8.x repository:
Expand All @@ -57,14 +46,6 @@ sudo dnf -y install https://yum.puppet.com/puppet8-release-el-9.noarch.rpm
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_el8">
<p>Enable the Foreman repositories:</p>

{% highlight bash %}
sudo dnf -y install https://yum.theforeman.org/releases/{{page.version}}/el8/x86_64/foreman-release.rpm
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_el9">
<p>Enable the Foreman repositories:</p>

Expand All @@ -73,14 +54,6 @@ sudo dnf -y install https://yum.theforeman.org/releases/{{page.version}}/el9/x86
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_el8">
<p>Enable the Foreman module:</p>

{% highlight bash %}
sudo dnf -y module enable foreman:el8
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_debian11">
<p>
Enable Puppet's 8.x repository:
Expand Down Expand Up @@ -147,7 +120,7 @@ echo "deb http://deb.theforeman.org/ plugins {{page.version}}" | sudo tee -a /et
<i>No operating system selected.</i>
</div>

<div class="quickstart_os quickstart_os_el8 quickstart_os_el9">
<div class="quickstart_os quickstart_os_el9">
{% highlight bash %}
sudo dnf -y install foreman-installer
{% endhighlight %}
Expand All @@ -167,7 +140,7 @@ sudo apt-get update && sudo apt-get -y install foreman-installer

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_debian12 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_el9">
{% highlight bash %}
sudo foreman-installer
{% endhighlight %}
Expand Down
1 change: 0 additions & 1 deletion _includes/manuals/nightly/2_quickstart_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@ The installation will require 4GB of memory, see [System Requirements](manuals/{

#### Supported platforms

* Enterprise Linux 8, x86_64
* Enterprise Linux 9, x86_64
* Debian 11 (Bullseye), amd64
* Debian 12 (Bookworm), amd64
Expand Down
3 changes: 0 additions & 3 deletions _includes/manuals/nightly/3.1.1_supported_platforms.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,5 @@
The following operating systems are supported by the installer, have packages and are tested for deploying Foreman:

* Red Hat Enterprise Linux 8
* Architectures: x86_64 only
* Apply all SELinux-related errata.
* Red Hat Enterprise Linux 9
* Architectures: x86_64 only
* Apply all SELinux-related errata.
Expand Down
6 changes: 0 additions & 6 deletions _includes/manuals/nightly/3.3.1_rpm_packages.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@

Foreman is packaged for the following RPM based distributions:

* RHEL and derivatives, version 8
* RHEL and derivatives, version 9

**Note:** The RPM packages are not tested on Rocky Linux or Oracle Linux. The Foreman installation on Rocky Linux or Oracle Linux may or may not work.
Expand All @@ -26,11 +25,6 @@ Under each repo are directories for each distribution, then each architecture.

To set up the repository, foreman-release packages are provided which add a repo definition to `/etc/yum.repos.d`. Install the release RPM and enable the module:

# EL8
dnf -y install https://yum.theforeman.org/releases/{{page.version}}/el8/x86_64/foreman-release.rpm
dnf -y module enable foreman:el8

# EL9
dnf -y install https://yum.theforeman.org/releases/{{page.version}}/el9/x86_64/foreman-release.rpm

### Signing
Expand Down
Loading
Loading