Instalacja: Comarch ERP Enterprise na Oracle Linux

Wprowadzenie

Niniejsza dokumentacja opisuje proces instalacji systemu Comarch ERP Enterprise na Oracle Linux, a także na systemie zarządzania bazą danych Oracle. Dla obu tych przypadków proces instalacji jest identyczny.

Grupa docelowa

• Administratorzy systemu
• Wsparcie techniczne
• Programiści, instalujący system Comarch ERP

Założenia

Wykaz wymaganych komponentów, jak również wspierane wersje Linuxa i Oracle można znaleźć w dokumentacji Wymagania systemowe.

Jako system operacyjny wymagana jest poprawna instalacja Oracle Linux. Sieć musi być skonfigurowana w taki sposób, aby możliwe było zarządzanie ustawieniami DNS.

Zalecanym systemem zarządzania bazą danych (DBMS) jest opisany w tej dokumentacji DBMS Oracle. Instrukcje dotyczące instalacji uwzględniające również ustawienia specyficzne dla systemu ERP znajdują się w pomocy jako Instalacja systemów zarządzania bazami danych.

Należy utworzyć użytkownika oracle, który ma możliwość zalogować się do bazy danych przy użyciu polecenia:

sqlplus sys/yourpassword@orcl as sysdba

Nazwa instancji lub SID ORCL dla identyfikacji instancji bazy danych jest zapisana w wyeksportowanej Konfiguracji i dlatego jest wymagana jako SID dla instalacji i obsługi systemu instalacyjnego.

Na pliki instalacyjne oraz zainstalowany system potrzebne jest około 30 GB wolnego miejsca na dysku.

Do instalacji należy użyć użytkownika root lub użytkownika z grupy root.

Zalecamy instalację w następującej kolejności.

1. Sprawdzić wymagania dla Oracle Linux i Oracle DBMS.
2. Jeśli to konieczne, podnieść swój system do stanu certyfikacji Oracle Linux, na przykład poprzez YUM.

Konwencje

Należy zachować domyślne struktury katalogów, aby zapewnić jednolitą strukturę podczas równoległej instalacji kilku systemów.

Wykorzystany folder instalacyjny /opt/comarch/CEE630PA  jest zgodny z używanymi konwencjami dla Unix (Filesystem Hierarchy Standard).

Użyta w niniejszej dokumentacji nazwa systemu, czyli CEE630PA, jest nazwą zastępczą, która powinna zostać zastąpiona właściwą nazwą zgodnie z otrzymaną licencją.

Stosowany w dokumentacji skrót SAS oznacza serwer aplikacji systemu ERP.

Instalacja AdoptOpenJDK

System Comarch ERP jest opracowany w języku programowania JavaTM i dlatego wymaga on Java Development Kit (JDK) jako środowiska uruchomieniowego, a także do dalszych prac. Dostarczone JDK od AdoptOpen ma w momencie pisania tej dokumentacji wersję jdk-11.0.10+9. Należy pobrać najnowszą wersję JDK ze strony https://adoptopenjdk.net/  jako tar.gz.

Opisana poniżej procedura instalacji Java JDK jest konieczna przy pierwszej instalacji lub w przypadku zmiany wersji dostarczonego JDK.

Instrukcja: Instalacja Java JDK

Podczas instalacji JDK należy potwierdzić postanowienia licencyjne Oracle: istnieje możliwość, że z biegiem czasu będą dostarczane nowsze wersje JDK wraz z systemem instalacyjnym. Należy dostosować dane do odpowiedniej wersji JDK.

Utworzyć katalog dla instalacji JDK.

mkdir /opt/comarch/java

Przejść do katalogu /opt/comarch/java. Skopiować pobrany plik tar do katalogu /opt/comarch/java , a następnie otworzyć

tar –xzf OpenJDK11U-jdk_x64_linux_hotspot_11.0.10_9.tar.gz .

Na końcu zmienić nazwę katalogu JDK na

mv jdk-11.0.10+9/ jdk-11.0.10+9-64/ .

Aby sprawdzić automatyczną instalację po jej zakończeniu, można wprowadzić następujące polecenia w wierszu poleceń.

• export JAVA_HOME=/opt/comarch/jdk-11.0.10+9-64
• $JAVA_HOME/bin/java –server –version

Zostaną wyświetlone 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)

Instalacja systemu ERP

Użytkownik otrzyma paczkę CEE630PA-Partnersystem.zip do pobrania na serwerze Comarch FTP. Poprzez wywołanie skryptu pliki zostanę rozpakowane, stworzone zostaną niezbędne pliki bazy Oracle wraz z użytkownikami, zaimportowane zostaną dane z plików eksportowych, a także zostaną zbudowane statystyki dla danych.

Aby zainstalować dostarczony system z poziomu powłoki, należy uruchomić powłokę bash jako użytkownik root.

Utworzenie katalogów

W celu instalacji należy utworzyć następujący katalog:

1. mkdir –p /opt/comarch/CEE630PA
2. Rozpakować w utworzonym folderze pobrany plik ZIP.

unzip CEE630PA-Partnersystem.zip

Przygotowanie pliku licencyjnego

Przygotować plik licencyjny w rozpakowanym katalogu /opt/co- march/CIS620PB/install/licence  

Przygotowanie Oracle JDBC Connector

Przygotować konektor JDBC dla Oracle ojdbc8.jar, ojdbc10.jar  lub nowy w katalogu /opt/comarch/CEE630PA/install/lib

Skrypt instalacyjny crtsem.sh

1. Przejść do katalogu skryptu.

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

2. Zmienić uprawnienia skryptu crtsem.sh

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

3. Wywołać skrypt instalacyjny crtsem.sh z parametrem –help, aby wyświetlić pomoc ./crtsem.sh –help.
4. Skrypt oczekuje następujących parametrów:
   • systemname :zgodnie z licencją (np. CEE630PA)
   • java :katalog Java Home /opt/comarch/java/jdk-11.0.10+9-64
   • licencefile :nazwa pliku licencyjnego (np. 300-CEE630PA-01-CEE630PA.lic)
   • licencepassword :hasło licencji
   • database_type :ORACLE
   • filedestination_dir : Folder docelowy, w którym ma być założony katalog semiramis. Jeżeli folder ten nie istnieje, skrypt utworzy go wraz z wszystkimi folderami nadrzędnymi(np. /opt/co- march/CEE630PA)
   • configuration_database : Nazwa konfiguracyjnej bazy danych zgodnie z licencją (np. CEE630PACF)

• database_dir : Ścieżka do katalogu bazy danych Oracle przeważnie oradata
• password :hasło użytkownika system DBMS Oracle.

Przykładowa komenda wygląda następująco:

./crtsem.sh -systemname CEE630PA -java /opt/comarch/java/jdk- 11.0.10+9-64 -licencefile 300-CEE630PA-01-CEE630PA.lic -licence- password <hasło> -database_type ORACLE -filedestination_dir

/opt/comarch/CEE630PA -configuration_database CEE630PACF –data- base_dir /opt/oracle/oradata/orcl –password <hasło>

Plik semiramis.zip zostanie rozpakowany w podanym folderze

/opt/comarch/CEE630PA/semiramis .

Następnie tworzone są pliki bazy danych Oracle oraz użytkownicy bazy. Następnie rozpoczyna się import dostarczonych baz danych systemu Comarch ERP Enterprise. Na koniec budowane są statystyki optymalizatora.

Pliki logów oraz skrypty SQL wygenerowane dla importu można przeglądać w katalogu

/tmp/CEE630PA-log bzw. ${TMPDIR}/CEE630PA-log . Informują one o zakończonym pomyślnie procesie importu. Użytkownikami bazy danych i hasłami utworzonymi dla Comarch ERP Enterprise są:

Uruchomienie serwera aplikacji systemu ERP

Aby uruchomić serwer aplikacji systemu ERP (SAS), należy:

1. Uruchomić wiersz poleceń jako użytkownik root. Przejść do katalogu roboczego SAS:

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

Wykonać poniższy skrypt, aby uruchomić SAS:

./strsas-MESSAGESERVER.sh

Logi SAS przechowywane są w katalogu /opt/co- march/CEE630PA/semiramis/servers/MESSAGESERVER/log ab.

Utworzenie informacji o bazie danych

Przed pierwszym zalogowaniem się do systemu należy wygenerować informacje o bazie danych.

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

crtdbinf –configuration –repository

crtdbinf –oltp –nlsAutomatic

restart

Logowanie do systemu ERP

Pierwsze logowanie do systemu odbywa się poprzez URL http://localhost przy pomocy nazwy użytkownika ADMINISTRATOR i hasła 12345.

Tworzenie certyfikatów

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

Dokładnie informacje można znaleźć w artykule Tworzenie certyfikatów.

Dalsze kroki

Po instalacji konieczne jest jeszcze kilka kroków, aby skonfigurować system. Zainstalowany system jest licencjonowany tylko w ograniczonym zakresie funkcji. Aby korzystać z pełnej funkcjonalności Comarch ERP Enterprise, należy najpierw zainstalować licencję na nowy system, a następnie skonfigurować ten system.

W dokumentacji Tworzenie nowego systemu opisano proces tworzenia systemu. Ponadto dalsze informacje dotyczące uruchomienia systemu można znaleźć w dokumentacji Przewodnik: Instalacja.

Serwer aplikacji systemu ERP jako usługa

Uruchomić serwer aplikacji systemu ERP (SAS) jako usługę Linux. Informacje dotyczące wskazówek krok po kroku można znaleźć w dokumentacji Instalacja: Comarch ERP Enterprise jako usługa na Windows i Linux

Deinstalacja systemu ERP

Dezinstalacja systemu instalacyjnego Comarch ERP Enterprise podzielona jest na kilka etapów. Aby odinstalować system, należy:

1. Zatrzymać wszystkie SAS, które uzyskują dostęp do bazy danych poprzez użytkowników bazy danych, którzy mają zostać usunięci. Dane użytkownika nie mogą być usunięte, gdy jest on nadal podłączony do bazy danych.
2. Usunąć wszystkich użytkowników bazy danych utworzonych w trakcie instalacji, wybierając w tym celu opcję kaskadowanie w Enterprise Manager, a więc np. użytkowników CEE630PACF, CEE630PARP, CEE630PA00, CEE630PA02.

3. Sprawdzić, np. przy użyciu konsoli Enterprise Manager, czy przestrzenie tabel, które mają zostać usunięte, nie zawierają żadnych danych.
4. Usunąć wszystkie przestrzenie tabel utworzone w trakcie instalacji, a także tym samym usunąć dane systemu operacyjnego w Enterprise Manager, a więc np. przestrzenie danych CEE630PACF, CEE630PARP, CEE630PA00, CEE630PA02.
5. Usunąć następujący katalog wraz z zawartością:

/opt/comarch/CEE630PA/semiramis

System Comarch ERP Enterprise zostanie pomyślnie odinstalowany.