Contenido
• Introducción
• Configuración de Puertos
• Registro de Windows
• Contadores de Performance
• Conclusión
Introducción
En este nuevo artículo se mencionarán algunos aspectos importantes que deben ser tenidos en cuenta en la ejecución de los adaptadores de Commerce Server 2007 (CS2007) para Biz Talk Server 2006 (BTS2006) como lo son la configuración de puertos de envío y/o recepción, la relación de estos adaptadores con el Registro de Windows y algunos contadores de desempeño usados para evaluar el rendimiento de estos adaptadores en nuestras soluciones.
Configuración de Puertos
Cada adaptador de CS2007 maneja sus propios parámetros de configuración para crear o modificar nuevos puertos de envío y/o recepción. Algunos de estos parámetros de configuración son requeridos y otros no, eso depende del tipo de adaptador que se utilice.
Un ‘*’ delante del nombre de la propiedad indica que es requerida en la configuración del puerto. Por esto cada adaptador basa su configuración en un assembly diferente que define las propiedades de envío y recepción, estos assemblies se encuentran en la carpeta %CS_Install%\BizTalk Adapters, y son:
• Microsoft.CommerceServer.Adapter.Catalog.AdapterManagement.dll
• Microsoft.CommerceServer.Adapter.Inventory.AdapterManagement.dll
• Microsoft.CommerceServer.Adapter.Orders.AdapterManagement.dll
• Microsoft.CommerceServer.Adapter.Profiles.AdapterManagement.dll
Muchos de estos parámetros son únicos por tipo de adaptador, sin embargo algunos son comunes a todos los adaptador (su valor no es compartido por instancias).
Registry Subkey: define la clave dentro del Registro de Windows que almacenará la información de dicha instancia.
Connection Information: define información acerca de la conexión al Web Service de CS2007 como la URL, usuario, clave, entre otros.
Site Name: define el nombre del sitio de CS2007.
Namespace: define el namespace asignado al mensaje XML. Este valor debe coincidir con el utilizado en la definición del Schema. En caso contrario, el proceso en BTS2006 siempre estará en estado Suspended por qué no se encontrara suscripción al mensaje de entrada.
Se puede encontrar mas información acerca de los parámetros que deben ser configurados por adaptador en el artículo Working with the BizTalk Adapters, disponible en http://msdn.microsoft.com/library/default.asp?url=/library/en-us/CS07Default/html/932de393-dafa-42c7-8940-c963b0f461a3.asp (inglés).
Registro de Windows
Los adaptadores almacenan información por cada instancia configurada en cada puerto (envío y/o recepción) en el Registro de Windows (Windows Registry) que puede ser utilizada en el seguimiento a las ejecuciones de estas instancias y/o para extraer datos acerca de su última ejecución.
Los valores son almacenados en el Registro de Windows por los adaptadores de CS2007 en forma organizada en la clave:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Commerce Server 2007 BizTalk Adapters\adapter_type\subkey\
Donde adapter_type representa el tipo de adaptador: Catalog, Inventory, Orders o Profiles, y subkey el nombre configurado en la propiedad Registry Subkey de cada instancia.
Cada adaptador almacena los valores que se relacionan a continuación:
Nombre valor
Descripción
DateTime Of Last Run
Almacena la fecha de la última ejecución del adaptador configurado al puerto de recepción o de envío.
DateTime Of Next Run
Almacena la próxima fecha en la cual se ejecutará el adaptador configurado a un puerto de recepción.
Trace Guid
Almacena un GUID que identifica cada instancia configurada del adaptador, con el fin de hacer seguimientos.
El adaptador Orders almacena dos valores como valor agregado a su ejecución DateTime Of Query Window y Last OrderGroupId In Query.
En adición, los adaptadores de CS2007 también utilizan el Registro de Windows para determinar si se validan los parámetros de configuración especificados en la consola administrativa de BTS2006. Esta validación se basa en un DWORD configurado con el nombre ConfigValidation y con valor 1 en la clave:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Commerce Server 2007 BizTalk Adapters
Por defecto este DWORD no existe y se asume como 0, por lo tanto los parámetros no son validados. Es importante tener en cuenta que la creación de este valor disminuirá la rapidez en la creación/configuración de cada uno de los puertos.
Seguridad
En BTS2006, cada instancia de un adaptador configurado en un puerto debe estar relacionada con una instancia de host (Host Instance), y esta a su vez se ejecuta con una cuenta de usuario. Es importante validar que el(los) usuario(s) que esta(n) ejecutando la(s) instancia(s) de cada adaptador tengan permisos de lectura y escritura sobre la clave del Registro de Windows:
Catalog Adapter HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Commerce Server 2007 BizTalk Adapters
En caso que este usuario no tenga los permisos, constantes errores serán mostrados en el visor de eventos (EventLog) en cada ejecución del adaptador dado que no podrá actualizar los valores anteriormente descritos. Aunque este error no impide la comunicación entre BTS2006 y CS2007 y el envío y/o recepción de la información, si impide la actualización y/o creación de los valores en el Registro de Windows.
Se puede encontrar información acerca de cómo asignar permisos en Registro de Windows en Cómo usar las características del Editor del Registro de Windows XP y Windows Server 2003, disponible en http://support.microsoft.com/kb/310426
Contadores de Performance
Los adaptadores de CS2007 proveen varios contadores que pueden ser utilizados para medir el rendimiento en la ejecución de cada una de las instancias configuradas. Estos contadores pueden medir consumo de memoria, procesos exitosos, procesos fallidos, importaciones, exportaciones y muchos otros elementos.
Todos los adaptadores manejan contadores que corresponden a exportaciones fallidas, mensajes fallidos, exportaciones exitosas, importaciones fallidas, consultas fallidas, mensajes reenviados, mensajes enviados, mensajes suspendidos, importaciones reenviadas, importaciones exitosas, consultas exitosas, importaciones suspendidas y consultas suspendidas. Sin embargo, los adaptadores de Orders y Profiles manejan contadores adicionales relacionados a:
• Orders Adapter: ordenes procesadas, mensajes exitosos, respuestas del Basket fallidas, falla al salvar Purchase Orders, actualización fallida de Purchase Orders, mensajes reenviados al Basket, mensajes reenviados de Purchase Orders, mensajes suspendidos al Basket, suspendidas actualizaciones al Order Purchase y mensajes de almacenamiento suspendido al Order Purchase.
• Profiles Adapter: perfiles procesados, fallidos mensajes de eliminación, actualizaciones fallidas, eliminaciones exitosas, actualizaciones exitosas, eliminaciones suspendidas y actualizaciones suspendidas.
• En resumen, los adaptadores de Catalog e Inventory manejan 41 contadores y los adaptadores de Orders y Profiles 62. Estos contadores se encuentran definidos en cuatro objetos: Commerce: Adapters: adapter_type, y pueden ser medidos por instancia o en conjunto.
Conclusiones
Los adaptadores de CS2007 para BTS2006 ofrecen características que hacen más fácil, y a su vez extensa, la configuración de los puertos en BTS para intercambiar información. Igualmente, por medio del Registro de Windows y los contadores de Performance dejan ver como ha sido el promedio de uso, memoria consumida y otros detalles que pueden servir en el momento de evaluar su ejecución.
• Introducción
• Configuración de Puertos
• Registro de Windows
• Contadores de Performance
• Conclusión
Introducción
En este nuevo artículo se mencionarán algunos aspectos importantes que deben ser tenidos en cuenta en la ejecución de los adaptadores de Commerce Server 2007 (CS2007) para Biz Talk Server 2006 (BTS2006) como lo son la configuración de puertos de envío y/o recepción, la relación de estos adaptadores con el Registro de Windows y algunos contadores de desempeño usados para evaluar el rendimiento de estos adaptadores en nuestras soluciones.
Configuración de Puertos
Cada adaptador de CS2007 maneja sus propios parámetros de configuración para crear o modificar nuevos puertos de envío y/o recepción. Algunos de estos parámetros de configuración son requeridos y otros no, eso depende del tipo de adaptador que se utilice.
Un ‘*’ delante del nombre de la propiedad indica que es requerida en la configuración del puerto. Por esto cada adaptador basa su configuración en un assembly diferente que define las propiedades de envío y recepción, estos assemblies se encuentran en la carpeta %CS_Install%\BizTalk Adapters, y son:
• Microsoft.CommerceServer.Adapter.Catalog.AdapterManagement.dll
• Microsoft.CommerceServer.Adapter.Inventory.AdapterManagement.dll
• Microsoft.CommerceServer.Adapter.Orders.AdapterManagement.dll
• Microsoft.CommerceServer.Adapter.Profiles.AdapterManagement.dll
Muchos de estos parámetros son únicos por tipo de adaptador, sin embargo algunos son comunes a todos los adaptador (su valor no es compartido por instancias).
Registry Subkey: define la clave dentro del Registro de Windows que almacenará la información de dicha instancia.
Connection Information: define información acerca de la conexión al Web Service de CS2007 como la URL, usuario, clave, entre otros.
Site Name: define el nombre del sitio de CS2007.
Namespace: define el namespace asignado al mensaje XML. Este valor debe coincidir con el utilizado en la definición del Schema. En caso contrario, el proceso en BTS2006 siempre estará en estado Suspended por qué no se encontrara suscripción al mensaje de entrada.
Se puede encontrar mas información acerca de los parámetros que deben ser configurados por adaptador en el artículo Working with the BizTalk Adapters, disponible en http://msdn.microsoft.com/library/default.asp?url=/library/en-us/CS07Default/html/932de393-dafa-42c7-8940-c963b0f461a3.asp (inglés).
Registro de Windows
Los adaptadores almacenan información por cada instancia configurada en cada puerto (envío y/o recepción) en el Registro de Windows (Windows Registry) que puede ser utilizada en el seguimiento a las ejecuciones de estas instancias y/o para extraer datos acerca de su última ejecución.
Los valores son almacenados en el Registro de Windows por los adaptadores de CS2007 en forma organizada en la clave:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Commerce Server 2007 BizTalk Adapters\adapter_type\subkey\
Donde adapter_type representa el tipo de adaptador: Catalog, Inventory, Orders o Profiles, y subkey el nombre configurado en la propiedad Registry Subkey de cada instancia.
Cada adaptador almacena los valores que se relacionan a continuación:
Nombre valor
Descripción
DateTime Of Last Run
Almacena la fecha de la última ejecución del adaptador configurado al puerto de recepción o de envío.
DateTime Of Next Run
Almacena la próxima fecha en la cual se ejecutará el adaptador configurado a un puerto de recepción.
Trace Guid
Almacena un GUID que identifica cada instancia configurada del adaptador, con el fin de hacer seguimientos.
El adaptador Orders almacena dos valores como valor agregado a su ejecución DateTime Of Query Window y Last OrderGroupId In Query.
En adición, los adaptadores de CS2007 también utilizan el Registro de Windows para determinar si se validan los parámetros de configuración especificados en la consola administrativa de BTS2006. Esta validación se basa en un DWORD configurado con el nombre ConfigValidation y con valor 1 en la clave:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Commerce Server 2007 BizTalk Adapters
Por defecto este DWORD no existe y se asume como 0, por lo tanto los parámetros no son validados. Es importante tener en cuenta que la creación de este valor disminuirá la rapidez en la creación/configuración de cada uno de los puertos.
Seguridad
En BTS2006, cada instancia de un adaptador configurado en un puerto debe estar relacionada con una instancia de host (Host Instance), y esta a su vez se ejecuta con una cuenta de usuario. Es importante validar que el(los) usuario(s) que esta(n) ejecutando la(s) instancia(s) de cada adaptador tengan permisos de lectura y escritura sobre la clave del Registro de Windows:
Catalog Adapter HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Commerce Server 2007 BizTalk Adapters
En caso que este usuario no tenga los permisos, constantes errores serán mostrados en el visor de eventos (EventLog) en cada ejecución del adaptador dado que no podrá actualizar los valores anteriormente descritos. Aunque este error no impide la comunicación entre BTS2006 y CS2007 y el envío y/o recepción de la información, si impide la actualización y/o creación de los valores en el Registro de Windows.
Se puede encontrar información acerca de cómo asignar permisos en Registro de Windows en Cómo usar las características del Editor del Registro de Windows XP y Windows Server 2003, disponible en http://support.microsoft.com/kb/310426
Contadores de Performance
Los adaptadores de CS2007 proveen varios contadores que pueden ser utilizados para medir el rendimiento en la ejecución de cada una de las instancias configuradas. Estos contadores pueden medir consumo de memoria, procesos exitosos, procesos fallidos, importaciones, exportaciones y muchos otros elementos.
Todos los adaptadores manejan contadores que corresponden a exportaciones fallidas, mensajes fallidos, exportaciones exitosas, importaciones fallidas, consultas fallidas, mensajes reenviados, mensajes enviados, mensajes suspendidos, importaciones reenviadas, importaciones exitosas, consultas exitosas, importaciones suspendidas y consultas suspendidas. Sin embargo, los adaptadores de Orders y Profiles manejan contadores adicionales relacionados a:
• Orders Adapter: ordenes procesadas, mensajes exitosos, respuestas del Basket fallidas, falla al salvar Purchase Orders, actualización fallida de Purchase Orders, mensajes reenviados al Basket, mensajes reenviados de Purchase Orders, mensajes suspendidos al Basket, suspendidas actualizaciones al Order Purchase y mensajes de almacenamiento suspendido al Order Purchase.
• Profiles Adapter: perfiles procesados, fallidos mensajes de eliminación, actualizaciones fallidas, eliminaciones exitosas, actualizaciones exitosas, eliminaciones suspendidas y actualizaciones suspendidas.
• En resumen, los adaptadores de Catalog e Inventory manejan 41 contadores y los adaptadores de Orders y Profiles 62. Estos contadores se encuentran definidos en cuatro objetos: Commerce: Adapters: adapter_type, y pueden ser medidos por instancia o en conjunto.
Conclusiones
Los adaptadores de CS2007 para BTS2006 ofrecen características que hacen más fácil, y a su vez extensa, la configuración de los puertos en BTS para intercambiar información. Igualmente, por medio del Registro de Windows y los contadores de Performance dejan ver como ha sido el promedio de uso, memoria consumida y otros detalles que pueden servir en el momento de evaluar su ejecución.
Enjoy reading!
Good Luck
Dino
No hay comentarios.:
Publicar un comentario