WANdisco

 Subversion MultiSite v3.7

Home | Pre-deployment | Installation | Upgrade | User Guide | Technical Guide | Glossary
*

Pre-deployment
1 Introduction
  1.1 Deployment Overview
  1.2 System requirements
  1.3 Setting up repositories
  1.4 Using two or more repositories
    1.4.1 Subversion location directive
    1.4.2 About Subversion ParentPath
  1.5 Using the Authz Module
  1.6 MultiSite and Subversion password files
  1.7 Quorum recommendations
  1.8 Firewalls and virus scanners
  1.9 Deployment checklist
  1.10 Creating a new Subversion repository?
  1.11 Configuring Apache
        1.11.1 Changing Subversion port (Unix)
        1.11.2 Sharing Apache, and Using HTTPS
        1.11.3 Using HTTP with Apache
        1.11.4 Apache and SVNKit
        1.11.4.1 SVNKit and Connection Pooling
        1.11.4.2 Optimize Your Configuration
        1.11.5 Apache 2.2/SVN-DAV (Windows)
2 Installing Java and Perl
  2.1 Installing Java
  2.2 Installing Perl

Installation
1. Installation overview
2. Starting the installation
  2.1 Starting the installation
  2.2 Place your license key
3. Run the setup file
4. Complete setup through a browser
5. Login to the admin console
6. Setting up additional nodes
7. Create a replication group
8. Copy the installation files manually
9. Post installation configuration
  9.1 Using pre-commit hooks

Upgrade
1. Upgrade using the upgrader script
2. Upgrade using backed-up data
3. Backup your settings
4. Delete directories
5. Extract and run the setup file
6. Browser based setup
7. Import your saved settings

User Guide
1. Procedures
1.1 Disabling Access to Subversions
  1.1.1 (selected nodes)
  1.1.2 (all nodes)
1.2 Establishing a baseline for replication
    1.2.1 Copying the Subversion Database
    1.2.2 Synchronizing with an older copy
    1.2.3 Copying Over the Network
    1.2.4 Sending repositories on disk
1.3 Finding the Last Committed Transaction
1.4 Adding a repository to a replication group
1.5 Removing a Repository from the Replication Group
1.6 Moving a Repository to another replication group
1.7 Adding a Node to the Replication Group
1.8 Removing a Node from the Replication Group
1.9 Creating a New Replication Group
    1.9.1 Considerations
    1.9.2 Considerations for Majority Quorum
    1.9.3 Procedure
1.10 Deleting a Replication Group
1.11 Emergency Reconfiguration of Quorum
1.12 Changing a prefs.xml File
    1.12.1 Changing One Node's prefs.xml File
    1.12.2 Changing All Nodes' prefs.xml Files
1.13 Performing a Synchronized Stop
1.14 Verifying That the replicator is working
1.15 Installing an updated .jar File
1.16 Changing the Distinguished Node
1.17 Using Subversion triggers for sending e-mails
1.18 Toggling the Quorum Check
1.19 Changing the admin console username
1.20 Changing the admin console password
1.21 Resetting or recovering the admin console password
    1.21.1 Restore the admin console password
    1.21.2 Reset the admin console password as "wandisco"
1.22 Setting Up Hooks"
    1.22.1 Pre-Replication Hook"
      1.22.1.1 Configuration
      1.22.1.2 Repository-Specific Hooks
1.23 Selective Replication
1.24 Updating Apache or Subversion
1.25 Checking Repository Consistency

2. Replicator Management
2.1 Setting Replicator to Start Up on System Boot
2.2 Setting up the Replicator as a Windows Service
2.3 Changing the Quorum Type
2.4 About Watchdog Mode
2.5 Temporary Files

3. Troubleshooting
3.1 How Do I Get WANdisco Support?
3.1.1 How Do I Run the Talkback Script?
3.2 General Subversion MultiSite
    3.2.1 Connection Request Timeout Messages
    3.2.2 VPN, NAT, Firewall Timeouts
    3.2.3 A node is in read-only mode
3.3 Error messages
    3.3.1 Missing License Key file
    3.2.1 Connection Request Timeout Messages
    3.3.2 I'm getting a severe exception
    3.3.3 Compressed Stream Invalid
    3.3.4 Java consistency check on relicator restart
3.4 Oops!
    3.4.1 I Directly Committed to Subversion, How Do I Rsync?
    3.4.2 I Pressed Ctrl-C During a Subversion Command

4. Frequently Asked Questions
4.1 Why Are So Many Java Processes Running?
4.2 Can I Store Logs or Content on NFS?
4.3 Why is Installer Configuring IP Addresses as 0.0.0.0?
4.4 Should I Worry About Time Changes or Time Zones?
4.5 Does WANdisco Support Dynamic DNS?
4.6 Can I Use SSH Tunnel to Navigate a Firewall?
4.7 WANdisco Authentication
4.8 Encryption Around WANdisco Protocol
4.9 How Do I Restrict Direct Access to My Repository?
44.10 About MultiSite log files
4.11 How do I deal with failover agent failure?

5 Guide to the Admin Console
5.1. Security
  5.1.1 Create Roles
  5.1.2 List Roles
5.2. User Administration
  5.2.1 Create User
  5.2.2 List Users
  5.2.3 Import Users
  5.2.4 Change Admin Password
5.3. Group Administration
  5.3.1 Create Group
  5.3.2 List Groups
  5.3.3 Assign Users
  5.3.4 Remove Users
  5.3.5 Import Groups
5.4. ACL Administration
  5.4.1 Create ACLS
  5.4.2 List ACLS
  5.4.3 ACL Options
5.5. System
  5.5.1 Log Viewer
  5.5.2 System Settings
  5.5.3 Transaction Status
  5.5.4 Log Level
  5.5.5 Free Memory
  5.5.6 Dashboard
  5.5.7 Export Settings
  5.5.8 Import Settings
5.6. Proxy
  5.6.1 Proxy Status
  5.6.2 Log Viewer
  5.6.3 SVN Settings
  5.6.4 Email Settings
  5.6.5 Change Distinguished Node
  5.6.6 Stop Proxy
  5.6.7 Shut Down Node
  5.6.8 Nodes
  5.6.9 Replication Groups
  5.6.10 Replication Group History
5.7 Reports
  5.7.1 Configure URI
  5.7.2 User Group Report
  5.7.3 Audit Reports

Technical Guide
1. Introduction
2. MultiSite Overview
3 WANdisco Concepts
  3.1 How Replication Works
  3.2 Replication Example
  3.3 WANdisco is Listening
  3.4 Synchronized Stop of all nodes
4. Handling Node and Network Failire
  4.1 Node Failure
  4.2 Network Failure




WANdisco

Introduction

Welcome to the WANdisco Subversion MultiSite documentation. You'll find lots of information about setting running MultiSite.

If there's something you can't find, check out our online Knowledgebase which may contain updates and extra documentation.

Should you need further help and want to alert us to an error, please contact us by raising a case on our support website.



We'll be using terms like "node" and "replication group" without explaining what we mean. Check out the Glossary for an explanation of these and other WANdisco terms.

For a better understanding about how MultiSite and WANdisco's replication technology works read the Subversion MultiSite Technical Guide.

Release Notes: 3.7 Build: 3926

Issues Addressed

  • Fixed a bug that stopped Authz settings being saved, either during setup or by making changes from the admin console's Subversion Settings screen.(NA-2126)

Issues Addressed

  • Fixed an issue reported by a customer with 3.7 Build 3687 that could result in a thread deadlock within the replicator. (NA-2225)

  • Fixed a bug that stopped locked files from being deleted during garbage collection. (NA-2222)

  • Fixed an issue that in rare cases could cause a thread deadlock affecting the non-distinguished node. (NA-2139)

  • When updating a user password, the security menu is no longer displayed. (NA-2210)

  • Previous passwords are now properly obscured at the end of a user password change. (NA-2153)

  • Fixed a bug that caused the wrong admin console screen to be displayed after loading, instead of the authentication screen. (NA-2236)

Release Notes: 3.7 Build: 3687

What's New

  • System alert emails now list details of the node from which they originated to aid in identification, including replication group, node name and address.(NA-1516)

  • The minimum memory allocated to the java heap ($SERVER_JVM_ARGS in the file /svn-replicator/bin/reputils.pm) has been reduced to 128 Megabytes, from 1 Gigabyte (1024MB). (NA-1790)

  • Improved the Talkback script's handling of repository and Apache install paths. (NA-1874) (NA-1968)

  • Improved file transfer based on ordering of pending proposal files. (NA-1970)

  • Subversion global revisions are now logged for merge operations. (NA-1697)

  • Improved logging message traceability on Writer threads. (NA-1993)

  • Added the ability to disable a performance optimisation that has been found to cause problems in environments where clients use connection sharing (such as when load balancers or SVNKit are used).

    To disable the optimisation, add the following element to the element of your prefs.xml file:
    <WaitEnabled>true</WaitEnabled>
    
    When WaitEnabled is set to true, the replicator will wait for agreement before sending a 203-response to 'Activity Delete' requests. (NA-1912)

  • The prefs.xml element <AlwaysVerifyQuorum> which previously controlled whether bypassable transactions were automatically bypassed has been replaced by new setting in the admin console. To maintain this setting you must now use the "Auto skip bypassable transaction" checkbox in the system settings screen of the admin console. (NA-1475)

  • Names of Users and Usergroups must now be unique. Names that differed only by character case (usergroup,UserGroup etc) are no longer allowed. (NA-1851)

  • Users imported into Access Control who don't have an assigned role are now given a default role called "legacy". Administrators can then set permissions for these users individually or in bulk. (NA-1852)

Issues Addressed

  • Fixed a problem where Spaces in directory names were not being handled properly for locked resources. (NA-2006)

  • Fixed a problem whereby users imported via the LDAP plug-in who were later removed, were not showing up as being available to import again. (NA-1651)

  • Documentation for version 3.7.3 of the LDAP Plugin is now available online. (NA-1644) - http://docs.wandisco.com/svn/ldap

  • Fixed bug that caused replicator to crash while writing audit log. (NA-1840)

  • Consistency Checker is no longer available if any node in the replication group is unavailable or in read-only mode. (NA-1804)

  • We now ensure write threads properly stop trying to write when no additional bytes are available to read, fixing a problem that sometimes resulted in very heavy CPU load. (NA-1801)

  • Fixed problem where pre-replication hook with parentpath was sending an unnecessary forward slash in the path variable, causing problems for users of the jira2svn plug-in. (NA-1838)

  • Fixed a problem that caused garbage collection to incorrectly reschedule deletions when there were no files to delete. (NA-1791)

  • Fixed problem that resulted in DFTP stalls. (NA-1834)

  • Fixed a problem that caused UNLOCK to not work properly, resulting in "400 Bad Request" errors. (NA-1971)

  • Improvements have been made to the replicator's ability to catch up on very large numbers (100,000+) of delayed transactions. (NA-1828)

  • Fixed a deadlock that occurred during the premature closure of connections. (NA-1910)

  • Fixed a problem that caused a system crash due to StreamCorruptedException. (NA-1915)

  • Fixed problem with the Windows installer that stopped the automatic checking of the Apache config file from working. (NA-1894)

  • Fixed a problem with scheduled consistency checking that stopped some transactions from being marked complete and a resulted in an error "problem reading 'svn log' output java.io.IOException: Bad file descriptor" (NA-1742)

  • Fixed a problem with Access Control that prevented the cleanup of files in the /tmp directory after checkouts have completed. (NA-1655)

  • Fixed a problem that prevented a replication group from being deleted if non-alphanumeric character were used in its name. (NA-1638)

Release Notes: 3.7 Build: 2616

What's New

Issues Addressed

  • Fixed problem with Authz access when using a davLocation that is a single / (slash).(NA-1774)
  • Fixed problem where repo access was compromised when using multiple location directives, with DAV locations that started with the same values. (NA-1788)
  • Enabled access to sub folders on repos when using '/' as the dav location. (NA-1793)
  • Talkback now provides the option to include previous logs that fall within a date range. (NA-1591)



Copyright © 2010 WANdisco
All Rights Reserved

This product is protected by copyright and distributed under licenses restricting copying, distribution and decompilation.