Een Microsoft Dynamics AX-hotfix installeren

Van toepassing op
Microsoft Dynamics AX 2009 Microsoft Dynamics AX 4.0

Microsoft Business Solutions-Axapta 3.0 is nu onderdeel van Microsoft Dynamics AX 3.0. Alle verwijzingen naar Microsoft Business Solutions-Axapta en Microsoft Axapta hebben betrekking op Microsoft Dynamics AX.

INLEIDING

Dit artikel bevat koppelingen naar documentatie over het installeren van hotfixes voor Microsoft Dynamics AX 2012. Daarnaast wordt beschreven hoe u hotfixes voor Microsoft Dynamics AX 2009 en Microsoft Dynamics AX 4.0 kunt installeren.

Opmerking: Zorg ervoor dat u het Microsoft Knowledge Base-artikel waarin een specifieke hotfix wordt beschreven, grondig doorneemt om na te gaan welke objecten, databasetabellen of bestanden zijn getroffen.

Meer informatie

Hotfixes die zijn uitgebracht voor Microsoft Dynamics AX 2012

Het gedetailleerde proces voor het installeren van updates en hotfixes voor Microsoft Dynamics AX 2012 wordt beschreven op TechNet in de volgende sectie: Updates en hotfixes toepassen.

Hotfixes die zijn uitgebracht voor Microsoft Dynamics AX 2009 en Microsoft Dynamics AX 4.0

Opmerking: Het algemene proces voor het installeren van updates en hotfixes voor Microsoft Dynamics AX 2009 wordt beschreven in het volgende technische document: Onderhoud aan Microsoft Dynamics AX 2009.

Microsoft brengt hotfixes voor Microsoft Dynamics AX uit in de volgende indelingen:

  • Hotfixes worden uitgebracht als een gecomprimeerd (.zip) bestand. De bestanden die het .zip bestand bevat, vervangen bestaande bestanden op de computer.
  • Hotfixes worden uitgebracht als een Microsoft Windows Installer-update. Deze hotfixes bevatten een Setup.exe bestand.

Microsoft publiceert hotfixes voor Microsoft Dynamics AX 4.0 in de volgende indelingen:

  • Hotfixes worden uitgebracht als Microsoft Windows Installer-updates. Deze hotfixes bevatten een Setup.exe bestand.
  • Hotfixes worden uitgebracht als DIS-layer-bestanden (AxDIS.aod) of als DIP-layer-bestanden (AxDIP.aod). Met wijzigingen in de DIS-laag worden problemen in SYS-laag-code opgelost. Wijzigingen in de DIP-laag lossen problemen in GLS-laagcode op.
  • Zeer zelden worden hotfixes uitgebracht als XPO-bestanden die code bevatten. De code wordt toegepast op bestaande objecten, op databasetabellen of op beide.

Algemene richtlijnen voor hotfixes die bestanden vervangen

Sommige Microsoft Dynamics AX-hotfixes vervangen bestanden op de computer. Lees de documentatie bij de hotfix zorgvuldig door voor instructies over het installeren van een hotfix die bestanden vervangt. Hier volgen algemene aanbevelingen voor het installeren van hotfixes die bestanden vervangen:

  • Voordat u de bestanden in de hotfix naar uw computer kopieert, gebruikt u de gebruikelijke back-upprocessen om een back-up te maken van de serverbestanden die door de hotfix worden beïnvloed.

  • Test alle hotfixes in een testomgeving om te controleren of uw aanpassingen geen negatieve invloed hebben.

  • Zorg ervoor dat alle gebruikers zich afmelden bij de Microsoft Dynamics AX-clienttoepassing. Stop het AOS-exemplaar (Application Object Server) voordat u de hotfixbestanden een andere naam geeft en kopieert.

  • Wanneer er labelbestanden zijn opgenomen in de hotfix, kopieert u alle meegeleverde labelbestanden naar de toepassingsmap van Microsoft Dynamics AX. De labelbestanden hebben de volgende bestandsextensies:

    • .ali
    • .ACD
    • .alc

    De toepassingsmap heeft standaard het volgende pad:
    hoofdmap\Axapta Application\appl\StandardNote In dit pad vertegenwoordigt de hoofdmap de harde schijf en de hoofdmap waarin Microsoft Dynamics AX is geïnstalleerd.

Aangepaste omgevingen

Als u uw omgeving hebt aangepast voordat u een hotfix installeerde, leest u het Microsoft Knowledge Base-artikel waarin de hotfix die u wilt installeren grondig wordt beschreven. Alle objecten die worden beïnvloed door de hotfix, worden overschreven. Hierdoor kunnen aanpassingen in deze objecten verloren gaan.

Back-ups van databases

Als databasetabellen worden beïnvloed, maakt u een volledige back-up van de database voordat u de hotfix toepast. Zie de documentatie van Microsoft SQL Server voor instructies over hoe u een back-up van een database maakt. Of raadpleeg de documentatie bij Oracle Database Server.

Informatie over installatie

Hotfixes die zijn uitgebracht voor Microsoft Dynamics AX 2009

Ga als volgt te werk om hotfixes te installeren die zijn uitgebracht als toepassingsupdate voor Microsoft Dynamics AX 2009:

  1. Pak de bestanden uit het pakket uit.

  2. Open het kbxxxxxx.txt-bestand in het hotfixpakket om te bepalen voor welke objecten patches worden uitgebracht wanneer de hotfix wordt geïnstalleerd.

  3. Sluit alle Microsoft Dynamics AX 2009-clients af en stop vervolgens het AOS-exemplaar.

  4. Een back-up van de database maken.

  5. Maak een back-up van de toepassingsmap.

  6. Start het AOS-exemplaar opnieuw en controleer vervolgens het toepassingslogboek op de server waarop de AOS-service wordt uitgevoerd om ervoor te zorgen dat het AOS-exemplaar correct wordt gestart. Met het AOS-exemplaar wordt de index van toepassingsobjecten opnieuw opgebouwd. Het bestand Axapd.aoi bevat de index van het toepassingsobject. 

    Opmerking Afhankelijk van de serverhardware die u gebruikt, kan er een time-out optreden voor het opnieuw opstarten van het AOS-exemplaar voordat het proces is voltooid. Dit probleem treedt op omdat het proces onvoldoende tijd heeft om het bestand Axapd.aoi opnieuw op te bouwen voordat de AOS het bestand probeert te gebruiken. 

    Het AOS-exemplaar behoudt de beginstatus totdat het opnieuw opbouwen van het *.aoi-bestand is voltooid. Op dat moment heeft het AOS-exemplaar de status 'gestart'. Er zijn geen extra stappen vereist. Wacht tot de herbouw is voltooid en controleer vervolgens het toepassingslogboek voor een indicatie dat het AOS-exemplaar wordt gestart.

  7. Voer het Axpatch.exe bestand voor de installatie van de hotfix van de toepassing uit.

    1. Selecteer de taal waarin u de installatie wilt uitvoeren en klik op OK.

    2. Klik op Volgende wanneer de wizard van het installatieprogramma wordt gestart.

    3. Lees de licentievoorwaarden voor Microsoft-software, schakel het selectievakje in om de licentievoorwaarden te accepteren als u akkoord gaat en klik vervolgens op Volgende.

    4. Op de pagina Onderdelen selecteren moet de optie Toepassingsbestanden standaard zijn geselecteerd. Klik op Volgende.

    5. Geef op de pagina Configuratie selecteren de juiste configuratie aan en klik op Volgende.

    6. Klik op de pagina Klaar om de hotfix toe te passen op Installeren.

    7. Wanneer de installatie is voltooid, klikt u op Voltooien om de wizard af te sluiten.

  8. Controleer vanuit een client of u als beheerder van Microsoft Dynamics AX verbinding kunt maken met het AOS-exemplaar.

  9. Valideer de installatie van de hotfix als volgt:

    • Open de klasse SysHotfixManifest in de AOT.
    • Controleer of de klasse een methode bevat met een naam die hetzelfde is als het artikelnummer van de geïnstalleerde hotfix.
  10. Gebruik het code-upgradehulpmiddel ('Codevergelijking') om de SYP of GLP-wijziging te vergelijken met willekeurige VAR- of CUS-lagen. Als er aanpassingen bestaan, kan het IT-personeel van de partner of klant worden gevraagd om de hotfix samen te voegen in het aangepaste systeem.

Hotfixes die zijn uitgebracht als een Windows Installer-update

Belangrijk De volgende acties moeten worden uitgevoerd:

  • Het ObjectServer-kernelbestand moet op elke AOS-server zijn geïnstalleerd.
  • Het clientkernelbestand moet op elke clientcomputer worden geïnstalleerd.
  • Het kernelbestand NetBusinessConnector en het kernelbestand ComBusinessConnector moeten worden geïnstalleerd op elke computer waarop de Microsoft Dynamics AX .NET Business Connector en de Microsoft Dynamics AX Com Business Connector worden uitgevoerd.
  • Het kernelbestand van ApplicationIntegrationServer is de BizTalk-adapter. Zorg ervoor dat u het kernelbestand ApplicationIntegrationServer samen met het kernelbestand NetBusinessConnector installeert wanneer u de BizTalk-adapter bijwerkt.

Een Windows Installer-update werkt de volgende binaire clientbestanden van Microsoft Dynamics AX 4.0 bij:

  • Het .exe bestand
  • De .dll bestanden

Deze bestanden worden ook wel de kernelbestanden genoemd. Ga als volgt te werk om de update voor Windows Installer toe te passen:

  1. Pak de bestanden van de hotfix uit. De uitgepakte bestanden kunnen de volgende mappen bevatten:

    • ApplicationIntegrationServer
    • Client
    • ComBusinessConnector
    • NETBusinessConnector
    • ObjectServer
  2. Test de hotfix in een testomgeving. Plan vervolgens downtime in.

  3. Sluit alle Microsoft Dynamics AX-softwareclients af. Sluit vervolgens de AOS-exemplaren af die zijn verbonden met de bestandsshare van het productieprogramma.

  4. Maak een back-up van de database en maak vervolgens een back-up van de toepassingsmap.

  5. Voer het Setup.exe bestand uit dat is opgenomen in elke map in de hotfix.

  6. Start het AOS-exemplaar opnieuw. Controleer het toepassingsgebeurtenislogboek op de server waarop de AOS-service wordt uitgevoerd om te controleren of het AOS-exemplaar correct wordt gestart. Met het AOS-exemplaar wordt de index van toepassingsobjecten opnieuw opgebouwd. Het bestand Axapd.aoi bevat de index van het toepassingsobject.

    Opmerking Afhankelijk van de serverhardware die u gebruikt, kan er een time-out optreden voor het opnieuw opstarten van het AOS-exemplaar voordat het proces is voltooid. Dit probleem treedt op omdat het proces onvoldoende tijd heeft om het bestand Axapd.aoi opnieuw op te bouwen.

  7. Gebruik het AOS-exemplaar om u bij een client aan te melden met het Microsoft Dynamics AX 4.0-beheerdersaccount. Controleer of u verbinding kunt maken.

Hotfixes die worden uitgebracht als een .xpo-bestand dat code bevat

Hotfixes die zijn uitgebracht als een .xpo-bestand, bevatten oplossingen op codeniveau die direct van invloed zijn op objecten of databasetabellen in Microsoft Dynamics AX.

Belangrijk Controleer voordat u verdergaat elk XPO-bestand op de objecten of tabellen die worden gewijzigd. Noteer eventuele aanpassingen aan de huidige omgeving die mogelijk worden beïnvloed. U wordt ten zeerste aangeraden alle hotfixes in een testomgeving toe te passen voordat u de hotfixes toepast op uw live systeem.

  1. Meld u aan bij Microsoft Dynamics AX met het Microsoft Dynamics AX Administrator-account. Zorg ervoor dat er geen andere gebruikers zijn aangemeld bij Microsoft Dynamics AX.

  2. Het dialoogvenster Objectstructuur van toepassing openen. Gebruik een van de volgende methoden om dit te doen:

    • Klik op de werkbalk Standaard op Structuur van toepassingsobjecten.
    • Druk op Ctrl+D op het toetsenbord.
    • Wijs in het menu BestandOpenen aan en klik op Toepassingsobjectstructuur.
  3. Klik in het dialoogvenster Toepassingsobjectstructuur op Importeren op de werkbalk.

  4. Klik op Bladeren en zoek het XPO-bestand.

  5. Klik in het dialoogvenster Openen op het XPO-bestand en klik op Openen.

  6. Klik op OK om het importproces te voltooien.

    Opmerking Mogelijk moet u een voorwaartse compilatie of een volledig Application Object Tree (AOT)-compilatieproces voltooien.

Hotfixes installeren die worden uitgebracht als DIS-layer- of DIP-layer-bestanden

Ga als volgt te werk om hotfixes te installeren die worden uitgebracht als DIS-layer- of DIP-layer-bestanden:

  1. Pak de bestanden uit het hotfixpakket uit.

  2. Voordat u de bestanden in de hotfix naar uw computer kopieert, gebruikt u de gebruikelijke back-upprocessen om een back-up te maken van de toepassingsmap en de serverbestanden die door de hotfix worden beïnvloed.

  3. Test de hotfix in een testomgeving. Plan vervolgens downtime wanneer er geen andere gebruikers op het systeem zijn.

  4. Sluit alle Microsoft Dynamics AX-softwareclients af. Sluit vervolgens de Application Object Server-exemplaren af die zijn verbonden met de bestandsshare van het productieprogramma.

  5. Kopieer het bestand AxDIS.aod en het bestand AxDISen-us.ald naar de andere mappen van de toepassing waarin de andere .aod-bestanden aanwezig zijn. Deze map bevindt zich standaard op de volgende locatie:
    \application\appl\standardNote Gebruik in deze stap altijd de kopieerfunctie. Gebruik de functie MOVE niet. Wanneer u een bestand verplaatst, worden de machtigingen van de bronmap overgenomen voor dit bestand. Wanneer u een bestand kopieert, neemt het de machtigingen van de doelmap over.

  6. Maak een back-up van het bestand Axapd.aoi door de naam van het bestand te wijzigen. Of verwijder het bestand Axapd.aoi in elke toepassingsmap.

  7. Start het AOS-exemplaar opnieuw. Controleer het toepassingslogboek op de server waarop het AOS-exemplaar wordt uitgevoerd om te controleren of het AOS-exemplaar correct wordt gestart. Met het AOS-exemplaar wordt de index van toepassingsobjecten opnieuw opgebouwd. Het bestand Axapd.aoi bevat de index van het toepassingsobject.

    Opmerking Afhankelijk van de serverhardware die u gebruikt, kan er een time-out optreden voor het opnieuw opstarten van het AOS-exemplaar voordat het proces is voltooid. Dit probleem treedt op omdat het proces onvoldoende tijd heeft om het bestand Axapd.aoi opnieuw op te bouwen.

    Het AOS-exemplaar behoudt de uitgangsstatus totdat het AOI-bestand opnieuw is opgebouwd. Op dat moment heeft het AOS-exemplaar de status 'gestart'. Er zijn geen extra stappen vereist. Wacht tot de herbouw is voltooid en controleer vervolgens het toepassingslogboek voor een indicatie dat het AOS-exemplaar is gestart.

  8. Gebruik het AOS-exemplaar om u aan te melden bij een clientcomputer met het Microsoft Dynamics AX 4.0-beheerdersaccount. Maak vervolgens verbinding met dit AOS-exemplaar door de clientsoftware te gebruiken om te controleren of u verbinding kunt maken. Controleer ten slotte of de wijzigingen zijn gedetecteerd door Microsoft Dynamics AX en of ze zichtbaar zijn in de AOT.

  9. Als er een controlelijst voor de upgrade wordt weergegeven, voltooi deze dan om er zeker van te zijn dat er geen extra problemen optreden. Als er geen controlelijst voor de upgrade wordt weergegeven, wordt de DIS- of DIP-laag niet herkend. Als de DIS- of DIP-laag niet wordt herkend, gebruikt u een of meer van de volgende methoden:

    • Maak een nieuwe toepassingsmap. Kopieer vervolgens alle bestanden van de bestaande toepassingsmap naar de nieuwe toepassingsmap.

    • Wijzig de configuratie van het AOS-exemplaar om de nieuwe toepassingsmap te gebruiken. Ga hiervoor als volgt te werk:

      1. Klik op Start, klik op Uitvoeren, typ Control Admintools en klik op OK.

      2. Dubbelklik op Microsoft Dynamics AX Configuration Utility.

      3. Selecteer op het tabblad Application Object Server de nieuwe toepassingsmap die u hebt gemaakt in de lijst met toepassingsexemplaren.

      4. Pas de configuratie toe en start het AOS-exemplaar opnieuw.

      5. Herhaal stap 8.

  10. Nadat de controlelijst is voltooid, stelt u de hele toepassing opnieuw samen.

  11. Als u meerdere toepassingsmappen en meerdere AOS-exemplaren gebruikt, stopt u alle AOS-exemplaren en start u vervolgens alle AOS-exemplaren opnieuw.

Meer informatie

Zie de Microsoft Dynamics AX-ontwikkelaarshandleiding voor meer informatie over importopties voor een XPO-bestand.

De producten van derden die in dit artikel worden besproken, worden ontwikkeld door bedrijven die losstaan van Microsoft. Microsoft biedt geen garantie, uitdrukkelijk noch impliciet, voor de prestaties en betrouwbaarheid van deze producten.