Instalacja – etapy początkowe
Instalację aplikacji serwerowej i WEB należy przeprowadzić na serwerze (komputerze) z zainstalowanym serwisem IIS (Internet Information Services).
W wersji 2023.0.0 wprowadzono nowe instalatory aplikacji web dla:
- Comarch DMS Standalone
- Comarch DMS we współpracy z Comarch ERP XL
- Comarch DMS we współpracy z Comarch ERP Optima
Od wersji 2023.0 istnieje również możliwość instalacji serwera bazodanowego Microsoft SQL Server Express z poziomu instalatora aplikacji web Comarch DMS (zob.Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch DMS). Z poziomu instalatora aplikacji web można także przejść bezpośrednio do instalatora aplikacji desktop Comarch DMS.
Aby uruchomić instalator Comarch DMS, w pobranym pakiecie instalacyjnym należy wejść do katalogu Comarch DMS [wersja] instalator Comarch DMS i uruchomić Instalator Comarch DMS.exe
Zostanie uruchomiony instalator aplikacji webowej, dzięki któremu możliwa jest:
- Instalacja koniecznych komponentów serwera IIS
- Konfiguracja puli na której będzie pracowała aplikacji Comarch DMS
- Instalacja i konfiguracja aplikacji Comarch DMS
- Aktualizacja aplikacji serwerowej i webowej Comarch DMS
- Instalacja serwera MongoDB (od wersji Comarch DMS 2024.2.0)
- Instalacja i aktualizacja aplikacji Comarch DMS Repozytorium (od wersji Comarch DMS 2024.2.0)
Wybór języka instalacji
Po uruchomieniu instalatora zostaje wyświetlone okno początkowe, w ramach którego dostępne jest pole „Język instalatora”, w którym należy dokonać wyboru języka, w jakim ma zostać przeprowadzona instalacja aplikacji. Dostępne są następujące języki:
- Polski
- Angielski
- Niemiecki
- Francuski
Po wyborze języka instalacji należy nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji, okna instalacji wymaganych dodatków. Jeżeli operator naciśnie przycisk [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony następujący komunikat:
Jeśli użytkownik wybierze przycisk:
- Tak – instalator zostanie zamknięty
- Nie – użytkownik pozostanie w tym samym oknie, a komunikat będzie zamknięty
Od wersji 2024.0.1 po przejściu do okna instalacji wymaganych dodatków wyświetlany jest komunikat, który informuje o braku możliwości instalacji Comarch DMS w systemach wcześniejszych niż:
- Windows Vista x64;
- Windows Server 2008 x64;
- Windows 7 x64
- Windows Server 2008 R2 x64
- Windows Server 2012 x64
Po kliknięciu w przycisk [OK] instalator zostaje zamknięty.
Okno przygotowania komponentów
W kolejnym kroku instalatora zostaje wyświetlone okno, informujące o tym, że instalator przygotowuje potrzebne komponenty. Przejście do następnego okna nastąpi automatycznie.
W następnym kroku instalatora wyświetlone zostaje okno powitalne instalatora.
Okno powitalne instalatora
Jeżeli użytkownik chce kontynuować instalację, wówczas powinien nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji. Jeżeli operator naciśnie przycisk [Anuluj] albo spróbuje zamknąć okno za pomocą znaku x, wówczas zostanie wyświetlony komunikat analogiczny do przedstawionego powyżej.
Wybór aplikacji
Po przejściu do okna Wybór aplikacji należy wybrać opcję Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium.
Jeżeli użytkownik nie ma zainstalowanego serwera MongoDB, a chce korzystać z modułu Comarch DMS Repozytorium, wówczas powinien wybrać opcję Instalacja serwera MongoDB i kliknąć [Dalej]. Dalsze kroki opisano w rozdziale Instalacja serwera Mongo DB za pomocą instalatora Comarch DMS .
Po kliknięciu przycisku [Dalej] użytkownik przechodzi do okna „Wybór aplikacji cd.”.
Wybór aplikacji cd.
W ramach okna „Wybór aplikacji cd.” operator może wybrać jedną z trzech opcji:
-
-
- Instalacja aplikacji Comarch DMS (zob. poniżej: Instalacja aplikacji Comarch DMS – aby instalować jedynie Comarch DMS;
- Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium (zob. poniżej: Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium) – aby instalować zarówno Comarch DMS, jak i Comarch DMS Repozytorium;
- Instalacja Comarch DMS Repozytorium – aby instalować jedynie Comarch DMS Repozytorium (zob. Instalacja Comarch DMS Repozytorium za pomocą instalatora).
-
Instalacja aplikacji Comarch DMS
Jeśli w oknie „Wybór aplikacji cd.” operator zaznaczył opcję „Instalacja aplikacji Comarch DMS”, a następnie [Dalej], wówczas następuje przejście do okna „Tryb pracy”.
Tryb pracy
W ramach okna Tryb pracy należy zaznaczyć opcję Standalone – ta opcja pozwala na zainstalowanie Comarch DMS bez zdefiniowanej współpracy
Po zaznaczeniu opcji należy kliknąć [Dalej], aby przejść do kolejnego kroku instalacji.
Warunki korzystania z oprogramowania
W ramach okna Warunki korzystania z oprogramowania należy zapoznać się z warunkami korzystania z oprogramowania Comarch DMS, zaznaczyć checkbox „Akceptuję warunki instalacji” i nacisnąć [Dalej], aby przejść do kolejnego etapu – przycisk nie jest aktywny, jeśli nie została zaznaczona zgoda na warunki instalacji.
Internetowe usługi informacyjne (IIS)
W kolejnym oknie Internetowe usługi informacyjne (IIS) następuje weryfikacja, czy na danym komputerze dostępny jest serwer IIS. Jeżeli:
Serwer IIS nie jest dostępny - wyświetlana jest informacja „ Serwer IIS nie jest dostępny na tym komputerze” i nie jest możliwe przejście do kolejnego etapu instalacji.
W takim wypadku użytkownik może:
- Nacisnąć przycisk [Zainstaluj IIS] – nastąpi wówczas instalacja IIS. Podczas instalacji wyświetlany jest komunikat „ Trwa instalacja serwera IIS”. Po zakończonej instalacji przycisk „Zainstaluj IIS” zostaje wyszarzony i wyświetlany jest napis „Serwer IIS został poprawnie zainstalowany”.
- Pozostawić otwarte okno instalatora Comarch DMS, zainstalować ręcznie IIS, a potem kliknąć [Odśwież]
- Zamknąć instalator za pomocą przycisku [Anuluj] lub znaku x, wykonać ręczną instalację IIS i ponownie przejść przez kolejne kroki instalatora do okna „Internetowe usługi informacyjne (IIS)”
Po zastosowaniu jednego z powyższych sposobów możliwe będzie przejście do kolejnego kroku instalacji aplikacji web Comarch DMS za pomocą przycisku [Dalej]
Serwer IIS jest dostępny – wyświetlana jest informacja „ Serwer IIS został poprawnie zainstalowany” i należy przejść do kolejnego kroku, klikając przycisk [Dalej].
Wymagane dodatki
Po kliknięciu przycisku [Dalej], następuje przejście do następnego okna, w ramach którego następuje instalacja dodatków wymaganych dla poprawnego działania Comarch DMS.
W ramach pola dostępnego w prawej części okna dostępne są następujące kolumny:
- Name – zawiera nazwę danego dodatku
- Required – zawiera numer wymaganej wersji danego dodatku
- Found – zawiera numer wersji danego dodatku zainstalowanej już na komputerze
- Action – zawiera nieaktywny przycisk Pomiń¬¬ – jeśli na komputerze jest już odpowiednia wersja i dany dodatek nie wymaga instalacji, wówczas jego instalacja zostanie automatycznie pominięta
Aby zainstalować wymagane dodatki i przejść do następnego okna należy nacisnąć przycisk [Dalej].
Wybór puli aplikacji
Na kolejnym kroku, w oknie Pula aplikacji należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS – w tym celu należy:
- Wybrać pulę aplikacji z listy znajdującej się po prawej stronie okna, klikając na nią
lub
- Dodać nową pulę aplikacji –wpisać nazwę puli, która ma zostać utworzona, w polu „„Nazwa nowej puli aplikacji”, a następnie nacisnąć przycisk [Dodaj pulę]. Wybór puli zostaje automatycznie ustawiony na nowoutworzonej puli . Dodana w ten sposób pula spełnia wymagania konieczne do instalacji aplikacji DMS.
Kiedy operator wybrał pulę aplikacji z listy albo dodał nową pulę i ją zaznaczył, wówczas następuje sprawdzenie, czy pula spełnia konieczne wymagania. Jeśli pod listą pul aplikacji zostanie wyświetlony komunikat:
- Wybrana pula spełnia wymagania instalowanej aplikacji – można przejść do dalszego kroku instalacji Comarch DMS
- Wybrana pula nie spełnia wymagań instalowanej aplikacji – przed kontynuacją instalacji Comarch DMS należy wybrać inną pulę spełniającą wymagania lub dodać nową
- Wybrana pula jest zatrzymana. Przed uruchomieniem aplikacji należy uruchomić pulę w Menedżerze IIS. – przed kontynuacją instalacji Comarch DMS należy uruchomić pulę aplikacji
- Pula o tej nazwie już istnieje. – przed kontynuacją instalacji Comarch DMS należy wybrać inną pulę spełniającą wymagania lub dodać nową o innej nazwie
Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].
Kreowanie aplikacji serwerowej
W tym oknie następuje konfiguracja aplikacji serwerowej (webowej starszego typu). W ramach okna Kreowanie aplikacji serwerowej użytkownik:
- w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
- w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
- w polu „Wprowadź nazwę aplikacji serwerowej” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSapi
- \
- ?
- ;
- :
- @
- (spacja)
- =
- +
- $
- „
- |
- ”
- <
- >
- *
Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.
W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].
Następnie należy kliknąć przycisk [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”. Przycisk [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.
Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Nazwa witryny” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.
Operator ma także opcję dodania nowej witryny, na której utworzy aplikację serwerową. W tym celu powinien:
- W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny
Następnie operator powinien nacisnąć przycisk [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.
Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].
Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].
Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.
Kreowanie aplikacji WEB
W tym oknie następuje konfiguracja aplikacji webowej z nowym interfejsem. W ramach okna Kreowanie aplikacji WEB użytkownik:
- w polu „Wybierz lub utwórz witrynę web” – z listy dostępnych witryn wybiera witrynę, w której ma zostać utworzona aplikacja;
- w polu „Port” – wpisuje numer portu, który przypisany jest do danej witryny;
- w polu „Wprowadź nazwę aplikacji WEB” – wpisuje nadaną przez siebie nazwę aplikacji, np. DMSweb.
- \
- ?
- ;
- :
- @
- (spacja)
- =
- +
- $
- „
- |
- ”
- <
- >
- *
Jeżeli użytkownik wpisze nazwę zawierającą jeden lub więcej z powyższych znaków, wówczas nowa aplikacja nie zostanie utworzona, a w dolnej części okna pojawi się informacja o zakazanych znakach specjalnych.
W takim wypadku użytkownik powinien zmodyfikować nazwę wpisaną w polu „Nazwa aplikacji” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].
Następnie należy kliknąć przycis k [Utwórz aplikację], aby nowa aplikacja została utworzona. Podczas tworzenia aplikacji w dolnej części okna widoczna jest informacja „Trwa kreowanie aplikacji”. Jeżeli utworzenie aplikacji przebiegło pomyślnie, wówczas wyświetlana jest informacja „Aplikacja została utworzona pomyślnie”.
Przycisk [Utwórz aplikację] nie jest aktywny do czasu wybrania witryny i wpisania nazwy aplikacji przez użytkownika.
Jeżeli podczas tworzenia aplikacji nastąpił błąd, wyświetlona zostanie informacja „Nie udało się utworzyć aplikacji”. W takim przypadku użytkownik powinien zmienić witrynę w polu „Wybierz lub utwórz witrynę web” i ponownie kliknąć [Utwórz aplikację] albo opuścić instalator, a następnie ponownie przeprowadzić instalację.
Operator ma także opcję dodania nowej witryny, na której utworzy aplikację WEB. W tym celu powinien:
- W polu „Wybierz lub utwórz witrynę web” wpisać nazwę witryny, która ma zostać utworzona;
- W polu „Port” wpisać numer portu, który ma zostać przypisany do nowoutworzonej witryny
Następnie operator powinien nacisnąć przycisk [Utwórz witrynę]. Jeśli tworzenie witryny zakończyło się powodzeniem, wówczas w dolnej części okna wyświetlany jest napis Witryna została utworzona na serwerze IIS.
Jeśli operator wpisze w polu Wybierz lub utwórz witrynę web nazwę witryny, która już istnieje, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Witryna o tej nazwie już istnieje. W takim przypadku należy wprowadzić inną, nieistniejącą do tej pory nazwę witryny i ponownie kliknąć [Utwórz witrynę].
Analogicznie, jeżeli operator wpisze w polu Port numer portu, który jest już wykorzystywany, i kliknie [Utwórz witrynę], wówczas witryna nie zostanie utworzona, a w dolnej części okna widoczna będzie informacja Port jest już użyty przez inną witrynę. W takim przypadku należy wprowadzić inny, nieużywany do tej pory numer portu i ponownie kliknąć [Utwórz witrynę].
Aby przejść do kolejnego kroku instalacji należy wybrać przycisk [Dalej]. Przycisk nie jest aktywny dopóki aplikacja nie została utworzona.
Opcje instalacji
W następnym oknie Opcje instalacji w ramach pola „Domyślny język instalowanej aplikacji” wybierany jest język, w którym wyświetlana będzie domyślnie aplikacja Comarch DMS.
Dostępne są również dwa parametry:
-
- Opcja zmiany języka na ekranie logowania do aplikacji – jeżeli parametr zostanie zaznaczony, wówczas na ekranie logowania dostępny będzie link [aplikacja desktop] lub [aplikacja serwerowa], po kliknięciu w który możliwy jest wybór z listy jednego z czterech języków aplikacji: polskiego, angielskiego, niemieckiego lub francuskiego.
- Wymagaj przestrzegania polityki mocnych haseł – domyślnie zaznaczony parametr; sprawia, że hasła ustawiane w aplikacji muszą spełniać określone warunki:
- Składać się co najmniej z 8 znaków
- Zawierać wielkie i małe litery
- Zawierać znak specjalny
- Wersja Premium – opcja domyślnie zaznaczona; funkcjonalność modelowania procesów za pomocą kodu C#
Po ustawieniu parametrów należy kliknąć na przycisk [Dalej], aby kontynuować instalację.
Tworzenie bazy danych Comarch DMS
Po przejściu do okna „Baza danych Comarch DMS” należy poprawnie uzupełnić pole „Nazwa serwera”, a następnie wybrać typ logowania:
-
-
- Logowanie zintegrowane
-
lub
-
-
- Logowanie SQL – jeśli wybrano tę opcję, należy podać:
- W polu „Nazwa użytkownika” – nazwę użytkownika logującego się do serwera SQL – np. sa
- W polu „Hasło” – hasło użytkownika logującego się do serwera SQL
-
Następnie należy nacisnąć przycisk [Połącz], aby połączyć się z serwerem SQL. Jeżeli połączenie zostało nawiązane, w dolnej części okna pojawi się napis „Nawiązano połączenie z serwerem SQL”.
Jeśli nawiązano połączenie z serwerem, użytkownik powinien kliknąć przycisk [Zmień hasło]
Zostaje wówczas wyświetlone okno, w którym należy uzupełnić hasło dla użytkownika ODUser, który dodawany jest do serwera SQL podczas pierwszej instalacji Comarch DMS. Hasło musi być silne, to znaczy:
-
-
- Składać się z min. 12 znaków
- Zawierać cyfry
- Zawierać małe i wielkie litery;
- Zawierać znaki specjalne.
-
- ;
- ’
- „
Jeżeli wpisano hasło, które nie spełnia któregoś z tych trzech wymagań, wówczas po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:
-
-
- Jeśli hasło jest za krótkie
-
-
-
- Brakuje warunku/warunków wymaganych dla silnego hasła (np. brak znaku specjalnego, brak wielkiej litery)
-
Należy zmienić hasło, tak, aby spełniało wszystkie warunki.
Jeśli natomiast hasło wpisane w polu „Powtórz hasło” różni się od hasła wpisanego w polu „Hasło”, wtedy po kliknięciu przycisku [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:
Należy uzupełnić pole „Powtórz hasło” tak, aby zgadzało się z polem „Hasło”.
Kiedy pola zostały poprawnie uzupełnione, a użytkownik nacisnął przycisk [Zapisz], okno zmiany hasła dla ODUsera zostaje zamknięte, a hasło użytkownika ODUser zostało zmienione.
Hasło zostanie również wpisane do wszystkich „connection string” znajdujących się w pliku web.config aplikacji WWW. Jeżeli definiujemy połączenia bazodanowe w trybie wielospółkowym, należy pamiętać, aby nowe hasło podać we wszystkich połączeniach definicji spółek.
W przypadku aktualizacji Comarch DMS instalator wymusza ustawienie hasła operatora ODUser. Hasło może zostać zmienione (zalecane), ale można również wprowadzić aktualne hasło. Przy zmienionym haśle i włączonym trybie wielospółkowym należy nowe hasło ustawić we wszystkich konfiguracjach wielospółkowych połączeń do baz danych. W przypadku instalacji kilku aplikacji Comarch DMS, korzystających z jednego MS SQL Serwera, przy zmianie hasła podczas instalacji należy pamiętać, aby zmienione hasło dla ODUser zmienić w plikach web.config oraz w konfiguracji spółek, jeżeli aplikacje pracują w trybie wielospółkowym.
Następnie użytkownik powinien nacisnąć przycisk [Dodaj bazę]. Wtedy zostanie otwarte okno, w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS, a następnie kliknąć [Zapisz]. Jeżeli użytkownik nie chce jednak dodać nowej bazy, wtedy powinien nacisnąć przycisk [Anuluj] albo znak X.
Po naciśnięciu przycisku [Zapisz] baza Comarch DMS zostaje dodana i w ramach instalatora wyświetla się informacja „ Baza danych DMS została utworzona”.
Gdy baza danych została dodana, wówczas należy kliknąć przycisk [Uruchom skrypty] w celu przygotowania bazy Comarch DMS do pracy. Kiedy wykonywanie skryptów zakończyło się sukcesem, wyświetlona zostaje informacja „Skrypty SQL zostały wykonane pomyślnie”, a użytkownik może nacisnąć przycisk [Dalej], aby przejść do kolejnego kroku instalacji, okna "Klucze licencji".
Klucze licencji
W ramach okna „Klucze licencji” należy w polu „Serwer klucza licencji Comarch DMS” wpisać klucz licencji Comarch DMS zgodnie z wzorem nazwa_serwera_klucza::numer_klucza
Jeśli użytkownik ma tylko jeden klucz licencyjny, wówczas wystarczy wpisać nazwę serwera klucza licencji, zaś wpisanie numeru klucza jest opcjonalne.
Jeśli jednak użytkownik posiada na danym serwerze więcej kluczy licencji, wówczas wpisanie numeru klucza jest wymagane.
Instalacja aplikacji web Comarch DMS Standalone
Po uzupełnieniu klucza licencji i kliknięciu [Instaluj] następuje przejście do następnego okna i rozpoczyna się instalacja Comarch DMS Standalone.
Koniec pracy instalatora
Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji web Comarch DMS. Gdy użytkownik kliknie przycisk [Zakończ], instalator zostanie zamknięty, natomiast zostanie otwarta przeglądarka na ekranie logowania do nowej aplikacji WEB Comarch DMS, zgodnie z nazwą aplikacji, którą podano w instalatorze.
Jeśli podczas próby uruchomienia aplikacji serwerowej (dawna web) pojawia się komunikat ”Błąd http 500.19 – Internal Server Error’’ - sprawdź tutaj