JIRA集成VSS安装及操作指南

修改记录

目录

一、       目的：... 4

二、       环境：... 4

三、       集成前准备：... 4

四、       集成步骤：... 4

五、       效果展示：... 5

六、       注意事项：... 6

七、       待解决问题：... 9

一、         目的：

以任务作为作业单元，让项目相关人员通过配置库变化与分配任务的关联，可以清晰地了解项目各阶段（需求分析、设计、开发、测试、维护），各角色（项目经理、分析人员、设计人员、开发人员、测试人员）的工作进度及相对工作量，以此给公司管理者，项目管理者提供决策（项目计划、开发策略、变更策略）支持，也对配置管理中配置库的完整性和一致性有较大的帮助。

二、         环境：

JIRA 3.13-standalone

VSS 2005

JAVA JDK 1.5+

Ant 1.7.1

三、         集成前准备：

1.       下载最新版jira-vss-plugin-1.0-xxx.jar

（http://confluence.atlassian.com/display/JIRAEXT/JIRA+Visual+SourceSafe+Plugin）

2.       下载vss-jira-plugin.properties

（http://svn.atlassian.com/svn/public/contrib/jira/jira-vss-plugin/jars/）

3.       如果有集成旧版本，需要删除以下档案：

a)      JIRA_HOME/atlassian-jira/WEB-INF/lib下ant.jar 、ant-nodepds.jar和jira-vss-plugin-xxx.jar

b)        <JIRA index dir>/plugins/jira-vss-plugin下的档案

4.       下载vss-jira-plugin.license（https://my.atlassian.com/login）

5.       设置系统环境变量：

ANT_HOME=<ANT解压后目录>

JAVA_HOME=<JAVA安装目录>

CLASSPATH=%JAVA_HOME%\lib\tools.jar; %ANT_HOME%\lib\ant.jar

PATH=%JAVA_HOME%\bin;%ANT_HOME%\bin

四、         集成步骤：

1.       将最新版jira-vss-plugin-1.0-xxx.jar拷贝到JIRA_HOME/atlassian-jira/WEB-INF/lib

2.       将ANT_HOME/lib下ant.jar 和ant-nodepds.jar拷贝到

       JIRA_HOME/atlassian-jira/WEB-INF/lib

3.       编辑vss-jira-plugin.properties（参数说明详见该文件内文），然后拷贝到JIRA_HOME/atlassian-jira/WEB-INF/classes

4.       将vss-jira-plugin.license拷贝到

JIRA_HOME/atlassian-jira/WEB-INF/classes

5.       重新启动JIRA

6.       在项目明细页面会出现VSS Commits tab（别开心的太早，这只是一个“假象”，耐心看完吧。）

图4-1

五、         效果展示：

项目明细页面：

图5-1

任务页面：

图5-2

六、         注意事项：

1.       插件证书下载

图6-1

图6-2

图6-3

2.       为了及时获得VSS的最新修改记录，需要修改插件服务延迟时间

图6-4

3.       VSS客户端在check out/in时必须要填写JIRA中相应的任务编号。

图6-5

4.       vss-jira-plugin.properties中，属性值不能写中文。

5.       vss-jira-plugin.properties中，vss.username和vss.password一定要填写，除非该库允许匿名访问。

6.       vss-jira-plugin.properties中，vss.logDateFormatPattern属性值的格式应和windows的区域和语言选项中设置一致（中文系统默认为yy-MM-dd HH:mm）。

7.       每做完一次配置修改，最好将JIRA_HOME/work下的资料删除，并restart JIRA。

8.       定期清理JIRA备份目录下的档案，以释放空间。

9.       目前这个插件版本只支持同时操作一个配置库，但支持该配置库下的多个项目。

10.   如果上述设置后还无法正常显示，在JIRA_HOME/atlassian-jira/WEB-INF/classes下log4j.properties中加入如下代码：

log4j.category.com.atlassian.jira.plugin.ext.vss=DEBUG, console, filelog

log4j.additivity.com.atlassian.jira.plugin.ext.vss=false

重启JIRA后查看JIRA_HOME/logs/stdout_xxxxxx.log，获得详细异常信息。

七、         待解决问题：

1.       在vss-jira-plugin.properties中，属性值能否存在中文。

2.       在vss-jira-plugin.properties中，user能否建立多个，来记录不同VSS用户对配置项的修改。

3.       控制check out/in时输入JIRA中存在的任务编号。

4.       控制VSS user只能提交在JIRA中分配给自己的任务。