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
13. Install CVS connectors
• Select under Collaboration tools the CVS
connectors
• To get all the depending connectors, click the
button ‘Select Required’
• 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