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, in dem ein bestimmter Hotfix dokumentiert wird, um die Objekte, die Datenbanktabellen oder die betroffenen Dateien zu ermitteln.
Weitere Informationen
Hotfixes, die für Microsoft Dynamics AX 2012 veröffentlicht werden
Der ausführliche 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 für Microsoft Dynamics AX 4.0 veröffentlicht wurden
Hinweis Der allgemeine Prozess zum Installieren von Updates und Hotfixes für Microsoft Dynamics AX 2009 ist im folgenden Whitepaper dokumentiert: Wartung von 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, die die .zip-Datei enthält, 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. Dis-Layer-Änderungen beheben Probleme im SYS-Layer-Code. Änderungen der DIP-Ebene beheben Probleme im GLS-Schichtcode.
- Sehr selten werden Hotfixes als XPO-Dateien veröffentlicht, die Code enthalten. Der Code wird auf vorhandene Objekte, Datenbanktabellen oder 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 zum Download des Hotfixes. Im Folgenden sind allgemeine Empfehlungen für die Installation von Hotfixes aufgeführt, die Dateien ersetzen:
Bevor Sie die dateien, die im Hotfix enthalten sind, auf Ihren Computer kopieren, verwenden Sie ihre ü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.
Lassen Sie alle Benutzer die Microsoft Dynamics AX-Clientanwendung abmelden. Beenden Sie die AOS-instance (Application Object Server), bevor Sie die Hotfixdateien umbenennen und kopieren.
Wenn Bezeichnungsdateien im Hotfix enthalten sind, kopieren Sie alle enthaltenen Bezeichnungsdateien 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:
root directory\Axapta Application\appl\StandardNote In diesem Pfad stellt das Stammverzeichnis die Festplatte und das Hauptverzeichnis dar, in dem Microsoft Dynamics AX installiert ist.
Angepasste Umgebungen
Wenn Sie Ihre Umgebung vor der Installation eines Hotfixes angepasst haben, lesen Sie den Microsoft Knowledge Base-Artikel, der den Hotfix dokumentiert, den Sie installieren möchten. Alle Objekte, die vom Hotfix betroffen sind, werden überschrieben. Dies kann dazu führen, dass Anpassungen in 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 Oracle Database Server-Dokumentation.
Informationen zur Installation
Hotfixes, die für Microsoft Dynamics AX 2009 veröffentlicht werden
Führen Sie die folgenden Schritte aus, 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 kbxxxxxx.txt-Datei 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.
Sichern Sie die 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-Dienst ausgeführt wird, um sicherzustellen, dass die AOS-instance ordnungsgemäß gestartet wird. Der AOS-instance erstellt den Anwendungsobjektindex neu. Die Datei Axapd.aoi enthält den Anwendungsobjektindex.
Hinweis Abhängig von der verwendeten Serverhardware kann beim Start der AOS-instance ein Timeout auftreten, bevor der Prozess abgeschlossen ist. Dieses Problem tritt auf, weil der Prozess nicht genügend Zeit hat, die Datei "Axapd.aoi" neu zu erstellen, bevor AOS versucht, die Datei zu verwenden.
Die AOS-instance verbleibt in einem status, bis die *.aoi-Dateineuerstellung abgeschlossen ist. An diesem Punkt verfügt die AOS-instance über eine "gestartete" status. Es sind keine zusätzlichen Schritte erforderlich. Warten Sie, bis die Neuerstellung abgeschlossen ist, und überprüfen Sie dann das Anwendungsprotokoll, um anzuzeigen, dass die AOS-instance gestartet wird.
Führen Sie die Axpatch.exe-Datei für die Installation des Anwendungs-Hotfixes 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.
Überprüfen Sie die Microsoft-Software-Lizenzbedingungen, aktivieren Sie das Kontrollkästchen, um die Lizenzbedingungen zu akzeptieren, wenn Sie zustimmen, und klicken Sie dann auf Weiter.
Auf der Seite Komponenten auswählen sollte standardmäßig die Option Anwendungsdateien ausgewählt 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.
Klicken Sie nach Abschluss des Setups auf Fertig stellen , um den Assistenten zu beenden.
Vergewissern Sie sich auf einem Client, dass Sie als Microsoft Dynamics AX-Administrator eine Verbindung mit dem AOS-instance herstellen können.
Überprüfen Sie die Installation des Hotfixes wie folgt:
- Öffnen Sie die SysHotfixManifest-Klasse im AOT.
- Vergewissern Sie sich, dass die Klasse eine Methode mit einem Namen enthält, der mit der Artikelnummer des installierten Hotfixes übereinstimmt.
Verwenden Sie das Codeupgradetool ("Codevergleich"), um die SYP- oder GLP-Änderung mit var- oder CUS-Ebenen zu vergleichen. Wenn Anpassungen vorhanden sind, müssen die IT-Mitarbeiter des Partners oder Kunden möglicherweise den Hotfix mit dem angepassten System zusammenführen.
Hotfixes, die als Windows Installer-Update veröffentlicht werden
Wichtig Die folgenden Aktionen müssen ausgeführt werden:
- Die ObjectServer-Kerneldatei muss auf jedem AOS-Server installiert sein.
- Die Clientkernelsdatei muss auf jedem Clientcomputer installiert sein.
- Die NetBusinessConnector-Kerneldatei und die ComBusinessConnector-Kerneldatei müssen auf jedem Computer installiert werden, auf dem der Microsoft Dynamics AX .NET Business Connector und der 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 Binärdateien des Microsoft Dynamics AX 4.0-Clients:
- Die .exe-Datei
- Die .dll-Dateien
Diese Dateien werden auch als Kerneldateien bezeichnet. Führen Sie die folgenden Schritte aus, 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
- ObjectServer
Testen Sie den Hotfix in einer Testumgebung. Planen Sie dann Ausfallzeiten.
Beenden Sie alle Microsoft Dynamics AX-Softwareclients. Fahren Sie dann die AOS-Instanzen herunter, die mit der Produktionsprogrammdateifreigabe verbunden sind.
Sichern Sie die Datenbank, und sichern Sie dann den Anwendungsordner.
Führen Sie die Setup.exe-Datei aus, die in jedem Ordner im Hotfix enthalten ist.
Starten Sie den 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. Der AOS-instance erstellt den Anwendungsobjektindex neu. Die Datei Axapd.aoi enthält den Anwendungsobjektindex.
Hinweis Abhängig von der verwendeten Serverhardware kann beim Start des AOS-instance ein Timeout auftreten, bevor der Prozess abgeschlossen ist. Dieses Problem tritt auf, weil der Prozess nicht genügend Zeit hat, um die Datei "Axapd.aoi" neu zu erstellen.
Verwenden Sie die AOS-instance, um sich mit dem Microsoft Dynamics AX 4.0-Administratorkonto bei einem Client anzumelden. Vergewissern Sie sich, dass Die Verbindung erfolgreich hergestellt werden kann.
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. Beachten Sie alle Anpassungen an Ihrer aktuellen Umgebung, die möglicherweise betroffen sind. Es wird dringend empfohlen, dass Sie alle Hotfixes in einer Testumgebung anwenden, bevor Sie die Hotfixes auf Ihr Livesystem 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 Symbolleiste Standard 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 auf der Symbolleiste auf Importieren .
Klicken Sie auf Durchsuchen, und suchen Sie dann 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 einen Vorwärtskompilierungsvorgang oder einen vollständigen AOT-Kompilierungsprozess (Application Object Tree) abschließen.
Installieren von Hotfixes, die als DIS- oder DIP-Layer-Dateien veröffentlicht werden
Führen Sie die folgenden Schritte aus, um Hotfixes zu installieren, die als DIS- oder DIP-Layer-Dateien veröffentlicht werden:
Extrahieren Sie die Dateien aus dem Hotfixpaket.
Bevor Sie die dateien, die im Hotfix enthalten sind, auf Ihren Computer kopieren, verwenden Sie ihre ü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 Ausfallzeiten, wenn sich keine anderen Benutzer auf dem 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. Standardmäßig befindet sich dieser Ordner am folgenden Speicherort:
\application\appl\standardNote Verwenden Sie in diesem Schritt immer die Kopierfunktion. Verwenden Sie nicht die Move-Funktion. 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 benötigt.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 den 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. Der AOS-instance erstellt den Anwendungsobjektindex neu. Die Datei Axapd.aoi enthält den Anwendungsobjektindex.
Hinweis Abhängig von der verwendeten Serverhardware kann beim Start des AOS-instance ein Timeout auftreten, bevor der Prozess abgeschlossen ist. Dieses Problem tritt auf, weil der Prozess nicht genügend Zeit hat, um die Datei "Axapd.aoi" neu zu erstellen.
Die AOS-instance verbleibt in einem Start-status, bis die AOI-Datei neu erstellt wird. An diesem Punkt verfügt die AOS-instance über eine "gestartete" status. Es sind keine zusätzlichen Schritte erforderlich. Warten Sie, bis die Neuerstellung abgeschlossen ist, und überprüfen Sie dann das Anwendungsprotokoll, um anzuzeigen, 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 diesem AOS-instance her, indem Sie die Clientsoftware verwenden, um zu überprüfen, ob Eine Verbindung erfolgreich hergestellt werden kann. Überprüfen Sie abschließend, ob die Änderungen von Microsoft Dynamics AX erkannt wurden und im AOT sichtbar sind.
Wenn eine Upgradeprüfliste angezeigt wird, füllen Sie die Prüfliste aus, um sicherzustellen, dass keine zusätzlichen Probleme auftreten. Wenn keine Upgradeprüfliste 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 so, dass der neue Anwendungsordner verwendet wird. 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 Das Microsoft Dynamics AX-Konfigurationshilfsprogramm.
Wählen Sie auf der Registerkarte Anwendungsobjektserver den neuen Anwendungsordner aus, den Sie in der Anwendungsliste instance erstellt haben.
Wenden Sie die Konfiguration an, und starten Sie dann den AOS-instance neu.
Wiederholen Sie Schritt 8.
Kompilieren Sie nach Abschluss der Prüfliste die gesamte Anwendung neu.
Wenn Sie mehrere Anwendungsordner und mehrere AOS-Instanzen verwenden, beenden Sie alle AOS-Instanzen, und starten Sie dann alle AOS-Instanzen neu.
Referenzmaterial
Weitere Informationen zu 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.