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

Jump to bottom

add Ubuntu 22.04 to nightly manual #2133

Merged
merged 1 commit into from
Mar 7, 2024
Merged

add Ubuntu 22.04 to nightly manual #2133

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
27 changes: 24 additions & 3 deletions _includes/manuals/nightly/2.1_quickstart_installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,7 @@ To provide specific installation instructions, please select your operating syst
<option value="el9">Enterprise Linux 9</option>
<option value="debian11">Debian 11 (Bullseye)</option>
<option value="ubuntu2004">Ubuntu 20.04 (Focal)</option>
<option value="ubuntu2204">Ubuntu 22.04 (Jammy)</option>
</select>

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

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

{% highlight bash %}
sudo apt-get -y install ca-certificates
cd /tmp && wget https://apt.puppet.com/puppet7-release-jammy.deb
sudo apt-get install /tmp/puppet7-release-jammy.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/ jammy {{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>

#### Downloading the installer

<div class="quickstart_os quickstart_os_none">
Expand All @@ -132,21 +153,21 @@ sudo dnf -y install foreman-installer
{% endhighlight %}
</div>

<div class="quickstart_os quickstart_os_debian11 quickstart_os_ubuntu2004">
<div class="quickstart_os quickstart_os_debian11 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 alert alert-info">
<div class="quickstart_os quickstart_os_debian11 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_el8 quickstart_os_el9">
<div class="quickstart_os quickstart_os_none quickstart_os_debian11 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/nightly/2_quickstart_guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ The installation will require 4GB of memory, see [System Requirements](manuals/{
* Enterprise Linux 9, x86_64
* Debian 11 (Bullseye), amd64
* Ubuntu 20.04 (Focal), 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
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,8 @@ The following operating systems are supported by the installer, have packages an
- EPEL 9 is incompatible, enabling will cause package dependency issue.
* Ubuntu 20.04 (Focal)
* Architectures: amd64
* Ubuntu 22.04 (Jammy)
* Architectures: amd64
* Debian 11 (Bullseye)
* Architectures: amd64

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

* Debian Linux 11 (Bullseye), amd64
* Ubuntu Linux 20.04 LTS (Focal Fossa), 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 @@ -17,6 +18,8 @@ Add one of the following lines to your */etc/apt/sources.list* (alternatively in
deb http://deb.theforeman.org/ bullseye {{page.version}}
# Ubuntu 20.04 Focal
deb http://deb.theforeman.org/ focal {{page.version}}
# Ubuntu 22.04 Jammy
deb http://deb.theforeman.org/ jammy {{page.version}}
```

You may also want some plugins from the plugin repo (required for the Foreman Installer):
Expand Down
13 changes: 10 additions & 3 deletions _includes/manuals/nightly/3.6_upgrade.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -39,6 +39,7 @@ To provide specific installation instructions, please select your operating syst
<option value="el9">CentOS Stream 9 / Red Hat Enterprise Linux 8</option>
<option value="debian11">Debian 11 (Bullseye)</option>
<option value="ubuntu2004">Ubuntu 20.04 (Focal)</option>
<option value="ubuntu2204">Ubuntu 22.04 (Jammy)</option>
</select>

#### Step 1 - Backup
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_ubuntu2004">
<div class="upgrade_os upgrade_os_debian11 upgrade_os_ubuntu2004 upgrade_os_ubuntu2204">
{% highlight bash %}
systemctl stop apache2 foreman.service foreman.socket dynflow\*
{% endhighlight %}
Expand Down Expand Up @@ -128,7 +129,7 @@ dnf upgrade ruby\* foreman\*
{% endhighlight %}
</div>

<div class="upgrade_os upgrade_os_debian11 upgrade_os_ubuntu2004">
<div class="upgrade_os upgrade_os_debian11 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 @@ -148,6 +149,12 @@ deb http://deb.theforeman.org/ focal {{ 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 }}
deb http://deb.theforeman.org/ plugins {{ page.version }}
{% endhighlight %}
</div>

Next upgrade all Foreman packages:

Expand Down Expand Up @@ -207,7 +214,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">
<div class="upgrade_os upgrade_os_debian11 upgrade_os_ubuntu2004 upgrade_os_ubuntu2204">
{% highlight bash %}
systemctl start apache2 foreman.service foreman.socket
{% endhighlight %}
Expand Down