Install LinceBI on GNU/Linux

Install LinceBI

1. Install dependencies.

Debian, Ubuntu and derivatives:

apt-get update
apt-get install openjdk-11-jdk unzip

RHEL/CentOS and derivatives:

yum install java-11-openjdk unzip

2. Create lincebi user and group.

useradd -r -s "$(command -v nologin)" -md /var/cache/lincebi -U lincebi

3. Extract LinceBI package.

unzip ./lincebi.zip -d /opt/lincebi/
chown -R lincebi:lincebi /opt/lincebi/

4. If you are going to access LinceBI from another hostname different from localhost, update the fully-qualified-server-url property.

You can find this property in the pentaho-solutions/system/server.properties file.

5. Start LinceBI.

sudo -u lincebi /opt/lincebi/start-pentaho.sh

6. Access LinceBI from a web browser.

  • URL: http://localhost:8080
  • User: admin
  • Password: password

You must wait until the text “Pentaho BI Platform server is ready” is printed in the tomcat/logs/catalina.YYYY-MM-DD.out file.

Install systemd service (optional)

Following from the previous step 3.

1. Create /etc/systemd/system/lincebi.service file with the following content.

[Unit]
Description=LinceBI service
After=local-fs.target network.target

[Service]
Type=forking
User=lincebi
Group=lincebi
PIDFile=/opt/lincebi/lincebi.pid
Environment=CATALINA_PID=/opt/lincebi/lincebi.pid
ExecStart=/opt/lincebi/start-pentaho.sh
ExecStop=/opt/lincebi/stop-pentaho.sh
Restart=on-failure
RestartSec=30
TimeoutSec=30
NoNewPrivileges=yes
PrivateDevices=yes
PrivateTmp=yes
ProtectHome=yes
ProtectSystem=strict
ProtectKernelModules=yes
ProtectKernelTunables=yes
ProtectControlGroups=yes
ReadWritePaths=/opt/lincebi/
ReadWritePaths=/var/cache/lincebi/

[Install]
WantedBy=multi-user.target

2. Reload systemd configuration.

systemctl daemon-reload

3. Enable and start LinceBI service.

systemctl enable --now lincebi.service

IMPORTANT: If you install LinceBI as a service you should never directly execute the
start-pentaho.sh and stop-pentaho.sh scripts, you should always use the systemd service.