Cómo instalar una revisión de Microsoft Dynamics AX

Se aplica a
Microsoft Dynamics AX 2009 Microsoft Dynamics AX 4.0

Microsoft Business Solutions-Axapta 3.0 forma ahora parte de Microsoft Dynamics AX 3.0. Todas las referencias a Microsoft Business Solutions-Axapta y a Microsoft Axapta se refieren a Microsoft Dynamics AX.

INTRODUCCIÓN

En este artículo se proporcionan vínculos a documentación acerca de cómo instalar revisiones para Microsoft Dynamics AX 2012. También describe cómo instalar revisiones para Microsoft Dynamics AX 2009 y Microsoft Dynamics AX 4.0.

Nota: Asegúrese de revisar detenidamente el artículo de Microsoft Knowledge Base que documenta una revisión específica para determinar los objetos, las tablas de base de datos o los archivos que se verán afectados.

Más información

Revisiones publicadas para Microsoft Dynamics AX 2012

El proceso detallado para instalar actualizaciones y revisiones en Microsoft Dynamics AX 2012 se documenta en TechNet en la siguiente sección: Aplique actualizaciones y correcciones.

Revisiones publicadas para Microsoft Dynamics AX 2009 y para Microsoft Dynamics AX 4.0

Nota: El proceso general para instalar actualizaciones y revisiones en Microsoft Dynamics AX 2009 se documenta en el siguiente documento técnico: Mantenimiento de Microsoft Dynamics AX 2009.

Microsoft publica revisiones para Microsoft Dynamics AX en los siguientes formatos:

  • Las revisiones se publican como un archivo comprimido (.zip). Los archivos que contiene el archivo .zip reemplazan a los archivos existentes en el equipo.
  • Las revisiones se publican como una actualización de Microsoft Windows Installer. Estas revisiones contienen un archivo Setup.exe.

Microsoft publica revisiones para Microsoft Dynamics AX 4.0 en los siguientes formatos:

  • Las revisiones se publican como actualizaciones de Microsoft Windows Installer. Estas revisiones contienen un archivo Setup.exe.
  • Las revisiones se publican como archivos de capa DIS (AxDIS.aod) o como archivos de capa DIP (AxDIP.aod). Los cambios en la capa DIS solucionan problemas en el código de la capa SYS. Los cambios en la capa DIP solucionan problemas en el código de la capa GLS.
  • En muy raras ocasiones, las revisiones se publican como archivos .xpo que contienen código. El código se aplica a los objetos existentes, a las tablas de base de datos o a ambos.

Directrices generales para revisiones que reemplazan archivos

Algunas revisiones de Microsoft Dynamics AX reemplazan archivos en el equipo. Para obtener instrucciones acerca de cómo instalar una revisión que reemplaza archivos, lea atentamente la documentación que acompaña a la descarga de la revisión. A continuación se muestran recomendaciones generales para la instalación de revisiones que reemplacen archivos:

  • Antes de copiar en el equipo los archivos que se incluyen en la revisión, use los procesos de copia de seguridad habituales para realizar una copia de seguridad de los archivos del servidor afectados por la revisión.

  • Pruebe todas las revisiones en un entorno de prueba para comprobar que sus personalizaciones no se ven afectadas negativamente.

  • Haga que todos los usuarios cierren la sesión de la aplicación cliente de Microsoft Dynamics AX. Detenga la instancia del servidor de objetos de aplicación (AOS) antes de cambiar el nombre de los archivos de revisión y copiarlos.

  • Cuando se incluyan archivos de etiqueta en la revisión, copie todos los archivos de etiqueta incluidos en la carpeta de la aplicación Microsoft Dynamics AX. Los archivos de etiqueta tendrán las siguientes extensiones de nombre de archivo:

    • .ali
    • .acd
    • .alc

    De forma predeterminada, la carpeta de la aplicación tiene la siguiente ruta:
    directorio raíz\Axapta Application\appl\StandardNote En esta ruta de acceso, el directorio raíz representa la unidad de disco duro y el directorio principal en el que está instalado Microsoft Dynamics AX.

Entornos personalizados

Si personalizó el entorno antes de instalar una revisión, revise exhaustivamente el artículo de Microsoft Knowledge Base que documenta la revisión que desea instalar. Se sobrescribirán todos los objetos afectados por la revisión. Esto puede provocar que se pierdan las personalizaciones de esos objetos.

Copias de seguridad de bases de datos

Si las tablas de base de datos se ven afectadas, cree una copia de seguridad completa de la base de datos antes de aplicar la revisión. Para obtener instrucciones acerca de cómo realizar una copia de seguridad de una base de datos, consulte la documentación de Microsoft SQL Server. O consulte la documentación de Oracle Database Server.

Información de instalación

Revisiones publicadas para Microsoft Dynamics AX 2009

Para instalar revisiones publicadas como una actualización de aplicación para Microsoft Dynamics AX 2009, siga estos pasos:

  1. Extraiga los archivos del paquete.

  2. Abra el archivo kbxxxxxx.txt en el paquete de revisiones para identificar qué objetos se revisarán cuando se instale la revisión.

  3. Salga de todos los clientes de Microsoft Dynamics AX 2009 y, a continuación, detenga la instancia de AOS.

  4. Haga una copia de seguridad de la base de datos.

  5. Haga una copia de seguridad de la carpeta de la aplicación.

  6. Reinicie la instancia de AOS y, a continuación, revise el registro de aplicación en el servidor que ejecuta el servicio de AOS para asegurarse de que la instancia de AOS se inicia correctamente. La instancia de AOS vuelve a generar el índice del objeto de aplicación. El archivo Axapd.aoi contiene el índice del objeto de aplicación. 

    Nota: Según el hardware del servidor que esté utilizando, el tiempo de espera del inicio de la instancia AOS puede agotar el tiempo de espera antes de que se complete el proceso. Este problema se produce porque el proceso no tiene tiempo suficiente para volver a generar el archivo Axapd.aoi antes de que el AOS intente usar el archivo. 

    La instancia AOS permanece en un estado inicial hasta que se completa la recompilación del archivo *.aoi. En ese momento, la instancia de AOS tiene un estado "iniciado". No se requieren pasos adicionales. Espere a que finalice la recompilación y, a continuación, revise el registro de la aplicación para obtener una indicación de que se inicia la instancia de AOS.

  7. Ejecute el archivo Axpatch.exe para la instalación de la revisión de la aplicación.

    1. Seleccione el idioma en el que desea ejecutar la instalación y haga clic en Aceptar.

    2. Cuando se inicie el asistente para la instalación, haga clic en Siguiente.

    3. Revise los Términos de licencia del software de Microsoft, active la casilla para aceptar los términos de licencia si está de acuerdo y, a continuación, haga clic en Siguiente.

    4. En la página Seleccionar componentes , la opción Archivos de aplicación debe estar seleccionada de forma predeterminada. Haga clic en Siguiente.

    5. En la página Seleccionar configuración , indique la configuración correcta y, a continuación, haga clic en Siguiente.

    6. En la página Listo para aplicar la revisión , haga clic en Instalar.

    7. Una vez finalizada la instalación, haga clic en Finalizar para salir del asistente.

  8. Desde un cliente, compruebe que puede conectarse a la instancia de AOS como administrador de Microsoft Dynamics AX.

  9. Valide la instalación de la revisión siguiendo estos pasos:

    • Abra la clase SysHotfixManifest en el AOT.
    • Compruebe que la clase contiene un método cuyo nombre es el mismo que el número de artículo de la revisión instalada.
  10. Use la herramienta de actualización de código ("Comparación de código") para comparar el cambio SYP o GLP con cualquier capa VAR o CUS. Si existen personalizaciones, es posible que el personal de TI del partner o cliente tenga que combinar la revisión en el sistema personalizado.

Revisiones que se publican como una actualización de Windows Installer

Importante Se deben realizar las siguientes acciones:

  • El archivo kernel de ObjectServer debe instalarse en cada servidor AOS.
  • El archivo de kernel del cliente debe instalarse en cada equipo cliente.
  • El archivo de kernel de NetBusinessConnector y el de ComBusinessConnector deben estar instalados en todos los equipos que ejecutan Microsoft Dynamics AX .NET Business Connector y Microsoft Dynamics AX Com Business Connector.
  • El archivo de kernel ApplicationIntegrationServer es el adaptador de BizTalk. Asegúrese de instalar el archivo de kernel ApplicationIntegrationServer junto con el archivo de kernel NetBusinessConnector cuando actualice el adaptador BizTalk.

Una actualización de Windows Installer actualiza los siguientes archivos binarios del cliente de Microsoft Dynamics AX 4.0:

  • El archivo .exe
  • Los archivos .dll

Estos archivos también se conocen como archivos del kernel. Para aplicar la actualización de Windows Installer, siga estos pasos:

  1. Extraiga los archivos de la revisión. Los archivos extraídos pueden contener las siguientes carpetas:

    • ApplicationIntegrationServer
    • Cliente
    • ComBusinessConnector
    • NETBusinessConnector
    • Servidor de objetos
  2. Pruebe la revisión en un entorno de prueba. Luego, programe el tiempo de inactividad.

  3. Salga de todos los clientes de software de Microsoft Dynamics AX. A continuación, apague las instancias de AOS conectadas al recurso compartido de archivos del programa de producción.

  4. Realice una copia de seguridad de la base de datos y, a continuación, una copia de seguridad de la carpeta de la aplicación.

  5. Ejecute el archivo Setup.exe que se incluye en cada carpeta de la revisión.

  6. Reinicie la instancia de AOS. Revise el registro de sucesos de aplicación en el servidor que ejecuta el servicio AOS para asegurarse de que la instancia de AOS se inicia correctamente. La instancia de AOS vuelve a generar el índice del objeto de aplicación. El archivo Axapd.aoi contiene el índice del objeto de aplicación.

    Nota: Según el hardware de servidor que esté utilizando, el tiempo de espera del inicio de la instancia AOS puede agotar el tiempo de espera antes de que se complete el proceso. Este problema se produce porque el proceso no tiene tiempo suficiente para volver a generar el archivo Axapd.aoi.

  7. Utilice la instancia de AOS para iniciar sesión en un cliente mediante la cuenta de administrador de Microsoft Dynamics AX 4.0. Compruebe que puede conectarse correctamente.

Revisiones que se publican como un archivo .xpo que contiene código

Las revisiones que se publican como un archivo .xpo contienen correcciones de nivel de código que afectan directamente a objetos o tablas de base de datos en Microsoft Dynamics AX.

Importante Antes de continuar, examine cada archivo .xpo en busca de los objetos o tablas que se van a cambiar. Tenga en cuenta cualquier personalización de su entorno actual que pueda verse afectada. Recomendamos encarecidamente que aplique todas las revisiones en un entorno de prueba antes de aplicarlas a su sistema activo.

  1. Inicie sesión en Microsoft Dynamics AX utilizando la cuenta de administrador de Microsoft Dynamics AX. Asegúrese de que ningún otro usuario haya iniciado sesión en Microsoft Dynamics AX.

  2. Abra el cuadro de diálogo Árbol de objetos de aplicación . Para ello, utilice uno de los métodos siguientes:

    • En la barra de herramientas de Standard, haga clic en Árbol de objetos de aplicación.
    • En el teclado, presione Ctrl+D.
    • En el menú Archivo , seleccione Abrir y, a continuación, haga clic en Árbol de objetos de aplicación.
  3. En el cuadro de diálogo Árbol de objetos de aplicación , haga clic en Importar en la barra de herramientas.

  4. Haga clic en Examinar y busque el archivo .xpo.

  5. En el cuadro de diálogo Abrir , haga clic en el archivo .xpo y, después, haga clic en Abrir.

  6. Haga clic en Aceptar para completar el proceso de importación.

    Nota: Es posible que tenga que completar una compilación directa o un proceso completo de compilación del árbol de objetos de aplicación (AOT).

Cómo instalar revisiones publicadas como archivos de capa DIS o DIP

Para instalar revisiones publicadas como archivos de capa DIS o DIP, siga estos pasos:

  1. Extraiga los archivos del paquete de revisiones.

  2. Antes de copiar en el equipo los archivos que se incluyen en la revisión, use los procesos de copia de seguridad habituales para realizar una copia de seguridad de la carpeta de la aplicación y de los archivos del servidor afectados por la revisión.

  3. Pruebe la revisión en un entorno de prueba. Luego, programe el tiempo de inactividad cuando no haya otros usuarios en el sistema.

  4. Salga de todos los clientes de software de Microsoft Dynamics AX. A continuación, apague las instancias del servidor de objetos de aplicación que están conectadas al recurso compartido de archivos del programa de producción.

  5. Copie el archivo AxDIS.aod y el archivo AxDISen-us.ald en cada carpeta de aplicación donde existan los otros archivos .aod. De forma predeterminada, esta carpeta se encuentra en la ubicación siguiente:
    \application\appl\standardNote En este paso, use siempre la función de copia. No use la función mover. Al mover un archivo, se tomarán los permisos de la carpeta de origen para este archivo. Al copiar un archivo, tomará los permisos de la carpeta de destino.

  6. Haga una copia de seguridad del archivo Axapd.aoi cambiando el nombre del archivo. O elimine el archivo Axapd.aoi en cada carpeta de la aplicación.

  7. Reinicie la instancia de AOS. Revise el registro de aplicación en el servidor que ejecuta la instancia de AOS para asegurarse de que la instancia de AOS se inicia correctamente. La instancia de AOS vuelve a generar el índice del objeto de aplicación. El archivo Axapd.aoi contiene el índice del objeto de aplicación.

    Nota: Según el hardware de servidor que esté utilizando, el tiempo de espera del inicio de la instancia AOS puede agotar el tiempo de espera antes de que se complete el proceso. Este problema se produce porque el proceso no tiene tiempo suficiente para volver a generar el archivo Axapd.aoi.

    La instancia AOS permanecerá en un estado inicial hasta que se vuelva a generar el archivo .aoi. En ese momento, la instancia de AOS tendrá un estado "iniciado". No se requieren pasos adicionales. Espere a que finalice la recompilación y, a continuación, revise el registro de la aplicación para obtener una indicación de que se inició la instancia de AOS.

  8. Utilice la instancia de AOS para iniciar sesión en un equipo cliente utilizando la cuenta de administrador de Microsoft Dynamics AX 4.0. A continuación, conéctese a esta instancia de AOS mediante el software cliente para comprobar que puede conectarse correctamente. Por último, compruebe que los cambios se detectaron en Microsoft Dynamics AX y que están visibles en el AOT.

  9. Si aparece una lista de comprobación de actualización, complete la lista de comprobación para asegurarse de que no habrá ningún problema adicional. Si no aparece ninguna lista de comprobación de actualización, no se reconoce la capa DIS o DIP. Si no se reconoce la capa DIS o DIP, utilice uno o varios de los métodos siguientes:

    • Cree una nueva carpeta de aplicación. A continuación, copie todos los archivos de la carpeta de aplicación existente a la nueva carpeta de aplicación.

    • Cambie la configuración de la instancia de AOS para utilizar la nueva carpeta de aplicación. Para hacerlo, siga estos pasos.

      1. Haga clic en Inicio y en Ejecutar, escriba Control Admintools y haga clic en Aceptar.

      2. Haga doble clic en Microsoft Dynamics AX Configuration Utility.

      3. En la pestaña Servidor de objetos de aplicación , seleccione la nueva carpeta de aplicación que creó en la lista de instancias de aplicación.

      4. Aplique la configuración y, a continuación, reinicie la instancia de AOS.

      5. Repita el paso 8.

  10. Una vez completada la lista de comprobación, vuelva a compilar toda la aplicación.

  11. Si está utilizando varias carpetas de aplicaciones y varias instancias de AOS, detenga todas las instancias de AOS y, a continuación, reinicie todas las instancias de AOS.

Referencias

Para obtener más información sobre las opciones de importación de un archivo .xpo, consulte la Guía para desarrolladores de Microsoft Dynamics AX.

Los productos de otros fabricantes que se mencionan en este artículo han sido creados por compañías independientes de Microsoft. Microsoft no ofrece ninguna garantía, ya sea implícita o de otro tipo, sobre la confiabilidad o el rendimiento de dichos productos.