Instalacja: Comarch ERP Enterprise na IBM System i i5 DB2 Universal Database

Wprowadzenie

Niniejszy artykuł opisuje instalację systemu Comarch ERP Enterprise na IBM i5/OS z DB2 Universal Database for iSeries.

Definicje

System instalacyjny obejmuje wszystkie komponenty wymagane do samodzielnej instalacji systemu Comarch ERP Enterprise.

QShell oznacza interfejs obsługowy, w którym wprowadzane są do systemu polecenia w formacie ASCII. Umożliwia to kopiowanie plików, tworzenie katalogów itp. Może być uruchamiana pod OS/400 lub i5/OS za pomocą polecenia qsh.

Certyfikat serwera służy do identyfikacji systemu ERP względem klienta, a także względem użytkownika.
Weryfikowane jest szyfrowane połączenie pomiędzy serwerem a klientem.
Klient otrzymuje gwarancję, że komunikacja odbywa się z właściwym, docelowym serwerem.

Symboliczny link umożliwia administratorowi dostęp do plików znajdujących się na różnych systemach.
Zapobiega to redundancjom w przechowywaniu danych.
Zasada ta jest porównywalna z zasadą hiperłączy w Internecie.

Grupa docelowa

• Administratorzy systemu
• Konsultanci techniczni
• Programiści instalujący system Comarch ERP Enterprise

Wymagania wstępne

Przegląd wymaganych komponentów można znaleźć w dokumentacji Wymagania systemowe. Zalecanym jest przeprowadzenie instalacji zgodnie z kolejnością opisaną w rozdziale Procedura.

Wymagane są również następujące elementy:

• sieć musi być skonfigurowana w sposób umożliwiający rozpoznanie nazwy komputera.
• wymagany jest system zarządzania bazą danych (DBMS) DB2 Universal Database for i5.
• aby używać kodowania ASCII, ustaw następujące parametry systemowe z QShell:
  • ADDENVVAR ENVVAR(QIBM_CCSID) VALUE(1252) LEVEL(*SYS) REPLACE(*YES)

System plików

Specyfikacja Java i JDK obejmuje weryfikację kodu bajtowego Java przed wykonaniem przez wirtualną maszynę Java (JVM). Weryfikacja zapewnia, że wykonywane są tylko strukturalnie poprawne i bezpieczne pod względem typu programy Java. Służy to bezpieczeństwu i stabilności Javy oraz systemu operacyjnego.

W systemie i5/OS wynikiem weryfikacji pliku .class jest Java. Zawiera on zweryfikowany kod bajtowy Java w edytowanej formie. Jeśli plik .class lub zawierający go plik archiwum .jar lub .zip jest zapisany w Integrated File System (IFS) systemu i5/OS, program Java jest przypisywany bezpośrednio jako dodatek do pliku .class lub archiwum. Powoduje to następujące skutki:

1. Pierwsze uruchomienie aplikacji Java, np. serwera aplikacji systemu ERP, może być czasochłonne ponieważ jednorazowo muszą zostać wygenerowane programy Java. Dotyczy to również sytuacji, gdy na przykład pliki .class lub pliki archiwum zostały nadpisane nową zawartością po zainstalowaniu aktualizacji oprogramowania.
2. Kolejne uruchomienia aplikacji Java nie są czasochłonne.
3. Jeśli pliki .class lub archiwa nie są przechowywane w IFS, ale są otwierane za pośrednictwem udostępnień, takich jak \QNTC\, program Java wygenerowany podczas weryfikacji nie może zostać zapisany jako dodatek do oryginalnego pliku. W rezultacie dla każdej klasy podczas uruchamiania tworzony jest plik tymczasowy, który jest ponownie usuwany po zamknięciu maszyny JVM. Czas wymagany do tej operacji jest czasochłonny, a liczba operacji na plikach jest bardzo duża.

Konwencje

Należy przyjąć określone struktury katalogów, aby zapewnić znormalizowaną strukturę podczas równoległej instalacji różnych systemów.

Procedura

Procedura instalacji

1. Zalogować się jako użytkownik QSECOFR lub jako użytkownik z takimi samymi uprawnieniami.
2. Utworzyć tymczasowy katalog instalacyjny za pomocą polecenia MD DIR(’/tmp/comarch’).
3. Skopiować dostarczone pliki z komputera z systemem Windows z nośnika instalacyjnego do tymczasowego katalogu instalacyjnego utworzonego na i5.
4. Skopiować katalog SEMIRAMIS i wszystkie podkatalogi z pierwszego nośnika do katalogu /tmp/comarch.
5. Skopiować zawartość katalogu SEMIRAMIS\install\database z drugiego nośnika do katalogu /tmp/comarch/SEMIRAMIS/install/database.

Po skopiowaniu z nośnika instalacyjnego pliki są zabezpieczone przed zapisem, dlatego dostarczone skrypty instalacyjne nie są bezpośrednio wykonywalne. Usunięcie ochrony przed zapisem można wykonać za pomocą:

6. CHGATR OBJ(’/tmp/comarch’) ATR(*READONLY) VALUE(*NO) SUBTREE(*ALL)
7. Uruchomić QShell za pomocą polecenia qsh
8. Użyć następującego polecenia, aby przejść do katalogu zawierającego skrypty instalacyjne:

cd /tmp/comarch/SEMIRAMIS/install/scripts/iSeries

9. Rozpocząć instalację następującym poleceniem:

./install.sh /tmp/comarch/SEMIRAMIS

Instalacja jest rejestrowana w pliku dziennika /tmp/semiramis-install.log. Katalog bazowy dla instalacji to:

/QOpenSys/usr/cisag/V4R4M0/CIS450PxD4

Po instalacji dostępna jest biblioteka o nazwie SEM450, która zawiera wszystkie obiekty i polecenia wymagane do zarządzania Comarch ERP Enterprise.

Podczas instalacji tworzony jest profil użytkownika iSeries z następującym identyfikatorem użytkownika: CISAG. W celu poprawnego ustawienia czasu dla Europy Środkowej i korzystania z systemu ERP, podczas tworzenia profilu użytkownika CISAG parametr LOCALE ustawiany jest w następujący sposób:

/qsys.lib/SEM450.lib/locale_en.locale

Można następnie ustawić parametr LOCALE profilu użytkownika, wprowadzając następujące polecenie:

CHGUSRPRF USRPRF(CISAG) LOCALE (’/qsys.lib/SEM450.lib/locale_en.locale’)

Katalog localhost zawiera skrypty wymagane do uruchomienia serwera aplikacji systemu ERP.

Zainstalowane bazy danych

Instalacja tworzy użytkownika CISAG, jeśli jeszcze nie istnieje. Użytkownik ten jest właścicielem wszystkich utworzonych bibliotek i obiektów.

Utworzone kolekcje to:

• CIS450PxCF dla bazy konfiguracyjnej
• CIS450PxRP dla bazy danych repozytorium
• CIS450Px00 dla bazy danych OLTP Podstawowe
• CIS450Px01 dla demonstracyjnej bazy danych OLTP Single-Site IHB
• CIS450Px02 dla demonstracyjnej bazy danych OLTP Multi-Site
• CIS450PxD1 dla bazy danych OLAP CIS450Px01
• CIS450PxD2 dla bazy danych OLAP CIS450Px02

Konfigurowanie użytkowników bazy danych

Użytkownik używany do łączenia się z bazą danych musi mieć możliwość ALL OBJECTS lub poniższe polecenie musi zostać wykonane co najmniej raz przez użytkownika z odpowiednimi uprawnieniami:

ADDRPYLE SEQNBR(4492) MSGID(CPA32B2) RPY(I)

Jeśli to polecenie nie zostanie wykonane, podczas próby usunięcia kolumn w tabeli może pojawić się komunikat błędu: SQL0952 cause code 10.

Podczas instalacji tworzony jest profil użytkownika CISAG, którego należy dostosować.

Wszyscy użytkownicy, którzy tworzą kolekcje lub inne obiekty, muszą odziedziczyć prawa właściciela do grupy CISAG. W przeciwnym razie partnerzy i klienci mogą nie być w stanie przywrócić dostarczonych obiektów z plików kopii zapasowych. Zmiana praw właściciela jest możliwa za pomocą polecenia:

CHGUSRPRF USRPRF(’username’) GRPPRF(CISAG) OWNER(*GRPPRF)

Uruchamianie serwera aplikacji systemu ERP

Po instalacji, skrypt startowy strsas-localhost.sh, który można wywołać z QShell, znajduje się w katalogu /QOpenSys/usr/cisag/V4R4M0/CIS440PxD4/semiramis/servers/LOCALHOST.

Aby uruchomić Toolshell, serwer aplikacji systemu ERP (SAS) o nazwie LOCALHOST musi zostać uruchomiony przez skrypt w QShell.

1. Zalogować się jako użytkownik CISAG z hasłem cisag.
2. Uruchomić QShell za pomocą polecenia qsh
3. Przełączyć się do QShell za pomocą polecenia:

cd /QOpensys/usr/cisag/V4R5M0/ CIS450PxD4/semiramis/servers/LOCALHOST

do katalogu roboczego serwera aplikacji

4. UruchomićSAS z następującym wywołaniem:

./strsas-localhost.sh

Po uruchomieniu SAS serwer nawiązuje już połączenie z lokalną bazą danych i odczytuje ustawienia konfiguracyjne z bazy konfiguracyjnej.

Po uruchomieniu wyświetlane jest gotowe do wprowadzenia polecenie: ADMINISTRATOR@LOCALHOST>. Po wykonaniu operacji możliwe jest wywoływanie poleceń w Toolshell.

5. Aby uzyskać dostęp do uruchomionego serwera aplikacji za pośrednictwem przeglądarki internetowej poprzez wprowadzenie adresu URL, wymagany jest certyfikat serwera wydany dla żądanego adresu URL.

Zmiana bazowego adresu URL serwera aplikacji jest możliwa za pomocą polecenia Toolshell:

chgsas -sas:LOCALHOST -baseURL:https://comarch.yourcompany.com

Potwierdzenie wydanego ostrzeżenia musi zostać wykonane poprzez wprowadzenie y.
Linia stanu: SYS-3046 Application-Server LOCALHOST systemu CIS450PxD4 jest zmieniany.
Warnings have occurred:
Ostrzeżenie: SYS-3511 Nazwa hosta z bazowego adresu URL nie zgadza się z wartością Ausgestellt für z certyfikatu. Certyfikat serwera aplikacyjnego systemu ERP musi zostać wygenerowany ponownie, aby klienci mogli rozpoznać ten serwer i zalogować się do niego. Bez nowego certyfikatu klienci nie będą w stanie zweryfikować tożsamości serwera i odmówią logowania.
Confirm these warnings: y=yes , n=no , a=all

Wiersz stanu: SYS-3046 Serwer aplikacji „LOCALHOST” systemu „CIS450PxD4” został zmieniony.

Warnings have occurred:

Ostrzeżenie: SYS-3511 Nazwa hosta z bazowego adresu URL nie zgadza się z wartością Wystawiony dla z certyfikatu. Certyfikat serwera aplikacyjnego systemu ERP musi zostać wygenerowany ponownie, aby klienci mogli rozpoznać ten serwer i zalogować się do niego. Bez nowego certyfikatu klienci nie będą w stanie zweryfikować tożsamości serwera i odmówią logowania.

Confirm these warnings:

• y=yes
• n=no
• a=all

6. Utworzyć certyfikat serwera dla SAS dla podstawowego adresu URL, który został zdefiniowany za pomocą polecenia:

crtsascert -sas:LOCALHOST -issuer:COMARCHDEMO

7. Ustawić katalog serwera plików SAS za pomocą następującego polecenia:

chgsas -sas:LOCALHOST -fileServerDirectory: /QOpenSys/usr/cisag/V4R5M0/CIS450PxD4/semiramis

8. Wprowadzić polecenie restart Toolshell, aby ponownie uruchomić serwer aplikacji systemu ERP. Serwer WWW zawarty w serwerze aplikacji będzie teraz akceptował połączenia z adresem URL https://comarch.yourcompany.com na podstawie nowo wydanego certyfikatu serwera.

SAS przechowuje pliki dziennika w następującym katalogu:

/QOpenSys/usr/cisag/V4R5M0/CIS450PxD4/servers/LOCALHOST/log

Logowanie do systemu ERP

Przed pierwszym zalogowaniem się do systemu ERP użytkownik musi najpierw zainstalować certyfikat w przeglądarce. Należy również uwzględnić wymaganą wersję przeglądarki internetowej opisaną w artykule Wymagania systemowe.

• Ustawienia Chrome
• Ustawienia Firefox
• Ustawienia Safari

Jeśli te ustawienia mają zostać wykonane, należy uruchomić plik podwójnym kliknięciem (komputer z systemem Windows musi mieć dostęp do IFS systemu I5, poniżej ścieżka w IFS):

/tmp/comarch/SEMIRAMIS/install/certificates/ADMINISTRATOR.pfx

Certyfikat zostanie następnie zainstalowany w lokalnym magazynie certyfikatów przeglądarki. Jako hasło dla certyfikatów znajdujących się na nośnikach instalacyjnych służy hasło 1234567.
W taki sam sposób mogą zostać zainstalowane kolejne certyfikaty użytkowników, które zostały samodzielnie utworzone.

Gdy certyfikat użytkownika zostanie zainstalowany oraz certyfikat serwera dla SAS zostanie wygenerowany, możliwe jest wywołanie w przeglądarce adresu, np. https://comarch.yourcompany.com. Podczas uwierzytelniania klienta pojawi się żądanie uwierzytelnienia za pomocą jednego z zainstalowanych certyfikatów.

Do wyboru dostępne są następujące bazy danych OLTP: Podstawowe oraz Demo Multi-Site. W bazie demonstracyjnej znajdują się przykładowe dane sklepu rowerowego. Po wybraniu bazy danych następuje zalogowanie do systemu.

Dalsze kroki

Po instalacji konieczne jest wykonanie kilku kroków w celu dalszej konfiguracji systemu. Zainstalowany system jest licencjonowany jedynie na ograniczony zakres funkcji. Aby móc korzystać z pełnego zakresu funkcjonalności, najpierw należy wczytać licencję dla nowego systemu i skonfigurować to system. Przez okres przejściowy trzech miesięcy aktywna jest licencja demo, która umożliwia korzystanie z wielu funkcji.

Do utworzenia systemu demo na podstawie zainstalowanego systemu należy użyć polecenia Tool-Shell wrkcnf lub w aplikacji Panel system wybrać akcję Utwórz system z komponentami w celu utworzenia nowego systemu na podstawie licencji systemowej. W artykule Utwórz nowy system opisano procedurę tworzenia nowego systemu. Dodatkowe informacje dotyczące uruchamiania znajdują się w artykule Przewodnik: Instalacja.

Sprawdzanie wersji sterownika JDBC

Zdalny sterownik JDBC jest dostarczany wraz z systemem i przechowywany w katalogu plików jako semiramis/lib/jt400.jar. Należy sprawdzić, czy dostępny jest nowszy zdalny sterownik JDBC ze względu na wersję PTF dostępną na i. Sterownik znajduje się w IFS: /root/QIBM/ProdData/http/Public/jt400/lib/jt400.jar

Można zastąpić sterownik instalacji systemu ERP sterownikiem w IFS, jeśli data modyfikacji pliku Manifest.mf zawartego w /root/QIBM/ProdData/http/Public/jt400/lib/jt400.jar jest nowsza niż data tego samego pliku w semiramis/lib/jt400.jar.

Konfiguracja dla poszczególnych krajów

W przypadku natywnego sterownika JDBC w systemie i5/OS nie jest możliwe określenie właściwości specyficznych dla kraju dla połączenia JDBC z bazą danych. Zamiast tego właściwości połączenia z bazą danych są pobierane z profilu użytkownika określonego w ciągu połączenia.

Gdy Comarch ERP Enterprise jest nowo instalowany na i5/OS, użytkownik CISAG jest domyślnie tworzony z ustawieniami niemieckimi.

qcmd „CRTUSRPRF USRPRF($1) TEXT(’$2′) SRTSEQ(*LANGIDUNQ) LANGID(DEU) CNTRYID(DE) CCSID(273)”

W przypadku korzystania z innych języków profil użytkownika musi zostać ręcznie zmieniony zgodnie z odpowiednimi atrybutami językowymi lub muszą zostać utworzone dodatkowe profile użytkowników, które należy wskazać dla odpowiednich połączeń z bazą danych w Panel system. Języki te muszą być również zapisane jako język podstawowy dla odpowiedniej bazy danych OLTP. Zmiana profilu użytkownika może zostać wykonana za pomocą następującego polecenia:

CHGUSRPRF USRPRF(CISAG) SRTSEQ(*LANGIDUNQ) LANGID(DEU) CNTRYID(DE) CCSID(273)

Atrybuty języków obsługiwanych przez Comarch ERP Enterprise znajdują się w poniższej tabeli.

Biblioteka SEM450

Biblioteka SEM450 zawiera pomocne programy do administrowania systemem ERP w systemie i5/OS, w tym kod źródłowy. Odpowiednie programy zostały przedstawione w poniższych sekcjach.

CLRCISJRN – Usuń odbiorcę dziennika

Użycie tego programu, pozwala utworzyć nowego odbiorcę dziennika i usunąć istniejących odbiorców dziennika.

CRTCISCOL – Tworzenie kolekcji

Użycie tego programu, pozwala utworzyć nową kolekcję z domyślnymi ustawieniami i właścicielem CISAG.

DLTCISCOL – Usuwanie kolekcji

To polecenie służy do usuwania kolekcji ze wszystkimi powiązanymi obiektami.

DUPCISCOL – Duplikuj kolekcję

To polecenie służy do duplikowania zawartości istniejącej kolekcji do nowej kolekcji. Nowa kolekcja nie może jeszcze istnieć.

Należy wywołać program rgzciscol po poleceniu dupciscol.

RGZCISCOL – Reorganizacja kolekcji

Program służy do zwalniania pamięci, która nie jest już używana w kolekcji. Pamięć może być na przykład oznaczona jako nieużywana z powodu dużej liczby usuniętych rekordów w tabeli.

Ponadto odbiorcy dziennika są ponownie przypisywani do wszystkich tabel i indeksów w kolekcji. Jest to szczególnie konieczne po wywołaniu dupciscol, ponieważ w przeciwnym razie wpisy dziennika są zapisywane w dziennikach oryginalnej biblioteki.

RGZCISJRN – Reorganizacja dziennika

Program tworzy nowego odbiorcę dziennika i usuwa odbiorców dziennika, którzy już zostali utworzeni.

SAVCISLIB – Zapisz kolekcję

Programu należy użyć, aby utworzyć plik zapisu dla biblioteki w zintegrowanym systemie plików w katalogu /tmp. Utworzony plik zapisu może być opcjonalnie skompresowany.

Aby skompresować utworzony plik, należy wprowadzić wartość parametru:

• 1 – true
• 2 – false

WRKCOLLCK – Praca z blokadami kolekcji

Można użyć tego programu, aby wyświetlić blokady obiektów w kolekcji.

Kopiowanie biblioteki

Aby skopiować bibliotekę na tym samym komputerze, należy użyć następującej sekwencji poleceń (pozwala ono na skopiowanie i zreorganizowanie biblioteki za pośrednictwem kolejki przetwarzania):

SBMJOB CMD(SEM450/DLTCISCOL COL(xxxxxxxxxx) LCKACT(*ENDJOB))

SBMJOB CMD(SEM450/DUPCISCOL FROMCOL(xxxxxxxxxx) TOCOL(yyyyyyyyyy))

SBMJOB CMD(SEM450/RGZCISCOL COL(yyyyyyyyyyyyy))

Można użyć polecenia wrksbmjob, aby wyświetlić status zleceń przetwarzania, które zostały już przesłane. 

Można wyświetlić komunikaty utworzone podczas wykonywania poleceń za pomocą polecenia dspmsg.

Jeśli biblioteka ma zostać przeniesiona na inny komputer, można użyć polecenia savcislib, aby zapisać ją w zintegrowanym systemie plików.

SBMJOB CMD(CISAG450/SAVCISCOL COL(yyyyyyyyyyyy) COMPRESS `1`)

Plik jest przechowywany w katalogu /QopenSys/var/tmp i może być stamtąd skopiowany.