参考:https://docs.eazybi.com/eazybijira/set-up-and-administer/set-up-and-administer-for-jira-server/installation-and-setup
最新的eazyBI版本支持从6.0到7.13的Jira版本,以及即将推出的8.0版本。此外,您将需要MySQL 5.5 - 5.7,PostgreSQL 9.x或10.0,MS SQL Server 2008或更高版本,或Oracle 10g或更高版本的数据库。eazyBI插件应该适用于Linux,Windows和macOS。 如果您对支持的版本有疑问或者您的特定环境有任何问题,请联系 eazyBI支持。
对于从6.0到6.2的Jira版本,仅 支持Java 7。对于Jira版本6.3和6.4 ,Atlassian 也支持Java 8(并且与Windows和Linux安装包捆绑在一起)。从Jira 7.0版开始,仅支持Java 8。
仅支持 Oracle JDK / JRE 或 OpenJDK JVM。
在安装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报告查询。如果要启用它,请阅读有关子进程选项的更多信息。
建议在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
),然后在指定的数据库服务器中创建其他数据库。
请在生产环境中定期备份其他eazyBI数据库。eazyBI数据库内容不会包含在标准Jira XML备份或Jira数据库模式备份中。
以下是eazyBI数据库设置的数据库服务器特定说明。
作为MySQL管理员创建一个MySQL用户eazybi_jira
,该用户 具有以eazybi_jira开头的所有数据库的访问权限:
在‘eazybi_jira%`上授予所有特权。*‘‘eazybi_jira‘@‘%‘通过‘秘密‘识别;
(替换 secret
为所选密码)。当您保存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存储引擎。
使用创建PostgreSQL数据库用户
创造角色eazybi_jira密码“秘密”LOGIN CREATEDB;
保存eazyBI插件设置后,eazybi_jira
将创建一个新 数据库,每个新的eazyBI帐户将dwh_N
在同一数据库中的新架构(其中N是帐户ID号)中存储数据 。
如果您有大量的Jira问题,那么为了更快地进行eazyBI Jira数据导入,建议调整PostgreSQL内存设置。postgresql.conf
建议使用以下 设置:
shared_buffers = 512MB wal_buffers = 16MB max_connections = 200
shared_buffers
将指定PostgreSQL可以在内存中存储多少数据库数据 - 将其调整到可用的服务器内存(PostgreSQL将在内存中存储的数据越多,将执行的磁盘输入/输出操作越少)。 wal_buffers
影响将事务日志写入磁盘的性能。
请max_connections
根据所有应用程序的PostgreSQL使用情况进行调整。eazyBI连接池最多使用50个数据库连接。
创建MS SQL Server用户 eazybi_jira
- 如果您将使用SQL Server Management Studio,则选择 SQL Server身份验证 并取消选中 强制密码策略。另外,从 Server Roles select dbcreator
(允许创建新 eazybi_jira
数据库)。如果您不想将dbcreator
角色授予此用户,请eazybi_jira
手动创建数据库并将该eazybi_jira
用户用作此数据库的所有者。
In database connection settings, provide the host name, leave the port blank (if default 1433 is used) and leave the instance blank (if default should be used) and enter a database, username, and password. After saving the settings, a new database will be created (if not yet present) and each new eazyBI account will store data in a new dwh_N
schema (where N is the account ID number) in the same database.
默认情况下,eazyBI使用捆绑的jTDS JDBC驱动程序连接到Microsoft SQL Server。jTDS驱动程序不支持与SQL Server的SSL连接。如果SQL Server连接需要SSL,则可以使用支持SSL连接的Microsoft JDBC驱动程序。请下载最新的JDBC驱动程序并将其复制sqljdbc41.jar
到lib
Jira安装目录的子目录中(默认情况下C:\Program Files\Atlassian\JIRA\lib
)。重新启用eazyBI后,您应该在设置页面中看到jTDS和Microsoft JDBC驱动程序选项。
创建Oracle数据库用户 eazybi_jira
。例如,sqlplus
使用Oracle system
用户创建 :
创建用户eazybi_jira由秘密DEFAULT TABLESPACE用户识别; GRANT CONNECT,RESOURCE到eazybi_jira;
(替换 secret
为选择的密码)。请确保eazybi_jira用户没有TABLESPACE
配额或足够大。在数据库连接设置中,提供主机名,数据库名称(数据库的实例或SID名称),用户名和密码。您可以使用Jira使用的相同数据库实例,所有eazyBI数据都将存储在单独的 eazybi_jira
用户架构中。
如果要在数据库连接设置中指定Oracle服务名称而不是SID名称,请在其前面加上/
。所以在Database 字段中使用SID_NAME
或者/SERVICE_NAME
。
您还可以指定Oracle数据库连接的TNS别名(使用该tnsnames.ora
文件时)或完整的TNS连接字符串。在这种情况下,请不要在eazyBI数据库连接参数中指定主机名,只需在数据库名称中指定TNS别名或连接字符串:
oracle.net.tns_admin
Java属性设置为TNS管理目录。(DESCRIPTION=(ADDRESS_LIST=(ADDRESS=(PROTOCOL=tcp)(HOST=localhost)(PORT=1521)))(CONNECT_DATA=(SERVICE_NAME=ORCL)))
建议将系统参数设置OPEN_CURSORS
为1000. eazyBI为常用的SELECT,INSERT和 UPDATE语句保留打开的预准备语句,并使用不同的绑定变量值调用它们。
如果在建立数据库连接或创建数据库时出现任何问题,则单击“ 更新” 按钮后将看到相应的错误消息 。
请阅读有关为更大的Jira Server实例推荐的子进程选项的更多信息 。
选择许可类型 Atlassian Marketplace (如果您在那里创建了试用许可证密钥)或 eazybi.com (如果您收到了beta测试人员许可证密钥)。
输入相应的许可证密钥(以及eazybi.com许可证类型的组织名称)。如果输入的许可证名称或密钥存在任何问题,您将看到相应的错误消息。
如果您使用的是Atlassian Marketplace许可证和最新版本的附加组件管理器,则许可证信息将在附加组件管理器中输入,在此屏幕中您将只看到当前的许可证信息。
输入数据库连接和许可证信息后,单击“ 更新数据库和许可证设置” 以继续。
如果您需要返回到eazyBI 设置 屏幕,请以具有系统管理权限的Jira用户身份登录,并在任何eazyBI页面中单击右上角的 System Admin 链接,然后选择 Settings。
如果数据库连接和许可证信息正确,则将创建eazyBI数据库以及第一个eazyBI帐户(默认名称为“Jira reports”)。在一个eazyBI帐户中,您可以导入一个或多个Jira项目,创建报告,图表和仪表板,并授予对选定Jira用户和组的访问权限。如果在您的Jira服务器中有许多不同用户组使用的不同项目,则很可能需要创建多个eazyBI帐户,并在每个帐户中导入相关的Jira项目子集。
单击“ 创建”后, 将创建一个新的Jira源应用程序,您可以
单击“ 导入” 以启动问题导入。
导入完成后,转到“ 分析” 选项卡并尝试打开示例报告。
如果您想将仪表板页面导出为PDF或使用eazyBI仪表板作为PDF附件发送常规电子邮件,请 在您的Jira服务器上安装无头谷歌Chrome浏览器(从eazyBI版本4.4.0开始)。
如果您需要导出到包含数千行的Excel或CSV表,请参阅Jira服务器配置说明。
eazyBI Jira导入将执行从Jira服务器到其自身的REST API请求(这是Jira Agile和Tempo Timesheets数据导入所必需的)。如果您看到错误
无法向Jira Base URL发出REST API请求...
在设置页面中,这意味着存在Jira服务器设置问题,这些问题不允许发出此类REST API请求。造成这些问题的可能原因如下:
如果您的Jira服务器使用HTTPS连接,您还会看到以下消息:
请安装Java Cryptography Extension(JCE)Unlimited Strength Jurisdiction Policy Files以启用REST API请求的SSL证书验证
如果您的java版本> = 1.8.0_151,那么您可以在<JAVA_HOME>/jre/lib/security/java.security
文件中设置无限制策略 搜索该行, #crypto.policy=unlimited
并删除该 #
字符以取消注释并保存该文件。您将不得不重新启动Jira以实现此功能。
对于旧版本,您需要从给定链接下载文件(JAVA7 - http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html,JAVA8- http:// www.oracle.com/technetwork/java/javase/downloads/jce8-download-2133166.html)并将文件US_export_policy.jar和local_policy.jar复制到目录 <JAVA_HOME> / jre / lib / security(或者甚至更旧的版本)在 <JAVA_HOME> / lib / security中),其中JAVA_HOME是 java.home在 吉拉管理/系统/系统信息。
对于Java> = 9,默认情况下启用。
Jira服务器名称(来自Jira Base URL)未解析为Jira服务器上的正确IP地址。如果您使用的是Linux服务器,请尝试使用Jira服务器中的以下命令对其进行测试:
wget -d -O - JIRA_BASE_URL / rest / api / latest / serverInfo
其中JIRA_BASE_URL是基本URL中吉拉管理/系统/系统信息。 如果您需要帮助来解决此问题,请将此命令的输出发送到 eazyBI支持。
其他可能的原因可能是端口映射,使用iptables
它可能映射端口仅用于传入连接而不用于本地连接。
请参阅高级设置文档中的 本地REST API请求部分,以了解有关如何禁用本地REST API请求或为本地REST API请求指定其他Jira基本URL的更多信息。
原文:https://www.cnblogs.com/kaola8023/p/10363563.html