AppImporter excl. CU Update (Minor, Patch) 2024.2.2
Um ein Minor-Update oder ein Patch einzuspielen, laden Sie sich bitte den letzten bereitgestellten Minor/Patch-AppImporter herunter.
Das Nevaris-Setup und AppImporter müssen von der Version immer zusammen passen!
Heißt bereits installierte Setup-Version 2022.2 → Fin22.1.x_22.2.0.19.exe
Den Minor/Patch-AppImporter führen Sie bitte ausschließlich unter dem Benutzer nbauen auf dem Mittelschichtsserver aus.
Der AppImporter ist ein selbstextrahierendes Archiv, was die notwendigen Skripte, die entsprechende APP-Datei und die passenden Librarys zur Verfügung stellt unter %programdata%\NEVARIS\NevarisAPPImport
Die Log-Datei finden Sie dort ebenfalls.
Bitte starten sie nur die Mittelschichts-Instanzen die auch geupdatet werden sollen. Alle anderen Mittelschichten sollten zu diesem Zeitpunkt gestoppt sein. Stellen sie sicher, dass niemand zum Zeitpunkt des Updates mit dem System arbeitet. Mittelschichten die die selbe Datenbank als Basis haben bitte nur einmal starten, alle anderen gestoppt lassen.
Extensions, wie kundeneigene-Extensions werden im Zuge des Minor/Patch-AppImporter aus dem System entfernt. Diese Extensions müssen nach dem Ausführen des Minor/Patch-AppImporter manuell eingespielt oder sogar an die neue Finance-Version angepasst werden. Sie werden im Log als auch am Ende des Minor/Patch-AppImporter darauf hingewiesen.
Zusätzlich empfehlen wir einen Neustart der Maschine vor dem eigentlichen Update und vorübergehende Deaktivierung / Deinstallation des Anti-Virus für die Zeit des Updates.
Um den Updatevorgang zu Starten führen sie bitte den Minor/Patch-AppImporter aus:
Klicken Sie auf "Installieren":
Die Dateien werden nun entpackt:
Ein PowerShell-Fenster öffnet sich und es kommen ein paar Abfragen zur Einrichtung.
Sie können wählen, ob sie alle Instanzen mit den neuen App/Extension-Versionen updaten möchten (1) oder erstmal nur für eine bestimmte Instanz (2)
Geben Sie 1 oder 2 ein
Bei Auswahl von 1 kommt folgende Abfrage:
Wenn dies geschehen ist, geben Sie bitte j ein.
Bei Auswahl von 2 kommt folgende Abfrage:
Wählen Sie die Mittelschicht die Sie updaten möchten mit Eingabe der entsprechenden Zahl aus und bestätigen Sie mit ENTER
Anschließend wird die neue Nevaris Finance-App und weitere dazugehörige Apps in der Mittelschicht geupdatet.
Wenn der Vorgang abgeschlossen ist meldet es der AppImporter und öffnet das Log.
Dort können Sie die durchgeführten Aktionen nachverfolgen.
Wenn am Ende der Log-Datei steht, dass das Skript beendet wurde und keine Fehler beim Update / Install etc. in der Log-Datei aufgetreten sind, ist alles ordnungsgemäß durchgelaufen.
Das Update ist nun beendet und die Mittelschicht sollte wieder gestartet sein.
Hinweise
Sollte folgender Hinweis erscheinen:
Muss der Finance-Ordner unter: C:\Program Files\Microsoft Dynamics 365 Business Central\JENACHINSTALLIERTERBCVERSION\Service\Add-ins gelöscht werden. Beenden Sie dazu vorher alle laufenden Mittelschichten auf dem Server. Danach sollte sich der Ordner ohne Probleme löschen lassen.
Starten sie dann die Mittelschicht, die sie updaten möchten und führen den AppImporter erneut aus.
Änderungen im AppImporter ab Update 23.1 und Patch 23.0.X
Es gibt unter C:\ProgramData\NEVARIS\NevarisAPPImport
eine neue Datei mit dem Namen: apphistory.txt
Dort wird immer der letzte eingespielte App-Stand dokumentiert und immer wieder angehangen. So hat man einen guten Überblick über die Update-Historie.
Außerdem dazu gekommen ist die Datei: removedApps.txt
Dort wird angezeigt, welche Apps geunpublisht werden mussten um die Finance-Apps einzuspielen.
Dies wird auch im Verlauf des AppImporters angezeigt:
Damit Sie die Info darüber haben, welche Apps danach wieder eingespielt werden müssen. Folgenden Sie dazu folgender Anleitung, wenn Apps angezeigt werden (benötigt Administratorkenntnisse):
Automatisches Einspielen von kundeneigenen Extensions nach einem Patch
Bei Fragen dazu, wenden Sie sich bitte an den Support.
Ansicht der aktuellen Apps
Zur Kontrolle der aktuellen Version gehen Sie im NEVARIS Finance unter Einstellungen (Zahnrad), Erweiterte Einstellungen.
und wählen Sie Extensions aus.
Hier sehen Sie in der Zeile Finance die jetzt installierte Version (hier v.22.2.0.16)