搭建JIRA

前言
- 阅读本文档的Markdown版本时需要网络环境，如果没有网络，你会看不到后半部分的图片；
- 软件资源来自网络，如果有侵权行为，请联系我，请和我协商，请不要把我带走@_@，先行致谢；
一、准备工作
- ATLASSIAN 官方网站
- jira7.3.8安装包：要选Linux的jira 7.3.8哦！
- jira7.3-crack文件
- 一台纯洁的机器jira（Minimal的CentOS7）

二、安装过程

配置一些基础的环境
- 1. 修改yum源
- 1. 关闭SELINUX
- 1. 关闭防火墙
- 1. 推荐安装vim、rz（lrzsz）

安装Java虚拟机

我选择安装JDK1.8


x
# 使用如下命令查看源中的JDK版本
[root@jira ~]# yum provides java

# 选择一个1.8版本安装（我选择了1.8版本的最后一个)
[root@jira ~]# yum -y install 1:java-1.8.0-openjdk-1.8.0.191.b12-1.el7_6.x86_64

使用如下命令查看是否安装成功，出现类似如下的信息代表你安装成功


xxxxxxxxxx
[root@jira ~]# java -version
openjdk version "1.8.0_191"
OpenJDK Runtime Environment (build 1.8.0_191-b12)
OpenJDK 64-Bit Server VM (build 25.191-b12, mixed mode)
[root@jira ~]#

安装mariadb数据库


xxxxxxxxxx
[root@jira ~]# yum -y install mariadb-server mariadb

开启数据库并设置为开机自启


xxxxxxxxxx
# 开启数据库
[root@jira ~]# systemctl start mariadb
# 设置开机自启
[root@jira ~]# systemctl enable mariadb

初始化数据库


xxxxxxxxxx
[root@jira ~]# mysql_secure_installation

执行上一条语句后，很多同学不会处理接下来得交互问题，我接下来讲一下每个问题该如何回答

第一问：


xxxxxxxxxx
In order to (此处省略若干字）…… . If you've just installed MariaDB, and
you haven't set the root password yet, the password will be blank,
so you should just press enter here.

Enter current password for root (enter for none): (按回车键)

在问题的上方，mariadb系统提示你：“如果你还没有root密码，那密码应该是空的，因此你在这里应该按回车”，因为我们是初始化数据库，确实还没有root密码，所以按回车键就好。

第二问：


xxxxxxxxxx
Set root password? [Y/n] y

它问题是否设置root密码，输入y，设置

第三问及第四问：
```
xxxxxxxxxx
New password:y
Re-enter new password:y
```
输入你的新密码：y（这是我的密码，请你用你自己的！！）
把密码再输入一遍（进行确认）：y
第五问：
```
xxxxxxxxxx
Remove anonymous users? [Y/n]y
```
它问是否移除匿名用户？这是一种安全优化，移除匿名用户更安全，而且我们也不需要匿名登录，所以输入y，移除
第六问：
```
xxxxxxxxxx
Disallow root login remotely? [Y/n]n
```
它问是否允许root用户远程登录？我们平常是使用Xhell的，而且一些数据库管理工具也需要ssh，不使用远程登录不便于我们学习，所以果断开启，输入n，允许root远程登录

第七问：


xxxxxxxxxx
Remove test database and access to it? [Y/n]y

它问要移除test数据库吗？数据在创建时，会默认添加一个test数据库，实际上我们用不到，删除，输入y

第八问：
```
xxxxxxxxxx
Reload privilege tables now? [Y/n]y
```
它问"现在重新加载特权表?"，我不太了解特权表是什么，但是我们做了这么多关于初始化的设置，确实需要重新加载一些配置文件，所以我选了重新加载，输入y

最后命令行回显这个，就是配置完成了！


xxxxxxxxxx
Thanks for using MariaDB!
[root@jira ~]#

创建jira数据库

因为对数据库的命令不了解，所以以下内容来自网络。

等以后学习了数据库的知识，会再来修改这部分文档


xxxxxxxxxx
# 登录mysql
[root@jira ~]# mysql -uroot -py

# 创建`jira`数据库
MariaDB [(none)]> create database jira default character set utf8 collate utf8_bin;
# 回显如下，代表数据库创建成功
Query OK, 1 row affected (0.00 sec)
# 退出数据库
MariaDB [(none)]> exit
[root@jira ~]#

安装jira7.3.8

我的jira7.3.8安装包在/root下，安装包名atlassian-jira-software-7.3.8-x64_2.bin

以下方法二选一


xxxxxxxxxx
# 给bin包添加可执行权限
[root@jira ~]# chmod 755 atlassian-jira-software-7.3.8-x64_2.bin

# 添加权限的另一种方法
[root@jira ~]# chmod +x atlassian-jira-software-7.3.8-x64_2.bin

安装


xxxxxxxxxx
[root@jira ~]# ./atlassian-jira-software-7.3.8-x64_2.bin

安装过程中jira会问你几个问题，我在下面解释一下问题的意思

第一问：


xxxxxxxxxx
This will install JIRA Software 7.3.8 on your computer.
OK [o, Enter], Cancel [c]

（输入`o` 或 按`回车`键）

这里是在通知你，将要在你的电脑上安装JIRA 7.3.8，输入o 或按回车键，允许程序安装

第二问：


xxxxxxxxxx
Choose the appropriate installation or upgrade option.
Please choose one of the following:
Express Install (use default settings) [1], Custom Install (recommended for advanced users) [2, Enter], Upgrade an existing JIRA installation [3]

（输入`1`）

系统提示你“选择适当的安装或升级选项”

这里三个选项的含义分别是快速安装（默认设置）、自定义安装（适合高级用户）以及升级现有的JIRA

我们这里选择1，使用默认设置快速安装就好

第三问：


xxxxxxxxxx
Details on where JIRA Software will be installed and the settings that will be used.
Installation Directory: /opt/atlassian/jira 
Home Directory: /var/atlassian/application-data/jira 
HTTP Port: 8080 
RMI Port: 8005 
Install as service: Yes 
Install [i, Enter], Exit [e]

（输入`i` 或 按`回车`键）

这里是在提示你，默认设置是什么样的

默认安装路径是


xxxxxxxxxx
/opt/atlassian/jira

默认家路径是


xxxxxxxxxx
/var/atlassian/application-data/jira

其实，我还是觉得Home Directory翻译成起始路径或有效路径比较好，翻译成家路径好像容易引起歧义，这里拿捏不准，为了便于读者直接联想到Home这个单词，暂且选择翻译成家路径

默认监听端口**是


xxxxxxxxxx
HTTP Port: 8080 
RMI Port: 8005

如果你同意默认设置，那么输入i或按回车，等待安装完成

在一小段时间的等待后，它还会蹦出一个问题


xxxxxxxxxx
Installation of JIRA Software 7.3.8 is complete
Start JIRA Software 7.3.8 now?
Yes [y, Enter], No [n]

（输入`y` 或 按`回车`键）

其实到这一步，安装已经完成了。系统在问你，是不是现在就启动JIRA？我们接下来还要进行破解，需要替换JIRA的文件，所以我们选择不启动，输入n

出现如下信息，代表安装成功


xxxxxxxxxx
Installation of JIRA Software 7.3.8 is complete
Your installation of JIRA Software 7.3.8 is now ready.
Finishing installation ...
[root@jira ~]#

破解jira7.3.8分为两部分，第一部分替换原文件，第二部分是跳过秘钥

破解jira7.3.8（第一部分）

我的破解包位于/root，目录结构如下


xxxxxxxxxx
[root@jira ~]# tree jira7.3-crack/
jira7.3-crack/
├── atlassian-extras-3.2.jar
└── mysql-connector-java-5.1.39-bin.jar

0 directories, 2 files
[root@jira ~]#

把破解包里的文件复制到/opt/atlassian/jira/atlassian-jira/WEB-INF/lib/目录下


xxxxxxxxxx
[root@jira ~]# \cp -f ~/jira7.3-crack/* /opt/atlassian/jira/atlassian-jira/WEB-INF/lib/

cp命令系统默认是cp -i的别名，使用\cp是告诉shell不使用cp命令的别名，可以使操作简单一点；即便没有加\也别担心，只需要多按次回车就行

这里简单介绍一下两个jar包的功能：

atlassian-extras-3.2.jar：和license相关
mysql-connector-java-5.1.39-bin.jar：jira连接mysql数据库相关的jar包

到这里破解的第一部分完成

开启jira服务


xxxxxxxxxx
/opt/atlassian/jira/bin/start-jira.sh

打开jira首页测试服务是否成功启动，通过Windows的浏览器访问jira 机器的IP地址：8090端口，例如：


xxxxxxxxxx
http://192.168.25.138:8080

接下来按图操作

选择自定义配置

配置数据库
选择使用自己的数据库
选择使用自己的数据库后，会展开如下表单。因为我没有使用分离部署，所以Hostname字段使用的就是127.0.0.1，如果你是采用分离部署的方式安装，请输入你自己的数据库地址
执行完第三步、出现successful提示后，点击Next
这里需要等待的时间有点长，它在页面的最下方给了提示
```
xxxxxxxxxx
Please wait while the database is set up. This may take a minute...
```
接下来比较的配置比较随意
下图是jira应用的一些属性
这里解释一下Mode的两种模式
- Private模式：只有管理员才能创建新的工单
- Public模式：任何能登录的人都能创建工单
我这里选择了Private
破解jira7.3.8（第二部分）
Server ID页面
ATLASSIAN用户登录界面
申请试用码要完成这个表单，需要你注意的是，这里要选Jira Software(Server)
Jira Software(Server)与Jira Software(Data Center)的左右顺序是会变动的，不要无脑选左边
获得License Key
将License Key粘贴进jira页面
粘贴进去后，点击Next，如果能出现接下里步骤的页面，就算成功跳过License Key了。至此，破解第一、二部分均完成。
配置管理员账户
设置邮件提醒

点击Finish，完成安装

系统会在底部提示你


xxxxxxxxxx
Please wait while the final step of the JIRA installation is being performed...

意思是“正在执行JIRA安装的最后一步，请稍候……”

选择语言
选择完语言后，还有一步选择头像，简单又没坑，所以这里就容我省略了
最后，完结撒花❀❀❀

三、QA & DEBUG

为什么我在执行如下命令后


xxxxxxxxxx
[root@jira ~]# mysql_secure_installation

系统会连续不停的提问呢？

请确认你已经开启了mariadb


xxxxxxxxxx
# 使用如下命令查看 mariadb 是否开启
[root@jira ~]# ps aux | grep mariadb

# 或使用如下命令开启 mariadb
[root@jira ~]# systemctl restart mariadb

如何启动和关闭jira？


xxxxxxxxxx
# 启动 jira
[root@jira ~]# /opt/atlassian/jira/bin/start-jira.sh

# 关闭 jira
[root@jira ~]# /opt/atlassian/jira/bin/stop-jira.sh

我出现了如下问题怎么办？

这个问题的因为，很可能是你在使用破解文件替换源文件前，便开启了jira，结果导致破解文件并未生效，解决的方法也很简单，先将jira进程杀掉，再重启jira就好了


xxxxxxxxxx
# 查找 jira 进程
[root@jira ~]# ps aux | grep jira
# 杀掉 jira 进程
[root@jira ~]# kill -9 (jira's pid)
# 启动 jira
[root@jira ~]# /opt/atlassian/jira/bin/start-jira.sh

我在执行完如下这步后

出现了如下问题（空白页面）

打开浏览器控制台（按F12查看），状况如下

尝试重启jira后出现如下状况

但是过一会后，自行跳转到如下页面

点击Back To JIRA后，又出现如下问题

上述情况该如何解决？

如果你是重装Jira后产生的上述问题，可能是因为你之前删除Jira时，删除地不干净导致的。

如果你删除了jira安装路径与家路径下的文件，但却没有删除jira用户，就可能产生上述问题。

解决方法是删除掉那些没有删除干净的残渣文件和信息（包括用户信息、家目录等）

具体操作，举例如下


xxxxxxxxxx
# 查询到底有多少个残渣用户
[root@jira ~]# vim /etc/passwd
jira:x:1005:1005:Atlassian JIRA:/home/jira:/bin/bash
jira1:x:1005:1005:Atlassian JIRA:/home/jira1:/bin/bash
jira2:x:1005:1005:Atlassian JIRA:/home/jira2:/bin/bash
jira3:x:1005:1005:Atlassian JIRA:/home/jira3:/bin/bash

# 由上述信息可知，jira3 一定是最新加上去的，所以 jira 、jira1 、 jira2 都是残渣用户 
# 把这三个用户都删掉
[root@jira ~]# userdel -r jira 
[root@jira ~]# userdel -r jira1
[root@jira ~]# userdel -r jira2

# 再次重启 jira 并用浏览器访问，成功消灭BUG

我该怎么删除jira呢？
在安装时，jira会提示你将其安装在了什么位置（如果你忘记了，可以再读一遍安装文档）；
如果是使用默认配置进行安装，那只需要执行如下命令即可：
```
xxxxxxxxxx
[root@jira ~]# rm -rf /opt/atlassian/jira 
[root@jira ~]# rm -rf /var/atlassian/application-data/jira 
```
需要你注意的是，使用绝对路径进行删除是个不好的习惯，建议你先进入目录再删除。
除此之外，还需要你删除jira的用户和组，否则你再安装jira的时候，jira的用户名会被命名为jira1、jira2……
具体方法是
```
xxxxxxxxxx
[root@jira ~]# userdel -r jira 
```

搭建JIRA

EOF