安装步骤

确定部署方案、Jira 版本，以及相关的硬件和软件配置以后，要正式开始安装了。我们以 Jira Software 单节点部署+ MySQL 方案为例，介绍如何在 Linux 和 Windows 操作系统中安装 Jira 和进行 Jira 系统设置。

如果需要安装集群部署，硬件设备需要增加负载均衡(Load Balance)，多台服务器共享存储。安装过程要比单节点部署多一些步骤，如配置共享目录、增加到负载均衡等，详情请参考 https://confluence.atlassian.com/adminjiraserver0813/set-up-a-jira-data-center-cluster-1027138713.html 。

如果想要安装 Jira 的 Server 版本，需要自行寻找安装软件，官网已经不提供 Server 版本软件下载了。Jira Server 版本的安装方法可以参考单节点部署的安装步骤。

准备MySQL数据库

在安装 Jira 之前，我们先安装 MySQL 5.7，并且为 Jira 创建数据库、用户以及修改 MySQL 默认配置。

  1. 安装MySQL

    可以到 MySQL 官网( https://dev.mysql.com/downloads )下载符合你操作系统的安装包，然后在服务器上安装好 MySQL 5.7。根据系统规模，需要考虑数据库和 Jira 是否安装在不同的机器上，以提高系统性能。

  2. 创建 Jira 数据库

    在安装好的 MySQL 上新建一个数据库，如 jiradb，代码如下：

    CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;

  3. 创建 Jira 数据库用户在 MySQL 上新建一个 Jira 用户 jiradbuser，并且把 Jira 数据库的权限赋予这个用户。把以下命令行中 Jira 服务器的 IP 和密码替换为环境中的实际值。

    image 2023 11 17 14 58 28 047

  4. 修改 MySQL 默认配置打开 MySQL 的配置文件（my.cnf 或 my.ini），检查 [mysqld] 段落下的配置项，对照下面的代码进行设置。

    image 2023 11 17 14 59 38 886

Windows系统安装Jira

Jira 为 Windows 系统提供了两种安装方式：一种是安装程序，可以自动化安装，简单易用，建议使用这种方式；另一种是压缩包，需要手动安装和配置。如果你的环境无法自动安装程序，那么可以进行手动安装。

我们以 Jira 最新稳定版(8.13.0)的安装程序为例进行介绍。

  1. 第一步，在 Atlassian 官方网站( https://www.atlassian.com/zh/software/jira/update )下载 Windows 安装包到服务器，选择“8.13.0(Windows 64 Bit Install)”。

  2. 第二步，使用管理员身份运行 Jira 的安装程序，在安装程序界面单击 Next，开始安装。

  3. 第三步，选择安装或者升级选项，单击 Custom Install 进行定制安装，这样可以手动安装程序目录、数据目录和程序端口。如果单击 Express Install 进行快速安装，将使用默认的目录和端口设置。

  4. 第四步，选择 Jira 程序安装路径。这个路径是 Jira 程序的主目录，其中包括 Jira 的程序、库文件、系统配置文件等。

  5. 第五步，选择 Jira 数据目录。这个路径是 Jira 存储用户数据的目录，其中包括用户的数据（附件、头像）、系统数据备份、用户安装的插件、索引文件等。请不要放在 Jira 程序安装路径的子目录中。

  6. 第六步，选择创建 Jira 程序快捷方式的位置。

  7. 第七步，选择 Jira 网站和控制程序的网络端口，须考虑用户访问网站的便利性和服务器的端口分配，端口不能和其他程序冲突。当采用 80 端口时，用户访问 Jira 网站无须输入端口号。

  8. 第八步，选择是否采用 Windows 服务的方式来启动和停止 Jira。如果选择是，服务器启动时会自动启动 Jira 服务，并且可以在 Windows 服务中控制 Jira 服务的启动和停止。

  9. 第九步，检查并确认全部的安装设置，如果检查无误，单击“下一步”开始安装。

  10. 第十步，安装完毕后，单击“启动 Jira”。第十一步，启动 Jira 程序后，单击“完成”，系统会自动打开浏览器，访问 Jira 网站进行系统设置。至此， Jira 安装已经完成，后续的设置参见2.3节。

Linux系统安装Jira

Jira 为 Linux 系统也提供了两种安装方式：一种是安装程序，可以自动化安装，简单易用，建议使用这种方式；另一种是压缩包，需要手动安装和配置。

我们以 Jira 最新稳定版(8.13.0)的安装程序为例进行说明。

  1. 第一步，在 Atlassian 网站( https://www.atlassian.com/zh/software/jira/update )下载 Linux 安装包到服务器，这里我们选择 “8.13.0(Linux 64 Bit Install)”。

  2. 第二步，下载 Jira 安装包以后，把文件上传到 Linux 服务器，并且给文件增加执行属性。

    image 2023 11 17 15 04 42 470

  3. 第三步，使用 sudo 命令执行安装程序，根据提示选择安装参数。这里我们选择自定义模式，可以选择安装路径和服务端口。

    image 2023 11 17 15 05 17 295

  4. 第四步，根据需要选择安装路径和服务端口，选择是否要将 Jira 安装为系统服务。注意不要把 data 目录放在 Jira 程序安装路径的子目录中。

    image 2023 11 17 15 06 10 366
    image 2023 11 17 15 06 28 774

  5. 第五步，确定安装参数无误后，执行安装。安装程序执行完成后，会自动创建一个新用户 jira，并且使用这个用户的身份来启动 Jira 服务。

至此，Jira 安装已经完成，后续的设置参见 2.3 节。

image 2023 11 17 15 07 37 798

安装完成后，可以分别使用以下两个命令来启动和关闭 Jira 服务。

image 2023 11 17 15 08 06 678
image 2023 11 17 15 08 25 110