topo研发管理系统安装维护手册

1、Topo 研发管理系统安装Cloudtopo, 12/18/2010手册摘要本文介绍如何安装、运行、卸载、Topo研发管理系统。内容1. 简介2系统需求2服务器端需求2客户端需求2安装TOPO2安装TOPO2安装安装SUBVER.13.224. 运行TOPO255. 卸载TOPO286.TOPO29基本设置29数据库备份30文件备份347. 疑难解答34Hangzhou Cloudtopo Technology Co.,.第1页共36页1.简介Topo是云图科技面向研发管理的创新，在的下提供了研发项目管理、流程管理、团队协作的完整解决方案。Topo集成的项目管理解决方案便于研发团队迅速实施Sc

2、rum等敏捷项目管理；基于可定义的工作流和角色的流程系统可以帮助客户优化和改善流程；Topo还在制、Wiki等团队协作工具。下提供了诸如集成源代码控本文介绍如何安装、运行、卸载Topo，并给出了常见问题的解决方法。2.系统需求Topo基于Browser/Server架构，因此Topo只需要在服务器端安装，在客户端，并不需要安装额外的，用户通过浏览器就可以直接Topo了。2.1服务器端需求Topo在服务器端的需求如下：操作系统：Windows XP，Windows 2003 Server，Windows 7，Windows 2008 Server，Linux内存：至少2G，4G硬盘空间：至少剩余

3、500M（不含用户数据）数据库系统：、HSQLDB对于数据库系统，Topo内置了一个数据库系统，可以满足评估试用的需求，但如果做正式产品应用，使用5.x版本，和Topo可以安装在同一个服务器上，也可以在不同的服务器上，用户在安装Topo时可以对这些进行设定。2.2客户端需求操作系统：Windows，Linux，Mac OS浏览器：ernet Explorer 6.0+，Mozilla Firefox，Chrome, Apple Safari等3.安装Topo本章介绍如何安装Topo，由于Topo需要使用数据库系统，因此在Topo的安装程序时可以选择含安装程序的绑定版本，使用这个集成的Topo安

4、装程序会在Topo安装结束后提示安装。Topo可以和Subver（以下简称SVN）绑定，支持代码的浏览和检视，因此Topo的集成安装包中也包含了SVN的安装程序，可以在安装Topo结束后提示安装SVN，用户也可以根据需要自行选择。3.1安装Topo运行Topo安装程序：Hangzhou Cloudtopo Technology Co.,.第2页共36页这里选择的是安装过程的语言，不会影响安装后的服务器的语言设置，所以击确定。以中文为例，所以直接点这是安装过程的欢迎页面，直接点击下一步：Hangzhou Cloudtopo Technology Co.,.第3页共36页这个页面显示Topo的协议

5、，请仔细阅读，并点击我接受协议，然后点击下一步：这一步需要输入Topo的License，Topo的License可以在上申请得到，上述界面的第二个编辑框的内容（DEGENWWGVFJRBMEFPNOSTUDKMN）是号，可能在申请License时需要填入。Hangzhou Cloudtopo Technology Co.,.第4页共36页请将申请得到的合法的License拷贝到第一个输入框中，并点击下一步，安装程序会检查License的，如果License不合提示License无效，然后进入下面的界面：这一步设置Topo运行所要使用的端口，一般使用80作为Web服务器端口，但如果你已经在这台服

6、务器上运行了Web服务，那么这里可以选择一个不同的端，比如8080，设置好后，点击下一步：Hangzhou Cloudtopo Technology Co.,.第5页共36页这里选择Topo所用的数据库源，可以选择数据库或者数据库服务器，请按照情况选择，如果选择数据库服务器，那么点击下一步之后将出现下面的界面设置具体的数据库参数：这个页面配置数据库属性，在数据库服务器一栏输入数据库所在的服务器，以举例，如果安装在同一台服务器上，数据库服务器填写:/localhost就可以了，数据库名是Topo所要使用的数据库名，一般使用topo，下面是这个数据库的用户名和，注意如果这个数据库用户有创建数据库的

7、权限，那么在Topo第一次启动时，会自动检测并创建数据库，但如果这个数据库用户没有相应的权限，则需要用户事先创建好数据库。设置好后，点击下一步：Hangzhou Cloudtopo Technology Co.,.第6页共36页这里用于设置Topo服务器的缺省语言和时区，以中文和+8区为例进行设置，点击下一步：缺省会安装到c:topo目录，用户可以选择将Topo安装到其它目录。Topo安装目录将会包括将来Topo运行过用户上传的附件、文档，因此这个目录需要考虑备份，这里以d:topo为例，点击下一步：Hangzhou Cloudtopo Technology Co.,.第7页共36页这里可以选

8、择是否要为Topo创建桌面图标或是快速启动栏图标，如果都不选，安装后也可以通过开始菜单来运行Topo，点击下一步：这一步给出前面所有设置的小结，请确认所有的配置参数是否正确，如果不正确，可以通过上一步回去设置，如果没有问题，则点击“安装”开始Topo的安装。Hangzhou Cloudtopo Technology Co.,.第8页共36页请稍候，安装程序会显示安装的进度，安装完成后，如果你下面的界面：的Topo版本含有安装程序，会看到Hangzhou Cloudtopo Technology Co.,.第9页共36页如果想安装5，选中上面的安装选项就会自动启动安装程序，具体安装方法参考3.2

9、一节，否则点击下一步，如果你的安装集成有SVN安装程序，将会看到：这里可以选择是否运行SVN的安装程序和SVN仓库创建向导，如果你已经安装好SVN并创建好了仓库，可以不选这两个选项，否则勾选“安装Subver”将会安装Subver，安装Subver的过程可以参考下面的3.3节，如果你已经安装好SVN，但没有创建SVN仓库，可以只勾选下面的“运行Subver”，勾选这个将会在下一步后看到下面的界面：仓库创建向导Hangzhou Cloudtopo Technology Co.,.第10页共36页这个界面就是SVN仓库创建向导的第一步，为了创建一个SVN仓库，这里你需要输入仓库所在的目录，一定要是

10、一个不存在的目录，向导会自动把这个目录创建起来，然后要为仓库创建具有读写权限的用户及密，比如在用户名的地方输入jack;tom，在的地方输入pass1;pass2，就会码，可以输入多个用户名和创建两个用户jack和tom，分别为pass1和pass2，还需要在这里指定安装SVN所在的目录，因为仓库创建向导需要调用SVN程序去创建仓库，设好后，点击下一步，可以看到向导的下一个界面:Hangzhou Cloudtopo Technology Co.,.第11页共36页这里设置SVN仓库的权限，选择后，点击下一步：这里可以选择是否将这个仓库创建为Windows服务，如果选中“创建Windows服务并

11、启动服务”，Topo会自动为新创建的仓库创建一个Windows服务，这样就可以在服务器启动后立刻这个库了，到这里SVN仓库向导设置完毕，点击下一步就会看到一个小的Dos窗口来做SVN仓库的创建动作，完成后，可以看到下面的界面：Hangzhou Cloudtopo Technology Co.,.第12页共36页这里有两个选项，“将Topo安装为Windows服务”会创建为一个Windows服务，下次启动计算机之后，Topo会以服务形式自动运行，并且不需要Windows的用户登录。“运行Topo”可以在安装结束后立刻运行Topo。到这里，Topo安装已经完成，点击“完成”关闭Topo安装程序。3

12、.2安装Topo安装包集成了的安装程序，如果在安装Topo时选中了安装，将会看到下面的界面：点击Next：Hangzhou Cloudtopo Technology Co.,.第13页共36页这里选择安装的模式，选择Custom模式，这样后面可以进行基本的设置，然后点击Next:的安装组件和安装目录，这里使用缺省值就可以了，点击Next：选择Hangzhou Cloudtopo Technology Co.,.第14页共36页这里再检查一下安装设置，然后点击Install：Hangzhou Cloudtopo Technology Co.,.第15页共36页正在安装，安装过会显示的一些介绍，可

13、以点击Next过去，安装完成后，会显示下述界面：选中上面的Configure theServer now选项，点击Finish，就会开始的配置向导了：Hangzhou Cloudtopo Technology Co.,.第16页共36页点击Next进入下一步：服务的运行方式，选择Developer Machine将使用较少的内存，但性能较差，而选择Server Machine将占用最多的资源，而选择Server Machine则介于两者之间，所以这个选项这里选择Dedicated要根据情况来做出选择，如果不能确定，则选择Server Machine，然后点击Next:Hangzhou Clou

14、dtopo Technology Co.,.第17页共36页这里需要选择Database Only，的数据使用Tran引擎，对于Topo，这里需要选择Multifunctional Database或者Tran ional Database Only，然后点击Next：ionalHangzhou Cloudtopo Technology Co.,.第18页共36页这里配置数据文件的位置，由于数据文件涉及到备份操作，因此这里要结合用户数据备份的方案来考虑，然后点击Next：的并发连接数，上面的两个选项分别为20用户和500用户，也可以选择第三个选项来手动设置，设置根据用户的实际情况设置这里的连接

15、数，并点击Next：Hangzhou Cloudtopo Technology Co.,.第19页共36页这里设置端，保持缺省值就可以了，点击Next：这里要勾选Manual Selected Default Character Set/Collation，并设置Character Set为utf8，点击Next：Hangzhou Cloudtopo Technology Co.,.第20页共36页这里设置是否将然后点击Next：安装为Windows服务，一般都要选中，这样可以在服务器启动后自动运行，Hangzhou Cloudtopo Technology Co.,.第21页共36页这里可以

16、设置的root用户，缺省时的root用户为空，可以在这里设置一个root用户密码，这个步：需要和Topo安装时设置的选项一致，否则可能导致数据库连接问题，设置后点击下一到此， 置，并且配置完成，点击Execute，在这时已经运行了。写入配置完毕后点击Finish就完成了的安装和设3.3安装SubverSubver（以下简称SVN）是源代码版本控制工具，如果你不需要安装SVN，请跳过此节，Topo安装包集成了SVN的安装程序，如果在安装Topo过你选中了安装SVN，那么可以看到下面的界面：Hangzhou Cloudtopo Technology Co.,.第22页共36页点击下一步就好，可以看

17、到：Hangzhou Cloudtopo Technology Co.,.第23页共36页点击下一步，可以看到：这里选择将SVN安装到的目录，设置好后，点击下一步：Hangzhou Cloudtopo Technology Co.,.第24页共36页点击Install就开始安装SVN了，安装完成后，可以看到：点击Finish，SVN安装就完成了。4.运行Topo在安装好Topo后，就可以准备首次运行Topo了，在首次运行Topo之前，请确保以下条件：配置给Topo所用的端口没有被其他程序占据如果没有在安装Topo的最后一步选中运行Topo，Topo程序控制台界面：开始菜单中的Topo来启动To

18、po，就可以看到下述的Hangzhou Cloudtopo Technology Co.,.第25页共36页这个界面表示Topo已经开始运行，Topo在第一次运行时需要做一些数据库准备工作，因此启动速度会较慢，请稍等，正常启动后会看到下面的界面：Hangzhou Cloudtopo Technology Co.,.第26页共36页上面提示的Server startup in * ms就表示Topo已经启动成功，这时可以通过浏览器Topo了(如果安装时)，如果是在服务器本为Topo指定了非80的端机，那么使用，例如8080端口，这里应该通过来Topo服务器了，下面是第一次看到的界面：就应该可以H

19、angzhou Cloudtopo Technology Co.,.第27页共36页这时可以使用缺省的管理员帐号admin登录Topo了，用户名为admin，经成功。为admin。至此Topo的安装运行已* 注意：如果将Topo安装为Windows服务了，那么以后在服务器重启之后，Topo会自动以服务运行，不需要手动运行了，也看不到控制台的窗口。5.卸载Topo如果需要卸载Topo，执行下述步骤：先停止Topo服务运行Topo卸载程序，在开始菜单下的Topo菜单项下面选择卸载Topo，并点击“是(Y)”确认。Hangzhou Cloudtopo Technology Co.,.第28页共36页

20、卸载Topo不会自动删除数据库以及Topo安装目录下的用户数据文件，这些由用户决定是否删除。6.Topo6.1基本设置Topo的一些安装配置参数在安装完成后仍然可以修改，在开始菜单中找到topo，并运行“设置看到下面的界面：Topo”可以这里，可以直接修改Topo的数据库相关设置、Web相关设置及License。这些设置在改变后都需要重启Topo才能生效。数据库相关设置Web相关设置Hangzhou Cloudtopo Technology Co.,.第29页共36页DB Type（数据库类型）可选和hsqldb，hsqldb是数据库，无需外部数据库支持。DB Server（服务器）数据库服务

21、器，只对 有意义，如果 数据库服务器没有使用标准端 ，这里可以用host:port格式来设置端 。DB Name（数据库名）Topo所用的数据库名，只对有意义。DB User（用户名）连接数据库所用的用户名，只对有意义。DB Password（）连接数据库所用的，只对有意义。6.2数据库备份日常的数据库备份是很重要的Topo工作，对于，对数据库做定期的备份，以Administrator为例来说明如何做定期备份。首先，启动Administrator，如下图：这里没有Stored Connection，而使用Administrator做定期备份，需要一个Stored Connection，所以我A

22、dministrator界面，选择Tools下的Options进们这里先填写入设置界面：的服务器和登录用户及，进入Hangzhou Cloudtopo Technology Co.,.第30页共36页Http Port（Http端）Topo的Web服务所用的端，注意这个端不能和服务器上其他服务端口。Https Port（Https端）配置HttpsWeb时所用的端，并且可设置使能，如果不使能，Https端口不开放。Ajp Port（Ajp端）配置Ajp协议端，这个在Topo服务器做负载均衡时使用，一般不使能。Jvm Route这个设置也只在负载均衡时使用。这里在General Options中

23、选择页面，见下图：Store passwords，并设置方法为Obscured，然后点击左边的“Connections”Hangzhou Cloudtopo Technology Co.,.第31页共36页这里，选择“New Connection”建立一个数据库连接，并设置好，这样就设置好一个StoredConnection了，应用之后，退出 Administrator，然后Administrator，并使用刚刚建立的开始创建备份：数据库连接重新登录到Hangzhou Cloudtopo Technology Co.,.第32页共36页这里，按照上图的顺序：.5.选择Backup

24、功能选择“New Project”建立一个新的备份为这个备份项目起一个名字选择一个数据库（你的Topo的安装数据库，缺省情况下应该是“topo”）将数据库加入到Backup Content中。这里就设置好了需要备份的数据库，点击上方的Schedule，进入周期设置界面：Hangzhou Cloudtopo Technology Co.,.第33页共36页这里设置周期备份的路径和周期的具体时间，比如上图中是设置到了每个工作日的凌晨2:00，再点击“SaveProject”就可以保存下这个备份了（可能需要按提示输入管理员账号）。6.3文件备份除了数据库外，Topo在运行过产生的一些文件，比如流程附件、文档库文档、模板文件，会生成在Topo安装目录下的data子目录下，这个目录下的几个包含数据的子目录含义如下：将这几个目录也和数据库文件一样定期备份，这样Topo的数据就完整备份了。7.疑难解答这里介绍一下在Topo安装和运行过1.Web端口被占用用户可能遇到及解决方法。这是一种常见的Topo安装问题，参考下面的图示：Hangzhou Cloudtopo Technology Co.,.第34页共36页_library文档库文档、流程附件。hsql数据库（仅在使用数据