Instalacja Anvaigo OnPrem (typ B i C)
Istnieją różne warianty instalacji Anvaigo Mobile App: Jako wariant zarządzany z Anvaigo Mobile App Cloud Service i jako wariant zarządzany samodzielnie z Anvaigo Server. Przegląd dostępnych wariantów można znaleźć w wymaganiach systemowych. Niniejsza instrukcja instalacji opisuje Anvaigo Type B i C: samodzielnie zarządzane.
Kiedy powinienem korzystać z zarządzanego lub samodzielnego zarządzania?
Wariant zarządzany jest znacznie szybszą i prostszą opcją. Anvaigo dostarcza App Service i Delta Service jako rozwiązanie SaaS. Jeśli nie chcesz uruchamiać własnego serwera Anvaigo, wybierz wariant instalacji Anvaigo Type A (zarządzany).
Anvaigo Server zapewnia Anvaigo App Service, jak również Delta Service (dla instalacji Anvaigo B). Zarówno serwer Anvaigo Server, jak i baza danych PostgreSQL obsługują wiele instancji, dzięki czemu mogą być używane w wielu systemach, takich jak środowiska produkcyjne i sandbox.
Anvaigo App Service to połączenie pomiędzy Anvaigo Mobile App zainstalowaną na urządzeniach mobilnych a Microsoft Dynamics System. Jest on używany do uwierzytelniania i bezpieczeństwa i może być zainstalowany przed zaporą sieciową w celu ochrony systemu.
Serwer Anvaigo jest wymagany dla wariantów infrastruktury Anvaigo B i C. Można go łatwo zainstalować za pomocą konfiguracji. Alternatywnie, Anvaigo Mobile App Cloud Service może być użyty do zainstalowania Anvaigo Server. Więcej informacji na temat usługi Anvaigo Mobile App Cloud Service można znaleźć tutaj.
Anvaigo Infrastructure Variant B wymaga również instalacji bazy danych PostgreSQL. Baza danych PostgreSQL zapewnia Anvaigo Delta Server, który jest obowiązkowy dla Anvaigo Delta Service. Instalacja ta została opisana poniżej. W Anvaigo Infrastructure Variant C, Delta Server jest instalowany bezpośrednio w bazie danych SQL, w której znajduje się baza danych Microsoft Dynamics. Dlatego usługa Delta Service nie jest wymagana dla tego wariantu instalacji.
Instalacja serwera Anvaigo
Zainstaluj Anvaigo Server uruchamiając„Anvaigo Server Setup.exe„. Wybierz język i katalog docelowy.
Następnie zostaniesz poproszony o wybranie portu i hasła. Hasło będzie potrzebne później do konfiguracji w Microsoft Dynamics. Ze względów bezpieczeństwa powinien on być znany tylko administratorowi.
Ze względu na szyfrowany transfer danych między serwerem Anvaigo a klientem aplikacji mobilnej Anvaigo, zalecamy korzystanie z certyfikatu SSL. Więcej informacji na temat korzystania z certyfikatu można znaleźć w naszym Knowledge Base tutaj. W przypadku środowisk testowych można pozostawić to pole puste i zostanie utworzony certyfikat z podpisem własnym
Gdzie mogę znaleźć odcisk kciuka mojego certyfikatu SSL?
Odcisk kciuka certyfikatu SSL można znaleźć w następujący sposób:
Wpisz „Certificates” lub „certlm.msc” w wyszukiwarce systemu Windows. Pojawi się następujące okno:
W zakładce „Szczegóły” znajduje się odcisk kciuka:
Po wprowadzeniu „Odcisku kciuka” można sprawdzić ustawienia i rozpocząć instalację.
Uwaga: Podczas kopiowania i wklejania z tego pola na początku lub na końcu pojawiają się niewidoczne znaki specjalne, w zależności od wersji systemu Windows. Powinny one zostać usunięte przez skasowanie.
Po zakończeniu instalacji można sprawdzić, czy Anvaigo Server został pomyślnie uruchomiony.
W przypadku wystąpienia błędu należy sprawdzić komunikaty o błędach. Możliwymi przyczynami mogą być nieprawidłowy odcisk kciuka certyfikatu SSL lub już przypisany port TCP.
Instalacja bazy danych PostgreSQL
Aby korzystać z Anvaigo Server w ramach instalacji Anvaigo B, wymagana jest baza danych PostgreSQL. Można ją pobrać z tego linku.
Należy pamiętać, że w przypadku Anvaigo Varainte C baza danych PostgresSQL nie jest wymagana i tę sekcję można pominąć. Kontynuuj „Konfigurację Zapory systemu Windows”.
W przypadku środowisk testowych zalecamy zainstalowanie bazy danych PostgreSQL na tym samym serwerze co Anvaigo Server.
W przypadku systemów na żywo zalecamy korzystanie z oddzielnych serwerów. Dzięki temu serwer Anvaigo może być zlokalizowany jako serwer frontent w DMZ, podczas gdy PostgreSQL jest zainstalowany w zabezpieczonym środowisku. W przypadku instalacji na innym serwerze, w PostgreSQL należy wprowadzić dodatkowe ustawienia bezpieczeństwa, które nie zostały tutaj udokumentowane. Bardziej szczegółowe informacje można znaleźć pod tym linkiem.
W pierwszym kroku należy wybrać lokalizację instalacji.
Zainstaluj składniki wybrane domyślnie. Stack Builder nie jest wymagany. Można więc usunąć go z komponentów, które mają zostać zainstalowane.
W następnym kroku można zmienić katalog docelowy bazy danych.
Ustaw hasło do bazy danych. Hasło to powinno znacznie różnić się od hasła serwera Anvaigo i być znane tylko administratorowi.
Następnym krokiem jest ustawienie portu dla bazy danych PostgreSQL. Jeśli to możliwe, należy użyć domyślnego portu (5432) PostgreSql. W razie potrzeby można ją jednak zmienić.
Język/lokalizację można dostosować w następnym kroku. Zalecamy zachowanie ustawienia domyślnego.
Przed rozpoczęciem instalacji można jeszcze sprawdzić wszystkie wpisy.
Na koniec instalacja zostanie uruchomiona:
Konfiguracja zapory systemu Windows
Komunikacja między Anvaigo Server, Anvaigo Mobile App i Dynamics wymaga skonfigurowania odpowiednich portów w Zaporze systemu Windows.
Komunikacja Anvaigo Server z Microsoft Dynamics
Anvaigo Server komunikuje się z Microsoft Dynamics Web Service za pośrednictwem portu konfiguracyjnego Anvaigo Server. Domyślnie jest to port 8888, ale można go ustawić inaczej podczas instalacji Anvaigo Server. Ten port musi być otwarty tylko do komunikacji z Microsoft Dynamics Web Services. Nie zaleca się ustawiania tego portu na Publiczny.
Otwórz Zaporę systemu Windows.
Określ typ.
Port jest określany w następnym kroku.
Następnym krokiem jest określenie kierunku.
I w którym przypadku reguła zapory powinna zacząć obowiązywać.
Wreszcie, nowa reguła zapory musi mieć znaczącą nazwę.
Komunikacja Anvaigo Server z aplikacją Anvaigo Mobile App
Komunikacja z Anvaigo Server do Anvaigo Mobile App wymaga dwóch portów na instancję. Domyślnie są to porty 7020 i 7021. Porty te muszą być publicznie dostępne.
Uwaga: Jeśli planujesz kolejną instancję na tym serwerze Anvaigo, możesz na przykład włączyć dodatkowe porty, takie jak 7022-7023.
Utwórz nową regułę zapory i określ jej typ.
Wprowadź odpowiednie porty.
Postępuj zgodnie z dalszymi krokami opisanymi powyżej. Na koniec ponownie wprowadź znaczącą nazwę.
Po pomyślnym zakończeniu konfiguracji w zaporze sieciowej powinny pojawić się nowe reguły.
Uwaga:
Jeśli baza danych PostgreSQL nie jest zainstalowana na tym samym serwerze, należy włączyć inny port. Na serwerze instalacji PostgreSQL port 5432 (lub port niestandardowy) musi być domyślnie otwarty do komunikacji z serwerem Anvaigo. Port ten musi być również dostępny tylko wewnętrznie i nie powinien być dostępny z zewnątrz.
Konfiguracja w Microsoft Dynamics
W Microsoft Dynamics otwórz Kreatora konfiguracji aplikacji mobilnej Anvaigo.
Rozpocznij konfigurację Anvaigo Mobile App w Microsoft Dynamics, określając, że zainstalowałeś Anvaigo Server na własnej infrastrukturze (Self-managed Anvaigo Server). Dodatkowo należy podać unikalną nazwę instancji Anvaigo. Będzie on później używany na urządzeniach mobilnych do logowania. Nazwa instancji powinna zawierać company name i być tak krótka i zwięzła, jak to tylko możliwe. Tutaj można znaleźć listę niedozwolonych nazw instancji.
W następnej sekcji zostaniesz poproszony o wprowadzenie szczegółów połączenia z serwerem Anvaigo.
Adres usługi aplikacji (zewnętrzny) to „pełna kwalifikowana nazwa domeny” (FQDN), dla której potrzebny jest ważny, oficjalnie potwierdzony certyfikat. Serwer Anvaigo może być osiągnięty przez klienta aplikacji mobilnej Anvaigo z zewnątrz za pośrednictwem tego adresu. W celu sprawdzenia certyfikatu SSL należy w tym momencie użyć nazwy FQDN, a nie adresu IP.
Port TCP usługi aplikacji jest domyślnie ustawiony na 7020, chyba że zostanie dostosowany ręcznie. Jeśli wiele usług Anvaigo App Services jest świadczonych przez jeden serwer Anvaigo, port ten różni się od domyślnego.
Port http usługi aplikacji to zwykle 7021. Może się to również różnić w przypadku instalacji wielokrotnych.
Anvaigo Server Address (internal) to wewnętrzny adres, pod którym Microsoft Dynamics może dotrzeć do serwera Anvaigo. Ważne: Ten adres nie powinien być dostępny dla świata zewnętrznego.
Port serwera to domyślnie 8888 i został on również zdefiniowany podczas instalacji serwera Anvaigo.
Hasło Anvaigo Server zostało przypisane podczas poprzedniej instalacji Anvaigo Server.
Po wprowadzeniu danych połączenia dla serwera Anvaigo, następnym krokiem jest skonfigurowanie danych połączenia z bazą danych PostgreSQL.
Database Address to „Full Qualified Domain Name” (FQDN) lub adres IP, pod którym baza danych PostgreSQL jest dostępna z serwera Anvaigo. Jeśli baza danych PostgreSQL jest zainstalowana na tym samym serwerze co serwer Anvaigo, wpisz tutaj „localhost”. Jeśli baza danych PostgreSQL jest zainstalowana na innym serwerze, należy skonfigurować dostęp zewnętrzny. Więcej informacji na ten temat można znaleźć pod tym linkiem.
Tryb SSL jest wyłączony.
Domyślnym użytkownikiem bazy danych jest „postgres”.
Hasło do bazy danych zostało przypisane podczas instalacji bazy danych PostgreSQL.
Następnym krokiem jest określenie adresu URL usługi sieci Web i domyślnego klienta.
Następnym krokiem jest skonfigurowanie serwera Anvaigo.
Następnym krokiem jest przypisanie licencji do instancji.
Uwaga:
To nie jest komunikat o błędzie. Prosimy o kontakt z naszym zespołem pod adresem [email protected]. Mogą oni utworzyć licencję próbną lub przypisać istniejącą licencję rzeczywistą do instancji. Aby to zrobić, wprowadź nazwę instancji Anvaigo, którą przypisałeś na początku. Po otrzymaniu odpowiedzi od naszego zespołu, uruchom ponownie Kreatora Anvaigo.
Kreator Anvaigo kontynuuje konfigurację, ustawiając „Interwał zadań”.
W celu obliczenia danych delta zalecamy utworzenie zadania w Microsoft Dynamics, które automatycznie określa zmiany w danych Dynamics i przesyła je do Anvaigo Delta Service w regularnych odstępach czasu.
Obliczenia te są uruchamiane automatycznie za każdym razem, gdy użytkownicy Anvaigo synchronizują się. Automatyczne zadanie znacznie minimalizuje czas synchronizacji, ponieważ dane są zawsze obliczane w międzyczasie, a nie w momencie synchronizacji.
Replikacja danych do usługi Anvaigo Delta
Replikacja danych do Anvaigo Delta Service jest wymaganą funkcją, która jest automatycznie konfigurowana podczas pierwszej instalacji za pomocą Kreatora instalacji. Jeśli jednak konfigurujesz aplikację do swoich potrzeb, konieczne jest bliższe przyjrzenie się konfiguracji Anvaigo Delta Service.
Co robi usługa Anvaigo Delta?
Aby zapewnić użytkownikowi szybką synchronizację, tylko zmiany danych (delta danych), a nie zawsze wszystkie dane (tzw. pełne obciążenie)
są przesyłane między Dynamics a Anvaigo Mobile App. W tym celu zmiany danych w Dynamics są określane na bieżąco przez Anvaigo Delta Service i udostępniane Anvaigo Mobile App za pośrednictwem Anvaigo App Service.
W tym celu wszystkie zmiany danych są okresowo przesyłane z Dynamics do usługi Anvaigo Delta, dzięki czemu może ona szybko wykonywać obliczenia. Jest to obsługiwane przez Delta Service Replication.
W kliencie Anvaigo Mobile App na urządzeniu mobilnym dostępne są tylko dane zdefiniowane przez pakiety synchronizacji Anvaigo i konfigurację serwera Delta – patrz konfiguracja serwera Delta.
Ważne! Ponowne logowanie po zmianach konfiguracyjnych
Ze względu na pewne ograniczenia Microsoft Dynamics, konieczne jest wylogowanie i ponowne zalogowanie wszystkich użytkowników po dokonaniu pewnych zmian konfiguracyjnych w Anvaigo Delta Service Setup. Dlatego zalecamy wprowadzanie zmian poza godzinami pracy. Obecnie wymagane są przestoje dla użytkowników mobilnych podczas ponownej synchronizacji zmian. W przyszłych wersjach będzie można automatycznie zsynchronizować zmiany w nocy bez przestojów.
Zainstaluj aplikację Anvaigo Sales lub Service App
Jeśli zainstalowałeś aplikację Anvaigo Sales lub Service App jako rozszerzenie, zostaniesz zapytany, czy chcesz je skonfigurować.
Anvaigo Sales App
Tutaj można znaleźć instrukcje instalacji gotowych do użycia rozwiązań Anvaigo Sales App.
Anvaigo Service App
Tutaj można znaleźć instrukcje instalacji gotowych do użycia rozwiązań Anvaigo Service App.