关于Maia(迈亚)SVN用户管理系统

关于此系统的介绍,请参阅帖子:http://www.scmbbs.com/cn/maia/2009/6/maia1.php

 

Maia(迈亚)SVN用户管理系统系统的安装

假设你的系统已经支持PHPapachemysql(如果没有配置,请参阅相关文章),则部署“迈亚SVN用户管理系统(下简称svnMaia)”非常简单。

1、            下载程序包。

到:http://www.scmbbs.com/maia/ 下载最新安装程序包

2、            解压/拷贝程序文件,并上传到SVN服务器某个目录。

请选择合适的解压缩程序解开发行包,然后通过FTP软件上传到SVN服务器的某个目录,此目录通过http协议可以访问。强烈建议放在apache网络空间的根目录。

3、            修改目录的权限

上传之后,确保apache的运行用户对该目录具有可写权限。或者你为setup/config/scheme/目录单独赋予写权限:

chmod o=rwx setup config scheme

4、            访问setup.php页面,生成config.inc文件:

访问http://***.com/svnMaia/index.php页面(如果出来的页面为空白或者报错,则表明你的系统没有正确安装php),根据页面提示填写参数,生成svnMaia配置文件config.inc。如图:

图表 1迈亚svn用户管理系统安装界面

 

在此步骤中,本系统将试图创建数据库、数据表,并将信息保存到config.inc文件中(请确保此文件无法通过http访问)。

1)关于相关参数填写:

如果数据库链接用户名使用root,则系统可以自动创建数据库,无须你做更多操作。

 

作为另一种选择,您也可以在mysql数据库系统中手工创建数据库:

mysql> create database svnMaia;

然后在上面界面中填入适当的数据库链接用户名和密码。默认安装下,mysql的超级管理员用户名是:root,密码为空。你可以在svnMaia系统中使用此用户名来管理数据库,也可以为Maia单独创建链接用户:

mysql> GRANT ALL PRIVILEGES ON svnMaia.* TO UserName@localhost IDENTIFIED BY 'Password' WITH GRANT OPTION;
上面的UserNamePassowrd请分别换成你自己的用户名和密码。
也可以使用phpMyAdmin来建立此数据库。

 

svn超级用户root密码:svnMaia系统在创建时为自身创建一个超级用户root,你可以通过root登陆svnMaia系统进行用户管理、权限管理等操作,因此,你应当在此设置一个尽可能复杂的密码。

 

2)填写好上述参数后,点击【确定】按钮。通常情况下会提示如下错误:

Fatal Error:不能写入到文件 /home/apache/htdocs/config.inc ! 保存失败!原因可能是此程序owner没有足够权限修改此目录文件,请修复!
这是个致命错误,建议您手工创建此文件,并包含如下内容:
<?php
define("SERVER","localhost:3306");
define("USERNAME2","root");
define("PASSWORD2","");

遇到此情况时,你可以按其提示操作即可。创建完config.inc文件后,点击【下一步】。

 

3)点击【下一步】后进入系统设置界面。如图:

图表 2 迈亚svn系统设置界面

 

在此界面中将相关信息填写完整。其中:

l         权限控制文件路径、用户文件路径和svn仓库路径为必填项目。这几个变量是本系统正常工作的基础。

l         Svn父目录url在权限管理界面中会用到。用来支持快速定位路径权限和组成svn的实际url

l         Htpasswd路径、svnlook路径根据你系统的情况填写。如果系统不认识这几个命令,则需要填写其所在的系统绝对路径。如果svnlook参数有误,则无法在权限管理界面中浏览配置库目录;如果htpasswd参数有误,则无法添加新用户和修改密码。

l         邮箱后缀:请正确填写你公司的邮箱后缀,尽量保持成 svn用户名+公司邮箱后缀=用户实际邮箱”的公式。这样有利于得到本系统的自动发邮件通知服务。

 

填写完整后,点击【提交保存】。

 

5、            善后工作

上述设置完成后,svnMaia就可以正常使用了。但为安全起见,你还应:

l         删除 setup/setup.php文件。

l         拷贝/default.htmindex.php(即覆盖掉原来的index.php

此时,你可以通过类似如下链接进行访问svnMaia

http://***/svnMaia/index.php

 

6、            初始化

能正常访问后,在开始正式工作前,你可以进行初始化工作:

点击上方“工具”菜单à初始化:

图表 3 svnMaia初始化数据

相关错误提示处理

1、界面空白,无任何提示或提示下载文件:

原因:你的系统没有安装php

2、提示“Call to undefined function mysql_connect()”:

原因:你的php不支持mysql。请重新安装php,使之支持mysql(请参阅相关文章)。

3、在“权限管理”界面中,左侧导航栏为空

原因:在【设置】中没有正确配置svnlook路径。如果svn路径位于:/usr/local/etc/bin/svn,则svnlook路径填写:/usr/local/etc/bin/

4、【生成用户文件】或【生成权限文件】时提示“写入失败”

    原因:apache运行用户对此两文件没有写权限。应将此两文件的属主改为apache运行用户。