AppImporter inkl. CU Update (Major, Minor) - NEVARIS Finance 2024.2.2

AppImporter-Ablauf

Um ein Major/Minor-Update einzuspielen, laden Sie sich bitte den letzten bereitgestellten Major/Minor-AppImporter herunter.

Das Nevaris-Setup und AppImporter müssen namentlich immer zusammen passen!

Den Major/Minor-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 Major/Minor-AppImporter aus dem System entfernt. Diese Extensions müssen nach dem Ausführen des Major/Minor-AppImporter manuell eingespielt oder sogar an die neue Finance-Version angepasst werden. Sie werden im Log als auch am Ende des Major/Minor-AppImporter darauf hingewiesen.

Open

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 AppImporter aus:

Open

• Klicken SIe auf "Installieren":

• Die Dateien werden nun entpackt:

• Ein PowerShell-Fenster öffnet sich und führt nun fast alles automatisch aus.

• Sie können wählen, ob sie alle Instanzen mit den neuen App/Extension-Versionen updaten möchten oder erstmal nur für eine Bestimmte:

• Geben Sie 1 oder 2 ein

• Bei Auswahl 1 kommt folgende Abfrage:

• Wenn dies geschehen ist, geben Sie bitte j ein.

• Bei Auswahl 2 kommt folgende Abfrage:

• Wählen Sie die Mittelschicht die sie updaten möchten wieder mit Eingabe der Zahlen aus und bestätigen Sie mit ENTER

• Anschließend wird mit dem Ablauf begonnen

• Im Falle des Major-Updates wird eine neue Lizenz benötigt die eingespielt werden muss pro Mittelschicht (die Abfrage wird bei jeder Mittelschicht gestellt)

• Wählen Sie die Lizenz (.bclicense, auf keinen Fall mehr .FLF) aus dem Dateisystem aus und klicken "Öffnen"

• Bestätigen Sie die Lizenz mit j und ENTER

• Anschließend werden die neuen Microsoft System / Base / Application und Languages-Apps in der Mittelschicht installiert und geupdatet.

• Dann die eigentliche Finance-App.

• Wenn der Vorgang abgeschlossen ist (der je nach Datenmenge mehrere Stunden dauern kann!) meldet es der AppImporter und öffnet das Log.

• Dort können SIe den Vorgang nochmal nachverfolgen.

• Wenn in der Log-Datei am Ende steht, dass das Skript beendet wurde und keine Fehler beim Update / Install etc. in der Log-Datei aufgetreten sind, ist alles ordnungsgemäß durchgelaufen.

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

• Das Update ist nun beendet. Die Mittelschicht sollte wieder gestartet sein.

• Und die aktuelle Version im WebClient unter Extensions stehen:

Nach dem Update unter BC16:

Nach dem Update von BC16 auf BC18:

Nach dem Update von BC18 auf BC20:

Nach dem Update von BC20 CU3 auf BC20 CU8:

Nach dem Update von BC20 CU8 auf BC20 CU13:

Nach dem Update von BC20 CU13 auf BC23 CU3:

Nach dem Update von BC23 CU3 auf BC24:

Hier in diesem Falle wurden jetzt alle Apps aktualisiert. Das ist nur ein Beispiel, die Versionen und Anzahl an Apps unterscheiden sich natürlich je nach Update.

Gehen Sie nun zurück zur Hauptseite und folgen der weiteren Anleitung

NEVARIS Finance Version 2024.2