Instalacja: Comarch ERP Enterprise na Linux (PostgreSQL)

Artykuł opisuje instalację systemu Comarch ERP Enterprise na serwerze z systemem operacyjnym Redhat Enterprise Linux lub Ubuntu server oraz silnikiem bazy danych PostgreSQL.

Wymagania

Uwaga
Przegląd niezbędnych komponentów oraz obsługiwanych wersji systemu Linux i PostgreSQL znajduje się w artykule Wymagania systemowe.

Dodatkowo, wymagana jest poprawna instalacja Redhat Enterprise Linux lub Ubuntu server jako systemu operacyjnego. Sieć musi być skonfigurowana w taki sposób, aby możliwe było rozpoznanie nazwy komputera.

Przed instalacją należy zweryfikować:

  • czy użytkownik postgres (domyślny użytkownik silnika PostgreSQL) posiada możliwość logowania się do systemu poleceniem: su postgres
  • port na którym działa serwer SQL, w dalszej części instrukcji będzie on wykorzystywany
  • wolne miejsce na dysku twardym. Pliki instalacyjne oraz zainstalowany system potrzebują ogólnie 30 GB wolnej pamięci na dysku
  • posiadanie dostępu do użytkownika root lub użytkownika z grupy root
  • wymagania określone przez Redhat Enterprise Linux lub Ubuntu server i PostreSQL oraz posiadanie zainstalowanych niezbędnych aktualizacji oprogramowania
Uwaga
Do operacji na plikach można wykorzystywać wbudowane narzędzia systemu, doinstalowane narzędzia lub eksplorator plików np. WinSCP (dla połączeń ssh realizowanych z Windows).
Uwaga
Ze względu na specyfikę systemu operacyjnego może być wymagane zwiększenie uprawnień do niektórych plików i katalogów, m.in. uprawnienie do wykonania plików .sh.

Konwencje

Należy zapewnić jednolitą strukturę katalogów, szczególnie w przypadku, gdy kilka systemów jest utrzymywanych na jednym serwerze.

Uwaga
W tym artykule nazwa CEE630PA jest przykładową nazwą systemu. Musi być ona zastąpiona właściwą nazwą, zgodną z systemem, który jest instalowany.

 Instalacja JDK

Comarch ERP Enterprise jest oparty na języku programowania Java, w związku z czym  wymaga Java Development Kit (JDK) jako środowiska uruchomieniowego.

Opisana poniżej procedura instalacji JDK jest wymagana tylko w przypadku pierwszej instalacji lub zmiany wersji JDK.

Instrukcja instalacji Java JDK

Aktualna paczka JDK w wersji 11 dostępna jest do pobrania ze strony https://adoptopenjdk.net/. Po jej pobraniu należy wykonać następujące kroki:

  1. Umieścić pobraną paczkę na serwerze
  2. Utworzyć katalog mkdir /opt/comarch/java/
  3. Przejść do katalogu /opt/comarch/java i skopiować pobrany plik tar.gz do katalogu /opt/comarch/java
  4. Uruchomić tar –xzf OpenJDK11U-jdk_x64_linux_hotspot_11.0.10_9.tar.gz
  5. Zmienić nazwę katalogu JDK na mv jdk-11.0.10+9/ jdk-11.0.10+9-64/

Aby później zweryfikować instalację, można wprowadzić następujące polecenia w powłoce :

export JAVA_HOME=/opt/comarch/java/jdk-11.0.10+9-64

$JAVA_HOME/bin/java –version

Wskazówka
W sytuacji, gdy pojawi się błąd, należy ręcznie przepisać nazwę pliku w komendzie.

Wyświetlane są następujące informacje: openjdk version "11.0.10" 2021-01-19 OpenJDK Runtime Environment AdoptOpenJDK (build 11.0.10+9) OpenJDK 64-Bit Server VM AdoptOpenJDK (build 11.0.10+9, mixed mode)

Uwaga: Zmienna środowiskowa JAVA_HOME jest później ustawiana na ścieżkę zainstalowanego pakietu Java JDK za każdym razem, gdy wywoływany jest skrypt startowy strsas-MESSAGESERVER.sh Zapobiega to problemom z innymi już zainstalowanymi wersjami JDK.

Instalacja Comarch ERP Enterprise

Do instalacji niezbędne jest archiwum CEE630PA-Partnersystem.zip.

Poprzez wywołanie skryptu są one rozpakowywane, konfigurowane są niezbędne pliki bazy danych i użytkownicy, dane są importowane z plików eksportu i tworzone są statystyki dla danych. Aby zainstalować dostarczony system uruchom powłokę bash jako użytkownik root.

Tworzenie katalogów

Należy utworzyć następujące katalogi do instalacji:

mkdir –p /opt/comarch/CEE630PA

Następnie, trzeba rozpakować pobrane archiwum ZIP do katalogu:

unzip plik CEE630PA-Partnersystem.zip

Plik licencji

Plik licencji należy podać w rozpakowanym katalogu:

/opt/comarch/CEE630PA/install/licence

Skrypty instalacyjne crtsem.sh

W systemie operacyjnymi musi być zainstalowana obsługa języka de_DE.UTF-8.

Dla dystrybucji bazujących na Ubuntu:

  • sudo apt install language-pack-de

Dla dystrybucji bazujących na RHEL/CentOS:

  • yum install langpacks-de
  1. Po upewnieniu się, że język jest zainstalowany, należy przejść do katalogu ze skryptami

cd /opt/comarch/CEE630PA/install/scripts/linux

  1. Zmienić uprawnienia skryptu crtsem.sh

chmod 774 /opt/comarch/CEE630PA/install/scripts/linux/crtsem.sh

  1. Wywołać skrypt instalacyjny crtsem.sh z parametrem –help, aby wyświetlić

pomoc ./crtsem.sh –help

  1. Skrypt oczekuje następujących parametrów:

systemname : zgodnie z licencją (np. CEE630PA)

java : katalog domowy java /opt/comarch/jdk-11.0.10+9-64

licencefile : nazwa pliku licencji (np. 300-CEE630PA-01-CEE630PA.lic)

licencepassword : hasło licencyjne

database_type:PGSQL

filedestination_dir : katalog docelowy, w którym ma zostać skonfigurowany folder semiramis. Jeśli ten folder nie istnieje, skrypt tworzy ten i wszystkie nadrzędne foldery. (np. /opt/comarch/CEE630PA )

configuration_database : nazwa bazy danych konfiguracji zgodnie z licencją (np. CEE630PACF )

Uwaga
Baza danych konfiguracji musi kończyć się literami CF zgodnie z konwencją CEE.

Wykonywanie skryptu może potrwać dłuższa chwilę.

Przykładowe wywołanie wygląda następująco:

./crtsem.sh -systemname CEE630PA -java /opt/comarch/java/jdk11.0.10+9-64 -licencefile 300-CEE630PA-01-CEE630PA.lic -licencepassword <kennwort> -database_type PGSQL -filedestination_dir /opt/comarch/CEE630PA -configuration_database CEE630PACF

Plik semiramis.zip jest rozpakowywany w podanym katalogu  /opt/comarch/CEE630PA/semiramis . Następnie tworzone są pliki bazy danych PostgreSQL oraz użytkownicy bazy danych. W kolejnym kroku rozpoczyna się import dostarczonych baz danych Comarch ERP Enterprise. Na koniec tworzone są statystyki optymalizatora.

Pliki dziennika można przeglądać w katalogu /tmp/CEE630PA-log lub  ${TMPDIR}/CEE630PA-log. Dostarczają one informacji o pomyślnym procesie  importu.

Użytkownicy baz danych i hasła utworzone dla Comarch ERP Enterprise:

Nazwa użytkownika Hasło Baza danych
CEE630PACF dla bazy danych konfiguracji
CEE630PARP

 

dla bazy danych repozytorium
CEE630PA00 dla „podstawowej” bazy danych OLTP
CEE630PA02 dla bazy danych OLTP „Multi-Site”

W przypadku, gdy baza danych systemu CEE ma być na innym serwerze, należy ręcznie przenieść powyższe bazy na inny serwer oraz zaktualizować adres bazy konfiguracji w pliku:

/opt/comarch/CEE630PA/semiramis/classes/system.properties

Uruchomienie serwera aplikacji system Comarch ERP Enterprise

Aby uruchomić serwer aplikacji systemu ERP (SAS), należy wykonać następujące czynności:

  1. Uruchomić powłokę bash i przejdść do katalogu roboczego SAS:

cd /opt/comarch/CEE630PA/semiramis/servers/MESSAGESERVER

  1. Uruchomić następujący skrypt, aby uruchomić SAS:

./strsas-MESSAGESERVER.sh

SAS przechowuje pliki dziennika w katalogu /opt/comarch/CEE630PA/semiramis/servers/MESSAGESERVER/log.
Podczas uruchamiania SAS serwer nawiązuje już połączenia z lokalną bazą danych i odczytuje ustawienia konfiguracyjne z bazy danych konfiguracji.

Po uruchomieniu zostanie wyświetlony znak zachęty:

ADMINISTRATOR@MASSAGESERVER>

Można teraz wydawać polecenia w powłoce CEE toolshell.

Wygenerowanie informacji o bazie danych

Przed pierwszym logowaniem do systemu należy wygenerować informacje w bazie danych.

Aby to zrobić, należy uruchomić następujące polecenia na SAS:

crtdbinf -configuration -repository

crtdbinf -oltp -nlsAutomatic

restart

Logowanie do systemu ERP

Pierwsze logowanie do systemu odbywa się poprzez adres URL http://localhost

przy użyciu nazwy użytkownika ADMINISTRATOR i hasła 12345.

Utworzenie certyfikatów

Aby korzystać z bezpiecznego połączenia do logowania, należy utworzyć certyfikaty.

Dalsze kroki

Po instalacji konieczne jest wykonanie kilku dodatkowych czynności w celu dalszej konfiguracji systemu. Zainstalowany system jest licencjonowany tylko dla  ograniczonego zakresu funkcji. Aby korzystać z pełnej funkcjonalności Comarch  ERP Enterprise należy najpierw zainstalować licencję na nowy system i skonfigurować ten system.

Odinstalowanie Comarch ERP Enterprise

Aby odinstalować system Comarch ERP Enterprise należy wykonać następujące kroki:

  1. Zatrzymać wszystkie SAS uzyskujące dostęp do bazy danych za pośrednictwem użytkowników bazy danych, którzy mają zostać usunięci. Danych użytkownika nie można usunąć, gdy jest on jeszcze połączony z bazą danych.
  2. Usunąć wszystkie bazy danych utworzone podczas instalacji, np. B. użytkowników CEE630PACF, CEE630PARP, CEE630PA00, CEE630PA02
  3. Usunąć następujący katalog i jego zawartość:

/opt/comarch/CEE630PA/semiramis

System Comarch ERP Enterprise został odinstalowany.

Czy ten artykuł był pomocny?