Version control in practice - DiVetro

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

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

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

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?

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

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