参考: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项目
- 选择是否要导入状态转换历史记录
- 应安排定期问题导入的频率(默认情况下每天一次)
- 选择要导入的自定义字段(详细了解 支持的自定义字段类型)
单击“ 导入” 以启动问题导入。