confluence 3.3.1 安装笔记

一. 下载?

官网下载地址：

http://www.atlassian.com/software/confluence/ConfluenceDownloadCenter.jspa

支持多个平台，而且有多个安装版本。对于普通用户，根据各自情况可以考虑合适的版本：One-Click Evaluation Installer的版本很适合拿来试用，或者用来做小白，测试各种配置插件等。Standalone for Production Usage 的版本适合正式场合，已经打包好了confluence和tomcat，安装非常简单。如果已经安装有了tomcat之类的web容器，可以选择EAR/WAR 的版本。

下文以linux平台上的Standalone版本为例。

二. 准备安装

先在linux上准备好目录，如wiki，然后在wiki下建立子目录Confluence_home目录备用。

数据库准备用mysql，因此需要事先安装好mysql数据库，新建名为Confluence的database，新建Confluence用户。

依然逃不脱license的问题，可以在官网注册后申请30天试用的license。对于想破解的同学，请google " Confluence v3.3.1 Keygen"，也可以直接到hotfile下载这个文件：

http://hotfile.com/dl/62654103/a242e24/Atlassian.Confluence.v3.3.1.Incl.Keygen.and.Patch-iNViSiBLE.rar.html

我使用的就是这个文件，大概120m附近。其实里面是普通的Standalone，和官网相同11*M，重要的是附带了一个破解工具，不足1M的样子。破解工具有两大用处：1 破解atlassian-extras-2.4.jar 文件，2. 生成Confluence的license。

如果需要破解，可以先解开下载的confluence压缩包，执行keygen.bat，patch confluence/confluence/WEB-INF/lib下的atlassian-extras-2.4.jar，然后备用。这个在windows上破解之后的jar文件可以同样在linux平台上使用。

三. 安装

将下载得到的confluence-3.3.1-std.tar.gz文件上传到linux机器上的wiki目录，执行命令：

gunzip confluence-3.3.1-std.tar.gz

tar xvf confluence-3.3.1-std.tar

mv confluence-3.3.1-std confluence

然后将进入confluence/confluence/WEB-INF/lib，用前面破解好的版本覆盖atlassian-extras-2.4.jar文件。

接着进入confluence/confluence/WEB-INF/classes目录，打开confluence-init.properties文件，设置好confluence.home为我们前面准备的Confluence_home目录。

confluence.home=/..your path.../wiki/confluence_home

下面开始正式安装，进入confluence/bin目录，通过startup.sh启动tomcat. 默认使用8080端口，也可以通过配置confluence/conf/server.xml来修改默认端口。

使用浏览器打开http://yourip:8080/，出现confluence的安装界面。这里要求填写license，执行破解包里面的keygen.bat，写入任意的用户名邮箱等信息，然后将页面上的sid填入，执行gen，即可得到license。填入之后next，如果破解成功license有效则可进行一下步数据库设置，选择外部数据库mysql，next，然后选择jdbc driver，这里需要填写mysql的url，用户名和密码。

安装过程中在这个步骤遇到问题，总是报错说无法连接到mysql。

The following error(s) occurred:

Configuring the database failed. Couldn't create the database schema.

com.mysql.jdbc.exceptions.jdbc4.MySQLNonTransientConnectionException: Could not create connection to database server. Attempted reconnect 3 times. Giving up.

费了不少时间，最后发现时confluence 3.3.1版本的bug(也许是破解造成的？)，在填写mysql URL时，&符号必须替换为"&"! 例如：

jdbc:mysql://localhost/confluenceautoReconnect=true&useUnicode=true&characterEncoding=utf8&sessionVariables=storage_engine%3DInnoDB

然后设置admin账号的信息和密码，安装过程顺利结束，confluence可以使用。

四. 问题

我曾尝试使用EAR/WAR方式，试图将confluence安装到jetty下，但是遇到意外问题：在选择使用mysql书库，输入mysql信息之后的执行过程中，jetty总是报错，抛出outofmemory error.

然后jetty失去响应，等待很长时间也不能重新恢复正常。只能重启，重启之后发现数据库已经建立了很多表，安装过程也可以继续，但是安装完成之后的confluence无法使用，应该是安装不完整所致。

使用将jetty的内存增加到1g甚至2g，依然无效，每次都是outofmemory。原因不明, 只好放弃jetty + confluence的war安装。