Team Server Or Repository Configuration

Team Server is required to share AppPerfect projects across the team. AppPerfect provides support for Subversion(SVN) server for sharing projects across team. You need to download, install and configure SVN(Team) server manually.

For Windows/Linux/Mac OSX:
Please refer to following sections of document to download, install and configure SVN Server on your machine.

Once you have svn server installed and repository configured, you need to configure the AppPerfect client (AppPerfect Web Test / Load Test / App Test / Java Code Test / Java Unit Test / Java Profiler) so that client application can access the SVN server for sharing projects

Once you have AppPerfect client configured with SVN Server settings, you can access following features of SVN Server using File -> Repository menu from AppPerfect Client.

Manually Installing SVN Server

Get the latest version of SVN server binary as per your platform from http://subversion.tigris.org/project_packages.html. Follow the installation instructions for SVN server and install the server on the machine.

Manually Starting SVN Server

Once you have SVN server installed, we need to start same so that AppPerfect client application can access the same. To start SVN server, make SVN home as current directory and run the following command :
On windows svnserve -d --foreground --listen-port 8747 --listen-host localhost
On non-windows ./svnserve -d --foreground --listen-port 8747 --listen-host localhost

In case port 8747 is occupied, you can use any other free port.

Note : In case repository is created on different partition then the one from where server is started, then you need to start server with --root option. For eg., server is running from C:\ and you have SVN repository created on D:\ then start server using following commmand:
svnserve -d --foreground --root D:\ --listen-port 8747 --listen-host localhost

You can also use command line script files created in "svnserver" folder inside Test Manager home.

Manually Setting up Repository

Repository is the central location where all the projects and its revisions are stored and clients can access the same and synchronise the local copy of project with the one stored in the Repository, thus allowing multiple users in a SVN to share projects with each other. You need to follow following steps to set up a Repository

Creating SVN Repository

You can create a repository using following command :
On Windows:-
svnadmin create %REPOSITORY_PATH%
On Linux/Solris/Mac OSX:-
./svnadmin create $REPOSITORY_PATH
Where REPOSITORY_PATH is the path on local machine where the projects will be stored for sharing.
For example
On Windows
svnadmin create C:\AppPerfect\Repository
This will create Repository in folder "C:\AppPerfect". You will be required to provide path as /AppPerfect/Repository while configuring SVN Server in AppPerfect client applications.
On Linux/Solris/Mac OSX
/.svnadmin create /opt/AppPerfect/Repository
This will create Repository in folder "/opt/AppPerfect". You will be required to provide path as /opt/AppPerfect/Repository while configuring SVN Server in AppPerfect client applications.

Configuring SVN Repository

Once you have repository created, we need to configure it so that only authorised users can access it. To configure the repository we have a utility class com.appperfect.util.RepositoryConfigurationUpdater shipped inside apcommon.jar. Set classpath as shown below :
set CLASSPATH=%CLASSPATH%;%ENTERPRISESERVER_HOME%/tomcat/webapps/AppEnterpriseServer/WEB-INF/lib/apcommon.jar;

Once you have classpath set, run the following java command, make sure you have java binary in the PATH :
On Windows:-
java com.appperfect.util.RepositoryConfigurationUpdater %REPOSITORY_PATH% %SVN_USERNAME% %SVN_PASSWORD%

Note : REPOSITORY_PATH would be location where we created Repository, for ex, F:\AppRepository, Use back slash (\) as path separator and not forward slash.

On Linux/Solris/Mac OSX:-
java com.appperfect.util.RepositoryConfigurationUpdater $REPOSITORY_PATH $SVN_USERNAME $SVN_PASSWORD

where REPOSITORY_PATH would be location where we created Repository, for ex, F:\AppRepository
SVN_USERNAME is the user who can access the Repository, for example, admin
SVN_PASSWORD is the password required to access the Repository, for example, admin

Configuring AppPerfect client application to access SVN Server

Once you have repository setup you can access the same from AppPerfect products, You just need to provide the SVN configuration settings to AppPerfect client. Start the AppPerfect Product (AppPerfect Web Test / Load Test / App Test / Java Code Test / Java Unit Test / Java Profiler) and go to Tools -> Options -> Server Connection and Configure the Repository Settings. Provide the Machine IP/Host Name (where you have installed the SVN server), Port, Repository path and user details as per the settings you configured in earlier steps.

Note : If repository is created at C:\AppPerfect\EnterpriseServer\AppRepository then connection url will be of form : svn://127.0.0.1:8747/AppPerfect/EnterpriseServer/AppRepository.
OR
If repository is created at /opt/AppPerfect/EnterpriseServer/AppRepository then connection url will be of form : svn://127.0.0.1:8747/opt/AppPerfect/EnterpriseServer/AppRepository.
So you need to provide the complete path for the repository here.

Now you can share, synchronise, commit, update projects/workspace to the AppPerfect repository. Check out File -> Repository menu for the functionalities you can perform from AppPerfect client.

Checkout Projects

Using AppPerfect Client you can checkout projects on your local machine from SVN repository using File -> Repository -> Checkout Project... option. It will launch the checkout wizard, select the project you need to check out on local machine and follow the instructions in checkout wizard.

Synchronize Workspace

Using AppPerfect Client you can synchronize local copies of all projects in the workspace with the projects stored in SVN repository using File -> Repository -> Synchronize Workspace... option. It will launch the Syncrhonize dialog, you can compare the local changes with the one stored in repository and take appropriate action to commit or update.

Share Project

Using AppPerfect Client you can share local copy of the project with SVN repository using File -> Repository -> Share Current Project... option. For performing any commit or synchronize action you need to share the project first.

Synchronize Project

Using AppPerfect Client you can synchronize local copy of currently opened project with the project stored in SVN repository using File -> Repository -> Synchronize Current Project... option. It will launch the Syncrhonize dialog, you can compare the local changes with the one stored in repository and take appropriate action to commit or update.

Synchronize Rules

Using AppPerfect Java Code Test, you can synchronize local copy of system settings with the settings stored in SVN repository using File -> Repository -> Synchronize Rules... option. It will launch the Syncrhonize dialog, you can compare the local changes with the one stored in repository and take appropriate action to commit or update.