關於Confluence

關於Confluence的一些相關的介紹，可以看一下這兩個網站，http://www.confluence.cn/pages/viewpage.action?pageId=360467和http://www.confluence.cn/pages/viewpage.action?pageId=1048587，這兩個網站是confluence的官網介紹，這裡我簡單的介紹一下，Confluence是一個文件管理的軟體，使用java開發的，功能方面類似WIKI（我沒有用過WIKI），但是功能比wiki強大。目前最新版本是6.6.0，網上幾乎沒有與6.6相關的部落格和論壇，這次公司要求安裝，在這裡稍微做一下筆記。

confluence有Windows版本的也有linux版本的，這裡主要是linux版本的，Windows版本的設定與linux是一樣的，可類似參考。

一、需要事先準備的東西：

JDK1.7/1.8，myql5.6/5.7，mysql-connector-5.1.34.jar

因為Confluence是基於java開發的軟體，所以JDK是必須的。confluence是可以使用內嵌資料庫的額，但是作為生產環境的話，confluence是建議使用自己的資料庫的，在安裝資料庫的時候是支援多種的資料庫的，我這裡用的是mysql。關於這兩個的支援的最低版本不太清楚，但是親測JDK1.7以上和mysql5.6以上的版本都是可行的。關於linux和Windows上安裝jdk和mysql的操作，這裡就不贅述了，如果是弄java的，這些應該都是基本操作。還有就是連線mysql的包mysql-connector，版本應該沒差。

atlassian-confluence-6.6.0-x64.bin

confluence的安裝包，可以在http://www.confluence.cn/pages/viewpage.action?pageId=6722516進行下載，但是從這裡下載的話速度是真的感人，但是也沒有辦法，也可以從****************************下載，然後建議是先在windows下載在傳到伺服器上，之前我的上傳下載使用的都是rzsz，經過這個知道了又xftp，速度超級快，關於這兩個的使用，自行百度。
如果是要在windows上安裝的話，可以從https://www.evget.com/product/3663/download

atlassian-extras-decoder-v2-3.2.jar

這個是用來破解confluence的，你懂得。和上面的打包一起傳上去了。

開始安裝

window下的安裝就是直接執行exe檔案，跟著操作就行了，這裡主要是linux下怎麼安裝。

剛下載下來的atlassian-confluence-6.6.0-x64.bin是不具備執行的許可權的，所以新增執行的許可權

chmod +x atlassian-confluence-6.6.0-x64.bin

執行檔案得到下面的內容，先後輸入o，1，i三個指令，需要注意的是Confluence的安裝路徑，我這裡就是/opt/atlassian/confluence和/var/atlassian/application-data/confluence因為安裝這個一次就成功的可能性不大，所以記住這個東西方便解除安裝重灌。在安裝的最後，會問Start Confluence now?我這裡選擇的是n，當然如果心急，輸入y也是可以的，反正待會也是要重啟服務。

說到重啟服務，這裡說一下Confluence啟動關閉服務的幾種方法（啟動服務時間會挺長的，尤其是瀏覽器訪問的時候響應時間會挺長的）：

方法一：
如果是安裝在windows上的話，進入到服務管理的介面（我的電腦->右鍵->管理->服務=====或者=====services.msc）找到confluence的服務，在這裡啟動關閉服務。
方法二：（下面的方法都是linux上的）

#需要管理員許可權
#關閉服務
service confluence stop         
#啟動服務
service confluence start        

方法三：

#需要管理員許可權
#關閉服務
/ete/init.d/confluence stop
#啟動服務
/etc/init.d/confluence start

方法四：如果不是root使用者安裝的話，confluence這個服務可能不會被註冊到service上，所以上面的方法都不能用.

#非root使用者安裝,以我的安裝路徑為例：
#關閉服務
/opt/atlassian/confluence/bin/stop-confluence.sh
#啟動服務
/opt/atlassian/confluence/bin/start-confluence.sh

順便說一下怎麼解除安裝Confluence，還是以我的安裝路徑為主

#下面路徑有這個命令，執行一下就好了
/opt/atlassian/confluence/uninstall
#然後手動刪除兩個路徑的檔案
rm -rf /opt/atlassian /var/atlassian
#Windows上也是這麼解除安裝的，但是在Windows上的話需要重啟電腦。

Confluence的日誌儲存在/opt/atlassian/confluence/logs/catalina.out檔案中，Confluence出現什麼問題可以去日誌檔案裡看看是什麼原因引起的。

好了好了，說了這麼多東西，因為上面的這個操作在自己安裝的過程中對視都可能用得到，所以多逼逼了一會，繼續安裝，說一下為什麼在安裝的最後選擇不直接啟動Confluence服務，因為我的伺服器只有2G的記憶體，但是Confluence是非常吃記憶體的，如果我直接啟動的話很可能回報記憶體不足的錯誤（這個錯誤真的找了超級長的時間），還有就是需要替換一些jar包，為了待會重啟服務，這裡就直接先替換了。

關於confluence的記憶體不足，可以參考https://confluence.atlassian.com/confkb/how-to-fix-out-of-memory-errors-by-increasing-available-memory-154071.html，我這裡擷取一部分，具體的可以點進去看看怎麼解決，現在網上的部落格上通常是5.x的解決方式，在6.6.0中有不同。我2G的設定的是512M。還有就是在接下倆的安裝過程中，如果一個過程等的時間實在是太長了，那大部分原因就是因為記憶體不足了，建議停止Confluence之後，重新調小記憶體，但是在我的linux伺服器上，記憶體調整到400以下，Confluence服務就無法啟動了。

進入到/opt/atlassian/confluence/confluence/WEB-INF/lib路徑下，替換atlassian-extras-decoder-v2-3.2.jar(最好備份了再替換)，然後把mysql-connector-5.1.34.jar放進這個目錄中。然後重啟服務，訪問ip地址:8090，這個過程會花點時間，啟動伺服器挺慢的。

選擇哪個我感覺沒差，兩個我都試過，我選擇的是產品

為了避免發生一些不可預知的錯誤，建議這裡在新標籤頁開啟連結。

這裡的話可能需要Google授權登入，需要翻牆，我這裡之前註冊登陸過，所以直接登入，沒有翻牆的，可以在下面留言，留下你的伺服器ID。

如果沒有直接跳轉的話返回圖片6重新點一下連結，到下面這裡，我選擇的是Server，不知道什麼原因，選擇Data Center的幾個全部安裝到一半崩潰了。

頁面載入完畢會出現

這裡選擇內建的話，就是使用嵌入式的資料庫，不用配置什麼東西，等一段（挺長的）時間，就好了，我選擇的是我自己的資料庫，這裡需要對資料庫進行一些配置。這部分我遇到的問題不是很多，我就列舉一下我遇到的問題

先要設定編碼格式為utf8，如果有root許可權的話，直接開啟/etc/my.cnf，在[mysqld]下加入下面的東西

init_connect='SET collation_connection = utf8_unicode_ci'
init_connect='SET NAMES utf8'
character-set-server=utf8
collation-server=utf8_unicode_ci
skip-character-set-client-handshake
transaction-isolation=READ-COMMITTED

然後重啟一下mysql伺服器就好了。如果沒有root許可權的話，

#執行SQL語句
show variables like "%character%";
#得到類似這下面這個東西
+--------------------------+----------------------------+
| Variable_name            | Value                      |
+--------------------------+----------------------------+
| character_set_client     | utf8                       |
| character_set_connection | utf8                       |
| character_set_database   | utf8                       |
| character_set_filesystem | binary                     |
| character_set_results    | utf8                       |
| character_set_server     | utf8                       |
| character_set_system     | utf8                       |
| character_sets_dir       | /usr/share/mysql/charsets/ |
+--------------------------+----------------------------+
#使用命令列下面的命令列將所有的編碼格式設定成上面的這個樣子。
set character_set_database=utf8;

然後建立一個數據庫，授權等：

create database confluence default character set utf8 collate utf8_bin;
grant all on confluence.* to 'confluence'@'%' identified by 'confluencepasswd';
flush privileges;

同樣如果是非root使用者的話，設定完上面的編碼格式之後，沒有設定事務隔離(transaction-isolation)，所以事務隔離很可能是預設的REPEATABLE READ，執行下面的語句修改一下事務隔離。

set session transaction isolation level read committed;
set global transaction isolation level read committed;

到這裡基本上就設定完成了，在執行這部分內容過程中，如果報錯的話會有對應的連結告訴解決方法，放心。

在6.6.0會直接進入到下面的介面

點選下一步，這個過程會等挺久的，耐心等待一下，我再做這個過程時候遇到過這個錯誤

Cannot execute statement: impossible to write to binary log since statement is in row format and BINLOG_FORMAT = STATEMENT.

這個的話我是看其他人的部落格，在Mysql中運行了下面這句話，然後解除安裝重灌就沒有這個問題了。

SET GLOBAL binlog_format=MIXED;

上圖等很久之後會出現下面這個，到這一步基本上算是安裝完成了，後續幾乎不會有什麼錯誤出現了。在這裡選擇空白站點或者示範站點都是可以的。

關於漢化這個問題，我在linux和Windows上安裝，安裝完之後就自動全是中文的，但是我在虛擬機器的Ubuntu上安裝的Confluence確實英文版的，這個是什麼原因我也不太清楚，但是目前網上沒有免費的對於6.6.0的漢化包，官網上的漢化包是需要錢的。