1   背景假设

厦门央瞬公司是一家电子元器件设备供应商，其中有个ARM部门，专门负责ARM芯片的方案设计、销售，并在北京、上海各设立了一个办事处。对于工作日志，原先采用邮件方式发给经理，但是这种方式有个缺点，那就是不具备连续性，要看以前的日志必须一封一封邮件去查看，很麻烦。于是就想到利用 Subversion， 让员工在自己电脑上编辑日志，然后利用svn传送回来，既方便员工自己编写日志，又方便对日志的归档处理，而且提交日志的时候只需要执行一下 svn update 即可，比发送邮件还要简单的多。

• svn服务器相关信息

  • 服务器地址： 192.168.0.1
  • 服务器OS： MS Windows 2000 Server Edition 中文版
  • 代码库本地目录： D:\svn\arm

• arm部门文档的目录结构如下:

  arm                 部门名称
      ├─diary           工作日志目录
      │  ├─headquarters    总部工作日志目录
      │  ├─beijing         北京办日志目录
      │  └─shanghai        上海办日志目录
      ├─ref             公司公共文件参考目录
      └─temp            临时文件目录
      

• 人员情况

  • morson，公司总经理，其实他不必亲自看任何东西，就连部门经理们的每周总结都不一定看。但是为了表示对他的尊敬，以及满足一下他的权力欲，还是给他开放了“阅读所有文档”的权限
  • michael，arm事业部的部门经理，没事的时候喜欢弄点儿新技术，用svn来管理日志，就是他相处来的主意
  • scofield，北京办人员，老员工，为人油滑难管
  • lincon，上海办人员，老员工，大老实人一个
  • linda，总部协调员、秘书，文笔不错，长得也不错
  • rory，单片机技术员，技术支持

• 访问权限需求分析

  • 允许总经理读取所有文件
  • 除部门经理外，所有其他人员，均只能看到本办事处人员工作日志
  • 不允许匿名访问
  • ref目录只允许经理和秘书写，对其他人只读
  • temp目录人人都可以写

D:\svn>svnadmin create arm

[general]
password-db = passwd.conf
anon-access = none
auth-access = write
authz-db = authz.conf

[users]
morson = ShowMeTheMoney
michael = mysecretpassword
scofield = hellolittilekiller
lincon = asyouknows111
rory = 8809117
linda = IlikeWorldCup2006

[groups]
g_vip = morson
g_manager = michael
g_beijing = scofield
g_shanghai = lincon
g_headquarters = rory, linda
g_docs = linda
[arm:/]
@g_manager = rw
* = r
[arm:/diary/headquarters]
@g_manager = rw
@g_headquarters = rw
@g_vip = r
* =
[arm:/diary/beijing]
@g_manager = rw
@g_beijing = rw
@g_vip = r
* =
[arm:/diary/shanghai]
@g_manager = rw
@g_shanghai = rw
@g_vip = r
* =
[arm:/ref]
@g_manager = rw
@g_docs = rw
* = r
[arm:/temp]
* = rw

svn co svn://127.0.0.1/arm --no-auth-cache --username rory --password 8809117

arm
├─diary
│  └─headquarters
├─ref
└─temp

password-db = passwd.conf

anon-access = none
auth-access = write

authz-db = authz.conf

[groups]
# 任何想要查看所有文档的非本部门人士
g_vip = morson
# 经理
g_manager = michael
# 北京办人员
g_beijing = scofield
# 上海办人员
g_shanghai = lincon
# 总部一般员工
g_headquarters = rory, linda
# 小秘，撰写文档
g_docs = linda

[arm:/]
@g_manager = rw
* = r

[arm:/diary/headquarters]
@g_manager = rw
@g_headquarters = rw
@g_vip = r
* =

[diary:/]
@g_chief_manager = rw
[diary:/arm]
@g_arm_manager = rw
@g_arm = r

[diary:/]
@g_chief_manager = rw

[diary:/]
# @g_chief_manager = rw

[arm:/diary]
* = r

CFLAGS = -g -O2 改为CFLAGS = -fPIC -g -O2即可
改后必须make distclean->./configure->make才行

别的也没什么，感觉64位的机器比32位的略显麻烦而已。
个人感觉安装时大可不必看那些日志，刷得太快也看不清楚，直接加上>/dev/null只看报错信息即可。

Contents

I Introduction/Notes

So you decided (or you have been told) to install Subversion. Then all you have to do now is lean back and enjoy the ride, because we did all the work for you already. This document will save you a hack of a lot of time (and it might even make you the employee of the month).

We didn’t feel like typing two different download URLs for all the Solaris 8 and 9 packages. Hence we only used the Solaris 8 paths. In most cases you only have to replace the 8 with a 9 in the FTP paths and package names.

Please note that this guide is about compiling and installing Subversion and all the programs that it depends on from source. In case your hand moves in the direction of your head and makes a scratching motion when you hear the word “compile”, this guide might not be for you. You can get pre-compiled packages for just about any OS by now. That is definitely the easier way to go.

The section about configuring and setting up the Subversion server might be interesting for you even if you don’t compile everything from source, though.

In case this document actually helps you, we’d be very grateful if you would nag your employer about some t-shirts, mugs and other free stuff for us. (Whoever is reading this and actually is considering sending us something: You’re the first one, man! More power to you!)

Anyway, have fun (and success) installing Subversion!

PS: I guess I have to say this: I am not responsible for any damage that might be caused by following this guide!

II Step by Step Installation

1. Create a directory for all the source files that you’ll have to download and compile in the next steps. I’ll call this directory /basedir

2. Go to http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=260 and download the newest Subversion source tarball (save it in /basedir).

3. Open a shell and become the superuser:

su -

4. Go to the basedir and unpack the Subversion source files:

gunzip subversion-1.2.3.tar.gz

tar -xvf subversion-1.2.3.tar

5. Change into the subversion-1.2.3 subdirectory and run the autogen.sh script:

cd subversion-1.2.3

./autogen.sh

6. The script checks if all of Subversion’s dependencies are installed. When the script coughs up this error message:

“Can’t locate object method “path” via package “Request” at

/usr/local/share/autoconf/Autom4te/C4che.pm line 69, <GEN1> chunk 111.”

the directory “autom4te.cache” in the subdirectory “expat” of Subversion has to be deleted:

rm -r /basedir/subversion-1.1.1/apr-util/xml/expat/autom4te.cache

When the script says that one of the following things is not installed or not recent enough, then please follow the next steps and run autogen.sh again to check if everything’s OK now. Of course you can also download and install the newest versions of these tools and libraries, even if the installed versions are sufficient.

In case the script says that everything’s fine (autoheader warnings can be ignored) continue with step 7. If the script complains:

a. autoconf/autoheader: Continue with Appendix A.

b. libtool: Continue with Appendix B.

c. m4: Continue with Appendix C.

d. Python: For Linux continue with Appendix D. For Solaris continue with Appendix E.

e. Libxml2: Continue with Appendix F.

f. neon lib: Doesn’t have to be downloaded because it comes with the Subversion source files.

7. Go to http://www.sleepycat.com/download/index.shtml

and download the newest source tarball of Berkeley DB (either with or without strong cryptography, it doesn’t matter). Save it in /basedir.

20. Go to http://httpd.apache.org/download.cgi

and download the newest source tarball of the Apache2 httpd server. Save it in /basedir. Sometimes

the download fails if you use http. In that case, do this:

ftp ftp.uni-erlangen.de

cd /pub/mirrors/apache/httpd/

ls

Then find the newest tarball and download it, i.e.:

binary

mget httpd-2.0.55.tar.gz

y

bye

21. Extract the Apache source files in basedir:

gunzip httpd-2.0.55.tar.gz

tar -xvf httpd-2.0.55.tar

22. Change into the httpd-2.0.55 directory

23. Run buildconf:

./buildconf

autoheader warnings can be ignored.

24. Run configure:

./configure --enable-dav=shared --with-gdbm=no --enable-deflate=shared --enable-so --with-berkeley-db=/usr/local/BerkeleyDB.4.3 --with-dbm=db4

30. Run configure:

./configure --with-berkeley-db=/usr/local/BerkeleyDB.4.3 --with-apxs=/usr/local/apache2/bin/apxs --with-apr=/usr/local/apache2 --with-apr-util=/usr/local/apache2

In case BerkeleyDB.4.3 has been installed in it’s default directory, the configure script of Subversion version 1.0.2 and higher finds the BerkeleyDB libraries automatically. In that case, you can run configure without "--with-berkeley-db".

Watch out for any messages that say that only a Subversion client can be built. In that case, something went wrong.

31. Run make:

Now you can run make:

make

32. Maybe the coffee you made in step 26 causes a certain pressure inside of you….

Now would be the perfect opportunity to get some relief!

33. Run make install:

make install

34. Clean up:

make clean

35. Change into the directory /basedir/subversion-1.2.3/tools/xslt

36. Copy the contents of the directory into the Apache2 htdocs directory:

cp * /usr/local/apache2/htdocs

37. Create the group “svn”:

38. Create the user “svn”:

39. Set the password for the user “svn”:

passwd svn

40. Create the repository (you can change the path below to anything you like, but I will keep using it as an example path in this document). Execute this as root:

cd /usr/local

mkdir svnrepos

chown svn:svn svnrepos

ATTENTION: THE REPOSITORY MAY NOT RESIDE ON AN NFS DRIVE!

41. Create the repository as the user “svn”:

su svn

svnadmin create /usr/local/svnrepos

(If you get an error at this point saying thay some libs could not be found, set the LD_LIBRARY_PATH as described in section 19b and try again)

exit

42. Set up Apache. Change into the Apache2 conf directory:

cd /usr/local/apache2/conf

43. Fire up your favorite editor and open the httpd.conf file.

44. Make sure the file contains the following lines:

LoadModule dav_svn_module modules/mod_dav_svn.so

LoadModule authz_svn_module modules/mod_authz_svn.so

There lines have to appear before any other statements that have to do with Subversion!

45. Find the line that starts with “Listen” and set its value to the port that Apache should listen on, i.e.:

Listen 7770

46. Finde the line that starts with “#ServerName” an set it to the name of your server:

ServerName subversion.yourdomain.com

47. Find the area that contains the <Location> directives and add the following text to it (”/rep” being a virtual path of your choice under which the repository will be served and “/usr/local/svnrepos” being the absolute path of the repository):

<Location /rep>

  DAV svn

  SVNPath /usr/local/svnrepos

  SVNIndexXSLT “/svnindex.xsl” # (optional, to make it pretty)

  AuthType Basic

  AuthName “Subversion repository”

  AuthUserFile /etc/.svn-auth-file

  Require valid-user

</Location>

Your repository can be found at http://subversion.yourdomain.com:7770/rep later.

The Auth directives are important for access control. You can choose the path and filename for the AuthUserFile directive. You have to remember that path and the filename though because we have to create that file later, for the usernames and passwords.

48. Save and close the httpd.conf file.

49. Create the access control file for the users that should be allowed to use Subversion:

htpasswd -cm /etc/.svn-auth-file johannes

Repeat this with the option -m instead of -cm until all the users are created (replace “johannes” with the appropriate usernames, of course)

50. Change into the /usr/local/ directory

51. Make the user “svn” the owner of all Apache files and directories:

chown -R svn:svn apache2

52. Become the user svn:

su svn

53. Change into the /usr/local/apache2/bin directory

54. Fire up the Apache2 server:

./apachectl start

55. Open a web browser and go to

http://subversion.yourdomain.com:7770/rep

The page should display something like this:

Revision 0

/

Powered by Subversion 1.2.3

56. The Subversion server is now set up and ready to be used (congratulations)!

57. If you encountered any problems or if you know how to do it better, drop me a line at moremagic<N0 5PAM>.dot.gmail.dot.com Thanks.

III Appendices

APPENDIX A: autoconf Installation

A1. Go to http://ftp.gnu.org/gnu/autoconf/ and download the newest source tarball of GNU autoconf (save it in /basedir).

A2. Extract the autoconf source files in the basedir:

gunzip autoconf-2.59.tar.gz

tar -xvf autoconf-2.59.tar

A3. Change into the autoconf-2.59 directory

A4. Run the configure script:

./configure

A5. Run make:

make

A6. Run make install:

make install

A7. Clean up…:

make clean

A8. Done.

APPENDIX B libtool Installation

B1. Go to http://ftp.gnu.org/gnu/libtool/ and download the newest source tarball of GNU libtool (save it in /basedir).

B2. Extract the libtool source files in the basedir:

gunzip libtool-1.5.8.tar.gz

tar -xvf libtool-1.5.8.tar

B3. Change into the libtool-1.5.8 directory

B4. Run the configure script:

./configure

B5. Run make:

make

B6. Run make install:

make install

B7. Clean up…:

make clean

B8. Done.

APPENDIX C m4 Installation

C1. Go to http://ftp.gnu.org/gnu/m4/and download the newest source tarball of GNU m4 (save it in /basedir)…

C2. Extract the m4 source files in the basedir:

gunzip m4-1.4.4.tar.gz

tar -xvf m4-1.4.4.tar

C3. Change into the m4-1.4.4 directory

C4. Run the configure script:

./configure

C5. Run make:

make

C6. Run make install:

make install

C7. Clean up…:

make clean

C8. Done.

APPENDIX D Python Installation under Linux

D1. Gehe zu http://python.org/ftp/python/2.4.2/ and download the newest source tarball of Python (save it in /basedir)

D2. Extract the Python source files in the basedir:

bzip2 -d Python-2.4.2.tar.bz2

tar -xvf Python-2.4.2.tar

D3. Change into the Python-2.4.2 directory

D4. Run the configure script:

./configure

D5. Run make:

make

D6. Run make install:

make install

D7. Clean up…:

make clean

D8. Done.

APPENDIX E Python Installation under Solaris

E1. Download this file: ftp://sunsite.informatik.rwth-aachen.de/pub/mirror/ftp.sunfreeware.com/sparc/8/python-2.4.2-sol8-sparc-local.gz (save it in /basedir)

E2. Extract the Python binaries for Solaris:

gunzip python-2.4.2-sol8-sparc-local.gz

E3. Install the package:

pkgadd -d python-2.4.2-sol8-sparc-local

Confirm the question with <ENTER> (When an M appears, press <CTRL>+<ENTER>)

E4. Test Python:

python

If you get an error message at this point that libstdc++.so.5 can’t be found, continue with APPENDIX G

E5. Done.

APPENDIX F Libxml2 Installation

F1. Go to ftp://ftp.gnome.org/pub/GNOME/sources/libxml2/2.6/ and download the newest source tarball of libxml2 (save it in /basedir)

F2. Extract the libxml2 source files in the basedir:

gunzip libxml2-2.6.22.tar.gz

tar -xvf libxml2-2.6.22.tar

F3. Change into the libxml2-2.6.22 directory

F4. Run the configure script:

./configure

F5. Run make:

make

F6. Run make install:

make install

F7. Clean up…:

make clean

F8. Done.

APPENDIX G libgcc Installation (Solaris)

G1. Download this file: ftp://sunfreeware.nl.uu.net/pub/freeware/sparc/8/libgcc-3.4.1-sol8-sparc-local.gz (save it in /basedir)

G2. Extract the package in the basedir:

gunzip libgcc-3.4.1-sol8-sparc-local.gz

G3. Install the package:

pkgadd -d libgcc-3.4.1-sol8-sparc-local

Confirm the question with <ENTER> (When an M appears, press <CTRL>+<ENTER>)

G4. Done.

IV Acknowledgments

Thanks to Vasudeva Martin for the helpful additions to step 47.

Thanks to Ingo Brenckmann for the BerkeleyDB note at step 7.

Thanks to Dominik Fijalkowski for the configure note at step 24.

Thanks to Sebastian for the mod_deflate note at step 24.

Thanks to Joschka Reuss for the correction of the tar command at step 9.

   utils/

      calc/

         trunk/

         tags/

         branches/

      calendar/

         trunk/

         tags/

         branches/

      …

   office/

      spreadsheet/

         trunk/

         tags/

         branches/

      …

无论哪种规划，但是都必须遵循的一个原则就是必须符合你的项目的设计。

 $svn import . file:///path/to/repos –message ‘Initial repository layout’

.:代表当前目录

file段：代表1）中创建的仓库