How to install KOSI as a user

Setting up KOSI on RHEL systems requires a few key steps, including downloading the RPM file and configuring your environment. Here’s a quick guide to help you through the process.

Prerequisites

Operating System: A machine running RHEL 9.
Helm: Helm Must be installed on your machine. Refer to the Helm Official Documentation.
Podman:
KOSI requires Podman to be installed on your machine.

Note If you are a non-root user, ensure that the number of user namespaces (max_user_namespaces) is configured correctly. For more details, refer to this GitHub tutorial.

Install on RHEL9:
```
sudo dnf install podman
```
⚠ Caution KOSI supports only secure registries. If you use an insecure registry, you must explicitly add it as an insecure registry in registries.conf (/etc/containers/registries.conf).

Installation Steps

Download the KOSI RPM:
- Log in to your KubeOps account.
- Download your desired version of the KOSI RPM from the official download page.
Install the KOSI RPM on your admin node:
Run the following commands:
```
echo 'export KUBEOPSROOT=/home/<user>/kubeops' >> $HOME/.bashrc
source $HOME/.bashrc
sudo dnf install <path_to_rpm>/<kosi_file_name>.rpm
```
Note
- Replace <path_to_rpm> with the directory path where the file is located.
- Replace <kosi_file_name> with the exact RPM file name (including the .rpm extension).

$KUBEOPSROOT Variable

The $KUBEOPSROOT environment variable defines the location of the KOSI plugins, deployment.yaml, and config.yaml.
If you change the KUBEOPSROOT variable after installation, you must manually copy the updated deployment.yaml, config.yaml, and plugins.

Run the following commands to update them:

echo 'export KUBEOPSROOT=/home/<user>/kubeops' >> $HOME/.bashrc
source $HOME/.bashrc
cp -r /var/kubeops/kosi/config.yaml $KUBEOPSROOT/kosi/config.yaml
cp -r /var/kubeops/kosi/deployment.yaml $KUBEOPSROOT/kosi/deployment.yaml
cp -r /var/kubeops/plugins $KUBEOPSROOT/

For a clean installation, it is not necessary to move the deployment.yaml.

Check Installation

To verify that KOSI is installed correctly on your machine, run:

kosi version

A successful installation will display version details, it will look similar like this:

2024-08-07 13:49:00 Info:      KOSI version: 2.15.0.0_XXXXXXXXXX
2024-08-07 13:49:00 Info:      This work is licensed under Creative Commons Attribution - NoDerivatives 4.0 International License(see https://creativecommons.org/licenses/by-nd/4.0/legalcode for more details).
2024-08-07 13:49:00 Info:      © KubeOps GmbH, Hinter Stöck 17, 72406 Bisingen - Germany, 2023