Tersus: Preparing for Team Modeling with CVS

Preparing for Team Modeling with CVSDate: Apr 8, 2009Setting up a version control repositoryYou will first need to setup a version control 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 CVS servers bundled with various Linux distributions, as well as CVSNT on Windows, but other implementations should work equally well.Setting up the studioIn order to access the repository each team member must setup a CVS client in his studio, as follows:

Select Help -> Software Updates... to open the Software Updates and Add-ons dialog.

Switch to the Available Software tab.

If the list of update sites includes either the Ganymede Update Site or The Eclipse Project Updates site, skip to step 7.

Click the Manage Sites... button to open the Available Software Sites dialog.

Check Ganymede Update Site or The Eclipse Project Updates (or both).

Click the OK button.

Expand the Ganymede Update Site (or The Eclipse Project Updates) entry, and the Collaboration Tools (or the Uncategorized) branch .

Check the Eclipse CVS Client feature.

Click the Install... button to open the Install wizard and follow the instructions given.

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 CVS
- Click Next
At the Share Project with CVS Repository step
(This step will only appear if a CVS 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 Module 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 CVS repository defined in the current eclipse workspace or if you chose to create a new repository location in the previous step)
- Enter the details of your repository (ask your CVS admin or see the documentation for further details)
- Click Next
At the Enter Module Name step
- Select the radio button option which is best suited for you configuration. Usually this is the default Use project name as module name.
- Click Next
At the Share Project Resources step
- Check the Launch the Commit wizard check box
- Click Finish

In the Commit Files wizard

At the Add Resources step
(This step may or may not appear, depending on the content of your project)
- Go over each Name/Extension and set the Content to Binary or ASCII Text as appropriate for that file (If *.trp appears make sure you select ASCII Text)
- Click Next
At the Commit step
- Enter a description (such as Initial Commit)
- Click Finish

Note that once an application is connected to the repository, 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 CVS branch
- Select the Projects from CVS
- Click Next

At the Checkout Project from CVS Repository step
(This step will only appear if a CVS 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 Folder 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 CVS repository defined in the current eclipse workspace or if you chose to create a new repository location in the previous step)
- Enter the details of your repository (ask your CVS admin or see the documentation for further details)
- Click Next
At the Select Folder step
- Select the Use an existing module (this will allow you to browse the modules in the repository) radio button
- Select the [Application Name] branch
- Click Finish