Migracja Comarch ERP Altum Business Intelligence do wersji 2016.5 Wersja 2016.5
2 Comarch ERP Altum Wersja 2016.5
Copyright 2016 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. Comarch ERP Altum 3 Wersja 2016.5
Spis treści Wstęp... 5 1. Czynności przygotowawcze... 5 2. Tabela czynności jakie należy wykonać podczas migracji modułu Business Intelligence.. 5 3. Migracja Hurtowni Danych... 6 4. Tworzenie nowej bazy OLAP... 7 5. Reinstalacja serwisu subskrypcji i mobile... 9 6. Ustawienie delegacji do protokołu Kerberos... 9 7. Wykonanie transformacji ETL... 10 8. Odtwarzanie wymiarów analitycznych i atrybutów.... 10 9. Migracja Budżetów... 10 10. Migracja alokacji kosztów... 10 11. Migracja WRB... 10 12. Migracja BI Point... 12 4 Comarch ERP Altum Wersja 2016.5
Wstęp W niniejszym dokumencie opisane zostały czynności, jakie należy wykonać w celu migracji baz Comarch ERP Altum Business Intelligence do wersji 2016.5. Funkcjonalność migracji baz pozwala zaktualizować dane zawarte w bazie REPO, META, DW i LOG do aktualnej wersji systemu Comarch ERP ALTUM. Dokument opisuje jedynie migrację rozwiązania Business Intelligence, pomijając czynności związane z aktualizacją bazy transakcyjnej Altum. 1. Czynności przygotowawcze Przed rozpoczęciem procesu migracji baz Business Intelligence należy: - zainstalować aktualną wersję systemu Comarch ERP ALTUM (wraz z HF) - zaktualizować (zmigrować) bazę transakcyjną ALTUM - wykonać kopie zapasowe wszystkich baz Business Intelligence (DW, REPO, LOG, META) - wykonać backup bazy analitycznej OLAP 2. Tabela czynności jakie należy wykonać podczas migracji modułu Business Intelligence Punkt z dokumentacji Nazwa Wykonać (Tak/Nie) 3 Migracja hurtowni danych Tak 4 Tworzenie nowej bazy OLAP (wersje wcześniejsze niż 2015.5) Tak 5 Reinstalacja serwisu subskrypcji i mobile Tak 6 Ustawienie delegacji do protokołu Kerberos Tak 7 Wykonanie transformacji ETL Tak 8 Odtwarzanie wymiarów analitycznych i atrybutów Tak 9 Migracja budżetów Opcjonalnie 10 Migracja alokacji kosztów Opcjonalnie 11 Migracja WRB Tak 12 Migracja BI Point Tak Comarch ERP Altum 5 Wersja 2016.5
3. 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 komputera. Aby przeprowadzić migrację hurtowni danych należy uruchomić Panel Zarządzania BI w wersji 2016.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. 6 Comarch ERP Altum Wersja 2016.5
Rysunek 2 Okno migracji baz BI Po dokonaniu Aktualizacji pojawi się poniższe okno, należy kliknąć Zamknij. Rysunek 3 Zakończenie migracji baz 4. 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. Comarch ERP Altum 7 Wersja 2016.5
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. Rysunek 5 Wybór hurtowni danych 8 Comarch ERP Altum Wersja 2016.5
5. Reinstalacja serwisu subskrypcji i mobile W celu przeinstalowania serwisu subskrypcji i mobile należy wykonać następujące czynności: 1. Zatrzymać usługę serwisu subskrypcji i mobile (RBSS_AltumBi, RBMS_AltumBI) 2. Uruchomić linię komend z uprawnieniami administratora 3. Usunąć usługi serwisu subskrypcji i mobile za pomocą poleceń: sc delete RBSS_AltumBI sc delete RBMS_AltumBI 4. Uruchomić konfigurator Business Intelligence i wybrać tryby: Tylko Serwis Subskrypcji oraz Tylko Serwis Mobile 6. Ustawienie delegacji do protokołu Kerberos Uwaga: W sytuacji gdy baza źródłowa ALTUM 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. Comarch ERP Altum 9 Wersja 2016.5
7. Wykonanie transformacji ETL W celu odtworzenia relacji na bazie OLAP konieczne jest wykonanie transformacji ETL. Sposób uruchomienia transformacji ETL opisany został bardziej szczegółowo w dokumentacji modułu. 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 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. Krok należy wykonać w przypadku, gdy wykorzystywane było budżetowanie w wersji starszej niż 6.3. 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 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 10 Comarch ERP Altum Wersja 2016.5
Rysunek 6 Menadżer IIS 2. W folderze Sites wybrać odpowiednią stronę Web Reports Book 3. Kliknąć na niej a następnie na Usuń Rysunek 7 Konfiguracja IIS 4. Uruchomić konfigurator Business Intelligence i wybrać tryb Tylko Web Reports Book Comarch ERP Altum 11 Wersja 2016.5
12. 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 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 Altum Wersja 2016.5
Spis ilustracji Rysunek 1 Logowanie - Panel Zarządzania... 6 Rysunek 2 Okno migracji baz BI... 7 Rysunek 3 Zakończenie migracji baz... 7 Rysunek 4 Konfigurator - tylko baza OLAP... 8 Rysunek 5 Wybór hurtowni danych... 8 Rysunek 6 Menadżer IIS... 11 Rysunek 7 Konfiguracja IIS... 11 Comarch ERP Altum 13 Wersja 2016.5