SVN has been integrated to ZenTao 2.2+, which links ZenTao and codes, and makes it convenient for users to view codes. The followings will show you how to integrate SVN in ZenTao.

1. Subversion integration

The basic mechanism for Subversion integration is to

Analyze code comments submitted => Get linked  task, and bug IDs => Write IDs to ZenTao database.

Users have two ways to do it. One is to use the hook built-in SVN. When the code is committed, a hook script is triggered. It will analyze the comments and get the IDs of the linked tasks, and bugs, and then call ZenTao API and record it in the database. The other way is to use LOG command at SVN client to get all the committed code and analyzes it to get the IDs, and then save it in the database.

Either way has its pros and cons. The second way is used in ZenTao because it is easier to debug and more convenient to deploy. Besides, it can also analyze all the previous records with more flexibility.

2. Deploy SVN command-line client on machines installed ZenTao

SVN command lines are to commands built-in SVN. It is svn.exe in Windows and svn in Linux. The machine that ZenTao is installed can be independent of that one SVN is installed. They don’t have to be installed on the same machine.

2.1 Install svn for Linux machines. Subversion can be installed for rhel and centos via yum, and apt-get in Debian.
2.2 The latest Windows one-click installation package has built-in svn.ex e in the directory of  \xampp\silksvn . 

2.3 If you install SVN in Windows, download slilksvn and then install it.

3. Configure SVN in ZenTao

Since ZenTao 12.1, the best way to configure SVN is: Login as Admin, and go to CI - Repo - Create to configure your SVN repository. ( That you should refer to the manual "Integrate Jenkins", https://www.zentao.pm/book/zentaomanual/scrum-tool-with-jenkins-integration-258.html ) And You just need to look over Step 1. Create a repo in there. 

After your configuration of SVN successfully, you should jump to Step 4. Comment

3.1 Code

The configuration file of SVN is saved in zentao/module/svn/config.php. You can modify it and save the modified to svn/ext/config/svn.php. So later it will not be overridden, if updated.

3.2 Configuration

As for setting subversion parameters, there are concepts involved as follows.Parameters below are involved in configuring SVN.

• the SVN client
  
• repo: multiple repos can be set.
• Username and parameters of the repo

Now let’s explain this with an example.

3.2.1 Find the labeled with a red box in the image below

3.2.2 Modify the code

Modify codes as shown below.

$config->svn->client   save svn.exe, the client executable files

$config->svn->repos[$i]['path']  the path to save SVN code
$config->svn->repos[$i]['username']   save SVN login user name; Leave it blank if you don’t need to log in.
$config->svn->repos[$i]['password']   save SVN login password

3.3 Set multiple repos
3.3.1 Find the following code in the same file.

3.3.2 Modify the codes

• Delete “/*”and”*/“ from the code and modify it as mentioned above. Notes: $i ++ cannot be changed.
• For any svn repos, copy the code and configure it in the same way.

4. Comment

When committing codes to SVN, developers need to specify relevant stories, tasks or bug IDs of changes in the comments. Please follow the format below.

• bug#123,234, 1234 or bug: 123,234 1234; comma or space can be used as space holders among IDs; 
• task#123.
• bugs and tasks must be labeled.

5. Synchronize SVN

5.1 Refer to 8.1.1 Initialize Scripts to initialize all the scripts of command lines.
5.2 Enter  zentao/bin/ and execute syncsvn.bat or syncsvn.sh.

5.3 The execution is shown below.

5.4 Check the linked bugs in ZenTao

5.5  FAQ

The following problems are often seen in source code installation.

Run the script to synchronize SVN, and the error is shown

Run the command as shown in the notice manually, and the excution is done.

Solutions: In php.ini, cancel shell_exec() of disable_functions. Restart php-fpm and WebSever.

6. Deploy the cron

When all the commands are deployed, add the commands to the cron. For example, execute the tasks every 5 minutes.

Solution 1: Login ZenTao in the browser. Go to Admin->Cron and switch it on. Click Activate to synchronize SVN scripts. After you change the parameter, follow the steps below: Go to Admin->Cron and click Cancel=> Restart Apache=> Go to Admin->Cron and click Start.

Solution 2: Use the cron feature in your system. Go to Control Panel->Cron in Windows or use crontab in Linux.

7. Notes

It is not recommended use to https or ssh, because it involves verification and integration for https and ssh certificates, which can be quite complicated.

It is complicated to configure SVN. If you cannot do it yourself, think about our service and contact us at [email protected] to know more about technical support =)