在Linux上安装JIRA应用

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. 运行安装包

  1. 使安装包可执行。
    切换到JIRA下载目录，执行如下命令：

    $ chmod a+x atlassian-jira-software-X.X.X-x64.bin

    其中，jira-software.X.X.X is 是指你下载的JIRA的版本号信息。

  2. 执行安装包 - 我们建议使用sudo运行安装包，因为这可以创建特定账户来运行JIRA，而且允许你将JIRA作为服务运行。
     要使用sudo运行安装包，执行如下命令：

    $ sudo ./atlassian-jira-software-X.X.X-x64.bin

    其中jira-software.X.X.X is 是指你下载的JIRA的版本号信息。

    你也可以选择使用root账户来运行安装包。

  3. 根据提示一步步安装JIRA，你需要输入如下信息：
    1. Destination directory - 即JIRA将会被安装到的位置。
    2. Home directory - 用于存放JIRA数据，如日志，搜索索引和文件存储。
    3. TCP ports - 这是JIRA运行的http的连接器端口和控制端口。如果端口没有被其他应用占用，此处保持默认即可。
    4. Install as service - 这个选项只有管理员账户运行安装包时才能看到。
  4.  安装完成后，可在浏览器中启动JIRA。
  5. 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运行安装包时才能看到。 
  6. 安装完成后，在浏览器输入 http://localhost:8080 即可开始设置。. 
    (如果你安装时指定了不同的端口后，将此处的8080替换) 

设置JIRA应用

3. 选择设置方法

 选择 I'll set it up myself. 

4. 连接到数据库 

  1. 如果你还没有准备好，现在是创建数据库的时候了。查看 ‘开始之前’ 一节了解详细信息。
  2. 选择 My own database. 
  3. 选择你的数据库类型，然后输入数据库的详细信息。

JIRA会使用一个标准的JDBC连接件连接你的数据库。JIRA负责管理连接池，你可以稍后使用“JIRA configuration tool”修改配置。 

如果你使用的MySQL，需要如下额外的步骤：

    • 下载并解压对应的JDBC驱动。
    • 在进行下一步前，先将解压后的文件拷贝到安装目录<jira-installation>/lib下。

在设置向导中：

    • Driver Class Name – 你的数据库驱动的Java类名，如果不确定，可以查看数据库对应的说明文档。
    • Database URL – 数据库的JDBC URL。如果不确定，可以查看数据库对应的说明文档。
    • Username and Password – JIRA用连接数据库的用户名和密码.  

5. 设置应用配置项 

  1. 给出你JIRA站点的名字。
  2. 选择你的站点是否是私有的，还是任何人都可以登录的。你可以稍后修改这个配置。 
  3. 设置你的 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来访问了。

下面几个操作，可以帮助你使整个团队运作起来。

问题解决

    • 有些杀毒软件或者网络安全工具可能会与JIRA安装进程产生冲突，导致安装过程无法成功执行。如果你确定或者猜测你的杀毒软件/网络安全工具会引起这个问题，在执行安全包前先禁用该软件。
    • 当服务器的可用内存太少时，Linux OOM Killer 有时会杀死JIRA进程。查看 How to Configure the Linux Out-of-Memory Killer.

在我们的知识库中搜索Installation Troubleshooting可以获取更多的帮助。

posted @ 2018-03-13 15:54  临江仙·2007  阅读(565)  评论(0)  编辑  收藏  举报