Reference

The reference section runs through all of uberSVN's screens and explain what everything does. Some screens, relating to the administration of uberSVN may not be visible to you if your login account doesn't have system admin privileges.

1. Welcome

Create Replication Group 01

Login to the uberSVN portal.

The welcome screen features the login entry box. Enter a username and password.

1.1 Status bar

Status Bar

The top of the uberSVN screen features some key elements of functionality.

Once logged in, there's a link "My Profile" to your account profile screen in the Users section. There's a help link, that leads to the online admin guide (that you're currently reading), and a link to the support page on the ubersvn.com website. whenever there's a system change, an alert window will appear at the top of the screen with a note to what has changed.


Status Bar

At the bottom of uberSVN's frame is an indicator of which update channel is currently set. Click on the indicator to go to the Update settings. Read more about the update channels under Update Settings.

Most of uberSVN's features are available within the section tabs. The next section of this guide runs through each tab, explaining what functionality it covers.

2. Dashboard

The dashboard shows the state of the uberSVN deployment. The main panel features the activity stream where comments from uberSVN users and repository activity is displayed. Other panels show the server's status, a twitter based news feed and some Quick Links to popular features that appear deeper within the uberSVN portal.

Create Replication Group 01

uberSVN starts at the dash.

3. Repositories

The Repositories is the very heart of uberSVN, it's where the Subversion repositories are added or modified.

uberSVN Repositor

Repository list screen.

The main Repositories screen lists all the Subversion Repositories that are currently running under uberSVN. Repositories that have been added, but then subsequently deleted from uberSVN will not appear on the list, even though they may remain installed on the server.

ADD
Click ADD to add a new repository (either created from scratch or imported).
FILTER:
A search entry box to search for a particular repository, useful if you are running a lot of repositories.
Latest
Repositories listed in order of creation.
Favorites (tab)
A list of repositories tagged as your favourites.
uberSVN Repositor - Add

Make a repository a favourite to give it top billing on the repositories screen.

Repository Widgets
Widgets give you one-click control over the repository:
Click the COPY (Configure Widget) to make a copy of the repository.
Click the"Magnifying glass" (Configure Widget) to view the repository through the repository browser.
Click the "i" (Configure Widget) to view/edit the repository details. Clicking this widget has the same effect as clicking the repository's name.
Click "Star" (Configure Widget) to add the repository to your favourites. Click the star to turn it solid, indicating that it is a favourite.
The repository will be added to the Favourites tab until the star is clicked again, which will remove the favourite status.

3.1 Add Repository

uberSVN Repositor - Add

Add New Repository: General Settings

Repository Name
A name for the repository. You can change it later.
** Alert! **Repository Naming Rules:
The following restrictions apply to the naming of repositories:

  • Limited to 25 characters.
  • colons (:), spaces, double forward slashes (//) are not permitted. Single forward slashes (/) are allowed, but not as the first character.
  • On Windows systems, the usual Windows restrictions apply with the following characters not permitted: -?*<>|
  • While names that contain multi-byte characters are permitted they are not recommended. Multi-byte characters are not supported by the repository browser, and may result in other problems.
Location
The directory name for the repository that will appear at the end of the URL. Simple is best, use only lower case letters and numbers with no spaces. Choose carefully, the location can't be changed later.
URL
Shows the repository URL including your chosen DAV Location. This is the URL that you will use to access the repository on the web.

Click Next to move to the next part of the setup.

uberSVN Repositor - Add

Add New Repository: new repository

Create new repository
Create a new repository, tick the checkbox to also create trunk, branches and tags directories. Read more about Subversion's recommended directory structure.
uberSVN Repositor - Add

Add New Repository: Created from scratch

Import from dump file
Select Import from dump file to import the dump file from an already existing repository. The dump file must be less than 250MB.
uberSVN Repositor - Add

Add New Repository: Import from upload dump file

Import from a dump file located on the server
If there's a dump file located on the server it can be imported. There's no size limit if the file is imported from the server itself.
uberSVN Repositor - Add

Add New Repository: Import from dump file located on the server

Add an existing repository from the server
If there's a repository already set up on the server (independently from uberSVN) it can be imported. Once imported, a repository comes under full control of uberSVN.

** Alert! **Alert
Existing repositories that are added to uberSVN become new repositories, losing all their revision history.

Copying an existing repository and keeping its revision history
1. Create a new blank repository in uberSVN, with the same name as your current repository.
2. Delete the new repository from the file system.
3. Create a hotcopy of your existing repository and move it into the file location where you had deleted the new uberSVN repository.
4. uberSVN will now treat the hotcopy as a 'live' repository with its revision history intact.

uberSVN Repositor - Add

Add New Repository: Import from dump file located on the server.

Click DONE to complete the repository creation. Clicking CANCEL will return you to the repository list screen without saving any changes.

Permissions

uberSVN Repositor - Add

Add New Repository: Permissions

Once you're done adding the repository you'll automatically be taken to the new repositories Permissions tab in order to set up access rules. Changes made to repository permissions are made instantly, there's no need to submit changes - for this reason, take care when making changes.

Permissions can be controlled by uberSVN (uberSVN Internally Managed) or through an externally controlled Authorization file (User Alternative Authz File).

An external AuthZ file can be set up on a per repository basis, its location is set on the Administration tab of the Repository.

ADD
Enter the name of a user or a team that you wish to wish to provide with access to the new repository. As you type, uberSVN will list all the names that match the letters you enter.

** Alert! **Alert
By default all repositories are created with Read & Write permissions assigned to the "Everyone" group. As you add specific permissions to individual users and the teams that you create, you may wish to delete the Everyone team permissions, or downgrade them to Read only.

Create New User
Use this link if you want to add a user to this repository that isn't already present in uberSVN.
Create New Team
Use this link if you want to associate a team to this repository that isn't already present in uberSVN.

3.2 Repository tab

If you click on a repository, you'll be taken to the repository tab where the repositories can be edited or managed.

tip"Tip
It's possible to deep link to, or bookmark an individual repository screen.
http://xx.xx.xx.xx:9890/ubersvn/views/platform/repository/repositoryProfile.jsf?repoId=<Repository Number>

Repository tab

View repository details.

url
The fully qualified web address of the repository. This is the same address that users will use to access the repository from their Subversion clients.
Activity Tab
All system activity / user comments will be tracked on the activity tab.
Users
The Users tab shows all users who currently have permission to use access the repository. If you have system admin or team privileges then you can remove a user by clicking on the cross. View Repository Graph

Click the cross to remove a team member or time itself.

To add or update go to the list from the Permissions tab.
Teams
The Teams tab lists all the teams that are associated with the repository.

3.3 Graph

View Repository Graph

View repository activity in the form of a graph.

The graph plots the change in size of the repository over the previous 2 hours and 20 minutes. The graph updates every 30 minutes, or whenever the uberSVN service is restarted.

3.4 Browse

View Repository Browser

View repositories, through the integrated Subversion Repository Browser.

The repository browser provides a web interface to help manage repository files and directories. There is a list of all the file changes, adds or deletions in any given revision.

uberSVN has a built-in repository browser that makes it easier to keep track of repository changes. This section runs through what you can do with the browser.

tip"Tip
If you run into problems when using the repository browser, check the current Repository Browser Known Problems.

3.4.1 Repository Browser Guide

** Alert! **Known Problem (Windows only)
The repository browser currently doesn't work with repositories that use LDAP for user authentication.
We're looking to fix the problem, although our long term strategy is to bring in a replacement repository browser.

Login

Click on the browser tab and you'll see a login screen. This login is for access to Subversion itself, not uberSVN. You'll need to use an account that has permission to access the repository. Installation 01

Repository authentication required.

Main Repository Browser Screen


actions show recent changes filter show file extensions locked revision toggle drag

The main repository browser screen.

View file

From the repository browser you can view details about any files that are contained in the repository by clicking on the file's name.

Click on a file to view its details

To view file details, click on the name.

The file details screen will display the contents of the file, unless it is in binary format.

file details

File details screen.

There are some additional screens that offer specific details concerning the view being viewed.

Show log
View all revisions of the file, along with who made the change, what message they associated with the change. Optionally you can also view the type of change made, the file name and relative path.
Show Log

File details screen.

Download
You can download the file to view locally. Just remember that changes made to the file won't be picked up unless you first copy it to the local copy and commit the changes.

tip"Caution
When downloading very large files, ensure that you have enough system memory to store them. There's a problem with downloading large files through the repository browser, which doesn't check that there's enough system memory to store the file. Downloading a file that is larger than the server's remaining RAM will cause the system to stop working or crash.


Blame
From the name of this rather useful tool you might think that Subversion's developers are used to living in a "blame culture". In fact, it's just really useful to be able to identify exactly who made a particular change to a file, especially when a file has been touched by a lot of people.

Blame shows each line of the file along with which user last changed that line and in which revision the change was made.
Installation 01

Blame neo for revision 6 changes.

Show raw
View a raw version of the file renders the file without any adornment, ideal for copying out code.
Installation 01

Raw.

Diff to previous
Offers a comparison view of the file, useful if you need to review changes that have been made to a file. There's an option to Toggle line wrap, which forces the file to display within the window.

Installation 01 There are two drop-down boxes offering additional options:


Layout
Change the way that compared files are displayed. Unified shows only the changed elements, Inline shows the file with the changed lines both in the before and after state, Side By Side, as the name suggests, shows the two revisions together for side by side comparison.
Installation 01
Character format
There's an exhaustive list of available character encoding types, so that any character rendering problems can be fixed by selecting the matching encoding type.

3.5 Administration

View Repository Admin 01

Administer the repository though the admin tab.

Repository Name
The name you have given to the repository. This can be changed at any time.
Repository URL
The web address for accessing the repository.
Storage Location
The file location of the repository on the server.
DELETE REPOSITORY
Click the DELETE REPOSITORY button to remove the repository from uberSVN's control. The repository files will remain in place but will not show up in uberSVN. After clicking the button you will be asked if you also want to delete the files from the disk.
View Repository Graph

tip"Caution
Take care when deleting repository files from disk, this action can not be undone.

SAVE
Click save to save changes you make on the to the name, URL or storage location.

SVN Admin Options

uberSVN provides some functions for managing repositories that are available on the Administration sub-tab.

Verify

SVN Admin - Verify

SVN Verify command.

Run the Verify command to check the integrity of the repository data.

Hotcopy

SVN Admin - Hotcopy

SVN Hotcopy command.

Run the svnadmin hotcopy subcommand, which makes a full "hot" backup - so there's no need to take Subversion off-line, or stop users from committing changes to the repository.

Destination Repository Name
Name of the repository copy that you will create.
Destination Repository Path
The file path of the repository copy that you will create.
** Alert! **A word about Hotcopy
The hotcopy subcommand is designed specifically to offer a quick backup solution, it creates a complete, functional copy of a repository - revision history and all (that's all hook scripts, configuration and database files).

There are a few things you should remember:

Dump/Export

SVN Admin - Dump/Export

SVN Dump command.

Run the svnadmin Dump subcommand, which saves out the repository's file data as an stdout "dump-file".

Select Revision By
Select all or revision.
Dump File Name
The name of the dump file you will create.
Dump File Path
The path to the dump file you will create.
Incremental Dump
Sets the dump file's first revision to contain only the files and directories modified in that revision, instead of being presented as the addition of a new tree, and in exactly the same way that every other revision in the dump file is presented.
Use Deltas
If the repository is very large you can tick Use Deltas to greatly reduce the dump file size, as only the changes are copied.
DUMP/EXPORT
Click the DUMP/EXPORT button to begin the dump process.
SVN Admin - Dump/Export

Once run, you'll see a confirmation message that includes a path to the log.

Load

Run the SVNAdmin Load command to at a repository using a saved dump file.

SVN Admin - Load

SVN Admin Load Command.

Dump File
The full path to the dump file to be loaded.
Ignore UUID
Tick Ignore UUID to override the default behavior whereby the load command will use the UUID (unique serial number for the repository) from the dump file.
Force UUID
Tick Force UUID to ensure that the old UUID is maintained.
LOAD
Click the LOAD button to start the loading process.

** Alert! **Alert
In order to complete the Load of an SVN dump file, ensure that the repository in which you are loading the dump file is completely empty - it must not have been created with the default TTB (Trunk, Tags and Branches) format..

SVN Admin - Dump/Export

3.6 Permissions

The Permissions tab is used to manage which users and teams are able to access the repository, and what read/write permissions they have.

** Alert! **uberAPPS
When uberSVN Access Control is enabled, the repository permissions tab is removed. Instead all permissions need to be set from within the Access Control tab.

View Repository Permissions tab

Set the repository permissions.

The permissions table lists both users and teams with their corresponding permissions. All users and teams will have one of three levels of access permission: No permission, which is indicated by the users or team not having a record on the table. Read-only permission, by which they are able to view repository files, but will be unable to commit any changes themselves. If the Read and Write radio button is selected then the user or team has full access to the repository files.

The Admin column will show if a user has admin permissions, which allow them to manage the repository structure, as well as the files that are stored in the repository.

Create New User
Use this link if you want to add a user to this repository that isn't already present in uberSVN.
Create New Team
Use this link if you want to associate a team to this repository that isn't already present in uberSVN.

tip"Caution with team names
Don't give a team exactly the same (case-matching) name as a repository. When a team is created with a name that matches that of an existing repository, assigning this team to another repository can result in unintended read-write access being assigned to non-members of the team.

Enable Anonymous Reads
Tick this checkbox to allow anyone to view the contents of the repository, although limited to read-only access. This is a useful feature if you want to open up a repository to a wider audience without having to create login credentials for everyone.
SAVE
Click to save any changes that you make to the repository permissions. Currently this is required only for switching between uberSVN Internally Managed and Use Alternative Authz File or after making a change to Enable Anonymous Reads. Individual permission changes are instant and do not require you to click SAVE

3.7 Authentication

Options for how to handle authentication of the repository's users. The authentication method can be different for each repository hosted on uberSVN. View Repository Permissions tab

Set the repository authentication type.

uberSVN Internally Managed
uberSVN's default authentication option is to use the built-in htpasswd.
tip"Access Control
--
Use Alternative htpasswd file
Select this option to have uberSVN use a different htpasswd file for authentication. The location of the file is set on the Alternative htpasswd File tab, in the Subversion Server section under the Administration tab.
LDAP / Active Directory Authentication
This option enables LDAP/Active Directory authentication.

This table displays the available LDAP Locations.

You can add/edit LDAP Locations by going to the LDAP Locations tab under the Administration tab.
  • Auth Name: The AuthName directive sets the name of the authorization realm for this directory.
  • AuthzLDAPAuthoritive: Specifies whether LDAP has exclusive control over authentication.
  • AuthLDAPGroupAttribute: Specifies which LDAP attributes are used to check for group membership.
  • AuthLDAPGroupAttributeIsDN: directive specifies the use of the distinguished name of the client username when checking for group membership. Otherwise, the username will be used.
  • Require: Identifies which authenticated users can access a resource.
SAVE Click the SAVE button to store any change to settings that have been made.

4. Users

UberSVN users (including administrators) are managed under the Users tab. New users are created or imported from here and any user properties can be modified.

Users Main Screen

Users main screen.

The main Users screen shows a list of users, along with their usernames and email addresses. From here you can:

4.1 Create User

Manually add new users into uberSVN using the Create User Wizard.

A

Users - Single User Creation

Full Name :
The user's full name, e.g. Thomas Hobbes.
Username:
A name by which the user will be known on uberSVN. It should be a single word, consisting only of numbers and letters.
** Alert! **Username Rules:
The following restrictions apply to what form usernames can take:

  • Limited to 25 characters.
  • colons (:) are not permitted.
  • While usernames that consist of multi-byte characters are permitted, using them could potentially lead to problems.
Password
A password, which also should consist of numbers and letters only.
Email:
The email address for the users. Tick the Email password to user checkbox to have the password sent to the user in an email.

Configure User

You can view or configure user details by clicking on a user, or their configure widget. Most of the user details are presented on the Profile tab.

4.2 Profile

The profile tab shows the users information, avatar and contact details. When viewing with an account with admin privileges, an edit button will also appear, allowing you to make changes to the details. The avatar image can only be edited when logged in as the user (or by a user with system admin privileges).

Users Main Screen

Users - User Profile

Full Name :
The user's full name, e.g. Kevin Flynn.
Username:
A name by which the users will be known on uberSVN. It should consistent of a single word, with only numbers and letters.
Job Title
The user's position within your organization.
Location
The location of the office in which the user works.
Email:
The email address for the user.
Work Number:
The telephone number for the user.
Mobile Number:
The mobile telephone number for the user.
Other:
One of three option fields for additional information.
Share Profile With:
Choose who can view the user's profile: Everyone, Team Only or Nobody.
Quotation
A memorable saying or greeting from the user.
Upload Avatar
User avatars can only be uploaded or changed by the user. To upload or change an avatar, click on the image and then click on browse. Select the image you want to use and then click Upload.

Edit Avatar
Activity
The users comments and Subversion changes are logged in the Activity panel.
Teams
Lists the teams of which the user is a member. Click on the edit widget to make changes to the team.

Users Main Screen

Users - Edit Profile

tip"Tip
It's possible to deep link to, or bookmark an individual user's profile.
http://xx.xx.xx.xx:9890/ubersvn/views/platform/users/userProfile.jsf?userId=<User Number>

4.3 Preferences

4.3.1 Change Password

It's possible for a user to change their password through the uberSVN User Profile screen.
Users prefs - Change Password

Current Password
Enter the current password in this box
New Password
Enter a new password. Passwords can only contain numbers and letters. The password you enter will be graded, Weak, Good or Strong.
Users prefs - Password Grading Bar

tip"Tip
A strong password should contain 12 or more characters, mixing capital and small case letters and numbers.

Confirm Password
Retype the new password to ensure you entered it correctly the first time.
Update Password
Click the Update Password button to confirm that you wish to use the new password.

tip"Changing another user's password
Administrators are able to change a user's password by clicking on the user's profile and using the same method. An administrator doesn't need to enter the user's current password and also has the check box option for sending the password by email to the user, providing uberSVN's Email server settings have been completed correctly.

4.3.2 Mute List

Users prefs - Ignore List
Any users who have been set to be muted will be listed here, along with a ticked checkbox in the Ignored column. To un-mute a user, untick the checkbox and click the Update Ignore List button.
Click Cancel to close the Ignore List editor without making a change.

4.4 Permissions

Users perms tab

User permissions tab

From the Permissions tab the user's access priviledges are controlled.

System Admin
Tick the System Admin checkbox to give the user full admin rights for uberSVN. System Admin rights let users access all sections of uberSVN, including the Administration tab and all the admin sub-tabs, giving them complete control of uberSVN. For this reason it is prudent to limit the number of users who have Systems Admin rights.
Global Team Admin
Tick the Global Team Admin checkbox to give the user access to the Users and Teams Tabs. A user with Global Team Admin priviledges is able to create and delete Teams. A users with System Admin privileges is still required to create new users.
Global Repository Admin
Tick the Global Repository Admin checkbox to give the user full acess to the repositories tab. The user will be able to create or delete repositories, as well as use all the available Subversion Admin commands.
uberAPPS User
Tick the uberAPPS User checkbox to give the user the ability to register themselves as a purchaser in the uberAPPS store. An uberAPPS user gets access to the Account tab when they view uberAPPS.
Delegated Team Admin
The table shows the teams for which that the user has been delegated admin rights. Untick the Admin checkbox to remove the Team admin permissions.
Delegated Repository Admin
The table shows the repositories for which the user has been delegated admin rights. Untick the Admin checkbox to remove the Repository admin permissions.
UPDATE PERMISSIONS
The UPDATE PERMISSIONS button will save any changes that have been made to the Permissions tab.

5. Teams

Teams List

Click on the Teams tab to see the Teams List screen. All teams are listed, along with a description and the number of users and repositories associated with it. Clicking on the Team's name or corresponding Configure widget will open the Team's screen. uberSVN Teams List

tip"Caution with team names
Don't give a team exactly the same (case-matching) name as a repository. When a team is created with a name that matches that of an existing repository, assigning this team to another repository can result in unintended read-write access being assigned to non-members of the team.

View Team

Each uberSVN team has a team screen which has a description of the team, a lists the team members and a team-specific Activity window which tracks team posts.

tip"Tip
It's possible to deep link to, or bookmark a specific team's screen.
http://xx.xx.xx.xx:9890/ubersvn/views/platform/teams/teamProfile.jsf?teamId=<Team Number>

svn dump svn dump

Edit a User Group by clicking on its name. Use the Filter by Name entry box to search for a particular group.



6. uberAPPS

uberAPPS is a built-in store for development applications and services that turns uberSNV into a full development hub.

View the uberAPPS guide for more information about how to add, manage and update more applications for your uberSVN suite.

7. Administration

The administration tab provides access to uberSVN's inner workings and is only available (visible) to users with system admin privileges.

7.1 Status

Administration 1 - status

Administration - status tab.

The Administration status tab provides a quick view of what's going on.

Notices

Announcements
As an uberSVN administrator you can post a message to all users through the Announcements tool. Announcements are posted on the uberSVN Dashboard and remain pinned to the top of the message board, much like 'sticky' threads do in online forums.

Administration 1 - status

Announcements - How administrators send messages to all users.


Send email to all users
Tick this check box to also send the announcement to all users by email, using the email addresses that users provide when they set up their accounts.
Notices
System changes and messages appear on the notice board.
Subscription Options
Click on the Subscription Options to either enable or disable the sending of these messages to the email account associated with your uberSVN account.

uberSVN Stats

Lists the basic statistics for the server, useful for keeping an eye on application usage.

A
Number of Repositories
The number of repositories currently hosted by uberSVN. This will not include repositories that have been deleted from uberSVN that remain in place on the server's drive.
Total Size of Repositories
Displays the amount of disk space used by the repositories. Again, this will not included repositories that have been deleted from uberSVN that have been left in place on the server.
Number of Users
Shows the number of uberSVN that are create or imported onto the server.
Number of Teams
The number of teams that have been created on the server.

System Stats

Lists the basis hardware statistics, useful for keeping an eye on server load.

A
System OS Name
The operating system of the server on which uberSVN is running.
No. of CPUs
The number of processors or number of cores within the server's processor.
Total System Memory
The total memory that the uberSVN server has installed.
Total Free Memory
The total memory that remains free for assignment.

Server Status

Shows the current state of Subversion and uberSVN.

A
Subversion Server:
Green box indicates that Subversion is running, a red box will display if Subversion is not running. There's a Stop and restart button should you need to manually stop or restart the Subversion server.
uberSVN:
Green box indicates that uberSVN service is running, a red box will display if the uberSVN service is not running.

Uptime

Shows how long the server and uberSVN have been running.

A
System
Indicates how long the system as been running.
uberSVN
Indicates how long uberSVN has been running.
Subversion Last Configuration Reload:
Indicates the time and date of the last Apache restart (which is triggered whenever a change is made to the Apache config file.

7.2 Subversion Server

The Subversion Server tab (formerly known as the Apache Server tab) handles user access to the repositories.

A

Subversion Server - Main

Server Name / IP
The server's IP Address. This is no longer editable after installation, if you need to change the server's address change the Base URL located on the uberSVN Server sub-tab.
Server Port
The port that Apache will use. By default this is set to 9880. You can change this to any port that you like, although you should avoid using a common port (one that is numbered 1023 or less) as these will require that uberSVN is run with root privileges.
Bind IP
On a multi-homed server (one with multiple network cards) you would need to specify which IP address that Apache will be bound on.
HTTPS Enabled
Tick this checkbox to encrypt Apache traffic using SSL.
Subversion Server Stop/Start/Restart
The Stop and Restart buttons allow you to manually trigger a stop or restart of Apache. System changes that force Apache to be restarted will happen gracefully, you don't need to do anything to trigger them.

tip"Caution
There's a known problem for Linux users (seen in CentOS and Ubuntu) who start Apache from command line when logged in as root. Attempting to use Apache service controls will fail because Apache is not running as the ubersvn user.

The workaround is:
1. Login to the console as root and stop the httppdserverctl service, i.e. sudo ./httpdserverctl stop

2. Login to the uberSVN portal ( http://yourserver:9890/ubersvn) with an account that has system admin permissions.
3. Click on the Administration tab, then the Subversion Server sub-tab, then click the Subversion Server start button.
Apache will now be under uberSVN's control and will respond to future start/stop/restart commands.

Advanced Settings

The more advanced settings relate to Apache's fine tuning. It's recommended that you don't change these settings unless you're quite familiar with Apache's inner workings.

Subversion Server - Advanced

Subversion Server - Advanced Settings

Timeout
The number of seconds before receives and sends time out.
default: 300
Max Keep Alive Requests
The maximum number of requests allowed during a persistent connection. Set to 0 for unlimited connections.
default: 100, which ensures a balance between connection capacity and performance.
Keep Alive
Whether or not to allow persistent connections (more than one request per connection). Set to "Off" to deactivate.
default: on
Keep Alive Timeout
Number of seconds to wait for the next request from the same client on the same connection.
default: 15
Threads per Child (Windows installation only)
ThreadsPerChild parameter in the httpd.conf file specifies the number of requests that can be handled concurrently by Apache.
Requests in excess of the ThreadsPerChild parameter value wait in the TCP/IP queue. Having the requests wait in the TCP/IP queue can get you the best trade-off between response time and throughput.
default: 300
Max Requests per Child
Maximum number of requests that the Apache child process will serve before the child expires.
Setting a maximum value can help avoid long-lived process induced memory leaks, however, in most setups no maximum is set.
default: 0 - ensures that child processes never expire.

httpd.conf Editor

Subversion Server- Httpd.conf Editor

Users - Httpd.conf Editor

The httpd.conf editor allows for manual changes to be made to Apache's main configuration file. Click Save to store any changes you have made. Click Reset to ignore any changes and return to the previous settings. Any change to the httpd.conf file will come into effect as soon as the Apache process is restarted.

View a sample copy of the httpd.conf file

Alternative htpasswd File

Alt passwd file

Subversion Server - Alternative htpasswd File

Allows you to replace the default htpasswd file with a different one. Simply browse to and select a different htpasswd file to set it as the password file to be used. This selection is made on a per repository basis.

Alternative authz file Editor

Alt authz editor

Subversion Server - Alternative authz File

Allows you to replace the default authz file with a different one. Simply browse to and select a different authz file to set it as the password file to be used. This selection is made on a per repository basis.

ProxyPass

UberSVN supports the Apache ProxyPass directive which allows a reverse proxy to be configured. When enabled, Apache can proxy traffic between the client and back-end applications like uberSVN Access Control.

proxy pass

ProxyPass Example

Initially, Proxypass has been added to allow the use of SSL encryption, which is not supported by uberSVN Access Control. In the example above, Proxypass is enabled, Apache listens on port 9800, the front proxy decrypts and forwards traffic directed at Subversion to Access Control via port 9801. Access Control (via the Back Proxy port of 9882) then directs this traffic to Subversion.

ProxyPass

Subversion Server - ProxyPass Settings

Enable ProxyPass
Tick this checkbox to enable ProxyPass on your uberSVN server. If enabled you'll also need to provide port numbers for both the front and back proxy.
SSL enabled for Front Proxy
Tick to enable https for traffic between client and Apache.
Front Proxy Port
Enter a port number for the front proxy.
SSL enabled for Back Proxy
Tick to enable https for traffic between Access Control and Subversion.
Back Proxy Port
Enter a port number to be used by the back proxy.

You can check the configuration that results from enabling ProxyPass by viewing the Apache proxy-pass configuration file:
C:\Program Files (x86)\WANdisco\uberSVN\conf\conf.d\proxy-pass.conf

LoadModule proxy_module modules/mod_proxy.so
LoadModule proxy_http_module modules/mod_proxy_http.so

Listen 9800

<VirtualHost *:9800>
SSLEngine on
SSLCertificateFile C:\Program Files (x86)\WANdisco\uberSVN\openssl\certs\ubersvn.crt
SSLCertificateKeyFile C:\Program Files (x86)\WANdisco\uberSVN\openssl\certs\ubersvn.key
SSLProxyEngine on
ProxyPass / https://10.2.5.89:9900/
ProxyPassReverse / https://10.2.5.89:9900/
</VirtualHost>

7.3 uberSVN Server

uberSVN's own server settings can be managed from this screen.

uberSVN Server - Settings

uberSVN Server - Settings

Install Path
The local path to where uberSVN has been installed.
Base URL
The hostname or IP address on which uberSVN is accessed.

tip"Caution
If you list a hostname, you must also include the protocol, i.e. 'http://ubersvn.server.com'

Server Port
The port used to access the uberSVN portal.
Default Repository Path
The local path to the directory in which all Subversion repositories are stored.
Enable HTTPS
Choose "Yes" to encrypt uberSVN using SSL. In this case you would need to access uberSVN using the HTTPS protocol.
HTTPS Port
If you select "Yes" for Enable HTTPS, enter the port that you want to use for SSL. (The default is port 9900.)

Update Settings

Tell uberSVN how you want to manage its software updates, through the Updates tab.


uberSVN Server - Settings

uberSVN Server - Settings

Update Frequency (days)

This sets how frequently uberSVN checks for software updates. Choose between Daily (24h), Weekly (7 days) or Monthly (30 days).


Update Channel
You can choose between two update channels:

Latest Releases: (default setting) uberSVN will always download the very latest files, as they are made available. This approach will get you the latest features and fixes, but it won't have benefitted from community testing.

Stable Releases: This channel will limit system updates so that they only occur when a new version of uberSVN is released - you wait longer for releases but there will be fewer bugs and more complete features.


Privacy Policy: A link to our uberSVN Privacy Policy which explains exactly how we manage any of your personal information that is stored within or transferred through uberSVN.

There's a tab button on the footer of the uberSVN that highlights that the installation defaults to the Latest Release Channel.

select release channel

Latest Release Channel tab

Click on the tab to go to the uberSVN Server settings screen where you can change to the Stable Release Channel. Once you select the Stable Release Channel this tab will disappear. Return to the uberSVN Server screen if you ever want to switch back to the Latest Release channel.

Proxy Settings

If your uberSVN server requires a proxy in order to talk to the outside world you enter the details here. When external connectivity is through a proxy, you'll need to configure this section to:

uberSVN Server - Settings
Host
The proxy server's IP or hostname.
Port
The port on which the proxy is running.
Authentication Required
If the proxy server requires authentication then select the "Yes" radio button. Additional fields will be revealed:
Username
The username required for logging into the proxy.
Password
The password required for logging into the proxy.

Encryption Settings

Manage the Trust Store credentials for use in securing uberSVN connections with SSL.

A

Administration- Preferences

Trust Store Location
Type the trust file name and file path.
Trust Store Password
Type in the password needed to access the truststore file.

7.4 Preferences

The preferences screen is used to manage various uberSVN setting, including the visual themes, Social Interface messaging and Quick Links.

A

Administration- Preferences

Social Interface
uberSVN integrates messaging and activities streams that are associated with the Dashboard, teams and repositories. The Social Interface control lets you disable the feature so that no further messages or activity will be displayed.
Theme
The Display Theme is currently not implemented in the current version. In future it will be possible to change the way that messaging streams are displayed.
Quick Links
The Quick Links panel that appears on the dashboard is edited from here. You can delete or add your own links, either deep linking to a screen in uberSVN, or an external link. Due to limited space on the dashboard there is currently a maximum limit of 8 Quick Links.
Dashboard Twitter Account
Subscribe to a Twitter feed by entering a twitter account name (the twitter account name without the @ prefix) into the Twitter Account entry box and clicking the SAVE button. The feed that you add will appear on the dashboard within 5 minutes. You can enable/disable the twitter feed by ticking or unticking the Enable Twitter check box.

7.5 Email Server

The Email Server screen is used to set up uberSVN to send emails out (using a seperate email server).

A

Users - Email Server

Enable email notifications
Select "Yes" to enable the sending of notifications emails to users who have subscribed to message/activity streams. Select "No" to disable all notification emails.

If email notifications are enabled you'll receive notification emails:
  • alerting actions based on user subscriptions (Repository activity, commits etc)
  • confirming forgotten Password resets
  • admin notifications, including update availability

** Alert! **uberSVN alert emails come from your server
To be clear, these emails are sent from your instance of uberSVN, they are not sent from WANdisco. If receiving yet more emails is going to mess with your calm you can click the Disable Email Notifications button. Just remember that many important system changes or problems will only be reported in log files.


Use SSL
Select "Yes" to use encryption for connections to the mail server. Select "No" to disable encryption of email traffic.
SMTP Server Address
The address IP or hostname of the email server.
SMTP Port
The port used by the mail server, the default port is 25.
From Address
This is the address that will appear as the source of notification emails, it will also be the address to which replies are sent.
Email Prefix
An optional value that is stuck on the front of all notifications that can assist in email filtering.

tip"Tip
If you run multiple instances of uberSVN, use the Email Prefix field to distinguish which instance from which the email has been sent.

SMTP Authentication
If the mail server requires authentication, select yes and provide a mail account username and password.
SAVE
Click the save button to save any changes you have made to the email server settings.
Test
Clicking Test will trigger a test message to be sent to the email address associated with the user account that is currnently logged in.

7.6 Logs

The Logs tab provides access to a number of system logs for uberSVN, Subversion and Apache.

A

Administration - Logs

Which log files appear will depend on which Subversion commands have been run and which uberSVN tools have been used.

PackagerTool.log.yymmddhhmmss
This log file is created when an update is performed in uberSVN.
access_log
Apache server records all incoming requests and all requests processed to this log file.
catalina.yyyy-mm-dd.log
Tomcat web server log.
commons-daemon.yyyy-mm-dd.log
Commons Daemon is a Java software library belonging to the Apache Commons Project.
error_log
The main uberSVN error log, tracks system behavior that can help with diagnosing problems.
host-manager.yyyy-mm-dd.log
Tomcat host manager log.
localhost.yyyy-mm-dd.log
Tomcat localhost log.
manager.yyyy-mm-dd.log
Tomcat manager application log.
RepoName_dump1-Dump-Messages.log
Generated after a successful dump.
RepoName_dump1-Load-Messages.log
Generated after a successful repository data Load.
rest-audit.log
uberSVN rest api audit log file.
svn_logfile
Shows log messages from the repository.
ubersvn-audit.log
uberSVN audit log file.
ubersvn.log
The main log file for uberSVN. It tracks most of the system changes that are made through the uberSVN console.
ubersvnportal-stderr.yyyy-mm-dd.log
Standard error is an output stream used to output error messages or diagnostics.
ubersvnportal-stdout.yyyy-mm-dd.log
Standard output is the stream where a program writes its output data.
verify_dumpXX-Load-Messages.log
Generated after a successful run of a Subversion dump.
verify-repositoryname-mm-dd-yyyy_hh-mm-ss-Messages.log
Generated after running a repository verification.
error.log
The error file is the place where Apache httpd will send diagnostic information and record any errors that it encounters in processing requests. It is the first place to look when a problem occurs with starting the Subversion server or with the operation of the server, since it will often contain details of what went wrong and how to fix it.
access.log
The server access log records all requests processed by the server.

Reload Click the reload button to refresh your view of the available log files.

Download Log Files Click the Download Log Files button to download a zip archive of all the current log files.

** Alert! **uberAPPS
When uberSVN Access Control is enabled, more detailed logs for Access Control can be viewed within the Access Control installation
i.e.
    C:\Program Files (x86)\WANdisco\uberSVN\svn-security\logs
When Access Control is running you can view the logs from the Log Viewer, under the System tab Access Control Log Viewer.

7.7 Updates

Once uberSVN has been installed, there's no need to re-install from scratch when a new version is release, instead the Updates section allows you to view which new versions of components are available and select which ones you want to install.

** Alert! **Update Channel: bang up-to-date or super-stable
UberSVN's updates can be set to come from one of two channels:

Latest Releases - By default, the Updates tool will make you aware of updates to individual components, which you can download as and when they're made available.

Stable Releases - If you prefer you can wait until uberSVN has completed a full development cycle, by which time any problems found by early adopters should be ironed out.

Set the Update Channel under the uberSVN Server settings screen.

A

Administration - Updates

List of currently available modules

updater
The uberSVN Updater itself. This file controls how the update tool actually works.
apr-util
Apache Portable Runtime Utilities are a bunch of libraries that help implement some of uberSVN's core functionality.
db
Berkeley Database Engine is used for storage by our implementation of Subversion.
apr
This is the Apache Portable Runtime, a library used by Subversion's Apache web server. It provides a set of APIs that map to the underlying operating system (OS). Where the OS doesn't support a particular function, APR will provide an emulation - making Apache portable across different platforms.
openldap
This is the open source variant of the Lightweight Directory Access protocol (LDAP) that can be used to manage user access.
serf
serf is a HTTP client library built upon the Apache Portable Runtime (APR) library. It multiplexes connections, running the read/write communication asynchronously. Memory copies and transformations are kept to a minimum to provide high performance operation.
sqlite
The database system that Subversion client libraries use for the storage of working copy information. APR also has a DBD module that uses sqlite for it's back-end, so it can also be used by Apache.
openssl
Cryptographic Library that enables uberSVN to encrypt its traffic using Secure Socket Layer technology.
ubersvn
the uberSVN Core software.
bzip2
A compression Library.
tomcat
Apache Tomcat is the Web Application Server on which uberSVN runs.
zlib
Another compression Library.
httpd
This is the Apache HTTP Web Server on which Subversion runs.
neon
Is a HTTP and WebDAV Client Library.
mod_wsgi
(For future use) This Python Adaptor for Apache will allow uberSVN to feature apps that run using Python.
expat
Is a stream-oriented parser XML Parsing Library.
Python
Python Language Interpreter, required for when uberAPPS suppies Python-based apps.
subversion17
The Subversion 1.7.x Binaries - these are installed along with Subversion 1.6, which is used by default.
subversion16
The Subversion 1.6.x Binaries.
accesscontrol
uberSVN Access Control - Access Control App is a commerical add-on for uberSVN that provides full authorization, authentication, access control and audit capabilities for Subversion. Visit uberAPPS to learn more.
accesscontrol-license-Demo
uberSVN Access Control License - this is the license file for running the demonstration version of the Access Control app.

** Alert! **Updating Plugins

Before updating any installed plugins you should download and install the core uberSVN update. Failure to do this may result in the plugin updates failing.


Completing an Online Update

Updating uberSVN is usually done online and couldn't be simpler. A run-through of the process follows below.


Should you have problems connecting to the update service from your network, you may need to set up a proxy - See Proxy Settings, under the uberSVN Server settings for more details.


In some cases, you may be installation or update files to install locally, instead of downloading from uberSVN's update server. For these occasions see the section about How to Upload Offline Update.

** Alert! **Alert: Problem running Apache on a privileged (numbered lower than 1024) port:
As part of the update process, Apache is updated so that the new LDAP features will work. The updater doesn't have root privileges, so if you are running Apache on a port that is lower than 1024 you'll need to run an extra script (opt/ubersvn/bin/fixup.sh) to finish the update.

  • 1. Login to uberSVN. Click on the Administration tab, then click on the Updates sub-tab. uberSVN's constituent components are listed (as described in the previous section). To see if updates are available, click on the Check For Updates button.
    uberSVN Server - Settings

    uberSVN Updates - Step 1 "Check For Updates"

  • 2. If there are updates available, they'll show up in the status column. To download and install available updates, click the Download Components button.
    uberSVN Server - Settings

    uberSVN Updates - Step 2 "Download Components"

    ** Alert! **Alert
    Once an update has started, Don't disconnect from the network and don't restart uberSVN.
    Any unexpected interuption to the update may cause you to get 'stuck in progress'. If this happens you'll need to complete a full reinstallation.


  • 3. You may need to refresh the screen to confirm the that the updates have been downloaded. Successful downloads will result in the status of the downloaded components changing to Ready for update. Click the Update Components button to continue the process.
    uberSVN Server - Settings

    uberSVN Updates - Step 3 "Ready for update"

  • 4. An alert box will appear, warning you that during the next stage of the update, uberSVN and any hosted Subversion repositories will be briefly unavailable. You may wish to inform users of the outage.


    Click the Continue button to complete the update. Clicking Not Yet will cancel the update, although the update files will remain available to update at a later date.

    uberSVN Server - Settings

    uberSVN Updates - Step 4

  • 5. A refresh of the screen will confirm that the Last Update Status for the updating components is Success. Congratulations, uberSVN is up-to-date.
    uberSVN Server - Settings

    uberSVN Updates - Step 5

Completing an Offline (local) Update

It's possible to update uberSVN or uberAPPS using a local installer or update file instead of downloading through the uberSVN server. To complete an offline update, click the Upload Offline Update button that appears at the bottom of the update screen, then follow the prompts. uberSVN Server - Settings

uberSVN Offline Updates.

Licence Comparison Functionality

When a licence update is available it will be shown in Updates under the uberSVN Administration tab.

  • 1. Click Check For Updates and a cog symbol will appear next to the component that has an update available. To apply the update click on the cog symbol, or Download Updates button, shown below.

  • ** Alert! **Alert
    The Download Updates button will attempt to download all the available updates.


    Download Updates

  • 2. A pop-up will confirm the updates are being downloaded. The progress of your download will be provided as a % complete. You can navigate away from the page whilst the download progresses.

  • Update Downloading

  • 3. When the download has finished click on the Install Updates button. If the update contains a new licence a confirmation popup will appear. The new licence details will be highlighted in red. Check the licence details are correct before clicking the Continue button.

  • Update Confirmation

    ** Alert! **Alert
    The existing license details will show up as unknown. However all subsequent licenses will contain all the details. Our latest license files now include additional metadata to present this attribute which isn't available in previous versions.


  • 4. Once the update has been installed the Subversion server will be gracefully restarted. When you log back into uberSVN you will see the update has been applied.

  • Update Complete

    ** Alert! **Alert
    You can check that the new license has been applied by viewing the license information from the ManageAPPS sub tab in uberAPPS.

7.8 LDAP Locations

The LDAP Locations tab stores settings for use when an LDAP service is used for managing authentication for Subversion users (and optionally for uberSVN access too). You can add multiple LDAP locations (multiple LDAP groups or servers).

** Alert! **Known Problem (Windows only)
Enabling LDAP authentication for a repository will prevent you from viewing it using uberSVN's repository browser.
We're looking to fix the problem, although our long term strategy is to bring in a replacement repository browser.

LDAP

Administration - LDAP Locations settings

+ADD
Click the ADD button to add a new LDAP/Active Directory location for use with Subversion/uberSVN.
Use LDAP for uber login authentication
Select "Yes" if you want to manage uberSVN access via your LDAP/Active Directory service. Select "No" if you only wish to manage Subversion users through LDAP/Active Directory.
Advanced Settings
Click to edit the advanced settings that uberSVN uses for fine-tuned LDAP/Active Directory setup
Delete Selected
Tick the corresponding check box for an available LDAP location, then click Delete Selected to remove the LDAP location from uberSVN.
Get User From Selected
Tick the corresponding check box for an available LDAP location, then click Get User From Selected to sync with the LDAP group.

LDAP

Administration - LDAP Locations Advanced Settings

Cache Settings

Cache Entries
The maximum size of the primary LDAP cache. This cache contains successful search/binds. Set it to 0 to turn off search/bind caching.
Cache TTL
The time in seconds that an item in the search/bind cache remains valid.
Connection Timeout
This value typically controls how long LDAP will wait for the TCP connect to the LDAP server to complete. If a connection is not successful within the timeout period, either an error will be returned or the LDAP client library will attempt to connect to the secondary LDAP server if one is specified in the URL.
Operation Cache Entries
The maximum size of the LDAP comparison operation cache. Setting it to 0 disables operation caching.
Operation Cache TTL
The time in seconds that entries in the operation cache remain valid.
Shared Memory Cache File
The directory path and file name of the shared memory cache file. If not set, anonymous shared memory will be used.
Shared Memory Cache Size
The number of bytes to allocate for the shared memory cache. if set to 0, shared memory caching will not be used.

Apache Encryption Settings

LDAP

Apache Encryption Setting

LDAP Encryption Mode
The encryption mode to be used when connecting to the LDAP server. Select between three encryption types, None (no encrytion), SSL (Secure Socket Layer) or TLS (Transport Security Layer).
LDAP

SSL Encryption settings

Verify Server Certificate
Whether to force the verification of the server certificate when establishing an SSL connection with the LDAP server.
Trusted Global Certificate 1
The type, directory path and file name of the trusted CA certificates and/or system-wide client certificates that should be used when establishing an encrypted connection to an LDAP server. E.g. CERT_BASE64 "C:/path/to/cert.pem".
Trusted Global Certificate 2
The type, directory path and file name of a second trusted CA certificates and/or system-wide client certificates that should be used when establishing an encrypted connection to an LDAP server. E.g. CERT_BASE64 "C:/path/to/cert.pem".
Trusted Client Certificate 1
The type, directory path and file name of per-connection client certificates that should be used when establishing an encrypted connection to an LDAP server. This certificate will be applied GLOBALLY, not per-location. E.g. CERT_BASE64 "C:/path/to/cert.pem".
Trusted Client Certificate 2
The type, directory path and file name of a second set of per-connection client certificates that should be used when establishing an encrypted connection to an LDAP server. This certificate will be applied GLOBALLY, not per-location. E.g. CERT_BASE64 "C:/path/to/cert.pem".
Cancel
Click Cancel to exit back to the LDAP settings screen without saving any changes
SAVE
Click SAVE to save any changes you have made to the advanced LDAP Settings

LDAP Location Creation

This section will run through the creation of an example LDAP location.

LDAP

Setting up an LDAP Location

Location Order
This field sets the order that LDAP authorities are queried. An LDAP authority with the location order of 1 will be the first to be checked.
Location Name
A meaningful name that you provide that will identify the LDAP authority - it must not contain spaces.
LDAP URL
The URL to connect to an DALP server and perform a search for entries to authenticate against, e.g. ldap(s)://primaryhost:port secondaryhost:port/basedn?attribute?scope?filter
- note this example illustrates that you can string multiple redundancy servers into the URL.
tip"Tip
LDAP URLs follow the format: ldap(s)://host:port/basedn?attribute?scope?filter
  • host is the fully qualified domain name or IP of the LDAP server.
  • port is the network port of the LDAP server
  • DN is the Distinguished Name to use as the search base
  • attributes is a comma-separated list of attributes to retrieve
  • scope is the starting point of an LDAP search and the depth from the base DN to which the search should occur
  • filter is a normal string which expresses the criteria for which you want to filter
Anonymous Bind
Anonymous binds can be used if the server does not require a DN and password to search for entries. Active Directory does not accept anonymous binds by default.
Set to "Yes",by default this will allow users to connect through LDAP without supplying a username or password. Anonymous binds simplify common search and read operations. If you select "No" then you have the option of supplying:
     Bind User DN
     An optional DN used to bind to the server when search for entries

     Bind User Password
     A bind password to use in conjunction with the bind DN.
tip"Caution
The bind password may be sensitive so you should only use a bind DN and password if absolutely necessary.


First Name Attribute
This is the attribute of your LDAP entries that contains a user's first name, e.g in Active Directory this could be 'givenName'.
Last Name Attribute
This is the attribute of your LDAP entries that contains a user's family name, e.g. in Active Directory this could be 'sn'.
Email Address Attribute
This is the attribute of your LDAP entries that contains a user's email address, e.g. in Active Directory this could be 'mail'.

Retrieve Users Click to query the LDAP service and return the first 10 users who match the current settings.

get em!

Use the retrieve users button to test a connection.

Click Show all users if you wish to view everyone who matches your query. If you are happy to use the LDAP group, click Import All Users.


SAVE Click on the SAVE button to store changes you have made to the current LDAP settings.

tip"Windows Active Directory LDAP Query Limit
Be aware that (Microsoft) Active Directory LDAP sets a default limit of 1000 entries (users etc) per fetch. Any query that exceeds this limit will result in the "LDAP error code: 4 Sizelimit exceeded" error.
Workarounds?

7.9 Backup

The Backup tab holds uberSVN's backup and recovery tools. From the Backup sub-tab you can save uberSVN's working database and Apache configuration files, safe in the knowledge that your repository data is protected against potential mishaps.

** Alert! **Alert
Backups will not work between different versions of uberSVN. We advise you to do a backup immediately after completing any product updates.

Backup tab

Backup!

uberSVN offers a complete backup and restore capability that ensures you don't lose your data.

** Alert! **Warning!
Backup will only store uberSVN internal data and does not store any Repository Content or uberAPPS data. Please create a copy of the Repositories and Tomcat webapps folder if you wish to use them after the restore

Filename
The name of the backup file, this is automatically generated with the name "ubersvn-dd-mm-yyyy-hhmm", although you can rename it anything you like.
Folder Location
By default, uberSVN will create a backup folder in the uberSVN folder.

Click the Backup button to create a backup. How long the process takes will depend on the size of your repositories.

Restore

Backup!

Restore sub-tab handles the reimport of backedup data.

Backup folder
This is the default method of backing up. If you use the default folder location in which to save backups, the backup files will appear in the Backup folder table. To restore one of the backup files, just click on it.

** Alert! **Alert
If you choose to restore your data, the restore tab will now show any backups that you made after completing the restored backup. The backups will still be present on your drive, you just need to select them manually.

Backup!

Restore using a manually selected backup file from the uberSVN server filesystem.

Select a file local to uberSVN
Restore from a backup file that is located on the uberSVN server, but not located in the default Backup folder. Click on the spyglass icon and browse to the backup file that you want to use for the restore.
Backup!

Restore using a manually selected backup file from the local machine.

Upload a file from your current machine
Restore from a backup file that is stored locally which will need to be uploaded to the uberSVN server.

** Alert! **Alert
Consider that if the backup file is very large, it might be better to transfer the file onto the uberSVN server first and then use Select a file local to uberSVN option to restore uberSVN.

7.10 Tab Manager

The Tab Manager lets you add additional tabs to the uberSVN portal so that you can add your own choice of applications and tools.

Click the ADD button to add a new tab.

Backup!

Add tabs!

Name
A name for the new tab, which will also appear on the tag.
Link
The URL for the application or website that you wish to associate with the new tag.
Use New Browser Tab
Leave unticked if you want the application or website to appear within uberSVN's main panel. This option offers the best integration, so that the tab becomes an integral part of the uberSVN portal. Tick the check box if you prefer to open the application in a new browser window, this option is best if rending the application within the uberSVN portal causes problems with navigation or usability.

tip"Tip
Adding your own tabs is our first step in making uberSVN an open and flexible ALM stack. In time, we'll be adding applications that fully integrate with uberSVN, right now it's worth testing your preferred development tools to see how well they work from inside         uberSVN.

Tabs!

Name and locate your application, site or tool.

When new tabs have been added, they are listed under the Tab manager, along with their details. The order in which the tabs appear on the list determinds the order in which the tabs appear. Ordering can be changed usuing the up/down arrows that appear at the end of the tabs list.

tip"Tip
Only the first three tabs will appear on the menu bar, any additional tabs will appear after clicking the tab extender button that appears at the end of the menu bar after the first extra tab has been added.

Jenkins details

Tabs list.

A tab's details can be edited by clicking the tab name.

Jenkins details

Edit tabs!

Name
A name for the new tab, as it appears on the tag.
Link
The URL for the application or website.
Use New Browser Tab
Tick to open the application in a new browser tab. When not ticked the application will open within uberSVN's panel.
Trac in action

Example tab: trac running in uberSVN.

7.11 SVNSwitch

uberSVN can switch between different versions of Subversion. Currently this lets you choose between Subversion 1.7 (default) and Subversion 1.6.

SVN Switch tool

SVN Switch

Which version to choose?

Version 1.7 is set to run by default and brings with it various fixes and improvements over 1.6 and has now seen enough live deployments to provide high levels of confidence over stability.

Subversion 1.6 remains selectable should you need to continue using Subversion 1.6 due to a specific known issue of compatibility between Subversion 1.7 and your environment.

You may find that you don't have the very latest version of Subversion on your system, in which case you can use uberSVN's built-in Update tool to get it. Once downloaded and installed, you'll be able to return to the SVNswitch and make the switch.

What happens when you switch

When the APPLY button is clicked, a restart of the uberSVN service is triggered, at which time uberSVN points at your chosen set of binaries. The process should only take a few seconds, although any Subversion activity that is ongoing at the time of the restart will fail.

7.12 Plugins

The plugin tab is used to manage any uberSVN plugins - by which we mean external processes, that are currently installed/running. At the time of writing, the plugin tab is only used by WANdisco Subversion Access Control.


** Alert! **Updating Plugins

Before updating any installed plugins you should download and install the core uberSVN update. Failure to do this may result in the plugin updates failing.


SVN Switch tool

SVN Switch

Plugin Name
The name of the plugin's service.
Plugin Provider
The originator of the plugin
Plugin ID
The unique name for the plugin's Java process.
Link
The URL for the application or website.
Use New Browser Tab
Tick to open the application in a new browser tab. When not ticked the application will open within uberSVN's panel.
Plugin Version
The installed version of the plugin.
Status
The status indicates whether the plugin is currently running or not.
Plugin Control
Contains any controls that correspond with the tool, including a start or stop button.