Installation¶

LIKPI CMDB license¶

The LIKPI Community Edition embeds a license ready to be used with a limitation on the number of Configuration Items (CIs) managed.

For further information about the Enterprise version, please visit our site Likpi.

Downloading the installation files¶

You can download the installation files, including the frontend build and backend JAR, from Download Likpi.

Pre-installation tasks on Debian operating system for example¶

Log on the server on which you want to install the CMDB application.

Warning

If you are reinstalling the CMDB Server due to a failure, you must delete all the existing installation directories and files except $LIKPI_PATH/security.

Installation tasks with system administrator¶

Check FQDN on /etc/host¶

When applicable, please edit /etc/host with your system administrator and check if the FQDN and hostname are configured.

127.0.1.1 <hostname.domain> <hostname>

Note

It will help the backend networking and clustering configuration to get the FQDN.

Create user likpiadm for LIKPI application¶

Create user without sudo:

$ sudo mkdir /home/likpiadm
$ sudo useradd -d /home/likpiadm likpiadm
$ sudo chown likpiadm:likpiadm /home/likpiadm
$ sudo passwd likpiadm (your_password)

Set user shell:

$ sudo vi /etc/passwd
likpiadm:x:1001:1001::/home/likpiadm:             // (Before)
likpiadm:x:1001:1001::/home/likpiadm:/bin/bash    // (After)

Create likpi group¶

$ sudo groupadd likpi

To add a likpiadm user to likpi group:

$ sudo usermod -g likpi likpiadm

Check likpiadm:

$ id likpiadm

Repository for Likpi application (Frontend Node)¶

$ sudo mkdir /opt/likpi
$ sudo mkdir /opt/likpi/cmdb-frontend
$ sudo chown -R likpiadm:likpi /opt/likpi

Repository for Likpi application (Backend Node)¶

$ sudo mkdir /opt/likpi
$ sudo mkdir /opt/likpi/cmdb-backend
$ sudo chown -R likpiadm:likpi /opt/likpi

Installing OpenJDK (Backend Node)¶

$ sudo apt update
$ sudo apt install default-jre
$ java -version

Note

If the default JRE is not at least OpenJdk 17 then Oracle’s OpenJDK binaries zip or tar achives for Linux are available on https://openjdk.org.

$ unzip openjdk-17*_bin.zip

Installing PostgreSQL database 15¶

$ sudo apt update
$ sudo apt full-upgrade
$ sudo apt install postgresql-15 postgresql-client-15
$ sudo systemctl status postgresql
$ sudo systemctl enable --now postgresql // (if service not started)

Configuring the PostgreSQL Server:

$ sudo su - postgres (as Linux admin)
$ psql

The corresponding SQL statement is:

CREATE DATABASE cmdb WITH ENCODING 'UTF-8';
CREATE USER cmdb_user WITH PASSWORD 'your_password';
GRANT ALL PRIVILEGES ON DATABASE "cmdb" to cmdb_user;
\c cmdb
\q

Note

Starting with version 15, PostgreSQL revokes default CREATE and USAGE privileges on the public schema from the PUBLIC role by default.

In such case you will need to add as postgres administrator user connected to cmdb to add these commands:

\c cmdb
GRANT USAGE ON SCHEMA public TO cmdb_user;
GRANT CREATE ON SCHEMA public TO cmdb_user;
\q

Enabling Remote Access if needed:

Find and edit the file postgresql.conf, and remove the comment marker on the line for the listen_addresses setting, so that it reads].

$ vi /etc/postgresql/15/main/postgresql.conf
#listen_addresses = 'localhost'
listen_addresses = '*'

Find and open the file pg_hba.conf:

$ vi /etc/postgresql/15/main/pg_hba.conf

To allow users to connect from remote systems on your network with any role, add this line:

# IPv4 local connections:
host    all             all             127.0.0.1/32         md5 // (Before)
host    all             all             0.0.0.0/0            md5 // (After)

To make your changes take effect, restart the server:

$ exit
$ sudo systemctl restart postgresql

NGINX Installation (Frontend Node)¶

$ sudo apt install nginx
$ systemctl status nginx

Likpi CMDB Application Deployment (with user likpiadm)¶

Move the Java Vert.x fat JAR to the application repository.

$ sudo mv cmdb-app-1.0.0-SNAPSHOT-fat.jar /opt/likpi/cmdb-backend
$ sudo chown likpiadm:likpi /opt/likpi/cmdb-backend/cmdb-app-1.0.0-SNAPSHOT-fat.jar

Extract the React frontend build to the Nginx web directory.

$ sudo unzip cmdb-frontend-build.zip -d /opt/likpi/cmdb-frontend/html/
$ sudo chown -R likpiadm:likpi /opt/likpi/cmdb-frontend/html/

Warning

Nginx configuration reminder: Since the frontend extraction path is /opt/likpi/cmdb-frontend/html/ and the ownership to likpiadm:likpi, ensure that your Nginx virtual host configuration (from our deployment_architecture.rst) points to this new root directory. Also, make sure that the Nginx worker process (usually www-data on Debian/Ubuntu) has read permissions for the /opt/likpi directory path so it can serve the files.

Installation tasks with likpiadm user¶

Create /opt/likpi/security folder and set likpiadm as owner¶

$ mkdir /opt/likpi/security
$ chown likpiadm:likpi /opt/likpi/security

For secure connection get your certificates from your Certificate Authority¶

Move your TLS CRT & TLS KEY files on /opt/likpi/security folder.

License file¶

Your license key for Enterprise version should be applied on the Likpi Portal by an administrator.

Note

You are now ready to start the CMDB backend service.