/
Installationsanleitung - Finance 2025.1

Installationsanleitung - Finance 2025.1

Vorwort

Mit NEVARIS 2025.1 ist es möglich, über das Finance Setup.exe eine NEVARIS Finance Initialdatenbank einfach und bequem zu installieren. Mehr dazu im Kapitel Mittelschichtserver/ Datenbankerzeugung.

Generell besteht Business Central aus drei Kern-Komponenten:

  • Dem Mittelschichtserver, in der Grafik nur “Server” genannt. Dieser enthält die Programmlogik und die Erweiterungen von NEVARIS Finance.

  • Dem Webserver, auf Basis von Microsoft IIS. Diese Komponente stellt den Zugang zu NEVARIS Finance als Website bereit.

  • Dem SQL Datenbank Server. Dieser ist die zentrale Datenhaltung für den Mittelschichtserver und die Anwendung. Hier werden alle Daten gespeichert.

 

Voraussetzungen

NEVARIS Finance 2025.1 Lizenzdatei: Für die Nutzung von NEVARIS Finance 2025.1 ist eine BC26 Lizenz-Datei erforderlich. Diese erhalten Sie auf Anforderung vom NEVARIS Ordermanagement (Bearbeitungsdauer ca. 5 Werktage)

  • Bitte füllen Sie hierzu das verknüpfte Formular aus. Anforderung Lizenz-Datei. 

  • Sollte die Umstellung gemeinsam mit unserem Professional Service erfolgen, dann stimmen Sie bitte ab, wer die Lizenz anfordert. 

Installation

Versionsangaben in den Screenshots können abweichend sein.

  • Starten Sie bitte das Finance Setup.exe unter dem Benutzer "nbauen".

  • Nachdem das Setup bereit ist, wählen Sie hier bitte "Benutzerdefiniert".

image-20240826-151512.png

Unterschiedliche Installationsvarianten

Je nachdem, auf welchen Server Sie sich befinden bzw. welche Funktion der Server haben soll, müssen Sie hier unterschiedliche Auswahlen treffen.

Mittelschichtserver mit Datenbankerzeugung

  • Wählen Sie hier entsprechend "Datenbank erzeugen" und "Server" aus. Sie können auch den "Webserver" auf dem gleichen System installieren. Folgen Sie für weitere Informationen dann den unteren Schaubildern zum Webserver.

  • Der Punkt: "Datenbank erzeugen" erscheint nur, wenn das Setup auf dem System einen installierten SQL-Server findet.

  • Möchten Sie nur einzelne Pakete auswählen wie Mittelschichtserver, kann sich die Anzahl der notwendigen Schritte verringern. Alle drei Varianten sind in diesem
    Leitfaden enthalten.

  • Falls dies ein Test-Server ist, bei dem der Installations-Benutzer ein anderer Benutzer als "nbauen" ist, kommt diese Abfrage. Bestätigen Sie bitte mit "Ja".

image-20240826-151614.png

  • Falls der SQL-Server ordnungsgemäß konfiguriert wurde, sollte eine Authentifizierung über "Integrated Security" möglich sein.

  • Geben Sie den SQL-Servernamen und die eventuell vorhandene Instanz an.

  • Benennen Sie die Datenbank, hier "BAU".

  • Anschließend können Sie mit dem Klick auf "Download" die aktuelle Finance-Datenbank herunterladen oder eine vorab heruntergeladene Finance-Datenbank einspielen. Der Link zum Download ist hier: https://NEVARIS.blob.core.windows.net/finance/Deploy_DB_24_2.bak

ZyAu38sa5Z-20240826-162950.png

  • Hier bitte entsprechend wie beim vorherigen Schaubild verfahren.

image-20240826-163119.png
image-20240826-163218.png

  • Der Name BAU ist bereits eingetragen, bei Test-Installationen kann der Name hier angepasst werden.

  • Geben Sie das ausführende Dienstkonto des zu installierenden Finance Mittelschicht-Dienstes ein.
    Wichtig ist hier, dass Sie die Domäne ebenfalls angeben.

  • Der Management Port des NEVARIS Mittelschichts-Dienstes ist bereits mit Port 7045 vorgegeben und muss normalerweise nicht geändert werden.

image-20240826-163341.png

  • Der Server wird nun installiert, wenn Sie auf "Jetzt installieren" klicken.

image-20240826-163405.png

  • Sie können auch das erweiterte Protokoll öffnen.

  • Warten Sie ab, bis die Installation fertiggestellt ist.

  • Es kann vorkommen, dass bei der Installation des Webservers und weiterer Komponenten ein CMD-Fenster erscheint, dies ist normal.

image-20240826-170922.png
image-20240830-183244.png

  • Das Setup ist abgeschlossen. Bei etwaigen Meldungen, schauen Sie bitte in die genannten Log-Dateien.
    Dort wird detailliert die Installation protokolliert und man findet schnell Informationen zu den Meldungen.

Lizenz einspielen in der Mittelschicht

Passen Sie anschließend folgenden PowerShell-Befehl an und führen Sie die Befehle aus :

Einspielen der Lizenz
Import-NAVServerLicense MITTELSCHICHTSNAME -LicenseFile "PFAD DER LIZENZDATEI (.bclicense)" -Database NavDatabase Restart-NAVServerInstance MITTELSCHIHTSNAME

WebClientBaseURL in der Mittelschicht setzen

Um gewisse Funktionen bereitzustellen, muss in der Mittelschicht der Wert von der Web Client Base URL eingetragen werden. Der Verweis auf die Webinstanz mit der die Mittelschicht verbunden ist.

Die Business Central Administration ist mit BC23 entfallen, alle Konfigurationen der Mittelschicht müssen nun mit der Administration Shell via PowerShell erledigt werden.

Passen Sie anschließend den folgenden PowerShell-Befehl an und führen Sie die Befehle aus :

Setzen der WebClientBaseURL und Neustart der Mittelschicht

Set-NavServerConfiguration -ServerInstance MITTELSCHICHTSNAME -KeyName "PublicWebBaseURL" -KeyValue "http://WEBSERVER:8080/WEBSERVERINSTANZNAME/" Restart-NavServerInstance -ServerInstance MITTELSCHICHTSNAME

Die Einrichtung ist danach abgeschlossen.

Setzen der Anmeldedaten zur Mittelschicht

Setzen Sie einmal nach der Neuinstallation die Anmeldedaten für den hinterlegten Service-Account, starten Sie danach die Mittelschicht.

image-20240902-153922.png

Webserver

Installation Webserver

Sie erreichen den Finance-Client nach der Installation mit folgender URL: http://SERVERNAMEVOMWEBSERSERVER:8080/BAU.

image-20240826-151512.png

  • Wählen Sie hier bitte nur den Eintrag "Webserver" aus. Klicken Sie anschließend auf "Weiter".

  • Natürlich können Sie auch gleichzeitig den File Service in einem Durchgang installieren, folgen Sie hier der Installationsanleitung vom File Service.

image-20240902-151812.png

  • Bitte geben Sie hier den Server an, wo der Mittelschichts-Server ausgeführt wird und die dazu gehörige Mittelschicht + Client-Port.

  • Die restlichen Ports werden automatisch anhand der Eingabe ermittelt.

  • Klicken Sie anschließend auf "Weiter".

image-20240902-152827.png

  • Sie bekommen nochmals eine Übersichtsseite, bestätigen Sie hier mit "Jetzt installieren".

image-20240902-152930.png

  • Es werden nun die notwendigen Komponenten für den Webserver (IIS) installiert.
    Dabei kann es vorkommen, dass ein CMD-Fenster erscheint.
    Das ist vollkommen normal, warten Sie bitte bis die Installation abgeschlossen ist.

image-20240829-130958.png

File Service

Wechseln Sie dazu bitte zu der gesonderten Anleitung:  Installation File Service - Finance 2025.1, falls Sie den File Service noch nicht installiert hatten.

Weitere Konfigurationen

SPN-Registrierung

Wichtig ist, dass der Mittelschichtservice-Benutzer die Erlaubnis hat, um SPN-Registrierungen zu tätigen. Ohne diese Erlaubnis funktioniert die Authentifizierung über Windows nicht:

  • Start the Active Directory Users and Computers snap-in in Microsoft Management Console (MMC):

    1. Choose Run on the Start menu, type mmc on the command line, and the choose OK.

    2. When the console opens, select Add/Remove Snap-In from the File menu, select Active Directory Users and Computers, and choose Add.

      If you do not see Active Directory Users and Computers in the list of available snap-ins, you may need to use Server Manager to install the Active Directory Domain Services role on your server computer.

  • In MMC, select Active Directory Users and Computers in the tree view and choose Advanced Features from the View menu.

  • Expand the domain node in the tree view and choose Users.

  • Right-click the service account, select Properties, and then choose to display the Security tab.

  • Choose SELF in the Group or user names list.

  • Under Permissions for SELF, in the lower part of the panel, scroll down to Write public information and select the Allow column.

  • Choose OK to exit the Properties panel, and close Active Directory Users and Computers.

Nach der Installation ist ein Neustart der gesamten Maschine erforderlich!

Zugriff vom Webserver zum Mittelschichtserver delegieren

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/deployment/configure-delegation-web-server --->Version 21 and later.

Sollte der Lookup (z.B. auf den Namen des Serviceaccounts der Mittelschicht) im Rahmen der Delegierung nicht funktionieren, ist vermutlich der SPN des Serviceaccounts noch nicht registriert. Befolgen Sie bitte nochmals die bereits geschilderten Punkte zum Thema SPN und starten Sie den Mittelschichtserver einmal neu.

  1. Die Delegation vom Mittelschichtserver an den Webserver von Business Central im AD ist unbedingt notwendig.

  2. Sie müssen folgende Einträge bei der Delegation hinterlegen:

    image-20240902-153211.png

  3. SPN-Registrierung für Mittelschichts-Service-Benutzer aktivieren, siehe oben!

Kernel-Modus-Authentifizierung auf AppPool-Zugangsdaten umstellen

https://docs.microsoft.com/en-us/dynamics365/business-central/dev-itpro/deployment/configure-delegation-web-server

Unter: C:\Windows\System32\inetsrv\config gibt es die Datei applicationHost.config. In der Datei ganz nach unter scrollen und den Eintrag:

<windowsAuthentication enabled="true" useAppPoolCredentials="true" /> eintragen.

Anschließend Webserver und Mittelschichtserver neu starten.

Auf EntraID (AAD) Anmeldung umstellen

Wechseln Sie dazu bitte zu der gesonderten Anleitung:  Einrichtung EntraID-Anmeldung - ACS - Finance 2025.1