Aby program działał prawidłowo, konieczne jest ustawienie opcji regionalnych systemu na polskie.

 

W tym celu dla systemu Windows 8/ Windows 10 należy:

 

 

 

Uwaga

Opisane ustawienia to ustawienia na rynek polski. W przypadku stosowania Comarch DMS w innych krajach konieczne jest zastosowanie ustawień, które są rekomendowane przez firmę Microsoft dla danego kraju albo krajów.

System operacyjny dla serwera IIS

Silnik aplikacji Comarch DMS czyli aplikacje webową można zainstalować na następujących systemach operacyjnych:

 

Komponenty systemu IIS

Comarch DMS korzysta z następujących komponentów systemowych:

Serwer SQL

Comarch DMS może działać w oparciu o następujące wersje i edycje Microsoft SQL Server:

 

Uwaga

Podczas ręcznej instalacji silnika bazy danych  Microsoft SQL  Server należy zwrócić uwagę, aby po zaznaczeniu parametru „Windows collation designator and sort order” w polu „Collation designator” została wybrana wartość „Polish” oraz aby został  zaznaczony checkbox „Accent-sensitive”.

 

Prawidłowa konfiguracja parametru sortowania/porównywania znaków, widoczna w zakładce „Collation” to: POLISH_CI_AS

Jeżeli użytkownik będzie chciał dokonać zmiany ustawień w późniejszym terminie, może się okazać konieczna reinstalacja silnika bazy.

Opisane ustawienia to ustawienia na rynek polski. W przypadku stosowania Comarch DMS w innych krajach konieczne jest zastosowanie ustawień, które są rekomendowane przez firmę Microsoft dla danego kraju albo krajów.

 

Wymagane komponenty SQL

W przypadku instalacji ręcznej (z pominięciem instalatora), wymagane jest posiadania narzędzia sqlcmd.exe na stanowisku, na którym będzie uruchamiany plik install.bat. SQLCMD może być zainstalowane razem z Microsoft SQL Server Management Studio lub pobrane w ramach Microsoft® Command Line Utilities.

Uwaga

Zalecamy, aby serwer IIS, serwer SQL oraz serwer MongoDB były zainstalowane na osobnych maszynach.

Uwaga

W przypadku aplikacji mobilnych nie jest obsłużona praca na MacOS. Obsługujemy urządzenia z systemem iOS, czyli iPhony i iPady

 

Zalecane przeglądarki

Do pracy z modułem zalecane są przeglądarki:

 

Porty, które powinny zostać otwarte dla Comarch DMS

 

Zalecana konfiguracja sprzętowa serwera IIS

Wymagany sprzęt – zalecenia minimalne:

Zapewnienie możliwości rozbudowy:

Wymagane oprogramowanie serwera IIS

System operacyjny (jedna z poniższych możliwości):

Dodatkowe wymagania:

 

Wymagane licencje na oprogramowanie dla serwera IIS

Licencja na system operacyjny

Jeden z dostępnych rodzajów licencji:

Licencje klienckie (dostępowe) do serwera SQL

Liczba wymaganych licencji dostępowych powinna odpowiadać ilości użytkowników lub urządzeń posiadających dostęp do serwera IIS (logujących się do Comarch DMS). W związku z tym, w niektórych przypadkach bardziej korzystnym rozwiązaniem może okazać się zakup licencji „per Core”.

Wymagane licencje:

Ograniczenia i uwagi

 

Zalecana konfiguracja sprzętowa serwera SQL

Zalecaną konfiguracją współpracy Comarch DMS z serwerem MS SQL jest użycie serwera MS SQL przygotowanego dla ERP XL. W przypadku konfiguracji „Standalone” lub konfiguracji z wykorzystaniem dwóch serwerów MS SQL, zalecane wymagania sprzętowe zostały przedstawione poniżej.

Wymagany sprzęt – zalecenia minimalne:

 

Wymagane oprogramowanie SQL

System operacyjny:

Baza danych:

 

Uwaga

Możliwa jest również instalacja z wykorzystaniem serwera MS SQL Express. Należy pamiętać o ograniczeniach związanych z maksymalną wielkością bazy danych (max 10 GB) oraz maksymalną ilością alokowanej pamięci (max 1 GB).

 

Licencje:

Zalecana konfiguracja sprzętowa serwera MongoDB

(jeśli Comarch DMS ma aktywną współpracę z modułem Comarch DMS Repozytorium – zob. Comarch DMS – Repozytorium)

 

Wymagane oprogramowanie

(jeśli Comarch DMS ma aktywną współpracę z modułem Comarch DMS Repozytorium – zob. Comarch DMS – Repozytorium)

 

Uwaga

Repozytorium należy zainstalować na tej samej witrynie, na której znajduje się moduł Workflow (np. Default Web Site).

 

System operacyjny:

 

Uwaga

Możliwa jest instalacja także na innych systemach operacyjnych. Więcej informacji można znaleźć tutaj: Install MongoDB Community Edition — MongoDB Manual

 

Baza danych:

MongoDB Community version

Licencje:

Konieczny jest zakup licencji na: system operacyjny, licencji CAL systemu operacyjnego w przypadku
systemu Windows.

 

Rozwiązanie dedykowane pod jeden serwer MongoDB, zalecana ilość dokumentów to 6 mln.

 

Obciążenie serwera uruchomioną aplikacją DMS w sesji terminalowej.

Obciążenie na jedną sesje terminalową z uruchomioną aplikacją Comarch DMS:

Konfiguracja sprzętowa dla stacji roboczej

Wymagany sprzęt – zalecenia minimalne:

Wymagane oprogramowanie dla stacji roboczej

System operacyjny:

.Net Framework:

Wydajność systemu Comarch DMS

Wydajność Comarch DMS zależy w znacznym stopniu od złożoności realizowanych procesów, tj. od liczby kontrolek zdefiniowanych na karcie obiegu, wykorzystania mechanizmów inicjowania wartości kontrolek skryptami SQL i C# oraz od liczby kolumn zdefiniowanych na liście dokumentów.

Od wersji 2019.3 w Comarch DMS wprowadzono weryfikację zgodności wersji komponentów systemu. Podczas uruchamiania aplikacji desktop i web następuje weryfikacja zgodności numeru wersji:

1. Aplikacji web,
2. Aplikacji desktop,
3. Pliku web.config,
4. Pliku DMS.exe.config (lub pliku ObiegDokumentow.exe.config dla wersji wcześniejszych niż 2020.2.1),
5. Skryptów SQL,
6. Skryptów SQL XL,
7. Skryptów SQL Optima,
8. Skryptów SQL Altum.

W sytuacji, gdy weryfikacja wersji wykaże niezgodność, zamiast okna logowania do aplikacji zostanie wyświetlony komunikat.

 

Dla aplikacji stacjonarnej uruchomionej poprzez połączenie terminalowe udostępniono kanały wirtualne umożliwiające załączanie plików oraz skanów dokumentów ze skanera podpiętego do lokalnego komputera, na którym pracuje użytkownik.

W celu korzystania z kanałów wirtualnych niezbędne jest zainstalowanie na komputerze lokalnym, z którego uruchamiane jest połączenie terminalowe, paczki sterowników – OnlineFp.exe – Comarch ERP Sterowniki i usługi terminalowe.

Plik OnlineFp.exe dostępny jest w katalogu Sterowniki umieszczonym w katalogu instalacyjnym Comarch DMS.

W pliku DMS.exe.config udostępniono dwa klucze, z domyślnie ustawioną wartością „false”, oznaczającą, że kanały wirtualne są wyłączone.

W celu włączenia kanałów wirtualnych należy zmienić wartość na „true”.

Dla wersji Comarch DMS wcześniejszych niż 2020.2.1 klucze znajdują się w pliku ObiegDokumentow.exe.config.

 

 

Klucz VirtualChannelToLocalMachineFiles odpowiada za możliwość załączania plików z lokalnego komputera do aplikacji Comarch DMS uruchomionej na wirtualnej maszynie.

Gdy kanał wirtualny VirtualChannelToLocalMachineFiles jest włączony, nie ma możliwości dodawania załączników z katalogów umieszczonych na maszynie wirtualnej, wywoływane są wyłącznie okna z komputera lokalnego, na którym uruchomiono połączenie terminalowe.

Możliwe jest załączanie plików zarówno z lokalnego komputera jak i maszyny wirtualnej, o ile w opcjach podłączania pulpitu zdalnego udostępniono dyski komputera lokalnego. W takiej konfiguracji należy wartość klucza VirtualChannelToLocalMachineFiles ustawić na „false”.

Klucz VirtualChannelToLocalMachineScanner odpowiada za możliwość załączenia w aplikacji Comarch DMS uruchomionej na wirtualnej maszynie skanu dokumentu bezpośrednio ze skanera podłączonego do lokalnego komputera użytkownika.

Po wybraniu w kontrolce typu Załącznik opcji „Skan”, zostaje wyświetlone okno:

Funkcjonalność zrealizowana za pomocą sterowników OnlineFp pozwala na skanowanie jedno i wielostronicowe.

Skanowanie jednostronicowe pozwala zapisać obrazy w formatach: jpg, tif, pdf, png.

Skanowanie wielostronicowe pozwala zapisać pliki wyłącznie z rozszerzeniem tif.

Wybranie przycisku „Skan” uruchamia skanowanie na skanerze podpiętym do lokalnego komputera.

 

Z pobranego pliku instalacyjnego, do instalacji Comarch DMS należy wykorzystać:

1. Katalog do instalacji ręcznej – Comarch DMS {numer wersji}

lub

1. Katalog z instalatorem aplikacji, serwerowej, WEB i aplikacji desktop – Comarch DMS {numer wersji} instalator Comarch DMS

 

Uwaga

Instalator aplikacji desktop nie jest dostępny w wersji 2022.0.2

Podstawowym elementem systemu Comarch DMS jest aplikacja serwerowa. Dlatego w pierwszej kolejności procesu instalacji należy zainstalować aplikację serwerową, później aplikację WEB, a następnie skonfigurować aplikację stacjonarną.

Zalecamy przeprowadzenie instalacji aplikacji serwerowej, WEB oraz instalacji aplikacji desktop przy użyciu instalatora znajdującego się w katalogu Comarch DMS {numer wersji} instalator Comarch DMS. Istnieje również możliwość instalacji ręcznej.

Jeżeli użytkownik nie ma zainstalowanego Microsoft SQL, wtedy od wersji 2023.0.0 może dokonać instalacji darmowego Microsoft SQL Server Express za pomocą instalatora Comarch DMS.

Aby uruchomić instalator Comarch DMS, w pobranym pakiecie instalacyjnym należy wejść do katalogu Comarch DMS 2024.0.0 instalator Comarch DMS i uruchomić Instalator Comarch DMS.exe

Uwaga

Podczas instalacji za pomocą Instalatora (Instalator Comarch DMS.exe) potrzebny jest dostęp do Internetu.

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:

 

Po wyborze języka instalacji należy 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 następujący komunikat:

 

 

Jeśli użytkownik wybierze przycisk:

 

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.

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

Następnie w ramach okna Wybór aplikacji należy zaznaczyć opcję Microsoft SQL Server Express i kliknąć przycisk [Dalej].

 

 

Wtedy następuje przejście do instalatora, w ramach którego nastąpi zainstalowanie najnowszej wersji Microsoft SQL Server Express – zostaje otwarte okno „Serwer bazodanowy SQL”

 

Serwer bazodanowy SQL

W ramach okna „Serwer bazodanowy SQL” użytkownik może wybrać sposób logowania do serwera SQL:

Po wpisaniu hasła w obydwóch polach należy nacisnąć przycisk [Instaluj], aby przejść do następnego kroku instalacji. Przycisk jest nieaktywny do czasu poprawnego uzupełnienia pól.

 

 

Wskazówka

Jeśli wybrano logowanie za pomocą własnego hasła, to aby zalogować się do Microsoft QL Server Express konieczny będzie wybór opcji „SQL Server Authentication” i wpisanie sa w polu „Login” oraz określonego podczas instalacji hasła w polu „Hasło”.

 

 

 

Instalowanie

Po wyborze sposobu logowania do serwera SQL i kliknięciu przycisku [Instaluj] następuje  instalacja Microsoft SQL Server Express, wyświetlane jest także okno instalacji serwera.

 

 

Koniec pracy instalatora

Kiedy instalacja Microsoft SQL Server Express dobiegnie końca, wówczas nastąpi przejście do okna „Koniec pracy instalatora”, zaś okno instalacji serwera zamknie się automatycznie. Aby wyjść z okna, należy wybrać przycisk „Zakończ”.

 

 

Następnie należy zainstalować aplikacje: serwerową (dawną web) i  WEB (nową web) Comarch DMS jak opisano w artykule:

 

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.

 

Uwaga

Instalacje wersji WWW nie są zalecane na stacjach roboczych. Instalacja powinna być przeprowadzona na dedykowanym serwerze.

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:

 

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:

 

 

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:

 

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ż:

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.

 

Uwaga

Jeżeli użytkownik nie ma zainstalowanego serwera SQL, wówczas przed przystąpieniem do instalacji aplikacji web powinien wybrać opcję Instalacja Microsoft SQL Server Express i kliknąć [Dalej]. Dalsze kroki opisano w artykule Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch DMS.

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 oraz Comarch DMS Repozytorium

Jeśli w oknie „Wybór aplikacji cd.” operator zaznaczył opcję „Instalacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium”, 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:

 

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:

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:

 

 

 

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:

 

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].

 

Kreowanie aplikacji serwerowej

Uwaga

Od wersji 2024.3.0 podczas instalacji Comarch DMS za pomocą instalatora użytkownikowi IIS_IUSRS zostają nadane pełne uprawnienia na folderze aplikacji serwerowej.

Uwaga

Aplikacje: serwerowa i web powinny znajdować się na tej samej witrynie.

W tym oknie następuje konfiguracja aplikacji serwerowej (webowej starszego typu). W ramach okna Kreowanie aplikacji serwerowej użytkownik:

 

Uwaga

Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

• \
• ?
•  ;
• :
• @
• (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:

 

 

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

Uwaga

Aplikacje: serwerowa i web powinny znajdować się na tej samej witrynie.

W tym oknie następuje konfiguracja aplikacji webowej z nowym interfejsem. W ramach okna Kreowanie aplikacji WEB użytkownik:

 

Uwaga

Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

• \
• ?
•  ;
• :
• @
• (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:

 

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:

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:

 

 

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:

 

Uwaga

Hasło nie może również zawierać następujących znaków :

• ;
• ’
• „

 

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:

 

 

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.

 

Uwaga

Operator ODUser jest wspólnym operatorem dla wszystkich instalacji Comarch DMS realizowanych w ramach jednego serwera MS SQL.

 

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”.

 

Uwaga

Jeśli użytkownik instaluje Comarch DMS po raz pierwszy, ma tylko możliwość dodania nowej bazy dla DMS – nie może dokonać wyboru z listy istniejących baz, jak w poprzednim instalatorze.

 

Uwaga

Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).

 

 

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 "Pula aplikacji Comarch DMS Repozytorium".

 

Pula aplikacji Comarch DMS Repozytorium

W ramach okna „Pula aplikacji Comarch DMS Repozytorium” należy określić, na jakiej puli aplikacji ma pracować aplikacja Comarch DMS Repozytorium– w tym celu należy:

 

 

 

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji , klikając przycisk   [Dalej].

 

Kreowanie aplikacji Repozytorium

Następnie w dodanym w wersji 2024.2.0 oknie Kreowanie aplikacji Repozytorium następuje konfiguracja aplikacji dla modułu Comarch DMS Repozytorium.

Uwaga

W wersji 2024.2.2 w Comarch DMS Repozytorium wprowadzono szyfrowanie connection stringów znajdujących się w pliku appsettings.json w folderze z plikami Comarch DMS Repozytorium.

 

W ramach okna Kreowanie aplikacji Repozytorium użytkownik:

 

Uwaga

Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

• • • \
    • ?
    • ;
    • :
    • @
    • (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.

 

Operator ma również opcję dodania nowej witryny, na której utworzy aplikację Comarch DMS Repozytorium, jednakże zaleca się, aby aplikację Comarch DMS Repozytorium zainstalować na tej samej witrynie, na której zainstalowano moduł Workflow Comarch DMS.

Aby jednak utworzyć nową witrynę operator powinien:

 

 

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.

 

Aby przejść do kolejnego kroku instalacji należy wybrać przycisk   [Dalej]. Przycisk nie jest aktywny, dopóki aplikacja nie została utworzona.

 

Baza danych Comarch DMS Repozytorium

Następnie w ramach okna „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:

Następnie należy sprawdzić poprawność wprowadzonych danych, klikając w przycisk [Połącz].

Jeśli próba nawiązania połączenia zakończyła się powodzeniem, w dolnej części okna wyświetlony zostaje napis „Nawiązano połączenie z serwerem MongoDB”.

Uwaga

Dane uwierzytelniające operatora są niezbędne do przeprowadzenia procesu instalacji i są wykorzystywane wyłącznie podczas pracy instalatora.

 

 

Następnie operator powinien wybrać bazę w ramach pola „Lista baz danych” (jeśli wcześniej przygotowano bazę przeznaczoną dla Comarch DMS Repozytorium) albo nacisnąć przycisk [Dodaj bazę], aby utworzyć nową bazę danych dla aplikacji Comarch DMS Repozytorium.

Jeżeli operator kliknął w przycisk [Dodaj bazę], wówczas zostaje otwarte okno w ramach którego należy wprowadzić nazwę nowej bazy danych Comarch DMS Repozytorium, 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 Repozytorium zostaje dodana i w ramach instalatora wyświetla się informacja „ Baza danych została utworzona”.

 

Następnie operator powinien nacisnąć przycisk [Zmień hasło].

W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser serwera MongoDB, za którego pośrednictwem będzie odbywać się komunikacja aplikacji Comarch DMS Repozytorium z bazą danych. Hasło należy następnie wpisać ponownie w polu „Powtórz hasło”, a później kliknąć przycisk „Zapisz”.

Hasło powinno spełniać następujące warunki:

 

Uwaga

Login ani hasło nie mogą zawierać następujących znaków:

• :
• /
• ?
• #
• [
• ]
• @
• !

Od wersji 2024.2.2 można używać powyższych znaków w ramach loginu i/lub hasła.

Nie należy natomiast używać spacji w loginie ani w haśle.

 

 

Jeżeli wpisano hasło, które nie spełnia któregoś z tych czterech wymagań, wówczas po kliknięciu przycisku   [Zapisz] hasło nie zostaje zapisane i wyświetlany jest komunikat:

 

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 MongoUsera zostaje zamknięte, a hasło użytkownika MongoUser zostaje zmienione. Następnie operator powinien kliknąć  [Dalej].

 

Klucze licencji

Po kliknięciu w przycisk  [Dalej] następuje przejście do okna „Klucze licencji”. Operator powinien uzupełnić:

 

Instalacja

Po uzupełnieniu pól operator powinien kliknąć [Instaluj]. Następuje wówczas przejście do kolejnego okna „Instalacja”.

 

Koniec pracy instalatora

Po zakończeniu instalacji następuje przejście do końcowego okna instalacji aplikacji. 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.

Dalsze kroki dotyczące konfiguracji Comarch DMS Repozytorium należy wykonać w ramach aplikacji desktop Comarch DMS, a następnie w zakładce [Repozytorium] w aplikacji web Comarch DMS.

 

 

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.

 

Uwaga

Instalacje wersji WWW nie są zalecane na stacjach roboczych. Instalacja powinna być przeprowadzona na dedykowanym serwerze.

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:

 

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:

 

 

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:

 

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ż:

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.

 

Uwaga

Jeżeli użytkownik nie ma zainstalowanego serwera SQL, wówczas przed przystąpieniem do instalacji aplikacji web powinien wybrać opcję Instalacja Microsoft SQL Server Express i kliknąć [Dalej]. Dalsze kroki opisano w artykule Instalacja Microsoft SQL Server Express za pomocą instalatora Comarch DMS.

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

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:

 

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:

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:

 

 

 

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:

 

Po wyborze puli aplikacji spełniającej wymagania należy przejść do następnego kroku instalacji, klikając przycisk [Dalej].

 

Kreowanie aplikacji serwerowej

Uwaga

Od wersji 2024.3.0 podczas instalacji Comarch DMS za pomocą instalatora użytkownikowi IIS_IUSRS zostają nadane pełne uprawnienia na folderze aplikacji serwerowej.

Uwaga

Aplikacje: serwerowa i web powinny znajdować się na tej samej witrynie.

W tym oknie następuje konfiguracja aplikacji serwerowej (webowej starszego typu). W ramach okna Kreowanie aplikacji serwerowej użytkownik:

 

Uwaga

Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

• \
• ?
•  ;
• :
• @
• (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:

 

 

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

Uwaga

Aplikacje: serwerowa i web powinny znajdować się na tej samej witrynie.

W tym oknie następuje konfiguracja aplikacji webowej z nowym interfejsem. W ramach okna Kreowanie aplikacji WEB użytkownik:

 

Uwaga

Nazwa aplikacji nie może zawierać następujących znaków specjalnych:

• \
• ?
•  ;
• :
• @
• (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:

 

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:

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:

 

 

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:

 

Uwaga

Hasło nie może również zawierać następujących znaków :

• ;
• ’
• „

 

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:

 

 

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.

 

Uwaga

Operator ODUser jest wspólnym operatorem dla wszystkich instalacji Comarch DMS realizowanych w ramach jednego serwera MS SQL.

 

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”.

 

Uwaga

Jeśli użytkownik instaluje Comarch DMS po raz pierwszy, ma tylko możliwość dodania nowej bazy dla DMS – nie może dokonać wyboru z listy istniejących baz, jak w poprzednim instalatorze.

 

Uwaga

Od wersji 2024.0.0 instalator szyfruje connection strings w pliku Web.config w katalogu aplikacji serwerowej (dawnej web).

 

 

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

 

Uwaga

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.

 

 

Uwaga

W ramach instalatora nie następuje weryfikacja klucza – jeśli wprowadzono niepoprawny klucz licencji, wystąpi błąd przy próbie logowania do aplikacji web Comarch DMS.

 

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.

 

 

Wskazówka

Jeśli podczas uruchomiania aplikacji serwerowej (dawna web) pojawia się komunikat: „add name=”strConnct providerName=”System.Data.SqlClient" - sprawdź tutaj

Jeśli podczas próby uruchomienia aplikacji serwerowej (dawna web) pojawia się komunikat ”Błąd http 500.19 – Internal Server Error’’ - sprawdź tutaj

 

Konfiguracja Menedżera Internetowych Usług Informatycznych (IIS)

Do instalacji aplikacji Comarch DMS wymagane jest posiadanie dodatku Microsoft.Net Framework w wersji 4.7.2 lub wyższej (zalecana 4.8) oraz zainstalowanie serwera IIS. Po zainstalowaniu serwera IIS, należy włączyć następujące komponenty:

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja} i  przekopiować zawartość katalogów DMS Workflow API i DMS Web do dwóch oddzielnych nowoutworzonych folderów na dysku C:\inetpub\wwwroot.

Nazwy folderów będą zarazem nazwami aplikacji webowych uruchamianych poprzez przeglądarkę, tzn:

 

Uwaga

Lokalnemu użytkownikowi IUSR należy nadać uprawnienie do katalogów DMSApi i DMSWeb!

 

 

 

Po uruchomieniu Menedżera Internetowych Usług Informatycznych należy kliknąć w nazwę nazwę serwera i przejść do opcji „Ograniczenia ISAPI i CGI”.

Dla wpisów z Framework ASP.NetV4.0.* należy wybrać z menu kontekstowego opcję „Zezwalaj”.

W kolejnym kroku należy dodać/wybrać pulę aplikacji, na której będzie uruchamiana aplikacja Comarch DMS. Nową pulę aplikacji dodajemy klikając prawym przyciskiem myszy na kategorię „Pule aplikacji”.

Pojawi się okno dodawania puli aplikacji. Należy wpisać w nim nazwę „DMS” i wybrać wersję .NetFramework v4.0 lub wyższą, a następnie ustawić „Zarządzany tryb potokowy” na Zintegrowany i zaznaczyć opcję „Uruchom pulę aplikacji natychmiast”.

Dla wybranej puli należy skonfigurować ustawienia zaawansowane.

Pojawi się okno, w którym należy ustawić opcję „Włącz aplikacje 32-bitowe” jako False, natomiast jako „Tożsamość” należy ustawić opcję „ApplicationPoolIdentity”, a następnie sprawdzić czy pozostałe parametry zostały ustawione jak poniżej:

 

Następnie należy skonwertować katalogi DMSApi (katalog, do którego skopiowano pliki z folderu DMS Workflow Api z pakietu instalacyjnego)  i DMSWeb (katalog, do którego skopiowano pliki z folderu DMS Web z pakietu instalacyjnego) na aplikacje i przypisać do nich utworzoną pulę.

 

 

 

Uwaga

Aplikacje: serwerowa i web powinny znajdować się na tej samej witrynie.

 

Uwaga

Zalecana jest instalacja Comarch DMS jako aplikacji w witrynie (np. w witrynie Default Web Site) , a nie jako odrębne witryny.

 

 

Przygotowanie baz danych

W kolejnym kroku instalacji należy przygotować bazę danych dla aplikacji Comarch DMS.

Aby utworzyć nową bazę danych Comarch DMS, należy uruchomić program Microsoft SQL Server Management Studio i za pomocą opcji „New Database” wykreować nową bazę.

Pojawi się okno, w którym należy podać nazwę bazy danych.

Konfiguracja pliku web.config

Uwaga

Comarch DMS może pracować w trybie jednofirmowym lub wielofirmowym. Niektóre ustawienia pliku Web.config w trybie wielofirmowym są nieużywane i nie ma potrzeby ich definiowania. Tryb pracy (jedno/wielofirmowy) ustawiany jest w kluczu
<add key=”MultiCompany” value=”” />.

W pliku konfiguracyjnym Web.config znajdującym się w katalogu C:\inetpub\wwwroot\{nazwa aplikacji serwerowej} należy wprowadzić następujące informacje:

 

 

Uruchamianie skryptów

Następnie należy uruchomić skrypty na bazie Comarch DMS.

W katalogu DMS Workflow Api\Sql znajduje się plik Install.bat, który służy do instalacji skryptów na bazie Comarch DMS.

Lokalizacja pliku:

katalog z plikami instalacyjnymi \ Comarch DMS {wersja} \ DMS Workflow Api \ Sql \ Install.bat

Aby uruchomić skrypty, należy postępować w jeden z następujących sposobów:

 

Przyklad

Sposób 1

Należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

 

Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji pliku Install.bat – np. C:\inetpub\wwwroot\DMS Workflow Api\Sql – a następnie nacisnąć Enter.

Później należy uruchomić plik z linii poleceń wpisując:

Install.bat <nazwa_serwera> <nazwa_bazy_Comarch_DMS>

a następnie klikając Enter – wówczas zostaną uruchomione skrypty.

 

 

Po wykonaniu skryptów należy zamknąć okno Wiersza polecenia.

 

 

Przyklad

Sposób 2

W katalogu DMS Workflow Api\Sql należy odnaleźć plik Install.bat i otworzyć go do edycji.

 

 

Następnie w ramach okna edytora należy uzupełnić dane w następujący sposób:

set SERVER=nazwa_serwera

SHIFT

set DATABASE=nazwa_bazy_Comarch_DMS

a następnie zapisać zmiany i zamknąć okno.

 

 

Uwaga

W wersji 2024.0.2 w pliku Install.bat został dodany dodatkowy argument ODUSERPASSWORD, w którym należy uzupełnić hasło dla ODUsera w przypadku instalacji ręcznej aplikacji Comarch DMS, jeśli aplikacja Comarch DMS jest instalowana po raz pierwszy i użytkownik ODUser nie istnieje w MSSQL.

Hasło dla użytkownika ODUser musi być zgodne z polityką haseł.
Należy używać silnego hasła, które spełnia wszystkie poniższe warunki:

• składa się z minimum 12 znaków;
• zawiera znaki alfabetyczne;
• zawiera znaki specjalne ze zbioru !@#$%^*()

 

 

Później należy kliknąć prawym przyciskiem myszki na plik Install.bat i wybrać opcję „Uruchom jako administrator”. Wówczas, po wyrażeniu zgody na dokonanie zmian przez Windows Command Processor, zostaną uruchomione skrypty. Po wykonaniu skryptów okno zostanie automatycznie zamknięte.

 

 

Reindeksacja bazy

W katalogu DMS Workflow Api\SQL znajduje się plik „reindex.bat”, który umożliwia:

Aby reindeksować bazę, należy uruchomić wiersz polecenia, wpisując cmd w wyszukiwarce w menu „Start” i wybierając opcję „Uruchom jako administrator”.

 

Następnie należy wpisać cd, nacisnąć spację i podać ścieżkę do lokalizacji pliku reindex.bat – np. C:\inetpub\wwwroot\dms202311\Sql – a następnie nacisnąć Enter.

Póżniej należy uruchomić plik z linii poleceń wpisując:

reindex.bat <nazwa_serwera> <nazwa_bazy_Comarch_DMS>

 

a następnie klikając Enter – wówczas zostanie uruchomiona reindeksacja bazy Comarch DMS.

Po wykonaniu reindeksacji należy kliknąć dowolny przycisk, a później zamknąć okno Wiersza polecenia.

 

 

Wskazówka

Zalecana jest reindeksacja bazy przy aktualizacji aplikacji Comarch DMS.

 

Weryfikacja poprawności konfiguracji aplikacji serwerowej

Poprawność instalacji można zweryfikować poprzez uruchomienie skonfigurowanej aplikacji serwerowej (dawny web) i zalogowanie się na użytkownika „administrator” (bez hasła).

 

Okno logowania do aplikacji serwerowej 

 

Wskazówka

Jeśli podczas uruchomiania aplikacji serwerowej (dawna web) pojawia się komunikat: „add name=”strConnct providerName=”System.Data.SqlClient” – sprawdź tutaj

Jeśli podczas próby uruchomienia aplikacji serwerowej (dawna web) pojawia się komunikat ”Błąd http 500.19 – Internal Server Error’’ – sprawdź tutaj

 

W celu konfiguracji aplikacji WEB należy przejść do artykułu Ręczna konfiguracja aplikacji WEB (nowej aplikacji web)