EN: https://confluence.atlassian.com/adminjiraserver073/installing-jira-applications-on-linux-861253030.html
在本向导中,我们会引导你在生产环境中使用Linux安装包安装一个带有外置数据库的JIRA应用。这是在Linux服务器上搭建并运行一个生产环境站点最简单的方式。

其他安装Jira的方式
- Evaluation - 获取并立刻运行一个试用环境。
- Zip - 通过zip压缩包手动安装。
- Windows - 基于Windows系统安装。
在开始之前
在你安装Jira前,你需要确认如下几个问题。
你使用的是否是受支持的操作系统?
|
从 Supported Platforms 网页查找你将要安装的JIRA版本所支持的操作系统、数据库和浏览器的信息。
须知:
- 我们不支持在OSX或mac OS上安装JIRA作为生产环境站点。
- JIRA安装包里包含了Java(JRE)和Tomcat,所以你不需要单独安装他们。
- JIRA无法在OpenJDK上运行。
|
你是否打算将JIRA作为一个服务运行?
|
JIRA作为服务运行是指,JIRA会在Linux系统启动时自启动。
如果你选择将JIRA作为服务运行:
- 你必须使用sod运行安装包才能将JIRA作为服务安装。
- 安装包将会创建一个专用账户,jira,用来运行服务。
如果你选择将JIRA作为非服务运行:
- 你需要在JIRA的安装目录运行start-jira.sh来启动或停止JIRA。
- JIRA需要使用安装JIRA时的用户运行,或者你可以选择一个特定的用户运行。
- 如果服务器重启,你需要手动启动JIRA。
|
你的数据库是否已经安装并可以使用?
|
在生产环境运行JIRA,你需要一个外置数据库。在 Supported platforms 页面检查你所安装的JIRA版本支持的数据库列表。如果你没有可用的数据库,推荐PostgreSQL,免费,易安装,而且被广泛用于JIRA。
须知:
- 在开始之前,先安装你的数据库。可以在 PostgreSQL , Oracle , MySQL , and SQL Server网站找到傻瓜式安装指导。
- 使用UTF-8编码。
- 如果你使用Oracle或者MySQL,你需要为你的数据库下载一个驱动。
- 可以在JIRA测试环境中使用H2嵌入式数据库,但在生产环境中你需要将其移动到另外一个数据库中。你会发现在开始时使用一个外置的数据库会更简单一些。
|
你有JIRA许可吗? |
你需要一个JIRA软件服务器,JIRA核心服务器或者JIRA桌面服务的有效许可来正常使用JIRA。
须知:
- 如果你没有购买一个JIRA应用的许可,你可以在安装过程中创建一个试用许可。
- 如果你已经有了一个许可,在安装时会提示你登录 my.atlassian.com来获取许可的密钥,你也可以手动输入。
- 如果你从JIRA云上迁移,你需要获取一个新的许可。
|
检查一些已知问题
|
对于Linux安装,我们已知在显示一些特定的系统文本(验证码和小工具)时会有问题,与常规的字母数字字符不同,这些文本似乎是乱码或者看起来像是个符号。为了避免这些问题,你需要安装几个JIRA需要的字体库。更多信息参考 JIRA UI shows unreadable text。
|
安装JIRA应用
1. 下载JIRA
根据你的操作系统类型下载对应的安装包 – https://www.atlassian.com/software/jira/download
2. 运行安装包
- 使安装包可执行。
切换到JIRA下载目录,执行如下命令:
其中,jira-software.X.X.X
is 是指你下载的JIRA的版本号信息。
- 执行安装包 - 我们建议使用sudo运行安装包,因为这可以创建特定账户来运行JIRA,而且允许你将JIRA作为服务运行。
要使用sudo运行安装包,执行如下命令:
其中jira-software.X.X.X
is 是指你下载的JIRA的版本号信息。
你也可以选择使用root账户来运行安装包。
- 根据提示一步步安装JIRA,你需要输入如下信息:
- Destination directory - 即JIRA将会被安装到的位置。
- Home directory - 用于存放JIRA数据,如日志,搜索索引和文件存储。
- TCP ports - 这是JIRA运行的http的连接器端口和控制端口。如果端口没有被其他应用占用,此处保持默认即可。
- Install as service - 这个选项只有管理员账户运行安装包时才能看到。
- 安装完成后,可在浏览器中启动JIRA。
- Follow the prompts to install JIRA. You'll be asked for the following info:
- Install type – 选择第二个选项(custom)来进行更多配置。
- Destination directory – JIRA将要被安装的目录。
- Home directory – 运行日志、搜索索引和文件等JIRA数据的存放目录。
- TCP ports – 这是JIRA运行的http的连接器端口和控制端口。如果端口没有被其他应用占用,此处保持默认即可。
- Install as service – 这个选项只有sudo运行安装包时才能看到。
- 安装完成后,在浏览器输入 http://localhost:8080 即可开始设置。.
(如果你安装时指定了不同的端口后,将此处的8080替换)
设置JIRA应用
3. 选择设置方法
选择 I'll set it up myself.
4. 连接到数据库
- 如果你还没有准备好,现在是创建数据库的时候了。查看 ‘开始之前’ 一节了解详细信息。
- 选择 My own database.
- 选择你的数据库类型,然后输入数据库的详细信息。
JIRA会使用一个标准的JDBC连接件连接你的数据库。JIRA负责管理连接池,你可以稍后使用“ JIRA configuration tool”修改配置。
如果你使用的MySQL,需要如下额外的步骤:
- 下载并解压对应的JDBC驱动。
- 在进行下一步前,先将解压后的文件拷贝到安装目录
<jira-installation>
/lib下。
在设置向导中:
- Driver Class Name – 你的数据库驱动的Java类名,如果不确定,可以查看数据库对应的说明文档。
- Database URL – 数据库的JDBC URL。如果不确定,可以查看数据库对应的说明文档。
- Username and Password – JIRA用连接数据库的用户名和密码.
5. 设置应用配置项
- 给出你JIRA站点的名字。
- 选择你的站点是否是私有的,还是任何人都可以登录的。你可以稍后修改这个配置。
- 设置你的 BASE URL - 访问者将通过这个BASE URL访问你的站点。
6. 输入许可
根据提示信息登录 my.atlassian.com 来获取许可,或受哦的那个输入许可的密钥信息。
7. 创建管理员账户
输入管理员账户信息。你可以在设置完成后,添加更多的管理员账户。
8. 设置邮件通知
输入邮件服务器的信息。如此一来,JIRA就可以在ISSUE发生变化时发送通知邮件。
9. 开始使用JIRA
就这样!你的JIRA站点已经可以通过BASE URL或者一个类似于http://<computer_name_or_IP_address>:<port>的URL来访问了。
下面几个操作,可以帮助你使整个团队运作起来。
- Add and invite users邀请或添加用户加入你的团队,对于稍微大点的团队,可以通过 configure user directories配置。
- Create your first project 创建你的第一个项目,以便有事可做。
- Configure SSL or HTTPS 配置SSL或HTTPS,让你的团队更安全。
问题解决
- 有些杀毒软件或者网络安全工具可能会与JIRA安装进程产生冲突,导致安装过程无法成功执行。如果你确定或者猜测你的杀毒软件/网络安全工具会引起这个问题,在执行安全包前先禁用该软件。
- 当服务器的可用内存太少时, Linux OOM Killer 有时会杀死JIRA进程。查看 How to Configure the Linux Out-of-Memory Killer.