Pytania do klienta przed wyrównaniem:

1. Czy przenosimy Archiwum?
2. Czy maile użytkowników powinny być ustawione tak jak na prod?

Checklista migracji środowiska produkcyjnego → testowego

Dokument opisuje kroki niezbędne do bezpiecznego przeniesienia backupu bazy produkcyjnej na serwer testowy w systemie PlusWorkflow, tak aby środowisko testowe nie wchodziło w interakcję z realnymi danymi/usługami produkcyjnymi.

1. Zadania zaplanowane (Scheduled Tasks / RPA)

Tabele:pm_scheduled_tasks, pm_scheduled_tasks_parameters, pm_scheduled_tasks_history, pm_scheduled_tasks_component, pm_scheduled_tasks_category, pm_rpa_configs, pm_rpa_scripts, pm_rpa_workers_history

Sposób wykonania: Zaraz po przeniesieniu backupu bazy produkcyjnej na serwer testowy — jeszcze przed uruchomieniem serwera testowego — wyłączyć wszystkie zaplanowane zadania:

update PM_SCHEDULED_TASKS set name=name+'_disabled', is_active='0'  where  is_active='1'

update PM_SCHEDULED_TASKS set name=name||'_disabled', is_active='0'  where  is_active='1'

Docelowo po przejściu całej instrukcji należy przywrócić konfigurację zadań zgodnie ze stanem środowiska sprzed zrównania. Docelowo aktywne powinny pozostać wyłącznie te zadania, które były uruchomione na danym środowisku przed importem bazy. Przykład: jeżeli przed zrównaniem na środowisku testowym aktywne były zadania OCR, po imporcie bazy docelowo chcemy, aby też one działały(po przejściu całej instrukcji).

2. Konfiguracja parametrów systemowych

Sposób wykonania: Dane dotyczące parametrów systemowych są przechowywane  w tabeli pm_systemparameter. Po wyrównaniu środowiska podmienić na wartości odpowiadające systemowi test:

HTTPLink

np. 

UPDATE public.pm_systemparameter
SET valuestring = 'https://<adres_serwera_testowego>:8443/PWFL'
WHERE parameterkey = 'HTTPLink';

WorkingDirectory

np. na C:\Suncode\PlusWorkflow-TEST\Home\temp

SystemType 

np. na Test

3. Konfiguracja skrzynek pocztowych i powiadomień

Lokalizacja:Administracja → Konfiguracja systemu → Konfiguracja skrzynek pocztowych

Sposób wykonania: Podmienić konta pocztowe pochodzące z wersji produkcyjnej na konta testowe — w każdym przypadku, gdy środowisko testowe ma korzystać z innych skrzynek niż produkcja.

• Sprawdź skrzynki odbiorcze skonfigurowane do odbierania poczty przychodzącej (np. e-faktury, pm_efaktura_email_from) — jeśli DEV podłącza się do prawdziwej skrzynki produkcyjnej (IMAP/POP3), odłącz i podmień na skrzynkę testową, aby uniknąć oznaczania/usuwania maili produkcyjnych.
• Zweryfikuj adresy „From"/„Reply-To", aby ewentualne odpowiedzi nie trafiały na skrzynki produkcyjne.

4. Pliki konfiguracyjne/wdrożeniowe i systemowe

Sposób wykonania: Podmiana plików na serwerze.

Przenieść zawartość katalogu wtyczek z produkcji na środowisko testowe

5. Zmiany w bazie danych

Ścieżki do katalogów, dokumentów i plików

Tabele:pm_devices, pm_docclasses, pm_files, pm_documenttemplate, pm_notificationdef, pm_reports

Sposób wykonania: Zaktualizować wszystkie ścieżki systemowe, zastępując wartość produkcyjną odpowiednikiem testowym. Przy kopiowaniu bazy danych i zmianie ścieżki należy zawsze sprawdzić z poziomu serwera, czy wskazany docelowy katalog fizycznie istnieje.

-- Ścieżki do katalogów systemu (urządzeń)
SELECT * FROM pm_devices;
UPDATE pm_devices SET devicepath = replace(devicepath, 'stara wartosc', 'nowa wartosc');

-- Klasy dokumentów
SELECT * FROM pm_docclasses;
UPDATE pm_docclasses SET docclassindexpath = replace(docclassindexpath, 'stara wartosc', 'nowa wartosc');

-- Ścieżki do fizycznych plików zapisanych w systemie
SELECT * FROM pm_files;
UPDATE pm_files SET path = replace(path, 'stara wartosc', 'nowa wartosc');

-- Szablony dokumentów
SELECT * FROM pm_documenttemplate;
UPDATE pm_documenttemplate SET templatepath = replace(templatepath, 'stara wartosc', 'nowa wartosc');

-- Definicje powiadomień
SELECT * FROM pm_notificationdef;
UPDATE pm_notificationdef SET templatepath = replace(templatepath, 'stara wartosc', 'nowa wartosc');

-- Raporty
SELECT * FROM pm_reports;
UPDATE pm_reports SET reportdefinitionpath = replace(reportdefinitionpath, 'stara wartosc', 'nowa wartosc');

SELECT * FROM PM_VCOLUMNS;
UPDATE PM_VCOLUMNS SET value = replace(value, 'stara wartosc', 'nowa wartosc');

SELECT * FROM PM_VTABLES;
UPDATE PM_VTABLES SET value = replace(value, 'stara wartosc', 'nowa wartosc');

SELECT * FROM PM_VTYPES;
UPDATE PM_VTYPES SET value = replace(value, 'stara wartosc', 'nowa wartosc');

SELECT * FROM PM_VVALUES;
UPDATE PM_VVALUES SET value = replace(value, 'stara wartosc', 'nowa wartosc');

-- Weryfikacja połączeń zewnętrznych baz danych
SELECT * FROM pm_externaldb_conf;

SELECT * FROM dbex_alias;

-- Podmiana bazy produkcyjnej na testową
UPDATE dbex_alias
SET db_catalog = '<test_external_database_name>'
WHERE db_catalog = '<prod_external_database_name>';

6. Konfiguracja wtyczek i modułów 


Należy zwrócić uwagę czy występują wtyczkieFaktura, KSeF, OCR, Directory Monitor, Barcode Reader. W takim przypadku należy przywrócić dotychczasowe konfiguracje z systemu testowego.
Jeśli występował projekt kliencki we wtyczce do Automatycznych aktualizacji należy go przywrócić zgodnie z tym co było dotychczas.

Dodatkowo dla DBExplorer, Plus E-faktura, PO Module potrzebne są poniższe zmiany. 

Tabele:pm_modules_dbexplorer_cfg, pm_plusefaktura_license, pm_po_module

Sposób wykonania: Podmienić konfiguracje i ścieżki specyficzne dla używanych modułów (licencje, powiązane tabele per wtyczka).

-- DBExplorer (nazwa tabeli, do której odwołuje się wtyczka)
SELECT * FROM pm_modules_dbexplorer_cfg;
UPDATE pm_modules_dbexplorer_cfg SET dbRealName = replace(dbRealName, 'stara wartosc', 'nowa wartosc');

-- Ścieżka do pliku licencyjnego modułu Plus E-faktura
SELECT * FROM pm_plusefaktura_license;
UPDATE pm_plusefaktura_license SET path = replace(path, 'stara wartosc', 'nowa wartosc');

-- Moduł PO
SELECT * FROM pm_po_module;
UPDATE pm_po_module SET value = replace(value, 'stara wartosc', 'nowa wartosc'); 
 

8. Weryfikacja zgodności z dokumentacją projektu

W procedurze należy uwzględnić i zweryfikować poprawne ścieżki oraz konfiguracje wskazane w dokumentacji projektowej — powyższa checklista obejmuje tabele systemowe, jednak każdorazowo należy dodatkowo sprawdzić dokumentację właściwego projektu pod kątem:

• tabel i konfiguracji wdrożeniowych specyficznych dla danego wdrożenia,
• ścieżek katalogów i plików wskazanych w dokumentacji projektowej,
• dodatkowych integracji lub modułów niewymienionych w niniejszej checkliście.