RHEL

Installing Broker on RHEL systems

Make sure you have completed all generic prerequisites mentioned in the Prerequisites section.
Install OpenJDK 21 using the following command:
- Older versions of RHEL:
```
sudo yum install java-21-openjdk-devel
```
- Newer versions of RHEL:
```
sudo dnf install java-21-openjdk-devel
```
Verify the Java version:
```
java --version
```
Install the broker using the downloaded package:
```
sudo rpm -ivh britivrbroker.rpm
```
Change the directory to /opt:
```
cd /opt
```
Verify if the owner of the folder britive-broker is britivebroker; if not, change the owner of the britive-broker directory:
```
sudo chown -R britivebroker:britivebroker britive-broker
```
Change directory to broker's config file:
```
cd /opt/britive-broker/config/
```

Rename the config file:

mv broker-config-template.yml broker-config.yml

Open and edit the broker configuration file using vi:
```
vi broker-config.yml
```
Start the broker service:
```
sudo systemctl start britive-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:
```
$ sudo rpm -q britive-broker 
```
  Expected output example:
```
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:
```
$ 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:
```
$ 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:
```
$ sudo rpm -q britive-broker 
```
  Expected output example:
```
britive-broker-2.1.0 
```