Instalacja: Comarch ERP Enterprise na Microsoft SQL Server

Niniejsza dokumentacja opisuje instalację systemu ERP dla Windows i dla Microsoft SQL Server.

Grupa docelowa

  • Administratorzy systemu
  • Wsparcie techniczne
  • Programiści

Założenia

Wykaz wymaganych komponentów, jak również strukturę systemu można znaleźć w dokumentacji Wymagania systemowe.

Wskazówka
W trakcie instalacji należy przestrzegać podanej kolejności.

Jako system operacyjny wymagana jest poprawna instalacja Microsoft Windows Server 2012R2 lub nowszego. Sieć musi być skonfigurowana w taki sposób, aby możliwe było zarządzanie ustawieniami DNS. Należy zainstalować aktualnie dostępne service packs.

Jako system zarządzania bazą danych (DBMS) zalecany jest Microsoft SQL Server 2012 lub nowszy. Należy zainstalować aktualnie dostępne service packs dla serwera SQL.

Do instalacji systemu ERP tymczasowo potrzebne będzie 20 GB wolnej przestrzeni dyskowej.

Konwencje

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

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

Ustawienie zmiennych środowiskowych

Podczas pierwszej instalacji należy dostosować zmienne środowiska systemowego, aby umożliwić płynne działanie systemu.

Katalog tymczasowy

  1. Utworzyć folder C:\temp.
  2. Dla utworzonego folderu zmienić zmienne środowiskowe TMP i TEMP przynajmniej dla konta użytkownika uruchamiającego Serwer Aplikacji Systemu ERP (SAS) lub System Output Manager (SOM).
Wskazówka
Pozwala to uniknąć bardzo długich nazw katalogów, np. „C:\Dokumenty i ustawienia\Comarch-ERP-Enterprise\Ustawienia lokalne\Temp\“.

Ścieżka do SQL Server 2012 Tools

  1. Dodać do ścieżki zmiennej środowiskowej następującą ścieżkę prowadzącą do SQL Server 2012 Tools: C:\Program Files\Microsoft SQL Server\110\Tools\Binn
  2. Ścieżkę należy dostosować do instalacji serwera SQL 2012.
Wskazówka
Narzędzie sqlcmd można wywołać w wierszu poleceń.

 

Instalacja AdoptOpenJDK

System 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.

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

JDK

Należy pobrać aktualną wersję JDK x64 dla Windows ze strony https://adoptopenjdk.net/ .

Pobrany plik zainstalować w katalogu C:\comarch\java\jdk-11.0.10+9-64.

Wskazówka
Katalog sugerowany do przeprowadzenia instalacji różni się od ścieżki używanej w systemie ERP. W trakcie instalacji należy zmienić proponowany katalog na C:\comarch\java\jdk-11.0.10+9-64.

Podczas instalacji JDK nie należy instalować środowiska Java Runtime Environment. Aby to zrobić, należy zdezaktywować punkt Public JRE podczas wybierania komponentów do zainstalowania. Dla tego punktu należy wybrać opcję Don’t install this feature now.

Aktualizacja Public Java Runtime Environment

Oprócz plików Java Executables w katalogu instalacyjnym, które są konieczne do działania SAS, podczas instalacji do katalogu C:\Programme\Java\ kopiowane jest również publiczne środowisko Java Runtime Environment. Ta wersja jest wykorzystywana np. przez przeglądarki jako wtyczka. W przypadku Public Java Runtime Environment instalowany jest program, który w regularnych odstępach czasu sprawdza, czy na stronie głównej Oracle dostępne są nowe wersje lub poprawki zabezpieczeń Public Java Runtime Environment.

Aktualizacja Public Java Runtime Environment nie ma wpływu na system ERP, ponieważ w procesie tym nie jest zmieniana zawartość katalogu używanego przez SAS.

Aby uniknąć aktualizacji publicznego środowiska Java Runtime Environment:

  • Podczas instalacji JDK nie należy instalować środowiska Java Runtime Environment. Aby to zrobić, należy zdezaktywować punkt Public JRE podczas wybierania komponentów do zainstalowania. Dla tego punktu należy wybrać opcję Don’t install this feature now.
  • Jeśli publiczne środowisko Java Runtime Environment jest już zainstalowane, należy wyłączyć regularne sprawdzanie nowych aktualizacji poprzez ustawienia programu aktualizacji Java.

Instalacja systemu ERP

Utworzenie katalogów

Na rozpakowane pliki instalacyjne CEE potrzebne jest około 20 GB wolnego miejsca na dysku.

Użytkownik otrzyma paczkę instalacyjną za pomocą platformy Comarch iBard. Zawiera ona plik .zip z kodem programu, a także inne katalogi ze skryptami instalacyjnymi, eksportami baz danych i dokumentacją. Plik zip zawiera dużą ilość plików, które mogą zostać nieprawidłowo rozpakowane np. za pomocą programu WinZip lub programu do pakowania plików dostarczanego z nowszymi wersjami systemu Windows. Plik jest automatycznie rozpakowywany w dalszym toku instalacji za pomocą programu Jar.

Instrukcja:

  1. Utworzyć folder C:\comarch\CEE630PA.
  2. Rozpakować w utworzonym folderze pobrany plik ZIP.

Przekazana zawartość bazy danych i ich użytkownicy są przywracani przez wywołanie skryptu. Aby przeprowadzić instalację potrzebne jest 20 GB wolnej przestrzeni dyskowej.

Przygotowanie pliku licencyjnego

Przygotować plik licencyjny w rozpakowanym katalogu C:\comarch\CEE630PA\install\licence

Utworzenie skryptu instalacyjnego

W wierszu poleceń wywołać następujące polecenie: C:\comarch\CEE630PA\install\scripts\windows\crtsem.cmd

Skrypt oczekuje następujących parametrów:

  • Katalog Java Home (C:\comarch\java\11.0.10+9-64)
  • Nazwa systemu zgodnie z licencją (SYSTEMNAME)
  • Nazwa pliku licencyjnego. Plik licencyjny musi zostać zakupiony w standardowy sposób poprzez kontakt z konsultantem i musi zostać skopiowany do podkatalogu licence.
  • Hasło pliku licencyjnego
  • Typ bazy danych (MSSQL)
  • Folder docelowy, w którym ma być założony katalog CEE. Jeśli katalog ten nie istnieje, skrypt automatycznie utworzy taki katalog wraz z wszystkimi katalogami nadrzędnymi.
  • Katalog docelowy, w którym mają być później utworzone fizyczne pliki bazy danych

Instrukcja:

Wskazówka
Ścieżki zawierające spacje należy wpisywać w cudzysłowie, np. ” „d:\datafiles go here“.

Katalog nie może znajdować się na żadnym dysku sieciowym.

Dla źródła (source) i przeznaczenia (destination) należy użyć nazw katalogów bez spacji. Podany katalog docelowy do przechowywania plików bazy danych musi istnieć jeszcze przed wykonaniem skryptu.

  1. Uruchomić wiersz poleceń i przejść do odpowiedniego katalogu za pomocą następującego polecenia:

cd /D C:\comarch\CEE630PA\install\scripts\windows.

  1. W katalogu wykonać polecenie crtsem, wykorzystując wymagane parametry:

crtsem C:\comarch\java\jdk-11.0.10+9-64 SYSTEMNAME NAZWA_LICENCJI HASŁO_LICENCJI MSSQL C:\comarch\SYSTEMNAME c:\sql_server_data

Przykład
crtsem C:\comarch\java\jdk-11.0.10+9-64 CEE630PA 300-CEE630PA-01-CEE630PA.lic [HASŁO_LICENCJI] MSSQL C:\comarch\CEE630PA c:\sql_server_data
  • Katalog CEE jest rozpakowany z pliku zip.
  • Generowany jest skrypt instalacyjny, który zawiera niezbędne informacje do tworzenia baz danych i użytkowników.
  • Skrypt zostanie wykonany. Bazy danych i użytkownicy baz danych zostaną ustawione automatycznie.
  • Pliki logów oraz skrypty SQL wygenerowane dla importu można przeglądać w katalogach %TEMP%\SYSTEMNAME-log“ und „%TEMP%\SYSTEMNAME-tmp.

Skrypt utworzy następujących użytkowników i hasła:

 

Nazwa użytkownika/hasło Baza danych
SYSTEMNAMECF Baza konfiguracyjna
SYSTEMNAMERP Repozytorium bazy danych Podstawowa
SYSTEMNAME00 Baza danych OLTP Podstawowa
SYSTEMNAME02 Baza danych OLTP Wielofirmowość

Każdy z użytkowników jest tworzony jako database_owner (dbo). Dodatkowi użytkownicy, którzy chcą pracować z serwerem SQL, mogą być tworzeni poprzez SQL Server Management Studio.

Wskazówka
W przypadku wystąpienia błędu (np. z powodu niewystarczającej ilości pamięci), skrypt można wykonać ponownie. Wszelkie ewentualnie utworzone bazy danych i użytkownicy zostaną usunięte i utworzone na nowo. Nie wolno jednak edytować żadnej z baz danych za pomocą SQL Server Management Studio, w przeciwnym razie nie będzie można zmienić tego obiektu.

Jeśli katalog źródłowy (source) znajduje się na dysku sieciowym, polecenie sqlcmd nie będzie mogło uzyskać dostępu do tego dysku w celu odzyskania danych.

Uruchomienie serwera aplikacji systemu ERP

  1. Uruchomić wiersz poleceń.
  2. Wykonać następujące polecenie, aby przejść do katalogu roboczego SAS: cd /D C:\comarch\SYSTEMNAME\semiramis\servers\MESSAGESERVER
  3. Wykonać poniższy skrypt, aby uruchomić SAS: strsas-messageserver.cmd
  • SAS przechowuje logi w następującym katalogu: C:\comarch\SYSTEMNAME\semiramis\servers\MESSAGESERVER\log

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

Logowanie do systemu ERP

Pierwsze logowanie do systemu odbywa się poprzez URL http://localhost   przy pomocy nazwy użytkownika ADMINISTRATOR i hasła, które jest generowane przez skrypt crtsem.cmd i wyprowadzane na konsolę.

 Zakładanie nowego systemu

Dostarczone skrypty instalacyjne zainstalowały już podaną licencję w bazie konfiguracyjnej i utworzyły odpowiedni system.

Po udanym zalogowaniu, dalsza konfiguracja systemu może być przeprowadzona poprzez aplikację Panel System.

Dalsze informacje dotyczące uruchomienia systemu można znaleźć w artykule: Przewodnik instalacji.

  • Serwer aplikacji systemu ERP jako usługa Windows

Uruchomić serwer aplikacji systemu ERP (SAS) jako usługę Windows.

Tworzenie certyfikatów

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

Dezinstalacja systemu ERP

  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. Uruchomić SQL Server Management Studio.
  3. Usunąć wszystkie bazy danych systemu, który mają zostać usunięte. Następnie można usunąć pliki danych i pliki logów z systemu plików.
  4. Usunąć loginy należące do baz danych systemu ERP (SYSTEMNAME).
  5. Jeżeli zostały utworzone usługi (patrz rozdział 10), należy je odinstalować za pomocą odpowiedniego skryptu bat“, im Pfad „C:\comarch\SYSTEMNAME\semiramis\servers\MESSAGESERVER\service.
  6. Usunąć pliki, które zostały zapisane w katalogu C:\SYSTEMNAME.

System ERP został pomyślnie odinstalowany.

Czy ten artykuł był pomocny?