Microsoft Business Solutions-Axapta 3.0 fait désormais partie de Microsoft Dynamics AX 3.0. Toutes les références à Microsoft Business Solutions-Axapta et à Microsoft Axapta se rapportent à Microsoft Dynamics AX.
INTRODUCTION
Cet article fournit des liens vers la documentation sur l’installation des correctifs logiciels pour Microsoft Dynamics AX 2012. Il décrit également comment installer des correctifs logiciels pour Microsoft Dynamics AX 2009 et Microsoft Dynamics AX 4.0.
Remarque Veillez à lire attentivement l’article de la Base de connaissances Microsoft qui décrit un correctif logiciel spécifique afin de déterminer les objets, les tables de base de données ou les fichiers qui seront affectés.
Informations supplémentaires
Correctifs logiciels publiés pour Microsoft Dynamics AX 2012
Le processus détaillé d’installation des mises à jour et des correctifs pour Microsoft Dynamics AX 2012 est documenté sur TechNet, dans la section suivante : Application des mises à jour et des correctifs.
Correctifs logiciels publiés pour Microsoft Dynamics AX 2009 et Microsoft Dynamics AX 4.0
Remarque Le processus général d’installation des mises à jour et des correctifs logiciels pour Microsoft Dynamics AX 2009 est documenté dans le livre blanc suivant : Maintenance de Microsoft Dynamics AX 2009.
Microsoft publie des correctifs logiciels pour Microsoft Dynamics AX aux formats suivants :
- Les correctifs sont publiés sous forme de fichier compressé (.zip). Les fichiers que contient le fichier .zip remplacent les fichiers existants sur l’ordinateur.
- Les correctifs sont publiés sous la forme d’une mise à jour de Microsoft Windows Installer. Ces correctifs contiennent un fichier Setup.exe.
Microsoft publie des correctifs logiciels pour Microsoft Dynamics AX 4.0 aux formats suivants :
- Les correctifs sont publiés en tant que mises à jour de Microsoft Windows Installer. Ces correctifs contiennent un fichier Setup.exe.
- Les correctifs sont publiés sous forme de fichiers de couche DIS-(AxDIS.aod) ou de fichiers de couche DIP (AxDIP.aod). Les modifications de la couche DIS résolvent les problèmes dans le code de la couche SYS. Les modifications de la couche DIP résolvent les problèmes dans le code de la couche GLS.
- Très rarement, les correctifs logiciels sont publiés sous forme de fichiers .xpo contenant du code. Le code est appliqué à des objets existants, à des tables de base de données ou aux deux.
Instructions générales concernant les correctifs logiciels qui remplacent des fichiers
Certains correctifs logiciels Microsoft Dynamics AX remplacent les fichiers sur l’ordinateur. Pour obtenir des instructions sur l’installation d’un correctif logiciel qui remplace des fichiers, lisez attentivement la documentation accompagnant le téléchargement du correctif. Voici des recommandations générales pour l’installation de correctifs logiciels qui remplacent des fichiers :
Avant de copier les fichiers inclus dans le correctif logiciel sur votre ordinateur, utilisez vos processus de sauvegarde habituels pour sauvegarder les fichiers serveur concernés par le correctif.
Testez tous les correctifs logiciels dans un environnement de test pour vérifier que vos personnalisations ne sont pas affectées.
Demandez à tous les utilisateurs de se déconnecter de l’application cliente Microsoft Dynamics AX. Arrêtez l’instance du serveur d’objets d’application (AOS) avant de renommer et de copier les fichiers de correctifs.
Lorsque des fichiers d’étiquette sont inclus dans le correctif, copiez tous les fichiers d’étiquette inclus dans le dossier d’application Microsoft Dynamics AX. Les fichiers d’étiquette auront les extensions de nom de fichier suivantes :
- .ali
- .acd
- .alc
Par défaut, le dossier d’application a le chemin d’accès suivant :
répertoire racine\Axapta Application\appl\StandardNote Dans ce chemin d’accès, le répertoire racine représente le lecteur de disque dur et le répertoire principal dans lequel Microsoft Dynamics AX est installé.
Environnements personnalisés
Si vous avez personnalisé votre environnement avant d’installer un correctif logiciel, consultez attentivement l’article de la Base de connaissances Microsoft qui décrit le correctif logiciel à installer. Tous les objets concernés par le correctif logiciel seront remplacés. Cela peut entraîner la perte des personnalisations de ces objets.
Sauvegardes de bases de données
Si des tables de base de données sont affectées, créez une sauvegarde complète de la base de données avant d’appliquer le correctif. Pour obtenir des instructions sur la sauvegarde d’une base de données, consultez la documentation de Microsoft SQL Server. Vous pouvez également consulter la documentation du serveur de base de données Oracle.
Informations sur l’installation
Correctifs logiciels publiés pour Microsoft Dynamics AX 2009
Pour installer les correctifs logiciels publiés sous forme de mise à jour d’application pour Microsoft Dynamics AX 2009, procédez comme suit :
Extrayez les fichiers du package.
Ouvrez le fichier.txt KBxxxxxx dans le package de correctif logiciel pour identifier les objets qui seront corrigés lors de l’installation du correctif.
Quittez tous les clients Microsoft Dynamics AX 2009, puis arrêtez l’instance AOS.
Sauvegardez la base de données.
Sauvegardez le dossier de l’application.
Redémarrez l’instance AOS, puis consultez le journal des applications sur le serveur qui exécute le service AOS pour vous assurer que l’instance AOS démarre correctement. L’instance AOS reconstruit l’index de l’objet de l’application. Le fichier Axapd.aoi contient l’index de l’objet application.
Remarque En fonction du matériel serveur utilisé, le démarrage de l’instance AOS peut expirer avant la fin du processus. Ce problème se produit, car le processus ne dispose pas de suffisamment de temps pour reconstruire le fichier Axapd.aoi avant que l’AOS tente d’utiliser le fichier.
L’instance AOS reste dans un status de départ jusqu’à ce que la reconstruction du fichier *.aoi soit terminée. À ce stade, l’instance AOS a un status « démarré ». Aucune étape supplémentaire n’est requise. Attendez la fin de la reconstruction, puis examinez le journal des applications pour obtenir une indication que l’instance AOS démarre.
Exécutez le fichier Axpatch.exe pour l’installation du correctif de l’application.
Sélectionnez la langue dans laquelle exécuter l’installation, puis cliquez sur OK.
Lorsque l’Assistant du programme d’installation démarre, cliquez sur Suivant.
Passez en revue les termes du contrat de licence logiciel Microsoft, activez la case à cocher pour accepter les termes du contrat de case activée afin d’accepter les termes du contrat de licence si vous l’acceptez, puis cliquez sur Suivant.
Sur la page Sélectionner les composants , l’option Fichiers d’application doit être sélectionnée par défaut. Cliquez sur Suivant.
Sur la page Sélectionner une configuration , indiquez la configuration correcte, puis cliquez sur Suivant.
Sur la page Prêt à appliquer le correctif , cliquez sur Installer.
Une fois la configuration terminée, cliquez sur Terminer pour quitter l’Assistant.
À partir d’un client, vérifiez que vous pouvez vous connecter à l’instance AOS en tant qu’administrateur Microsoft Dynamics AX.
Validez l’installation du correctif logiciel en procédant comme suit :
- Ouvrez la classe SysHotfixManifest dans AOT.
- Vérifiez que la classe contient une méthode dont le nom est identique au numéro de l’article du correctif logiciel installé.
Utilisez l’outil de mise à niveau du code (« Comparaison de code ») pour comparer le changement SYP ou GLP avec n’importe quelle couche VAR ou CUS. S’il existe des personnalisations, le service informatique du partenaire ou du client peut être amené à fusionner le correctif logiciel dans le système personnalisé.
Correctifs logiciels publiés sous la forme d’une mise à jour de Windows Installer
Important : les actions suivantes doivent être effectuées :
- Le fichier de noyau ObjectServer doit être installé sur chaque serveur AOS.
- Le fichier noyau client doit être installé sur chaque ordinateur client.
- Le fichier du noyau NetBusinessConnector et le fichier du noyau ComBusinessConnector doivent être installés sur chaque ordinateur exécutant Microsoft Dynamics AX .NET Business Connector et Microsoft Dynamics AX Com Business Connector.
- Le fichier du noyau ApplicationIntegrationServer est l’adaptateur BizTalk. Assurez-vous d’installer le fichier du noyau ApplicationIntegrationServer avec le fichier du noyau NetBusinessConnector lorsque vous mettez à jour l’adaptateur BizTalk.
Une mise à jour de Windows Installer met à jour les fichiers binaires du client Microsoft Dynamics AX 4.0 suivants :
- Fichier .exe
- Les fichiers .dll
Ces fichiers sont également appelés fichiers du noyau. Pour appliquer la mise à jour de Windows Installer, procédez comme suit :
Extrayez les fichiers du correctif. Les fichiers extraits peuvent contenir les dossiers suivants :
- ApplicationIntegrationServer
- Client
- ComBusinessConnector
- NETBusinessConnector
- Serveur Objet
Testez le correctif logiciel dans un environnement de test. Ensuite, planifiez un temps d’arrêt.
Quittez tous les clients logiciels Microsoft Dynamics AX. Ensuite, arrêtez les instances AOS connectées au partage de fichiers du programme de production.
Sauvegardez la base de données, puis sauvegardez le dossier de l’application.
Exécutez le fichier Setup.exe inclus dans chaque dossier du correctif.
Redémarrez l’instance AOS. Examinez le journal des événements de l’application sur le serveur qui exécute le service AOS pour vous assurer que l’instance AOS démarre correctement. L’instance AOS reconstruit l’index de l’objet de l’application. Le fichier Axapd.aoi contient l’index de l’objet application.
Remarque En fonction du matériel serveur utilisé, le démarrage de l’instance AOS peut expirer avant la fin du processus. Ce problème se produit car le processus ne dispose pas de suffisamment de temps pour reconstruire le fichier Axapd.aoi.
Utilisez l’instance AOS pour vous connecter à un client à l’aide du compte Administrateur Microsoft Dynamics AX 4.0. Vérifiez que la connexion réussit.
Correctifs logiciels publiés sous la forme d’un fichier .xpo contenant du code
Les correctifs logiciels publiés sous forme de fichier .xpo contiennent des correctifs de niveau code qui affectent directement des objets ou des tables de base de données dans Microsoft Dynamics AX.
Important : Avant de continuer, examinez chaque fichier .xpo pour identifier les objets ou les tables qui seront modifiés. Notez toutes les personnalisations de votre environnement actuel qui peuvent être affectées. Nous vous recommandons vivement d’appliquer tous les correctifs logiciels dans un environnement de test avant de les appliquer à votre système en direct.
Connectez-vous à Microsoft Dynamics AX à l’aide du compte Administrateur Microsoft Dynamics AX. Assurez-vous qu’aucun autre utilisateur n’est connecté à Microsoft Dynamics AX.
Ouvrez la boîte de dialogue Arborescence des objets d’application . Pour cela, appliquez l’une des méthodes suivantes :
- Dans la barre d’outils Standard, cliquez sur Arborescence des objets de l’application.
- Sur le clavier, appuyez sur Ctrl+D.
- Dans le menu Fichier , pointez sur Ouvrir, puis cliquez sur Arborescence des objets de l’application.
Dans la boîte de dialogue Arborescence des objets application , cliquez sur Importer dans la barre d’outils.
Cliquez sur Parcourir, puis recherchez le fichier .xpo.
Dans la boîte de dialogue Ouvrir , cliquez sur le fichier .xpo, puis cliquez sur Ouvrir.
Cliquez sur OK pour terminer le processus d’importation.
Remarque Vous devrez peut-être effectuer une compilation en amont ou un processus de compilation AOT (Application Object Tree).
Comment installer des correctifs logiciels publiés sous forme de fichiers de couche DSI ou de couche DIP
Pour installer les correctifs logiciels publiés sous forme de fichiers de couche DSI ou DIP, procédez comme suit :
Extrayez les fichiers du correctif logiciel.
Avant de copier les fichiers inclus dans le correctif logiciel sur votre ordinateur, utilisez vos processus de sauvegarde habituels pour sauvegarder le dossier d’application et les fichiers serveur concernés par le correctif.
Testez le correctif logiciel dans un environnement de test. Ensuite, planifiez les temps d’arrêt lorsqu’aucun autre utilisateur n’est sur le système.
Quittez tous les clients logiciels Microsoft Dynamics AX. Ensuite, arrêtez les instances du serveur d’objets d’application connectées au partage de fichiers du programme de production.
Copiez les fichiers AxDIS.aod et AxDISen-us.ald dans chaque dossier d’application où se trouvent les autres fichiers .aod. Par défaut, ce dossier se trouve à l’emplacement suivant :
\application\appl\standardNote À cette étape, utilisez toujours la fonction de copie. N’utilisez pas la fonction de déplacement. Lorsque vous déplacez un fichier, les autorisations du dossier source sont prises pour ce fichier. Lorsque vous copiez un fichier, il récupère les autorisations du dossier cible.Faites une copie de sauvegarde du fichier Axapd.aoi en renommant le fichier. Vous pouvez également supprimer le fichier Axapd.aoi dans chaque dossier d’application.
Redémarrez l’instance AOS. Consultez le journal des applications sur le serveur qui exécute l’instance AOS pour vous assurer que l’instance AOS démarre correctement. L’instance AOS reconstruit l’index de l’objet de l’application. Le fichier Axapd.aoi contient l’index de l’objet application.
Remarque En fonction du matériel serveur utilisé, le démarrage de l’instance AOS peut expirer avant la fin du processus. Ce problème se produit car le processus ne dispose pas de suffisamment de temps pour reconstruire le fichier Axapd.aoi.
L’instance AOS conserve un status de départ jusqu’à ce que le fichier .aoi soit reconstruit. À ce stade, l’instance AOS aura un status « démarré ». Aucune étape supplémentaire n’est requise. Attendez la fin de la reconstruction, puis examinez le journal des applications pour obtenir une indication que l’instance AOS a démarré.
Utilisez l’instance AOS pour vous connecter à un ordinateur client en utilisant le compte Administrateur Microsoft Dynamics AX 4.0. Ensuite, connectez-vous à cette instance AOS en utilisant le logiciel client pour vérifier que vous pouvez vous connecter correctement. Enfin, vérifiez que les modifications ont été détectées par Microsoft Dynamics AX et qu’elles sont visibles dans AOT.
Si une liste de contrôle de mise à niveau apparaît, terminez-la pour vous assurer qu’aucun problème supplémentaire ne sera éventuel. Si aucune liste de contrôle de mise à niveau n’apparaît, la couche DIS ou DIP n’est pas reconnue. Si la couche DIS ou DIP n’est pas reconnue, appliquez une ou plusieurs des méthodes suivantes :
Créez un nouveau dossier d’application. Ensuite, copiez tous les fichiers du dossier d’application existant vers le nouveau dossier d’application.
Modifiez la configuration de l’instance AOS pour utiliser le nouveau dossier d’application. Pour ce faire, procédez comme suit :
Cliquez sur Démarrer, puis sur Exécuter, tapez Control Admintools, puis cliquez sur OK.
Double-cliquez sur l’utilitaire de configuration Microsoft Dynamics AX.
Sous l’onglet Serveur d’objets d’application, sélectionnez le nouveau dossier d’application que vous avez créé dans la liste des instances d’application.
Appliquez la configuration, puis redémarrez l’instance AOS.
Répétez l’étape 8.
Une fois la liste de contrôle remplie, recompilez l’ensemble de la demande.
Si vous utilisez plusieurs dossiers d’application et plusieurs instances AOS, arrêtez toutes les instances AOS, puis redémarrez toutes les instances AOS.
Références
Pour plus d’informations sur les options d’importation d’un fichier .xpo, consultez le Guide du développeur Microsoft Dynamics AX.
Les produits tiers mentionnés dans le présent article sont fabriqués par des sociétés indépendantes de Microsoft. Microsoft exclut toute garantie, implicite ou autre, concernant les performances ou la fiabilité de ces produits.