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.
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
- Utworzyć folder C:\temp.
- 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).
Ścieżka do SQL Server 2012 Tools
- 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
- Ścieżkę należy dostosować do instalacji serwera SQL 2012.
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.
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:
- Utworzyć folder C:\comarch\CEE630PA.
- 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:
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.
- Uruchomić wiersz poleceń i przejść do odpowiedniego katalogu za pomocą następującego polecenia:
cd /D C:\comarch\CEE630PA\install\scripts\windows.
- 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
- 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.
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
- Uruchomić wiersz poleceń.
- Wykonać następujące polecenie, aby przejść do katalogu roboczego SAS: cd /D C:\comarch\SYSTEMNAME\semiramis\servers\MESSAGESERVER
- 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
- 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.
- Uruchomić SQL Server Management Studio.
- 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.
- Usunąć loginy należące do baz danych systemu ERP (SYSTEMNAME).
- 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.
- Usunąć pliki, które zostały zapisane w katalogu C:\SYSTEMNAME.
System ERP został pomyślnie odinstalowany.