4.1.8.2 Microsoft SharePoint FQDN Änderung

Dieses Kapitel ist nur relevant, wenn ADVOKAT mit Microsoft SQL und Microsoft SharePoint betrieben wird und der SharePointserver nicht per Servername sondern per FQDN hinterlegt werden soll.
Dies kann beispielsweise erforderlich sein, wenn Dokumente aus einer SharePoint Dokumentbibliothek von externen Geräten per VPN-Client oder öffentlicher URL abgerufen werden sollen.

Beachten Sie, dass für diese Migration ein Wartungsfenster benötigt wird, die Änderungen können nicht im laufenden Betrieb durchgeführt werden.

Hinweise

In diesem Kapitel sind zwei Beispiele beschrieben
- In Beispiel 1 lautet der Servername "http://SHAREPOINT" und der FQDN "http://SHAREPOINT.advokat.at".
- In Beispiel 2 lautet der Servername "https://SHAREPOINT" und der FQDN "https://SHAREPOINT.advokat.at".
Hyperlinks und Verknüpfungen welche sich außerhalb von ADVOKAT, also im Windows Explorer, Internet Browser, E-Mails oder Dokumenten befinden werden durch diese Änderung nicht aktualisiert.
Diese Anpassung greift nur für Hyperlinks und Verknüpfungen welche ab diesem Zeitpunkt neu erstellt werden.

Anleitung

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.
Verbinden Sie sich per Remotedesktop auf den Microsoft SharePoint-Server, als Windows Benutzerkonto muss der SharePoint-Administrator gewählt werden.
Öffnen Sie die SharePoint Zentraladministration. Navigieren Sie dort zu "Systemeinstellungen" > "Alternative Zugriffszuordnungen konfigurieren (Alternate Access Mappings)".
- Im Feld "Alternative Zugriffszuordnungen (Alternate Access Mapping Collection) wählen Sie aus der Dropdownliste die SharePoint Site aus, meist ist das "SharePoint – 80".
- Klicken Sie auf "Öffentliche URLs bearbeiten (Edit Public URLs)" und passen Sie die Felder "Default" und bedarfsweise "Intranet", "Internet" und "Extranet" an.
  - Alle notwendigen Informationen zur Anpassung finden Sie in dem Microsoft Artikel hier.

Navigieren Sie im ADVOKAT Backend "...\ADVOKAT\Daten\" zur Konfigurationsdatei "Advokat.ini" und öffnen Sie diese mit einem Texteditor.
Mehr Informationen finden Sie im Kapitel Datei "Advokat.ini". Passen Sie die URL im Konfigurationsschalter "SSEARCH" von Servername auf FQDN an.

Beispiel 1+2 (vorher)	Beispiel 1+2 (nachher)
SSEARCH=http://SHAREPOINT/_vti_bin/search.asmx	SSEARCH=http://SHAREPOINT.advokat.at/_vti_bin/search.asmx
SSEARCH=https://SHAREPOINT/_vti_bin/search.asmx	SSEARCH=https://SHAREPOINT.advokat.at/_vti_bin/search.asmx

Verbinden Sie sich als Domänenadministrator per Remotedesktopverbindung auf den Datenbankserver. Ist AdvoAll im Einsatz, so kann alternativ auch das AdvoAll-Benutzerkonto genutzt werden.
- Starten Sie Microsoft SQL Management Studio. Sollte es nicht starten oder eine Fehlermeldung anzeigen, versuchen Sie es erneut per Rechtsklick > "Als Administrator ausführen".
- Verbinden Sie sich mit jener Microsoft SQL Instanz, welche die ADVOKAT Datenbanken beinhaltet. Weitere Informationen dazu finden Sie im Kapitel Microsoft SQL Datenbanken einsehen.
  - Den Instanznamen können Sie in der Konfigurationsdatei "Advokat.ini" im ADVOKAT Backend unter "...\ADVOKAT\Daten\" ermitteln.
    
    DATENBANK=S:\ADVOKAT\DATEN\ADVOKAT.MDB/SERVER/INSTANZ/Advokat_DATEN
Führen Sie folgende Anpassungen per SQL-Befehlen in der Datenbank "Advokat_DATEN" durch.
1. Ermittlung der relevanten Dokumentbibliothek(en)
```
SELECT Id,DocumentRoot from dbo.DMSSettings WHERE Assembly LIKE 'Advokat8.Dms.Sharepoint.dll'
```
  Notieren Sie sich die Werte aus den Feldern Id und DocumentRoot, da diese für den nächsten Schritt benötigt werden.
  Beispiel ID (1): http://SHAREPOINT/AdvokatSharepointWinword oder http://SHAREPOINT/AdvSP
  Beispiel ID (2): https://SHAREPOINT/AdvokatSharepointWinword oder https://SHAREPOINT/AdvSP
  Beispiel DocumentRoot: FFAE4790-0145-4B62-9C0D-B049E59B527E
2. Anpassung der relevanten Dokumentbibliothek(en)
  Beispiel (1) (http)
```
UPDATE dbo.DMSSettings SET DocumentRoot = 'http://SHAREPOINT.advokat.at/AdvokatSharepointWinword' WHERE ID LIKE 'FFAE4790-0145-4B62-9C0D-B049E59B527E'
oder
UPDATE dbo.DMSSettings SET DocumentRoot = 'http://SHAREPOINT.advokat.at/AdvSP' WHERE ID LIKE 'FFAE4790-0145-4B62-9C0D-B049E59B527E'
```
  Beispiel (2) (https)
```
UPDATE dbo.DMSSettings SET DocumentRoot = 'https://SHAREPOINT.advokat.at/AdvokatSharepointWinword' WHERE ID LIKE 'FFAE4790-0145-4B62-9C0D-B049E59B527E'
oder
UPDATE dbo.DMSSettings SET DocumentRoot = 'https://SHAREPOINT.advokat.at/AdvSP' WHERE ID LIKE 'FFAE4790-0145-4B62-9C0D-B049E59B527E'
```
  Mit diesem Befehl wird im Feld DocumentRoot die URL von Servername auf FQDN geändert. Wiederholen Sie diesen Befehl für jede weitere Dokumentbibliothek, falls es unter Punkt 6a mehrere Ergebnisse gibt.
3. Ermittlung der relevanten URL in Tabelle dbo.DMSElement
  Beispiel (1+2) (http+https)
```
SELECT PartialPath from dbo.DMSElement WHERE Type LIKE '100'
```
  - Notieren Sie sich den Wert aus dem Feld PartialPath, da dieser für den nächsten Schritt benötigt wird.
  - Erhalten Sie mehr als 1 Ergebnis dann suchen Sie nach jenem Ergebnis, bei dem der aktuelle SharePoint-Servername enthalten ist.
    - Beispiel 1 PartialPath: \\SHAREPOINT
    - Beispiel 2 PartialPath: \\SHAREPOINT@SSL
  - Andere Einträge können von älteren SharePoint-Servern sein, welche bereits außer Betrieb genommen wurden.
    - Beispiel 1 PartialPath: \\SHAREPOINT-ALT
    - Beispiel 2 PartialPath: \\SHAREPOINT-ALT@SSL
4. Anpassung der relevanten in URL in Tabelle dbo.DMSElement
  Beispiel (1) (http)
```
UPDATE dbo.DMSElement SET PartialPath = '\\SHAREPOINT.advokat.at' WHERE Type LIKE '100'
```
  Beispiel (2) (https)
```
UPDATE dbo.DMSElement SET PartialPath = '\\SHAREPOINT.advokat.at@SSL' WHERE Type LIKE '100'
```
  Mit diesem Befehl wird im Feld PartialPath der Pfad von Servername auf FQDN geändert.
Stellen Sie sicher, dass alle relevanten Gruppenrichtlinien angepasst wurden. Es muss die URL dort jeweils auch von Servername auf FQDN geändert werden.
- Netzlaufwerk für Dokumentbibliothek
- Anpassung Internetoptionen, Punkt 1 und 2
- Anpassung Microsoft Office Word
Testen Sie per Windows Explorer und Internet Browser ob der Zugriff auf Microsoft SharePoint per FQDN im Domänennetzwerk funktioniert.
- Falls man zur Eingabe von Benutzername und Kennwort aufgefordert wird, so sind die Anpassungen laut Punkt 7b unvollständig oder es wurden die Geräte noch nicht neu gestartet.
- Besteht das Problem weiterhin so wechseln Sie zum Kapitel WebDAV (Webclient) verlangt Anmeldeinformationen.
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: Soll die Sperre für die anderen Benutzer wieder aufgehoben werden?