如何将Confluence和JIRA standalone安装到一起l

How to add Confluence to a JIRA standalone install

此文将有助于您将Confluence安装到您已经安装好的 JIRA standalone 中.

This document is a guideline on how to add Confluence to a JIRA standalone install. It assumes that the files mentioned in this document are shipped with Jira.
如果您运行的不是Jira standalone版本, 则配置过程不同于此文.

Step 1 - 下载并解压缩WAR文件
1. 下载 Confluence WAR 文件.
2. 解压缩下载的 zip 文件. It should extract to a folder called confluence-<version>. Inside this folder you‘ll find a folder called "confluence". Make a note of the absolute path to this directory (as you will need to use it later). Note: Do not copy the confluence folder to the webapps folder inside tomcat - this may cause Confluence to be deployed more than once.

Step 2 - 配置confluence-init.properties
1. 用文本编辑器打开confluence/WEB-INF/classes/confluence-init.properties文件;
2. 将 confluence.home 属性设置为您选择的目录.此目录将包含所有的Confluence配置文件,备份和附件文件.

Step 3 - 编辑tomcat context 描述符
如果您正在部署的是JIRA 3.3或者更高版本,则按如下步骤:
1. Create a file called confluence.xml in your JIRA standalone‘s conf/Catalina/localhost directory (if you have set up a different hostname for your JIRA tomcat instance, please specify that instead of localhost)
2. Open confluence.xml and add these lines:

代码:

<Context path="/confluence" docBase="c:/applications/confluence-2.1.3/confluence" debug="0" reloadable="true">
<Logger className="org.apache.catalina.logger.FileLogger"
prefix="atlassian-confluence." suffix=".log" timestamp="true"/>
</Context>

3. For docBase specify the value you noted down earlier.
如果您运行的JIRA版本低于3.3,则安装如下步骤操作:
1. Open conf/server.xml in a text editor
2. Find the block that begins: <Context path="" docBase="../atlassian-jira" debug="0" reloadable="true"> and ends with </Context> block.
3. After the </Context>, append the following:

代码:

<Context path="/confluence" docBase="c:/applications/confluence-2.1.3/confluence" debug="0" reloadable="true">
<Logger className="org.apache.catalina.logger.FileLogger"
prefix="atlassian-confluence." suffix=".log" timestamp="true"/>
</Context>

1. For docBase specify the value you noted down earlier.
2. Remove the commons-logging-1.0.4.jar file from the confluence\WEB-INF\lib directory

Do not delete the existing Jira <Context> block. Insert the code above after the Jira <Context> block.

Step 4 - 修改setenv.sh/bat 文件(仅适用于SUN的JVM)
1. 用文本编辑器打开 bin/setenv.sh/bat 文件(.sh on unix, .bat on windows) .
2. 将 JAVA_OPTS="-Xms128m -Xmx256m $JAVA_OPTS -Djava.awt.headless=true"
修改为: JAVA_OPTS="-Xms128m -Xmx256m $JAVA_OPTS -Djava.awt.headless=true -XX:MaxPermSize=128m"

The Java Virtual Machine sets aside a portion of memory as the "permanent space", for objects that it never expects to have to garbage-collect. Because JIRA and Confluence are both quite large applications, it is possible that this permanent space will be filled up. Increasing the application heap size will not help, because the permanent generation size is a separate setting.

This flag is only supported on JVM‘s created by Sun Microsystems. If you include this flag while running another vendors JVM (such as JRocket, or IBM‘s JVM) they will not start.

Step 5 - 重新启动应用服务器
1. Shut down, and then restart the standalone server
2. Confluence should now be accessible on the same server as your existing JIRA standalone, under the confluence directory.
For example, if your JIRA is running at http://jira.example.org:8080/, Confluence will be running on http://jira.example.org:8080/confluence

问题及解决办法:
When I try to send a test mail from Confluence, I get javax.mail.NoSuchProviderException: smtp

In some circumstances, Confluence will be unable to send email after being deployed in the same application-server as JIRA. If, when you try to send a test mail from the administration tool, you get the error: "javax.mail.NoSuchProviderException: smtp", please follow these instructions to fix it.

ref:
http://confluence.atlassian.com/display/DOC/How+to+add+Confluence+to+a+JIRA+standalone+install