Tigerstripe Source Control Integration

Service Contracts are developed in a team environment, and have a lifecycle of their own based on additional requirements and/or application upgrades, it is essential that your Service Contract model (ie. Tigerstripe projects) are placed under version control.

This section provides documentation on integrating your Tigerstripe project with CVS (Concurrent Versions System).

Note: Tigerstripe Workbench directly leverages the Eclipse integration with various versioning systems. For more information on specific operations or functionalities, either with CVS or any other versioning system, please refer to the appropriate Eclipse documentation.

Tigerstripe uses a set of XML and Java files for internal representation of all Tigerstripe Artifacts and project information. This makes it possible to establish a fine-grain version control mechanism, where each Artifact is controlled independently.

The following operations should be considered with version control:

• Sharing a Tigerstripe Project through a CVS repository: For example, placing your local project into a CVS repository so other team members can access it.
• Importing a Tigerstripe Project from a CVS repository: For example, your project has already been placed under version control onto a CVS repository.
• Making changes on a Tigerstripe Project under CVS

Each of these topics is detailed in one of the following sections.

Sharing a Tigerstripe Project

Tigerstripe Projects are fully integrated into Eclipse, which allows you to directly leverage the integration with CVS.

To share a Tigerstripe Project

1. Open your Tigerstripe Perspective. For more information, refer to Tigerstripe Workbench Perspective.
2. Right-click on the project you want to place under version control in the Tigerstripe Explorer.
3. Select Team and click Share project.The following dialog box displays:

   

4. Select CVS and click Next. The following dialog box displays:

   

5. Enter a CVS repository host in the Host text box. If you have already set up a respository, you can select a repository host from the drop-down list.
6. Enter a CVS respository location in the Respository path text box or select an existing repository from the drop-down list.
7. Enter the user authentication information in the Authentication area.
8. Select the connection information in the Connection area.
9. Click Next. The following dialog box displays:

   

10. Select the identifier of the project as it will appear on the CVS respository. You have the following options
• Use project name as module name: the project name (as it appears in the Tigerstripe Explorer) is used as the identifier.
• Use specified module name: the provided name is used as the name of the CVS identifier.
• Use an existing module: use an existing CVS identifier obtained directly from the CVS repository. For more details, refer to the corresponding Eclipse documentation.
  
  Note: This option adds an extra step in the process where you are requred to select the target tags/versions.
  
  
11. Click Next. The following dialog box displays:

    

12. Make sure all of your project files appear in the dialog box window, and click Finish. Your project is now under version control. The label of each artifact and each file in the project now have a version number attached in the Tigerstripe Explorer.

Importing a Tigerstripe Project from CVS

Once your Tigerstripe project is stored in a CVS repository, you can import it into any Eclipse workspace.

To import a project:

Before you Begin: Make sure that your Tigerstripe Perspective is active.

1. Right-click anywhere in Tigerstripe Explorer and select Import. The following dialog box displays:

   

2. Click CVS, select Projects from CVS, and click Next.. The following dialog box displays:

   

3. Enter a CVS repository host in the Host text box. If you have already set up a respository, you can select a repository host from the drop-down list.
4. Enter a CVS respository location in the Respository path text box or select an existing repository from the drop-down list.
5. Enter the user authentication information in the Authentication area.
6. Select the connection information in the Connection area.
7. Click Next. The following dialog box displays:

   

8. Select the name of the module in CVS to import. You can either enter the exact name of the module by selecting Use specified module name or you can browse to an existing module in the repository by selection Use existing module.
9. After entering or selecting the module, click Next.
10. Select Check out as project in the workspace. Optionally, you can specify the name of your local copy of the project in your workspace.
11. Click Finish.

Your imported project will appear in your Tigerstripe Explorer.

Note: Each Artifact and additional file is decorated with their version number in CVS.

Working with a Tigerstripe Project under CVS

When a Tigerstripe Project is shared through CVS (or is imported from a CVS repository), all Artifacts and files are versioned separately. They display the version number in CVS as a decoration on their names in the Tigerstripe Explorer.

Similar to any other Eclipse project under CVS control, normal CVS operations are available such as Update, Commit,and Synchronize. Complete the following procedure to access the CVS operations available.

To access files through CVS

1. Right-click on the target object in the Tigerstripe Explorer, and select Team.
2. Select the action that you want to perform.

For more information, refer to CVS or Eclipse documenation.