VisualSVN set-up guide

Installing the VisualSVN server


STEP 1: Download the standard edition of VisualSVN server from http://www.visualsvn.com/server/download/. Its free and it is supported by articy:draft

STEP 2: Install it on any Windows PC that can be reached from all computers running articy:draft. We recommend the same machine that also runs the articy:server.

STEP 3: Choose VisualSVN Server and Management Console 1



STEP 4: Choose a server port and write it down. You need this port number later when creating or importing an articy:draft project. If the port is already in use by another program or service, just pick another one from the drop down list.

STEP 5: Select a proper path for Repositories 1. This is the location where the data files are stored. It should be on a local drive of the machine. Do not use mapped or network drives!

STEP 6: Choose Use Windows authentication 2
 
Step 21 deals with how to handle Subversion authentication.




STEP 7: Open the VisualSVN Server Manager

STEP 8: Copy the Server URL of the VisualSVN Server into the clipboard or write the URL down. In the screenshot below the highlighted server URL is https://PC-007.nevigo.zz/svn 1. You need this URL later when creating or importing an articy:draft project.

STEP 9: Create a new repository by right-clicking Repositories 2 in the tree view on the left hand side and choose Create New Repository. A dialog box asks for a pository name. Choose any name (e.g. ArticyProjects). You also need this repository name for creating/importing projects so write it down too!



Create a new articy multi-user project



STEP 10: Start articy:draft

STEP 11: Connect to articy:server

STEP 12: Login with your articy user credentials as they were created by the articy:server admin

STEP 13: Click button Create new project on the bottom of the projects list

STEP 14: Switch to the Source control page of the create new project assistant.

STEP 15: Change source control type from Perforce provider 1 to Subversion 1.6/1.7

STEP 16: Enter https://MyServerURL:MyPort/svn/MyRepositoryName in the field Repository-URL (internal) 2
  • "MyServerURL" is the server name you copied in step 8
  • "MyPort" is the port number you copied in step 4
  • "MyRepositoryName" is the name you have entered in step 9

STEP 17: In this example the full repository URL is https://PC-007.nevigo.zz:443/svn/ArticyProjects

STEP 18: Enter any name in the field Repository-path 3. While you are free to choose any name, it makes sense to use the same name as the articy project itself for a better allocation. In this example the name choosen is MyProject.

STEP 19: Fill-out the remaining project details and click the Finish button 4.



STEP 20: Finally you are asked to authenticate with the SVN server.



STEP 21: As you have chosen Use Windows authentication in step 6, this is the same user account you use when starting Windows. Enter your username and password and confirm. If Windows authentication is not working for some reasons, you might want to change the authentication type of VisualSVN to Subversion authentication.



In order to do this,
  • Open the VisualSVN Server Manager like shown in step 7
  • Click on the link Configure authentication options... in the right side of the VisualSVN Server Manager window
  • Switch to Use Subversion authentication 1 and confirm by pressing OK
  • Click on the link Create new user... and fill out user name and password. Confirm by pressing OK
  • Now you are able to use this SVN user account in step 20

STEP 22: The project is created and automatically stored into the VisualSVN repository.