Subversion (SVN) Administration

Before your team can collaborate on ReqView projects managed in SVN as described in Team Collaboration > Subversion you should install SVN on your computer, set up an SVN repository and import the projects into SVN.

Install SVN

You can download SVN command line tools for your platform from Apache Subversion page. It is also bundled with many popular SVN GUI clients, such as Tortoise SVN for Windows after enabling command line client tools install option.

You can verify if the installation was successful by the following command:

$ svn --version

If svn command is not found, make sure that Subversion executable binary is present in the system or the user environment variable PATH.

Set up SVN Local Repository

You can simply install an SVN repository on your PC in a few steps:

1. Create a parent directory C:\SVN where you will place your SVN repositories (Windows example):

   $ mkdir C:\SVN
   

2. Create a new repository ReqView under C:\SVN:

   $ svnadmin create C:\SVN\ReqView
   

More information is described in Apache Subversion: Quick Start > Setting up a local repository. For production use, your network administrator should set up a remote SVN repository for your ReqView projects on your intranet or in cloud. For more information see SVN Book > Choosing a Server Configuration.

SVN repositories can be very flexibly structured into sub-folders to manage your project(s). You can choose if you want to store a single project or multiple projects in the repository, see Recommended Repository Layout.

Single-project SVN repositories have typically trunk, branches, and tags sub-folders at the top level to store the main branch, development branches and baselines. Multi-project SVN repositories are typically structured into sub-folders by projects at the top level and each project then have the same structure as described for single-project SVN repositories.

Import Project to SVN

You can import your ReqView Project Folder into a single-project SVN repository as follows:

1. Create a new project folder <reqview_project> storing the working copy of your project in your local file system. Feel free to choose your custom name for the project.
2. Create empty <reqview_project>/trunk and <reqview_project>/tags subfolders. Because ReqView only works with a single branch, we do not need to create branches subfolder.
3. In ReqView, open your project and save it to <reqview_project>/trunk by File > Save as Folder. The working copy of your ReqView project should have the following structure:

   <reqview_project>
   ├───tags
   └───trunk
       ├───attachments
       └───documents
   

4. Open command line from the working copy <reqview_project>, and then import the project to SVN repository by svn import command:

   $ svn import file:///C:/SVN/ReqView -m "Initial import of ReqView project"