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

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 we współpracy z Comarch ERP XL

 

Dostępne są również trzy parametry:

  • Opcja zmiany języka na ekranie logowania do 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ć instalację.

 

Jeśli podczas instalacji utworzono osobną bazę danych dla Comarch DMS, wówczas następuje przejście do okna „Baza danych Comarch DMS”, gdzie 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. 8 znaków
  • Zawiera wielkie i małe litery
  • Zawiera znak specjalny

 

Następnie 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 aktualizacji – do okna „Baza danych Comarch ERP XL”.

W ramach okna „Firmowa baza danych Comarch ERP XL” 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

 

Okno „Baza danych Comarch ERP XL”

 

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 w ramach pola „Lista baz danych” wybrać bazę firmową Comarch ERP XL, która ma zostać zaktualizowana, a później nacisnąć przycisk [Uruchom skrypty] w celu aktualizacji bazy Comarch ERP XL.

 

Okno „Baza danych Comarch ERP XL” po nawiązaniu połączenia z serwerem

 

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”

 

Okno instalatora po pomyślnym wykonaniu skryptów na bazie Comarch ERP XL

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

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;
      • 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ć nastepujących znaków:

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

    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 polach: „Serwer klucza licencji Comarch DMS” i „Serwer klucza licencji Comarch ERP XL” zostają automatycznie wpisane klucze licencji, pobrane 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 [Dalej], 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 niepoprawne klucze licencji, wystąpi błąd przy próbie logowania do aplikacji web Comarch DMS.

     

    Po uzupełnieniu klucza licencji i kliknięciu [Instaluj] następuje przejście do kolejnego okna i rozpoczyna się aktualizacja aplikacji web Comarch DMS.

     

    Okno „Aktualizowanie”

     

    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?