jira中使用eazyBI

Posted 2021-02-08 kaola8023

参考：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支持。

Java版本

对于从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。

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），然后在指定的数据库服务器中创建其他数据库。

请在生产环境中定期备份其他eazyBI数据库。eazyBI数据库内容不会包含在标准Jira XML备份或Jira数据库模式备份中。

以下是eazyBI数据库设置的数据库服务器特定说明。

MySQL的

作为MySQL管理员创建一个MySQL用户eazybi_jira ，该用户  具有以eazybi_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 Server实例推荐的子进程选项的更多信息  。

注册码

选择许可类型  Atlassian Marketplace  （如果您在那里创建了试用许可证密钥）或  eazybi.com  （如果您收到了beta测试人员许可证密钥）。

输入相应的许可证密钥（以及eazybi.com许可证类型的组织名称）。如果输入的许可证名称或密钥存在任何问题，您将看到相应的错误消息。

如果您使用的是Atlassian Marketplace许可证和最新版本的附加组件管理器，则许可证信息将在附加组件管理器中输入，在此屏幕中您将只看到当前的许可证信息。

输入数据库连接和许可证信息后，单击“  更新数据库和许可证设置”  以继续。

如果您需要返回到eazyBI  设置  屏幕，请以具有系统管理权限的Jira用户身份登录，并在任何eazyBI页面中单击右上角的  System Admin  链接，然后选择  Settings。

执行第一个Jira数据导入

如果数据库连接和许可证信息正确，则将创建eazyBI数据库以及第一个eazyBI帐户（默认名称为“Jira reports”）。在一个eazyBI帐户中，您可以导入一个或多个Jira项目，创建报告，图表和仪表板，并授予对选定Jira用户和组的访问权限。如果在您的Jira服务器中有许多不同用户组使用的不同项目，则很可能需要创建多个eazyBI帐户，并在每个帐户中导入相关的Jira项目子集。

单击“  创建”后，  将创建一个新的Jira源应用程序，您可以

• 在第一个eazyBI帐户中选择要导入的Jira项目
• 选择是否要导入状态转换历史记录
• 应安排定期问题导入的频率（默认情况下每天一次）
• 选择要导入的自定义字段（详细了解  支持的自定义字段类型）

单击“  导入”  以启动问题导入。

检查导入结果

导入完成后，转到“  分析”  选项卡并尝试打开示例报告。

导出为PDF

如果您想将仪表板页面导出为PDF或使用eazyBI仪表板作为PDF附件发送常规电子邮件，请 在您的Jira服务器上安装无头谷歌Chrome浏览器（从eazyBI版本4.4.0开始）。

将大表导出为Excel或CSV

如果您需要导出到包含数千行的Excel或CSV表，请参阅Jira服务器配置说明。

REST API请求错误

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它可能映射端口仅用于传入连接而不用于本地连接。

• 您正在使用Jira版本6.1.4,6.1.5或6.1.6，它们有一个JRA-36276错误  ，它可以防止本地REST API请求。在这种情况下，请升级到后来的Jira版本，该版本有针对此问题的错误修复。

请参阅高级设置文档中的  本地REST API请求部分，以了解有关如何禁用本地REST API请求或为本地REST API请求指定其他Jira基本URL的更多信息。

Microsoft的IIS数据导入错误