Ausgangssituation
- Vorarbeiten laut Kapitel Vorbereitung sind umgesetzt.
Anleitung
- Kontaktieren Sie den ADVOKAT Support per E-Mail unter support@advokat.at oder telefonisch unter +43 512 / 58 80 33.
- Fragen Sie die Freischaltung der Features "AdvokatClient", "AdvokatControls" und "StartMUA" an. Mehr Informationen zu Features finden Sie im Kapitel Datei "Features.xml".
- Anschließend führen Sie ein ADVOKAT Update durch, auch wenn bereits die aktuellste verfügbare Version im Einsatz ist. Mehr Informationen dazu siehe Kapitel ADVOKAT Updates.
- Laden Sie das Installationsskript (PowerShell) herunter und legen die Datei beispielsweise am Desktop ab: ADVOKAT-Server_Installation.ps1
- Wichtig ist, dass die Datei nicht auf einem UNC-Pfad oder Netzlaufwerk gespeichert wird, da die Ausführung sonst blockiert wird.
- Sollte die Ausführung blockiert werden, so kann die Datei dennoch wie folgt ausgeführt werden: powershell.exe -ExecutionPolicy Bypass
Starten Sie Windows PowerShell mit administrativen Rechten und führen die Datei laut Schritt 2 aus. Dabei müssen mehrere Parameter übergeben werden, wie im Beispiel ersichtlich.
Achten Sie wie in der Beschreibung der Parameter ersichtlich, dass die Pfade zu den Dateien und Ordnern aus lokaler Sicht des Fileservers sein müssen und keine UNC-Pfade oder Netzlaufwerkspfade.Befehl.\ADVOKAT-Server_Installation.ps1 -HostName "<FQDN>" -ZipPath "<Pfad>" -WebVerzeichnis "<Pfad>" -AdvokatIni "<Pfad>" -AdvokatFeatures "<Pfad>" -SiteName "AdvokatServer"
Parameter Beschreibung -HostName Name unter dem Server erreichbar sein wird. Beispiel: -HostName "SERVER.advokat.local" -> https://SERVER.advokat.local
-SiteName Im Microsoft IIS sichtbarer Name der Seite, Standard = "Advokat".
- Der Parameter ist optional, wird dieser nicht angeführt ist der Wert "Advokat".
- Es wird empfohlen den Parameter mit Wert "AdvokatServer" anzugeben, da der Standardwert "Advokat" oftmals bereits für Microsoft SharePoint in Verwendung ist.
-ZipPath Pfad aus lokaler Sicht zur Datei "AdvokatServer.zip". Diese befindet sich im ADVOKAT Backend unter "...\ADVOKAT\Admin\Setup\AdvokatServer.zip" -WebVerzeichnis Zielverzeichnis des Webservers -Certificate Fingerabdruck (Thumbprint) des verwendeten Zertifikats
- Der Parameter ist optional, wird kein Zertifikat angegeben, wird ein SSL-Zertifikat passend zum Hostnamen erzeugt.
- Wird ein Zertifikat angegeben, muss es unter LocalMachine\My installiert sein. Mehr Informationen finden Sie im Kapitel Selbstsigniertes SSL-Zertifikat.
-AdvokatIni Pfad aus lokaler Sicht zur Konfigurationsdatei "Advokat.ini". Diese befindet sich im ADVOKAT Backend unter "...\ADVOKAT\Daten\Advokat.ini". -AdvokatFeatures Pfad aus lokaler Sicht zur Datei "Features.xml". Diese befindet sich im ADVOKAT Backend unter "...\ADVOKAT\Admin\Cab\Features.xml". -Sqlserver Legt den ApplicationPool-Benutzer der IIS-Seite als Microsoft SQL-Benutzer mit umfänglichen Rechten an.
- Der Parameter ist optional und wird nur nach Rücksprache mit dem ADVOKAT Support benötigt.
Beispiel.\ADVOKAT-Server_Installation.ps1 -HostName "SERVER.advokat.local" -ZipPath "D:\Share$\ADVOKAT\Admin\Setup\AdvokatServer.zip" -WebVerzeichnis "D:\Share$\ADVOKAT\Advokat.Server" -AdvokatIni "D:\Share$\ADVOKAT\Daten\Advokat.ini" -AdvokatFeatures "D:\Share$\ADVOKAT\Admin\Cab\Features.xml" -SiteName "AdvokatServer"
- Tritt bei der Ausführung des PowerShell-Skripts ein oder mehrere Probleme auf, dann prüfen Sie das Protokoll unter "%programdata%/Advokat/Log".
- Es handelt sich dabei um eine Textdatei, diese kann mit einem beliebigen Texteditor geöffnet werden, wir empfehlen dazu Notepad++.
- Tritt die Fehlermeldung auf, dass das SharePoint-Modul "WebAdministration" fehlt, dann führen Sie den PowerShell-Befehl aus und versuchen es erneut: Install-Module -Name WebAdministration
- Tritt die Fehlermeldung auf, dass das PowerShell-Modul "SQLServer" fehlt, dann führen Sie den PowerShell-Befehl aus und versuchen es erneut: Install-Module -Name SqlServer
- Diese Fehlermeldung tritt üblicherweise nicht auf, da das Modul "SQLServer" nur optional verwendet wird.
- Diese Fehlermeldung tritt üblicherweise nicht auf, da das Modul "SQLServer" nur optional verwendet wird.
- Navigieren Sie per Windows Explorer zum ADVOKAT Backend unter "...\ADVOKAT\Daten" und öffnen die Datei "Advokat.ini" mit einem Texteditor.
- Fügen Sie drei neue Zeilen unterhalb vom Eintrag [Options] mit folgenden Konfigurationsschaltern ein:
- AdvokatServerUNC=...
- IISAppPoolName=...
- IISMachineName=...
- xyz
- xyz
- xyz
- xyz
- Fügen Sie drei neue Zeilen unterhalb vom Eintrag [Options] mit folgenden Konfigurationsschaltern ein:
- Navigieren Sie per Windows Explorer zum ADVOKAT Backend unter "...\ADVOKAT\Daten\Config" und speichern dort diese Datei ab: Client.json
- Öffnen Sie die Datei mit einem Texteditor, es wird Notepad++ empfohlen. Mehr Informationen Datei finden Sie im Kapitel Datei "Client.json".
Passen Sie den Parameter "Address" an, sodass der Eintrag zum Parameter -Hostname laut Schritt 3 passt.
Beispiel "Address": "https://SERVER.advokat.local:443",
- Soll das Modul Compliance zum Einsatz kommen, wechseln Sie zum Kapitel Konfiguration und setzen folgende Unterkapitel um:
- Kapitel Akt "VORLAGE", Unterordner "AML"
- Kapitel Compliance-Felder konfigurieren
- Kapitel Compliance-Vorlagen einspielen
- Soll im Modul ADVOKAT Executive Board die Ansicht "Dashboard" zum Einsatz kommen, wechseln Sie zum Kapitel Konfiguration und setzen folgende Unterkapitel um:
- Anschließend starten Sie ADVOKAT und rufen per Menüpunkt "Programme" die Einträge "Compliance" und "Executive Board" auf. Bei Problemen wechseln Sie zum Kapitel Fehlerbehandlung.