Deploying Objecteering CM Synergy for shared use

Prerequisites

Before you deploy the Objecteering CM Synergy MDAC, please make sure that Objecteering has already been installed and that the OBJING_PATH environment variable is already set. Telelogic CM Synergy must also be installed and the PATH environment variable has to contain the path to the "bin" directory of the CM Synergy installation.

Your Objecteering license key must include a license for the Objecteering CM Synergy MDAC, otherwise it will be impossible to use the MDAC.

Note: <$OBJING_PATH> refers to the Objecteering installation directory.

Using the MDAC

In order to use the Objecteering CM Synergy MDAC, it is necessary that:

· You export a project to CM Synergy.

· Each developer selects the MDAC to connect his project to the CM Synergy repository.

Exporting a project to CM Synergy

To export a project to CM Synergy, simply carry out these steps:

1. Create or open a project (please see "Creating or opening a project" in the Objecteering Modeler User Guide). In our example, we shall call our project "CMSynergyProject".

2. Deploy the Objecteering CM Synergy MDAC in this project (for information on how to deploy a MDAC, please see "Working with MDACs" in the Objecteering Modeler User Guide).

3. Export the Objecteering model to a directory.

4. Import the exported model and configure the CM Synergy project.

Deploying the Objecteering CM Synergy MDAC

The Objecteering CM Synergy MDAC can only be used if there exists a CM Synergy project related to the Objecteering project. Two case scenarios are possible:

· A new user wishing to connect to a CM Synergy work area is concerned. By selecting the MDAC, a wizard is used to initialize these parameters.

· The project is new and has not yet been archived in CM Synergy. This work is particularly destined for the build manager, who must export the Objecteering model in the form of a file and migrate these files into CM Synergy. This case scenario does not allow the MDAC to be selected, but can be used to create the CM Synergy work area, through a wizard.

Figure 109. Choices available when selecting the MDAC

Steps:

1. Select the desired options.

2. Confirm.

Exporting the Objecteering model to a directory

To be put in version in CM Synergy, a model must be generated as a set of files. The "Export the Objecteering model" option is used to generate all files which are necessary between Objecteering and CM Synergy. This option is only used once, by the build manager, to create the CM Synergy project.

Figure 110. Creating files which represent the model

Select a directory into which the Objecteering model will be exported, before migrating it into a CM Synergy project.

The migration directory is temporary, and is only used to migrate the Objecteering project into a CM Synergy project. Once the model has been exported to the entered directory, the build manager is informed of the actions to be carried out.

Figure 111. Actions to be carried out after creating the repository

Migrating the exported model and configuring the CM Synergy project

The following steps must be carried out to configure the CM Synergy environment, in order to integrate the Objecteering model into this environment. These steps must be carried out in the CM Synergy environment.

First create, if necessary, a CM Synergy "MyBase" database.

Continue by modifying the version "delimiter". This version "delimiter" must be the "," character. The CM synergy administrator can define this version delimiter using the ccm delim "," command.

Next, create a project whose name is the same as the Objecteering project (for example, "CMSynergyProject") for "Shared" purposes with "Tasks" in the "Reconfigure Using" field and "No value" for the "Release" field.

Figure 112. The "Create Project" dialog box

Next, migrate the directory where you have exported the model (for example, "C:\Temp\CMDirectory\CMSynergyProject") to this project (for example, "CMSynergyProject,1"). This can be done by clicking on the "Migrate" CM Synergy icon in the toolbar.

Figure 113. The. "Project view" window

Figure 114. The. "Migrate" dialog box

Figure 115. The project after migration

Connecting to the CM Synergy work area for shared purposes

To connect to the CM Synergy repository, each developer must:

· Create a project whose root package has the same name as the migrated project.

· Select and configure the Objecteering CM Synergy MDAC.

Note: The path to the CM Synergy work area must not be a UNC path. Instead, a network drive should be connected to the shared directory, and the path of the repository entered via this network drive.

Deploying the Objecteering CM Synergy MDAC

Now that the environment has been defined, all that remains is to select the Objecteering CM Synergy MDAC and to position it on the CM Synergy project work area.

To initialize your Objecteering project with the contents of the work area, deploy the Objecteering CM Synergy MDAC in your UML modeling project and choose the "Connect to the CM Synergy work area" option (as shown in Figure 109 of the current section).

The following dialog box will enable you to configure the CM Synergy connection.

Figure 116. The "Configuring MDAC parameters" window

Steps:

1. Type in the position of the project directory in your work area. This directory has the same name as your root package.

2. Enter your username and password to be able to open the CM Synergy session.

3. You can choose to start the CM Synergy in either GUI or text mode. If you choose the GUI mode, a CM Synergy window will be opened in the background. The "Properties" and "History" menu commands will open the corresponding CM Synergy window instead of an Objecteering dialog box.

4. In the "Task synopsis" field, you can select a CM Synergy task. If you leave this field empty, the CM Synergy MDAC will ask you to select a default task after confirmation of the information entered in the "Configuring MDAC parameters" window shown in Figure 12-27 above.

5. If you have selected a CM Synergy task, enter its release number.

6. Confirm.

Once these operations have been carried out, the project contained in the previously specified work area is imported into your project. You are ready to work.

Note: The Objecteering project must be empty. Otherwise, it will be overwritten by the imported project.