Microsoft Business Solutions-Axapta 3.0 ist jetzt Teil von Microsoft Dynamics AX 3.0. Alle Verweise auf Microsoft Business Solutions-Axapta und Microsoft Axapta beziehen sich auf Microsoft Dynamics AX.
EINFÜHRUNG
Dieser Artikel enthält Links zur Dokumentation zum Installieren von Hotfixes für Microsoft Dynamics AX 2012. Außerdem wird beschrieben, wie Hotfixes für Microsoft Dynamics AX 2009 und Microsoft Dynamics AX 4.0 installiert werden.
Hinweis Lesen Sie unbedingt den Microsoft Knowledge Base-Artikel, der einen bestimmten Hotfix dokumentiert, sorgfältig durch, um zu ermitteln, welche Objekte, Datenbanktabellen oder Dateien betroffen sind.
Weitere Informationen
Hotfixes, die für Microsoft Dynamics AX 2012 veröffentlicht werden
Der detaillierte Prozess zum Installieren von Updates und Hotfixes für Microsoft Dynamics AX 2012 ist auf TechNet im folgenden Abschnitt dokumentiert: Anwenden von Updates und Hotfixes.
Hotfixes, die für Microsoft Dynamics AX 2009 und Microsoft Dynamics AX 4.0 veröffentlicht werden
Hinweis: Der allgemeine Prozess zum Installieren von Updates und Hotfixes für Microsoft Dynamics AX 2009 ist im folgenden Whitepaper dokumentiert: Servicing Microsoft Dynamics AX 2009.
Microsoft veröffentlicht Hotfixes für Microsoft Dynamics AX in den folgenden Formaten:
- Hotfixes werden als komprimierte Datei (.zip) veröffentlicht. Die Dateien in der .zip Datei ersetzen vorhandene Dateien auf dem Computer.
- Hotfixes werden als Microsoft Windows Installer-Update veröffentlicht. Diese Hotfixes enthalten eine Setup.exe Datei.
Microsoft veröffentlicht Hotfixes für Microsoft Dynamics AX 4.0 in den folgenden Formaten:
- Hotfixes werden als Microsoft Windows Installer-Updates veröffentlicht. Diese Hotfixes enthalten eine Setup.exe Datei.
- Hotfixes werden als DIS-Layer-Dateien (AxDIS.aod) oder als DIP-Layer-Dateien (AxDIP.aod) veröffentlicht. Änderungen an der DIS-Ebene beheben Probleme im Code der SYS-Schicht. DIP-Layer-Änderungen beheben Probleme im GLS-Layer-Code.
- Sehr selten werden Hotfixes als XPO-Dateien veröffentlicht, die Code enthalten. Der Code wird auf vorhandene Objekte, auf Datenbanktabellen oder auf beides angewendet.
Allgemeine Richtlinien für Hotfixes, die Dateien ersetzen
Einige Microsoft Dynamics AX-Hotfixes ersetzen Dateien auf dem Computer. Anweisungen zum Installieren eines Hotfixes, der Dateien ersetzt, finden Sie in der Dokumentation zu dem Hotfix-Download. Im Folgenden finden Sie allgemeine Empfehlungen für die Installation von Hotfixes, die Dateien ersetzen:
Bevor Sie die im Hotfix enthaltenen Dateien auf Ihren Computer kopieren, verwenden Sie die üblichen Sicherungsprozesse, um die Serverdateien zu sichern, die vom Hotfix betroffen sind.
Testen Sie alle Hotfixes in einer Testumgebung, um sicherzustellen, dass Ihre Anpassungen nicht beeinträchtigt werden.
Alle Benutzer müssen sich von der Microsoft Dynamics AX-Clientanwendung abmelden. Beenden Sie die AOS-instance (Application Object Server), bevor Sie die Hotfixdateien umbenennen und kopieren.
Wenn der Hotfix Etikettendateien enthält, kopieren Sie alle enthaltenen Etikettendateien in den Microsoft Dynamics AX-Anwendungsordner. Die Bezeichnungsdateien weisen die folgenden Dateinamenerweiterungen auf:
- .ali
- .acd
- .alc
Standardmäßig weist der Anwendungsordner den folgenden Pfad auf:
Stammverzeichnis\Axapta Application\appl\StandardNote In diesem Pfad stellt das Stammverzeichnis das Festplattenlaufwerk und das Hauptverzeichnis dar, in dem Microsoft Dynamics AX installiert ist.
Benutzerdefinierte Umgebungen
Wenn Sie Ihre Umgebung vor der Installation eines Hotfixes angepasst haben, lesen Sie den Microsoft Knowledge Base-Artikel, der den Hotfix, den Sie installieren möchten, gründlich dokumentiert. Alle Objekte, die von dem Hotfix betroffen sind, werden überschrieben. Dies kann dazu führen, dass Anpassungen an diesen Objekten verloren gehen.
Datenbanksicherungen
Wenn Datenbanktabellen betroffen sind, erstellen Sie eine vollständige Datenbanksicherung, bevor Sie den Hotfix anwenden. Anweisungen zum Sichern einer Datenbank finden Sie in der Microsoft SQL Server-Dokumentation. Oder lesen Sie die Dokumentation zu Oracle Database Server.
Informationen zur Installation
Hotfixes, die für Microsoft Dynamics AX 2009 veröffentlicht werden
Gehen Sie folgendermaßen vor, um Hotfixes zu installieren, die als Anwendungsupdate für Microsoft Dynamics AX 2009 veröffentlicht werden:
Extrahieren Sie die Dateien aus dem Paket.
Öffnen Sie die Datei KBxxxxxx.txt im Hotfixpaket, um zu ermitteln, welche Objekte bei der Installation des Hotfixes gepatcht werden.
Beenden Sie alle Microsoft Dynamics AX 2009-Clients, und beenden Sie dann die AOS-instance.
Erstellen Sie eine Sicherungskopie der Datenbank.
Sichern Sie den Anwendungsordner.
Starten Sie die AOS-Instance neu und überprüfen Sie dann das Anwendungsprotokoll auf dem Server, auf dem der AOS-Service ausgeführt wird, um sicherzustellen, dass die AOS-Instance ordnungsgemäß gestartet wird. Die AOS-Instance erstellt den Anwendungsobjektindex neu. Die Datei Axapd.aoi enthält den Anwendungsobjektindex.
Hinweis Abhängig von der verwendeten Serverhardware kann es beim Start der AOS-Instance zu einer Zeitüberschreitung kommen, bevor der Vorgang abgeschlossen ist. Dieses Problem tritt auf, weil der Prozess nicht genügend Zeit hat, um die Axapd.aoi-Datei neu zu erstellen, bevor das AOS versucht, die Datei zu verwenden.
Die AOS-instance verbleibt in einem Start status, bis die Neuerstellung der *.aoi-Datei abgeschlossen ist. An diesem Punkt hat die AOS-Instance den Status "gestartet". Es sind keine weiteren Schritte erforderlich. Warten Sie, bis die Neuerstellung abgeschlossen ist, und überprüfen Sie dann das Anwendungsprotokoll auf einen Hinweis darauf, dass die AOS-Instance gestartet wird.
Führen Sie die Axpatch.exe Datei für die Anwendungshotfixinstallation aus.
Wählen Sie die Sprache aus, in der die Installation ausgeführt werden soll, und klicken Sie dann auf OK.
Wenn der Installations-Assistent gestartet wird, klicken Sie auf Weiter.
Lesen Sie die Microsoft-Software-Lizenzbedingungen, aktivieren Sie das Kontrollkästchen, um die Lizenzbedingungen zu akzeptieren, wenn Sie damit einverstanden sind, und klicken Sie dann auf Weiter.
Auf der Seite "Komponenten auswählen " sollte die Option "Anwendungsdateien " standardmäßig aktiviert sein. Klicken Sie auf Weiter.
Geben Sie auf der Seite Konfiguration auswählen die richtige Konfiguration an, und klicken Sie dann auf Weiter.
Klicken Sie auf der Seite "Bereit zum Anwenden des Hotfixes" auf "Installieren".
Wenn das Setup abgeschlossen ist, klicken Sie auf "Fertig stellen ", um den Assistenten zu beenden.
Überprüfen Sie auf einem Client, ob Sie als Microsoft Dynamics AX-Administrator eine Verbindung mit der AOS-Instance herstellen können.
Überprüfen Sie die Installation des Hotfixes wie folgt:
- Öffnen Sie die SysHotfixManifest-Klasse in der AOT.
- Überprüfen Sie, ob die Klasse eine Methode enthält, deren Name mit der Artikelnummer des installierten Hotfixes übereinstimmt.
Verwenden Sie das Code-Upgrade-Tool ("Codevergleich"), um die SYP- oder GLP-Änderung mit allen VAR- oder CUS-Schichten zu vergleichen. Wenn Anpassungen vorhanden sind, müssen die IT-Mitarbeiter des Partners oder Kunden den Hotfix möglicherweise mit dem benutzerdefinierten System zusammenführen.
Hotfixes, die als Windows Installer-Update veröffentlicht werden
Wichtig Folgende Aktionen müssen ausgeführt werden:
- Die ObjectServer-Kerneldatei muss auf jedem AOS-Server installiert sein.
- Die Clientkerneldatei muss auf jedem Clientcomputer installiert sein.
- Die NetBusinessConnector-Kerneldatei und die ComBusinessConnector-Kerneldatei müssen auf jedem Computer installiert sein, auf dem Microsoft Dynamics AX .NET Business Connector und Microsoft Dynamics AX Com Business Connector ausgeführt werden.
- Die ApplicationIntegrationServer-Kerneldatei ist der BizTalk-Adapter. Stellen Sie sicher, dass Sie die ApplicationIntegrationServer-Kerneldatei zusammen mit der NetBusinessConnector-Kerneldatei installieren, wenn Sie den BizTalk-Adapter aktualisieren.
Ein Windows Installer-Update aktualisiert die folgenden Microsoft Dynamics AX 4.0 Clientbinärdateien:
- Die .exe Datei
- Die .dll Dateien
Diese Dateien werden auch als Kerneldateien bezeichnet. Gehen Sie wie folgt vor, um das Windows Installer-Update anzuwenden:
Extrahieren Sie die Dateien aus dem Hotfix. Die extrahierten Dateien können die folgenden Ordner enthalten:
- ApplicationIntegrationServer
- Client
- ComBusinessConnector
- NETBusinessConnector
- Objektserver
Testen Sie den Hotfix in einer Testumgebung. Planen Sie dann eine Auszeit ein.
Beenden Sie alle Microsoft Dynamics AX-Softwareclients. Fahren Sie dann die AOS-Instanzen herunter, die mit der Dateifreigabe des Produktionsprogramms verbunden sind.
Sichern Sie die Datenbank und dann den Anwendungsordner.
Führen Sie die Setup.exe Datei aus, die in jedem Ordner des Hotfixes enthalten ist.
Starten Sie die AOS-instance neu. Überprüfen Sie das Anwendungsereignisprotokoll auf dem Server, auf dem der AOS-Dienst ausgeführt wird, um sicherzustellen, dass die AOS-Instance ordnungsgemäß gestartet wird. Die AOS-Instance erstellt den Anwendungsobjektindex neu. Die Datei Axapd.aoi enthält den Anwendungsobjektindex.
Hinweis Abhängig von der verwendeten Serverhardware kann es beim Start der AOS-Instance zu einer Zeitüberschreitung kommen, bevor der Vorgang abgeschlossen ist. Dieses Problem tritt auf, weil der Prozess nicht genügend Zeit hat, um die Axapd.aoi-Datei neu zu erstellen.
Verwenden Sie die AOS-Instance, um sich mit dem Microsoft Dynamics AX 4.0-Administratorkonto bei einem Client anzumelden. Überprüfen Sie, ob Sie erfolgreich eine Verbindung herstellen können.
Hotfixes, die als XPO-Datei veröffentlicht werden, die Code enthält
Hotfixes, die als XPO-Datei veröffentlicht werden, enthalten Korrekturen auf Codeebene, die sich direkt auf Objekte oder Datenbanktabellen in Microsoft Dynamics AX auswirken.
Wichtig Bevor Sie fortfahren, überprüfen Sie jede XPO-Datei auf die Objekte oder Tabellen, die geändert werden. Notieren Sie alle Anpassungen an Ihrer aktuellen Umgebung, die möglicherweise betroffen sind. Es wird dringend empfohlen, alle Hotfixes in einer Testumgebung anzuwenden, bevor Sie die Hotfixes auf Ihrem Live-System anwenden.
Melden Sie sich mit dem Microsoft Dynamics AX-Administratorkonto bei Microsoft Dynamics AX an. Stellen Sie sicher, dass keine anderen Benutzer bei Microsoft Dynamics AX angemeldet sind.
Öffnen Sie das Dialogfeld "Anwendungsobjektstruktur ". Wenden Sie hierzu eine der folgenden Methoden an:
- Klicken Sie auf der Standard Symbolleiste auf Anwendungsobjektstruktur.
- Drücken Sie auf der Tastatur STRG+D.
- Zeigen Sie im Menü Datei auf Öffnen, und klicken Sie dann auf Anwendungsobjektstruktur.
Klicken Sie im Dialogfeld "Anwendungsobjektstruktur" in der Symbolleiste auf "Importieren ".
Klicken Sie auf "Durchsuchen", und suchen Sie die XPO-Datei.
Klicken Sie im Dialogfeld "Öffnen " auf die XPO-Datei, und klicken Sie dann auf "Öffnen".
Klicken Sie auf OK , um den Importvorgang abzuschließen.
Hinweis: Möglicherweise müssen Sie eine Vorwärtskompilierung oder einen vollständigen AOT-Kompilierungsprozess (Application Object Tree) durchführen.
So installieren Sie Hotfixes, die als DIS-Layer- oder DIP-Layer-Dateien veröffentlicht werden
Gehen Sie folgendermaßen vor, um Hotfixes zu installieren, die als DIS-Layer- oder DIP-Layer-Dateien veröffentlicht wurden:
Extrahieren Sie die Dateien aus dem Hotfixpaket.
Bevor Sie die im Hotfix enthaltenen Dateien auf Ihren Computer kopieren, verwenden Sie die üblichen Sicherungsprozesse, um den Anwendungsordner und die Serverdateien zu sichern, die vom Hotfix betroffen sind.
Testen Sie den Hotfix in einer Testumgebung. Planen Sie dann eine Ausfallzeit ein, wenn sich keine anderen Benutzer im System befinden.
Beenden Sie alle Microsoft Dynamics AX-Softwareclients. Fahren Sie dann die Application Object Server-Instanzen herunter, die mit der Produktionsprogrammdateifreigabe verbunden sind.
Kopieren Sie die Dateien AxDIS.aod und AxDISen-us.ald in jeden Anwendungsordner, in dem die anderen AOD-Dateien vorhanden sind. Dieser Ordner befindet sich standardmäßig am folgenden Speicherort:
\application\appl\standardNote Verwenden Sie in diesem Schritt immer die Kopierfunktion. Verwenden Sie nicht die Verschiebefunktion. Wenn Sie eine Datei verschieben, werden die Berechtigungen des Quellordners für diese Datei übernommen. Wenn Sie eine Datei kopieren, werden die Berechtigungen des Zielordners übernommen.Erstellen Sie eine Sicherungskopie der Datei Axapd.aoi, indem Sie die Datei umbenennen. Oder löschen Sie die Datei "Axapd.aoi" in jedem Anwendungsordner.
Starten Sie die AOS-instance neu. Überprüfen Sie das Anwendungsprotokoll auf dem Server, auf dem die AOS-Instance ausgeführt wird, um sicherzustellen, dass die AOS-instance ordnungsgemäß gestartet wird. Die AOS-Instance erstellt den Anwendungsobjektindex neu. Die Datei Axapd.aoi enthält den Anwendungsobjektindex.
Hinweis Abhängig von der verwendeten Serverhardware kann es beim Start der AOS-Instance zu einer Zeitüberschreitung kommen, bevor der Vorgang abgeschlossen ist. Dieses Problem tritt auf, weil der Prozess nicht genügend Zeit hat, um die Axapd.aoi-Datei neu zu erstellen.
Die AOS-instance verbleiben in einem Start-status, bis die AOI-Datei neu erstellt wird. An diesem Punkt hat die AOS-Instance den Status "gestartet". Es sind keine weiteren Schritte erforderlich. Warten Sie, bis die Neuerstellung abgeschlossen ist, und überprüfen Sie dann das Anwendungsprotokoll auf einen Hinweis, dass die AOS-Instance gestartet wurde.
Verwenden Sie die AOS-Instance, um sich mit dem Microsoft Dynamics AX 4.0-Administratorkonto bei einem Clientcomputer anzumelden. Stellen Sie als Nächstes eine Verbindung mit dieser AOS-Instance her, indem Sie die Clientsoftware verwenden, um zu überprüfen, ob Sie erfolgreich eine Verbindung herstellen können. Überprüfen Sie abschließend, ob die Änderungen von Microsoft Dynamics AX erkannt wurden und im AOT sichtbar sind.
Wenn eine Upgrade-Checkliste angezeigt wird, füllen Sie diese Checkliste aus, um sicherzustellen, dass keine weiteren Probleme auftreten. Wenn keine Upgrade-Checkliste angezeigt wird, wird die DIS- oder DIP-Ebene nicht erkannt. Wenn die DIS- oder DIP-Ebene nicht erkannt wird, verwenden Sie eine oder mehrere der folgenden Methoden:
Erstellen Sie einen neuen Anwendungsordner. Kopieren Sie dann alle Dateien aus dem vorhandenen Anwendungsordner in den neuen Anwendungsordner.
Ändern Sie die Konfiguration der AOS-Instance, um den neuen Anwendungsordner zu verwenden. Führen Sie hierzu die folgenden Schritte aus:
Klicken Sie auf Start, klicken Sie auf Ausführen, geben Sie Control Admintools ein, und klicken Sie dann auf OK.
Doppelklicken Sie auf Microsoft Dynamics AX Configuration Utility.
Wählen Sie auf der Registerkarte Anwendungsobjektserver den neuen Anwendungsordner aus, den Sie in der Liste der Anwendungs-Instance erstellt haben.
Wenden Sie die Konfiguration an, und starten Sie dann die AOS-Instance neu.
Wiederholen Sie Schritt 8.
Nachdem die Prüfliste abgeschlossen ist, kompilieren Sie die gesamte Anwendung erneut.
Wenn Sie mehrere Anwendungsordner und mehrere AOS-Instances verwenden, beenden Sie alle AOS-Instances, und starten Sie dann alle AOS-Instances neu.
Referenzmaterial
Weitere Informationen zu den Importoptionen für eine XPO-Datei finden Sie im Microsoft Dynamics AX-Entwicklerhandbuch.
Die in diesem Artikel genannten Drittanbieterprodukte stammen von Herstellern, die von Microsoft unabhängig sind. Microsoft gewährt keine implizite oder sonstige Garantie in Bezug auf die Leistung oder Zuverlässigkeit dieser Produkte.