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
S o u r c e : h t t p : / / e n . w ik ip e d ia . o r g / w ik i/ R e v is io n _ c o n t r o l

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.d

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