Aktualizacja i deinstalacja

Nowa wersja phaf to nowy instalator. Uruchom go na serwerze, na którym działa phaf: zastępuje aplikację, zachowuje config.json i nigdy nie dotyka folderu danych. Dotychczasowa wersja zostaje zachowana w C:\phaf\app.previous na wypadek wycofania. Zaplanuj około 15 minut, poza godzinami największego ruchu.

Zanim zaczniesz

• Przeczytaj informacje o wersji nowego wydania i każdej pomijanej wersji.
• Zweryfikuj nowy instalator sumą kontrolną SHA-256 i odblokuj go (jak w kroku Instalacja).

Aktualizacja krok po kroku

1. Pozwól zakończyć bieżącą pracę

W Settings › Advanced › Database otwórz Migrate to another database i kliknij Enter Safe Mode. phaf przestaje wysyłać, przetwarzać i odbierać i informuje, kiedy bieżąca praca się zakończy. Nie musisz kontynuować migracji.

2. Wykonaj kopię zapasową

$svc = (Get-Service | Where-Object DisplayName -like 'phaf*').Name
Stop-Service $svc
$stamp = Get-Date -Format 'yyyy-MM-dd'
Compress-Archive -Path C:\phaf\data, C:\phaf\app\config.json -DestinationPath "E:\Backups\phaf-before-upgrade-$stamp.zip"

Przy SQL Server wykonaj teraz także kopię bazy danych.

3. Uruchom nowy instalator

Uruchom phaf-<nowa wersja>-setup.exe jako administrator albo z parametrem /S dla cichej aktualizacji. Instalator wykrywa istniejącą instalację i:

• przenosi bieżącą aplikację do C:\phaf\app.previous;
• instaluje nową wersję w C:\phaf\app i zachowuje Twój config.json;
• zostawia C:\phaf\data bez zmian;
• ponownie uruchamia usługę phaf.

4. Sprawdź

Przy starcie phaf dodaje do bazy danych aplikacji nowe tabele, których potrzebuje wersja. Zaloguj się — otwarta wcześniej karta przeglądarki sama się przeładuje, gdy wykryje nową wersję. Sprawdź wersję w stopce konsoli, czy przepływy są na miejscu i czy Safe Mode jest wyłączony (ponowne uruchomienie wyłącza go automatycznie, chyba że w config.json jest "safeMode": true). Obserwuj pierwsze transakcje w Activity.

Jeśli usługa działa na dedykowanym koncie, sprawdź, czy nadal ma dostęp do odczytu C:\phaf\app (zobacz uprawnienia do folderów).

Wycofanie

1. Zatrzymaj usługę phaf.
2. Zmień nazwę C:\phaf\app na C:\phaf\app-failed, a C:\phaf\app.previous z powrotem na C:\phaf\app.
3. Jeśli informacje o wersji mówią, że nowa wersja zmieniła istniejące dane, przywróć kopię z kroku 2 (i kopię bazy danych). W przeciwnym razie poprzednia wersja działa z bieżącymi danymi.
4. Uruchom usługę i prześlij nam szczegóły nieudanej aktualizacji przez wsparcie.

Deinstalacja

Otwórz Ustawienia › Aplikacje › Zainstalowane aplikacje (lub Aplikacje i funkcje), wybierz phaf DATA CONNECTOR i kliknij Odinstaluj. Deinstalator zatrzymuje i usuwa usługę oraz usuwa aplikację.

Następnie usuń to, co dodałeś samodzielnie: witrynę IIS i jej regułę zapory, konto usługi oraz — przy SQL Server — poproś DBA o usunięcie bazy phaf i loginu phaf_app.