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.

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:

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)

System operacyjny:

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.

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch BPM {wersja}, następnie zawartość katalogu BPM Desktop przekopiować do nowo utworzonego folderu na lokalnym dysku. Np. do C:\BPM

Następnie należy otworzyć do edycji plik BPM.exe.config i w kluczu ServerUri wprowadzić adres URL którym uruchamiana jest aplikacja serwerowa (dawna web). Np. <add key=”ServerUri” value=”http://localhost/BPM” />

Po zapisaniu pliku BPM.exe.config należy sprawdzić działanie aplikacji uruchamiając plik BPM.exe

Dla wersji Comarch BPM wcześniejszych niż 2020.2.1 istnieje konieczność wykonywania powyższych kroków na pliku ObiegDokumentow.exe.config, aplikacja uruchamiana jest plikiem ObiegDokumentow.exe.

Weryfikacja poprawności konfiguracji aplikacji stacjonarnej (desktop)

W utworzonym katalogu (np. C:\BPM) należy odszukać i uruchomić plik BPM.exe. Zostanie otwarte okno logowania do aplikacji stacjonarnej, w którym należy się zalogować na operatora administrator (bez hasła). Od wersji 2025.1.0 w przypadku, gdy aplikację Comarch BPM (dawniej DMS) instalowano za pomocą instalatora, w polu „Hasło” należy wprowadzić hasło, które wprowadzono dla administratora podczas instalacji, w ramach okna „Klucze licencji i hasło Administratora”.

Od wersji 2020.2.1 dostępna jest możliwość rejestracji nowych użytkowników Comarch DMS z poziomu aplikacji serwerowej (dawna web). Do potencjalnego użytkownika zostaje wysłany mail zawierający link do formularza rejestracyjnego, w ramach którego potencjalny użytkownik :

Konfiguracja

Rejestracja nowych użytkowników z poziomu aplikacji serwerowej (dawna web) zostaje włączona, jeśli w pliku web.config wartość klucza <add key=”ExternalRegistrationEnabled” value=”false” /> zostanie zmieniona na true:

<add key=”ExternalRegistrationEnabled” value=”true” />  (zob. Instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym).  Następnie należy określić następujące parametry:

• <add key=”TaxPayerIdRequired” value=”false” /> – klucz określa, czy użytkownik będzie musiał podać NIP podczas rejestracji. Wartość „true” oznacza konieczność podania NIP, wartość „false” oznacza brak konieczności.

 

 

• <add key=”PersonalDataProcessingConsentRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję regulamin oraz zapoznałem się z informacją o przetwarzaniu danych osobowych”. Wartość „true” spowoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Tekst regulaminu i informacji o przetwarzaniu danych osobowych należy wprowadzić odpowiednio do plików Rules_pl.txt i Gdpr_pl.txt znajdujących się w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.

 

 

• <add key=”WorkingConditionsAcceptanceRequired” value=”false” /> – klucz określa, czy w oknie rejestracji będzie wyświetlany parametr „Akceptuję warunki pracy”. Wartość „true” powoduje, że parametr będzie wyświetlany, a jego zaznaczenie będzie wymagane do rejestracji konta. Treść informacji o warunkach pracy należy wprowadzić do pliku WorkingConditions_pl.txt w folderze TextResources. Wartość „false” powoduje, że parametr nie jest wyświetlany i jego zaznaczenie nie jest wymagane do rejestracji.

Przebieg rejestracji

Uwaga

Do właściwego działania rejestracji użytkownika z poziomu aplikacji web konieczne jest poprawne wypełnienie przez administratora pól sekcji Ustawienia konta pocztowego w ramach zakładki Ustawienia  w aplikacji desktopowej

Potencjalny użytkownik wyświetla w przeglądarce stronę, która znajduje się pod adresem: http://localhost/DocumentWorkflow.Web/ExternalRegistration- adres składa się z adresu aplikacji serwerowej (dawna web), do którego dokładany jest człon „/ExternalRegistration”, np. http://localhost/Standalone/ExternalRegistration

Potencjalny użytkownik powinien uzupełnić wymagane pola formularza, a następnie kliknąć przycisk [Zarejestruj się].

Po wyborze przycisku [Zarejestruj się] wyświetlone zostaje okno informujące o konieczności aktywacji konta, aby dokończyć proces rejestracji, a na adres email podany w formularzu wysyłana jest wiadomość zawierająca link aktywacyjny do konta. Jeżeli wiadomość nie dotarła na skrzynkę mailową, można ponowić próbę, klikając wyślij link ponownie w ramach okna przeglądarki.

Po wyborze przycisku [Aktywuj konto] wyświetlane jest okno z informacją o zakończeniu rejestracji sukcesem i z przyciskiem [Zaloguj się do Comarch DMS], po wyborze którego następuje przejście do okna logowania do aplikacji serwerowej (dawna web) Comarch DMS.

Dodany w ten sposób pracownik jest widoczny wraz z  loginem, imieniem, nazwiskiem i adresem mailowym, które uzupełniono w formularzu rejestracji,  w ramach zakładki [Struktura organizacyjna] w aplikacji Comarch DMS desktop.

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:

• w ramach opcji Ustawienia wybrać Region i w polu Kraj lub region  – „Polska”

 

• w ramach opcji Panel sterowania wybrać ustawienia Zegar i region, a później Region

 

 

• następnie w ramach zakladki  „Formaty” wybrać format „Polski (Polska)”

 

 

• później w ramach zakładki „Administracyjne”  upewnić się, czy w polu Bieżący język dla programów nieobsługujących kodu Unicode: wybrane zostało ustawienie „Polski (Polska)”. Ustawienie mozna zmienić   po kliknięciu na przycisk „Zmień ustawienia regionalne systemu” – w otwartym wówczas oknie „Ustawienia regionalne” nalezy również dodatkowo sprawdzić, czy checkbox Użyj formatu Unicode UTF-8 do obsługi języków z całego świata jest zaznaczony – jeśli jest, należy go odznaczyć.

Kopiowanie zawartości katalogu DMS Workflow Api

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja} i przekopiować zawartość katalogu DMS Workflow Api  do folderu, który utworzono podczas poprzedniej instalacji i do którego wówczas przeniesiono zawartość folderu DMS Web (np.na dysku C:\inetpub\wwwroot\DMS).

Wprowadzanie zmian w pliku Web.config

Następnie w pliku konfiguracyjnym Web.config znajdującym się w katalogu C:\inetpub\wwwroot\{nazwa aplikacji serwerowej} należy wprowadzić potrzebne informacje, analogicznie jak podczas instalacji Comarch DMS (zob. punkt Konfiguracja pliku web.config w artykule Instalacja aplikacji serwerowej (dawnej web) w trybie ręcznym) i zapisać plik.

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\DMSWeb\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.

 

 

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.

Weryfikacja poprawności konfiguracji aplikacji serwerowej

Poprawność instalacji można zweryfikować poprzez uruchomienie skonfigurowanej aplikacji serwerowej i zalogowanie się na użytkownika.

W pobranym pliku instalacyjnym należy wejść do katalogu Comarch DMS {wersja}, następnie zawartość katalogu DMS Desktop przekopiować do folderu, który utworzono podczas poprzedniej instalacji i do którego wówczas przeniesiono zawartość folderu DMS Desktop (np. do C:\DMS).

Następnie należy otworzyć do edycji plik DMS.exe.config i w kluczu ServerUri wprowadzić adres URL którym uruchamiana jest aplikacja serwerowa (dawna web). Np. <add key=”ServerUri” value=”http://localhost/DMS” />

Po zapisaniu pliku DMS.exe.config należy sprawdzić działanie aplikacji uruchamiając plik DMS.exe

Dla wersji Comarch DMS wcześniejszych niż 2020.2.1 istnieje konieczność wykonywania powyższych kroków na pliku ObiegDokumentow.exe.config, aplikacja uruchamiana jest plikiem ObiegDokumentow.exe.

Weryfikacja poprawności konfiguracji aplikacji stacjonarnej (desktop)

W utworzonym katalogu (np. C:\DMS) należy odszukać i uruchomić plik DMS.exe. Zostanie otwarte okno logowania do aplikacji stacjonarnej, w którym należy się zalogować na operatora.

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 BPM (dawniej DMS) .

Aby uruchomić instalator Comarch BPM (dawniej DMS) , w pobranym pakiecie instalacyjnym należy wejść do katalogu Comarch BPM  [wersja] instalator Comarch BPM i uruchomić Instalator Comarch BPM.exe

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:

• Logowanie domenowe – w takim przypadku użytkownik nie dokonuje żadnych zmian, tylko klika przycisk [Instaluj], aby przejść do następnego kroku instalacji

 

 

• • Za pomocą własnego hasła – w takim wypadku użytkownik będzie logował się do serwera SQL, używając własnego hasła, które zostanie nadane dla konta administratora o nazwie „sa” – w tym celu konieczne jest zaznaczenie dostępnego w ramach okna checkboxa Zabezpiecz własnym hasłem (domyślnie checkbox jest odznaczony). Po zaznaczeniu checkboxa poniżej pojawiają się pola:
    • Hasło – należy tu wpisać hasło, za pomocą którego użytkownik będzie się logował na serwerze SQL. Hasło musi składać się z 12 znaków i spełniać następujące zasady, a mianowicie zawierać:
      • Małe litery
      • Wielkie litery
      • Cyfry
      • Znaki specjalne
    • Powtórz hasło – w tym polu konieczne jest ponowne wpisanie frazy, za pomocą której uzupełniono pole „Hasło”

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 BPM (dawniej DMS) jak opisano w artykule: