Ubuntu

Installing Broker on Ubuntu

Make sure you have completed all generic prerequisites mentioned in the Prerequisites section.
Install OpenJDK 21 using the following command:
```
sudo apt install openjdk-21-jdk
```
Run the following command to verify Java installation:
```
$ java -version
```

Create a user and group britivebroker as a best practice before installing the broker:
1. Creating a group:
```
sudo groupadd britivebroker
```
2. Creating and adding a user to the group:
```
sudo useradd -g britivebroker britivebroker
```
The britive-broker Debian package has a dependency on the Debian package openjdk-21-jre-headless. If the openjdk-21-jre-headless package is not installed on the Debian system, run the following command to install it:
```
‘apt-get install openjdk-21-jre-headless’
```
Install the Debian package as the root user; the broker is installed at /opt/britive-broker.
```
‘dpkg -i <path to the downloaded Debian package>’
```

If the user britivebroker and the group britivebroker are already present, they are not created; otherwise, a user and a user group with the name britivebroker are created.

The system user `britivebroker' already exists. Exiting.
Unpacking britive-broker (1.0.0-SNAPSHOT) over (1.0.0-SNAPSHOT) ...
Setting up britive-broker (1.0.0-SNAPSHOT) ...

The contents of the /opt/britive-broker folder are:

drwxr-x--- 2 britivebroker britivebroker     4096 May 22 01:53 cache/
-rwxr-x--- 1 britivebroker britivebroker 26799984 Aug  6 20:19 britive-broker.jar*
drwxr-x--- 2 root          britivebroker     4096 Aug 13 18:59 bootstrap/
drwxr-xr-x 2 root          root              4096 Aug 13 18:59 config/

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 (broker-config.yml) using vi. For more details about the configuration file, see the Configure broker-config.yml file.
```
vi broker-config.yml
```
A list of brokers is updated on Britive after users download and install the broker package on their system.
Start the Britive Broker service:
```
systemctl service start britive-broker
```

Upgrading Access Broker

Uninstall the Debian or RPM package for the broker and install the desired version.
Ensure /opt/britive-broker/conf/broker-config.yml and /opt/britive-broker/conf/logback.xml have not been modified after the upgrade.