Importing a Subversion dump file

A Subversion (SVN) dump file includes the entire contents of a Subversion repository. You can import all or part of a Subversion dump file to a new or existing component.

Before you begin

You must be Jazz™ repository administrator to map user names. If you do not map user names, all imported files and folders are owned by the user who ran the import.
Note: Dump format versions previous to Subversion 3.0 can be imported into IBM® Engineering Workflow Management (EWM).

About this task

To create a Subversion dump file, use the Subversion command svnadmin dump. Dump files can be filtered to remove repository contents that you do not want to import to EWM. For more information about creating and filtering Subversion dump files, see http://svnbook.red-bean.com/en/1.1/re31.html or the Subversion documentation at http://subversion.tigris.org/.

There are two phases to importing a Subversion dump file. In the first phase, you specify the import source (a Subversion dump file) and destination (a component in a repository workspace). In the second phase, the importer opens the dump file and displays a list of folders that can be selected for import and a list of Subversion user names that you can map to Jazz users.

To import a Subversion dump file:

Procedure

  1. On the Jazz Source Control main menu, click File > Import.
  2. On the Select page, expand Jazz Source Control, and select SVN Dump File. Click Next.
  3. On the Import SVN Dump File page, click Browse. Navigate to the dump file that you want to import and click Open.
  4. Optional: To save a compressed dump file, select Save a compressed version of the dump file for additional imports. After you import the trunk, you can use the saved dump file to import one or more branches.
  5. Click Next.
  6. On the Import into workspace and component page, to specify a destination workspace and component for the import:
    Tip: If you are importing the trunk, create a new component for it. If you are importing a branch, select a component baseline that was created during the previous trunk import.
    • To import into an existing repository workspace and component, select Select a component in an existing repository workspace and select the workspace and component.
    • To import into a new component in an existing repository workspace, select Select a component in an existing repository workspace and click New component. Type a name for the new component.
    • To create a new repository workspace and component to receive the import, select Create a new repository workspace name and type a name for the new workspace. The import creates a new workspace and component. The component has the same name as the workspace.
  7. Click Next.
  8. Optional: On the Configure import from SVN to Jazz page, complete any of the following steps:
    • To specify a baseline name, in the Post Import Baseline Name field, type a new baseline name.
    • To generate baselines for branch and tag points, select Create baselines for branch and tag points.
    • To specify a text file encoding, in the Text file encoding pane, select Other; in the drop-down list, select an encoding type.
    • To reconcile existing and imported files, select Reconcile any overlap between existing imported files and folders.
    • To specify a revision range to import, in the Revisions to import pane, select Import all revisions within the specified range; in the Start Revision and End Revision fields, specify the revision range.
  9. Click Next.
  10. Optional: On the User Mapping page, complete any of the following steps:
    • To defer user mapping until after the SVN dump file has been read and the list of users in it displayed, select Prompt for Jazz users once the SVN user IDs have been discovered.
    • To not map users, select Do not map SVN users to Jazz users.
    • To automatically map user names with the same id and create missing users, select Automatically map SVN users to Jazz users with the same id and create any missing users.
  11. Optional: On the User Mappings page, to manually map SVN users to Jazz users, select Use the mappings entered below and complete any of the following steps:
    • To add an SVN user, click Add SVN user. In the Add an SVN user ID dialog box, type a user name in the field and click OK.
    • To create a new Jazz user with the same user ID as a Subversion user, in the SVN User ID column, select a name; then click Create Jazz users.
    • To map an SVN user ID to an existing Jazz user, in the SVN User ID column, select a name; then click Change Jazz user. In the Select users dialog box, enter a Jazz user name in the field and click OK.
    • To remove a Subversion user, click the user name; then click Remove.
    • To save the current mappings to a file that you can reuse for future imports, click Save.
    • To reuse a mapping file that you created in a previous import, click Load.
  12. Click Next.
  13. On the Project Paths page, to specify the paths of projects to be imported, complete one of the following steps:
    • If you are not sure of the structure of the Subversion repository, select Prompt to determine what folders to import when the SVN repository folder structure is known.
    • To import a path as a top-level folder in the target component, select Import the paths specified below as top-level folders in the target component. To add a path, click Add Path and in the Add Path dialog box, type the path name in the path field and click OK. To load a set of paths saved to a file, click Load and navigate the file. To save the file to a specified location, click Save.
    • To import a path specified below as a component root, select Import the path specified below as the root of the component. To edit a path, select it; then click Edit. In the Edit path dialog box, in the Path field, change the path and click OK.
  14. Click Finish to display the contents (folders and users) of the selected Subversion dump file.
  15. In this phase of the import process, you select folders to import and, if you are a repository administrator, specify how SVN user names map to Jazz user names. On the Choose SVN folders to import page, in the Folders found in SVN repository area, select the folders that you want to import and complete any of the following steps:
    • To search the file for Eclipse projects, click Add Projects, or use the Add and Remove buttons to create a list of the folders that you want to import.
    • To save the current list of folders to a file that you can reuse for future imports, click Save.
    • To reuse a list of folders that you created in a previous import, click Load.
  16. To map user names, click Next.
  17. On the User Mapping page, specify any user name mappings that you want the importer to make, or click Do not map SVN users to Jazz users if you want all imported files and folders to be owned by the Jazz user running the importer.
    • Click a name in this list and then click Change Jazz user to view a list of Jazz user names to which the Subversion user can be mapped.
    • To create a new Jazz user to map to a Subversion user, click Create Jazz Users.
    • To undo any mappings you have specified, click Reset.
    • To save the current user mappings to a file that you can reuse for future imports, click Save.
    • To reuse a user mapping file that you created in a previous import, click Load.
  18. To start the import, click Finish.

Results

After the import completes, you can add the new component to a stream or, if you imported into an existing component, deliver the imported change sets, so that other team members can use them.

video icon Video

Jazz.net channel
Software Education channel

learn icon Courses

IoT Academy
Skills Gateway

ask icon Community

Jazz.net
Jazz.net forums
Jazz.net library

support icon Support

IBM Support Community
Deployment wiki