BuildForge puede trabajar con Rational ClearCase para la gestión de código fuente.
En este tema se describen requisitos de configuración adicionales para la integración con Rational ClearCase y
se resumen las características de las plantillas de adopción de ejemplo proporcionadas.
La plantilla de adaptador de ClearCase proporciona métodos para el análisis de cambios en una
línea base. Para evitar compilaciones, se utiliza análisis de cambios comunes: si un componente de línea base
no ha cambiado, no se vuelve a compilar
Requisitos de configuración adicionales para los adaptadores de ClearCase
Para requisitos generales,
consulte Requisitos de los adaptadores. Además de completar los
requisitos generales para adaptadores, siga estas instrucciones:
- Instale un agente de Build Forge en un host que pueda conectarse al servidor ClearCase.
- Instale el cliente completo de ClearCase en el host del agente.
- Configure el entorno para el agente de forma que se puedan ejecutar mandatos a través del cliente ClearCase.
- Determine cómo implementar y cómo y cuándo iniciar las vistas de ClearCase necesarias. Las plantillas que se proporcionan asumen el uso de vistas dinámicas e incluyen
vistas iniciales cuando ejecutan un mandato de cleartool. Instale el cliente completo de ClearCase en el host del agente.

Vistas de ClearCase
ClearCase emplea vistas como
forma de acceso del usuario a sus datos. Pueden usarse dos tipos de vistas:
- Vistas dinámicas: Las vistas dinámicas permiten ver la versión más reciente
de los elementos de VOB que especifique sin copiarlos a su sistema local. Deben iniciarse. Se especifica en
la vista qué VOB deben montarse.
- Vistas de instantánea: Las vistas de instantánea son una copia del repositorio.
El usuario puede especificar qué versión de objetos desea utilizar. Las vistas de
instantánea deben actualizarse manualmente para obtener los elementos más recientes
que se hayan incorporado.
- Vistas dinámicas
- Las vistas dinámicas muestran un espacio de trabajo que se actualiza
constantemente cuando algo cambia en el contexto de la vista que el usuario selecciona. Solamente
los elementos extraídos se copian al espacio de trabajo, y deben incorporarse para que estén
disponibles para otros usuarios. Cuando se utilizan vistas dinámicas, se usan tres especificaciones para
acceder a los datos deseados:
- Vista: define la lista de versiones que deben presentarse (a través de una especificación de
configuración). La vista debe iniciarse utilizando un mandato. Se representa en el disco local como un
directorio raíz del contenido. También se llama vista raíz. Los directorios usados normalmente son
los siguientes:
- Windows: unidad M:, una unidad compartida
- UNIX o Linux: /view, un sistema de archivos montado
- Contexto de la vista: define un directorio de contenido que utilizar
a través de una etiqueta de vista. La etiqueta de vista está definida en ClearCase. El
directorio se hace disponible cuando se inicia la vista.
- VOB (base de objetos versionados): define un nuevo subdirectorio del contexto
de vista. Las VOB se definen en ClearCase. La VOB se monta en el contexto de la vista
de manera explícita. Este subdirectorio contiene artefactos versionados
(archivos fuente y otros artefactos).
Las vías de acceso de una VOB en la máquina
local se construyen con los tres elementos siguientes:
- Vía de acceso de ejemplo para sistemas Windows, utilizando el valor predeterminado:
M:\view_tag\vob_name
- Vía de acceso de ejemplo para sistemas UNIX y Linux, utilizando el valor predeterminado:
/view/view_tag/vob_name
- Vistas de instantánea
- Cuando se utilizan vistas de instantánea debe especificarse el contexto de la vista
y cargar los datos. El resultado es una copia local de todos los datos especificados. Las vistas de instantánea deben volver a cargarse para obtener los cambios que se hayan
incorporado desde la última carga de datos.
Características de Rational Build Forge que dan soporte a las vistas dinámicas
Puede utilizar variables de entorno especiales para definir e iniciar vistas dinámicas desde un
trabajo de Build Forge.
- CLEARCASE_VIEW
- Inicia la vista de ClearCase especificada. La vista especificada en esta variable debe existir,
y el paso que la utiliza se debe establecer en "absoluto". En sistemas que
ejecutan Microsoft Windows, esta variable debe utilizarse junto al parámetro
cc_suppress_server_root para el agente de bfagent.conf.
- _CLEARCASE_VIEWS
- Especifica una lista de vistas de ClearCase que se deben iniciar antes de ejecutar un mandato.
Defina el valor con una lista separada por comas de vistas, por ejemplo, "Vista1,Vista2,Vista3".
- _CLEARCASE_VOBS
- Especifica un lista de VOB de ClearCase que se deben montar antes de ejecutar un mandato.
Defina el valor con una lista separada por comas de VOB, por ejemplo, "\Vob1,\Vob2,\Vob3".
También es posible que necesite utilizar los parámetros del agente para gestionar
las vistas en el host del agente. Debe definir los parámetros del agente si el que está utilizando con ClearCase se ejecuta
en un sistema Windows. También son útiles si la vista raíz que desea utilizar a través de
este agente es distinta de la vista raíz definida
por el trabajo. Esto puede ocurrir si ha utilizado el trabajo para más de un
agente y las especificaciones tienen que ser diferentes en el host de cada agente.
- ccviewroot vía-de-acceso-raíz
- Especifica la raíz de la vista predeterminada para este host. Consulte la documentación de ClearCase sobre init para obtener más información. Los valores predeterminados internos son los siguientes:
- Sistemas Windows: ccviewroot M:
- Sistemas UNIX o Linux: ccviewroot /view
- cc_suppress_server_root
- Si está establecido, la vía de acceso de la vista será la vía de acceso establecida por ccviewroot. Si no
está establecido, la vía de acceso establecida en la definición de servidor se añade a la
vía de acceso establecida por ccviewroot. Este valor no necesita valor. Si se encuentra
en bfagent.conf, entonces está establecido.
Ejemplos de plantillas de adaptador de ClearCase
Se proporcionan los ejemplos de plantillas de adaptador
siguientes.
- ClearCaseBaseline
- Explora un directorio en una vista ClearCase.
- Registra la información de versión y ramificación facilitada por ClearCase en el informe BOM.
Variables utilizadas:
- INT_STREAM
- VIEW
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- ClearCaseByBaselineActivities
- Crea una nueva línea base a partir del contenido de una vista ClearCase.
- Compara la nueva línea base y la línea base desde la ejecución de adaptador previa para identificar un cambio de actividad.
- Por cada cambio de actividad, registra la siguiente información
en el informe BOM: actividad, archivos cambiados, usuario,
fecha, comentarios y versión.
- Por cada archivo cambiado, registra los detalles del cambio
(desde la salida del mandato diff) en el informe BOM.
Variables utilizadas:
- CurDate
- LAST_RUN
- BASELINE
- VIEW
- VOB_PATH
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- ClearCaseByBaselineVersions
- Crea una nueva línea base a partir del contenido de una vista ClearCase.
- Compara la nueva línea base y la línea base desde la ejecución de adaptador previa para identificar los archivos cambiados.
- Por cada archivo cambiado, registra la siguiente información en el informe BOM:
nombre de archivo, versión, fecha, usuario y comentarios.
- Por cada archivo cambiado, registra los detalles del cambio
(desde la salida del mandato diff) en el informe BOM.
Variables utilizadas:
- CurDate
- LAST_RUN
- LABEL
- BASELINE
- VIEW
- VOB_PATH
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- _CHAR_NATIVE
- ClearCaseByDate
- Consulta en una vista ClearCase si ha habido cambios entre dos fechas. Las fechas predeterminadas son la indicación de fecha actual y la indicación de fecha de la ejecución de adaptador previa.
- Por cada archivo cambiado, registra la siguiente información en el informe BOM:
nombre de archivo, versión, fecha, usuario y comentarios.
- Por cada archivo cambiado, registra los detalles del cambio
(desde la salida del mandato diff) en el informe BOM.
Variables utilizadas:
- CurDate
- LAST_RUN
- LABEL
- BASELINE
- VIEW
- VOB_PATH
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- _CHAR_NATIVE
- ClearCaseByLabel
- Crea y aplica una nueva etiqueta en el contenido de una vista
ClearCase.
- Compara la nueva etiqueta y la etiqueta registrada desde la ejecución de adaptador previa
para identificar los archivos cambiados.
- Por cada archivo cambiado, registra la siguiente información en el informe BOM:
nombre de archivo, versión, fecha, usuario y comentarios.
- Por cada archivo cambiado, registra los detalles del cambio
(desde la salida del mandato diff) en el informe BOM.
Variables utilizadas:
- CurDate
- LAST_RUN
- LABEL
- BASELINE
- VIEW
- VOB_PATH
- PROJECT_VOB
- CCSERVER
- UNIXCLIENT
- _CHAR_NATIVE
Variables de adaptador de ClearCase
Esta tabla es una referencia para las listas de variables
para las plantillas de adaptador.
Nombre de la variable de entorno |
Descripción |
BASELINE |
Para los adaptadores ByBaseline, cuando utiliza un adaptador para generar diferencias según la línea base, el sistema utiliza este valor como línea base. |
CCSERVER |
Establezca esta variable en el nombre del host que tiene el cliente
ClearCase y el agente Build Forge instalados. |
CurDate |
Pone la fecha actual al adaptador. Utiliza un mandato .date
para generar la fecha con el formato esperado por ClearCase.
No cambie este valor. |
LABEL |
Para los adaptadores ByLabel, cuando utiliza un adaptador para generar diferencias según la etiqueta (con el adaptador ByLabel), el sistema utiliza este valor como etiqueta. |
LAST_RUN |
Para los adaptadores ByDate, el sistema utiliza este valor para determinar si se han producido cambios; el valor es la fecha de la última ejecución con éxito. Puede manipular este valor al probar el adaptador para forzarlo a que se ejecute tomando como referencia una fecha que sabe que es anterior a algunos cambios. Si el adaptador permite que a ejecución
continúe, actualiza automáticamente este valor a la fecha actual. El valor predeterminado es 1-Enero-05.00:00:00. |
PROJECT_VOB |
Cuando utilice el adaptador ByBaseline, defina esta
variable con el nombre de su proyecto VOB (sólo utilizado con UCM ClearCase).
Ejemplo: \ProjectVob |
UNIXCLIENT |
Se utiliza para establecer la información específica de plataforma. Establecer en 0 si
el cliente se ejecuta en Windows. Establecer en 1 si el cliente se ejecuta en UNIX o Linux. |
VIEW |
Defina esta variable con el nombre de la vista ClearCase que quiere utilizar con el adaptador. |
VOB_PATH |
Defina este valor con el nombre del componente
VOB, y opcionalmente, sus subdirectorios. Usar una lista separada por comas para varios nombres. |
_CHAR_NATIVE |
Se utiliza internamente, y siempre se establece en 1. |
Las variables
de desencadenantes siguientes también se pueden utilizar para iniciar vistas y vobs de montaje. No obstante, son independientes de las vistas y vobs que se establecen en las variables de adaptador.
- CLEARCASE_VIEW
- _CLEARCASE_VIEWS
- _CLEARCASE_VOBS
Consulte Referencia de variables de desencadenantes.