---
title: "RHEL"
slug: "rhel"
updated: 2026-05-08T12:24:50Z
published: 2026-05-08T12:24:50Z
canonical: "docs.britive.com/rhel"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.britive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# RHEL

## Installing Broker on RHEL systems

1. Make sure you have completed all generic prerequisites mentioned in the [Prerequisites](/v1/docs/installing-and-configuring-broker-1#prerequisites) section.
2. Install *OpenJDK 21* using the following command:
  - Older versions of RHEL:

```shell
sudo yum install java-21-openjdk-devel
```
  - Newer versions of RHEL:

```shell
sudo dnf install java-21-openjdk-devel
```
3. Verify the Java version:

```shell
java --version
```
4. Install the broker using the downloaded package:

```shell
sudo rpm -ivh britivrbroker.rpm
```
5. Change the directory to */opt*:

```shell
cd /opt
```
6. Verify if the owner of the folder britive-broker is britivebroker; if not, change the owner of the *britive-broker* directory:

```shell
sudo chown -R britivebroker:britivebroker britive-broker
```
7. Change directory to broker's config file:

```shell
cd /opt/britive-broker/config/
```
8. Rename the config file:

```shell
mv broker-config-template.yml broker-config.yml
```
9. Open and edit the broker configuration file using vi:

```shell
vi broker-config.yml
```
10. Start the broker service:

```shell
sudo systemctl start britive-broker
```

## Upgrading Access Broker

There are two ways to upgrade an Access Broker on RHEL:

- Uninstalling and installing broker package again:
  1. Uninstall the Britive package for the broker and install the desired version.
  2. Ensure */opt/britive-broker/conf/broker-config.yml* and */opt/britive-broker/conf/logback.xml* have not been modified after the upgrade.
- In-place upgrade, preserving the existing broker configuration files:
  1. Verify the current version of the broker package:

```shell
$ sudo rpm -q britive-broker
```

Expected output example:

```shell
britive-broker-2.0.1
```

Make a note of the current version. This is useful for rollback reference if needed.
  2. Run the following command to perform the in-place upgrade, replacing the filename with the actual RPM file path:

```shell
$ sudo yum upgrade ./britive-broker-2.1.0.rpm
```

Yum resolves dependencies and upgrades the existing installation without removing configuration files. Confirm any prompts during the process.
  3. Restart the broker service to load the new version:

```shell
$ sudo systemctl restart britive-broker.service
```

The service stops, applies the updated binaries, and starts again. No output is returned on success.
  4. Run the version query again to confirm the upgrade was successful:

```shell
$ sudo rpm -q britive-broker
```

Expected output example:

```shell
britive-broker-2.1.0
```