confluence與jira帳號對接、查看到期時間及問題總結

 

前面介紹了對於confluence和jira的破解版安裝記錄，下面簡單記錄下confluence和jira結合配置：
安裝順序：先安裝Jira，而後安裝Confluence，在Confluence安裝過程當中去鏈接jira，既Confluence用戶目錄會主動同步jira的用戶目錄。這樣，在jira裏建立用戶就會自動同步到Confluence裏，雙方登錄的用戶是同樣的（最好是先在jira裏建立用戶，而後同步到Confluence裏）。在同一個session環境下，可使用一樣的帳號登錄jira和Confluence。（可是在切換登錄時仍然須要輸入密碼，要想切換登錄時不須要登錄密碼，即實現單點登陸，則須要基於Crowd實現，這樣就不作介紹了）。

下面粘貼下Confluence安裝中鏈接jira的截圖：

===============================================================================
若是是先安裝的confluence，而且在"配置用戶管理"中選擇的是"在Confluence中管理用戶和組"，那麼後續向跟jira對接的操做方法以下：
1）jira和confluence最好設置相同的管理員帳號和密碼
2）登陸confluence管理員帳號下，依次點擊右上角的"用戶管理"->點擊左側最下面的"管理"中的"應用程序連接"->"建立新連接"，而後添加jira的url地址，根據提示進行添加配置便可（提示中會跳到jira界面裏，相繼添加confluence的地址）
3）左上角jira和confluence對接的標題名稱能夠自定義，jira在"系統"->"通常配置"->編輯"標題";confluence在"通常配置"->編輯"標題"
===============================================================================

1）在jira裏建立的用戶，會主動給用戶發送一封郵件，點擊郵件能夠重置密碼。使用該用戶登陸後，點擊左上角圖標，切換到confluence後進行該用戶的界面
設置，這樣該用戶才能載入到confluence用戶目錄下。
2）在jira裏建立和刪除用戶，默認confluence同步是須要一段時間的。若是用戶同步不及時，能夠手動同步，即點擊"用戶目錄"->"同步"，即手動同步用戶目錄便可！（刪除用戶最後先在jira裏刪除，而後Confluence同步用戶）

通常來講，用戶建立（建議使用"邀請用戶"的方式建立用戶）的規則：
1）若是jira和Confluence都須要建立用戶，就先在jira上建立用戶，而後Confluence同步。
2）若是隻須要Confluence帳號，不須要jira帳號。那麼就在Confluence上"邀請用戶"註冊帳號，而後同步到jira上的帳號默認不能登陸，須要將用戶添加到jira的相關用戶組內纔可以登陸。

========================================================
confluence和jira的用戶目錄同步方式：
根據以上部署可知，confluence和jira的用戶同步是單方向的，及confluence同步jira的用戶，可是jira不能同步confluence用戶！
在配置用戶目錄同步時，點擊"添加目錄"，發現只有三種同步方式：
1）添加Crowd服務器，能夠實現jira和confluence用戶目錄雙向同步；
2）添加LDAP服務器，能夠實現jira和confluence用戶目錄雙向同步；
3）添加Jira服務器，只能實現confluence同步jira用戶目錄，即單向同步。

=================================================
如何查看破解後的的jira和Confluence到期時間

1）查看jira的到期時間。以下可知，jira到期時間是2033年2月8號

2）查看Confluence的到期時間。以下可知，Confluence離到期時間還有957個月零7天20小時

=====confluence上開通用戶，使該用戶只具備某一個或幾個項目空間的操做權限=====

方法：
1）正常開通用戶，好比A用戶。
2）建立一個用戶組，好比test用戶組（默認是空的）。
3）點擊右上角設置圖標裏的"用戶管理"->"站點管理"->"用戶"->"全局權限"，而後編輯test組權限（設置"我的空間"、"建立空間"兩個權限便可，
   "站點管理"和"系統管理員"權限看狀況是否設置）
4）編輯A用戶，將A用戶所屬的組設置爲test。注意：千萬不要設置爲confluence-users組，不然就對全部的項目空間都具備權限。
5）假設使A用戶僅僅只具備kevin項目的操做權限。則打開kevin名稱的目錄空間，點擊左下角的"空間管理"->"權限"，在右邊的"用戶"區域(或者"組"區域)點擊
  "編輯權限"，將A用戶(或者test組)添加進去，並設置權限(好比只設置"查看"權限)便可。
6）若是是一個用戶針對多個項目空間的權限，就依次在這些項目空間的"空間管理"->"權限"裏設置，如上第4步操做便可。
  
如上操做後，A用戶登陸confluence就只有所設置的空間的權限了。

jira跟confluence不同，它只有角色權限，針對組進行設置的，不針對我的。jira權限設置："系統"->"安全"->"全局權限"
=====jira/confluence訪問界面出現"您能夠臨時訪問管理功能。若是再也不須要，請 取消訪問。更多信息, 請查看 相關文檔"======

如何取消？
1）須要在JIRA的Home文件夾裏手工建立一個文件：jira-config.properties，文件裏面寫一句話jira.websudo.is.disabled=true
2）重啓JIRA服務便可

具體操做：
a）查詢jira服務的家目錄
[root@file-server ~]# cat /opt/atlassian/jira/atlassian-jira/WEB-INF/classes/jira-application.properties
# Do not modify this file unless instructed. It is here to store the location of the JIRA home directory only and is typically written to by the installer.
jira.home = /var/atlassian/application-data/jira

如上能夠得知，jira服務的家目錄是/var/atlassian/application-data/jira

b）在jira家目錄下添加文件
[root@file-server ~]# cd /var/atlassian/application-data/jira
[root@file-server jira]# touch jira-config.properties
[root@file-server jira]# vim jira-config.properties
jira.websudo.is.disabled=true
[root@file-server jira]# chown jira.jira jira-config.properties

c）重啓jira
[root@file-server jira]# /etc/init.d/jira stop
[root@file-server jira]# /etc/init.d/jira start

==========jira和confluence調整爲域名訪問的操做記錄============

如以前的安裝文檔，jira和confluence安裝後都是經過ip+port進行訪問以及關聯，後面調整爲域名訪問，修改記錄以下：
1）在前面架設一個LB層，經過域名訪問代替ip+port訪問，而後將域名解析到LB的ip上便可。例如：
   http://jira.kevin-inc.com 代替http://172.16.220.129:8080
   http://wiki.kevin-inc.com 代替http://172.16.220.129:8090
2）訪問http://wiki.kevin-inc.com，在右上角
   a）點擊"通常配置"，將"服務器主頁URL"由http://172.16.220.129:8090修改成http://wiki.kevin-inc.com；
   b）點擊"配置應用程序連接",將對應的ip的url修改成域名的url；
   c）點擊"應用程序導航器",發現confluence對應的url已經變成wiki域名了，此時jira的連接仍是ip+port方式，
      接着進行添加操做，將jira的域名方式添加進去，而後將以前的ip+port方式的連接拉到最下面。（這個配置
      涉及到從confluence界面的左上角切換到jira後顯示的地址信息）
3）訪問http://jira.kevin-inc.com，在右上角
   a）點擊點擊"通常配置"，將"服務器主頁URL"由http://172.16.220.129:8080修改成http://jira.kevin-inc.com；
   b）點擊"應用程序"->"應用程序連接",將對應的ip的url修改成域名的url；
   c）點擊"應用程序導航器",將對應的ip的url修改成域名的url；

===========jira帳號建立項目的權限==========

默認建立的jira帳號是沒有建立jira項目的權限的，若是想讓一個jira帳號擁有建立項目的權限，正確作法以下：
1）建立一個組,好比叫jira-project
2）點擊右上角的"系統"->"安全"->"全局配置",而後將所建立的組jira-project設置爲"JIRA 管理員"，注意是
  "JIRA 管理員"，而不是"JIRA 系統管理員"
3）而後將用戶拉到jira-project組內便可！

===========confluence和jira的備份和恢復==========

confluence的自動備份：
數據備份目錄：/var/atlassian/application-data/confluence/backups           （"站點管理"->"每日備份管理"）
附件備份目錄：/var/atlassian/application-data/confluence/attachments       （"站點管理"->"附件存儲"）

confluence備份與還原 （"站點管理"->"管理"->"備份與還原"）

能夠根據界面裏提示進行數據恢復
若是從confluence主目錄中由備份和恢復
備份必須複製至/var/atlassian/application-data/confluence/restore目錄中。 若是備份文件很大，推薦這種方式

----------------------------------------------------------------

jira的自動備份
數據備份目錄： /var/atlassian/application-data/jira/export     （"系統"->"導入導出"->"備份系統"）
附件所在目錄：/var/atlassian/application-data/jira/data/attachments    這個須要手動備份

jira的數據恢復：   （"系統"->"導入導出"->"恢復系統"）

========confluence管理員admin帳號密碼忘記的處理辦法========

1）登陸mysql，查看admin帳號狀況,記下admin管理員的id號
[root@confluence-server ~]# mysql -p123456
......
MariaDB [(none)]> use confluence;
......
MariaDB [confluence]> select id,user_name,credential from cwd_user;
+--------+-----------+---------------------------------------------------------------------------+
| id     | user_name | credential                                                                |
+--------+-----------+---------------------------------------------------------------------------+
| 229377 | admin     | {PKCS5S2}1QX4TpvSnyJPEwfJ5Y5OQDIxaHPqkrYlsRAPSvd4quVt3wku9WPKugZxSlUCYV71 |
+--------+-----------+---------------------------------------------------------------------------+
1 row in set (0.000 sec)

MariaDB [confluence]> 

2）根據admin的id號進行update更新密碼。若是你的密碼是{PKCS5S2}前綴開頭的，則用下面這個sql:
以下密碼修改成"Ab123456"（下面的密碼就是Ab123456的密文）
MariaDB [confluence]> update cwd_user set credential =  '{PKCS5S2}ltrb9LlmZ0QDCJvktxd45WgYLOgPt2XTV8X7av2p0mhPvIwofs9bHYVz2OXQ6/kF'  where id=229377;  
Query OK, 0 rows affected (0.057 sec)
Rows matched: 1  Changed: 0  Warnings: 0

MariaDB [confluence]> select id,user_name,credential from cwd_user;
+--------+-----------+---------------------------------------------------------------------------+
| id     | user_name | credential                                                                |
+--------+-----------+---------------------------------------------------------------------------+
| 229377 | admin     | {PKCS5S2}ltrb9LlmZ0QDCJvktxd45WgYLOgPt2XTV8X7av2p0mhPvIwofs9bHYVz2OXQ6/kF |
+--------+-----------+---------------------------------------------------------------------------+
1 row in set (0.000 sec)

MariaDB [confluence]> 

3）而後使用更新後的新密碼Ab123456登陸admin帳號，在confluence界面裏進行密碼重置。

========confluence導出PDF格式文件不顯示中文解決========

因爲confluence導出PDF格式文件須要應用字體文件，下載字體文件在confluence管理員界面安裝便可。
從本機c盤->Windows-Fonts文件夾裏複製simkai字體文件到桌面，而後使用管理員帳號登錄confluence，找到"PDF導出語言支持"選擇，
選擇本機桌面的simkai字體文件進行安裝便可。安裝後，導出的pdf文件裏的中文就能正常顯示了。

=========================離職人員的jira/confluence帳號銷燬=========================
員工離職時是不能直接在jira/confluence裏刪除他們帳號的,由於這些帳號關聯了對應項目,除非修改成其餘帳號的關聯關係, 不然不能直接刪除. 可是能夠禁用這些帳號. 

可行的處理方法:
1) 管理員帳號登陸jira, 點右上角的"設置"->"用戶管理"->"用戶",直接搜索離職人員的對應帳號, 點擊後面的"編輯", 將"活躍"前面方框裏的對勾去掉, 即改成了"不活躍"狀態, 這樣該用戶就登陸不了jira了! 而後使用管理員帳號登陸confluence, 點擊右上角的"設置"->"用戶管理"->"用戶目錄"->"同步". 而後在"用戶"裏搜索離職人員帳號,發現帳號上被標記了"無效",即登陸不了confluence了!

2) 若是離職的人員是jira上某些項目關聯負責人, 則也是沒法設置爲"不活躍"的, 即沒法註釋"編輯"->"活躍", 此時的作法是:
將此帳號從它以前全部所在的組內撤出來, 即確保它在jira/confluence下不屬於任何組, 這樣它登陸後就沒有任何權限了.

==============================Confluence問題============================

1）問題一：
JVM 堆內存溢出，致使confluence訪問慢或程序直接跑死問題
查看/opt/atlassian/confluence/logs/catalina.out日誌，報錯信息爲：
java.lang.OutOfMemoryError: Direct buffer memory

解決辦法：增大JVM內存，作法以下：
在bin/catalina.sh腳本文件裏添加下面一行內容，具體內存增長到多少，要根據本身服務器的實際內存來考慮（好比個人機器是128G，這裏我調整到24G）
[root@file-server ~]# vim /opt/atlassian/confluence/bin/catalina.sh      
......
JAVA_OPTS='-Xms20480m -Xmx20480m -XX:PermSize=10240M -XX:MaxNewSize=10240m -XX:MaxPermSize=5120m'

[root@file-server ~]# /etc/init.d/confluence restart
--------------------------------------------------------------------------------------------------------------

2）問題二：
confluence正常啓動，8090端口也順利起來了，可是confluence訪問報錯404！
[root@file-server ~]# tail -f /opt/atlassian/confluence/logs/catalina.out
........
11-Jan-2018 09:10:46.527 SEVERE [http-nio-8090-exec-6] org.springframework.web.socket.sockjs.client.SockJsClient.doHandshake Initial SockJS "Info" request to server failed, 
url=ws://127.0.0.1:8091/synchrony/sockjs/v1org.springframework.web.client.ResourceAccessException: I/O error on GET request for "http://127.0.0.1:8091/synchrony/sockjs/v1/info": 
Connection refused (Connection refused); nested exception is java.net.ConnectException: Connection refused (Connection refused)
        at org.springframework.web.client.RestTemplate.doExecute(RestTemplate.java:607)
        at org.springframework.web.client.RestTemplate.execute(RestTemplate.java:572)
        at org.springframework.web.socket.sockjs.client.RestTemplateXhrTransport.executeInfoRequestInternal(RestTemplateXhrTransport.java:138)
        at org.springframework.web.socket.sockjs.client.AbstractXhrTransport.executeInfoRequest(AbstractXhrTransport.java:153)
        at org.springframework.web.socket.sockjs.client.SockJsClient.getServerInfo(SockJsClient.java:286)
        at org.springframework.web.socket.sockjs.client.SockJsClient.doHandshake(SockJsClient.java:254)
        at org.springframework.web.socket.sockjs.client.SockJsClient.doHandshake(SockJsClient.java:236)
        at com.atlassian.synchrony.proxy.websocket.WebSocketProxy.afterConnectionEstablished(WebSocketProxy.java:49)
        at org.springframework.web.socket.handler.PerConnectionWebSocketHandler.afterConnectionEstablished(PerConnectionWebSocketHandler.java:81)

特別注意：
confluence和jira的日誌不僅是隻在/opt/atlassian/confluence/logs和/opt/atlassian/jira/logs下面，有時只根據這裏面的日誌是看不到具體報錯的！
還須要去confluence和jira服務的家目錄/var/atlassian/application-data（默認就是這個路徑）下面查看日誌，能夠經過這裏面的日誌信息進行排錯。
日誌分別爲/var/atlassian/application-data/jira/log/atlassian-jira.log和/var/atlassian/application-data/confluence/logs/atlassian-confluence.log
以上報錯查看confluence日誌以下
[root@file-server ~]# tail -f /var/atlassian/application-data/confluence/logs/atlassian-confluence.log
......
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'hostComponentProvider': Injection of autowired dependencies failed; nested exception is 
org.springframework.beans.factory.BeanCreationException: Could not autowire method: public void com.atlassian.plugin.spring.SpringHostComponentProviderFactoryBean.setSpringHos
tComponentProviderConfig(com.atlassian.plugin.spring.SpringHostComponentProviderConfig); nested exception is org.springframework.beans.factory.BeanCreationException: Error cre
ating bean with name 'bundledPluginLoader' defined in class path resource [services/pluginServiceContext.xml]: Cannot resolve reference to bean 'osgiPluginFactory' while setting 
constructor argument with key [1]; nested exception is org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'osgiPluginFactory' defined in class 
path resource [services/pluginServiceContext.xml]: Cannot resolve reference to bean 'osgiPersistentCache' while setting constructor argument; nested exception is org.springframework.
beans.factory.BeanCreationException: Error creating bean with name 'osgiPersistentCache': FactoryBean threw exception on object creation; nested exception is com.atlassian.plugin.osgi.
container.OsgiContainerException: Unable to clean the cache directory: /var/atlassian/application-data/confluence/plugins-osgi-cache/felix

經過上面的日誌錯誤信息可知，是因爲cache緩存目錄的權限不對形成的：
[root@file-server ~]# ll -d /var/atlassian/application-data/confluence/plugins-osgi-cache
drwxr-xr-x 5 root root 4096 Nov  9 10:54 /var/atlassian/application-data/confluence/plugins-osgi-cache

plugins-osgi-cache目前權限是root，confluence程序權限是confluence，因此不能建立緩存數據。將其權限修改成confluence便可！
建議能夠將/var/atlassian/application-data/confluence下的目錄權限所有修改成confluence.confluence。
[root@file-server ~]# chown -R confluence.confluence /var/atlassian/application-data/confluence/plugins-osgi-cache
[root@file-server ~]# ll -d /var/atlassian/application-data/confluence/plugins-osgi-cache
drwxr-xr-x 5 confluence confluence 4096 Nov  9 10:54 /var/atlassian/application-data/confluence/plugins-osgi-cache

如上修改後，訪問confluence就正常了（能夠不用重啓confluence）
--------------------------------------------------------------------------------------------------------------

問題三：
confluence登錄後，上傳附件報錯：Could not upload the file to Confluence. The server may be unavailable

查看日誌：
[root@file-server ~]# tail -f /var/atlassian/application-data/confluence/logs/atlassian-confluence.log
......
javax.servlet.jsp.jspException: java.lang.RuntimeException: Error creating temp file in folder: /var/atlassian/application-data/confluence/attachments/ver003/21/87/4587521/92/247/3997842/5144597
javax.servlet.error.exception: java.lang.RuntimeException: Error creating temp file in folder: /var/atlassian/application-data/confluence/attachments/ver003/21/87/4587521/92/247/3997842/5144597

由此能夠看出，附件不能上傳的緣由是因爲權限問題致使的，解決以下：
[root@file-server ~]# ll -d /var/atlassian/application-data/confluence/attachments/ver003/
drwxr-xr-x 11 root root 4096 Jan  9 09:14 /var/atlassian/application-data/confluence/attachments/ver003/
[root@file-server ~]# chown -R confluence.confluence /var/atlassian/application-data/confluence/attachments
[root@file-server ~]# ll -d /var/atlassian/application-data/confluence/attachments/ver003/
drwxr-xr-x 11 confluence confluence 4096 Jan  9 09:14 /var/atlassian/application-data/confluence/attachments/ver003/