Un archivo dump de Subversion (SVN) incluye todos los contenidos de un
repositorio Subversion. Se puede importar todo o parte del archivo dump de Subversion
a un componente nuevo o pre-existente.
Antes de empezar
Debe ser
Jazz administrador
para correlacionar (map) nombres de usuario. Si no correlaciona nombres de usuario, todos los archivos y carpetas importados
pertenecerán al usuario que ejecutó la importación.
Por qué y cuándo se efectúa esta tarea
Para crear un archivo dump de Subversion, utilice el mandato de Subversion svnadmin
dump. Los archivos dump se pueden filtrar para quitar contenidos del repositorio
que no se deseen importar a Rational Team Concert. Para más información sobre creación y filtrado de archivos dump de
Subversion, véase http://svnbook.red-bean.com/en/1.1/re31.html o la documentación de Subversion enhttp://subversion.tigris.org/.
Existen dos fases
de importación de un archivo dump de Subversion. En la primera fase,
especifique la fuente de importación (un archivo dump Subversion) y de destino (un componente
en un área de trabajo en un repositorio). En la segunda fase, el importador abre el archivo
dump y muestra una lista de carpetas que se pueden seleccionar y una lista
de nombres de usuario de Subversion que se pueden correlacionar (map) con usuarios de Jazz.
Para importar un archivo dump Subversion:
- En el menú principal de Jazz Source Control, pulse .
- En la página Seleccionar, expanda Jazz Source Control, y seleccione Archivo dump SVN.
Pulse Siguiente.
- En la página Importar archivo SVN Dump, pulse Buscar.
Navegue hasta el archivo dump que desea importar y pulse Abrir.
- Opcional: Para guardar un archivo dump comprimido, seleccione Guardar
una versión comprimida del archivo dump para importaciones adicionales.
- Pulse Siguiente.
- En la página Importar al área de trabajo y componente,
para especificar un área de trabajo destino y un componente para la importación:
Consejo: Si está importando la versión estable (trunk), cree un componente para la misma.
Si va a importar un módulo, seleccione una línea inicial del componente que fue creado
durante la importación previa de la versión estable o trunk.
- Para importar a un área de trabajo de un repositorio preexistente y un componente, seleccione Seleccionar
un componente en un área de trabajo de repositorio preexistente y seleccione el
área de trabajo y el componente.
- Para importar un componente nuevo en un área de trabajo de repositorio preexistente
seleccione Seleccionar un componente en un área de trabajo de repositorio preexistente y pulse Nuevo componente. Teclee un nombre para el nuevo componente.
- Para crear un área de trabajo de repositorio nueva y un componente para recibir la
importación, seleccione Crear un nombre para la nueva área de trabajo de repositorio y teclee
un nombre para dicho área de trabajo nueva. La importación crea un nuevo espacio de trabajo y un
componente. El componente posee el mismo nombre que el área de trabajo.
- Pulse Siguiente.
- Opcional: En la página Configurar importación de SVN
a Jazz, complete cualquiera de los pasos siguientes:
- Para especificar un nombre de línea base, en el campo Nombre de Línea base post-
importación, teclee un nombre para la nueva línea base.
- Para generar líneas base para ramificaciones y etiquetas puntuales, seleccione Crear líneas
base para ramificaciones y etiquetas puntuales.
- Para especificar una codificación de archivo de texto, en el panel Codificación de archivo de texto,
seleccione Otro; en la lista desplegable, seleccione un tipo de
codificación.
- Para acomodar los archivos existente e importado, seleccione Acomodar
cualquier solapamiento entre archivos y carpetas existentes.
- Para especificar un rango de revisión a importar, en el panel Revisiones
a importar, seleccione Importar todas las revisiones dentro
del rango especificado; en los campos Iniciar revisión y Finalizar
revisión, especifique el rango de revisión.
- Pulse Siguiente.
- Opcional: En la página Correlación de usuario,
realice cualquiera de los siguientes pasos:
- Para posponer la correlación de usuario hasta que el archivo dump SVN se haya leído
y la lista de usuarios aparezca, seleccione Avisar a los usuarios Jazz
una vez que los ID de usuario SVN se hayan descubierto.
- Para no correlacionar usuarios, seleccione No correlacionar usuarios SVN con usuarios Jazz.
- Para correlacionar nombres de usuarios con el mismo ID y crear usuarios
perdidos, seleccione Correlacionar automáticamente usuarios SVN con usuarios Jazz con mismo ID y
crear usuarios faltantes.
- Opcional: En la página de Correlaciones de usuario,
para correlacionar usuarios SVN con usuarios Jazz, seleccione Usar las correlaciones
abajo introducidas y complete cualquiera de los pasos siguientes:
- Para añadir un nuevo usuario SVN, pulse Añadir usuario SVN. En el
cuadro de diálogo Añadir ID de usuario SVN, teclee un nombre de usuario en
dicho campo y pulse Aceptar.
- Para crear un nuevo usuario Jazz con la misma ID de usuario como usuario de Subversion,
en la columna de ID de usuario SVN, seleccione un nombre y pulse Crear usuarios Jazz.
- Para correlacionar un ID de usuario SVN con un usuario Jazz existente, en la columna de ID de usuario SVN,
seleccione un nombre y pulse Cambiar usuario Jazz.
En el cuadro de diálogo Seleccionar usuarios, introduzca un nombre de usuario Jazz
en dicho campo y pulse Aceptar.
- Para quitar un usuario de Subversion, pulse sobre el nombre de usuario y, a continuación, en Quitar.
- Para guardar las correlaciones actuales en un archivo que pueda reutilizarse en importaciones
futuras, pulse en Guardar.
- Para reutilizar un archivo de correlaciones que se creó en una importación previa, pulse Cargar.
- Pulse Siguiente.
- En la página Rutas de proyecto, para especificar las
rutas de proyectos a importar, realice uno de los pasos siguientes:
- Si no está seguro de la estructura del repositorio de Subversion,
seleccione Solicitar la identificación de las carpetas a importar cuando la estructura de la estructura de carpetas del repositorio SVN
se conozca.
- Para importar una ruta como carpeta de nivel máximo en el componente destino, seleccione Importar
las rutas abajo indicadas como carpetas de nivel máximo en el componente destino.
Para añadir una ruta, pulse Añadir ruta y en el cuadro de diálogo Añadir
ruta, escriba el nombre de la ruta en el campo correspondiente a la misma y pulse Aceptar.
Para cargar un conjunto de rutas guardadas en un archivo, pulse Cargar y
vaya hasta dicho archivo. Para guardar el archivo en una ubicación específica pulse Guardar.
- Para importar una ruta abajo especificada como componente root seleccione Importar
la ruta abajo especificada como raíz del componente. Para editar
una ruta, selecciónela y pulse Editar. En el cuadro de diálogo Editar
ruta, en el campo Vía de acceso, cambie la ruta
y pulse Aceptar.
- Pulse Finalizar para ver los contenidos (carpetas
y usuarios) del archivo dump Subversion seleccionado.
- En esta fase del proceso de importación, seleccione las carpetas que desea importar
y, si es usted administrador de un repositorio, especifique cómo se correlacionarán los
nombres de usuario SVN con los nombres de usuario Jazz. En la página Seleccionar carpetas SVN a importar,
en el área Carpetas ubicadas en el repositorio SVN, seleccione
las carpetas que quiere importar y complete cualquiera de los pasos siguientes:
- Para buscar el archivo de proyecto Eclipse, pulse Añadir proyectos,
o use los botones de Añadir y Quitar
para crear una lista de las carpetas que desea importar.
- Para guardar la lista actual de carpetas en un archivo que se pueda reutilizar en importaciones
futuras, pulse Guardar.
- Para reutilizar una lista de carpetas que se creó en una importación previa, pulse Cargar.
- Para correlacionar nombres de usuario, pulse Siguiente.
- En la página Correlación de usuario, especifique cualquier correlación de nombres de usuario
que desee que el importador procese o pulse No
correlacionar usuarios SVN con usuarios Jazz si desea que todos los archivos y
carpetas importadas pertenezcan al usuario de Jazz que ejecuta el importador.
- Pulse en un nombre de esta lista y después en Cambiar usuario Jazz para
ver una lista de nombres de usuario Jazz para los que se puede correlacionar el usuario de Subversion.
- Para crear un nuevo usuario de Jazz y así poder correlacionarlo con un usuario de Subversion, pulse Crear
usuarios de Jazz.
- Para deshacer cualquier correlación que haya especificado, pulse Reajustar.
- Para guardar las correlaciones de usuario actuales en un archivo que pueda usted reutilizar en importaciones
futuras, pulse Guardar.
- Para reutilizar un archivo de correlaciones de usuario que se creó en una importación previa, pulse Cargar.
- Para iniciar la importación, pulse Finalizar.
Resultados
Una vez que la importación se haya completado, podrá añadir un nuevo componente a una agrupación
o, si lo importó en un componente existente, distribuir los conjuntos de cambios importados,
de manera que los demás miembros del equipo los puedan utilizar.