Instalacja Platformy AMODIT dla wersji starszych niż 2016.0004.

Ostatnia modyfikacja Sierpień 30, 2017

Jeżeli instalujesz wersję nowszą niż 2016.0004, to skorzystaj z instrukcji dostępnej pod tym linkiem.

 

Ten dokument poprowadzi Cię przez proces instalacji Platformy AMODIT 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.

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.
    setup10
  13. Proces zakładania bazy może potrwać kilka do kilkunastu minut. Jeżeli wszystko przebiegnie pomyślnie, to powinieneś otrzymać komunikat jak wyżej. 
  14. Wybierz OK. 

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

    setup12
  17. 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 2.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:\inetpub\AMODIT

  1. Skopiuj do niego pliki z katalogu amoditdeploy (zobacz rozdział Pobranie paczki instalacyjnej)
    setup21
  2. Przejdź do katalogu c:\inetpub\AMODIT i odszukaj plik web.config.txt
    setup22
  3. Platforma AMODIT standardowo jest przygotowana do obsługi wielu firm (organizacji). Jednakże w indywidualnej instalacji ta opcja jest zbędna i należy ją wyłączyć. W tym celu: 
    1. Otwórz plik web.config.txt do edycji w Notatniku.
    2. Wyszukaj sekwencję ChooseOrganizationModule. Powinieneś znaleźć dwa wystąpienia. kod będzie wyglądał tak:



    3. Usuń powyższe sekwencje.
    4. Zapisz plik.
  4. 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.
  5. setup23
  6. Potwierdź przyciskiem TAK.

    setup24
  7. Musisz mieć uprawnienia administratora. Wybierz Kontynuuj.
  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. 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
  16. Uzupełnij formularz
  17. Wybierz Załóż konto.

    setup29
  18. 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/

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

  1. Pobierz plik https://app.amodit.com/amod/doc/ghostview.zip
  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:\amodit_working
  4. Ustaw na tym folderze 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)
  5. Wgraj tam pliki z pobranego wyżej ghostview.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:\amodit_working

Powrót na górę

Częste problemy związane z instalacją

500.19

W przypadku pojawienia się błędu o kodzie 500.19 przy próbie uruchomienia Platformy AMODIT należy:

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

Powrót na górę