1.12.4.1 Szenario A – Migration Microsoft SharePoint

Owned by Johannes Driendl
Last updated: Sept. 26, 2024
4 min read

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

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

  1. Installation und Konfiguration 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 Microsoft SharePoint Server mindestens die gleiche Version wie der bisherige 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

  2. 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.
    • Die Zeit für das Anfügen entspricht der Zeit des Exports. Führen Sie testweise einen Export der Microsoft SharePoint Inhaltsdatenbank "WSS_Content" am Datenbankserver durch.
    • Es ist später bei der Durchführung in Problemfällen das Entfernen und anschließende Anfügen dieser Datenbank erforderlich.


Durchführung

  1. 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.

  2. Aktualisieren Sie die Gruppenrichtlinien und die Ausnahmen in der Antivirensoftware laut Kapitel Gruppenrichtlinien und Antivirensoftware, sodass diese zum neuen Microsoft SharePoint-Server passen.

  3. Verbinden Sie sich per Remotedesktop auf den alten 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".
    • Achtung: Dieser Vorgang kann mehrere Minuten oder gar Stunden – abhängig von der Datenbankgröße – beanspruchen.
    • Falls mehrere Dokumentbibliotheken mit jeweils einer eigenen Inhaltsdatenbank genutzt werden, so ist dieser Schritt für alle Inhaltsdatenbanken durchzuführen.

  4. Verbinden Sie sich per Remotedesktop auf den neuen Microsoft SharePoint-Server, als Windows Benutzerkonto muss der SharePoint-Administrator gewählt werden.

    1. Ö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".

    2. Ö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.

  5. 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.


  6. Führen Sie einen Neustart der Internetinformationsdienste (IIS) per iisreset durch.

    Befehlszeilenkommando (mit lokalen administrativen Rechten): iisreset

       

  7. Starten Sie den Microsoft SharePoint Konfigurationsassistenten, dieser aktualisiert die laut Schritt 4 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.

  8. Navigieren Sie 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.

  9. Markieren Sie im Bereich "Bibliotheken verwalten" die Dokumentbibliothek vom alten SharePoint-Server und wählen im rechten Bereich "Dokumentbibliothek neu zuweisen".


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

    1. Aufgrund von Punkt 3 und 4 steht die Dokumentbibliothek am neuen SharePoint-Server mit gleicher SiteCollection, Site und Bibliotheknamen wie am alten SharePoint-Server zur Verfügung.

    2. Klicken Sie auf "Starten" und warten bis der Vorgang abgeschlossen ist. Bei Problemen wechseln Sie zum Kapitel SharePoint-Tool Fehlermeldungen.

    3. Verfügen der alte- und neue 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?

    4. Relevante Einstellungen

      FeldBeschreibungBeispiele (alter SharePoint-Server)Beispiele (neuer SharePoint-Server)
      WebAnwendungWählen Sie die WebAnwendung aus.SharePoint - 80SharePoint - 80
      SiteCollectionWählen Sie die SiteCollection aus.

      http://SHAREPOINT
      http://SHAREPOINT/websites/

      http://SHAREPOINT-NEU
      http://SHAREPOINT-NEU/websites/

      SiteWählen Sie die Site am neuen SharePoint-Server aus.

      http://SHAREPOINT
      http://SHAREPOINT/websites/Advokat/

      http://SHAREPOINT-NEU
      http://SHAREPOINT-NEU/websites/Advokat/

      DokumentbibliothekWä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

         

  11. Falls mehrere Dokumentbibliotheken genutzt werden, so müssen Schritt 9 bis 10 für jede weitere Dokumentbibliothek wiederholt werden.

  12. Navigieren Sie 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 SharePoint-Server.

    Beispiel (vorher)Beispiel (nachher)

    SSEARCH=http://SHAREPOINT/_vti_bin/search.asmx

    		SSEARCH=http://SHAREPOINT-NEU/_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

  13. 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.

  14. Soll Microsoft SharePoint per HTTPS (SSL) betrieben werden, dann wechseln Sie zum Kapitel Microsoft SharePoint Aktivierung SSL. 

  15. 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?

Copyright © 2024 ADVOKAT Unternehmensberatung GREITER & GREITER GmbH - Impressum ->https://advokat.at/Impressum.aspx