Niniejszy artykuł opisuje instalację systemu Comarch ERP Enterprise na Novell SuSE Linux Enterprise Server i Red Hat Enterprise Linux oraz systemu zarządzania bazą danych Oracle. Procedura instalacji jest taka sama dla obu wydań.
Grupa docelowa
- Administratorzy systemu
- Konsultanci techniczni
- Programiści instalujący Comarch ERP
Wymagania
Przegląd wymaganych komponentów oraz obsługiwanych wersji systemu Linux i Oracle znajduje się w dokumentacji Wymagania systemowe.
Jako system operacyjny wymagana jest poprawnie zainstalowana dystrybucja Oracle Linux. Sieć musi być skonfigurowana w taki sposób, aby możliwe było rozwiązywanie nazw hostów.
Jako system zarządzania bazą danych (DBMS) dla procedury opisanej w niniejszej dokumentacji wymagany jest system Oracle DBMS. Instrukcja instalacji, uwzględniająca również ustawienia dla Comarch ERP Enterprise, znajduje się w pomocy do tematu „Instalacja systemów zarządzania bazą danych”.
Należy utworzyć użytkownika oracle oraz zapewnić możliwość logowania do bazy danych za pomocą następującego polecenia:
Nazwa instancji lub SID ORCL służąca do identyfikacji instancji bazy danych jest zapisana w wyeksportowanej konfiguracji (Configuration) i dlatego jest wymagana jako SID do instalacji oraz działania systemu instalacyjnego.
Tymczasowo wymagane jest 30 GB wolnego miejsca na dysku na potrzeby plików instalacyjnych oraz zainstalowanego systemu.
Instalację należy przeprowadzić przy użyciu użytkownika root lub użytkownika należącego do grupy root.
Zaleca się przeprowadzenie instalacji w następującej kolejności:
- Należy zweryfikować wymagania dotyczące Oracle Linux oraz Oracle DBMS.
- W razie potrzeby należy zaktualizować system do wersji certyfikowanej przez Oracle Linux, np. przy użyciu narzędzia YUM.
Konwencje
Należy zachować zalecane struktury katalogów, aby zapewnić spójną strukturę w przypadku równoległej instalacji wielu systemów.
Używany katalog instalacyjny /opt/comarch/CEE630PA jest zgodny z konwencjami standardu „Filesystem Hierarchy Standard” stosowanego w systemach Unix.
Nazwa CEE630PA używana w dokumentacji stanowi symbol zastępczy i należy ją zastąpić właściwą nazwą zgodną z otrzymaną licencją.
W dalszej części dokumentacji skrót „SAS” oznacza serwer aplikacji systemu ERP (System Application Server).
Instalacja AdoptOpenJDK
Comarch ERP Enterprise został opracowany w języku programowania Java™ i dlatego wymaga środowiska uruchomieniowego oraz zestawu Java Development Kit (JDK) do dalszego rozwoju. W momencie tworzenia niniejszej dokumentacji dostarczany JDK od AdoptOpen ma wersję jdk-11.0.10+9. Należy pobrać aktualną wersję JDK w formacie tar.gz ze strony https://adoptopenjdk.net/.
Opisana poniżej procedura instalacji Java JDK jest wymagana wyłącznie przy pierwszej instalacji lub w przypadku zmiany wersji dostarczanego JDK.
Procedura: instalacja Java JDK
Podczas instalacji JDK należy zaakceptować warunki licencyjne Oracle. Z czasem mogą być dostarczane nowsze wersje JDK wraz z systemem instalacyjnym, dlatego należy dostosować poniższe instrukcje do dostarczonej wersji JDK.
Należy utworzyć katalog dla instalacji JDK:
- mkdir /opt/comarch/java
- tar -xzf OpenJDK11U-jdk_x64_linux_hotspot_11.0.10_9.tar.gz
- mv jdk-11.0.10+9/ jdk-11.0.10+9-64/
- export JAVA_HOME=/opt/comarch/jdk-11.0.10+9-64
- $JAVA_HOME/bin/java -server -version
openjdk version „11.0.10” 2021-01-19
- OpenJDK Runtime Environment AdoptOpenJDK (build 0.10+9)
- OpenJDK 64-Bit Server VM AdoptOpenJDK (build 11.0.10+9, mixed mode)
Instalacja systemu ERP
Pakiet instalacyjny jest udostępniany jest po kontakcie z zespołem Asysty Technicznej. Po uruchomieniu odpowiedniego skryptu archiwum zostaje rozpakowane, tworzone są wymagane pliki i użytkownicy Oracle Database, importowane są dane z plików eksportu oraz budowane są statystyki dla bazy danych.
W celu instalacji dostarczonego systemu z poziomu powłoki należy uruchomić powłokę bash jako użytkownik root.
Tworzenie katalogów
Na potrzeby instalacji należy utworzyć następujący katalog:
Udostępnienie pliku licencyjnego
Plik licencyjny należy umieścić w katalogu:
/opt/comarch/CEE630PA/install/licence
Udostępnienie Oracle JDBC Connector
Plik JDBC Connector dla Oracle (ojdbc8.jar, ojdbc10.jar lub nowszy) należy umieścić w katalogu:
/opt/comarch/CEE630PA/install/lib
Skrypt instalacyjny „crtsem.sh”
Należy przejść do katalogu ze skryptem:
Aby wyświetlić pomoc, należy uruchomić skrypt z parametrem –help:
Skrypt przyjmuje następujące parametry:
- -systemname – zgodnie z licencją (np. CEE630PA)
- -java – katalog Java Home (np. /opt/comarch/java/jdk-11.0.10+9-64)
- -licencefile – nazwa pliku licencyjnego (np. 300-CEE630PA-01-CEE630PA.lic)
- -licencepassword – hasło licencyjne
- -database_type – ORACLE
- -filedestination_dir – katalog docelowy, w którym zostanie utworzony folder semiramis; jeśli nie istnieje, zostanie utworzony wraz z katalogami nadrzędnymi (np. /opt/comarch/CEE630PA)
- -configuration_database – nazwa bazy konfiguracyjnej zgodnie z licencją (np. CEE630PACF)
- -database_dir – ścieżka do katalogu bazy Oracle (zazwyczaj oradata)
- -password – hasło użytkownika „system” bazy Oracle
/opt/comarch/CEE630PA/semiramis
Następnie tworzone są pliki bazy danych Oracle oraz użytkownicy bazy danych. Kolejno rozpoczyna się import dostarczonych baz danych Comarch ERP Enterprise. Na końcu wykonywana jest budowa statystyk optymalizatora.
Pliki logów oraz skrypty SQL utworzone podczas importu są dostępne w katalogu:
/tmp/CEE630PA-log lub ${TMPDIR}/CEE630PA-log
i umożliwiają weryfikację poprawności procesu importu.
Użytkownicy bazy danych / hasła
| Nazwa użytkownika | Przeznaczenie bazy danych |
|---|---|
| CEE630PACF | dla bazy konfiguracyjnej |
| CEE630PARP | dla bazy repozytorium |
| CEE630PA00 | dla bazy OLTP Podstawowe |
| CEE630PA02 | dla bazy OLTP Wielofirmowość |
Uruchomienie serwera aplikacyjnego ERP (SAS)
W celu uruchomienia serwera aplikacji ERP (SAS) należy wykonać następujące kroki:
Należy uruchomić powłokę bash jako użytkownik root, a następnie przejść do katalogu roboczego SAS:
Następnie należy uruchomić poniższy skrypt:
Pliki logów SAS są zapisywane w katalogu:
/opt/comarch/CEE630PA/semiramis/servers/MESSAGESERVER/log
Generowanie informacji o bazie danych
Przed pierwszym logowaniem do systemu należy wygenerować informacje o bazie danych.
W tym celu należy wykonać na uruchomionym SAS następujące polecenia:
Logowanie do systemu ERP
Pierwsze logowanie do systemu odbywa się poprzez adres URL http://localhost z użyciem nazwy użytkownika ADMINISTRATOR oraz hasła 12345.
Tworzenie certyfikatów
W celu korzystania z bezpiecznego połączenia podczas logowania należy utworzyć certyfikaty.
Szczegółowe informacje znajdują się w artykule Generowanie certyfikatów.
Dalsze kroki
Po zakończeniu instalacji wymagane są dodatkowe kroki w celu dalszej konfiguracji systemu. Zainstalowany system posiada jedynie ograniczony zakres funkcjonalny wynikający z licencji. Aby korzystać z pełnej funkcjonalności Comarch ERP Enterprise, należy najpierw zainstalować licencję dla nowego systemu oraz przeprowadzić jego konfigurację.
Procedura tworzenia nowego systemu została opisana w artykule Tworzenie nowego systemu.
Serwer aplikacji ERP jako usługa
Serwer aplikacji ERP (SAS) należy uruchomić jako usługę w systemie Linux.
Informacje dotyczące sposobu konfiguracji znajdują się w artykule Instalacja: Comarch ERP Enterprise jako usługa w systemie Linux lub Windows.
Deinstalacja systemu ERP
Deinstalacja systemu instalacyjnego Comarch ERP Enterprise składa się z kilku kroków. Należy postępować zgodnie z poniższą procedurą:
- Należy zatrzymać wszystkie serwery SAS, które uzyskują dostęp do bazy danych za pomocą użytkowników przeznaczonych do usunięcia. Dane użytkownika nie mogą zostać usunięte, dopóki jest on połączony z bazą danych.
- Należy usunąć wszystkich użytkowników bazy danych utworzonych podczas instalacji, korzystając z opcji kaskadowo w Enterprise Managerze, np. użytkowników:
CEE630PACF, CEE630PARP, CEE630PA00, CEE630PA02
Można to zweryfikować np. w konsoli Enterprise Manager.
- Należy usunąć wszystkie tablespace’y utworzone podczas instalacji, wybierając opcję usunięcia również plików systemowych, np.:
CEE630PACF, CEE630PARP, CEE630PA00, CEE630PA02 - Należy usunąć poniższy katalog wraz z całą jego zawartością: /opt/comarch/CEE630PA/semiramis
