1.12.4.5 Szenario E – Migration Microsoft SharePoint (mehrere Generationen) + Microsoft SQL

Dieses Szenario unterscheidet sich zu Szenario C dadurch, dass die ADVOKAT Datenbanken nicht migriert werden und beschreibt die Migration für mehrere SharePoint-Generation.
Bei der Migration einer SharePoint-Generationen wechseln Sie zum Kapitel Szenario B - Migration Microsoft SharePoint + Microsoft SQL.

Es ist empfehlenswert, die notwendigen Arbeiten in die Schritte "Vorbereitung" und "Durchführung" zu unterteilen.
Die Vorbereitungen können im laufenden Betrieb stattfinden, während für die Dauer der Durchführung ein Wartungsfenster benötigt wird.

Hinweise

In diesem Beispiel wird die Migration eines alten Microsoft SharePoint-Server mit SharePoint 2013 (Computername: SP2013) auf einen neuen Microsoft SharePoint-Server mit SharePoint 2019 (Computername: SP2019) beschrieben.
Dafür ist eine Migration des alten SharePoint-Server 2013 auf einen temporären SharePoint-Server 2016 (Computername: SP2016) und vom temporären SharePoint-Server auf den neuen (finalen) SharePoint-Server 2019 erforderlich.
Im Kapitel Microsoft SQL Datenbanken Sicherungsdauer ist beschrieben wie man ermittelt, wie lange die Sicherung/Wiederherstellung einer SQL-Datenbank benötigt.
Dies ist in diesem Zusammenhang für die Inhaltsdatenbank "WSS_Content" von Vorteil, da deren Sicherung/Wiederherstellung je nach Datenvolumen sehr lange dauern kann.

Vorbereitung

Installation und Konfiguration temporärer Microsoft SharePoint Server: Es ist wie bei der erstmaligen Installation laut Kapitel Installation und Vorbereitung vorzugehen.
- Beachten Sie in diesem Fall zusätzlich, dass der temporäre Microsoft SharePoint Server mindestens die gleiche Version wie der alte oder eine höhere verfügen muss.
  - Downgrades sind nicht möglich.
- Die Installation unterteilt sich zusammengefasst in folgende zwei Schritte:
  1. Installation Microsoft SharePoint Standard/Enterprise/Evaluation
  2. Konfiguration per Konfigurationsassistent
Installation und Konfiguration neuer (finaler) Microsoft SharePoint Server: Es ist wie bei der erstmaligen Installation laut Kapitel Installation und Vorbereitung vorzugehen.
- Beachten Sie in diesem Fall zusätzlich, dass der neue (finale) Microsoft SharePoint Server mindestens die gleiche Version wie der alte und temporäre SharePointserver oder eine höhere verfügen muss.
  - Downgrades sind nicht möglich.
- Die Installation unterteilt sich zusammengefasst in folgende drei Schritte:
  1. Installation Microsoft SharePoint Standard/Enterprise
  2. Konfiguration per Konfigurationsassistent
  3. Erstellung einer leeren SharePoint-Site
Installation und Konfiguration temporärer Datenbankserver: Es ist wie bei der erstmaligen Installation vorzugehen.
- Beachten Sie in diesem Fall zusätzlich, dass der temporäre Microsoft SQL Server mindestens die gleiche Version wie der bisherige oder eine höhere verfügen muss.
  - Downgrades sind nicht möglich.
Installation und Konfiguration neuer (finaler) Datenbankserver: Es ist wie bei der erstmaligen Installation vorzugehen.
- Beachten Sie in diesem Fall zusätzlich, dass der neue (finale) Microsoft SQL Server mindestens die gleiche Version wie der alte und temporäre Datenbankserver oder eine höhere verfügen muss.
  - Downgrades sind nicht möglich.
Führen Sie testweise einen Export der Microsoft SharePoint Inhaltsdatenbank "WSS_Content" am alten Datenbankserver durch.
Führen Sie testweise das Anfügen der Datenbank am temporären und neuen (finalen) Datenbankserver durch.
Für das Wartungsfenster bei der Durchführung müssen die Wartezeit für Export und Import der Datenbank berücksichtigt werden, diese Wartezeit wird in der Praxis oftmals massiv unterschätzt.

Durchführung

Sicherstellen, dass ADVOKAT und Microsoft Office Outlook auf allen Arbeitsplätzen geschlossen sind.
- ADVOKAT Frontend auf einer Arbeitsstation oder Terminalserver starten.
- Am Startbildschirm von ADVOKAT "STRG + SHIFT + Doppelklick linke Maustaste" drücken.
- Option "Advokat Programmstart sperren" aktivieren
- Im Fenster "Optional zusätzlicher Text für die Meldung" einen Informationstext eingeben, Beispiel: ADVOKAT Update von 12:00 bis 12:15 Uhr.
  
  Auf allen anderen Geräten kann ADVOKAT nun nicht mehr gestartet werden.
  Alle Benutzer, welche sich zu diesem Zeitpunkt noch im Programm befinden werden nach einer Wartefrist von 5 Minuten getrennt.
Aktualisieren Sie die Gruppenrichtlinien und die Ausnahmen in der Antivirensoftware laut Kapitel Gruppenrichtlinien und Antivirensoftware, sodass diese zum neuen (finalen) Datenbank- und SharePointserver passen.
Verbinden Sie sich per Remotedesktop auf den temporären Microsoft SharePoint-Server, als Windows Benutzerkonto muss der SharePoint-Administrator gewählt werden.
- Öffnen Sie die SharePoint Zentraladministration. Navigieren Sie dort zu "Inhaltsdatenbanken verwalten".
- Wählen Sie die Inhaltsdatenbank "WSS_Content" und aktivieren Sie die Checkbox "Inhaltsdatenbank entfernen", klicken Sie zuletzt auf "OK".
Verbinden Sie sich per Remotedesktop auf den neuen (finalen) Microsoft SharePoint-Server, als Windows Benutzerkonto muss der SharePoint-Administrator gewählt werden.
- Öffnen Sie die SharePoint Zentraladministration. Navigieren Sie dort zu "Inhaltsdatenbanken verwalten".
- Wählen Sie die Inhaltsdatenbank "WSS_Content" und aktivieren Sie die Checkbox "Inhaltsdatenbank entfernen", klicken Sie zuletzt auf "OK".
- Falls mehrere Dokumentbibliotheken mit jeweils einer eigenen Inhaltsdatenbank genutzt werden, so ist dieser Schritt für alle Inhaltsdatenbanken durchzuführen.
Verbinden Sie sich per Remotedesktop auf den alten Datenbankserver und öffnen Sie Microsoft SQL Management Studio.
Starten Sie den Export der Inhaltsdatenbank "WSS_Content" und übertragen Sie das Dumpfile (.BAK) auf den temporären Datenbankserver.
- Verbinden Sie sich per Remotedesktop auf den temporären Datenbankserver und öffnen Sie Microsoft SQL Management Studio.
- Löschen Sie die existierende Inhaltsdatenbank "WSS_Content" – jene des temporären Microsoft SharePoint-Server. Starten Sie den Import der zuvor übertragenen Inhaltsdatenbank "WSS_Content".
- Falls mehrere Dokumentbibliotheken mit jeweils einer eigenen Inhaltsdatenbank genutzt werden, so ist dieser Schritt für alle Inhaltsdatenbanken durchzuführen.
Stellen Sie sicher, dass SharePoint-Administrator des temporären Microsoft SharePoint-Server über das Recht "sysadmin" und für die importierte(n) Inhaltsdatenbank(en) "WSS_Content" die Rolle "db_owner" verfügt.
Verbinden Sie sich per Remotedesktop auf den temporären Microsoft SharePoint-Server, als Windows Benutzerkonto muss der SharePoint-Administrator gewählt werden.
Öffnen Sie die Microsoft SharePoint Verwaltungsshell (nicht reguläre Microsoft Powershell). Es ist zu überprüfen, ob ein Upgrade der Inhaltsdatenbank und Site möglich sind.
Info

Test-SPContentDatabase -Name WSS_Content -WebApplication http://SharePoint-Servername
Es erscheint eine Reihe von Einträgen, ausschlaggebend ist, dass bei der Zeile "UpgradeBlocking" das Ergebnis "False" lautet.
Lautet das Ergebnis "True", dann werden die weiteren Schritte nicht funktionieren, das Einbinden der Inhaltsdatenbank "WSS_Content" in der temporären Umgebung wird fehlschlagen.
Öffnen Sie die Microsoft SharePoint Verwaltungsshell (nicht reguläre Microsoft Powershell). Fügen Sie die Inhaltsdatenbank des alten Microsoft SharePointserver hinzu.
Wichtig: Nutzen Sie dazu keinesfalls die SharePoint Zentraladministration sondern immer die SharePoint Verwaltungsshell!

Mount-SPContentDatabase -Name WSS_Content -WebApplication http://SharePoint-Servername
Falls mehrere Dokumentbibliotheken mit jeweils einer eigenen Inhaltsdatenbank genutzt werden, so ist dieser Schritt für alle Inhaltsdatenbanken durchzuführen.
Dieser Schritt ist nur bei einem Wechsel von Microsoft SharePoint 2010 auf SharePoint 2013 erforderlich, andernfalls überspringen Sie diesen Punkt.
1. Es muss die Authentifizierungsmethode per Microsoft SharePoint Verwaltungsshell angepasst werden:
  
  Convert-SPWebApplication -Identity "http://SharePoint-Servername" -To Claims -RetainPermissions -Force
  Hinweise
  - Bei Verwendung von SSL muss die URL mit https anstatt http angegeben werden.
  - Wird man nach einem Wert für den Parameter "From" gefragt, so gibt man den Wert "Legacy" ein.
2. Es muss eine Aktualisierung (Upgrade) der SiteCollection per Microsoft SharePoint Verwaltungsshell durchgeführt werden:
  Info
  
  Upgrade-SPSite http://SharePoint-Servername -VersionUpgrade
  Hinweise
  - Bei Verwendung von SSL muss die URL mit https anstatt http angegeben werden.
Führen Sie einen Neustart des IIS per iisreset am temporären Microsoft SharePoint-Server durch.

Befehlszeilenkommando (mit administrativen Rechten): iisreset
Starten Sie am temporären SharePointserver den Microsoft SharePoint Konfigurationsassistenten, dieser aktualisiert die laut Schritt 8 eingebundene(n) Inhaltsdatenbank(en).
- Dieser Vorgang kann unter Umständen mehrere Durchläufe des Konfigurationsassistenten benötigen. Starten Sie diesen also so oft, bis keine Fehlermeldungen mehr auftreten.
- Im Anschluss an den Konfigurationsassistenten öffnet sich ein weiterer Assistent im Internet Browser zwecks Konfiguration der SharePoint Farm. Dieser Assistent wird mit "Abbrechen" (Cancel) beendet.
Öffnen Sie Microsoft SQL Management Studio am temporären Datenbankserver und starten den Export der Inhaltsdatenbank "WSS_Content". Anschließend übertragen Sie das Dumpfile (.BAK) auf den neuen (finalen) Datenbankserver.
- Verbinden Sie sich per Remotedesktop auf den neuen (finalen) Datenbankserver und öffnen Sie Microsoft SQL Management Studio.
- Löschen Sie die existierende Inhaltsdatenbank "WSS_Content" – jene des neuen (finalen) Microsoft SharePoint-Server. Starten Sie den Import der zuvor übertragenen Inhaltsdatenbank "WSS_Content".
- Falls mehrere Dokumentbibliotheken mit jeweils einer eigenen Inhaltsdatenbank genutzt werden, so ist dieser Schritt für alle Inhaltsdatenbanken durchzuführen.
Stellen Sie sicher, dass SharePoint-Administrator des neuen (finalen) Microsoft SharePoint-Server über das Recht "sysadmin" und für die importierte(n) Inhaltsdatenbank(en) "WSS_Content" die Rolle "db_owner" verfügt.
Verbinden Sie sich per Remotedesktop auf den neuen (finalen) Microsoft SharePoint-Server, als Windows Benutzerkonto muss der SharePoint-Administrator gewählt werden.
Öffnen Sie die Microsoft SharePoint Verwaltungsshell (nicht reguläre Microsoft Powershell). Es ist zu überprüfen, ob ein Upgrade der Inhaltsdatenbank und Site möglich sind.
Info

Test-SPContentDatabase -Name WSS_Content -WebApplication http://SharePoint-Servername
Es erscheint eine Reihe von Einträgen, ausschlaggebend ist, dass bei der Zeile "UpgradeBlocking" das Ergebnis "False" lautet.
Lautet das Ergebnis "True", dann werden die weiteren Schritte nicht funktionieren, das Einbinden der Inhaltsdatenbank "WSS_Content" in der temporären Umgebung wird fehlschlagen.
Öffnen Sie die Microsoft SharePoint Verwaltungsshell (nicht reguläre Microsoft Powershell). Fügen Sie die Inhaltsdatenbank des temporären Microsoft SharePointserver hinzu.
Wichtig: Nutzen Sie dazu keinesfalls die SharePoint Zentraladministration sondern immer die SharePoint Verwaltungsshell!

Mount-SPContentDatabase -Name WSS_Content -WebApplication http://SharePoint-Servername
Falls mehrere Dokumentbibliotheken mit jeweils einer eigenen Inhaltsdatenbank genutzt werden, so ist dieser Schritt für alle Inhaltsdatenbanken durchzuführen.
Führen Sie einen Neustart des IIS per iisreset am neuen (finalen) Microsoft SharePoint-Server durch.

Befehlszeilenkommando (mit administrativen Rechten): iisreset
Starten Sie am neuen (finalen) SharePointserver den Microsoft SharePoint Konfigurationsassistenten, dieser aktualisiert die laut Schritt 14 eingebundene(n) Inhaltsdatenbank(en).
- Dieser Vorgang kann unter Umständen mehrere Durchläufe des Konfigurationsassistenten benötigen. Starten Sie diesen also so oft, bis keine Fehlermeldungen mehr auftreten.
- Im Anschluss an den Konfigurationsassistenten öffnet sich ein weiterer Assistent im Internet Browser zwecks Konfiguration der SharePoint Farm. Dieser Assistent wird mit "Abbrechen" (Cancel) beendet.
Navigieren Sie am neuen (finalen) SharePointserver per Windows Explorer zum ADVOKAT Backend unter "...\ADVOKAT\Admin\Support\Adv2SharePoint" und starten das Tool "Advokat8.DMS.SharePoint.Manager.exe".
Geben Sie im Feld "Advokat.ini" per Schaltfläche "Öffnen" den Pfad zur Konfigurationsdatei "Advokat.ini" an. Achten Sie darauf, den Pfad zur Datei wie aus Sicht eines Arbeitsplatzes anzugeben.

Nach Angabe der Konfigurationsdatei werden dessen Einträge und die Verbindungen zu den ADVOKAT Datenbanken geprüft.
Sobald die Prüfungen abgeschlossen sind, werden die ausgelesenen Informationen im Bereich "Bibliotheken verwalten" angezeigt.
Markieren Sie im Bereich "Bibliotheken verwalten" die Dokumentbibliothek vom alten SharePoint-Server und wählen im rechten Bereich "Dokumentbibliothek neu zuweisen".

Im Fenster "Dokumentbibliothek neu zuweisen" müssen die Felder "WebAnwendung", "SiteCollection", "Site" und "Dokumentbibliothek" befüllt werden.

Aufgrund der Migration steht die Dokumentbibliothek am neuen SharePoint-Server mit gleicher SiteCollection, Site und Bibliotheknamen wie am alten SharePoint-Server zur Verfügung.
Klicken Sie auf "Starten" und warten bis der Vorgang abgeschlossen ist. Bei Problemen wechseln Sie zum Kapitel SharePoint-Tool Fehlermeldungen.
Verfügen der alte und neue (finale) SharePointserver über den selben Computernamen (Stichwort: Alias), dann erscheint noch folgende Abfrage, welche Sie mit "Ja" bestätigen:
- Das DMS <Dokumentbibliothek> existiert bereits in ADVOKAT. Soll trotzdem neu zugewiesen werden?

Relevante Einstellungen

Feld	Beschreibung	Beispiele (alter SharePoint-Server)	Beispiele (neuer SharePoint-Server)
WebAnwendung	Wählen Sie die WebAnwendung aus.	SharePoint - 80	SharePoint - 80
SiteCollection	Wählen Sie die SiteCollection aus.	http://SP2013 http://SP2013/websites/	http://SP2019 http://SP2019/websites/
Site	Wählen Sie die Site am neuen SharePoint-Server aus.	http://SP2013 http://SP2013/websites/Advokat/	http://SP2019 http://SP2019/websites/Advokat/
Dokumentbibliothek	Wählen Sie die Dokumentbibliothek mit dem Namen wie am alten SharePoint-Server aus. Steht diese nicht zur Auswahl, dann wurde die falsche SiteCollection und/oder Site gewählt.	AdvokatSharePointWinword AdvSP	AdvokatSharePointWinword AdvSP

Falls mehrere Dokumentbibliotheken genutzt werden, so müssen Schritt 19 bis 20 für jede weitere Dokumentbibliothek wiederholt werden.
Navigieren Sie am neuen (finalen) SharePointserver per Windows Explorer zum ADVOKAT Backend unter "...\ADVOKAT\Daten" und öffnen die Konfigurationsdatei "Advokat.ini" mit einem Texteditor.
Suchen Sie den Konfigurationsschalter SSEARCH und aktualisieren Sie die URL passend zum neuen (finalen) SharePointserver.
Beispiel (vorher) Beispiel (nachher)
SSEARCH=http://SP2013/_vti_bin/search.asmx
SSEARCH=http://SP2019/_vti_bin/search.asmx
Diese Konfigurationsschalter können Sie ignorieren (falls vorhanden), diese werden nicht mehr verwendet:
DM-External, DM-Library, DM-MaxFileSize, SP-Admin, SP-AdminPW, SPWWDokumente, SPDatenbank, SPTabellbank
Führen Sie die Konfiguration für die Volltextsuche von Microsoft SharePoint wie im Kapitel Volltextsuche konfigurieren und optional Volltextsuche für externe Verzeichnisse konfigurieren durch.
Soll Microsoft SharePoint per HTTPS (SSL) betrieben werden, dann wechseln Sie zum Kapitel Microsoft SharePoint Aktivierung SSL.
Sperre des Programmstarts aufheben, starten Sie ADVOKAT am gleichen Gerät wie bei Schritt 1, es erscheint folgende Meldung, welche Sie mit "Ja" bestätigen:
Abfrage

Soll die Sperre für die anderen Benutzer wieder aufgehoben werden?