Step-by-Step Guide: Installation of RERO ILS on Clear Linux Latest

The following is a comprehensive guide on how to install RERO ILS on Clear Linux Latest using step-by-step instructions.

Prerequisites

Before installing RERO ILS, ensure that you have met the following prerequisites:

  • A Clear Linux Latest Operating System
  • A minimum of 8 GB RAM and 4 cores CPU
  • Java 11 or higher
  • PostgreSQL 10 or higher
  • Apache Maven 3.6.0 or higher

Installation Steps

  1. Install Java 11 or higher if it is not already installed.

sudo swupd bundle-add java-basic

  1. Install PostgreSQL 10 or higher if it is not already installed.

sudo swupd bundle-add postgresql

  1. Install Apache Maven 3.6.0 or higher if it is not already installed.

sudo swupd bundle-add maven

  1. Create a new user and group for running the RERO ILS application.

sudo useradd -m -d /opt/reroils -s /bin/bash reroils

  1. Create a new directory for the installation of RERO ILS

sudo mkdir /opt/reroils

  1. Change the ownership of the /opt/reroils directory to the newly created reroils user

sudo chown reroils:reroils /opt/reroils

  1. Download the RERO ILS source code from its Github repository.

git clone https://github.com/rero/rero-ils.git

  1. Navigate into the cloned repository directory.

cd rero-ils

  1. Switch to the latest stable tag of the RERO ILS repository

git tag -l

git checkout tags/1.4.1

  1. Configure the RERO ILS application settings by editing the ils_vars.env file.

  2. Use Maven to compile the RERO ILS application source code.

sudo mvn clean package -X -Dmaven.test.skip=true

  1. When the build is completed, deploy the application to the target directory.

sudo cp rero-ils-app/target/rero-ils-app-*.jar /opt/reroils/rero-ils-app.jar

  1. Create a JAR file containing all required dependencies.

sudo mvn dependency:copy-dependencies -DoutputDirectory=./target/lib

  1. Create a directory for the configuration.

sudo mkdir /opt/reroils/conf

  1. Copy the configuration files to the target directory.

sudo cp -v rero-ils-app/src/main/resources/application.yml rero-ils-app/src/main/resources/logback.xml /opt/reroils/conf/

  1. Use the following command to start the RERO ILS application.

cd /opt/reroils && sudo java -Dspring.config.additional-location=/opt/reroils/conf/ -jar rero-ils-app.jar

  1. Verify that the RERO ILS application is running by visiting the following URL in your web browser.

http://localhost:8080

Conclusion

The above step-by-step guide provides a comprehensive explanation of how to install RERO ILS on Clear Linux Latest. With these instructions, you should now be able to set up the RERO ILS application on your system with ease.