Instalacja Platformy AMODIT dla wersji 2016.0004 lub nowszych

Ostatnia modyfikacja Wrzesień 24, 2018

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 8.1, Windows 8 oraz Windows 7  z użyciem serwera IIS.

Jeżeli instalujesz wersję o numerach typu 2.9.1 lub wersję wcześniejszą niż wersja 2016.0004 to skorzystaj z instrukcji dostępnej pod tym linkiem.

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.

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:

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. Wskazówki znajdziesz w artykule Przygotowanie serwera bazy danych do instalacji.
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.
    setup1
  2. Wybierz Next.
    setup2
  3. Zaznacz Everyone. Wskaż folder instalacyjny. Zalecane jest pozostawienie folderu domyślnego.
  4. Wybierz Next.
    setup3
  5. Ponownie wybierz Next.
    setup4
  6. Poczekaj, aż proces instalacji zakończy się.
    setup5
  7. Wybierz Close.
  8. Na pulpicie powinna pojawić się ikona
    setup6

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 danychsetup7
  3. Wybierz OK.
  4. Uruchomi się okno aplikacji AMODIT Database Admininistrator
    setup8
  5. Wybierz Add new organization
    setup9
  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:amoditlucene i kliknąć Configure.
  14. Instalator dokończy proces instalacji i powinieneś otrzymać komunikat jak na poniższym ekranie.
    setup10
  15. Wybierz OK.
    setup11
  16. Nowa organizacja o nazwie amod (numer) została utworzona, co widać w lewym okienku.
  17. Zamknij okno aplikacji AMODIT Database Administrator.
    setup12
  18. Baza danych została utworzona. Utworzony został również użytkownik wskazany w punkcie 10 powyżej. Przykład dla MySQL.
    setup13

Powrót na górę

Instalowanie bazy danych obsługującej Text Mining.

W celu prawidłowego działania i korzystania z funkcji Text mining niezbędne jest zainstalowanie specjalnej bazy do obsługi tej funkcjonalności.

  1. Ponownie uruchom AMODIT Database Administrator w celu utworzenia bazy dla Text Mining.
  2. Kliknij przycisk AMODDC.
    setup14
  3. Wpisz hasło dla konta administratora bazy danych
    setup15
  4. Po instalacji wybierz OK.
  5. Zamknij okno aplikacji AMODIT Database Administrator.
  6. Instalacja bazy danych została zakończona.

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.
    setup16
  3. Wybierz Dodaj witrynę sieci Web.
    setup17
  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.
    setup18
  8. Kliknij na węzeł Pule aplikacji.
    setup19
  9. Kliknij na pulę AMODIT, z dostępnych Akcji wybierz Ustawienia zaawansowane…
    setup20
  10. Ustaw wersję .NET Framework na 4.0
  11. Ustaw tożsamość na NetworkService.
  12. Kliknij OK.
  13. 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:inetpubAMODIT.

  1. Skopiuj do niego pliki z katalogu amoditdeploy (zobacz rozdział Pobranie paczki instalacyjnej)
    setup21
  2. Przejdź do katalogu c:inetpubAMODIT i odszukaj plik web.config.txt
    setup22
  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. setup23
  5. Potwierdź przyciskiem TAK.
    setup24
  6. Musisz mieć uprawnienia administratora. Wybierz Kontynuuj.
  7. Uruchom Menedżera usług IIS.
  8. Wskaż i rozwiń zawartość witryny AMODIT
  9. Na katalogu excelsync kliknij prawym przyciskiem i wybierz Konwertuj na aplikację.
    setup25
  10. Czynność powtórz dla katalogów sharedservices i webdav.
  11. Instalacja została zakończona.
  12. Kliknij prawym przyciskiem myszy na witrynie AMODIT.
    setup26
  13. Wybierz Zarządzaj witryną sieci Web i następnie Przeglądaj.
    setup27
  14. Jeżeli wszystko przebiegło bez problemów, to powinna uruchomić się Platforma AMODIT.
  15. Jeżeli widzisz stronę z błędem to zapoznaj się z rozdziałem Częste problemy z instalacją AMODIT
  16. 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.
    setup28
  17. Uzupełnij formularz
  18. Wybierz Załóż konto.
    setup29
  19. 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

Platforma AMODIT udostępnia funkcje wyszukiwania pełnotekstowego również w treści załączanych dokumentów. W tym celu korzysta ze standardowych mechanizmów dostępnych w systemie Windows. Jednakże nie są one zawsze zainstalowane. Należy doinstalować następujące składniki:

W internecie można znaleźć inne filtry np. do obsługi plików DWG. Po zainstalowaniu będzie możliwe wyszukiwanie pełnotekstowe w dokumentach tego typu. Może to jednak wiązać się z koniecznością zakupu odpowiedniego filtru. Zobacz np tutaj: http://www.ifiltershop.com/

LibreOffice jako generator podglądu oraz generator plików PDF (szablony)

Platforma AMODIT udostępnia podgląd dokumentów graficznych, PDF, 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
  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.)
  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
  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\libreoffice\program\soffice.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}

AMODITPDFWordConeverter  (od wersji 2017.0004 nieużywane)

Platforma AMODIT udostępnia podgląd dokumentów graficznych, PDF  oraz MS Word . Do tego celu korzysta z dodatkowego komponentu, który również należy doinstalować.

  1. Pobierz plik AmoditPDFWordConverter
  2. Rozpakuj.
  3. 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
  4. Ustaw na folderze c:\amoditworking uprawnienie Modyfikacja dla konta używanego do uruchomienia puli aplikacji AMODIT (sprawdź w IIS). Jeżeli postępowałeś zgodnie z wcześniejszymi wskazówkami będzie to konto Usługa sieciowa (NetworkService). Jeżeli używasz innego konta do uruchamiania puli aplikacji, to pamiętaj że AMODITPDFWordConeverter wymaga aby konto, na którym działa pula aplikacji AMODIT było kontem z uprawnieniami administratorskimi na danym serwerze.
  5. Wgraj tam pliki z pobranego wyżej AmoditPDFWordConverter.zip
  6. Zaloguj się do Platformy AMODIT.
  7. 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

Powrót na górę

Częste problemy związane z instalacją

Błąd 500.19

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:WindowsMicrosoft.NETFrameworkv2.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:WindowsMicrosoft.NETFramework64v4.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:
<bindingRedirect oldVersion="0.0.0.0-8.0.0.0" newVersion="8.0.0.0" />
i zmienić na
<bindingRedirect oldVersion="0.0.0.0-9.0.0.0" newVersion="9.0.0.0" />
Powrót na górę