Uaktualnienie z Workflow Manager do SharePoint Workflow Manager na nowej farmie — SharePoint Server (2023)

DOTYCZY: 201320162019Wersja subskrypcyjnaProgram SharePoint na platformie Microsoft 365

Przegląd

Podczas uaktualniania starszych farm programu SharePoint korzystających z klasycznego Menedżera przepływu pracy (WFM) do nowszej wersji programu SharePoint należy również uaktualnić WFM do programu SharePoint Workflow Manager (SPWFM). Ponieważ instalujesz świeżą kopię SPWFM na nowym sprzęcie i aktualizujesz istniejące bazy danych WFM, ta procedura jest zasadniczo mieszanką nowych procedur instalacji i aktualizacji z kilkoma dodatkowymi krokami.

Krok 1: Przygotuj starą farmę Workflow Manager

Potrzebujesz informacji ze „starego” środowiska, aby poprawnie skonfigurować „nowe” środowisko.

Uzyskaj klucz generowania certyfikatu

Ponieważ kroki aktualizacji wymagają dołączenia do istniejącej farmy przepływu pracy, do ponownego dołączania potrzebny jest „Klucz generowania certyfikatu” WFM. Jeśli nie wiesz, co to za klucz i nie masz pisemnego zapisu,zresetować klucz generowania certyfikatudla WFM i Service Bus przed kontynuowaniem. Musisz dołączyć do istniejącej farmy przepływu pracy z odpowiednim kluczem generowania certyfikatu.

Sprawdź zakres

Musisz ponownie zarejestrowaćSPWorkflowServiceprzy użyciu tej samej nazwy zakresu, która była używana w starej farmie.

1. Aby sprawdzić nazwę zakresu, uruchom następujący PowerShell na jednym z serwerów SharePoint w „starej” farmie:

Add-PSSnapin *sharepoint*$site = (Get-SPWebapplication -IncludeCentralAdministration | ?{$_.IsAdministrationWebApplication}).Sites[0]$wfmProxy = Get-SPServiceApplicationProxy | ?{$_.TypeName -eq "Proxy aplikacji usługi przepływu pracy"} $wfmProxy.GetWorkflowServiceAddress($site)

2. Wyświetlany jest adres podobny do tego:https://aplikacje.contoso.lokalnie:12290/SharePoint2013

Część po numerze portu tonazwa zakresu. W tym przykładzie jest to „SharePoint2013”.Zapisz nazwę zakresu i zachowaj ją na później.Potrzebujesz go podczas bieganiaRegister-SPWorkflowServicew nowym gospodarstwie.

Sprawdź konto usługi i grupę administratorów

1. Na serwerze WFM w „starej” farmie otwórz PowerShell.
2. Uruchomić

GET-wffarm | wybierz runasaccount, admingroup

Przykład:

Zanotuj konto i grupę. Po ponownym dołączeniu do farmy przepływu pracy w nowym środowisku należy podać hasło dlaUruchom jako konto. Tylko użytkownicy, którzy są członkami AdminGroup, mogą przeglądać identyfikator URI punktu końcowego przepływu pracy i uruchamiać plikRegister-SPWorkflowServiceKomenda.

Odłącz starą farmę WFM

1. Zaloguj się do serwera obsługującego farmę WFM i otwórz „Konfiguracja Workflow Manager”.
2. WybieraćOpuść farmę Menedżera przepływu pracyi wykonaj kroki, aby opuścić obecną farmę.
3. Jeśli masz wiele węzłów (hostów) w swojej farmie WFM, powtórz ten krok dla każdego węzła.

Krok 2: Przenieś bazy danych

Przenieś bazy danych treści

Aby zachować zgodność między witrynami programu SharePoint i przepływami pracy w nich działającymi, należy przenieść bazy danych zawartości wraz z usługą zarządzania aplikacjami i bazami danych WFM. Uaktualnianie zawartości programu SharePoint wykracza poza zakres tego dokumentu, ale odwołujemy się do kilku elementów związanych z aktualizacją WFM.

Za pomocą metody dołączania bazy danych można przenosić bazy danych zawartości programu SharePoint ze starej farmy do nowej.

Dowiedz się więcej na:

• Uaktualnienie do wersji subskrypcyjnej programu SharePoint Server
• Uaktualnij do programu SharePoint Server 2019
• Uaktualnij do SharePoint Server 2016

Przenieś bazę danych zarządzania aplikacjami

Ponieważ przepływy pracy uzyskują uprawnienia do zawartości programu SharePoint za pośrednictwem podmiotów zabezpieczeń aplikacji przechowywanych w plikuBaza danych zarządzania aplikacjami, musisz także uaktualnić/przenieść tę bazę danych do nowej farmy.

Oto podstawowe kroki:

• Utwórz kopię zapasową bazy danych zarządzania aplikacjamiw starej farmie przy użyciu kopii zapasowej SQL Server.
• Przywróć bazę danych zarządzania aplikacjamido nowego serwera SQL.
• Utwórz nową usługę zarządzania aplikacjamiW administracji centralnej w nowej farmie przejdź do Zarządzaj aplikacjami usługi i utwórz nową usługę zarządzania aplikacjami. W sekcji Baza danych wprowadź nazwę serwera SQL i nazwę bazy danych zarządzania aplikacjami, która została przywrócona ze starej farmy. Zasadniczo tworzymy nową aplikację usługi, ponownie wykorzystując starą bazę danych. To powinno zaktualizować bazę danych do bieżącej wersji programu SharePoint.
• Potwierdź, że usługa znajduje się w domyślnej grupie proxy. Upewnij się, że ta nowa usługa zarządzania aplikacjami znajduje się w domyślnej grupie proxy i że używają jej aplikacje internetowe.

Przenieś bazy danych WFM i Service Bus

Jeśli uaktualnienie/migracja obejmuje przeniesienie baz danych na nowy serwer SQL, należy przenieść wszystkie bazy danych WFM i Service Bus.

1. Wykonaj kopię zapasową baz danych na starym serwerze SQL:

• Baza danych SbGateway
• SbManagementDB
• SBMessageContainer01
• WFInstanceManagementDB
• WFManagementDB
• WFRResourceManagementDB

2. Przywróć bazy danych na nowym serwerze SQL.

Przywróć bazy danych na nowym serwerze SQL

Utwórz alias SQL

Kreator konfiguracji menedżera przepływu pracy monituje tylko o wprowadzenie informacji o połączeniu dla 2 z sześciu baz danych. Parametry połączenia dla pozostałych czterech baz danych są przechowywane w dwóch określonych bazach danych. Dlatego ważne jest, aby przywrócić bazy danych z tymi samymi nazwami, które były używane wcześniej.
Aby zachować działanie poprzednich łańcuchów połączeń DB, należy również utworzyć alias SQL na nowych serwerach SPWFM.

• Znajdź nazwę „starego” serwera SQL, uruchamiając to zapytanie SQL w bazie danych „SbManagementDB”:

wybierz nazwę, wartość jako „SQLServerName” z store.serviceconfig gdzie nazwa = „SBGatewayDatabaseServer”

Przykład:

• Na serwerze SPWFM przejdź do Start | Uruchom i wpisz „cliconfg”

• Na karcie Alias ​​wybierz Dodaj.
• Wybierz TCP/IP dla Biblioteki sieciowej.
• W polu „Server Alias” wpisz nazwę „starego” serwera SQL. Przykład: „SQL”
• W polu „Nazwa serwera” wpisz nazwę „nowego” serwera SQL (przykład: „New_SQL”) i wybierz OK.

Sprawdź rolę serwera usług IIS

1. Sprawdź, czy masz zainstalowaną rolę serwera „Web Server (IIS)” na nowym serwerze SPWFM. Zainstaluj go, jeśli nie ma go na serwerze.

Jeśli instalujesz SPWFM na serwerze innym niż SharePoint, być może nie jest on jeszcze zainstalowany. Niestety, nic nie zmusza cię do jej zainstalowania, więc jeśli tego nie zrobisz, Kreator konfiguracji przepływu pracy zakończy się niepowodzeniem z błędem „Nie można załadować pliku lub zestawu „Microsoft.Web.Administration".

Zainstaluj usługę Azure Service Fabric

Program SharePoint Workflow Manager wymaga platformy Azure Service Fabric, którą należy zainstalować przed uruchomieniem instalacji programu SharePoint Workflow Manager. Jeśli środowisko uruchomieniowe usługi Azure Service Fabric nie jest jeszcze zainstalowane, wykonaj poniższe czynności, aby je zainstalować:

Minimalna wersja Azure Service Fabric Runtime obsługiwana przez SharePoint Workflow Manager to 9.1.1583.9590 i można ją pobrać zŚrodowisko uruchomieniowe usługi Azure Service Fabric. Lub możesz znaleźć i pobrać dowolną wyższą wersję Instalatora Windows zTutaj.

Otwórz konsolę PowerShell jako administrator z podwyższonym poziomem uprawnień i uruchom następujące polecenie:

.\MicrosoftServiceFabric.9.1.1583.9590.exe /accepteula

Aby sprawdzić, czy usługa Azure Service Fabric jest zainstalowana, powinieneś być w stanie znaleźć ją w Programy i funkcje w Panelu sterowania.

Zainstaluj SPWFM i klienta SPWFM na serwerze SPWFM

1. Na serwerze SPWFM pobierz i zainstaluj plikKlient SharePoint Workflow Manager i SharePoint Workflow Manager

1. Pobierz instalator klienta programu SharePoint Workflow Manager.
2. ZainstalujKlient Menedżera przepływu pracy programu SharePointna wszystkich serwerach SharePoint w farmie.

Skonfiguruj usługi zarządzania aplikacjami i ustawień subskrypcji

1. Na serwerze SharePoint (jeśli jeszcze tego nie zrobiłeś) skonfigurujZarządzanie aplikacjamiusługi przy użyciu zaktualizowanej bazy danych zarządzania aplikacjami ze starej farmy. Zobacz krok „Przenieś bazę danych zarządzania aplikacjami” powyżej.
2. Utwórz nową usługę ustawień subskrypcji.

$sa = New-SPSubscriptionSettingsServiceApplication -ApplicationPool 'SharePoint Web Services Default' -Name 'Subscriptions Settings Service Application' -DatabaseName 'Subscription'New-SPSubscriptionSettingsServiceApplicationProxy -ServiceApplication $sa

3. Sprawdź aplikacje usługi Zarządzanie aplikacjami i Subskrypcja. Powinny być w stanie „Uruchomiono”.

Krok 4: Dołącz ponownie do Workflow Farm i uaktualnij

1. Uruchom kreatora konfiguracji SPWFM.
2. Na serwerze SPWFM otwórz „Konfiguracja menedżera przepływu pracy” i wybierzDołącz do istniejącej farmy Workflow Manager.
3. Wprowadź dane programu SQL Server i bazy danych, z których korzystała poprzednia „klasyczna” instalacja programu WFM, a następnie uruchom konfigurację.

4. Wprowadź hasło do konta usługi oraz Klucz generowania certyfikatu.

5. Na serwerze SPWFM ponownie otwórz „Konfiguracja menedżera przepływu pracy” i wybierzUaktualnij farmę menedżera przepływu pracyi pozwól mu działać, aż skończy.

Ponieważ program SharePoint musi kontaktować się z punktem końcowym usługi SPWFM, serwery programu SharePoint muszą ufać używanemu certyfikatowi.

Wyeksportuj certyfikat

1. Na serwerze SPWFM otwórzMenedżer usług IIS. Kliknij prawym przyciskiem myszyWitryna zarządzania przepływem pracyi wybierzEdytuj powiązania. Wybierz powiązanie HTTPS na porcie 12290 i wybierz pozycję Edytuj. Wybierz przycisk „Wyświetl” obok certyfikatu SSL.

2. Wybierz kartę Szczegóły i wybierz „Kopiuj do pliku…”
3. Uruchom kreatora eksportu certyfikatów, aby wyeksportować certyfikat bez klucza prywatnego jako plikKodowany binarnie kod DER X.509 (.CER)certyfikat.
4. Skopiujcerplik na serwer administracji centralnej SharePoint.

Dodaj certyfikat SPWFM do Farm Trust

1. W Administracji Centralnej, aby przejśćBezpieczeństwo > Zarządzaj zaufaniem.
2. Wybierz Nowy, nadaj mu nazwę „Przepływ pracy” lub „SPWFM”.
3. WybieraćWybierz plik, a następnie wybierzcerplik skopiowany na komputer. WybieraćOK.

Dodaj certyfikat SPWFM do zaufanych urzędów głównych

1. Na serwerze administratora centralnego kliknij prawym przyciskiem myszy plikCertyfikat SPWFM .cerplik i wybierzZainstaluj certyfikat.
2. Korzystając z Kreatora importu certyfikatów, wybierzKomputer lokalny > Umieść wszystkie certyfikaty w następującym magazynie > Przeglądaj > Zaufane główne urzędy certyfikacji.

1. Najpierw sprawdź z serwera SPWFM. A. WybieraćWitryna zarządzania przepływem pracy. Wybierz w prawym okienkuPrzeglądaj *12290 (https). B. Otworzy się przeglądarka; przejdź do https://localhost:12290. Jeśli podczas konfiguracji zezwoliłeś na połączenia przez HTTP, punkt końcowy HTTP będzie na porcie 12291, a punkt końcowy HTTPS na porcie 12290. c. Przetestuj zarówno punkty końcowe http, jak i https.

2. Sprawdź na swoich serwerach SharePoint. Ostatecznie to twoje serwery SharePoint muszą łączyć się z punktem końcowym SPWFM, więc musisz potwierdzić, że jest tam również łączność. A. Zaloguj się do jednego ze swoich serwerów programu SharePoint za pomocąSPWFM RunAskonto lub jako użytkownik będący członkiem AdminGroup. Zobacz krok „Sprawdź konto usługi i grupę administracyjną” powyżej. B. Przejdź do nazwy FQDN punktu końcowego SPWFM.

Na przykład:

https://aplikacje.contoso.lokalny:12290/. Wynik powinien wyglądać tak:

Zarejestruj usługę

1. Zaloguj się do dowolnego serwera SharePoint jako konto SPWFM RunAs lub jako użytkownik będący członkiem AdminGroup. Zobacz krok „Sprawdź konto usługi i grupę administracyjną” powyżej.
2. UruchomRegister-SPWorkflowServicepolecenie, aby zarejestrować usługę przepływu pracy w SharePoint. Potrzebujesz identyfikatora URI punktu końcowego SPWFM, nazwy zakresu zebranego w powyższym kroku „Sprawdź zakres” i będziesz musiał dołączyć parametr -Force.

Przykład:

Register-SPWorkflowService -SPSite http://www.contoso.local -WorkflowHostUri https://spwfm.contoso.local:12290 -ScopeName SharePoint2013 -Force

Potwierdź konfigurację

1. Sprawdź serwer proxy aplikacji usługi przepływu pracy wAdministracja centralna > Zarządzaj aplikacjami usług. Wybierz łącze dlaSerwer proxy aplikacji usługi przepływu pracy. Powinien być wyświetlany jako połączony.

Przykład:

2. Przetestuj nowy przepływ pracyA. Zaloguj się do komputera klienckiego, a następnie otwórzProjektant programu SharePoint.B. Otwórz jedną ze swoich witryn i przejdź do przepływów pracy. C. Utwórz nowy przepływ pracy i upewnij się, że widzisz „SharePoint Workflow 2013” ​​na liście platform do wyboru. D. Utwórz podstawowy przepływ pracy platformy 2013 „loguj do historii” i przetestuj, aby upewnić się, że się powiedzie.

3. Przetestuj stary przepływ pracyA. Znajdź listę, do której przypisano przepływ pracy w „starej” farmie. B. Uruchom nową instancję tego przepływu pracy i sprawdź, czy działa. Jeśli podczas migracji uwzględniono bazę danych aplikacji usługi zarządzania aplikacjami i uruchomiono plikRegister-SPWorkflowServiceużywając poprawnej nazwy „zakresu”, przepływy pracy ze starej farmy powinny nadal działać.