StarTeam平台操作手册

1、starteam平台操作手册二00六年三月一、 对象和目标 谁可能从本教程中获得益处？ starteam初级用户 公司新员工 本教程目标 掌握starteam的基本操作 了解配置管理规范二、 starteam在配置管理中的作用 提供一个共享平台 安全可靠的文件管理 版本管理 项目周期开发中，进行有效的分支管理。三、 starteam基本操作(一) add server准确输入starteam 服务器的ip地址（2）以及端口号(49201)，并为这个设置在本地命名为“第一研究室”。(二) 登录项目出现服务器选择画面，如下所示：点击“log on as”按钮：出现登录画面成功

2、登录后，第一研究室自动展开，列出当前用户有权看到的所有项目选择“测试项目”，点击“完成”按钮，进入项目画面(三) 新建项目点击“project/new”菜单，出现如下画面：点击“下一步”，出现如下画面：选择工作目录，也就是项目在本地的位置，然后按“下一步”点击“完成”就可以了。(四) 选择视图选择“view/select view”菜单，出现如下画面：选择视图“项目样板”，点击“ok”即可(五) 创建视图选择“view/new”菜单，出现如下画面选择“下一步”选择子目录作为新的视图，点击“下一步”修改工作目录，如果采用默认得目录，将会造成和根视图冲突，点击“下一步”：选择视图标签（confiu

3、ration as of）或加入已有标签(labeld configuration)，也可以选择浮动配置。(六) 视图比较和合并选择“view/compare/merge”，选择项目，点击“完成”，出现视图比较画面分别选择不同的视图标签左右两边分别选择相同的目录，如果有不同的地方，将会在下面显示选择差异项，右键出现画面：选择合并或共享来获得想要合并的内容。(七) 选择标签 starteam的标签（view label）主要用来记录事件，如里程碑; 和代码分支没有必然的联系 starteam 的 label 是建立在视图中，针对一个view中所有文件，也就是view label。 view la

4、bel非常灵活，可以将后来新增加的文件加入到view label中。我们在使用时是将view label分为以下两种来进行标识 baseline label项目的基线标记 build label项目的构建标记标签分视图标签和修订标签，视图标签用于对整个视图作标记；修订标签用于对部分文件或目录打标记。标记的目的是为了取版本或文件的方便以及新旧版本的对照。假如我想取标记为buile #1014的版本，可以按如下操作：点击“ok”即可。标签在冻结前，可以自由的往标签中加内容，也可以从标签中移走内容。(八) 创建标签选择“view/label”，出现如下画面：如果是视图标签，将直接和当前视图附接，如果

5、是修订标签，将不附接任何内容。(九) 文件操作 上传文件 将需要载入的文件进行正确的标识后放到本地相应工作路径 在starteam中f5刷新，会看到该文件为not in view状态，选中文件，执行add in 操作即可。 在开发目录中中有部分类型文档是限制载入的，如：.pch,.scc, .dll, .exe, .obj, .clw, add in 操作： 主菜单中file-add files或右键菜单add files或工具条可以将文件上传到服务器。 添加文件时要注意：一定要将临时文件和二进制文件（编译过程的目标文件，可执行文件等）排除在外，以免引入数据垃圾。因为 starteam 很难将

6、文件彻底从服务器端删除。 更新文件 选中需要更新的文件，check out and lock 打开，编辑，保存（此时文件保存是在本地）。 在starteam中f5刷新一下，会看到刚才编辑的文件为modified状态。 选中文件，check in and unlock check out and lock便捷操作：工具条中 按钮 check in and unlock便捷 操作：工具条中 按钮 查看文件最新版本 all descants 按钮：是否展示子目录中文件。 查看一批文件：选中文件所在目录，在右上的展示框中选中文件（支持shift和crtl批量选择），点击工具条上 按钮，即可将文件che

7、ck out到本地相应目录。 查看所有文件：在主菜单中或者选中一个文件在其右键菜单中选择file-check out all菜单，即可将本项目所有文件一次性check out到本地相应目录。 便捷查看单个文件： 选中文件，双击，文件被打开。并且本地相应路径会有该文件的current版本。 查看文件历史和历史文件 查看文件历史选中文件，选择history按钮，在右下展示框中会有文件的历史信息：何时谁建立文件，何时谁修改文件等。 查看历史文件内容 选中历史信息，右键选择open revision content 文件properties选中文件右键properties菜单，或者主菜单file-pr

8、operties 文件状态 五种正常文件状态 not in view：文件在本地，不在服务器中(add files or delete) currut：本地和服务器中文件版本一致(无需任何操作) modified：本地文件版本比服务器中新(check in) out of date：服务器中文件版本比本地新(check out) missing：文件在服务器中，本地没有(check out) 两种不正常文件状态 merge：本地与服务器中文件版本有交叉(比较) unknown：starteam对文件状态的辨识有错误 (update status、统一客户端与服务器时间、 force check

9、 in或者force check out （但小心覆盖）)(十) 个性化设置 更改密码新添加的用户在第一次登陆时要求更改密码，如下图对话框： 如果需要修改密码可以按照以下操作进行：tools server administration选择所在的server点击my account 设定本地工作路径默认工作路径的设置 folder create working folders默认路径没有空间或者本地没有默认路径的磁盘号时候，可以在viewproperties中设置个性的本地工作路径。四、 starteam和开发环境的整合 starteam和delphi7的整合选择“select porject”

10、菜单，从服务器下载项目点击“ok”，就会将服务器上的项目取下来并使本地和服务器建立连结。选择“new project”菜单，可以从本地上传项目到服务器。当本地和服务器连接后，就可以操作文件了选择“check in file”上传文件和修改选择“check out file”从服务器取文件 starteam和.net环境的整合选择“pull solution”或者 “pull project”可以将解决方案或项目取到本地选择“place solution”或者“place project”可以将本地项目或解决方案上传到服务器选择“update project”菜单可以从服务器获取最新的版本，并保

11、存本地修改，如果发生冲突会提示合并。选择“commit project” 菜单可以将本地的修改保存到服务器上。选择“check in” 菜单可以将某一项或者几项的修改保存到服务器上选择“check out” 菜单可以将服务器上的指定的文件下载到本地选择“find” 菜单可以将得到项目的所有项列表以及每一项在服务器上的状态选择“compare contents” 菜单可以服务器和本地文件的区别选择“pending check out” 菜单可以将系统认为需要check out的所有文件列出来，供用户选择同理，选择“pending check in” 菜单可以将系统认为需要check in的所有文

12、件列出来，供用户选择选择“revert” 菜单系统将只取和本地文件相应的早期版本，不考虑后期版本。 starteam和java环境eclipse3.1的整合选择“synchronize outgoing”是本地修改模式，可以将文件和项目签出到本地，修改后通过synchronize with server 将修改的内容保存到服务器；选择“synchronize incoming”是服务器修改模式，表示修改来自服务器；选择“lock/unlock”表示对文件加锁，以便排他操作；选择“label”可以设定标签，标示项目的修改和进度。五、 starteam管理员备份 下面的文件必须备份： 配置文件st

13、arteam-server-configs.xml：这个文件在starteam server的安装目录，包含了数据仓库的信息以及sqlserver、数据源的相关信息。 数据库文件：必须记下数据库的名称，并用备份数据库命令备份 数据仓库hivearchives folder: *.*attachments folder: *.*或者干脆备份数据仓库的所有东西，记下仓库路径 备份方案： 建立任务：锁定starteam serverstcmd server-mode -s administrator:asec-huping:49201 -mode lock建立sqlserver任务：夜里0：00 备份数据库建立任务：夜里1：00起拷贝以上配置文件、数据仓库文件和数据库文件到指定目录；copy f:program filesborlandstarteam server 2005starteam-server-configs.xml c:backupforstarteamxcopy f:phutest c:backupforstarteam /e建立任务：解锁starteam se