生产JIRA安装及配置

安装环境描述

Linux硬件配置：8U，16G

部署流程

安装配置mysql–>安装配置jira–>配置nginx反代–>配置jira连接数据库，数据初始化

生产安装JIRA的前提条件

https://confluence.atlassian.com/adminjiraserver/installing-jira-applications-on-linux-938846841.html#InstallingJiraapplicationsonLinux-Installaapplication
以上是atlassian官网，其中说明了关于jira安装的所有前提条件及安装信息，以 下我简单说明一下注意事项。

首先是数据库，jira可以连接多种数据库，详细可转到==>https://confluence.atlassian.com/adminjiraserver/supported-platforms-938846830.html<==查看，这里选择了使用较多的MySQL进行部署。

注：MySQL在低版本（5.6版本及之前）不支持对4字节的信息存储，因此在写入emoji表情时会导致存储失败，这里建议使用MySQL5.7的稳定版本。

关于jira的安装包（下载地址：https://www.atlassian.com/software/jira/download），选择Linux 64 Bit进行下载，其中内置了jdk和tomcat，开箱即用。

点击下载：https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-8.14.0-x64.bin

一、安装配置MySQL

我所采用的是MySQL通用版本，是已经编译完成的tar包，直接解压配置即可。

点击下载：https://downloads.mysql.com/archives/get/p/23/file/mysql-5.7.29-linux-glibc2.12-x86_64.tar.gz

导入MySQL安装包，转到SHELL界面，根据环境自行执行以下配置

groupadd mysql    #创建MySQL组

useradd -M -s /sbin/nologin -r -g mysql mysql    #创建MySQL用户，不允许登录系统，仅用于MySQL运行

tar xf mysql-5.7.29-linux-glibc2.12-x86_64.tar.gz

mv mysql-5.7.29-linux-glibc2.12-x86_64 /usr/local/mysql

mkdir -p /data/mysql/{data,log}   #数据，日志存放路径

chown mysql:mysql -R /data/       #存储目录赋权

chown mysql:mysql -R /usr/local/mysql/      #安装目录赋权

接下来配置my.cnf文件，这里要说明一下，因为jira和confluence都连接同一个MySQL中，所以其中整合了jira和confluence对MySQL的配置。

注：其中只包含了运行jira和confluence的全部配置，并未对mysql进行优化，若有需要，可自行添加

[mysqld]
user=mysql  #mysql启动用户
port=3306   #端口
basedir=/usr/local/mysql   #安装目录
lower_case_table_names=1 #MySQL不区分大小写，特别注意：如果数据原本已经配置了区分大小写，直接改成不区分会导致之前大写的库表数据找不到，可以先导出，修改完成后再重新导入，最好在是MySQL安装阶段配置
 
datadir=/data/mysql/data  #库存放目录
log-error=/data/mysql/log/mysql.err   #错误日志存放目录
pid-file=/usr/local/mysql/mysql.pid     #pid文件存放路径
 
character-set-server=utf8mb4    #服务器安装时指定的默认编码格式
collation-server=utf8mb4_bin    #指定数据存储字符的编码格式
 
default-storage-engine=INNODB   #数据存储引擎
innodb_default_row_format=DYNAMIC    #将默认行格式设置为 DYNAMIC
innodb_large_prefix=ON   #启用前缀索引
innodb_file_format=Barracuda   #将InnoDB文件格式设置为Barracuda
max_allowed_packet=256M   #mysql最大接受包的大小为256M
innodb_log_file_size=2GB   #日志文件最大为2GB
 
transaction-isolation=READ-COMMITTED  #事务隔离级别READ-COMMITTED
binlog_format=row   #binlog日志格式设置为row
max_connections = 250   #MySQL最大连接数设置为250
skip_ssl   #关闭ssl

添加MySQL命令软链接

ln -s /usr/local/mysql/bin/* /usr/sbin/

接下来安装链接库文件，初始化数据库，默认链接库文件是没有的，直接初始化会报这个错误。

yum install libaio-devel.x86_64 -y  #安装链接库文件
 
/usr/local/mysql/bin/mysqld --initialize-insecure --user=mysql --basedir=/usr/local/mysql --datadir=/data/mysql/data   #初始化数据库
 
cp /usr/local/mysql/support-files/mysql.server /etc/init.d/mysqld  #复制MySQL启动脚本
 
chmod +x /etc/init.d/mysqld
 
/etc/init.d/mysqld  {start|stop|restart|reload|force-reload|status}   #MySQL控制脚本

启动MySQL之后，配置MySQL密码，创建jira相关的库及用户

mysqladmin -uroot password JCDB_admin
 
mysql -uroot -pJCDB_admin
 
CREATE DATABASE jiradb CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;
 
GRANT SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,REFERENCES,ALTER,INDEX on jiradb.* TO 'jirauser'@'%' IDENTIFIED BY 'jira_admin!';
 
flush privileges;

到此为止，关于MySQL的安装配置就完成了，下面是主菜jira。

二、安装Jira

关于jira的安装比较简单，将bin包下载好之后，按照提示执行即可。

点击下载：https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-software-8.14.0-x64.bin

下载完成后，建议放在/opt目录下。

chmod +x atlassian-jira-software-8.14.0-x64.bin 

添加权限之后，开始执行安装。

./atlassian-jira-software-8.14.0-x64.bin

以下为安装脚本配置流程

We couldn't find fontconfig, which is required to use OpenJDK. Press [y, Enter] to install it.   #如果没有fontconfig，需要安装fontconfig
For more info, see https://confluence.atlassian.com/x/PRCEOQ
y  #回车
 
This will install Jira Software 8.14.0 on your computer.   #是否安装Jira Software 8.14.0
OK [o, Enter], Cancel [c]   
o   #回车
 
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]    #选择自定义安装
2  #回车
 
Select the folder where you would like Jira Software to be installed.   #指定jira的安装目录和数据存放目录
Where should Jira Software be installed?
[/opt/atlassian/jira]
#选择默认即可
 
Default location for Jira Software data   #将数据存放目录指定到数据存储盘
[/var/atlassian/application-data/jira]
/data/atlassian/application-data/jira
 
Configure which ports Jira Software will use.   #指定jira的服务端口和控制端口
Jira requires two TCP ports that are not being used by any other
applications on this machine. The HTTP port is where you will access Jira
through your browser. The Control port is used to startup and shutdown Jira.
Use default ports (HTTP: 8080, Control: 8005) - Recommended [1, Enter], Set custom value for HTTP and Control ports [2]    #自定义配置
2  #回车
 
HTTP Port Number    #将服务端口更改一下即可
[8080]
18080
Control Port Number
[8005]
#默认
 
Jira can be run in the background.   #安装为系统服务
You may choose to run Jira as a service, which means it will start
automatically whenever the computer restarts.
Install Jira as Service?
Yes [y, Enter], No [n]
y  #回车
 
 
 
 
Details on where Jira Software will be installed and the settings that will be used.    #确认安装信息
Installation Directory: /opt/atlassian/jira 
Home Directory: /data/atlassian/application-data/jira 
HTTP Port: 18080 
RMI Port: 8005 
Install as service: Yes 
Install [i, Enter], Exit [e]
i  #回车
 
Please wait a few moments while Jira Software is configured.    #安装配置完成，是否启动
 
Installation of Jira Software 8.14.0 is complete
Start Jira Software 8.14.0 now?
Yes [y, Enter], No [n]
y  #回车

配置完成后，以下为正常的启动信息

Please wait a few moments while Jira Software starts up.
Launching Jira Software ...
 
Installation of Jira Software 8.14.0 is complete
Your installation of Jira Software 8.14.0 is now ready and can be accessed
via your browser.
Jira Software 8.14.0 can be accessed at http://localhost:18080
Finishing installation ...

启动完成后，先curl一下确认服务的可用性，然后做进一步的配置。

确认状态码和路径无误后，关闭服务开始进一步配置。

三、配置jira的反向代理及拷贝MySQL的连接器

暂停jira服务 ，也可采用/opt/atlassian/jira/bin/catalina.sh stop方式停止，选其一

/opt/atlassian/jira/bin/stop-jira.sh

编辑tomcat配置，在其中配置反代

vim /opt/atlassian/jira/conf/server.xml      #注：这里的IP和端口为临时测试机搭建

scheme：反代nginx的配置，根据情况指定http|https
proxyName：反代nginx的配置，有域名指定域名，没域名指定访问IP
proxyPort：反代nginx的配置，访问端口

在这里可以指定jira的访问目录，正常访问是IP:Port，加上之后多了层目录，也就是IP:Port/Path

配置文件修改完成，关于连接MySQL，需要用到java连接器，可以到MySQL官网下载

点击下载：https://downloads.mysql.com/archives/get/p/3/file/mysql-connector-java-5.1.47.zip

将其中mysql-connector-java-5.1.47.jar放到jira服务器

cp mysql-connector-java-5.1.47.jar /opt/atlassian/jira/lib/     #拷贝到jira安装目录的/lib/目录下
 
/opt/atlassian/jira/bin/start-jira.sh    #重新启动

四、配置nginx反代

因为此环境是内网进行的，所以需要配置一个反代来完成jira的访问及初始化。

yum install -y nginx

配置jira代理

vim /etc/nginx/conf.d/jira.conf
server {
   listen 18088;
   server_name jira.test.cn;
   location / {
       proxy_set_header X-Real-IP $remote_addr;
       proxy_set_header X-Forwarded-Host $host;
       proxy_set_header X-Forwarded-Server $host;
       proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       proxy_pass http://192.168.0.221:18080;
       proxy_read_timeout 3000;
       client_max_body_size 200M;
       proxy_set_header Host $http_host;
   }
}

启动nginx

systemctl start nginx

nginx反代配置完成，在浏览器界面访问测试

五、jira连接数据库，数据目录初始化

接下来在Web界面进行配置，选择自己安装

接下来就是配置数据库，选择使用自己配置的数据库，找到MySQL进行配置，信息填写完成后，点击Test Connection测试连接

确认没有问题后，点击下一步就开始数据的导入了，在这里要清楚的是，不只是往数据库中导入数据，在jira的家目录（/data/atlassian/application-data/jira/）中同样需要导入，这里查看一下目前家目录和jiradb库中的数据。

点击下一步，开始导入数据

导入完成后，在对应的库和目录中查看

接下来继续到Web界面操作，配置模式和URL

再下一步，输入产品的许可证秘钥后下一步即可，试用可以点击箭头指的链接申请试用许可证，我这里先去申请一下试用许可证

点击链接之后，往下拉，按以下操作，然后点击申请即可，然后会跳出到右侧的提示，选择YES

许可证就会自动填到对应的位置，继续下一步

配置jira管理员用户，继续下一步

配置电子邮件通知，根据情况选择，初始化完成后也可配置

语言
头像
创建一个测试项目
选择模板，工作流展示，下一步
名称下一步
到这里，关于jira的部署就完成了，以下为初始界面。