1. Integrate Domino Designer with
CVS Source Control
Frank van der Linden

2. Agenda
• Introduction
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

3. Who is Frank van der Linden
• I live in Utrecht in the Netherlands.
• My role is XPages/Domino/Web
developer at e-office since 2000. So
I started with Lotus Notes 4.5.x.
• I develop XPages application since
the introduction of XPages in Lotus
Notes 8.5.0.
• In my spare time I do a lot of
running and then I mean a lot.
• And I am married and have 2
daughters

4. And he works at e-office
• Celebrated in 2011 it’s 20th
anniversary
• First Lotus Business Partner
in the Netherlands
• E-office is IBM Premier
Business Partner, Microsoft
Gold Partner and RIM
Alliance Elite partner

5. • Introduction
Agenda
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

6. What is Source Control
• management of changes to
collections of information
• revision control became much more
important, and complicated, when
the era of computing began
Source:http://en.wikipedia.org/wiki/Revision_control

7. Source Control systems
• CVS
• Subversion
• Mercurial
• Git
• And many more, see...
http://en.wikipedia.org/wiki/List_of_revision_
control_software

8. Source Control and Domino
Designer
• Compatible with Lotus Notes 8.5.3 and higher
• The Standard Configuration, the eclipse based
version

9. • Introduction
Agenda
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

10. Install CVS connectors
• Goto install in the Domino Designer

11. Install CVS connectors
• Specify the Ganymede update site
• Add Remote location
• Url is http://download.eclipse.org/releases/ganymede/
• Click Finish

12. Install CVS connectors
• Select the required mirror site or leave it as is.
• Click OK

13. Install CVS connectors
• Select under Collaboration tools the CVS
connectors
• To get all the depending connectors, click the
button ‘Select Required’
• Click Next.

14. Install CVS connectors
• You need to accept the license of the
connectors
• Click Next

15. Install CVS connectors
• You get an overview of all the plugins to be
installed
• Click Finish
• The connectors are being installed, can take
some time
• Restart Lotus Notes

16. • Introduction
Agenda
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

17. Set up connection to CVS
• Open the CVS Repository Exploring
perspective
• To be found Window --> Open perspective -->
Other

18. Set up connection to CVS
• Click CVS icon on top of perspective
• In the popup add the host and respository
path of Source Control (CVS)
• If Authentication is required, provide User and
Password.
• Click Finish

19. Set up connection to CVS
• If connections is correct, the root of the
Source Control System will be displayed.

20. • Introduction
Agenda
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

21. Connect the database to Source
Control
• Create a on-disk project
• Right click on project name in Domino
Designer Perspective
• Select Team Development --> Set Up Source
Control for this application

22. Connect the database to Source
Control
• You will get an Helper panel, with some
information about the setup.
• If you don’t want this in the future, tick the
checkbox at the bottom

23. Connect the database to Source
Control
• Fill in the project name
• Use default location in the dataworkspace
directory or specify a custom location to store
the on-disk project.

24. Connect the database to Source
Control
• Open the Navigator view, Window --> Show
Eclipse Views
• There is the new on-disk project

25. Connect the database to Source
Control
• Next share the on-disk
project with Source
Control
• Right mouse click and
select Team-->Share
project

26. Connect the database to Source
Control
• Select the Respository type, CVS
• Click Next

27. Connect the database to Source
Control
• Use the newly created repository location
• Or create a new one
• Click Next

28. Connect the database to Source
Control
• Select the location on the Source Control
server
• Let Check box ‘Use project.....’ selected.
• Click Next

29. Connect the database to Source
Control
• An overview will be presented of all the
design elements who will be committed
• Leave the ‘Launch the Commit wizard’
checkbox selected.
• Click Next

30. Connect the database to Source
Control
• Commit the files.
• Enter comment for the
Commit operation
• This should be a meaning full
description of this commit
operation.
• Click Finish and the commit
operation will directly start.

31. Connect the database to Source
Control
• In the CVS Repository exploring perspective
you can see if everything went well.

32. • Introduction
Agenda
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

33. Submit new changes to Source Control
• Make changes to the
database.
• Right mouse click
• Select --> Team
Development -->
Sync with On-Disk
project

34. Submit new changes to Source Control
• Open the Navigator view, Window --> Show
Eclipse Views
• The arrow before the On-Disk Project
indicates there are changes to commit

35. Submit new changes to Source Control
• Right mouse click on project
• Select Team --> Synchronize with Repository

36. Submit new changes to Source Control
• A warning of switching perspectives will be
presented
• If don’t want this warning in the future, select
the checkbox ‘Remember my decision’

37. Submit new changes to Source Control
• The Team Synchronizing perspective opens.
• It gives an overview of all the changes.
• Right click on project name and select
‘Commit’

38. Submit new changes to Source Control
• The commit window will popup, to give a
meaningfull description of this commit
operation.
• Click Finish

39. Submit new changes to Source Control
• After Commit operation, the changes has
disapperead from the perspective

40. • Introduction
Agenda
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

41. Get data out Source Control
• Open the CVS Repository perspective
• Right click the project
• Check Out as..

42. Get data out Source Control
• It will be associated to on On-Disk Project
• If there is no On-Disk Project you can also
choose the New Project Wizard.
• Click Finish

43. Get data out Source Control
• If existing On-Disk project, there will be a
warning about overwriting the On-Disk
Project
• Choose Yes or No

44. Get data out Source Control
• Switch back to the
Domino Designer
perspective
• Right click on the
database
• Select --> Team
Development -->
Associate with Existing
On-disk project

45. Get data out Source Control
• Select the On-Disk project to associate the
database with.
• Click Finish

46. Get data out Source Control
• All the design elements are loaded in a new
database.

47. • Introduction
Agenda
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

48. Beyond the basics - branches
• Create a branch of the project
• For example with customer specific design
elements
• Sync database with On-Disk Project

49. Beyond the basics - branches
• Switch to the Navigator perspective
• Right click project
• Select Team → Branch

50. Beyond the basics - branches
• Fill in a Branch Name
• And a Version Name
• Click OK

51. Beyond the basics - branches
• In the CVS Repository
perspective the branch
has been created
• The new changes are
not present yet

52. Beyond the basics - branches
• Switch to the Team Synchronizing perspective
• Commit the new changes to the branch, by
right click the project name

53. Beyond the basics - branches
• Comment the commit operation
• Click Finish

54. Beyond the basics - merging
• Branches can also be merged together
• Right mouse --> Team --> Merge

55. Beyond the basics - merging
• Branches can also be merged together
• Right mouse --> Team --> Merge

56. Beyond the basics - merging
• The Synchornize perspective will open
• It shows the modification who will commit to
the base.

57. Beyond the basics - merging
• Right click --> Merge
• Two branches will be merged together

58. Beyond the basics – other actions
• Tag as Version
• Can switch to a other version or branch

59. • Introduction
Agenda
• What is Source Control
• Install CVS connectors
• Setup connection to CVS
• Connect the database to Source Control
• Submit new changes to Source Control
• Get data out Source Control
• Beyond the basics
• Usefull links

60. Usefull links
• CVS help
– http://help.eclipse.org/helios/index.jsp?topic=
%2Forg.eclipse.platform.doc.user%2Ftasks%2Ftasks-100b.htm

61. Twitter: @flinden68
Blog: http://www.domino-
weblog.nl/
E-mail: fli@e-office.com

62. Grazie agli sponsor per aver reso possibile i
Dominopoint Days 2012!
Main Sponsor
Vad sponsor
Platinum sponsor
Gold sponsor