Amazon Linux

Installing Broker on Amazon Linux

1. Make sure you have completed all generic prerequisites mentioned in the Prerequisites section.

2. Install OpenJDK 21 using the following command:

   sudo dnf install java-21-amazon-corretto-devel -y

3. Run the following command to verify Java installation:

   $ java -version

4. 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

5. Install the broker using the downloaded package. If you are upgrading/updating a broker, see Upgrading Access Broker.

   sudo rpm -ivh britivrbroker.rpm

6. Change the directory to /opt:

   cd /opt

7. 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

8. Change directory to broker's config file:

   cd /opt/britive-broker/config/

9. Rename the config file:

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

10. 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

11. A list of brokers is updated on Britive after users download and install the broker package on their system.

12. Start the Britive Broker service:

    systemclt service start britive-broker

Upgrading Access Broker

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.