Skip to content
Permalink
Browse files
Update subversion.md
Replaced this material with a link to infra.apache.org/svn-basics.html, where it also appears.
  • Loading branch information
cottage14 committed Dec 10, 2021
1 parent d789bf7 commit 823e4c8735a956445e978a8de9a662ad22a498c5
Showing 1 changed file with 1 addition and 287 deletions.
@@ -1,290 +1,4 @@
Title: Using Subversion
slug: reference/committer/subversion

[TOC]

Our developers are located all around the world. To enable them to work
together on our software, we keep the source code in an Internet-accessible
revision control system called [Subversion](http://subversion.apache.org/)
(SVN). Apache committers have write access to the Subversion repository,
enabling them to make changes to the source code. Everyone has read access
to the repositories, so you may download the most up-to-date development
version of the software.
If you are looking for a stable release of the source code, you should
download it from the [distribution
directory](http://www.apache.org/dyn/closer.lua/). The Subversion
repository should only be used if you want to be on the *bleeding-edge* of
the development effort. The code contained in them may fail to work, or it
may even eat your hard drive.
There are several ways to access the Subversion repository:

## Web Access ## {#viewcvs}

If you just wish to browse around or download a few individual files, the
best tool is the web-based [ViewVC interface for
Subversion](http://svn.apache.org/viewvc/) or go straight to the public
repository at
[http://svn.apache.org/repos/asf/](http://svn.apache.org/repos/asf/).

## Anonymous Subversion ## {#anon-svn}

To access the Subversion repository anonymously, you will need a Subversion
client. You can also browse for projects via
[http://svn.apache.org/repos/asf/](http://svn.apache.org/repos/asf/).

Choose the module you would like and check it out. For example, to get the
Spamassassin module, use:

$ svn checkout http://svn.apache.org/repos/asf/spamassassin/trunk spamassassin

For more help on using Subversion, consult the [Subversion
website](http://subversion.tigris.org/) or [Subversion
book](http://svnbook.red-bean.com/). The web site provides a [list of
clients and useful links](http://subversion.tigris.org/project_links.html)
(including a link to the [Eclipse plug-in](http://subclipse.tigris.org/) ).

## Committer Subversion Access ## {#https-svn}

We currently use HTTPS basic authentication for logging in to Subversion (
[certificate info below](#cert) ). To change your password, visit
[https://svn.apache.org/change-password](https://svn.apache.org/change-password).

This will prompt you to enter a svn password of your choice. Pick a safe
password! If you cannot login, or have lost your password, visit
<https://id.apache.org/> to reset it.

Now, when you make changes, you can commit them with your username/password
combination, i.e.

$ svn co https://svn.apache.org/repos/asf/excalibur/trunk/ excalibur-trunk
$ cd excalibur-trunk
$ echo "test" > test.txt
$ svn add test.txt
$ svn commit --username your-name --password your-password \
--message "Trying out svn"

svnserve is not supported, nor is svn+ssh.

## Configuring the Subversion client ## {#https-svn-config}

Committers will need to properly configure their svn client. One particular
issue is OS-specific line-endings for text files. When you add a new text
file, especially when applying patches from Bugzilla, first ensure that the
line-endings are appropriate for **your** system, then do...
`
svn add test.txt
svn propset svn:eol-style native test.txt
`
Your svn client can be configured to do that automatically for some common
file types. Add the contents of the file
[http://www.apache.org/dev/svn-eol-style.txt](svn-eol-style.txt) to the bottom of your
~/.subversion/config file.<br></br>[Note: for Windows this is normally
found at C:\\Documents and Settings\\{username}\\Application
Data\\Subversion\\config -or-<br></br>For Windows 7 at
C:\\Users\\{username}\\AppData\\Roaming\\Subversion\\config]
Some files may need additional properties to be set, for example
svn:executable=* should be applied to those script files
(e.g..bat,.cgi,.cmd,.sh) that are intended to be executed. Since not all
such files are necessarily intended to be executed, the executable property
should not be made an automatic default.
However, you should still pay attention to the messages from your svn
client when you do 'svn commit'.
Tip: If you use TortiseSVN, a popular Windows GUI client that integrates
with Windows Explorer, you can simply right click in Explorer and select
TortiseSVN - Settings, and then press the "Edit" button to
update your "Subversion configuration file:". Simply copy the
above svn-eol-style.txt file's contents into the end of the
config editor (usually Notepad) that appears, and save the file.
## SSL Server certificate ## {#cert}
The server certificate for
[https://svn.apache.org/](https://svn.apache.org/) is a real SSL
certificate. However, Subversion, by default, does not currently ship with
a list of trusted CAs. So, here's some information to help you verify the
validity of our cert:
:::text
Hostname: *.apache.org
Valid: from Mon, 19 Dec 2011 22:00:00 GMT until Mon, 17 Feb 2014 21:59:59 GMT
Issuer: Thawte, Inc., US
Fingerprint: bc:5f:40:92:fd:6a:49:aa:f8:b8:35:0d:ed:27:5e:a6:64:c1:7a:1b
Note that the SSL certificate for our Subversion repository is different
from certificates used when logging into Apache infrastructure -
please [see the New Committer guide](http://www.apache.org/dev/new-committers-guide.html#spoof) for more information.
# Problems with Subversion? # {#svnproblems}
## "Error validating server certificate" errors ## {#no-trusted-root-cert}
:::text
Error validating server certificate for 'https://svn.apache.org:443':
- The certificate is not issued by a trusted authority. Use the
fingerprint to validate the certificate manually!
Certificate information:
- Hostname: *.apache.org
- Valid: from Tue, 20 Dec 2011 00:00:00 GMT until Mon, 17 Feb 2014 23:59:59 GMT
- Issuer: Thawte, Inc., US
- Fingerprint: bc:5f:40:92:fd:6a:49:aa:f8:b8:35:0d:ed:27:5e:a6:64:c1:7a:1b
(R)eject or accept (t)emporarily
On some platforms, the root Thawte certificate, used to sign the Apache
SSL cert, is not made available to OpenSSL and Subversion. Fix this by
downloading the Thawte root certificate, and updating your Subversion
`servers` file accordingly to use it for SSL validation:
- Save the [Thawte root certificate] (in .pem format) to a suitable path,
for example, in your `~/.subversion/` directory, or on Windows, in
`%USERPROFILE%\AppData\Roaming\Subversion\` folder.
- In the servers file, found in the same folder, add the following to
the `[global]` section, adding the section if required, and
amending the path appropriately:


[global]
ssl-authority-files = /full/path/to/thawte_Premium_Server_CA.pem
ssl-trust-default-ca = true

Re-trying the Subversion operation should now succeed. In some cases,
you may additionally need to move to a more recent svn client, version,
1.6 or higher should be sufficient.

[Thawte root certificate]: https://www.thawte.com/roots/thawte\_Premium\_Server\_CA.pem

## "svn: No such revision 765287" errors ## {#out-of-sync}

If you're getting an error message like the following:

:::text
svn: No such revision 765287

This may be because of a short lag in the synchronization between
Subversion mirrors, and can occur if multiple commits are run immediately
after each other. This error will usually only happen if you are located in
Europe, or explicitly using the European mirror.

Waiting for 10 seconds and repeating the command should succeed.

## "specified baseline is not the latest baseline" errors ## {#latest-baseline}

If you're getting an error message like the following:

:::text
svn: Commit failed (details follow):
svn: The specified baseline is not the latest baseline, so it may not be
checked out.

This may be because of a short lag in the synchronization between
Subversion mirrors, and can occur if multiple commits are run immediately
after each other. This error will usually only happen if you are located in
Europe, or explicitly using the European mirror.

Waiting for 10 seconds and repeating the command should succeed.

## "Compressed stream invalid" errors ## {#compressed-stream-errors}

If you're getting an error message like the following:

:::text
svn: PROPFIND of '/repos/asf/foobar':
Compressed stream invalid (https://svn.apache.org)

That's a known issue in the neon client library which has been fixed in
neon 0.24.7. A workaround is to disable compression in your client. Edit
~/.subversion/servers. Uncomment the [global] section if necessary, and
add a line that reads

:::text
http-compression = no

And that should "fix" the problem until you can upgrade.

## Problems using date revisions ## {#date-revisions}

If you are using a date revision such as `-r{2004-09-12}:{2004-08-12}` and
not getting any or all of the revisions you expected, this is a known
problem specific to the ASF repository.

Unfortunately, there is nothing that can be done to improve this situation,
so you must use a workaround. You can use `svn log` or ViewVC to locate the
actual revision number that is first after the date you desire, and
substitute that into your `-r` argument to the `svn` command.

For example, consider the desired command:

$ svn diff -rHEAD:{2005-01-01}

When this produces no output, running `svn log` alone shows:

:::text
...
------------------------------------------------------------------------
r124032 | aheritier | 2005-01-04 09:58:16 +1100 (Tue, 04 Jan 2005) | 1 line

Switch to subversion
------------------------------------------------------------------------
r123911 | brett | 2005-01-03 09:48:57 +1100 (Mon, 03 Jan 2005) | 1 line

remove nagoya references
------------------------------------------------------------------------
r116173 | brett | 2004-10-23 22:11:51 +1000 (Sat, 23 Oct 2004) | 2 lines

remove old requires descriptions
...

So, the comand above should become:

$ svn diff -rHEAD:123911

The particular reason this occurs is because the order of the revisions is
not identical to the order of dates in the repository. This is a side
effect of loading CVS repositories with history with dates prior to the
latest date in the Subversion repository.

# Frequently Asked Questions # {#FAQ}

## When Do I Need To Use svn lock? ## {#lock}

Very rarely. Commits in subversion are
transactional. This means that locks are almost always unnecessary.

An oft quoted use case is to prevent concurrent editing of a large
unmergeable binary document. However, for open development, good
communication is preferable to locking even in this use case. A good timely
post to the list letting your fellow developers know that you're going to
start editing that huge PDF is better than locking the file.

## How frequently can I run a cron that connects to the repository? ## {#poll}

Hourly is fine. Please do not use programs that poll the repository more
frequently than hourly. People who run automated scripts that continuously
poll the repository wind up getting their access denied, which may impact
other folks connecting through the same host. If you need to stay more
in-sync than an hourly cron allows, subscribe your script to the relevant
commit mailing list.

## How do I mirror the entire SVN repository for my experimental $foo? ## {#mirror}

First, ask yourself: do I really want the *entire* ASF repository? Generally
most people really want only a single project. In that case, just checkout that
source directory from the repo.

If you really do want the entire ASF repository, *don't* use svnsync. Instead,
start by looking here: [http://svn-master.apache.org/dump/][1] Use that to bootstrap
your repo.

## Why Do I Get a 403 When I Try To Commit? ## {#commit-403}

Run `svn info` and check that the URL starts with https://. If it starts with
http://, run:

$ svn switch --relocate http://svn.apache.org https://svn.apache.org

If you still get 403 Forbidden errors, ask your PMC to double-check the authz
file and LDAP/Unix group membership.

[1]: http://svn-master.apache.org/dump/
See <a href="https://infra.apache.org/svn-basics.html">Subversion basics</a>

0 comments on commit 823e4c8

Please sign in to comment.