Migracja XL Business Intelligence do wersji 2019.0
Copyright 2018 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 2019.0
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. Stworzenie nowego joba SQL... 8 7. Transformacja ETL z pełnym odświeżaniem faktów księgowych, magazynowych i sprzedażowych... 9 8. Odtwarzanie wymiarów analitycznych i atrybutów.... 10 9. Migracja Budżetów tylko w wersji starszej niż 2014.0... 10 10. Migracja Alokacji kosztów... 11 11. Migracja BI Point... 11 12. Migracja Raportów Olap (tylko z wersji wcześniejszych niż 2017)... 11 Spis rysunków... 12 Comarch ERP XL 3 Wersja 2019.0
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 2019.0. Przed migracją należy najpierw podnieść bazę Comarch ERP XL do wersji 2019.0 oraz bazy hurtowni co najmniej do wersji 9.0 a także zainstalować aplikację Comarch ERP XL Business Intelligence 2019.0 (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 2019.0. 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 Stworzenie nowego joba SQL Tak 7 Transformacja z pełnym odświeżaniem faktów magazynowych, księgowych, CRM i sprzedażowych* Tak 8 Odtwarzanie wymiarów analitycznych i atrybutów Tak 9 Migracja budżetów opcjonalnie 10 Migracja Alokacji Kosztów opcjonalnie 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 2019.0
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 2019.0 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 2019.0
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 2019.0
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 2019.0
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. Stworzenie nowego joba SQL UWAGA: Ze względu na zmianę ścieżki do panelu zarządzania (folder Management Panel zmienił nazwę na panel ) w wersji 2019.0 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. 8 Comarch ERP XL Wersja 2019.0
7. 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. 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 Comarch ERP XL 9 Wersja 2019.0
- Fakt Koszty 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. 8. 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). 9. 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. 10 Comarch ERP XL Wersja 2019.0
10. 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. 11. Migracja BI Point Od wersji Comarch XLBI 2019 migrację BI Point należy wykonać zgodnie z dokumentem migracji dostępnym na stronach dla partnerów - Dokument migracji Comarch BI Point Najnowsza wersja Comarch BI Point dostępna jest także na stronach dla partnerów - Comarch BI Point 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 8 Migracja raportów OLAP Comarch ERP XL 11 Wersja 2019.0
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 Migracja raportów OLAP 11 12 Comarch ERP XL Wersja 2019.0