Cómo exportar una aplicación de BizTalk

Artículo
05/04/2023

En este tema se describe cómo utilizar la consola de administración de BizTalk Server o la línea de comandos para exportar una aplicación. Exportar una aplicación de BizTalk genera un archivo (.msi) de Windows Installer que contiene la aplicación y los artefactos seleccionados para que se exportaran. La opción predeterminada es seleccionar todos los artefactos de la aplicación, pero puede seleccionar un subconjunto de ellos. A continuación, puede importar el archivo .msi a otro grupo de BizTalk para agregar los artefactos a una aplicación existente de un grupo nuevo, actualizar los artefactos de una aplicación existente o crear una aplicación nueva en el grupo que contiene los artefactos que se van a importar. Para obtener más información, vea Cómo importar una aplicación de BizTalk. También usa el archivo .msi para instalar la aplicación en los equipos que lo ejecutarán, como se describe en Cómo instalar una aplicación de BizTalk. Si la aplicación incluye artefactos basados archivos, debe instalarla antes de que pueda funcionar.

Al exportar una aplicación, tenga en cuenta que los siguientes puntos son importantes:

Los enlaces importados sobrescriben automáticamente los enlaces existentes. Si no desea que los enlaces de la aplicación que se está exportando sobrescriban los enlaces de la aplicación en la que se está importando un archivo .msi, no seleccione el archivo de enlace como un recurso que es preciso exportar. Al importar un archivo .msi que contenga un archivo de enlace en una aplicación existente, los enlaces importados sobrescribirán los existentes, incluso si no ha activado la opción de sobrescribir artefactos existentes.
Un usuario puede que esté realizando cambios a un artefacto mientras exporta la aplicación. Si el usuario modifica un artefacto basado en bases de datos, tal como un directorio virtual, un certificado o una directiva, mientras está en curso una operación de exportación, los cambios no se reflejarán en el archivo .msi exportado. Por lo tanto, se recomienda programar las operaciones de exportación durante horas cuando sea probable que los usuarios no realicen cambios en estos artefactos.
Se puede mostrar un error incorrecto al instalar un .msi en Windows Vista. Al instalar un paquete de .msi exportado mediante BizTalk Server, puede recibir el siguiente error incorrecto: "El instalador ha encontrado un error inesperado al instalar este paquete. Esto puede deberse a un problema del paquete. El código de error es 2869". Para corregir este error, importe primero el paquete de .msi mediante BizTalk Server y, a continuación, vuelva a exportar e instalar el paquete.
La aplicación puede que dependa de otra aplicación. Esto puede afectar a cómo implemente la aplicación. Para obtener más información, consulte Dependencias e implementación de aplicaciones.
Puede modificar el directorio de destino de los recursos de la aplicación antes de realizar la exportación. Si desea cambiar la ubicación de destino, expanda el nodo de recursos de la aplicación, haga clic con el botón derecho en el recurso que desea cambiar y, después, elija Modificar. En el cuadro de diálogo Modificar recursos, escriba una nueva ubicación en para Ubicación de destino.
Se producirá un error en la operación de exportación si la aplicación contiene una directiva que se ha quitado de la base de datos del motor de reglas. Cuando se quita una directiva de la base de datos del motor de reglas mediante el Asistente para implementar el motor de reglas, ésta se mostrará en la consola de administración en estado “No publicada” y no se podrá exportar la aplicación. Para obtener más información sobre el Asistente para la implementación del motor de reglas, vea Cómo implementar y anular la implementación de directivas y vocabularios.

Importante

El archivo .msi puede contener datos confidenciales. Asegúrese de seguir los pasos necesarios para garantizar que el archivo es seguro. Para obtener más información, vea Seguridad y Windows Installer.

Las contraseñas se quitan de los enlaces de aplicación durante la exportación de la aplicación. Después de instalar la aplicación desde el archivo .msi, deberá volver a configurar las contraseñas para que funcione la aplicación. No obstante, las contraseñas no se quitan de ningún archivo de enlace que se haya agregado a la aplicación.

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 el archivo .msi se genera durante la exportación de la aplicación. Si va a implementar una aplicación en un entorno de producción, antes de exportar la aplicación, debe comprobar que la configuración cumple los requisitos de seguridad. Si el directorio virtual ya existe en el equipo host, su configuración de seguridad no se sobrescribe, pero se le agregan los archivos de la aplicación. Debería comprobar la configuración de seguridad después de importar la aplicación.

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

Nota

Si se produce un error en la operación de exportación, BizTalk Server elimina todos los archivos temporales junto con el archivo .msi, si se ha creado uno.

Requisitos previos

Para realizar los procedimientos descritos en este tema, deberá iniciar la sesión con una cuenta que sea miembro del grupo de administradores de BizTalk Server. Para obtener información más detallada sobre los permisos, vea Permisos necesarios para implementar y administrar una aplicación de BizTalk. Asimismo, debe estar instalado el motor de reglas de negocios. Para obtener más información, consulte Instalación de BizTalk Server.

Exportación de una aplicación mediante administración de BizTalk Server

Haga clic en Inicio, todos los programas, Microsoft BizTalk Server 20xx y, a continuación, haga clic en Administración de BizTalk Server.
En el árbol de consola, expanda BizTalk Server Administración, expanda el grupo de BizTalk y, a continuación, expanda Aplicaciones.
Haga clic con el botón derecho en la aplicación que desea exportar, seleccione Exportar y, a continuación, haga clic en Archivo MSI.
En la página Asistente para exportar archivos MSI, haga clic en Siguiente.
En la página Seleccionar recursos, seleccione los artefactos que se van a exportar al archivo .msi y, a continuación, haga clic en Siguiente.
Si se le solicita, en la página Especificar hosts de IIS, escriba el nombre del servidor del equipo que hospeda el directorio virtual que desea incluir y, a continuación, haga clic en Siguiente. Se le pedirá que especifique el servidor sólo si el directorio virtual no se ha agregado previamente a la base de datos de administración de BizTalk, como cuando se agregó a la aplicación o se importó a una aplicación.
En la página Dependencias, revise las dependencias de la aplicación y, a continuación, haga clic en Siguiente.
En la página Destino, en Nombre de la aplicación de destino, escriba el nombre de la aplicación.
En el archivo MSI que se va a generar, escriba la ruta de acceso completa del archivo .msi y, a continuación, haga clic en Exportar. Ejemplo: C:\MSI\Errorhandling.msi

Nota

Se recomienda almacenar los archivos .msi en una carpeta segura.
En la página Resumen, anote la ubicación del archivo de registro de esta operación y, a continuación, haga clic en Finalizar.

Exportación de una aplicación mediante la línea de comandos

Abra un símbolo del sistema como se indica a continuación: haga clic en Inicio, haga clic en Ejecutar, escriba cmdy, a continuación, haga clic en Aceptar.

Escriba el siguiente comando, sustituyendo los valores según corresponda, como se describe en la tabla que se presenta a continuación:

BTSTask ExportApp [/ApplicationName:value] /Package:value [ResourceSpec:value [/Server:value] [/Database:value]

Nota

En un sistema que admita el Control de cuentas de usuario (UAC), es posible que deba ejecutar la herramienta con privilegios administrativos.

Ejemplo:

BTSTask ExportApp /ApplicationName:MyApplication /Package:C:/MSI/MyApplication.msi /ResourceSpec:"C:\My Files\ResourceSpec.xml" /Server:MySQLServer /Database:BizTalkMgmtDb

Los artefactos especificados se exportan al archivo .msi en la ubicación especificada.

Parámetro	Value
/Applicationname	Nombre de la aplicación de BizTalk que se va a exportar. Si no se especifica el nombre de aplicación, se utiliza la aplicación predeterminada de BizTalk. Si el nombre incluye espacios, debe ir entre comillas dobles (").
/Paquete	Ruta de acceso del archivo .msi que se va a crear, incluyendo el nombre de archivo.
/ResourceSpec	Ruta de acceso del archivo XML de especificación del recurso, incluido el nombre de archivo. Puede especificar los artefactos que se van a exportar editando el archivo XML de especificación de recursos, que se crea al ejecutar el comando ListApp con el parámetro ResourceSpec, como se describe en ListApp Command. Debe editar manualmente este archivo para agregar el nombre del servidor de host de Servicios de Internet Information Services (IIS) para el directorio virtual que desea exportar si el servidor Web no se encuentra en un equipo remoto.
/Servidor	Nombre del servidor SQL Server que aloja la base de datos de administración de BizTalk en el formato Nombredelservidor\Nombredeinstancia,Puerto. Sólo se necesita el nombre de instancia cuando el nombre de instancia es diferente del nombre de servidor. Sólo se necesita el puerto cuando el servidor SQL Server utiliza un nombre de puerto diferente al predeterminado (1433) Ejemplos: Servidor = MyServer Servidor = MyServer\MySQLServer,1533 Si no se proporciona, se utiliza el nombre de la instancia de SQL Server que se ejecuta en el equipo local.
/Base	Nombre de la base de datos de administración de BizTalk. Si no se especifica, se utiliza la base de datos de administración de BizTalk que se ejecuta en la instancia local de SQL Server.

Consulte también

Exportación de aplicaciones, enlaces y directivas de BizTalk
ExportApp (comando)

Compartir vía