Cómo instalar la versión provisional de la solución orientada a servicios

En los pasos siguientes se describe cómo preparar el equipo antes de instalar la versión de código auxiliar de la solución orientada al servicio y, a continuación, cómo instalar la solución en el equipo.

• Prepara el ordenador para instalar la versión stub de la solución orientada a servicios

• Instalación del cliente WebSphere MQ de IBM para Windows

• Creación de los directorios virtuales en IIS para la solución orientada a servicios

• Compilación de la solución orientada a servicios

• Creación de las entradas y valores de Enterprise Single Sign-On (SSO) en la base de datos de SSO

• Implementación de la definición de BAM para la solución orientada a servicios

• Implementación de la solución orientada a servicios

Preparar el equipo para instalar la versión preliminar de la solución orientada a servicios

Para preparar el equipo para instalar la versión básica de la Solución Orientada a Servicios

1. Asegúrese de que el sitio web predeterminado está configurado para usar ASP.NET 2.X.

   1. Haga clic en Inicio, seleccione Todos los programas, Herramientas administrativas y, a continuación, haga clic en Administrador de Internet Information Services (IIS).

   2. En el Administrador de Internet Information Services (IIS), seleccione el nombre del equipo, expanda Sitios, expanda Sitio web predeterminado, expanda aspnet_client, expanda system_web.

   3. Asegúrese de que la subcarpeta es 2.X.

2. Haga clic en Inicio, seleccione Todos los programas, Herramientas administrativas y, a continuación, haga clic en Servicios. Con la consola de Servicios , asegúrese de que se ejecutan los siguientes servicios:

   • Publicación en World Wide Web

3. Haga clic en Inicio, seleccione Todos los programas, Herramientas administrativas, consola de administración de equipos y agregue la cuenta de servicio de BizTalk al grupo administradores local.

4. Si instaló Windows SharePoint Services, excluya (raíz) del sitio web predeterminado de las rutas administradas de Windows SharePoint Services como se indica a continuación: Haga clic en Inicio, seleccione Todos los programas, Herramientas administrativas y, a continuación, haga clic en Administración central de SharePoint.

   1. En Configuración del servidor virtual, seleccione Configurar la configuración del servidor virtual.

   2. En la página Lista de servidores virtuales , haga clic en Sitio web predeterminado.

   3. En la página Configuración del servidor virtual , haga clic en Definir rutas de acceso administradas.

   4. En la sección Rutas de acceso incluidas de la página Ruta de acceso administrada definida , seleccione Raíz y, a continuación, haga clic en Quitar rutas seleccionadas.

   5. En una ventana de comandos, realice un IISReset.

5. Cierre sesión en el equipo y, a continuación, inicie sesión en el equipo como cuenta de servicio de BizTalk.

6. Abra un símbolo del sistema, escriba el siguiente comando y luego presione INTRO para configurar el entorno de %BTSSolutionsPath%. A continuación, salga de la línea de comandos.

   • setx BTSSolutionsPath "\Archivos de programa (x86)\Microsoft BizTalk Server <VERSION>SDK\Scenarios"

     Nota:

     Si usa un equipo de 64 bits, use %ProgramFiles(x86)% en lugar de %ProgramFiles%.

     Nota:

     Para obtener más información sobre el comando SETX, consulte el sitio web de Microsoft TechNet en https://go.microsoft.com/fwlink/?LinkId=67831.

Instalación del cliente WebSphere MQ de IBM para Windows

Para instalar el cliente WebSphere MQ de IBM para Windows

1. Descargue la versión más reciente de IBM WebSphere MQ Client para Windows.

   Nota:

   Incluso si la versión de código auxiliar de la solución no requiere IBM WebSphere Server, la aplicación cliente hace referencia al archivo amqmdnet.dll proporcionado por el cliente webSphere MQ para Windows, por lo que debe instalarlo. El cliente de la versión simulada no llama realmente a una API en el archivo DLL. Solo es necesario para compilar y ejecutar la aplicación cliente. Puede descargar IBM WebSphere MQ Client for Windows desde el sitio web de IBM.

2. Instale el cliente web de IBM WebSphere MQ para Windows.

   Nota:

   No es necesario configurar el cliente WebSphere MQ de IBM para Windows. Mantenga toda la configuración predeterminada.

3. Agregue las clases de WebSphere MQ del ensamblado .NET al caché global de ensamblados (GAC).

   1. En el símbolo del sistema de Visual Studio, vaya al directorio <IBM MQSeries Installation Directory>\bin.

   2. Ejecute el siguiente comando (asegúrese de que gacutil.exe está en el entorno de ruta de acceso):

      gacutil.exe /i amqmdnet.dll

Creación de los directorios virtuales en IIS para la solución orientada a servicios

Para crear los directorios virtuales en IIS para la solución orientada a servicios

1. En el Administrador de Internet Information Services (IIS), haga clic con el botón derecho en Grupos de aplicaciones y seleccione Agregar grupo de aplicaciones.

   En el cuadro de diálogo Agregar grupo de aplicaciones , escriba SSOStubAppPool el cuadro de texto Nombre y, a continuación, haga clic en Aceptar.

   Los directorios virtuales que utiliza la solución orientada a servicios incluyen el servicio web publicado para la versión de prueba de las orquestaciones, el servicio web SAP de prueba, el servicio web de seguimiento de pagos de prueba y el servicio web de transacciones pendientes de prueba.

2. En el Administrador de Internet Information Services (IIS), haga clic con el botón derecho en el grupo de aplicaciones que acaba de crear y, a continuación, haga clic en Configuración avanzada.

3. Haga clic en la columna a la derecha de la propiedad Identity y, a continuación, haga clic en el botón de puntos suspensivos (...).

4. En el cuadro de diálogo Identidad del grupo de aplicaciones, seleccione la opción Cuenta personalizada y, a continuación, haga clic en Establecer.

5. En el cuadro de diálogo Establecer credenciales , especifique un nombre de usuario y una contraseña, confirme la contraseña y, a continuación, haga clic en Aceptar.

   Nota:

   Este usuario debe tener permiso para ejecutar el servicio web proxy de orquestación y debe agregarse a uno de los grupos administradores de BizTalk Server, administradores de SSO o administradores afiliados de SSO.

6. Haga clic en Aceptar para cerrar el cuadro de diálogo Identidad del grupo de aplicaciones.

7. Haga clic en Aceptar para cerrar el cuadro de diálogo Configuración avanzada .

8. En el Administrador de Internet Information Services (IIS), expanda Sitios web, haga clic con el botón derecho en el sitio web predeterminado, seleccione Nuevoy, a continuación, haga clic en Directorio virtual para ejecutar el Asistente para crear directorios virtuales.

   1. Con el Asistente para la creación de directorios virtuales, cree el siguiente directorio virtual para el servicio web proxy para la versión del adaptador:

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub

      PATH = <Directorio de instalación> de BizTalk\SDK\Scenarios\SO\BTSSoln\OrchProxy\Stub

      Permisos de acceso = Lectura, Ejecución de scripts

   2. Con el Asistente para la creación de directorios virtuales, cree el siguiente directorio virtual para el servicio web proxy para la versión del adaptador:

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\SAP

      Permisos de acceso = Lectura, Ejecución de scripts

   3. Con el Asistente para la creación de directorios virtuales, cree el siguiente directorio virtual para el servicio web proxy para la versión del adaptador:

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions

      PATH = <BizTalk Install Directory>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PendingTrans

      Permisos de acceso = Lectura, Ejecución de scripts

   4. Con el Asistente para la creación de directorios virtuales, cree el siguiente directorio virtual para el servicio web proxy para la versión del adaptador:

      Alias = Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker

      PATH = <Directorio de Instalación de BizTalk>\SDK\Scenarios\SO\BTSSoln\StubWebServices\PaymentTrack

      Permisos de acceso = Lectura, Ejecución de scripts

9. En el Administrador de Internet Information Services (IIS), expanda Sitios web, expanda sitio web predeterminado, haga clic con el botón derecho en Microsoft.Samples.BizTalk.WoodgroveBank.OrchProxy.Stub, haga clic en Propiedades y, a continuación, modifique la configuración de la siguiente manera:

   1. En la pestaña Directorio virtual , establezca el grupo de aplicaciones en SSOStubAppPool que acaba de crear.

   2. Haga clic en la pestaña Seguridad del directorio , haga clic en Editar en el cuadro Grupo de control de acceso y autenticación de acceso , seleccione Solo la autenticación integrada de Windows habilitada y, a continuación, desactive otras casillas de acceso de autenticación . Haga clic en Aceptar para salir.

10. En el Administrador de Internet Information Services (IIS), expanda Sitios web, expanda sitio web predeterminado, haga clic con el botón derecho en Microsoft.Samples.BizTalk.WoodgroveBank.StubSAP, haga clic en Propiedades y, a continuación, modifique la configuración de la siguiente manera:

    1. En la pestaña Directorio virtual , establezca el grupo de aplicaciones en SSOStubAppPool que acaba de crear.

    2. Haga clic en la pestaña Seguridad del directorio , haga clic en Editar en el cuadro Grupo de control de acceso y autenticación y, a continuación, seleccione Habilitar acceso anónimo. Haga clic en Aceptar para salir.

11. En el Administrador de Internet Information Services (IIS), expanda Sitios web, expanda Sitio web predeterminado, haga clic con el botón derecho en Microsoft.Samples.BizTalk.WoodgroveBank.StubPendingTransactions, haga clic en Propiedades y, a continuación, modifique la configuración como se indica a continuación:

    1. En la pestaña Directorio virtual , establezca el grupo de aplicaciones en SSOStubAppPool que acaba de crear.

    2. Haga clic en la pestaña Seguridad del directorio , haga clic en Editar en el cuadro Grupo de control de acceso y autenticación y, a continuación, seleccione Habilitar acceso anónimo. Haga clic en Aceptar para salir.

12. En el Administrador de Internet Information Services (IIS), expanda Sitios Web, expanda el Sitio Web Predeterminado, haga clic con el botón derecho en Microsoft.Samples.BizTalk.WoodgroveBank.StubPaymentTracker, haga clic en Propiedades y, a continuación, modifique la configuración de la siguiente manera:

    1. En la pestaña Directorio virtual , establezca el grupo de aplicaciones en SSOStubAppPool que acaba de crear.

    2. Haga clic en la pestaña Seguridad del directorio , haga clic en Editar en el cuadro Grupo de control de acceso y autenticación y, a continuación, seleccione Habilitar acceso anónimo. Haga clic en Aceptar para salir.

Compilación de la solución orientada a servicios

Para compilar la solución orientada a servicios

1. Inicie el Visual Studio Command Prompt.

   Nota:

   En los archivos %BTSInstallPath%\Scenarios\SO\BTSSoln\OrchProxy\Inline\app_code\customerserviceport.asmx.cs y %BTSInstallPath%\Scenarios\SO\BTSSoln\OrchProxy\Stub\app_code\customerserviceport.asmx.cs, reemplace todas las instancias de 17f20caea2afcc8c por a1054514fc67bded.

2. En el símbolo del sistema de Visual Studio, cambie el directorio a la carpeta \SO\BTSSoln de %BTSSolutionsPath%y, a continuación, ejecute el siguiente comando para compilar la versión de código auxiliar de la solución orientada a servicios.

   • SetupBTSSoln.bat

   Nota:

   En los archivos que se enumeran a continuación, reemplace todas las instancias de 17f20caea2afcc8c por el token de clave pública actual.

   • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\Aggregate_To_CustomerServiceResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\Aggregate_To_ErrorResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_CreditLimitResponse.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_CustomerServiceResponseDenied.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_LastPaymentResponseTimeout.btm.cs
     • %BTSInstallPath%\Scenarios\SO\BTSSoln\Maps\CustomerServiceRequest_To_PendingTransactionResponse.btm.cs

Crea las entradas y valores de Enterprise Single Sign-On (SSO) en la base de datos de SSO

Para crear las entradas y valores de Enterprise Single Sign-On (SSO) en la base de datos de SSO

1. Abra una línea de comandos, cambie el directorio actual a la %BTSSolutionsPath%\SO\BTSSoln\Scripts y, a continuación, ejecute el siguiente comando para establecer la variable de entorno PATH para la carpeta Enterprise Single Sign-On.

   • Set PATH=%PATH%;%ProgramFiles%\"Common Files\Enterprise Single Sign-On"

2. En el símbolo del sistema, cambie el directorio a la %BTSSolutionsPath%\SO\BTSSoln\Scripts folder, open ConfigStoreApp.xml y luego revise el contenido del archivo con el Bloc de notas.

   Nota:

   Este archivo define la aplicación de almacén de configuración en SSO que el escenario usa para almacenar parámetros de configuración. Algunos de los parámetros de configuración incluyen el valor timeout usado para comunicarse con SAP (para las tres versiones). No es necesario realizar ningún cambio en este archivo.

3. En la línea de comandos, ejecute el siguiente comando para crear la aplicación del almacén de configuración de SSO.

   • ssomanage -createapps ConfigStoreApp.xml

4. En el símbolo del sistema de comandos, abra SetConfigValuesInSSO.cmd con el Bloc de notas y luego revise el contenido del archivo.

   Nota:

   Este archivo de comandos establece los valores de los parámetros de configuración en la base de datos de SSO. Contiene varias instrucciones set que establecen los valores en variables locales al principio del archivo de comandos. Los valores SAPAdapterTimeout, PendingTransactionsAdapterTimeout y PaymentTrackingAdapterTimeout se utilizan en el stub y la versión del adaptador. Los valores restantes se usan en la versión en línea. No es necesario realizar ningún cambio en este archivo para la versión preliminar.

5. En el símbolo del sistema, escriba SetConfigValuesInSSO.cmd y presione la tecla ENTRAR para almacenar los valores en la aplicación de almacén de configuración de SSO.

6. En el indicador de comandos, ejecute el siguiente comando para habilitar los tickets de autenticación en SSO.

   • ssomanage -tickets yes yes

Implementación de la definición de BAM para la solución orientada a servicios

Para implementar la definición de BAM para la solución orientada a servicios

1. En un símbolo del sistema, escriba el comando siguiente y presione ENTRAR. Esto establece la ruta de acceso para buscar la utilidad BAM:

   • SET PATH=%PATH%;%programfiles%\Microsoft BizTalk Server\Tracking

2. En el símbolo del sistema, cambie el directorio a la carpeta %BTSSolutionsPath%\SO\BTSSoln\BAM y escriba el siguiente comando y presione ENTRAR:

   • bm deploy-all -DefinitionFile:ServiceLevelTracking.xml

     Nota:

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

Implementación de la solución orientada a servicios

Para implementar la solución orientada a servicios

1. Abra un símbolo del sistema y cambie el directorio a la carpeta %BTSSolutionsPath%\SO\BTSSoln\Scripts.

2. Modifique el archivo DeployStubBinding.cmd reemplazando todas las instancias de "debug" y "development" por "release".

3. Abra una línea de comandos y cambie el directorio a la carpeta %BTSSolutionsPath%\SO\BTSSoln\Scripts. Escribe el siguiente comando y presiona ENTRAR:

   • DeployStubBinding.cmd

4. En el símbolo del sistema, ejecute el siguiente comando para iniciar las orquestaciones de la versión de código auxiliar.

   • Startstub.vbs

Pasos siguientes

Pruebe cómo funciona la versión de código auxiliar de la solución orientada a servicios en Ejecución de la solución orientada a servicios.

Véase también

Antes de instalar la solución orientada a serviciosCómo instalar las versiones en línea y de adaptador de la solución orientada a serviciosConfiguración de la máquina del desarrollador para la solución orientada a servicios