IBM Software Group Team Support and Versioning with ClearCase and CVS in WebSphere Business Modeler V7 Klaus Ulrich (klaus.ulrich@de.ibm.com) Technical Support Professional 7 October 2010 WebSphere Support Technical Exchange
Agenda What is team support Why using team support CVS vs Rational ClearCase Modeler with CVS integration Modeler with ClearCase (CC) integration What you need to know about ClearCase ClearCase VOBs ClearCase views Best practices Summary WebSphere Support Technical Exchange 2 of 42
What is team support Several users working on same set of project files Central repository holding project files Enables project versioning WebSphere Business Modeler integration with CVS and ClearCase WebSphere Support Technical Exchange 3 of 42
Why using team support Alternative to import/export Versioning needed Collaboration between several persons needed Working simultaneously on project WebSphere Support Technical Exchange 4 of 42
CVS vs Rational ClearCase CVS Open source, no support available No extra costs No locking mechanism Rational ClearCase ClearCase: IBM product, professional support Commercial product Locking mechanism available WebSphere Support Technical Exchange 5 of 42
Limitation of Modeler with CVS/ ClearCase integration Modeler does not support CVS/ClearCase branches Modeler project needs to be top level element in the CVS/ClearCase repository Modeler does not fully support ClearCase UCM projects WebSphere Support Technical Exchange 6 of 42
CVS (Concurrent Versions System) Supported CVS versions Unix CVS 1.11.22 and future fix packs Windows CVS NT 2.0.58d and future fix packs. WebSphere Support Technical Exchange 7 of 42
Setup Modeler with CVS integration Install CVS Create CVS repository Create CVS connection in Modeler Open view CVS Repository Create new repository connection Share project in Modeler Export Modeler preferences Check out project from CVS WebSphere Support Technical Exchange 8 of 42
Create CVS repository WebSphere Support Technical Exchange 9 of 42
Create CVS connection in Modeler WebSphere Support Technical Exchange 10 of 42
Share project in Modeler On the model, click Version -> Share Select CVS as provider Select the CVS location WebSphere Support Technical Exchange 11 of 42
Export Modeler preferences (CVS link) When doing a checkout from another Modeler instance, you need to configure the CVS connection again To avoid this, you can export the Modeler preferences and import it to the other Modeler instance Just do a File -> Export -> Preferences and export all defined preferences Import preferences in other Modeler instance, do a File -> Import -> Preferences of the saved preference file WebSphere Support Technical Exchange 12 of 42
Check out project from CVS Right click on Project Tree view and do a Version -> Check Out Project... Select the project WebSphere Support Technical Exchange 13 of 42
Modeler with ClearCase integration ClearCase Terminologie ClearCase view elements Configure ClearCase view in Modeler Checkout project from ClearCase Configure web views with ClearCase Remote Client (CCRC) WebSphere Support Technical Exchange 14 of 42
ClearCase Terminologie Element: File or directory element Version: Specific revision of an element: WebSphere Support Technical Exchange 15 of 42
ClearCase Terminologie (cont) Versioned object base (VOB) WebSphere Support Technical Exchange 16 of 42
ClearCase Terminologie (cont) ClearCase view WebSphere Support Technical Exchange 17 of 42
ClearCase server side setup In order to use ClearCase as source control system, you need to do some server side setup first 1) Create VOB 2) Create view (snapshot or dynamic view) 3) Mount VOB WebSphere Support Technical Exchange 18 of 42
ClearCase server side setup (cont) Create VOB Start Create VOB tool (clearvobtool) WebSphere Support Technical Exchange 19 of 42
ClearCase server side setup (cont) Use --none-- as administrative VOB WebSphere Support Technical Exchange 20 of 42
Create ClearCase dynamic view Start Rational ClearCase explorer (clearexplorer) Switch to Base ClearCase view and create a dynamic view like this: WebSphere Support Technical Exchange 21 of 42
ClearCase view elements WebSphere Support Technical Exchange 22 of 42
Configure Modeler to use CC view WebSphere Support Technical Exchange 23 of 42
Checkout project from ClearCase WebSphere Support Technical Exchange 24 of 42
Modeler and CC web-based views With Modeler V7 and ClearCase V7.1 or later, you can use web-based views To create a web-based view, you need to use the tool ClearCase Remote Client (CCRC) 1) Install CCRC on Modeler client machine 2) Start CCRC 3) Connect to CC (remote) server 4) Create web-based view 5) In Modeler, configure the web-based view WebSphere Support Technical Exchange 25 of 42
Web-based views Start CCRC Connect to ClearCase Server, use http://<cc_server>:12080/teamweb/services/ Team WebSphere Support Technical Exchange 26 of 42
Web-based views (cont) Create web-based view Select the ClearCase (remote) server to use WebSphere Support Technical Exchange 27 of 42
Web-based views (cont) WebSphere Support Technical Exchange 28 of 42
Configure Modeler with web-based view 1 3 2 WebSphere Support Technical Exchange 29 of 42
Checkout project from web-based view WebSphere Support Technical Exchange 30 of 42
Best practices Use short workspace path name and short names for all your artifacts (folders, processes, business objects, etc) since Windows has a limitation of 255 characters for file names Remember CVS file name restrictions (see link) Strategies for deleting elements (see link) What to do when an error occur? Workspace corruption issues Checkin/checkout issues Determine status of project WebSphere Support Technical Exchange 31 of 42
Workspace corruption issues When Modeler signals a severe error do the following: 1)Try to export your project as a.mar file 2)Exit Modeler and backup your whole workspace, including the.metadata directory 3)Restart Modeler in a new workspace 4)Configure CVS/CC link and checkout the project 5)Import exported.mar and use the Compare Merge editor and accept/reject your changes 6)Synchronize with CVS/CC and commit changes WebSphere Support Technical Exchange 32 of 42
Checkin/checkout issues Debug CVS issues Enable CVS console: Go to Preferences -> Team -> CVS -> Console and select Show CVS console automatically when command is run All CVS commands and their result will be displayed Check the.log and the WBModeler0.log file in your.metadata directory of your workspace for any error indication Follow the process mentioned in Workspace corruption issues WebSphere Support Technical Exchange 33 of 42
Checkin/checkout issues (cont) Debug ClearCase issues Check the server logs on you CC server Start ClearCase Administration Console (ccadminconsole) and check the server logs for any errors Check the.log and the WBModeler0.log file in your.metadata directory of your workspace for any error indication Follow the process mentioned in Workspace corruption issues WebSphere Support Technical Exchange 34 of 42
Status of project files Different icons displayed for status of element WebSphere Support Technical Exchange 35 of 42
Status of project files (cont) Collision on element WebSphere Support Technical Exchange 36 of 42
Status of project files (cont) WebSphere Support Technical Exchange 37 of 42
Helpful links Redbook ClearCase ClearCase 7.1 InfoCenter Rational Licensing Information Technote: How to configure WebSphere Business Modeler to use the Rational ClearCase V7.1 Web view Technote: WebSphere Business Modeler and Rational ClearCase Unified Change Management Technote: How to resolve CVS or ClearCase conflicts when working with WebSphere Business Modeler WebSphere Support Technical Exchange 38 of 42
Summary Modeler CVS integration Modeler ClearCase integration with Dynamic views Static views Web-based views Best practices Recommendations Trouble shooting Resolving conflicts WebSphere Support Technical Exchange 39 of 42
Additional WebSphere Product Resources Learn about upcoming WebSphere Support Technical Exchange webcasts, and access previously recorded presentations at: http://www.ibm.com/software/websphere/support/supp_tech.html Discover the latest trends in WebSphere Technology and implementation, participate in technically-focused briefings, webcasts and podcasts at: http://www.ibm.com/developerworks/websphere/community/ Join the Global WebSphere Community: http://www.websphereusergroup.org Access key product show-me demos and tutorials by visiting IBM Education Assistant: http://www.ibm.com/software/info/education/assistant View a webcast replay with step-by-step instructions for using the Service Request (SR) tool for submitting problems electronically: http://www.ibm.com/software/websphere/support/d2w.html Sign up to receive weekly technical My Notifications emails: http://www.ibm.com/software/support/einfo.html WebSphere Support Technical Exchange 40 of 42
We Want to Hear From You! Tell us about what you want to learn Suggestions for future topics Improvements and comments about our webcasts We want to hear everything you have to say! Please send your suggestions and comments to: wsehelp@us.ibm.com WebSphere Support Technical Exchange 41 of 42
Questions and Answers WebSphere Support Technical Exchange 42 of 42