Zmiana nazwy serwera aplikacyjnego a WEBCON BPS

Dotyczy wersji: 2022 R1 i powyżej; autor: Konrad Keppert

Dokumentacja powiązana

Wstęp

W domyślnej konfiguracji platformy nazwa maszyny, na której zainstalowane są komponenty WEBCON BPS, przechowywana jest w kilku miejscach w systemie. Służy ona za adres m.in. serwisu licencji, serwera Solr, a także ma swój udział w procesie aktywacji licencji. W związku z tym zmiana nazwy serwera WEBCON BPS uniemożliwi poprawną pracę komponentów i będzie wiązała się z koniecznością wprowadzenia zmian konfiguracyjnych na środowisku.

Niniejszy artykuł zawiera listę kroków, które należy wykonać, aby umożliwić poprawną pracę systemu w przypadku konieczności zmiany nazwy serwera aplikacyjnego.

W przykładach przedstawionych w tym artykule nazwa maszyny została zmieniona z „WINSRV2022APP01” na „WEBCON01”.

1. Dezaktywuj serwis licencji

W momencie aktywowania serwisu licencji zaszyfrowana nazwa maszyny zapisywana jest na środowisku WEBCON BPS. Późniejsza zmiana nazwy maszyny spowoduje rozbieżność pomiędzy nową nazwą a wpisem w bazie danych, co uniemożliwi poprawną pracę systemu.

Z tego względu przed zmianą nazwy maszyny konieczna jest dezaktywacja serwisu licencji, aby po zmianie móc ponownie go aktywować.

Aktywacja oraz dezaktywacja licencji w trybie offline możliwe są do przeprowadzenia bez kontaktu z firmą WEBCON, dzięki usłudze License Activation Service opisanej w artykule: License Activation Service – Blog techniczny WEBCON BPS.

Co jeśli nazwa maszyny została zmieniona przed dezaktywacją serwisu licencji?

Jeśli nazwa maszyny została już zmieniona, a przez to dostęp do Designer Studio nie jest możliwy, należy zatrzymać usługę WEBCON Workflow Service, przejść do setup.exe → Narzędzia do zarządzania systemem → Manager licencji, użyć skrótu klawiszowego Ctrl + L (dostępne od 2022.1.3), a następnie kliknąć Deaktywuj lokalny serwis licencji.

Spowoduje to przejście serwisu licencji w tryb nieaktywny (DEMO) i umożliwi jego ponowne aktywowanie.

W takim scenariuszu licencja nie została poprawnie dezaktywowana (w License Activation Service wciąż będzie znajdowała się informacja o jej wykorzystaniu), a więc w celu jej ponownego wykorzystania konieczny jest kontakt z firmą WEBCON.

Rys. 1. Awaryjna dezaktywacja serwisu licencji

2. Reinstaluj WEBCON Workflow Service

Usługa WEBCON Workflow Service nie uruchomi się, jeśli występuje rozbieżność pomiędzy nazwą usługi (maszyny), a wpisem w konfiguracyjnej bazie danych. Instalacja nowego serwisu w ramach środowiska WEBCON BPS spowoduje dodanie odpowiedniego wpisu (z nową nazwą serwisu) do bazy danych.

Po zainstalowaniu nowej usługi należy przełączyć wszystkie role oraz powiązane bazy zawartości ze starego serwisu na nowy, w setup.exe → Narzędzia do zarządzania systemem → Konfiguracja serwisów farmy.

Restart usługi WEBCON Workflow Service jest konieczny, aby zastosować zmiany.

Rys. 2. Przełączenie ról i powiązanych baz procesów między serwisami (Konfiguracja serwisów farmy)

3. (Opcjonalnie) Nadpisz poświadczenia kont serwisu/puli aplikacji IIS, jeśli są kontami lokalnymi

Konto serwisu w setup.exe → Narzędzia do zarządzania systemem → Konfiguracja serwisu lokalnego.

Konto puli aplikacji w setup.exe → Narzędzia do zarządzania systemem → Konfiguracja adresu Portalu.

W Konfiguracji adresu Portalu należy również zmienić URL Portalu, jeśli ten się zmieni wraz z nazwą maszyny.

4. (Opcjonalnie) Wygeneruj certyfikaty dla nowego serwisu, jeśli połączenie Portal-Serwis realizowane jest za pomocą protokołu TCP

Można to zrobić w setup.exe → Narzędzia do zarządzania systemem → Konfiguracja połączenia Portal-Serwis.

Jeśli połączenie realizowane jest za pomocą protokołu HTTP, nie ma potrzeby wykonywania dodatkowych czynności.

Opcja wykorzystania protokołu TCP dostępna jest począwszy od wersji: 2021.1.5, 2022.1.3 oraz 2023.1.1. Poprzednie wersje pozwalały jedynie na komunikację przez HTTP.

Rys. 3. Konfiguracja połączenia Portal-Serwis

5. Aktywuj serwisu licencji

Proces aktywacji opisano w artykule: Aktywacja licencji platformy WEBCON BPS – Blog techniczny WEBCON BPS.

6. Zmień adres serwera Solr

W setup.exe → Narzędzia do zarządzania systemem → Konfiguracja Search Server.

Do zaaplikowania zmian konieczny jest restart usługi WEBCON BPS Search Service.

Rys. 4. Zmiana adresu serwera Solr (Konfiguracja Search Server)

7. (Opcjonalnie) Zaktualizuj powiązania witryny IIS, jeśli nazwa hosta witryny ulegnie zmianie

Do zaaplikowania zmian konieczny może być restart witryny.

8. Wykonaj recycle puli aplikacji w IIS

Od tego momentu powinien zostać przywrócony dostęp do Portalu oraz Designer Studio.

9. (Opcjonalnie) Podmień serwisy w konfiguracji, jeśli nie korzystały z opcji „Dowolny”

Jeśli jakąkolwiek konfigurację w Designer Studio przeprowadzono z wybraniem „na sztywno” starego serwisu workflow, a nie opcji „Dowolny” (np. do obsługi HotMailBoxów), to należy ją zmienić, wybierając nowy serwis.

Rys. 5. Zmiana odpowiedzialnego serwisu w konfiguracji

10. (Opcjonalnie) Usuń stary serwis z farmy

Opcja dostępna po wybraniu serwisu w Designer Studio → Konfiguracja systemu → Serwisy.

Podsumowanie

W artykule przedstawiono kroki, jakie należy wykonać, aby po zmianie nazwy maszyny aplikacja WEBCON BPS działała poprawnie. Kluczowym punktem jest dezaktywacja serwisu licencji, która, wykonana w odpowiednim momencie, pozwoli przeprowadzić całą operację bez interwencji producenta. Nakład pracy zależny jest od konfiguracji środowiska, co widać po liczbie działań oznaczonych jako opcjonalne.