Instalacja Comarch BI Point Linux

Uwaga
Uwaga: Poniższa przykładowa instalacja przeprowadzana była na dystrybucji Ubuntu.

W celu rozpoczęcia instalacji należy uruchomić skrypt instalacyjny w folderze z obrazem instalatora za pomocą komendy:

 sh first-setup.sh

Jeżeli skrypt zostanie uruchomiony przez użytkownika bez uprawnień administratora (root) należy dopisać do komendy ‘sudo’ (uprawnienia do tej funkcji są niezbędne do przeprowadzenia instalacji):

sudo sh first-setup.sh

Instalacja składa się z kilku etapów, jeżeli poszczególne komponenty zostały już zainstalowane skrypt pominie ich instalacje (Docker, Docker – compose):

  1. Docker
  2. Docker – compose
  3. Instalacja skryptów pomocniczych
  4. Wygenerowanie pliku docker-compose.yml
  5. Instalacja obrazu BI Point

 

1. Wstęp i Akceptacja Licencji

Proces instalacji rozpoczyna się od weryfikacji warunków licencyjnych.

  • Wymagania: Przed kontynuacją należy zapoznać się z plikiem license_en.rtf
  • Zatwierdzenie: Kontynuacja instalacji wymaga wpisania frazy yes w celu akceptacji postanowień licencyjnych.

 

2. Sprawdzenie Środowiska (Docker)

Aplikacja BI Point bazuje na technologii kontenerów.

  • Weryfikacja: Skrypt instalacyjny automatycznie sprawdza obecność środowiska Docker.
  • Istniejąca instalacja: Jeśli Docker jest już zainstalowany, instalator pominie ten krok. W przypadku problemów z silnikiem Docker, należy odnieść się do oficjalnej dokumentacji dostawcy.
  • Potwierdzenie: Aby przejść do instalacji obrazów, należy nacisnąć klawisz Enter.

 

3. Konfiguracja Komponentów i Ścieżek

Podczas instalacji użytkownik jest proszony o zdefiniowanie parametrów systemowych:

  • Ścieżka do obrazów: Należy podać ścieżkę do plików obrazów (domyślnie jest to katalog bieżący ./”).

  • Centralne logowanie (Fluent-bit): Możliwe jest włączenie narzędzia Fluent-bit do zbierania i przesyłania logów do centralnej lokalizacji.

Uwaga
Producent nie dostarcza systemu składowania logów (np. Elasticsearch, Loki) – należy go zapewnić we własnym zakresie.

          Konfiguracja znajduje się w katalogu „conf/fluent-bit”.

  • Menadżder kluczy (Key Manager): Należy określić, czy instancja ma uruchomić własny Key Manager, czy użyć istniejącej instancji menadżera kluczy. W sieci wymagana jest tylko jedna instancja tego komponentu.

W przypadku braku instancji menadżera kluczy należy wpisać „y” aby utworzyć kontener menadżera kluczy.

 

4. Skrypty Pomocnicze i Porty

  • Instalator kopiuje kluczowe skrypty zarządzające do lokalizacji systemowych:

  • Konfiguracja portu: Użytkownik musi wskazać port, na którym BI Point będzie dostępny (domyślnie port 80).

 

5. Wybór Wersji Produktu

W kroku siódmym następuje wybór konkretnej edycji BI Point. 

  • BI Point Standalone (Domyślny)
  • XL BI Point Start
  • Optima BI Point
  • XL BI Point
  • Altum BI Point
  • CEE BI Point
  • CEE BI Point Smart
  • XL BI Point Premium

 

6. Rejestracja i Licencjonowanie

  • Serwer Licencji: Należy podać adres IP serwera Key Manager (zaleca się używanie adresu IP zamiast nazwy hosta, aby uniknąć problemów z DNS).

  • Klucz Licencyjny: Wymagane jest wprowadzenie 10-cyfrowego klucza licencyjnego.

  • Dostęp: Domyślny login administratora to admin. Hasło:podane w poniższym oknie/dostępne w docker-compose.yml

 

7. Uruchomienie Systemu

Po wprowadzeniu parametrów konfiguracyjnych aplikacji należy uruchomić komendę:

 sudo docker-compose up -d

Odpowiadającej za uruchomienie kontenerów i woluminów. Po uruchomieniu kontenerów rozpocznie się proces importu połączeń, modeli danych oraz raportów standardowych.

Ważne: Pierwsze uruchomienie kontenerów może potrwać powyżej 20 minut ze względu na import raportów standardowych.

 

8. (Opcjonalne) Konfiguracja menadżera kluczy

W sytuacji, gdy w infrastrukturze nie posiadamy jeszcze aktywnej instancji Menedżera Kluczy i podczas etapu konfiguracji (Krok 5 instalacji) wybraliśmy opcję instalacji nowego kontenera tego komponentu wraz z aplikacją BI Point, po zakończeniu procesu instalacyjnego niezbędne jest dodanie licencji.

Wskazówka
Przed wykonaniem komend należy uwzględnić nazwy konteneru menadżera kluczy:

  • Dodanie klucza licencji
 docker exec -i Nazwa_Kontenera_MK manager addkey clientid=<id klienta> pin=<pin> key=<klucz>
  • Usunięcie klucza licencji
docker exec -i Nazwa_Kontenera_MK  manager deleteinstallation key=12341241234
  • Zwolnienie licencji
docker exec -i Nazwa_Kontenera_MK  manager releaseuser user=”<user>”
Wskazówka
Status możemy zobaczyć w przeglądarce, wchodząc na http://<server>:5150/key/<nr klucza>

np. http://localhost:5150/key/12341241234

Czy ten artykuł był pomocny?