Cómo importar una aplicación de BizTalk
En este tema se describe cómo utilizar la consola de administración de BizTalk Server o la línea de comandos para importar una aplicación de BizTalk en un grupo de BizTalk. La importación de una aplicación de BizTalk registra los artefactos en la base de datos de administración de BizTalk y escribe los datos de aquéllos en las bases de datos de BizTalk apropiadas. Para obtener más información, consulte ¿Qué ocurre cuando se importan artefactos? Cuando se instala una aplicación, ésta no se instala. Antes de poder ejecutar una aplicación que incluya artefactos basados en archivos, es preciso instalarla.
Al utilizar la consola de administración de BizTalk Server para importar una aplicación, la ubicación desde la que se inicia el Asistente para importación de MSI determina la posibilidad o no de crear una nueva aplicación a la vez que se efectúa la importación de los artefactos. Si inicia el Asistente haciendo clic con el botón secundario en el grupo de BizTalk, tendrá que proporcionar un nombre de aplicación. Si una aplicación del grupo de BizTalk tiene el nombre especificado, los artefactos del archivo se importan en esta aplicación; de lo contrario, se creará una nueva aplicación con el nombre especificado en la que se importan los artefactos. Si se inicia el Asistente haciendo clic con el botón secundario en una aplicación, no será posible especificar un nombre de aplicación y los artefactos se importarán en la aplicación actual.
Al utilizar la herramienta de línea de comandos BTSTask para importar un archivo .msi, la especificación de un nombre de aplicación es opcional. Si no se proporciona un nombre, sus artefactos se importarán en la aplicación predeterminada.
Tras importar los artefactos, es posible verlos en la carpeta adecuada de la carpeta de la aplicación en la consola de administración de BizTalk. También puede ver una lista de artefactos en la aplicación mediante BTSTask, como se describe en ListApp Command.
Requisitos previos
Para importar una aplicación de BizTalk, es preciso haber iniciado sesión con una cuenta que sea miembro del grupo de administradores de BizTalk Server. Para instalar una aplicación de BizTalk, también se debe contar, como mínimo, con permisos de escritura en el sistema de archivos local. Para obtener información más detallada sobre los permisos, vea Permisos necesarios para implementar y administrar una aplicación de BizTalk.
Consideraciones para importar aplicaciones
Al importar una aplicación, es preciso tener en cuenta lo siguiente:
Importación de aplicaciones de versiones anteriores de BizTalk Server. Si va a importar aplicaciones desde BizTalk Server 2006 R2 o BizTalk Server 2009, y las aplicaciones contienen datos de entidad EDI/AS2, la importación de la aplicación podría producir un error porque el modelo de administración de socios comerciales ha cambiado considerablemente en BizTalk Server. Debe utilizar en su lugar la Herramienta de migración de entidades para migrar los datos de entidades de versiones anteriores de BizTalk Server. Para obtener más información sobre la herramienta, consulte Utilidades de migración de EDI.
Los enlaces importados siempre sobrescriben los enlaces existentes. Al importar un archivo .msi que contenga enlaces en una aplicación existente, los enlaces importados sobrescribirán los existentes que tengan el mismo nombre. Esto ocurre aun si no se ha seleccionado la opción de sobrescritura de los artefactos existentes al importar el archivo .msi. Si no desea que los enlaces de la aplicación que se está exportando sobrescriba los enlaces de la aplicación en la que se está importando el archivo .msi, no seleccione el archivo de enlace como un recurso que es preciso exportar durante la exportación. Para obtener más información, vea Cómo exportar una aplicación de BizTalk.
A medida que se aplican los enlaces durante el proceso de importación, los enlaces que ya se han aplicado se sobrescriben con enlaces nuevos que tienen el mismo nombre. Es decir, surtirá efecto el último enlace de un nombre concreto que se aplica. Cuando importa una aplicación, los enlaces se aplican en el orden siguiente:
Los enlaces de la aplicación generados por BizTalk Server que no se agregaron explícitamente a la aplicación mediante un archivo de enlace, pero que el usuario seleccionó explícitamente para exportarlos al archivo .msi de la aplicación.
Los archivos de enlace que se han agregado explícitamente y que no tienen especificado un entorno de implementación de destino. Los enlaces de este conjunto no se aplican en ningún orden específico.
Los enlaces que se ha agregado explícitamente y que tienen un entorno de implementación de destino asociado que coincide con el entorno de implementación seleccionado para la importación de la aplicación. Los enlaces de este conjunto no se aplican en ningún orden específico.
Es preciso que el host exista en el grupo. En el grupo de BizTalk, debe existir un host correspondiente al especificado en los enlaces de la aplicación que contiene el archivo.msi; de lo contrario, se producirán errores en la operación de importación. Además, es necesario que el nivel de confianza del host coincida.
Es posible que sea necesario agregar una referencia a otra aplicación. Si la aplicación que se importa depende de un artefacto de otra aplicación, es posible que se deba agregar una referencia a esta aplicación. Es preciso que tanto la aplicación como el artefacto requerido existan en el grupo. El Asistente para importación proporciona esta opción. Sin embargo, si usa el comando ImportApp de BTSTask, debe agregar la referencia a la aplicación después de la importación, como se describe en Cómo agregar una referencia a otra aplicación. Para obtener información general, consulte Dependencias e implementación de aplicaciones. El Asistente para importación hace coincidir las referencias con las aplicaciones existentes en el grupo y proporciona la opción de agregar una nueva referencia o cambiar una referencia existente. Como paso adicional, debería comprobarse que la aplicación a la que se ha hecho referencia contiene el artefacto requerido.
Si se excede el tiempo de espera de una operación de importación, divida la aplicación en archivos .msi adicionales. Una operación de importación agotará el tiempo de espera si supera 3600 segundos de duración. Si está intentando importar un archivo .msi y la operación agota el tiempo de espera, debería dividir el contenido de la aplicación en más de un archivo .msi exportando de nuevo la aplicación y seleccionando un subconjunto de artefactos para exportarlos. Para obtener más información, vea Cómo exportar una aplicación de BizTalk.
Importante
Por motivos de seguridad, las contraseñas se quitan de los enlaces de aplicación durante la exportación de la aplicación. No obstante, no se quitan de ningún archivo de enlace que se haya agregado a la aplicación. Después de importar la aplicación, se deberá volver a configurar las contraseñas para que funcione la aplicación. Esto puede llevarse a cabo editando el archivo de enlace o mediante la consola de administración. Para obtener más información sobre cómo editar un archivo de enlace, vea Customizing Binding Files. Para obtener más información sobre cómo configurar la seguridad de los adaptadores, consulte Uso de adaptadores.
Nota
Si se producen errores en una importación, BizTalk Server deshace todas las operaciones de importación, excepto las acciones llevadas a cabo mediante secuencias de comandos personalizadas.
Nota
Si crea un filtro para un puerto de envío en una aplicación que utilice un esquema de propiedades en otra aplicación y si, a continuación, importa la primera aplicación en un nuevo grupo de BizTalk, no recibirá ninguna advertencia de la falta del esquema, y el filtrado no se efectuará una vez instalada e iniciada la aplicación. Puede corregir el problema importando la aplicación que contiene el esquema antes de instalar la aplicación que no contiene el esquema.
Importación de una aplicación de BizTalk mediante administración de BizTalk Server
Haga clic en Inicio, en Todos los programas, en Microsoft BizTalk Server 20xx y, a continuación, en Administración de BizTalk Server.
En el árbol de consola, expanda BizTalk Server Administración, expanda el grupo de BizTalk y realice una de las siguientes acciones:
Para importar la aplicación y los artefactos contenidos en el archivo .msi en el grupo de BizTalk, haga clic con el botón derecho en Aplicaciones, seleccione Importary, a continuación, haga clic en Archivo MSI.
Para importar los artefactos incluidos en el archivo .msi en una aplicación existente, expanda Aplicaciones, haga clic con el botón derecho en la aplicación, seleccione Importar y, a continuación, haga clic en Archivo MSI.
En la página Asistente para importar MSI, en el archivo MSI que se va a importar, escriba la ruta de acceso del archivo .msi y, a continuación, haga clic en Siguiente. Si es necesario, puede buscar el archivo .msi haciendo clic en el botón ... .
En la página Configuración de la aplicación, en la lista desplegable Nombre de la aplicación, seleccione el nombre de la aplicación, si está disponible. La lista se encuentra disponible en el caso de importar la aplicación en el grupo de BizTalk.
Nota
Esta lista incluye los nombres de todas las aplicaciones que se encuentran actualmente en el grupo de BizTalk, además de la aplicación desde la que se exporta el archivo .msi. Si se selecciona el nombre de esta última aplicación y ésta no existe en el grupo de BizTalk, el Asistente para importación creará una nueva aplicación. Si se selecciona una aplicación ya existente en el grupo, el Asistente para importación importa los artefactos del archivo .msi en la aplicación existente.
En Aplicaciones disponibles a las que agregar referencias, seleccione las aplicaciones a las que agregar referencias, si las hay, y haga clic en Siguiente.
Si va a importar el archivo .msi en una aplicación existente y desea sobrescribir artefactos en la aplicación existente, seleccione Sobrescribir recursos.
Nota
Si no selecciona esta opción y el archivo .msi contiene un artefacto ya existente en la aplicación, se producirán errores en la operación de importación y ésta se deshará. Ciertos tipos de artefactos de la aplicación o del grupo de BizTalk deben ser únicos. Si se agrega un artefacto ya existente en el grupo de BizTalk, pero no en la aplicación actual, la operación de importación no se llevará a cabo correctamente, aun si se especifica la opción de sobrescritura. Para obtener más información sobre qué artefactos deben ser únicos y de qué maneras deben ser únicos, consulte Artefactos que deben ser únicos en una aplicación o grupo.
En la página Configuración del entorno de destino de la aplicación, en la lista desplegable Entorno de ensayo de destino, seleccione el entorno de destino de esta aplicación y haga clic en Siguiente. Esta lista contiene todos los entornos especificados para cualquiera de los archivos de enlace agregados a esta aplicación. Seleccione <Predeterminado> si desea aplicar todos los enlaces de la aplicación, excepto los que tienen un entorno de destino especificado. Si el archivo .msi no contiene un archivo de enlace que desea aplicar explícitamente, puede dejar <seleccionado Predeterminado> .
Nota
El entorno de destino para los enlaces se especifica al agregar un archivo de enlace a una aplicación. Para obtener información general, consulte Enlace de archivos y implementación de aplicaciones. Para obtener instrucciones sobre cómo agregar archivos de enlace, vea Cómo agregar un archivo de enlace a una aplicación.
En la página Resumen de importación, confirme que la información de resumen es correcta y, a continuación, haga clic en Importar.
En la página Importar correcta, si desea instalar la aplicación en el equipo local, active la casilla Ejecutar el Asistente para la instalación de aplicaciones para instalar la aplicación en el equipo local .
Nota
A menos que sea necesario ejecutar la aplicación tal como está configurada actualmente en el equipo local, no será preciso efectuar su instalación. No obstante, si la aplicación incluye artefactos basados en archivos, se deberá instalar la aplicación en todos los equipos en los que se ejecutará antes de que pueda empezar a funcionar, ya que cuando se importa una aplicación, ésta solo se agrega a la base de datos de administración de BizTalk.
Haga clic en Finalizar
Nota
Si la instalación no se lleva a cabo correctamente porque, por ejemplo, no se dispone de permiso de escritura en el sistema de archivos local, se procederá a deshacer la instalación, pero no la operación de importación.
Importación de una aplicación de BizTalk 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 ImportApp /Package:value [/Environment:value] [/ApplicationName:value] [/Overwrite] [/Server:value] [/Database:value]
Ejemplo:
BTSTask ImportApp /Package:"C:\MSI Files\MyApplication.msi" /Environment:Test /ApplicationName:MyApplication /Overwrite
Parámetro Value /Paquete Ruta completa del archivo .msi. Si la ruta de acceso incluye espacios, debe incluirla entre comillas ("). /Ambiente El entorno de implementación de destino del archivo de enlace que se va a aplicar, como Prueba. Este es el valor que se especificó para el entorno de implementación de destino cuando se agregó a la aplicación el archivo de enlace. /Applicationname Nombre de la aplicación de BizTalk a la que se importan los artefactos del archivo .msi. Si no se especifica, se utiliza el nombre de aplicación especificado al exportar el archivo .msi. Si la aplicación especificada no existe, se creará. Los nombres de aplicación que incluyen espacios deben flanquearse con comillas dobles ("). /Sobrescribir Opción para sobrescribir artefactos en la aplicación con artefactos del archivo .msi que tienen el mismo identificador local único (LUID). Si no se especifica esta opción y si hay uno o más artefactos en la aplicación que tienen el mismo LUID que los artefactos del archivo .msi, se produce un error en la importación. Puede ver los LUID de los artefactos en una aplicación mediante el comando ListApp. /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
Importación de aplicaciones, enlaces y directivas de BizTalk
ImportApp (comando)