Instalator Comarch DMS umożliwia również aktualizację aplikacji serwerowej i aktualizację aplikacji WEB Comarch DMS oraz aktualizację aplikacji Comarch DMS Repozytorium.
W ramach okna początkowego dostępne jest pole Język instalatora – w ramach tego pola użytkownik wybiera język, w którym będą wyświetlane kolejne kroki instalatora.
Po wyborze odpowiedniej wartości w polu należy kliknąć [Dalej], aby przejść do kolejnego kroku aktualizacji.
Jeżeli użytkownik chce zrezygnować z aktualizacji, powinien wybrać przycisk [Anuluj] albo spróbować 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:
W kolejnym oknie instalatora (po oknie przygotowywania komponentów) należy wybrać przycisk [Dalej], aby kontynuować aktualizację.
Wybór aplikacji
Następnie aby zaktualizować aplikację Comarch DMS, należy w ramach okna „Wybór aplikacji” wybrać opcję „Aktualizacja aplikacji Comarch DMS oraz Comarch DMS Repozytorium” (od wersji 2024.2.0) i kliknąć [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].
Aktualizacja aplikacji serwerowej
Następnie zostaje otwarte okno Aktualizacja aplikacji serwerowej. W ramach tego okna dostępne są następujące pola:
- Wybierz witrynę web – w tym polu użytkownik z listy dostępnych witryn wybiera witrynę, na której znajduje się aplikacja serwerowa (dawna web), która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
- Port – nieedytowalne pole numeru portu, widoczne jako wyszarzone;
- Wybierz aplikację serwerową – w tym polu użytkownik z listy aplikacji dostępnych na danej witrynie wybiera tę aplikację serwerową (dawna web), która ma zostać zaktualizowana
Od wersji 2023.0.1 możliwa jest aktualizacja aplikacji web Comarch DMS za pomocą instalatora w przypadku, jeśli dotychczasowa instalacja była wykonywana ręcznie i aplikacja web została zainstalowana bezpośrednio w witrynie.
W tym celu w ramach okna Aktualizacja aplikacji serwerowej w polu Wybierz aplikację serwerową dostępna jest opcja Aplikacja zainstalowana w witrynie.
Jeżeli użytkownik wybrał opcję Aplikacja zainstalowana w witrynie, wówczas aktualizacja plików aplikacji serwerowej (dawnej web) będzie się odbywać w folderze źródłowym witryny sieci web, który został wskazany w ustawieniach zaawansowanych witryny (Ogólne -> Ścieżka fizyczna).
Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do kolejnego okna.
Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest aplikacją serwerową Comarch DMS, wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch DMS. Wybierz odpowiednią aplikację.”.
Kiedy wybrano aplikację do aktualizacji, wówczas weryfikowany jest plik web.config. Od wersji 2023.0.1 jeśli w kluczu „MultiCompany” value= true, wówczas aktualizacja bazy Comarch DMS zostaje przeprowadzona i zostaje wyświetlony następujący komunikat:
W przypadku, jeśli użytkownik naciśnie przycisk:
- Anuluj – praca instalatora zostanie zakończona, zaś aktualizacja – przerwana
- Ok – zostanie wykonana aktualizacja bazy DMS, a w kluczu MultiCompany zostaje zachowana wartość True
Następnie:
- jeżeli użytkownik utworzył już wcześniej aplikację WEB, wówczas przechodzi do okna „Aktualizacja aplikacji WEB”
- jeżeli użytkownik nie utworzył jeszcze aplikacji WEB, wówczas przechodzi do okna „Kreowanie aplikacji WEB”
Aktualizacja aplikacji WEB
Opcja aktualizacji aplikacji WEB za pomocą instalatora jest dostępna od wersji 2024.0.1. W ramach okna „Aktualizacja aplikacji WEB” należy:
- w polu „Wybierz witrynę web” wybrać witrynę, na której znajduje się aplikacja WEB, która ma zostać zaktualizowana – domyślnie wyświetlana jest witryna Default Web Site;
- w polu „Wybierz aplikację WEB” wybrać z listy aplikacji dostępnych na danej witrynie tę aplikację WEB (nowy web), która ma zostać zaktualizowana
a następnie kliknąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.
Jeśli użytkownik wybrał w polu „Wybierz aplikację WEB” aplikację, która nie jest aplikacją serwerową Comarch DMS, wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch DMS. Wybierz odpowiednią aplikację.”.
Kreowanie aplikacji WEB
W ramach tego okna dostępne są pola, w ramach których 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.
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 „Wprowadź nazwę aplikacji WEB” 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 „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.
Po wybraniu odpowiednich wartości w polach należy nacisnąć przycisk [Dalej], aby przejść do okna „Opcje aktualizacji”.
Jeśli użytkownik wybrał w polu „Nazwa aplikacji” aplikację, która nie jest nową aplikacją web Comarch DMS, wówczas po kliknięciu przycisku [Dalej] wyświetlony zostaje komunikat „Wybrana aplikacja nie jest aplikacją Comarch DMS. Wybierz odpowiednią aplikację.”.
Opcje aktualizacji
W następnym oknie „ Opcje aktualizacji” w ramach pola „Domyślny język aktualizowanej aplikacji” wybierany jest język, w którym wyświetlana będzie domyślnie aplikacja Comarch DMS.
Dostępne są również trzy parametry:
- Opcja zmiany języka na ekranie logowania Comarch DMS – 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ę z min. 12 znaków;
Zawierać cyfry;
Zawierać małe i wielkie litery;
Zawierać znaki specjalne.
- 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ć aktualizację.
Baza 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, w ramach pola „Lista baz danych” powinna być wybrana baza Comarch DMS, która jest właściwa dla danej aplikacji – domyślnie podpowiada się właściwa baza. Opcjonalnie, użytkownik może zmienić hasło dla istniejącej bazy po kliknięciu przycisku [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.
Nastepnie 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.
Po wyborze bazy i (opcjonalnie) zmianie hasła dla istniejącej bazy użytkownik powinien nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch DMS. 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:
- Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „false” – aplikacja Comarch DMS nie współpracuje z modułem Comarch DMS – następuje przejście do okna „Klucze licencji”
- Jeżeli w folderze z aktualizowaną aplikacją serwerową w pliku Web.config klucz „UseRepository” ma wartość „true” – następuje przejście do okna „Aktualizacja aplikacji Repozytorium”
Aktualizacja aplikacji Repozytorium
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 „Aktualizacja aplikacji Repozytorium” znajdują się następujące pola:
-
-
- Wybierz witrynę web – w ramach tego pola operator powinien wybrać witrynę, na której znajduje się aplikacja Repozytorium do zaktualizowania (domyślnie wyświetlana jest witryna Default Web Site);
- Port – pole numeru portu, wyszarzone i nieedytowalne;
- Wybierz aplikację Repozytorium – w ramach tego pola operator powinien wybrać aplikację Repozytorium do zaktualizowania.
-
Następnie należy kliknąć [Dalej], aby przejść do kolejnego okna.
Baza danych Comarch DMS Repozytorium
Następnie w ramach okna „Baza danych Comarch DMS Repozytorium” operator powinien uzupełnić:
-
-
- W ramach pola „Nazwa serwera” – nazwę serwera, na którym znajduje się serwer MongoDB;
-
-
-
- W sekcji „Logowanie do serwera MongoDB”:
- W ramach pola „Login” – login administratora MongoDB
- W ramach pola „Hasło” – hasło administratora MongoDB
- W sekcji „Logowanie do serwera MongoDB”:
-
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”.
Jeśli nawiązano połączenie z serwerem MongoDB, wówczas w ramach pola „Lista baz danych” wybrana jest baza Comarch DMS Repozytorium odpowiednia dla danej aplikacji.
Nastepnie, opcjonalnie, operator może zmienić hasło dla użytkownika MongoUser, klikając przycisk [Zmień hasło].
W otwartym oknie w polu „Hasło” należy ustawić hasło dla użytkownika MongoUser, dodanego do serwera MongoDB podczas pierwszej instalacji danej aplikacji Comarch DMs Repozytorium. 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:
-
-
- Składać się z min. 12 znaków;
- Zawierać cyfry;
- Zawierać małe i wielkie litery;
- Zawierać znaki specjalne.
-
- :
- /
- ?
- #
- [
- ]
- @
- !
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.
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].
Po kliknięciu w przycisk [Dalej] następuje przejście do okna „Klucze licencji”.
Klucze licencji
W ramach okna „Klucze licencji” w polu „Serwer klucza licencji Comarch DMS” zostaje automatycznie wpisany klucz licencji, pobrany z pliku web.config. W razie potrzeby użytkownik może wpisać ręcznie inne klucze licencji Comarch DMS zgodnie ze wzorem nazwa_serwera_klucza::numer_klucza.
Jeżeli operator aktualizuje również moduł Repozytorium, wówczas w ramach okna „Klucze licencji” dostępne jest także pole „Adres e-mail administratora”, w którym znajduje się adres email, który będzie widoczny w Comarch DMS w komunikatach, w których wymagany jest kontakt z administratorem – automatycznie uzupełniony, ale dostępny do edycji.
Następnie należy kliknąć na przycisk [Instaluj], aby przejść do kolejnego kroku.
Aktualizowanie
Po uzupełnieniu klucza licencji i kliknięciu [Instaluj] następuje przejście do kolejnego okna „Aktualizowanie” i rozpoczyna się aktualizacja aplikacji web Comarch DMS.
Koniec pracy instalatora
Po dokonaniu aktualizacji wyświetlone zostanie końcowe okno instalatora. Kiedy 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.