Ausgangssituation
- Vorarbeiten laut Kapitel Vorbereitung sind umgesetzt.
Anleitung
Stellen Sie sicher, dass Microsoft .NET Desktop Runtime installiert ist. Es ist nicht Teil des Windows Betriebssystems und muss manuell installiert werden.
Alle notwendigen Informationen finden Sie im Kapitel Microsoft .NET Desktop Runtime.WICHTIG
Microsoft .NET Desktop Runtime muss nicht nur auf dem Server installiert sein, sondern auch auf allen Arbeitsplätzen (FAT-Clients und Terminalserver), auf denen ADVOKAT verwendet wird.
Führen Sie die Installation von Microsoft ASP.NET Core Runtime als Hosting Bundle durch. Einen Überblick dazu finden Sie unter https://dotnet.microsoft.com/en-us/download/dotnet/6.0.
Der Download dafür erfolgt automatisch auf dieser Microsoft Website, es wird das Windows Hosting Bundle heruntergeladen.WICHTIG
Microsoft ASP.NET Core Runtime als Hosting Bundle muss nur auf dem Server installiert sein, nicht auf den den Arbeitsplätzen (FAT-Clients und Terminalserver).
- Führen Sie einen Neustart der Geräte durch, dieser ist zwingend erforderlich, damit die Installation laut Punkt 1 und 2 abgeschlossen und von ADVOKAT erkannt wird.
- 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" und "AdvokatControls" 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 5 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 eines 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.
- Datei "Client.json" erstellen
- Starten Sie ADVOKAT und rufen per Menüpunkt "Programme" die Einträge "Compliance" und "Executive Board" auf. Bei Problemen wechseln Sie zum Kapitel Fehlerbehandlung.