Versionen im Vergleich

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

...

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

    Info
    titleWICHTIG

    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.

       

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

    Info
    titleWICHTIG

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

       

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

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

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

  6. xyz

    Codeblock
    languageyml
    titleBefehl
    .\ADVOKAT-Server_Installation.ps1 -HostName "<FQDN>" -ZipPath "<Pfad>" -WebVerzeichnis "<Pfad>" -AdvokatIni "<Pfad>" -AdvokatFeatures "<Pfad>" -SiteName "AdvokatServer"
    ParameterBeschreibung
    -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.
    -ZipPathPfad aus lokaler Sicht zur Datei "AdvokatServer.zip". Diese befindet sich im ADVOKAT Backend unter "...\ADVOKAT\Admin\Setup\AdvokatServer.zip"
    -WebVerzeichnisZielverzeichnis 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.
    -AdvokatIniPfad aus lokaler Sicht zur Konfigurationsdatei "Advokat.ini". Diese befindet sich im ADVOKAT Backend unter "...\ADVOKAT\Daten\Advokat.ini".
    -AdvokatFeaturesPfad 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.

      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

    . Codeblock
    languageyml
    titleBefehl
    .\ADVOKAT-Server_Installation
    • .

    ps1 -HostName "<FQDN>" -ZipPath "<Pfad>" -WebVerzeichnis "<Pfad>" -AdvokatIni "<Pfad>" -AdvokatFeatures "<Pfad>" -SiteName "AdvokatServer"
    Codeblock
    languageyml
    titleBeispiel
    .\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"

       

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

  8. AdvokatX Server IIS Application Pool erstellen + Rechte vergeben für Bestand (read/write): https://docs.microsoft.com/en-us/iis/manage/configuring-security/application-pool-identities
  9. AdvokatX Server Webseite erstellen
  10. AdvokatX Server Binaries in den Ordner der Webseite kopieren.
  11. Advokat.Server.Settings.json anpassen
  12. Datei "Client.json" erstellen

  13. Starten Sie ADVOKAT und rufen per Menüpunkt "Programme" die Einträge "Compliance" und "Executive Board" auf. Bei Problemen wechseln Sie zum Kapitel Fehlerbehandlung.