參考:https://docs.eazybi.com/eazybijira/set-up-and-administer/set-up-and-administer-for-jira-server/installation-and-setup
安裝前的清單
Jira內存設置
在安裝eazyBI之前,請檢查您當前的Jira內存設置。如果您的Jira服務器沒有足夠的可用內存,那么eazyBI可能無法啟動,整體Jira性能可能會受到影響。
為了確保eazyBI的更好性能,建議將Jira Java VM可用內存設置為1 GB或更多(如果使用Java 8則建議設置為2 GB或更多)和Total PermGen內存為384 MB或更多(建議使用512 MB)你有很多Jira插件)。有關 如何在Jira安裝中執行此操作的詳細說明,請參閱 增加Jira內存。
指定 JVM_MAXIMUM_MEMORY=1024m
(如果使用Java 8然后指定2048m
或以上),以及 JIRA_MAX_PERM_SIZE=384m
在你的(不,如果使用Java 8設置PermGen的內存大小) setenv.sh
或 setenv.bat
文件(如果您運行吉拉為Windows服務,那么請跟着 增加吉拉內存/ Windows服務 的指令,而不是) 。稍后在使用eazyBI時,請檢查Jira管理/系統/故障排除和支持/系統信息/ Java VM內存統計信息頁面,以查看可用內存的數量以及是否需要增加更多內存。
如果eazyBI插件啟動失敗並且 文件中SystemStackError: stack level too deep
出現錯誤 localhost.*.log
(請參閱 文件位置疑難解答),那么您已-Xss
為Java VM 指定了太低的 最大堆棧大小設置。您可以-Xss
在Jira管理/系統/故障排除和支持/系統信息/ JVM輸入參數中查看是否使用此 選項。請刪除 -Xss
選項或增加它(推薦設置是-Xss1024k
),直到eazyBI插件啟動而沒有“堆棧級太深”錯誤。
可以在單獨的JVM進程中運行eazyBI報告查詢。如果要啟用它,請閱讀有關子進程選項的更多信息。
UTF-8編碼
建議在Jira配置中使用 UTF-8編碼。 如果默認編碼不同於UTF-8,請添加 -Dfile.encoding=UTF-8
到 JVM啟動參數。
您可以在Jira管理/系統/故障排除和支持/系統信息/系統編碼中檢查當前的JVM默認編碼。
安裝
從Atlassian Marketplace頁面下載eazyBI插件 或使用Jira Add-ons Manager進行安裝。
您應該具有Jira系統管理權限來安裝加載項。轉到主 管理 屏幕,然后轉到 Add-ons 鏈接。然后從Atlassian Marketplace中找到並安裝eazyBI插件,或者如果您已下載該插件,則轉到 Manage Add-ons 頁面並上載下載的eazyBI插件文件。
初始設置
在eazyBI加載項安裝之后,單擊“ 配置” 鏈接以導航到eazyBI設置頁面。或者,如果單擊“ 退出管理” ,則應 在頂部導航欄(“儀表板,項目和問題”旁邊)中看到 eazyBI鏈接。
eazyBI第一次加載時可能需要大約半分鍾。如果您選擇了 eazyBI 鏈接,那么您應該看到eazyBI歡迎頁面。您應該以具有系統管理權限的Jira用戶身份登錄以設置eazyBI。單擊“ 設置eazyBI” 繼續。
數據庫連接
eazyBI將數據存儲在另外的MySQL,PostgreSQL,Microsoft SQL Server或Oracle數據庫中。您可以使用Jira使用的相同數據庫服務器,也可以使用其他數據庫服務器。建議您為eazyBI需求創建單獨的數據庫用戶(默認情況下使用名稱 eazybi_jira
),然后在指定的數據庫服務器中創建其他數據庫。
MySQL的
作為MySQL管理員創建一個MySQL用戶eazybi_jira
,該用戶 具有以eazybi_jira開頭的所有數據庫的訪問權限;或者使用和jira一樣的用戶但是要擁有創建數據庫的權限
連接數據庫:# mysql -uroot
GRANT ALL PRIVILEGES ON `eazybi_jira%`.* TO 'eazybi_jira'@'%' IDENTIFIED BY '123456';
(替換 123456 為所選密碼)。當您保存eazyBI設置時,將建立數據庫連接並創建數據庫。稍后,當創建其他eazyBI帳戶時,每個帳戶數據將存儲在單獨的數據庫中, eazybi_jira_dwh_N
其中N是帳戶ID號。
您應該將MySQL JDBC驅動程序添加 到應用程序服務器。如果您已經為Jira主數據庫完成了它,那么您不需要做任何事情,eazyBI將使用相同的已安裝的MySQL JDBC驅動程序。
如果您有大量的Jira問題,那么為了更快地進行eazyBI Jira數據導入,建議調整MySQL內存設置。my.cnf
建議使用以下 設置:
innodb_buffer_pool_size = 1024M innodb_log_file_size = 256M query_cache_size = 16M query_cache_type = 1 max_connections = 200
innodb_buffer_pool_size
將指定MySQL可以存儲在內存中的數據庫數據 - 將其調整到可用的服務器內存(MySQL將在內存中存儲的數據越多,將執行的磁盤輸入/輸出操作越少)。如果您將更改 innodb_log_file_size
,則需要在啟動MySQL服務器之前刪除現有的MySQL日志文件。
請max_connections
根據所有應用程序的MySQL使用情況進行調整。eazyBI連接池最多使用50個數據庫連接。
請確保MySQL eazybi_jira數據庫表正在使用InnoDB存儲引擎(默認情況下從MySQL 5.5開始),而不是舊的MyISAM存儲引擎。
執行第一個Jira數據導入
如果數據庫連接和許可證信息正確,則將創建eazyBI數據庫以及第一個eazyBI帳戶(默認名稱為“Jira reports”)。在一個eazyBI帳戶中,您可以導入一個或多個Jira項目,創建報告,圖表和儀表板,並授予對選定Jira用戶和組的訪問權限。如果在您的Jira服務器中有許多不同用戶組使用的不同項目,則很可能需要創建多個eazyBI帳戶,並在每個帳戶中導入相關的Jira項目子集。
單擊“ 創建”后, 將創建一個新的Jira源應用程序,您可以
- 在第一個eazyBI帳戶中選擇要導入的Jira項目
- 選擇是否要導入狀態轉換歷史記錄
- 應安排定期問題導入的頻率(默認情況下每天一次)
- 選擇要導入的自定義字段(詳細了解 支持的自定義字段類型)
單擊“ 導入” 以啟動問題導入。