IBM BPM, V8.0.1, All platforms > Authoring services in Integration Designer > Work in teams > Use software configuration management systems
Use CVS with Integration Designer and Process Center
This topic shows you how to perform common tasks using IBM Integration Designer with IBM Process Center and a traditional software configuration management (SCM) system.
If you are using Integration Designer with Process Center, you are either storing your projects in Process Center or storing them in both Process Center and an SCM system. The latter case is likely to apply if you were working with earlier versions of WebSphere Integration Developer for several reasons:
- The SCM contains a history that is important for maintaining code integrity.
- There are usually automated build scripts that run from the SCM.
- Corporate standards may require that you continue to use a specific SCM.
Working with two repositories introduces additional complexity to the governance system, but those can be addressed by careful planning. These instructions will help you manage that configuration successfully.
Although this topic addresses working with Concurrent Versions System (CVS), the principles also apply to other SCM systems. For more information about working with CVS or other SCM systems, see the related links at the end of this topic. You can access actions for source control management system clients that you have currently installed from the Integration Designer Business Integration view by right clicking a project and opening the Team menu.
Eclipse only allows one SCM to be associated with a project.
If you use Process Center with another SCM system, treat Process Center as a secondary repository. The SCM system is the primary storage area used by the developers as they work with their artifacts. Load projects to the Process Center intermittently, perhaps at project milestones. Do not check projects out from Process Center to make changes.
Because you work from CVS, artifacts such as business process definitions, which are solely associated with Process Center will not exist in the CVS repository.
Procedure
- Add projects to both repositories. A project that is under CVS control can be added to Process Center by associating it with a process application or toolkit (see the related links for instructions). That association creates a bpm.repo.prefs file in the Integration Designer .settings folder. That file contains the details about the association. Integration Designer checks for this file when a when a project is brought into a workspace. If Integration Designer finds that file, it will connect to the Process Center repository and show the project as contained in the specified process application or toolkit. You can add a project to the repositories in either order, but if you associate the project with Process Center last, synchronize the project with CVS immediately after association so that the bpm.repo.prefs file is visible if someone checks the file out of CVS.
- Remove projects from the Process Center by disassociating them. You need access authority on the Process Center to perform this task.
- In the Business Integration view of Integration Designer, right click the project and select Disassociate from Process Center. Disassociation removes the project from the Process Center repository and deletes the bpm.repo.prefs file. The file will still exist in previous snapshots, so a disassociation can be reversed.
- Synchronize with CVS immediately so the disassociation is registered there before someone else checks out the file.
- Check out files only from CVS, using the CVS Import wizard or the CVS navigator. Although Integration Designer makes it easy to bring in projects from Process Center using the pop-up menu, you should not do that for projects that reside in CVS. CVS metadata is stripped out when a project is shared with the Process Center repository. If you pull projects from Process Center, the files will not be connected to CVS. If you unintentionally make changes to files that you have accessed in this way, you need to publish them to Process Center and have someone pull them into another workspace that still contains the CVS connection for the project. The revised project can then be committed to CVS from there.
- Before publishing projects to Process Center, update from CVS to capture any changes that have been made by the team. Immediately after publishing, synchronize with CVS. Doing these two actions keeps CVS as the system of reference and avoids conflicts between the two repositories.
- Create tracks in Process Center before creating branches in CVS. Make the branch and track names similar so the relationship between them is easy to identify.
- In the Process Center perspective, select a process application.
- In the process application title bar, select Manage. Select Allow users to create tracks in this process app.
- Select Snapshots and then select an existing snapshot or create one. Click New Track:
You need to create the track from a snapshot.
- In the Create New Track window, provide a name and description for the track. Click Create. Now that a track exists in Process Center, you can create a corresponding branch in CVS.
- Right-click a project in CVS and select Team > Branch.
- In the Create a new CVS branch window, give the branch a name and version.
- At this point, the new CVS branch still points to the main track, not the new track. To complete the process, you need to replace the workspace content with the new track content. In the Business Integration view, right-click the project and select Replace With > Latest from Tip of Track.
- Select the new track and click OK. At this point, Integration Designer edits the bpm.repo.prefs file to point to the new track. However, the projects must still be reassociated with the new CVS branch.
- In the Business Integration view, select Team > Share Project.
- In the Share Project window, select Use an existing module and select the module that you have associated with the process application. The program recognizes that there is now a branch for that module and provides a page where you can choose to synchronize with the branch instead of the HEAD stream.
- Select the branch and click Next. If you do not see your branch, click Refresh Tags.
- Expand the module settings, right-click bpm.repo.prefs, and select Mark as Merged. Select Launch the Commit wizard and click Next.
- Right-click bpm.repo.prefs, and select Commit. Click Finish.
- If a Process Center machine URL changes, edit the bpm.repo.prefs file to reflect the change.
- If a project in CVS is associated with a Process Center that is no longer running, disassociate the project from the Process Center server. Right-click the project in the Business Integration view. Select Disassociate and confirm the action.
Use software configuration management systems
Related concepts:
Work with ClearCase
Perspectives and views for team development in Integration Designer
Physical Resources view: The .settings folder
Related tasks:
Sharing your integration project through CVS
Related information:
Associating a module or library with a process application or toolkit
Disassociating a module or library from a process application or toolkit