Cómo instalar una aplicación de BizTalk

Artículo
05/04/2023

Este tema describe cómo instalar una aplicación en un equipo local al hacer doble clic en el archivo (.msi) de Windows Installer para la aplicación de la interfaz de Windows o al ejecutar msiexec desde la línea de comandos. También puede iniciar el Asistente para la instalación como el último paso del Asistente para importación, como se describe en Cómo importar una aplicación de BizTalk.

Precaución

Si esta aplicación ya se ha instalado en este equipo, se le ofrecerá la posibilidad de reparar la aplicación. Sólo se admite la reparación cuando se ha instalado un único .msi para esta aplicación. Si ha instalado más de un .msi en este equipo para esta aplicación, no debería seleccionar esta opción. Esto se debe a que si selecciona Reparar, se desharán los cambios realizados por los archivos .msi que se instalaron posteriormente a este archivo .msi, lo que puede producir un error de funcionamiento de la aplicación.

Antes de poner en funcionamiento una aplicación, la debe instalar en los equipos de BizTalk Server que la ejecutarán. Al instalar una aplicación, se colocan sus recursos en el sistema de archivos local. En función de la aplicación, sus contenidos y su configuración, la instalación también puede realizar lo siguiente:

Agregar ensamblados a la caché de ensamblados global (GAC)
Instalar certificados y directorios virtuales
Agregar componentes al Registro de Windows
Ejecutar secuencias de comandos previas y posteriores al procesamiento, si están presentes en el archivo .msi.

Para obtener información general, consulte What Happens to Artifacts During Installation and Uninstallation.

Requisitos previos

Para realizar los procedimientos de este tema, deberá iniciar sesión con una cuenta que tenga permisos de escritura en el sistema de archivos local. En función de los elementos que incluye la aplicación, también necesita permisos de escritura en el Registro de Windows, GAC, almacén de certificados y en los Servicios de Internet Information. La cuenta de administradores del equipo local tiene estos permisos. Para obtener información más detallada sobre los permisos, vea Permisos necesarios para implementar y administrar una aplicación de BizTalk.

Consideraciones para instalar aplicaciones

Al instalar una aplicación, es preciso tener en cuenta lo siguiente:

Debe instalar aplicaciones de las que tenga dependencia esta aplicación. Cuando instale una aplicación que tenga dependencia de un artefacto, como de un ensamblado de BizTalk, que está contenido en otra aplicación, también es necesario instalar la aplicación que contiene el artefacto. Debe hacerlo para poder ejecutar la aplicación. Por ejemplo, si la aplicación A depende de un ensamblado en la aplicación B, también debe instalar la aplicación B. A continuación, puede instalar la aplicación A. Para obtener información general, consulte Dependencias e implementación de aplicaciones.
Debe detener las aplicaciones que se están actualizando. Si realiza la instalación para actualizar el artefacto en la aplicación, no es necesario detener la aplicación a menos que la actualización incluya uno o más ensamblados que tengan la misma extensión que los ensamblados existentes. En este caso, debe detener la aplicación antes de instalar la actualización. Sin embargo, se recomienda detener la aplicación en todos los casos a menos que sepa que la actualización no interferirá en la aplicación cuando se ejecute. Para obtener más información, vea Actualizar aplicaciones de BizTalk.
Cuando instala varios archivos .msi para la misma aplicación, solo se realiza una entrada en Agregar o quitar programas. Puede hacer esto para actualizar una aplicación existente, por ejemplo. Puede usar la opción Agregar o quitar programas (en el Panel de control) para desinstalar la aplicación por completo, incluyendo todos los elementos actualizados. Tenga en cuenta que no se admite desinstalar una aplicación haciendo doble clic en el archivo .msi o mediante msiexec. Para obtener más información, vea Cómo desinstalar una aplicación de BizTalk.
Los certificados deben estar presentes en todos los equipos que alojan puertos de envío antes de que se pueda ejecutar una aplicación. El almacén de certificados Otras personas contiene los certificados que utilizan los puertos de envío.
Puede descomponer los artefactos de la aplicación en varios archivos .msi para la instalación. No es necesario instalar todos los artefactos de la aplicación en cada equipo que ejecutará la aplicación. En su lugar, puede exportar subconjuntos de los artefactos de la aplicación en varios archivos .msi que se van a instalar en distintos equipos. Para obtener instrucciones, vea Cómo exportar una aplicación de BizTalk.
Si el archivo .msi de la aplicación incluye un directorio virtual, los Servicios de Internet Information Server (IIS) se deben ejecutar en el equipo local. De no ser así, se producirá un error en la instalación
Si la aplicación incluye un directorio virtual con el mismo nombre que uno existente en el equipo local, se le agregan recursos desde la aplicación. De lo contrario, se crea un directorio virtual. Se sobrescribirán todos los archivos que tengan el mismo nombre que los archivos agregados. Asimismo, la configuración de seguridad para el directorio virtual existente no cambia y debería comprobar que es lo suficiente segura.
Crear grupos de aplicaciones para los directorios virtuales antes de instalar una aplicación. Si la aplicación incluye un directorio virtual y el grupo de aplicaciones no existe en IIS, debe crear de forma manual el grupo de aplicaciones antes de la instalación. De esta forma, el directorio virtual se enlazará al grupo de aplicaciones durante la instalación. Si no crea la aplicación, el directorio virtual se enlazará al grupo de aplicaciones predeterminado durante la instalación.
Asegúrese de que BTSHttpReceive.dll está registrado como asignación de controlador en Internet Information Services (IIS) 7.0. Para que la ubicación de recepción HTTP funcione, deberá hacer esto si la aplicación incluye un directorio virtual.
Se pueden producir errores al instalar una aplicación que incluya artefactos de 64 bits en un equipo de 32 bits. Para obtener más información, vea Cómo agregar un artefacto de 64 bits a una aplicación.
Se pueden producir problemas si la longitud del directorio de destino supera los 260 caracteres. Si el número de caracteres del directorio de destino que se ha especificado durante la instalación de un paquete MSI supera los 260 caracteres, se producirá un error en la instalación. Para solucionar este problema, asegúrese de que el número de caracteres especificado para el directorio de destino no supera los 260 caracteres.
No debería cambiar la ubicación de una carpeta de instalación. Tras instalar la aplicación, no debería cambiar la ubicación de la carpeta de instalación o de los archivos que la contienen. Si lo hace e intenta quitar (desinstalar) la aplicación, se producirá un error en la operación de eliminación. En concreto, la carpeta de instalación de la aplicación contiene archivos generados por BizTalk Server que son necesarios para realizar la eliminación. No debe cambiar el nombre, mover o quitar estos archivos. Los archivos son:
- ApplicationDefinition.adf
- Microsoft.BizTalk.CustomInstaller.dll
- Microsoft.BizTalk.CustomInstaller.InstallState

Nota

Si cancela la operación de instalación antes de que finalice, BizTalk Server revertirá la instalación, excepto las acciones realizadas por scripts previos o posteriores al procesamiento antes de cancelar la operación.

Importante

Antes de instalar aplicaciones, asegúrese de que ha recibido el archivo .msi de una fuente de confianza. Un usuario malintencionado puede incluir un código en el archivo .msi que tenga un efecto no deseado en el sistema o en la red. Para obtener más información, vea Seguridad y Windows Installer.

Si la aplicación incluye un sitio Web o una orquestación que utilice un servicio Web, tenga en cuenta que la configuración de seguridad del directorio virtual es la que está activa cuando se genera el archivo .msi durante la exportación de la aplicación, salvo en el caso de directorios virtuales existentes, ya que se utiliza la configuración existente. Tras instalar la aplicación, debe comprobar que la configuración satisface sus requisitos de seguridad.

Todas las listas de control de acceso (DACL) de todos los documentos se quitan de archivos y carpetas cuando se exporta una aplicación. Tras instalar una aplicación en una instancia de host, debe volver a configurar la configuración de seguridad de los archivos y carpetas, incluyendo la de los directorios virtuales.

Es posible que necesite cambiar la ruta local: designación de un directorio virtual al que la ubicación de recepción HTTP hace referencia tras su creación en el equipo de destino.

Cuando el directorio virtual se crea en el equipo de destino, apuntará a uno de los siguientes directorios físicos:

<unidad de> instalación\Archivos de programa\Microsoft BizTalk Server\HttpReceive

- o –

<unidad de> instalación\Archivos de programa (x86)\Microsoft BizTalk Server\HttpReceive

Si el archivo BTSHTTPReceive.dll de la extensión ISAPI de recepción HTTP de BizTalk no se encuentra en el directorio especificado, o si el equipo de destino ejecuta un sistema operativo de 64 bits, tendrá que cambiar la ruta local: designación del directorio virtual con el que se apunta al directorio físico que contiene el archivo de extensión ISAPI de recepción HTTP de BizTalk. Por ejemplo, si la máquina de destino ejecuta la versión de 64 bits de Windows Vista, la ruta de acceso local: designación del directorio virtual debe cambiarse a <unidad> de instalación\Archivos de programa (x86)\Microsoft BizTalk Server\HttpReceive64.

Para instalar una aplicación de BizTalk

Uso de la interfaz de Windows

Copie el archivo .msi para la aplicación en el equipo local.
Si va a reinstalar o actualizar una aplicación de BizTalk existente y la nueva instalación incluye un ensamblado que tiene la misma versión que la que ya existe en la aplicación, o interactúa con un artefacto que está actualizando, asegúrese de que la aplicación se detiene haciendo clic con el botón derecho en la carpeta de la aplicación y, a continuación, haciendo clic en Detener.
En el Explorador de Windows, haga doble clic en el archivo .msi para iniciar el Asistente para instalación.
En la página Seleccionar carpeta de instalación , en Carpeta, escriba la ruta de instalación completa de la aplicación de BizTalk. Ejemplo: C:\Archivos de programa\Generated by BizTalk\MyApplication.
Haga clic en Siguiente cuatro veces y, a continuación, en la página Instalación completada , haga clic en Cerrar.
Si varios equipos ejecutarán la aplicación, repita los pasos anteriores en cada equipo.

Una vez instalada la aplicación en todos los equipos que lo ejecutarán y la aplicación se ha importado en el grupo de BizTalk, puede iniciar la aplicación desde la consola de administración de BizTalk Server haciendo clic con el botón derecho en la carpeta de la aplicación y haciendo clic en Iniciar. Para obtener instrucciones completas, vea Cómo iniciar y detener una aplicación de BizTalk.

Uso de la línea de comandos

Copie el archivo .msi para la aplicación en el equipo local.
Haga clic en Inicio, haga clic en Ejecutar, escriba cmdy presione ENTRAR.
Desplácese a la ubicación en la que se almacena el archivo .msi.

Escriba el comando siguiente para instalar la aplicación, proporcionando los valores y parámetros apropiados, como se muestra en la tabla siguiente:

Importante

Sólo se admiten los valores de msiexec que se muestran en la tabla siguiente.

msiexec [/i] Paquete [/qn] TARGETDIR="value"]

Ejemplo: msiexec /i MyApplication.msi

Parámetro	Value
/i	Instala la aplicación.
Paquete	Nombre del archivo (.msi) de Windows Installer.
/Qn	Efectúa la instalación sin mostrar una interfaz de usuario.
TARGETDIR="value"	Especifica la carpeta de instalación de la aplicación. El valor se ha configurado en la variable de entorno %BTAD_InstallDir%. Ejemplo: TARGETDIR="C:\Archivos de programa\BizTalk Applications\My Application"

Si varios equipos ejecutarán la aplicación, repita los pasos anteriores en cada equipo.

Una vez instalada la aplicación en todos los equipos que lo ejecutarán, puede iniciar la aplicación desde la consola de administración de BizTalk Server haciendo clic con el botón derecho en la carpeta de la aplicación y haciendo clic en Iniciar. Para obtener instrucciones completas, vea Cómo iniciar y detener una aplicación de BizTalk.

Consulte también

Implementación de aplicaciones de BizTalk
Cómo desinstalar una aplicación de BizTalk

Share via