Instalacja Platformy AMODIT (edycja 3)

Wstęp

Ten dokument poprowadzi Cię przez proces instalacji Platformy AMODIT w wersji 2016.0004 lub nowszej na serwerze pracującym pod kontrolą systemu operacyjnego Windows Server 2012 R2, Windows Server 2016, Windows Server 2019, Windows 10, Windows 8.1, Windows 8 oraz Windows 7  z użyciem serwera IIS.

Instalacja platformy AMODIT

Platforma AMODIT składa się z dwóch składników:

• Aplikacja webowa, instalowana pod IIS, dostępna dla użytkowników przez przeglądarkę pod ustalonym podczas instalacji adresem URL.
• Baza danych, zestaw tabel, widoków, procedur i funkcji do obsługi aplikacji webowej, instalowanych na serwerze SQL. Platforma AMODIT przygotowana jest do współpracy z jednym z dwóch silników SQL: Microsoft SQL oraz MySQL (nie dotyczy edycji MariaDB).

Typowym scenariuszem instalacji Platformy AMODIT jest umieszczanie aplikacji webowej i serwera bazy danych na odrębnych maszynach. Przy czym mogą to być maszyny wirtualne. Dla mniejszych wymagań wydajnościowych dopuszczalna jest instalacja obu funkcji na jednej maszynie. Należy jednak pamiętać, że przy zwiększającym się obciążeniu (wzrost liczby użytkowników, rosnąca liczba spraw i dokumentów) wydajność tak przygotowanego środowiska może być niewystarczająca. Z kolei dla wyższych wymagań wydajnościowych można zaplanować instalację aplikacji webowej na farmie serwerów. Instalowanie Platformy AMODIT przebiega w kilku krokach. Wykonanie ich zgodnie z zaleceniami umożliwi bezproblemową instalację. Czynności należy wykonać w podanej kolejności:

1. Przygotowanie serwerów do instalacji.
2. Pobranie i rozpakowanie paczki instalacyjnej.
3. Instalacja AMODIT Database Administrator.
4. Instalacja bazy danych Platformy AMODIT
5. Instalacja bazy danych do obsługi Text miningu
6. Utworzenie aplikacji webowej pod IIS
7. Kopiowanie plików aplikacji i konfigurowanie aplikacji webowej
8. Czynności po instalacyjne.
9. Częste problemy związane z instalacją.

Przygotowanie serwerów do instalacji

Przed przystąpieniem do instalacji zapoznaj się z artykułami:

• przygotowanie serwera aplikacyjnego do instalacji
• przygotowanie serwera bazy danych do instalacji

Upewnij się, że wszystkie zalecane w nich czynności zostały wykonane. Pozwoli to na płynne wykonanie procesu instalacji. Przemyśl jakie konta użyjesz do tworzenia bazy danych oraz jakie konto będzie kontem do łączenia się aplikacji AMODIT z bazą danych.

Powrót na górę

Pobranie i rozpakowanie paczki instalacyjnej

1. Zaloguj się na serwer aplikacyjny, na którym chcesz zainstalować Platformę AMODIT.
2. Pobierz paczkę instalacyjną z najnowszą wersją Platformy AMODIT. Link do paczki instalacyjnej znajdziesz tutaj.
3. Rozpakuj ją do wybranego katalogu. Przykładowo niech to będzie katalog c:\Install:

   

4. Powstaną dwa folder amoditapps oraz amoditdeploy.

Powrót na górę

Instalacja AMODIT Database Administrator

1. Z katalogu amoditapps, uruchom program Setup.

   

2. Wybierz Next.

   

3. Zaznacz Everyone. Wskaż folder instalacyjny. Zalecane jest pozostawienie folderu domyślnego.
4. Wybierz Next.

   

5. Ponownie wybierz Next.

   

6. Poczekaj, aż proces instalacji zakończy się.

   

7. Wybierz Close.
8. Na pulpicie powinna pojawić się ikona

   

Powrót na górę

Instalacja bazy danych Platformy AMODIT

Zapoznaj się z artykułem Przygotowanie serwera bazy danych do instalacji.

1. Uruchom AMODIT Database Admin
2. System poinformuje, że nie zostało jeszcze skonfigurowane żadne połączenie do bazy danych

   

3. Wybierz OK.
4. Uruchomi się okno aplikacji AMODIT Database Admininistrator

   

5. Wybierz Add new organization

   

6. Wybierz typ silnika bazy danych MySQL lub MS SQL Server
7. System użyje domyślnej wartości dla pola Port. Dla MySQL będzie to wartość 3306, a dla MS SQL Server 1433. Możesz wskazać inne wartości, jeżeli wynika to z konfiguracji środowiska, w którym instalowana jest Platforma AMODIT.
8. W polu Database server wpisz nazwę serwera bazy danych. Możesz również wskazać serwer za pomocą adresu IP.
9. W polu Database name pozostaw nazwę AMODIT. Pod tą nazwą zostanie utworzona baza dla Platformy AMODIT.
10. W sekcji AMODIT database user wskaż konto, za pomocą którego aplikacja AMODIT będzie komunikowała się z bazą danych. W zależności od okoliczności:
    1. Wprowadź nazwę użytkownika oraz hasło. Użytkownik o podanej nazwie nie musi istnieć w bazie danych. Zostanie on założony w dalszym procesie zakładania bazy danych. Przykładowo może to być nazwa amodit_user.
    2. W przypadku bazy MS SQL Server możesz zaznaczyć integrated authentication. System użyje konta, na którym jesteś obecnie zalogowany.
11. W sekcji Database administrator user wskaż konto, za pomocą którego aplikacja AMODIT Database Administrator utworzy bazę danych. Konto to będzie użyte tylko podczas tworzenia bazy danych. W zależności od okoliczności:
    1. Wprowadź nazwę użytkownika oraz hasło. Konto musi istnieć na serwerze bazodanowym. Użytkownik ten musi mieć uprawnienia co najmniej dbcreator. Możesz użyć standardowego konta administracyjnego. Dla MySQL jest to root, a dla MS SQL Server konto sa.
    2. W przypadku bazy MS SQL Server możesz zaznaczyć integrated authentication. System użyje konta, na którym jesteś obecnie zalogowany. Konto to musi mieć uprawnienia co najmniej dbcreator.
12. Wybierz Create. Proces zakładania bazy może potrwać kilka do kilkunastu minut. Jeżeli wszystko przebiegnie pomyślnie, to powinieneś otrzymać komunikat jak poniżej.

    

13. AMODIT od wersji 2016.0006 korzysta z nowego silnika wyszukiwani pełnotekstowego. W tym miejscu instalacji musisz podać folder na serwerze aplikacyjnym, w którym AMODIT będzie zapisywał pliki indeksujące. Proponujemy utworzyć folder c:\amodit i w nim folder \lucene i tę ścieżkę podać w tym momencie instalacji czyli przykładowo c:\amodit\lucene i kliknąć Configure.
14. Instalator dokończy proces instalacji i powinieneś otrzymać komunikat jak na poniższym ekranie.

    

15. Wybierz OK.

    

16. Nowa organizacja o nazwie amod (numer) została utworzona, co widać w lewym okienku.
17. Zamknij okno aplikacji AMODIT Database Administrator.

    

18. Baza danych została utworzona. Utworzony został również użytkownik wskazany w punkcie 10 powyżej. Przykład dla MySQL.

    

Powrót na górę

Utworzenie aplikacji webowej pod IIS

1. Uruchom Menedżera usług IIS.
2. Rozwiń drzewo w lewym oknie, kliknij prawym przyciskiem myszy na węźle Witryny.

   

3. Wybierz Dodaj witrynę sieci Web.

   

4. W oknie dialogowym w polu Nazwa witryny wpisz AMODIT.
5. Kliknij przycisk [….] po prawej stronie pola Ścieżka fizyczna. Wyszukaj katalog c:\inetpub i stwórz w nim katalog o nazwie np. \AMODIT
6. W polu Port podaj nieużywany numer portu np. 81. Jeżeli na serwerze będzie tylko witryna AMODIT, to możesz zatrzymać domyślną witrynę Default Web Site i użyć portu 80.
7. Kliknij OK.

   

8. Kliknij na węzeł Pule aplikacji.

   

9. Kliknij na pulę AMODIT, z dostępnych Akcji wybierz Ustawienia zaawansowane…

   

10. Ustaw wersję .NET Framework na 4.0
11. Ustaw tożsamość na NetworkService (zobacz również uwagę odnośnie konta puli aplikacji w artykule Synchronizacja z Active Directory).
12. Należy pamiętać też o parametrze Load User Profile, parametr powinien być TRUE 

    

13. Kliknij OK.
14. Zamknij okno Menedżera IIS.

Powrót na górę

Kopiowanie plików aplikacji i konfigurowanie aplikacji webowej

W poprzednim kroku utworzyłeś aplikację i wskazałeś dla niej fizyczną ścieżkę. Jeżeli postępowałeś zgodnie z powyższym schematem, będzie to katalog  c:\inetpub\AMODIT.

1. Skopiuj do niego pliki z katalogu amoditdeploy (zobacz rozdział Pobranie paczki instalacyjnej)

   

2. Przejdź do katalogu c:\inetpub\AMODIT i odszukaj plik web.config.txt

   

3. Plik web.config dla zabezpieczenia ma rozszerzenie .txt, Rozszerzenie należy usunąć tak, aby plik nazywał się web.config. Jeżeli nie widzisz rozszerzeń plików, to  należy zmienić sposób wyświetlania zgodnie z używanym systemem Windows. Przykładowo w Windows 7 – wybierz Organizuj -> Opcje folderów i wyszukiwania -> Widok  i odznacz opcję Ukryj rozszerzenie znanych typów plików.

4. 

5. Potwierdź przyciskiem TAK.

   

6. Musisz mieć uprawnienia administratora. Wybierz Kontynuuj.
7. Uruchom Menedżera usług IIS.
8. Instalacja została zakończona.
9. Kliknij prawym przyciskiem myszy na witrynie AMODIT.

   

10. Wybierz Zarządzaj witryną sieci Web i następnie Przeglądaj.

    

11. Jeżeli wszystko przebiegło bez problemów, to powinna uruchomić się Platforma AMODIT.
12. Jeżeli widzisz stronę z błędem to zapoznaj się z rozdziałem Częste problemy z instalacją AMODIT
13. Teraz musisz założyć pierwsze konto użytkownika. Pierwsze konto zawsze jest traktowane jako konto administracyjne. W tym celu wybierz link „Nie masz konta?„, a następnie Załóż konto.

    

14. Uzupełnij formularz
15. Wybierz Załóż konto.

    

16. Wróć do strony logowania i zaloguj się używając parametrów dla właśnie stworzonego konta administratora.

Powrót na górę

Czynności po instalacyjne

LibreOffice jako generator podglądu plików MS Office oraz generator plików MS Word i PDF z szablonów

Platforma AMODIT udostępnia podgląd dokumentów  MS Word, MS Excel, MS PowerPoint. Do tego celu korzysta z dodatkowego komponentu LibreOffice, który należy doinstalować.

1. Pobierz LibreOffice https://www.libreoffice.org/download/portable-versions/
2. Utwórz katalog roboczy, który będzie używany przez Platformę AMODIT do tworzenia plików tymczasowych, indeksów przeszukiwania itp. Przykładowo niech będzie to folder c:\amoditworking. UWAGA! Ścieżkę do tego katalogu należy wprowadzić w konfiguracji systemu za pomocą aplikacji AMODIT Database Admininistrator. Do katalogu należy nadać pełne uprawnienia dla konta użytkownika, na którym działa pula aplikacji webowej AMODIT i usługa AMODAsynchronousService.
3. Ustaw na folderze c:\amoditworking uprawnienie Modyfikacja dla konta używanego do uruchomienia puli aplikacji AMODIT (sprawdź w IIS).
4. Uruchom pobrany plik LibreOfficePortable_6.1.0_MultilingualAll.paf.exe. Wskaż jako katalog docelowy c:\amoditworking (ten utworzony w pkt 2.).

   UWAGA! Pakiet rozpakuje/zainstaluje się w podkatalogu LibreOfficePortable i tak należy to pozostawić.

5. Zaloguj się do Platformy AMODIT.
6. Przejdź do Ustawień systemowych na zakładkę USŁUGI i sekcji Wyszukiwanie pełnotekstowe w polu TmpSearchDir podaj katalog roboczy utworzony wcześniej np. c:\amoditworking. UWAGA! Jeżeli nie znajdujesz parametru TmpSearchDir w ustawieniach systemowych, to ścieżkę do tego katalogu należy wprowadzić w konfiguracji systemu za pomocą aplikacji AMODIT Database Admininistrator.
7. W szczególnych przypadkach, gdy zainstalujesz LibreOffice w innym katalogu niż katalog podany w TmpSearchDir, to musisz skonfigurować dodatkowe parametry w zakładce Interfejs użytkownika, sekcja Opcje dokumentów.
   1. w polu Office converter command: wpisz pełną ścieżkę prowadzącą do pliku wykonywalnego LibreOffice np. C:\amodittmp\LibreOfficePortable\App\libreofficeprogramsoffice.exe
   2. w polu Command attributes: wpisz dokładnie ten ciąg znaków zaczynając od dwóch myślników  –headless –convert-to pdf –outdir {1} {0}

Konfiguracja lokalnego OCR

W celu poprawnego działania mechanizmu lokalnego OCR należy go skonfigurować zgodnie z tym opisem: Konfiguracja lokalnego OCR.

Dodatkowe zabezpieczenia aplikacji AMODIT wynikające z testów bezpieczeństwa

Zalecenie związane z wykonaniem dodatkowych zabezpieczeń aplikacji webowej AMODIT w kontekście jej bezpieczeństwa opisane są w tym dokumencie: Dodatkowe zabezpieczenia aplikacji webowej amodit. A tak ogólnie, to warto wdrożyć zalecenia znajdujące się w sekcji „Bezpieczeństwo systemu” na zakładce „Dla administratorów”:

Powrót na górę

Częste problemy związane z instalacją

Błąd 500.19

Pojawienie się błędu o kodzie 500.19 przy próbie uruchomienia Platformy AMODIT oznacza, że nie jest uruchomiony .Net Framework dla .Net Framework 2.0 wykonaj poniższe czynności

1. Uruchomić cmd jako admin
2. Wpisać polecenie cd C:\Windows\Microsoft.NETFramework\v2.0.50727
3. Uruchomić aplikację z parametrem wpisując komendę  aspnet_regiis -i

Jeżeli wersja AMODIT wymaga NET Framework do wersji 4.5.2. to sprawdź, czy jest zainstalowana ta wersja .Net. Wersję instalacyjną możesz pobrać ze strony Microsoft. https://www.microsoft.com/pl-pl/download/details.aspx?id=42642

1. Uruchom konsolę cmd jako administrator i wykonaj polecenie:

   • C:\Windows\Microsoft.NETFramework64\v4.0.30319>aspnet_regiis -i

Could not load file or assembly Newtonsoft.Json

Jeżeli pojawi się błąd: Could not load file or assembly 'Newtonsoft.Json, Version=6.0.0.0, Culture=neutral, PublicKeyToken=30ad4fe6b2a6aeed’ or one of its dependencies. The located assembly’s manifest definition does not match the assembly reference. (Exception from HRESULT: 0x80131040) Trzeba znaleźć w web.config wiersz:

i zmienić na

Problemy z uruchomieniem usługi AMODAsynchronousService

Jeżeli występują problemy z uruchomieniem usługi AMODAsynchronousService, to należy sprawdzić, czy nie są one spowodowane przyczyną opisaną w tym artykule: Problemy po instalacji usługi AMODITAsynchronousService.

„Dziwny” formularz logowania do systemu

Czasami po instalacji systemu AMODIT podczas uruchamiania strony startowej systemu można zaobserwować dziwnie wyglądający formularz logowania, np. jak na poniższym obrazku.

Problemem zazwyczaj jest brak uprawnień dla systemowych użytkowników procesu IIS do katalogów witryny AMODIT. Rozwiązaniem jest wykonanie kroków przedstawionych na poniższym obrazku:

• [0] Przejść „Menedżera internetowych usług informacyjnych (IIS)”.
• [1] Wybrać witrynę, dla której problem występuje.
• [2] Przejść do sekcji „Uwierzytelnianie” wybranej witryny i dla uwierzytelniania anonimowego …
• [3] … przejść do edycji jego konfiguracji.
• [4] Wybrać opcję „Tożsamość puli aplikacji”.

Powrót na górę