Upgrade von Workflow Manager auf SharePoint Workflow Manager auf einer neuen Farm – SharePoint Server (2023)

GILT FÜR:201320162019AbonnementversionSharePoint und Microsoft 365

Überblick

Wenn Sie ältere SharePoint-Verträge, die Classic Workflow Manager (WFM) verwenden, auf eine neuere Version von SharePoint aktualisieren, muss auch WFM auf SharePoint Workflow Manager (SPWFM) aktualisiert werden. Da Sie eine neue Kopie von SPWFM auf neuer Hardware installieren und vorhandene WFM-Datenbanken aktualisieren, ist dieser Prozess im Wesentlichen eine Mischung aus den neuen Installations- und Upgrade-Prozessen mit einigen zusätzlichen Schritten.

Schritt 1: Bereiten Sie den alten Workflow Manager-Cluster vor

Sie benötigen Informationen aus der „alten“ Umgebung, um die „neue“ Umgebung richtig zu konfigurieren.

Holen Sie sich den Schlüssel zur Zertifikatsgenerierung

Da Sie sich für die Upgrade-Schritte bei einem vorhandenen Workflow-Cluster registrieren müssen, müssen Sie bei der erneuten Registrierung den WFM-„Zertifikatgenerierungsschlüssel“ verwenden. Wenn Sie diesen Schlüssel nicht kennen und keine schriftliche Aufzeichnung haben,Legen Sie den Zertifikatsgenerierungsschlüssel festfür WFM und Service Bus, bevor Sie fortfahren. Sie müssen sich mit dem richtigen Zertifikatsgenerierungsschlüssel beim vorhandenen Workflow-Cluster anmelden.

Kontrolle des Gebiets

Es mussspWorkflowServiceNeuregistrierung mit demselben nationalen Namen, der auf dem alten Bauernhof verwendet wurde.

1. Um den Feldnamen zu überprüfen, führen Sie die folgende PowerShell auf einem der SharePoint-Server im „alten“ Cluster aus:

Add-PSSnapin *sharepoint*$site = (Get-SPWebapplication -IncludeCentralAdministration | ?{$_.IsAdministrationWebApplication}).Sites[0]$wfmProxy = Get-SPServiceApplicationProxy | ?{$_.TypeName -eq "Workflow Service Application Proxy"}$wfmProxy.GetWorkflowServiceAddress($site)

2. Es erscheint eine Adresse ähnlich der folgenden:lokalt:12290/SharePoint2013contoso.apps.https://

Der Teil nach der Portnummer istder Name des Königreichs. In diesem Beispiel ist es „SharePoint2013“.Notieren Sie sich den Raumnamen und speichern Sie ihn für später.Sie brauchen es wannRegister-SPWorkflowServiceFahrt zum neuen Bauernhof.

Überprüfen Sie das Dienstkonto und die Administratorgruppe

1. Öffnen Sie PowerShell auf dem WFM-Server in der „alten“ Farm.
2. Implementierung

GET wffarm | Wählen Sie runasaccount,admingroup

Beispiel:

Notieren Sie sich das Konto und die Gruppe. Wenn Sie in der neuen Umgebung zum Workflow-Cluster zurückkehren, müssen Sie das Kennwort für eingebenrunAsAccountangeben. Nur Benutzer, die Mitglieder der AdminGroup sind, können den Workflow-Endpunkt-URI und den Befehl durchsuchenRegister-SPWorkflowServiceausführen.

Teilen Sie die alte WFM-Farm

1. Stellen Sie eine Verbindung zum Server her, der die WFM-Farm hostet, und öffnen Sie die Workflow Manager-Konfiguration.
2. Entscheide dichBeenden Sie die Workflow Manager-Farmund folgen Sie den Schritten, um die aktuelle Farm zu verlassen.
3. Wenn in der WFM-Farm mehrere Knoten (Hosts) vorhanden sind, wiederholen Sie diesen Schritt für jeden Knoten.

Schritt 2: Verschieben Sie die Datenbanken

Inhaltsdatenbanken verschieben

Um die Parität zwischen SharePoint-Sites und den darauf ausgeführten Workflows sicherzustellen, verschieben Sie die Inhaltsdatenbanken zusammen mit dem Anwendungsverwaltungsdienst und den WFM-Datenbanken. Das Aktualisieren von SharePoint-Inhalten geht über den Rahmen dieses Dokuments hinaus, wir werden jedoch einige Punkte im Zusammenhang mit der Aktualisierung von WFM behandeln.

Sie können die Methode „Datenbank anhängen“ verwenden, um SharePoint-Inhaltsdatenbanken vom alten Cluster in die neue Farm zu verschieben.

Weitere Informationen finden Sie unter:

• Führen Sie ein Upgrade auf eine Abonnementversion von SharePoint Server durch
• Upgrade auf SharePoint Server 2019
• Upgrade auf SharePoint Server 2016

Verschieben Sie die Anwendungsverwaltungsdatenbank

Da Workflows durch in der enthaltene Anwendungsrichtlinien für SharePoint-Inhalte lizenziert werdenAnwendungsverwaltungsdatenbankWenn die Datenbank gespeichert wurde, müssen Sie sie auch aktualisieren oder auf die neue Farm migrieren.

Dies sind die grundlegenden Schritte:

• Sichern Sie die Anwendungsverwaltungsdatenbankauf die alte Farm mithilfe von SQL Server Backup.
• Richten Sie die Anwendungsverwaltungsdatenbank einEs wird auf den neuen SQL Server zurückgesetzt.
• Erstellen Sie einen neuen AnwendungsverwaltungsdienstGehen Sie in der Zentraladministration in der neuen Farm zu „Dienstanwendungsverwaltung“ und erstellen Sie einen neuen Anwendungsverwaltungsdienst. Geben Sie im Abschnitt „Datenbank“ den SQL-Servernamen und den Datenbanknamen der Application Manager-Datenbank ein, die Sie aus der alten Farm wiederhergestellt haben. Im Grunde erstellen wir eine neue Dienstanwendung, indem wir die alte Datenbank wiederverwenden. Dadurch sollte die Datenbank auf die aktuelle Version von SharePoint aktualisiert werden.
• Stellen Sie sicher, dass sich der Dienst in der Standard-Proxy-Gruppe befindet. Stellen Sie sicher, dass sich dieser neue Anwendungsverwaltungsdienst in der Standard-Proxy-Gruppe befindet und von Ihren Webanwendungen verwendet wird.

Verschieben Sie die WFM- und Service Bus-Datenbanken

Wenn das Upgrade/die Migration das Verschieben von Datenbanken auf einen neuen SQL Server umfasst, verschieben Sie alle WFM- und Service Bus-Datenbanken.

1. Sichern Sie die Datenbanken auf dem alten SQL Server:

• SbGateway-Datenbank
• SbManagementDB
• SBMessageContainer01
• WFInstanceManagementDB
• WFManagementDB
• WFResourceManagementDB

2. Stellen Sie die Datenbanken auf dem neuen SQL Server wieder her.

Stellen Sie die Datenbanken auf dem neuen SQL Server wieder her

Erstellen Sie einen SQL-Alias

Der Workflow Manager-Konfigurationsassistent fragt Sie nur nach Verbindungsinformationen für zwei der sechs Datenbanken. Die Verbindungszeichenfolgen für die anderen vier Datenbanken werden in den beiden von Ihnen angegebenen Datenbanken gespeichert. Aus diesem Grund ist es wichtig, die Datenbanken mit denselben Namen wiederherzustellen, die zuvor verwendet wurden.
Damit die vorherigen Datenbankverbindungszeichenfolgen funktionieren, müssen Sie auch einen SQL-Alias ​​auf den neuen SPWFM-Servern erstellen.

• Suchen Sie den „alten“ SQL-Servernamen, indem Sie diese SQL-Abfrage für die Datenbank „SbManagementDB“ ausführen:

Wählen Sie Name und Wert als „SQLServerName“ aus „store.serviceconfig“ aus, wobei name = „SBGatewayDatabaseServer“ ist.

Beispiel:

• Gehen Sie auf dem SPWFM-Server zu Start | Führen Sie es aus und geben Sie „cliconfg“ ein.

• Wählen Sie auf der Registerkarte „Alias“ die Option „Hinzufügen“.
• Wählen Sie TCP/IP als Netzwerkverzeichnis.
• Geben Sie im Feld „Server-Alias“ den Namen des „alten“ SQL-Servers ein. Beispiel: „SQL“
• Geben Sie im Feld „Servername“ den Namen des „neuen“ SQL-Servers ein (Beispiel: „New_SQL“) und wählen Sie OK.

Überprüft die IIS-Serverrolle

1. Stellen Sie sicher, dass die Webserverrolle (IIS) auf Ihrem neuen SPWFM-Server installiert ist. Installieren Sie es, wenn es nicht auf dem Server vorhanden ist.

Wenn Sie SPWFM auf einem Nicht-SharePoint-Server installieren, ist es möglicherweise noch nicht installiert. Leider zwingt Sie nichts zur Installation. Andernfalls schlägt der Workflow-Konfigurationsassistent mit der Fehlermeldung „Die Datei oder Assembly „Microsoft.Web.Administration“ konnte nicht geladen werdenwird versagen.

Azure Service Fabric-Installationsprogramm

Für SharePoint Workflow Manager ist Azure Service Fabric erforderlich, das vor der Einrichtung von SharePoint Workflow Manager installiert werden muss. Wenn die Azure Service Fabric-Laufzeitumgebung noch nicht installiert ist, führen Sie die folgenden Schritte aus, um sie zu installieren:

Die von SharePoint Workflow Manager unterstützte Mindestversion der Azure Service Fabric-Laufzeitumgebung ist 9.1.1583.9590. Sie können sie von erhaltenAzure Service Fabric-LaufzeitBringen. Sie können auch eine höhere Version von Windows Installer herunterladenihrfinden und herunterladen.

Öffnen Sie eine PowerShell-Konsole als Administrator mit erhöhten Rechten und führen Sie den folgenden Befehl aus:

.\MicrosoftServiceFabric.9.1.1583.9590.exe /accepteula

Um zu bestätigen, dass Azure Service Fabric installiert ist, sollten Sie es unter „Programme und Funktionen“ in der Systemsteuerung finden.

Installation von SPWFM und des SPWFM-Clients auf dem SPWFM-Server

1. Laden Sie auf dem SPWFM-ServerSharePoint-Workflow-Manager-Client und SharePoint-Workflow-ManagerLaden Sie es herunter und installieren Sie es.

1. Laden Sie die SharePoint Workflow Manager-Clientinstallationen herunter.
2. InstallateurSharePoint Workflow-Manager-Clientauf allen SharePoint-Servern in der Farm.

Konfigurieren Sie Anwendungsverwaltungsdienste und Abonnementeinstellungen

1. Konfigurieren Sie auf dem SharePoint-Server (falls noch nicht geschehen) die EinstellungenAnwendungsverwaltungsdienstVerwendung der aktualisierten Anwendungsverwaltungsdatenbank aus der alten Farm. Weitere Informationen finden Sie oben unter „Verschieben der Anwendungsverwaltungsdatenbank“.
2. Erstellen Sie einen neuen Abonnementeinstellungsdienst.

$sa = New-SPSubscriptionSettingsServiceApplication -ApplicationPool "SharePoint Web Services Default" -Navn "Subscription Settings Service Application" -DatabaseName "Subscription"New-SPSubscriptionSettingsServiceApplicationProxy -$saerviceApplication

3. Überprüfen Sie die Anwendungsmanager- und Abonnementdienstanwendungen. Sie sollten sich im Status „Start“ befinden.

Schritt 4: Treten Sie dem Workflow-Cluster bei und führen Sie ein Upgrade durch

1. Führen Sie den SPWFM-Konfigurationsassistenten aus.
2. Öffnen Sie auf dem SPWFM-Server die Workflow Manager-Konfiguration und wählen Sie ausTreten Sie einer vorhandenen Workflow-Management-Farm bei.
3. Geben Sie die SQL Server- und Datenbankinformationen ein, die von der vorherigen „klassischen“ WFM-Installation verwendet wurden, und schließen Sie dann die Einrichtung ab.

4. Geben Sie das Passwort für das Dienstkonto und den Zertifikatsgenerierungsschlüssel ein.

5. Öffnen Sie „Workflow Manager-Konfiguration“ erneut auf dem SPWFM-Server und wählen Sie ausAktualisieren Sie die Workflow Manager-Farmund lass es bis zum Ende laufen.

Da SharePoint mit dem SPWFM-Dienstendpunkt kommunizieren muss, müssen die SharePoint-Server dem verwendeten Zertifikat vertrauen.

Exportieren Sie das Zertifikat

1. Öffnen Sie den SPWFM-ServerIIS-Manager. RechtsklickDie Website der Workflowverwaltungund auswählenBindungen bearbeitenaußer. Wählen Sie HTTPS-Verbindung auf Port 12290 und dann Bearbeiten aus. Wählen Sie die Schaltfläche „Anzeigen“ neben dem SSL-Zertifikat.

2. Wählen Sie die Registerkarte „Details“ und dann „In Datei kopieren…“.
3. Führen Sie den Zertifikatexport-Assistenten aus, um das Zertifikat ohne den privaten Schlüssel als Ganzes zu exportierenDER-codierte X.509-Binärdatei (.cer)-Zertifikat.
4. KopierenCER-Dateiauf dem SharePoint-Zentraladministrationsserver.

Hinzufügen des SPWFM-Zertifikats zur vertraulichen Farm

1. Gehen Sie zur ZentralverwaltungSicherheit > Vertrauensverwaltung.
2. Wählen Sie „Neu“ und geben Sie ihm einen Namen wie „Workflow“ oder „SPWFM“.
3. WählenSie wählen eine Datei ausund danachCER-Dateidie Sie auf den Computer kopiert haben. Entscheide dichOkayaußer.

Hinzufügen des SPWFM-Zertifikats zu den vertrauenswürdigen Stammzertifizierungsstellen

1. Klicken Sie mit der rechten Maustaste auf den zentralen Admin-ServerSPWFM-Zertifikat-CER-Dateiund auswählenInstallieren Sie ein Zertifikataußer.
2. Wählen Sie mit dem Zertifikatimport-Assistenten ausLokaler Computer > Alle Zertifikate im folgenden Speicher speichern > Durchsuchen > Vertrauenswürdige Stammzertifizierungsstellenaußer.

1. Überprüfen Sie zunächst den SPWFM-Server. A. Entscheide dichWorkflow-Management-Site. Wählen Sie im rechten Bereich ausNavigieren Sie zu *12290 (https) von. B. Öffnet einen Browser. Gehen Sie zu https://localhost:12290. Wenn Sie während der Einrichtung HTTP-Verbindungen zugelassen haben, verfügen Sie über einen HTTP-Endpunkt an Port 12291 und einen HTTPS-Endpunkt an Port 12290. C. Testen Sie die HTTP- und HTTPS-Endpunkte.

2. Überprüfen Sie dies auf Ihren SharePoint-Servern. Letztendlich müssen die SharePoint-Server eine Verbindung zum SPWFM-Endpunkt herstellen, daher müssen Sie sicherstellen, dass die Verbindung auch von dort aus hergestellt wird. A. Stellen Sie mit beiden eine Verbindung zu einem der SharePoint-Server herSPWFM-RunAs-Kontooder als Benutzer, der Mitglied der AdminGroup ist. Weitere Informationen finden Sie oben im Abschnitt „Überprüfen Sie Ihr Dienstkonto und Ihre Administratorgruppe“. B. Navigieren Sie zum FQDN des SPWFM-Endpunkts.

Beispiel:

https://Anwendungen.contoso.lokal:12290/.local.contosohttps://Anwendungen. Das Ergebnis sollte so aussehen:

Registrieren Sie den Dienst

1. Melden Sie sich bei einem beliebigen SharePoint-Server entweder als SPWFM-RunAs-Konto oder als Benutzer an, der Mitglied der AdminGroup ist. Weitere Informationen finden Sie oben im Abschnitt „Überprüfen Sie Ihr Dienstkonto und Ihre Administratorgruppe“.
2. Führen Sie den Befehl ausRegister-SPWorkflowServiceum den Workflow-Dienst in SharePoint zu registrieren. Sie benötigen den SPWFM-Endpunkt-URI, den Realmnamen, den Sie im Schritt „Realm Control“ oben notiert haben, und den Parameter „-Force“.

Beispiel:

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

Überprüfung der Konfiguration

1. Überprüfen Sie den Workflow-Service-AnwendungsproxyAnwendungsverwaltung des Zentralverwaltungsdienstes>. Wählen Sie den Link zu ausWorkflow-Dienst-Anwendungsproxyaußer. Es sollte als verbunden angezeigt werden.

Beispiel:

2. Testen eines neuen WorkflowsA. Stellen Sie eine Verbindung zu einem Client-Computer her und öffnen Sie ihnSharePoint-Designer. B. Öffnen Sie eine Ihrer Websites und gehen Sie zu „Workflows“. C. Erstellen Sie einen neuen Workflow und stellen Sie sicher, dass „SharePoint Workflow 2013“ in der Liste der Plattformen angezeigt wird, aus denen Sie auswählen können. d. h. Erstellen Sie einen grundlegenden Protokoll-Workflow in Platform History 2013 und testen Sie ihn, um sicherzustellen, dass er erfolgreich ist.

3. Testen Sie den älteren WorkflowA. Suchen Sie eine Liste, deren Workflow der „alten“ Farm zugewiesen ist. B. Starten Sie eine neue Instanz dieses Workflows und stellen Sie sicher, dass er funktioniert. Wenn Sie die Anwendungsdatenbank des Anwendungsmanagers während der Migration einbezogen haben undregister-SPWorkflowServiceMit dem korrekten Namen „Ausmaß“ sollten die Arbeitsabläufe der alten Farm weiterhin funktionieren.