Migracja XL Business Intelligence do wersji 2018.1
Copyright 2017 COMARCH Wszelkie prawa zastrzeżone Nieautoryzowane rozpowszechnianie całości lub fragmentu niniejszej publikacji w jakiejkolwiek postaci jest zabronione. Wykonywanie kopii metodą kserograficzną, fotograficzną, a także kopiowanie na nośniku filmowym, magnetycznym lub innym, powoduje naruszenie praw autorskich niniejszej publikacji. 2 Comarch ERP XL Wersja 2018.1
Spis treści Wstęp... 4 1. Tabela czynności jakie należy wykonać podczas migracji modułu Business Intelligence... 4 2. Migracja Hurtowni Danych... 5 3. Tworzenie nowej bazy OLAP... 6 4. Reinstalacja serwisu subskrypcji... 7 5. Ustawienie delegacji do protokołu Kerberos... 8 6. Transformacja ETL z pełnym odświeżaniem faktów księgowych, magazynowych i sprzedażowych... 8 7. Odtwarzanie wymiarów analitycznych i atrybutów.... 10 8. Migracja Budżetów tylko w wersji starszej niż 2014.0... 10 9. Migracja Alokacji kosztów... 10 10. Migracja WRB... 11 11. Migracja BI Point... 12 12. Migracja Raportów Olap do wersji 2017... 13 Spis rysunków... 14 Comarch ERP XL 3 Wersja 2018.1
Wstęp Użytkownik korzystający z aplikacji Comarch ERP XL moduł Business Intelligence w wersji 9.0 lub wyższej jest w stanie w prosty sposób zmigrować hurtownie danych, stworzone raporty oraz budżety do wersji 2018.1. Przed migracją należy najpierw podnieść bazę Comarch ERP XL do wersji 2018.1 oraz bazy hurtowni co najmniej do wersji 9.0 a także zainstalować aplikację Comarch ERP XL Business Intelligence 2018.1 (proces instalacji nowej wersji może wymagać restartu serwera). UWAGA: Przed rozpoczęciem migracji koniecznie należy wykonać kopie zapasowe wszystkich baz baz hurtowni danych, bazy analitycznej OLAP. Opisana poniżej migracja dotyczy przejścia z wersji 9.0 lub wyższych do wersji 2018.1. Migracja powinna być przeprowadzana przez użytkownika posiadającego pełne uprawnienia do baz Business Intelligence oraz minimum prawa odczytu do bazy źródłowej. Zaleca się przeprowadzanie migracji na koncie administratora systemu. 1. Tabela czynności jakie należy wykonać podczas migracji modułu Business Intelligence Punkt dokumentacji z Nazwa Wykonać (Tak/Nie) 2 Migracja hurtowni danych Tak 3 Tworzenie nowej bazy OLAP Tak 4 Reinstalacja serwisu subskrypcji Tak 5 Ustawienie delegacji do protokołu Kerberos Tak 6 Transformacja z pełnym odświeżaniem faktów magazynowych, księgowych, CRM i sprzedażowych* Tak 7 Odtwarzanie wymiarów analitycznych i atrybutów Tak 8 Migracja budżetów opcjonalnie 9 Migracja Alokacji Kosztów opcjonalnie 10 Migracja WRB Tak 11 Migracja BI Point Tak 12 Migracja Raportów Olap Tak *w przypadku migracji z wersji 10.2 pełne odświeżanie wszystkich faktów nie jest wymagane należy wykonać jednak transformację na nowej bazie OLAP, szczegóły poniżej w pkt.6 4 Comarch ERP XL Wersja 2018.1
2. Migracja Hurtowni Danych UWAGA: Ze względu na stopień złożoności zapytań wykonywanych podczas migracji baz danych, proces ten może być długotrwały i może pochłaniać dużą ilość zasobów serwera. Aby przeprowadzić migrację hurtowni danych należy uruchomić Panel Zarządzania BI w wersji 2018.1 i zalogować się do bazy meta hurtowni, którą chcemy zmigrować. Rysunek 1 Logowanie - Panel Zarządzania Po zalogowaniu pojawi się okno z informacją dotyczącą aktualizacji baz hurtowni. Jeżeli zostały wykonane kopie zapasowe baz hurtowni należy kliknąć Wykonaj, rozpocznie się proces aktualizacji. Rysunek 2 Okno migracji baz BI Comarch ERP XL 5 Wersja 2018.1
Po dokonaniu Aktualizacji pojawi się poniższe okno, należy kliknąć Zamknij. Rysunek 3 Zakończenie migracji baz 3. Tworzenie nowej bazy OLAP W kolejnym kroku należy stworzyć nową bazę OLAP. Należy pamiętać aby wykreować ją pod dokładnie taką samą nazwą i na tym samym serwerze co poprzednia (wcześniej starą bazę należy zachować w postaci backupu na dysku, a następnie usunąć z Analysis Services). Aby wykreować nową bazę należy uruchomić Konfigurator Business Intelligence i ustawić w oknie powitalnym tryb konfiguracji na Tylko baza OLAP i kliknąć Dalej. Rysunek 4 Konfigurator - tylko baza OLAP Należy wybrać z listy zdefiniowanych połączeń, alias do hurtowni, która będzie migrowana, bądź podać namiary na bazę konfiguracyjną meta. W dalszych krokach konfiguratora zostanie stworzona wskazana baza OLAP. 6 Comarch ERP XL Wersja 2018.1
Rysunek 5 Wybór aliasu połączenia 4. Reinstalacja serwisu subskrypcji Uruchomić Konfigurator XL BI i wybrać tryb: Serwis Subskrypcji. Następnie podążać za wskazówkami wyświetlanymi na ekranie. Konfigurator automatycznie usunie starą instancję serwisu, wymogiem jest, aby była ona uruchomiona w trakcie pracy konfiguratora. Comarch ERP XL 7 Wersja 2018.1
5. Ustawienie delegacji do protokołu Kerberos UWAGA: W sytuacji gdy baza źródłowa XL jest na innym serwerze niż hurtownia danych należy dla komputera z hurtownią dodać delegację do protokołu Kerberos. Uprawnienie takie może nadać Administrator domeny z poziomu usługi Active Directory. Poniższy rysunek przedstawia okno ustawienia opisanej delegacji. 6. Transformacja ETL z pełnym odświeżaniem faktów księgowych, magazynowych i sprzedażowych Po stworzeniu nowej bazy OLAP należy przeprowadzić transformację z wartością -1 ustawioną dla parametrów Odświeżaj fakty magazynowe za (dni), Odświeżaj fakty księgowe za (dni), Odświeżaj fakty CRM za (dni) oraz Odświeżaj fakty sprzedażowe za (dni) UWAGA: Proces pełnego odświeżania faktów magazynowych i księgowych konieczny jest w sytuacji, gdy bazy migrowane są z wersji starszej niż 9.7. Jeżeli migracja przeprowadzana jest z wersji 9.7 lub wyższej, pełne odświeżanie faktów magazynowych i księgowych można pominąć. Uwaga nie dotyczy faktów sprzedażowych. 8 Comarch ERP XL Wersja 2018.1
UWAGA: Ze względu na zastosowanie w wersji 2018.1 panelu jednoplikowego, wymagane jest ponowne wykreowanie nowego joba SQL ze względu na zmianę ścieżki do pliku EtlExec. Wpis można także zmodyfikować we właściwościach aktualnego joba. Jeśli migracja ma miejsce z wersji 2017, modyfikacja nie jest konieczna. Rysunek 6 Zbiór parametrów transformacji Jeżeli transformacja z pełnym odświeżaniem faktów sprzedażowych nie może być przeprowadzona ze względu na zbyt długi czas wykonania, to czynność tą można zastąpić pełnym odświeżaniem faktów rabatów i kosztów. (Uwaga bez wykonania odświeżania faktów sprzedaży nie będzie można analizować danych sprzedażowych po adresach pobieranych z kontrahenta docelowego z dokumentów). W tym celu należy uruchomić dodatkowe przetwarzanie z parametrem odświeżaj fakty sprzedażowe ustawionym na -1, gdzie wybrane będą jedynie następujące pakiety: - Fakt Koszty Sprzedaży - Fakt Rabaty Sprzedaży - Fakt Rabaty - Fakt Koszty Comarch ERP XL 9 Wersja 2018.1
Rysunek 7 Konfiguracja pakietów Po wykonaniu takiej transformacji parametr odświeżania należy przywrócić do wartości początkowej i ponownie wybrać odpowiednie obszary analityczne (pakiety), które mają być transformowane. 7. Odtwarzanie wymiarów analitycznych i atrybutów. Do nowo wykreowanej bazy należy dołączyć wcześniej wykorzystywane atrybuty i wymiary analityczne. Wszystkie czynności należy wykonać z poziomu Panelu Zarządzania za pomocą Konfiguratora bazy OLAP. Wymiary można dodać ręcznie lub za pomocą automatu (Sprawdź i Przywróć konfigurację bazy OLAP funkcja zalecana jest w przypadku mocnych serwerów). 8. Migracja Budżetów tylko w wersji starszej niż 2014.0 W przypadku, gdy migracja odbywa się z wersji 2014.0 lub wyższej migracja budżetów nie jest obowiązkowa, nawet w przypadku, gdy funkcjonalność budżetowania była wykorzystywana. Następnie należy z poziomu Księgi Raportów przenieść jeszcze raz poszczególne budżety do hurtowni. W ten sposób migracja budżetów zostanie zakończona. 9. Migracja Alokacji kosztów Podczas pierwszej transformacji na bazie OLAP odtworzone zostaną miary utworzone w procesie Alokacji kosztów. Wyjątkiem są miary, które zostały zaalokowane do grupy miar opartej na widokach. Takie miary należy odtworzyć ręcznie przenosząc odpowiednie procesy z poziomu Księgi Raportów. 10 Comarch ERP XL Wersja 2018.1
10. Migracja WRB W celu przeinstalowania WRB należy wykonać następujące czynności: 1. Przejść do: Menu Start -> Panel Sterowania -> Narzędzia administracyjne -> Internet Information Services (IIS) Manager Rysunek 8 Menadżer IIS 2. W folderze Sites wybrać odpowiednią stronę Web Reports Book 3. Kliknąć na niej a następnie na Usuń Rysunek 9 Konfiguracja IIS 4. W folderze Pule aplikacji usunąć ComarchBI_WRB_AppPool 5. Uruchomić Konfigurator XL BI, wybrać tryb Tylko Web Reports Book i podążać za wskazówkami wyświetlanymi na ekranie. Comarch ERP XL 11 Wersja 2018.1
11. Migracja BI Point W celu przeinstalowania aplikacji BI Point należy wykonać następujące czynności: 1. Usunąć starą wersję BI Point Server service dostępną w usługach systemu Windows. Usługa widoczna jest pod nazwą Comarch BI Server z dopisaną nazwą bazy META np. Comarch BI Server XXX_META. W pierwszej kolejności należy zatrzymać usługę, a następnie ją usunąć korzystając z wiersza poleceń systemu Windows. Wiersz poleceń musi być uruchomiony z uprawnieniami administratora. W celu usunięcia usługi Comarch BI należy wprowadzić poniższe polecenie: Sc DELETE <nazwa serwisu BI Point> 2. Przejść do: Menu Start -> Panel Sterowania -> Narzędzia administracyjne -> Internet Information Services (IIS) Manager 3. W folderze Sites wybrać odpowiednią stronę Comarch BI Point 4. Kliknąć na niej a następnie na Usuń 5. W folderze Pule aplikacji usunąć ComarchBI_AppPool 6. Usunąć fizyczne pliki aplikacji znajdujące się pod standardową ścieżką: C:\Program Files (x86)\comarch ERP XL\Business Intelligence\instances W folderze instances znajduje się folder z nazwą bazy META, a w nim dwa foldery przeznaczone do usunięcia: - Comarch.BI.Server - ComarchBI_Point nazwa tego folderu jest analogiczna jak nazwa strony w IIS 7. Zainstalować aplikację z konfiguratora BI korzystając z opcji Tylko Comarch BI Point. Zalecane jest wykreowanie tych samych nazw instancji jak w poprzedniej wersji. 8. W celu migracji bazy geolokalizacyjnej (baza wymagana do stosowania map w BI Point) należy wykonać na niej poniższy skrypt (baza dostępna na serwerze postgresql przez aplikację pgadmin): CREATE SEQUENCE public."custom_json_items_cji_id_seq" INCREMENT 1 MINVALUE 1 MAXVALUE 9223372036854775807 CACHE 1; START 4 ALTER TABLE public."custom_json_items_cji_id_seq" OWNER TO postgres; CREATE TABLE public.custom_json_items ( "CJI_Id" integer NOT NULL DEFAULT nextval('"custom_json_items_cji_id_seq"'::regclass), "CJI_Name" character varying(100) NOT NULL, "CJI_Json" json NOT NULL, "CJI_CompanyId" integer DEFAULT (-1) ) WITH ( OIDS=FALSE );ALTER TABLE public.custom_json_items OWNER TO postgres; 12 Comarch ERP XL Wersja 2018.1
12. Migracja Raportów Olap (tylko z wersji wcześniejszych niż 2017) W celu zachowania poprawnej struktury raportów Olap opartych o wymiar Produkt Katalog konieczna jest migracja raportów. Operację należy wykonać po wygenerowaniu nowej bazy Olap oraz zakończeniu pierwszej transformacji po migracji. Funkcjonalność jest dostępna z poziomu panelu zarządzania na zakładce Administracja -> Migracja raportów Olap. Rysunek 10 Migracja raportów OLAP Comarch ERP XL 13 Wersja 2018.1
Spis rysunków Rysunek 1 Logowanie - Panel Zarządzania 5 Rysunek 2 Okno migracji baz BI 5 Rysunek 3 Zakończenie migracji baz 6 Rysunek 4 Konfigurator - tylko baza OLAP 6 Rysunek 5 Wybór aliasu połączenia 7 Rysunek 6 Zbiór parametrów transformacji 9 Rysunek 7 Konfiguracja pakietów 10 Rysunek 8 Menadżer IIS 11 Rysunek 9 Konfiguracja IIS 11 Rysunek 10 Migracja raportów OLAP 13 14 Comarch ERP XL Wersja 2018.1