Skip to content

docs: Fix Fedora Repository, Icinga DB, SELinux#10479

Merged
julianbrost merged 1 commit intomasterfrom
docs-02-installation-fedora-fix-and-icingadb
Jun 17, 2025
Merged

docs: Fix Fedora Repository, Icinga DB, SELinux#10479
julianbrost merged 1 commit intomasterfrom
docs-02-installation-fedora-fix-and-icingadb

Conversation

@oxzi
Copy link
Copy Markdown
Member

@oxzi oxzi commented Jun 17, 2025

With Fedora 41, DNF was upgraded to version 5, breaking the command line API of "dnf config-manager"1. Unfortunately, DNF 5's addrepo does not work with a simple URL anymore, but requires to construct a .repo file.

Furthermore, no information about trusting the Icinga signing key was available, resulting in one being unable to install packages. This was already the case for Fedora 40, still using DNF 4.

Since we are building Icinga DB for Fedora, I have included Icinga DB documentation for Fedora. Otherwise, this section was empty.

Finally, the icingadb-redis-selinux package was mentioned for distributions were we started to build SELinux packages for2.

Footnotes

  1. https://docs.fedoraproject.org/en-US/quick-docs/adding-or-removing-software-repositories-in-fedora/#_adding_repositories

  2. SELinux package (like the Icinga 2 one) icingadb#580

@oxzi oxzi added this to the 2.15.0 milestone Jun 17, 2025
@oxzi oxzi requested a review from julianbrost June 17, 2025 07:09
@oxzi oxzi added the area/documentation End-user or developer help label Jun 17, 2025
@cla-bot cla-bot bot added the cla/signed label Jun 17, 2025
oxzi added a commit to oxzi/icinga-package-installation-docs that referenced this pull request Jun 17, 2025
With Fedora 41, DNF was upgraded to version 5, breaking the command line
API of "dnf config-manager"[^0]. Unfortunately, DNF 5's addrepo does not
work with a simple URL anymore, but requires to construct a .repo file.

Furthermore, no information about trusting the Icinga signing key was
available, resulting in one being unable to install packages. This was
already the case for Fedora 40, still using DNF 4.

This change is identical to another one in the Icinga 2 repo[^1].

[^0]: https://docs.fedoraproject.org/en-US/quick-docs/adding-or-removing-software-repositories-in-fedora/#_adding_repositories
[^1]: Icinga/icinga2#10479
oxzi added a commit to oxzi/icinga-package-installation-docs that referenced this pull request Jun 17, 2025
With Fedora 41, DNF was upgraded to version 5, breaking the command line
API of "dnf config-manager"[^0]. Unfortunately, DNF 5's addrepo does not
work with a simple URL anymore, but requires to construct a .repo file.

Furthermore, no information about trusting the Icinga signing key was
available, resulting in one being unable to install packages. This was
already the case for Fedora 40, still using DNF 4.

This change is identical to another one in the Icinga 2 repo[^1].

[^0]: https://docs.fedoraproject.org/en-US/quick-docs/adding-or-removing-software-repositories-in-fedora/#_adding_repositories
[^1]: Icinga/icinga2#10479
Comment on lines 108 to 122
#### Fedora 40 or earlier

```bash
dnf install -y 'dnf-command(config-manager)'
dnf config-manager --add-repo https://packages.icinga.com/fedora/$(. /etc/os-release; echo "$VERSION_ID")/release
rpm --import https://packages.icinga.com/icinga.key
```

#### Fedora 41 or later

```bash
dnf install -y 'dnf-command(config-manager)'
dnf config-manager addrepo --id=packages.icinga.com --set=name=Icinga --set=baseurl="https://packages.icinga.com/fedora/$(. /etc/os-release; echo "$VERSION_ID")/release"
rpm --import https://packages.icinga.com/icinga.key
```
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

but requires to construct a .repo file

We actually already provide that file on packages.icinga.com. For reference, in our container images, we do the following which works across all Fedora versions:

rpm --import https://packages.icinga.com/icinga.key
curl -o /etc/yum.repos.d/ICINGA-release.repo https://packages.icinga.com/fedora/ICINGA-release.repo

So I'd suggest using that instead as it's a simpler command and needs no version distinction.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch, thanks! I have changed the PR accordingly to get rid of the version-dependent cases.

oxzi added a commit to oxzi/icinga-package-installation-docs that referenced this pull request Jun 17, 2025
With Fedora 41, DNF was upgraded to version 5, breaking the command line
API of "dnf config-manager"[^0]. Unfortunately, DNF 5's addrepo does not
work with a simple URL anymore, but requires to construct a .repo file.

Furthermore, no information about trusting the Icinga signing key was
available, resulting in one being unable to install packages. This was
already the case for Fedora 40, still using DNF 4.

This change is identical to another one in the Icinga 2 repo[^1].

[^0]: https://docs.fedoraproject.org/en-US/quick-docs/adding-or-removing-software-repositories-in-fedora/#_adding_repositories
[^1]: Icinga/icinga2#10479
@oxzi oxzi force-pushed the docs-02-installation-fedora-fix-and-icingadb branch from 5ae5660 to b0b0331 Compare June 17, 2025 07:48
@oxzi oxzi requested a review from julianbrost June 17, 2025 07:48
@oxzi oxzi force-pushed the docs-02-installation-fedora-fix-and-icingadb branch from b0b0331 to cd1ec69 Compare June 17, 2025 08:08
With Fedora 41, DNF was upgraded to version 5, breaking the command line
API of "dnf config-manager"[^0]. Unfortunately, DNF 5's addrepo does not
work with a simple URL anymore, but requires to construct a .repo file.

Furthermore, no information about trusting the Icinga signing key was
available, resulting in one being unable to install packages. This was
already the case for Fedora 40, still using DNF 4.

Since we are building Icinga DB for Fedora, I have included Icinga DB
documentation for Fedora. Otherwise, this section was empty.

Finally, the icingadb-redis-selinux package was mentioned for
distributions were we started to build SELinux packages for[^1].

[^0]: https://docs.fedoraproject.org/en-US/quick-docs/adding-or-removing-software-repositories-in-fedora/#_adding_repositories
[^1]: Icinga/icingadb#580
@oxzi oxzi force-pushed the docs-02-installation-fedora-fix-and-icingadb branch from cd1ec69 to 881e1cc Compare June 17, 2025 08:41
@julianbrost julianbrost merged commit 6e654cd into master Jun 17, 2025
25 checks passed
@julianbrost julianbrost deleted the docs-02-installation-fedora-fix-and-icingadb branch June 17, 2025 08:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/documentation End-user or developer help cla/signed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants