Registro de aplicaciones como proveedores TRS para Lifecycle Query Engine

Si está utilizando Rational Engineering Lifecycle Manager, es necesario seguir pasos de configuración para configurar los productos como proveedores TRS y dar el Lifecycle Query Engine acceso a sus datos.

Después de crear y configurar todas las aplicaciones y después de crear las relaciones de amistad entre las aplicaciones en los servidores remotos, establezca cada aplicación como un proveedor de Conjunto de recursos rastreados (TRS) para que Lifecycle Query Engine pueda acceder a sus datos para crear el índice.

Requisitos previos:
Importante: Si su aplicación se encuentra en un Jazz Team Server distinto a LQE, las claves generadas en esta tarea se reutilizan más tarde al añadir los orígenes de datos a Lifecycle Query Engine como se describe en: Generación del índice LQE. Anote con cuidado el nombre y cada clave secreta.

Asigne la licencia interna de consumidor TRS

Asigne la licencia interna de consumidor TRS a los usuarios funcionales lqe_user y jts_user.

  1. Abra la consola administrativa de JTS en https://host_name:port/jts/admin
  2. Seleccione Usuarios > Usuarios activos.
  3. Pulse el enlace lqe_user. En la página lqe_user, vaya al área Licencia de acceso de cliente, seleccione Interna de consumidor TRS y pulse Guardar.
    Selección de la licencia interna de consumidor TRS para el usuario de LQE principal
  4. Vuelva a la página Usuarios activos. Pulse el enlace jts_user. En la página jts_user, vaya al área Licencia de acceso de cliente y seleccione Interna de consumidor TRS.
  5. Pulse Guardar.

Configuración de TRS para las aplicaciones CLM

Si estas aplicaciones se despliegan en el mismo Jazz Team Server como LQE, no es necesario crear consumidores de entrada. Siga estos pasos solo si las aplicaciones CCM, QM y RM están en un Jazz Team Server separado.

  1. Cree la clave de consumidor de entrada LQE para CCM. Abra la página de administración de CCM: https://host_name:port/ccm/admin
  2. En la página Aplicación, seleccione Comunicación >Consumidores (Entrada) y cree un nueva nueva clave de consumidor de OAuth para LQE:
    • Nombre: LQE
    • Secreto: xyz
    • De confianza:
    Pulse Registrar.
  3. Vaya a la lista Claves autorizadas y edite la entrada LQE pulsando el icono de lápiz.
  4. En el diálogo Editar propiedades de clave de consumidor, pulse el enlace Seleccionar usuario...
  5. Especifique lqe en el campo de filtro y seleccione lqe_user en la lista de usuarios coincidentes. Pulse Añadir y cerrar y, a continuación, Finalizar.
  6. Cree la clave de consumidor de entrada LQE para QM. Abra la página de administración: https://host_name:port/qm/admin, y siga los pasos del 7 al 10 de nuevo.
  7. Cree la clave de consumidor de entrada de LQE para DOORS Next Generation si esta es su aplicación RM. Abra la página de administración de RM: https://host_name:port/rm/admin y siga los pasos del 7 al 10 de nuevo.
  8. Registre las aplicaciones como proveedores TRS y genere su índice. Abra la página de administración de Lifecycle Query Engine: https://host_name:port/lqe/web.
  9. Pulse Administración > Orígenes de datos > Añadir origen de datos.
  10. En el diálogo , seleccione https://host_name:port/ccm/oslc/workitem/trs y añada la etiqueta RTC. Acepte el resto de los valores predeterminados (si tiene una muchos datos que indexar, aumente el número de hebras para la indexación inicial a 4) y pulse Finalizar.
  11. Registre QM como un proveedor TRS y genere su índice. En la página Orígenes de datos, pulse Añadir origen de datos.
  12. En el diálogo , seleccione https://host_name:port/qm/trs y añada la etiqueta RQM. Acepte los valores predeterminados restantes y pulse Finalizar.
  13. Registre RM como un proveedor TRS y genere su índice. En la página Orígenes de datos, pulse Añadir origen de datos.
  14. En el diálogo , seleccione https://host_name:port/rm/trs y añada la etiqueta DNG. Acepte los valores predeterminados restantes y pulse Finalizar.

Sus aplicaciones Rational Team Concert, Rational Quality Manager y Rational DOORS Next Generation ya están indexadas y disponibles para Rational Engineering Lifecycle Manager. Para obtener más información sobre las preferencias de la indexación en curso, consulte: Indexación de los datos con Lifecycle Query Engine

Configuración de DOORS y DOORS Web Access como proveedores TRS

Rational DOORS Web Access se suministra con varios usuarios predeterminados y contraseñas para la habilitación de TRS. Debe editar los parámetros de configuración asociados con estos usuarios, tal como se describe en el procedimiento siguiente. La integración utiliza los siguientes usuarios:
  • Usuario funcional de LQE. Este usuario maneja las solicitudes de LQE desde una aplicación de consumidor de TRS integrada para Rational DOORS Web Access. Este usuario debe existir en la base de datos de Rational DOORS. Debe especificar parámetros para este usuario en el archivo festival.xml.
  • trs.db.user. Es un usuario de base de datos de Derby que tiene acceso a los datos de la base de datos de TRS. Rational DOORS Web Access lo utiliza para recuperar datos de la base de datos.
  • derby.user.admin. Es un administrador de base de datos de Derby. Actualmente, este usuario no proporciona funciones para Rational DOORS Web Access ni para la base de datos de Derby. Puede establecer una contraseña para este usuario en el archivo de propiedades de Derby.
  1. Abra [DWA_path]\server\festival\config\festival.xml.
    1. Busque la sección Configurable system properties.
    2. Añada las propiedades que se listan en la tabla siguiente.
      Formateado de propiedades:
      <f:property name="property_listed_in_table" value="appropriate_value_or_default_listed_in_table" />
    Tabla 1. Propiedades del archivo Festival.xml para TRS y LQE
    Propiedad Descripción/Valor
    functional.user.consumer.key La clave de consumidor que está asociada con el usuario funcional de LQE. Lo utiliza el Motor de consultas de ciclo de vida (LQE) para acceder al Conjunto de recursos rastreados de (TRS) de DOORS. Esta clave debe estar en el separador Claves locales de la configuración de Rational DOORS.
    functional.user.consumer.secret El secreto de consumidor que está asociado con el usuario funcional de LQE. Lo utiliza el Motor de consultas de ciclo de vida (LQE) para acceder al Conjunto de recursos rastreados de (TRS) de DOORS. Este secreto debe estar en el separador Claves locales de la configuración de Rational DOORS.
    functional.user.name El nombre de usuario del usuario funcional de LQE. Este nombre de usuario debe ser un usuario de Rational DOORS válido. Asegúrese de que el ID de usuario de DOORS que utiliza en el archivo festival.xml existe y tiene acceso completo a los proyectos y artefactos que expone en el conjunto de trabajo.
    functional.user.password La contraseña del usuario funcional de LQE.
    trs.db.user Nombre de usuario para la habilitación de TRS. Para simplificar, utilice el nombre de usuario predeterminado trs.db.user. Si no se especifica esta propiedad, el sistema utiliza los valores predeterminados.
    trs.db.password La contraseña de trs.db.user. También debe especificar esta contraseña en el archivo de propiedades de Derby. El valor predeterminado es dwaTrsPa11word. Si no se especifica esta propiedad, el sistema utiliza los valores predeterminados.
    trs.page.size El número de recursos de TRS que se deben incluir en una página. El valor predeterminado es 250. Si no se especifica esta propiedad, el sistema utiliza los valores predeterminados.
    trs.enable Establezca este valor en true.
    El siguiente fragmento del archivo festival.xml muestra un ejemplo de las propiedades que están relacionadas con TRS:
    <f:property name="functional.user.consumer.key" value="xyz"/> 
    <f:property name="functional.user.consumer.secret" value="xyz" />
    <f:property name="functional.user.name" value="Administrator" /> 
    <f:property name="functional.user.password" value="qwert6" /> 
    <f:property name="trs.enable" value="true" />
  2. Opcional: Abra el archivo derby.properties en un editor. Este archivo está en el directorio instalación_dwa/derby.
  3. Opcional: Sustituya los valores de contraseña de los parámetros en la tabla siguiente.
    Tabla 2. Parámetros del archivo de propiedades de Derby para TRS
    Parámetro Descripción
    derby.user.trs La contraseña para trs.db.user que ha especificado en el archivo festival.xml. El valor predeterminado es dwaTrsPa11word.
    derby.user.admin La contraseña del administrador de la base de datos de Derby. Actualmente, este usuario no proporciona funciones para Rational DOORS Web Access ni para la base de datos de Derby. El valor predeterminado es dwaTrsPa11word.
  4. Inicializar la base de datos de TRS. Ejecute los scripts siguientes:
    • Para Windows.:
      instalación_dwa/derby.start.bat
      instalación_dwa/derby/scripts/init_trs.bat
    • Para Linux.:
      instalación_dwa/derby.start.sh
      instalación_dwa/derby/scripts/init_trs.sh
  5. Inicie la sesión en el cliente de Rational DOORS como un usuario de tipo Database Manager o un Administrador.
  6. Seleccione Archivo > OSLC > Claves locales. En la ventana Claves locales, pulse Añadir. Utilice los valores especificados en el archivo festival.xml.
    • Nombre de consumidor: cualquier nombre. Se recomienda LQE.
    • Clave de consumidor: el valor establecido para la propiedad functional.user.consumer.key.
    • Secreto de consumidor: el valor establecido para la propiedad functional.user.consumer.secret.
    Pulse Registrar y Aceptar.
  7. Seleccione Archivo > OSLC > Conjuntos de trabajo. En la ventana Seleccionar proyecto, seleccione los proyectos, las carpetas y los módulos que desea exponer a LQE.
  8. Seleccione todos los módulos necesarios en el panel Seleccionar módulos. Pulse Aplicar.

Configuración de LQE para utilizar DOORS Web Access como origen de datos

  1. Vaya a https://nombre_host:puerto/lqe/web
  2. Seleccione Administración en el menú de la barra de herramientas.
  3. En la página Orígenes de datos, seleccione Añadir origen de datos.
  4. En el diálogo Añadir origen de datos, seleccione la opción de URL de documento de Servicios raíz. Especifique el URL de servicios raíz de DOORS. Seleccione el URL de TRS. Especifique una etiqueta y seleccione Especificar detalles de autenticación.
    • URL de servicios raíz: https://doorsserver:port/dwa/public/rootservices
    • Seleccione https://servidor_doors:puerto/dwa/rm/trs
    • Etiqueta: DOORS
    Captura de pantalla de los valores de origen de datos de DOORS que se añaden a LQE
  5. Especifique la clave y secreto de consumidor.
    Nota: La clave y el secreto de consumidor deben coincidir con los valores del archivo festival.XML de DOORS Web Access. En el ejemplo siguiente, el valor xyz es un ejemplo.
    <f:property name="functional.user.consumer.key" value="xyz"/>
    <f:property name="functional.user.consumer.secret" value="xyz"/>
    Captura de pantalla de la clave y el secreto de consumidor
  6. Establezca el número de hebras en 1 para la primera indexación incremental y pulse Finalizar. Pueden producirse errores ocasionales si se utiliza más de una hebra para la indexación.

Configuración de TRS para la aplicación de Rhapsody Design Manager

  1. Vaya a https://nombre_host:port/jts/admin
    Nota: Los consumidores de entrada de Design Manager se definen en Jazz Team Server de la consola administrativa, no en la consola de Design Manager.
  2. Seleccione Servidor > Consumidores (Entrada), especifique lo siguiente y pulse Registrar:
    • Nombre: LQE
    • Secreto: xyz
    • De confianza: sí
  3. Vaya a la lista Claves autorizadas y edite la entrada LQE pulsando el icono de lápiz.
  4. En el diálogo Editar propiedades de clave de consumidor, pulse el enlace Seleccionar usuario...
  5. Especifique lqe en el campo de filtro y seleccione lqe_user en la lista de usuarios coincidentes. Pulse Añadir y cerrar y, a continuación, Finalizar.
  6. Vaya a https://nombre_host:port/dm/web
  7. Inicie una sesión como usuario administrativo.
  8. Seleccione su área de proyecto y seleccione Gestionar propiedades de proyecto en el menú desplegable Administración (el icono de rueda dentada). Seleccione Contexto OSLC predeterminado, y pulse Seleccionar. Seleccione el nombre del proyecto y pulse Aceptar y a continuación, Guardar.
    Seleccione su área de proyecto y asegúrese de que esté asignado el contexto de OSLC predeterminado.
  9. Registre Rhapsody DM como un proveedor TRS y genere su índice. Abra la página administrativa de Lifecycle Query Engine: https://nombre_host_lqe:port/lqe/web.
  10. Pulse Administración > Orígenes de datos > Añadir origen de datos.
  11. En el diálogo Añadir origen de datos, seleccione http://nombre_host_rdm:9443/dm/trs y añada la etiqueta RDM. Acepte el resto de los valores predeterminados (si tiene una muchos datos que indexar, aumente el número de hebras para la indexación inicial a 4) y pulse Finalizar.

Configuración de TRS para la aplicación de Rational Engineering Lifecycle Manager

Si la instalación es nueva, no hay datos que indexar. Puede crear un proyecto y un producto de ejemplo, para poder verificar que el índice se ha creado satisfactoriamente.

  1. Abra la página administrativa de Lifecycle Query Engine: https://nombre_host_lqe:port/lqe/web.
  2. Pulse Administración > Orígenes de datos > Añadir origen de datos.
  3. En el diálogo Añadir origen de datos, seleccione http://nombre_host_relm:port/productdef/resource/tracked_resource_set y añada la etiqueta RELM. Acepte el resto de los valores predeterminados (si tiene una muchos datos que indexar, aumente el número de hebras para la indexación inicial a 4) y pulse Finalizar.
    Lista de orígenes de datos que muestran todos los componentes indexados.
  4. Para probar el índice, abra Rational Engineering Lifecycle Manager: https://nombre_host_relm:port/relm/web
  5. Seleccione un proyecto de ejemplo. En el menú Consultas, seleccione Consultas compartidas.
  6. Expanda el nodo de ejemplo y seleccione Todos los artefactos. Se le solicitará autorizar todas las aplicaciones para las que desee ejecutar la consulta. En la página Autorización de usuario, https://nombre_host_relm:port/lqe/web/auth, pulse Autorizar junto a cada aplicación que desea consultar.
    Pantalla de autorización de usuario
  7. El resultado de la consulta visualiza el producto de ejemplo que ha creado.

Configure TRS para los usuarios de Jazz Team Server

  1. Abra la página administrativa de Lifecycle Query Engine: https://nombre_host_lqe:port/lqe/web.
  2. Pulse Administración > Orígenes de datos > Añadir origen de datos.
  3. En el diálogo , seleccione http://host_name:port/jts/trsUsers y añada la etiqueta Users. Acepte los valores predeterminados restantes y pulse Finalizar.

Qué hacer a continuación

Después de configurar las aplicaciones como proveedores de TRS, siga los pasos de Ejecutar una consulta para probar o depurar para validar la configuración.


Comentarios