Tersus: Preparing for Team Modeling with SVN

Preparing for Team Modeling with SVNDate: Dec 5, 2012Setting up a version control repositoryYou will first need to setup a Subversion server/deamon on a machine in the network to which all team members have access.
When the server has been setup, you will need to create a repository using the admin tools provided by your server.While the precise setup procedure is outside the scope of this document, we have successfully used SVN servers bundled with various Linux distributions, as well as cygwin based solutions on Windows, but other implementations should work equally well.Setting up the studioIn order to access the repository each team member must setup an SVN client in his studio. We recommend Subclipse, which is installed as follows:

Select Help -> Install New Software... to open the Install dialog.

Enter the url http://subclipse.tigris.org/update_1.6.x into the Work with: field, and press Enter.

The studio will query the update site, displaying Pending, which should be replaced after a few seconds, by one or more branches.

Expand the Subclipse branch and check the features:

Subclipse (Required)
Subversion Client Adapter (Required)
SVNKit Client Adapter (Not Rquired)

Check the Core SVNKit Library branch, to slect the SVNKit Library feature.

Click Next > as needed, accept the license, and Finish.

When installation is complete, restart the studio as prompted.

You'll also need to install Tersus Subclipse support as follows:

Select Help -> Install New Software... to open the Install dialog.

Enter the url http://updates.tersus.com/subclipse into the Work with: field, and press Enter.

The studio will query the update site, displaying Pending, which should be replaced after a few seconds, by one or more branches.

Check the Tersus branch to select the tersus.subclipse feature.

Click Next > as needed, accept the license, and Finish.

When installation is complete, restart the studio as prompted.

Setting up the teamThe lead (initial) modeler should share the application. Additional modelers should then checkout the application.Sharing the applicationThis procedure should be performed by the lead modeler (the modeler who has been maintaining the application up till now).

Switch to the Tersus Modeling perspective (Window -> Open Perspective or Window -> Open Perspective -> Other...)

Stop the application server if running

Switch to the Navigator view (Window -> Show View)

Right-click the [Application Name] project root, select Team -> Share Project... to open the Share Project wizard

At the Share Project step
(This step will only appear if both CVS and SVN clients have been installed)
- Select SVN
- Click Next
At the Share Project with SVN Repository step
(This step will only appear if an SVN repository has already been defined in the current eclipse workspace)
- If you want to share to an existing repository location:
  - Select the default Use existing repository location radio button
  - Select the repository from the list
  - Click Next to skip to the Enter Folder Name step
- If you want to share to a new repository location:
  - Select the Create a new repository location radio button
  - Click Next
At the Enter Repository Location Information step
(This step will appear if there is no SVN repository defined in the current eclipse workspace or if you chose to create a new repository location in the previous step)
- Enter the Url of your repository (ask your SVN admin or see the documentation for further details)
- Click Next
At the Enter Folder Name step
- Select the radio button option which is best suited for you configuration. Usually this is the default Use project name as folder name.
- Click Next
At the Ready to Share Project step
- Enter a commit comment (or leave the default Initial import.)
- Click Finish

If prompted to Enter SVN Author Name

Enter your name
Check the Save author name check box
Click OK

At this point a new folder for the project will be created in the repository, but the project itself is yet to be committed.

When prompted to switch to the Team Synchrnizing perspective

Click OK

The Synchronize view will contain a tree of all folders and files making up the project, with a decoration indicating they are outgoing (to the repository)

Click the Commit All Outgoing Changes ... button in the view's toolbar, or right-click the root folder and select Commit..., to open the Commit dialog

Enter a commit comment

Check the Show unversioned files check box
Make sure all folders and files are checked
Click OK to commit

The Sybchronize view tree should disappear

Note that once an application is connected to the repository, its packages (in the Repository Explorer view), and its files and folders (as displayed in the Navigator view) display a small icon decoration (on the left-bottom corner of the object's icon) indicating they have been shared.Checkout the applicationThis procedure should be performed by all modelers joining the team.

Switch to the Tersus Modeling perspective (Window -> Open Perspective or Window -> Open Perspective -> Other...)

Open the Import wizard (File -> Import...)

At the Select step
- Expand the SVN branch
- Select the Checkout Projects from SVN
- Click Next

At the Select/Create Location step
(This step will only appear if an SVN repository has already been defined in the current eclipse workspace)
- If you want to checkout from an existing repository location:
  - Select the default Use existing repository location radio button
  - Select the repository from the list
  - Click Next to skip to the Select Module step
- If you want to checkout from a new repository location:
  - Select the Create a new repository location radio button
  - Click Next
At the Enter Repository Location Information step
(This step will appear if there is no SVN repository defined in the current eclipse workspace or if you chose to create a new repository location in the previous step)
- Enter the Url of your repository (ask your SVN admin or see the documentation for further details)
- Click Next
At the Select Folder step
- Find the folder containing the project in the tree and select it
- Click Finish