1.
Utrecht 27 September 2018
Dennis Geluk
Version control in practice

2.
www.divetro.nl
Who is who?
• Dennis Geluk
28/09/2018 Workshop version control in practice 6
Participants
• Experience with EA in general
and version control in
particular?
• Personal goals for this
workshop?

3.
www.divetro.nl
Backlog
28/09/2018 Workshop version control in practice 7
DoneTo do In Progress
Version control
principles
Introduction
SQL Server
configuration –
General
SVN
configuration –
General
SQL Server
configuration –
General
Configuration
management
Configuration
management
Advanced topics
(SVN)
SVN
configuration –
General
Advanced topics
(SVN)

4.
www.divetro.nl
General
28/09/2018 Workshop version control in practice 8

5.
www.divetro.nl
Backlog
28/09/2018 Workshop version control in practice 9
DoneTo do In Progress
Introduction
SQL Server
configuration –
General
SVN
configuration –
General
SQL Server
configuration –
General
Configuration
management
Configuration
management
Advanced topics
(SVN)
SVN
configuration –
General
Advanced topics
(SVN)
Version control
principles

6.
www.divetro.nl
Why
28/09/2018 Workshop version control in practice 10
2. Configuration management1. Multiple users (at different
locations) sharing the same
model

7.
www.divetro.nl
Why
28/09/2018 Workshop version control in practice 11
• Historical information of model
• Historical information of part(s)
of the model
• Alignment with other
deliverables
• Multiple users (disciplines)
• Re-use knowledge
• Personal sandbox

8.
www.divetro.nl
Most common configurations
28/09/2018 Workshop version control in practice 14
1. Out of the box
2. DBMS
3. Version control repository
4. Combination of DBMS and version control repository

9.
www.divetro.nl
Backlog
28/09/2018 Workshop version control in practice 15
DoneTo do In Progress
Version control
principles
Introduction
SQL Server
configuration –
General
SVN
configuration –
General
SQL Server
configuration –
General
Configuration
management
Configuration
management
Advanced topics
(SVN)
SVN
configuration –
General
Advanced topics
(SVN)

10.
www.divetro.nl
DBMS
28/09/2018 Workshop version control in practice 16
EAP
EAP
EAP

11.
www.divetro.nl
DBMS
28/09/2018 Workshop version control in practice 17
Characteristics
• EAP file is transferred to DBMS
tables
• All users use the same EAP
• DBMS locking on “row” level
DBMS
EAP

12.
www.divetro.nl
01 Getting started (SQL Server)
• Create a SQL Server connection (EA Workshop)
• Open the model
• In duo’s - figure out how the configuration works
• Locks?
• Refresh?
• Etc…
28/09/2018 Workshop version control in practice 18
15- 20 minutes

13.
www.divetro.nl
Backlog
28/09/2018 Workshop version control in practice 19
DoneTo do In Progress
Version control
principles
Introduction
SQL Server
configuration –
General
SVN
configuration –
General
SQL Server
configuration –
General
Configuration
management
Configuration
management
Advanced topics
(SVN)
SVN
configuration –
General
Advanced topics
(SVN)

14.
www.divetro.nl
Version control repository
28/09/2018 Workshop version control in practice 20
EAP
EAP
EAP

15.
www.divetro.nl
Version control repository
28/09/2018 Workshop version control in practice 21
Characteristics
• Model content divided into
separate files
• Files are transferred to VC
Repository
• All users use private EAP
• VC locking on “package” level
• VC configuration management
VC Repo
EA “meta data” &
Model structure
EAP
EAP
EAP

16.
www.divetro.nl
02 Getting started (Subversion)
General setup
• Install Tortoise SVN (Subversion
client)
• Create Workfolder
• Update/Checkout
Enterprise Architect setup
• Create EAP
• Setup Version control setting
• Create package
• Save package under Version control
28/09/2018 Workshop version control in practice 22
30 minutes
In duo’s - figure out how the
configuration works
• Locks?
• Refresh?
• Etc…

17.
www.divetro.nl
SQL Server SVN
Multiple users (disciplines)
Re-use knowledge
Personal sandbox
Historical information (Model)
Historical information (Parts)
Alignment other deliverables
Evaluation
28/09/2018 Workshop version control in practice 23
Not
supported
Well
supported

18.
www.divetro.nl
Backlog
28/09/2018 Workshop version control in practice 24
DoneTo do In Progress
Version control
principles
Introduction
SQL Server
configuration –
General
SVN
configuration –
General
SQL Server
configuration –
General
Configuration
management
Configuration
management
Advanced topics
(SVN)
SVN
configuration –
General
Advanced topics
(SVN)

19.
www.divetro.nl
Configuration management (Package Control )
• Get All Latest: update all local information
(working folder) with server version
• Get Latest: update local information (working
folder) of one package with server version
• Check Out: lock server version (package) for write
updates
• Check In: upload local (changed) version of
package to server and unlock the package
• Undo Check Out: delete local (changed) version of
package and return to latest server version of
package
28/09/2018 Workshop version control in practice 25

20.
www.divetro.nl
Configuration management (Package Control )
• Re-sync Status With VC Provider: update (local)
status of all packages to server status
28/09/2018 Workshop version control in practice 26

21.
www.divetro.nl
Configuration management (Package Control )
• Check Out Branch: Check Out multiple packages
• Root package and all underlying packages are locked
• Do you actually need all these packages?
• Add Branch to Version Control: Add multiple
packages to version control
• Destination location of packages is not configurable
• Naming convention of packages is not configurable
28/09/2018 Workshop version control in practice 27

22.
www.divetro.nl
03 Configuration management
SQL Server
• Explore lock (Diagram) principle
28/09/2018 Workshop version control in practice 28
45 minutes
SVN
• Explore (standard) configuration
management options
• Get(All)Latest
• Check Out
• Check In
• Undo Check Out
• Delete a package from the model
• What’s the result in SVN?

23.
www.divetro.nl
SQL Server SVN
Multiple users (disciplines)
Re-use knowledge
Personal sandbox
Historical information (Model)
Historical information (Parts)
Alignment other deliverables
Evaluation
28/09/2018 Workshop version control in practice 29
Not
supported
Well
supported

24.
www.divetro.nl
Backlog
28/09/2018 Workshop version control in practice 30
DoneTo do In Progress
Version control
principles
Introduction
SQL Server
configuration –
General
SVN
configuration –
General
SQL Server
configuration –
General
Configuration
management
Configuration
management
Advanced topics
(SVN)
SVN
configuration –
General
Advanced topics
(SVN)

25.
www.divetro.nl
Advanced topics (Package Control )
• File History: Overview in (change) history of the
package
• Comments are depended on discipline
• View (revert to) previous version of package
• Get Package: Import (re-use) a package from the
server version into a model
• The package can be part of more than one model
• Only one package (file) on the server
28/09/2018 Workshop version control in practice 31

26.
www.divetro.nl
04 Advanced topics (SVN)
• Explore the History option
Re-use a package
• Create new EAP
• Setup new Version control setting
• Create package
• Save package under Version control
• Import existing package to new model by reusing old
Version control setting
28/09/2018 Workshop version control in practice 32
30 minutes

27.
www.divetro.nl
SQL Server SVN
Multiple users (disciplines)
Re-use knowledge
Personal sandbox
Historical information (Model)
Historical information (Parts)
Alignment other deliverables
Evaluation
28/09/2018 Workshop version control in practice 33
Not
supported
Well
supported

28.
www.divetro.nl
Advanced topics - Security
Security
• Not connected to any version
control
• Provides authorization
• User credentials
• Locking mechanism (package /
model)
• Can be combined with
network authorization
28/09/2018 Workshop version control in practice 34

29.
www.divetro.nl
Take away
3528/09/2018 Workshop version control in practice

30.
Dennis Geluk
dennis.geluk@divetro.nl
+31 (0)6 13 476 892
+31 (0)88 000 5400
www.divetro.nl
Hoofdstraat 20A| 3972LA Driebergen-Rijsenburg
28/09/2018Workshop version control in practice 41