Aktualizacja aplikacji serwerowej, aplikacji WEB i aplikacji Comarch DMS Repozytorium za pomocą instalatora

image_pdfimage_print

Instalator Comarch DMS umożliwia również aktualizację aplikacji serwerowej i aktualizację aplikacji WEB Comarch DMS oraz aktualizację aplikacji Comarch DMS Repozytorium.

Uwaga
Podczas aktualizacji za pomocą Instalatora (Instalator Comarch DMS.exe) potrzebny jest dostęp do Internetu.
Uwaga
Przed rozpoczęciem aktualizacji Comarch DMS Repozytorium konieczne jest, aby wykonać backup bazy MongoDB – zob. Backup bazy danych MongoDB

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:

 

Komunikat, który zostanie wyświetlony po naciśnięciu przycisku „Anuluj” lub przy próbie zamknięcia okna instalatora

 

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:

 

Ekran początkowy aktualizacji aplikacji web Comarch DMS

 

W kolejnym oknie instalatora (po oknie przygotowywania komponentów) należy wybrać przycisk [Dalej], aby kontynuować aktualizację.

 

Drugie okno aktualizacji Comarch DMS – ekran powitalny

 

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

Wybór opcji aktualizacji aplikacji Comarch DMS

 

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

 

Okno „Wymagane dodatki”

 

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.

Przykład aplikacji web zainstalowanej 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.

 

Wybór aplikacji serwerowej zainstalowanej w witrynie do aktualizacji

 

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

 

Okno „Aktualizacja aplikacji serwerowej” po wyborze aplikacji do zaktualizowania (gdy aplikacja nie jest zainstalowana w witrynie)

 

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:

Komunikat wyświetlany podczas aktualizacji aplikacji Comarch DMS, która pracuje w trybie wielofirmowym

 

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

 

Okno „Aktualizacja aplikacji WEB” przed wyborem aplikacji WEB

 

Okno „Aktualizacja aplikacji WEB” po wyborze aplikacji WEB

 

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

 

Okno „Aktualizacja aplikacji WEB” po wyborze do zaktualizowania aplikacji, która nie jest aplikacją WEB

 

Kreowanie aplikacji WEB

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

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.

 

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 „Wprowadź nazwę aplikacji WEB” tak, aby nie zawierała już znaków specjalnych, a później ponownie nacisnąć [Utwórz aplikację].

 

Informacja o znakach zakazanych w oknie „Kreowanie aplikacji WEB”

 

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.

 

Okno „Kreowanie aplikacji WEB” po tym, jak aplikacja została utworzona

 

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

 

Okno „Kreowanie aplikacji WEB” podczas dodawania nowej 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.

 

Okno „Kreowanie aplikacji WEB” po pomyślnym dodaniu nowej witryny

 

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ę].

 

Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę o takiej samej nazwie jak już istniejąca

 

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ę].

 

Okno „Kreowanie aplikacji WEB”, gdy próbowano utworzyć nową witrynę na porcie, który jest już wykorzystywany

 

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.

 

Okno „Opcje aktualizacji” w przypadku aktualizacji Comarch DMS Standalone

 

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#

 

Uwaga
Domyślnie opcje aktualizacji są zaznaczone tak, jak zaznaczono je podczas poprzedniej instalacji lub aktualizacji.

 

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

 

Okno „Baza danych Comarch DMS”

 

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

 

Okno zmiany hasła dla użytkownika ODUser

 

 

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

 

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.

 

Plik appsettings.json z zaszyfrowanymi connection strings

 

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.

Okno „Aktualizacja aplikacji Repozytorium” przed wypełnieniem pól

 

Okno „Aktualizacja aplikacji Repozytorium” po wypełnieniu pól

 

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;
Uwaga
Istnieje możliwość wprowadzenia w ramach pola „Nazwa serwera” IP serwera MongoDB.
      • W sekcji „Logowanie do serwera MongoDB”:
        • W ramach pola „Login” – login administratora MongoDB
        • W ramach pola „Hasło” – hasło administratora 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”.

Okno „Baza danych Comarch DMS Repozytorium” przed uzupełnieniem pól

 

Okno „Baza danych Comarch DMS Repozytorium” po uzupełnieniu pól i kliknięciu w przycisk „Połącz”

 

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

Okno zmiany hasła dla użytkownika MongoUser

 

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

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

Okno „Baza danych Comarch DMS Repozytorium” po zmianie hasła dla użytkownika MongoUser

 

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.

 

Okno „Klucze licencji” (jeśli aktualizowany jest tylko Comarch DMS)
Okno „Klucze licencji” (jeśli aktualizowany jest Comarch DMS i Comarch DMS Repozytorium)

 

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.

 

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.

 

Okno „Aktualizowanie”

 

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.

 

Okno końcowe instalatora Comarch DMS

 

Rozpoczynasz pracę z Comarch DMS i chcesz dowiedzieć się, jak korzystać z programu? A może masz już podstawową wiedzę o Comarch DMS i chcesz dowiedzieć się więcej?

Sprawdź Szkolenia Comarch DMS!

Czy ten artykuł był pomocny?