7.6. Troubleshooting the K3s Installer

This section provides troubleshooting information for the Installing K3s phase of Running the LOCKSS Installer.

The LOCKSS Installer's install-lockss script installs K3s by executing Rancher's official K3s Installer 2 from https://get.k3s.io/ after making sure various firewall and DNS issues are addressed 3 4 5 6. However, the installer can still run into issues and fail. Some of the error messages you might encounter are documented below, but you may need to refer to the official K3s documentation or use a search engine to look up the specific error message.

7.6.1. Failed to apply container_runtime_exec_t to /usr/local/bin/k3s

In some Fedora systems, the K3s installer may fail with an error message similar to the following:

[ERROR]  Failed to apply container_runtime_exec_t to /usr/local/bin/k3s, please install:
    yum install -y container-selinux selinux-policy-base
    yum install -y https://rpm.rancher.io/k3s/stable/common/centos/8/noarch/k3s-selinux-0.3-0.el8.noarch.rpm

The specific commands and version numbers may vary from the example above.

To resolve this problem:

  1. Run the recommended commands as root 7.

  2. Re-run install-lockss 1.

7.6.2. k3s-selinux requires container-selinux

In some Oracle Linux 7 systems, you may see an error message similar to the following:

Error: Package: k3s-selinux-0.3-0.el7.noarch (rancher-k3s-common-stable)
           Requires: container-selinux >= 2.107-3
 You could try using --skip-broken to work around the problem
 You could try running: rpm -Va --nofiles --nodigest

The specific commands and version numbers may vary from the example above.

This can occur in environments where the Oracle Linux 7 Addons Yum repository is not enabled by default, so Rancher's official K3s installer is unable to install the package container-selinux automatically.

To resolve this problem:

  1. Run the following command as root 7:

    yum-config-manager --enable ol7_addons
    
  2. Re-run install-lockss 1.


Footnotes

1

See Running the LOCKSS Installer.

2

See Installing K3s.

3

See Configuring iptables for K3s.

4

See Configuring firewalld for K3s.

5

See Configuring ufw for K3s.

6

See Configuring CoreDNS for K3s.

7

See Running Commands as root.