Cómo instalar la versión de código auxiliar de esta solución orientada a servicios

Los pasos siguientes describen cómo preparar el equipo para instalar la versión de código auxiliar de la solución orientada a servicios y cómo instalar ésta en el equipo.

• Preparar el equipo para instalar la versión de código auxiliar de la solución orientada a servicios

• Instale el cliente IBM WebSphere MQ para Windows

• En IIS, cree los directorios virtuales para la solución orientada a servicios

• Generar la solución orientada a servicios

• Crear las entradas y valores del inicio de sesión único (SSO) empresarial en la base de datos de SSO

• Implementar la definición de SAE para la solución orientada a servicios

• Implementar la solución orientada a servicios

Preparar el equipo para instalar la versión de código auxiliar de la solución orientada a servicios

Para preparar el equipo para instalar la versión de código auxiliar 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. Haz clic en Inicio, apunta a Todos los programas, Herramientas administrativas y haz clic en Administrador de Internet Information Services (IIS).

   2. En el Administrador de Internet Information Services (IIS), 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 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, seleccione Herramientas administrativas, haga clic en la consola Administración de equipos y, a continuación, agregue la cuenta de servicio de BizTalk al grupo de administradores locales.

4. Si instaló Windows SharePoint Services, excluya (raíz) del sitio web predeterminado de Windows SharePoint Services rutas administradas de la siguiente manera: 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 el símbolo del sistema, ejecute IISReset.

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

6. Abra un símbolo del sistema, escriba el comando siguiente y, a continuación, presione ENTRAR para establecer el entorno %BTSSolutionsPath%. A continuación, cierre el símbolo del sistema.

   • setx BTSSolutionsPath "\Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\Scenarios"

     Nota

     Si está utilizando un equipo de 64 bits, escriba %ProgramFiles(x86)% en lugar de %ProgramFiles%.

     Nota

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

Instale el cliente IBM WebSphere MQ para Windows

Para instalar el cliente IBM WebSphere MQ para Windows

1. Descargue la última versión del cliente IBM WebSphere MQ para Windows.

   Nota

   Aunque la versión de código auxiliar de la solución no requiere IBM WebSphere Server, la aplicación cliente utiliza como referencia el archivo amqmdnet.dll incluido en el cliente IBM WebSphere MQ para Windows y, por tanto, es necesario instalarlo. En realidad, el cliente de la versión de código auxiliar no realiza llamadas a API del archivo DLL. Sólo es necesario para compilar y ejecutar la aplicación cliente. Puede descargar el cliente IBM WebSphere MQ para Windows desde el sitio Web de IBM.

2. Instale el cliente IBM WebSphere MQ para Windows.

   Nota

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

3. Agregue las clases WebSphere MQ para el ensamblado .NET a la caché de ensamblados global (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 se encuentra en el entorno de la ruta):

      gacutil.exe /i amqmdnet.dll

En IIS, cree los directorios virtuales para la solución orientada a servicios

Para crear en IIS los directorios virtuales 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 incluye el servicio Web publicado para la versión de código auxiliar de las orquestaciones, el servicio Web SAP de código auxiliar, el servicio Web de seguimiento de pago de código auxiliar y el servicio Web de de código auxiliar de transacciones pendientes.

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 de proxy de orquestación y debe agregarse a uno de los grupos de administradores de BizTalk Server, administradores de SSO o administradores de aplicaciones afiliadas 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 = <Directorio de instalación> de BizTalk\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 = <Directorio de instalación> de BizTalk\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 de directorios , haga clic en Editar en el cuadro Grupo de control de acceso y autenticación de autenticación , seleccione Solo 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 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.

12. 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.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.

Generar la solución orientada a servicios

Para compilar la solución orientada a servicios

1. Inicie el símbolo del sistema de Visual Studio.

   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 por la carpeta %RutaSolucionesBTS%\SO\BTSSoln y, a continuación, ejecute el siguiente comando para generar la versión de código auxiliar de la solución orientada a servicios.

   • SetupBTSSoln.bat

   Nota

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

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

Crear las entradas y valores del inicio de sesión único (SSO) empresarial en la base de datos de SSO

Para crear las entradas y valores del inicio de sesión único (SSO) empresarial en la base de datos de SSO

1. Abra un símbolo del sistema, cambie el directorio actual a la carpeta %BTSSolutionsPath%\SO\BTSSoln\Scripts y, a continuación, ejecute el siguiente comando para generar el entorno PATH en la carpeta de inicio de sesión único (SSO) empresarial.

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

2. En el símbolo del sistema, cambie el directorio a la carpeta %BTSSolutionsPath%\SO\BTSSoln\Scripts, abra el archivo ConfigStoreApp.xml en Notepad y, a continuación, revise el contenido del archivo.

   Nota

   Este archivo define la aplicación de almacenamiento de configuración de SSO que el escenario emplea para almacenar parámetros de configuración. Algunos de los parámetros de configuración incluyen el valor de tiempo de espera usado para comunicarse con SAP (para las tres versiones). No es necesario realizar cambios en este archivo.

3. En el símbolo del sistema, ejecute el comando siguiente para crear la aplicación de almacenamiento de configuración de SSO.

   • ssomanage -createapps ConfigStoreApp.xml

4. En el símbolo del sistema, abra el archivo SetConfigValuesInSSO.cmd con Notepad y revise su contenido.

   Nota

   Este archivo de comandos establece los valores de los parámetros de configuración de la base de datos de SSO. Contiene varias instrucciones SET que establecen los valores de las variables locales al principio del archivo de comandos. Los valores SAPAdapterTimeout, PendingTransactionsAdapterTimeout y PaymentTrackingAdapterTimeout se usan en la versión de adaptador y código auxiliar. Los valores restantes se utilizan en la versión en línea. No es necesario realizar cambios en este archivo para la versión de código auxiliar.

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

6. En el símbolo del sistema, ejecute el siguiente comando para habilitar los vales en SSO:

   • ssomanage -tickets yes yes

Implementar la definición de SAE para la solución orientada a servicios

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

1. En una ventana de símbolo del sistema, escriba el comando siguiente y presione ENTRAR. De este modo, se configurará la ruta para buscar la utilidad de SAE:

   • 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 el Control de cuentas de usuario (UAC), es posible que deba ejecutar la herramienta con privilegios administrativos.

Implementar la solución orientada a servicios

Para implementar la solución orientada a servicios

1. Abra un símbolo del sistema y, a continuación, cambie el directorio a la carpeta %RutaSolucionesBTS%\SO\BTSSoln\Scripts.

2. Modifique el archivo DeployStubBinding.cmd reemplazando todas las instancias de "depuración" y "desarrollo" por "release".

3. Abra un símbolo del sistema y, a continuación, cambie el directorio a la carpeta %RutaSolucionesBTS%\SO\BTSSoln\Scripts. Escriba el siguiente comando y presione ENTRAR:

   • DeployStubBinding.cmd

4. En el símbolo del sistema, ejecute el comando siguiente 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.

Consulte también

Antes de instalar la solución orientadaa servicios Cómo instalar las versiones insertadas y de adaptadores de la configuración del equipo del desarrollador de soluciones orientadas a servicios para la solución orientada a servicios