Requisitos de instalación y configuración

Cada instalación de producto individual incluye el componente común y el subproveedor de la API de Rational CM del producto. Por ejemplo, la instalación del producto Rational ClearQuest incluye el subproveedor de la API de CM de Rational ClearQuest. La capa de subproveedor garantiza la instalación de la infraestructura de componentes de la API de CM. De este modo, en función de la combinación de productos instalados, los sistemas pueden tener todos los archivos JAR siguientes o un subconjunto de los mismos:

La infraestructura de la API de Rational CM está diseñada para funcionar independientemente de que los subproveedores estén presentes o no. La interfaz de proveedor permite utilizar los archivos JAR de subproveedor en diferentes niveles de release.

El componente de la API de Rational CM tiene asociado un número de versión de varios componentes. La instalación de un subproveedor sobrescribe el componente de infraestructura instalado por una versión anterior del subproveedor, pero sólo en el caso de que la versión del componente de la infraestructura sea más actual que la que se encuentra instalada.

El archivo JAR de la API de Rational CM y otros archivos JAR necesarios se instalan en las ubicaciones siguientes de forma predeterminada. La variable <dir-instal> representa el directorio en el que se han instalado los archivos del producto Rational. De forma predeterminada, este directorio es /opt/rational en los sistemas UNIX y Linux and C:\Program Files\IBM Rational en los sistemas Windows.

Para utilizar los archivos JAR de la API de Rational CM, deberá añadir todas sus ubicaciones a la vía de acceso de clase.

Acceso a la API de Rational CM desde un conector Eclipse

Puede crear un conector Eclipse mediante los archivos empaquetados en el archivo <install-dir>\common\com.ibm.rational.stp.teamapi.zip y otros archivos instalados (enumerados en la sección anterior) para dar soporte al acceso a la API de Rational CM desde otros conectores de un entorno de ejecución de Eclipse. Este archivo ZIP incluye ejemplos de código, incluidos los ejemplos que las guías de aprendizaje de la API de CM describen.

Para añadir el conector de la API de Rational CM a la configuración del tiempo de ejecución, puede copiar el conector en la instancia de Eclipse o crear un sitio de instalación de ampliación nuevo. De este modo, se crea un directorio nuevo para la API de Rational CM (por ejemplo, C:\eclipse\plug-ins\com.ibm.rational.stp.teamapi). Éste es un simple y nuevo conector de Eclipse independiente que consta de archivos JAR de la API de Rational CM y archivos JAR (ClearCase y ClearQuest) específicos de producto. Tenga en cuenta que el archivo .zip también contiene los archivos JAR del producto reales. Una vez que haya creado el directorio del conector, deberá copiar cada archivo JAR instalado desde su ubicación de instalación al nuevo directorio de conector. Cada archivo JAR del subproveedor requiere el archivo JAR de la API de Rational CM. El conector se puede usar la próxima vez que se inicie Eclipse. Tenga en cuenta que si instala una versión de producto o parche más nueva, deberá verificar que los archivos JAR del conector coinciden con los archivos JAR instalados y utilizan los archivos JAR más actuales.

Para utilizar la API de Rational CM desde el conector, deberá identificar com.ibm.rational.stp.teamapi como una dependencia. Para obtener información sobre cómo crear un conector, vaya a http://help.eclipse.org/help30/topic/org.eclipse.platform.doc.isv/guide/firstplugin.htm.

También puede importar el conector de la API de CM a Eclipse en forma de proyecto.

Deberá tener instalada una versión con licencia de un producto de Rational para utilizar el subproveedor de la API de Rational CM para dicho producto. Si instala los archivos JAR del subproveedor sin tener el producto correspondiente instalado, las llamadas al paquete Java no se realizarán correctamente.

Acceso a la API de Rational CM desde una aplicación cliente de Java

Para que una aplicación cliente realice solicitudes al subproveedor de Rational ClearQuest, el producto Rational ClearQuest deberá estar instalado en la misma máquina que el programa de cliente que está invocando la API de Rational CM.

El subproveedor ClearCase da soporte a vistas web y al acceso remoto a través del servidor Rational ClearCase CM. La versión actual de la API de Rational CM no da soporte a vistas dinámicas ni de instantánea. Los archivos JAR adecuados deben copiarse desde el servidor CM a la máquina del cliente, ya sea en la ubicación de instalación del cliente o en el directorio del conector, en función del modo en que se utilice la API de Rational CM.


Comentarios