Installation of Comarch BI Point on Linux

Note: The exemplary installation described below was carried out on Ubuntu distribution.

To begin BI Point installation, use the following command to run the setup script available in the folder with the setup wizard image:

 sh first-setup.sh

If the user running the script does not have administrator privileges (root), the command needs to be preceded with ‘sudo’ (permission to this function is necessary in order to carry out the installation):

sudo sh first-setup.sh

After the command is executed, the BI Point setup wizard will check whether all the necessary components are installed. The setup wizard requires a network tool – Curl. It is used to execute network queries and commands.

Note: In the case of other distributions, it is necessary to get a relevant command as part of package installation.

In order to install the curl tool, execute the following command (the exemplary command below is running on Debian and Ubuntu distributions):

sudo apt install curl

In order to install the curl tool, execute the following command (the exemplary command below is running on Debian and Ubuntu distributions):

  1. Docker
  2. Docker – compose
  3. Installation of supporting scripts
  4. Generation of a docker-compose.yml file
  5. Installation of BI Point image

The first step is the execution of the setup script for the Docker component:

The next step is the installation of a Docket-compose component:

Finally, the images are installed:

You will be asked to select the path to the package containing BI Point images on the server. You need to select the location of the file with .tar.gz extension (if you ran the setup script from the folder containing the BI Point image (a .tar.gz file), select the Enter key to confirm the suggested path).

Upon confirmation, the setup wizard will process the following:

  • Loading BI Point images

After the images are loaded, it will be possible to run the Key Manager and install BI Point application. Upon confirmation, the Key Manager application will be installed on Linux system.

Note: You only need one instance of the Key Manager per network. If you installed the Key Manager with a license for BI Point on another server (Windows or Linux), then you can skip this step (by typing n) and in the latter installation step you will be asked to provide appropriate parameters (server and key number).

If you added the Key Manager to the docker-compose.yml file while executing the script, then after running the Key Manager for the first time, you need to add your license key via the manager tool from the key manager image, e.g.:

Prior to executing the commands, make sure to include the container names of the Key Manager:

  • Adding a license key
docker exec -i KM_Container_Name manager addkey clientid=<client id> pin=<pin> key=<key>
  • Deleting the license key
docker exec -i KM_Container_Name manager deleteinstallation key=12341241234
  • Releasing the license
docker exec -i KM_Container_Name manager releaseuser user=”<user>”

We can check the Status in the browser by navigating to http://<server>:5150/key/<key number>.

For example: http://localhost:5150/key/123412412.

In the following step, the supporting scripts are installed:

After that, you will be asked to specify the configuration parameters of the application.

Setup parameters:

  • Port of BI Point application
  • BI Point version (ERP Standard BI, CEE BI,CEE BI Smart, Optima BI, XL BI, XL BI Start, BI Point Standalone)
  • Server of the license key manager (depending on the option selected in step [4])
  • License key number

After the configuration parameters are specified, execute the following command:

 sudo docker-compose up -d

The command is responsible for running containers and volumes. After the containers are run, the import of connections, data models and standard reports begins.

After the installation is completed, the BI Point website can be run via a web browser. The default user is admin (password – admin).

Verification of the import status

In order to verify the current import status of the standard content of BI Point application, you need to verify the name of the appropriate container by using the following command:

sudo docker ps

Next, execute the last fragment of the log of the selected container by using this command:

 sudo docker logs bipoint_bipoint1 –tail 10

The above message indicates that the import process has completed.

Czy ten artykuł był pomocny?