最近因为项目需要,得搞一个软件工程的管理平台,左看右看,还是选了Jira。
网上相关的搭建教程其实不少,但折腾了一个礼拜,愣是没把完整的Jira服务跑起来。中间踩了几个坑,总算摸索出一些门道,最后还真给搭成了。下面就把整个过程掰开了揉碎了,希望后面动手的朋友能少走点弯路。
准备工作:创建目录和下载安装包
先搭好架子:创建两个目录
登录服务器后,先干一件事:创建两个目录。一个用来放安装文件,一个用来存Jira的数据和配置。
mkdir /software
mkdir /jiradata
这两个目录分工明确,后面部署和运维时就知道清爽的好处了。
下载并解压安装包
目录建好后,进入 /software 目录,下载Jira 6.3.6的安装包。
cd /software
wget https://www.atlassian.com/software/jira/downloads/binary/atlassian-jira-6.3.6.tar.gz
下载完成后,直接解压。
tar -xvf atlassian-jira-6.3.6.tar.gz
这样,安装文件就展开了,后面所有的配置和启动都在这个目录里操作。
安装环境:JVM和MySQL
最关键的一步:JDK版本一定要选对
JVM装好后记得用 ja va -version 确认一下环境变量是否生效。如果没生效,重启一次服务器。
这里有个大坑:Jira 6.3.6官方说支持JDK 1.6到1.8,但实际踩坑经验告诉我们,如果用了1.6或1.7,服务运行两三个小时就会莫名其妙自动挂掉。后来查日志发现是JVM内存泄漏。把JDK升到1.8版本后,系统就稳定了。
配置与启动:动动端口和Home目录
进入 atlassian-jira-6.3.6-standalone/conf 目录,用vim打开 server.xml,把端口号改成自己想要的。如果默认端口没被占用,这一步也可以跳过。
接着,进入 atlassian-jira-6.3.6-standalone/atlassian-jira/WEB-INF/classes,修改 jira-application.properties 文件,把 jira.home 指向刚才创建的 /jiradata。
jira.home=/jiradata
一切就绪后,进入 /software/atlassian-jira-6.3.6-standalone/bin 目录,启动服务。
./start-jira.sh
启动后,浏览器里输入 服务器IP:端口号,就能看到Jira的配置向导了。按页面提示一步步走就行。
破解授权:填License、换补丁
配置到最后一步,Jira会要求输入授权码(License)。这时选择“没有账号”或“有账号但没有License”的选项。然后按下面步骤操作:
- 将
atlassian-extras-2.2.2.jar放到atlassian-jira-6.3.6-standalone/atlassian-jira/WEB-INF/classes/lib目录下。 - 将
atlassian-universal-plugin-manager-plugin-2.17.13.jar放到atlassian-jira-6.3.6-standalone/atlassian-jira/WEB-INF/classes/atlassian-bundled-plugins目录下。 - 再复制一份相同的jar文件到
/jiradata/plugins/installed-plugins下面。
替换好文件后重启服务。再次打开配置页面,输入一个自行构造的License。格式大致如下(注意将关键字段换成你自己的信息):
Description=JIRA: Commercial,
CreationDate=你的安装日期(yyyy-mm-dd),
jira.LicenseEdition=ENTERPRISE,
Evaluation=false,
jira.LicenseTypeName=COMMERCIAL,
jira.active=true,
licenseVersion=2,
MaintenanceExpiryDate=你想设置的失效日期(如2099-12-31),
Organisation=你的组织名称,
SEN=你申请到的SEN(注意没有前缀LID),
ServerID=你申请到的ServerID,
jira.NumberOfUsers=-1,
LicenseID=LID+你申请到的SEN(注意LID前缀不要丢掉),
LicenseExpiryDate=你想设置的失效日期(如2099-12-31),
PurchaseDate=你的安装日期(yyyy-mm-dd)
举例来说,一个完整的License示例如下(仅作参考):
Description=JIRA: Commercial,
CreationDate=2014-09-20,
jira.LicenseEdition=ENTERPRISE,
Evaluation=false,
jira.LicenseTypeName=COMMERCIAL,
jira.active=true,
licenseVersion=2,
MaintenanceExpiryDate=2099-12-31,
Organisation=pl,
SEN=SEN-L4572897,
ServerID=BPT3-4QRK-FCRR-HDP3,
jira.NumberOfUsers=-1,
LicenseID=AAABBw0ODAoPeNptkFtLxDAQhd/zKwI+R9Kwy66FPKxthGhvtF0p4kuso0a6sUwvuP/edissyj4MD
HPOfHOYqzu0tICWeoJy4a+FzzkNwpIK7q1ICF2Ntu3tl5P3Ot89+1SNphnMPCEBwqkJTQ9y9jN+w
zxBPi2a68jW4DpQr/a0rZJS5VmuC0XOBNnjAH/s5bGFxBxABmkcqzzQu2jRTd3bEZaFZvE+AnYzJ
DYWNeDM64G9d1aPJ4TeXxOlOK7cbZbjrbNgkyGwwtg+rbvJpBkHikAR0Adytt0XzFV7R5Y+qQzV
kWZIoVK5FQsWq03YrvdkN/Ekz3S4SXlcpRswPrDdPD/aT+P1nzDMC0CFQCM9+0LlHVNnZQnSTwuR
O3eK+2gVgIUCteTs4Q3khIgrnsY64hxYB/d8bM=X02dh,
LicenseExpiryDate=2099-12-31,
PurchaseDate=2014-09-20
插件也别忘了破解
在Jira的插件管理页面里,找到要破解的插件(比如Jira Agile),查看其SEN,然后更新License字段。格式如下:
Description=JIRA Agile (formerly GreenHopper) for JIRA: Commercial,
NumberOfUsers=-1,
CreationDate=2014-08-01,
Evaluation=false,
plugins.*.LicenseEdition=ENTERPRISE,
licenseVersion=2,
MaintenanceExpiryDate=2099-01-01,
Organisation=GoodCompany,
plugins.*.active=true,
SEN=SEN-L9374300,
ServerID=BMSW-8XXY-A06O-V5DH,
LicenseExpiryDate=2099-01-01,
LicenseTypeName=COMMERCIAL,
PurchaseDate=2014-08-01
按这个模板,只需要把 SEN 和 ServerID 替换成你自己的。保存后刷新,插件就永久可用了。
到此,你的Jira服务已经成功搭建,可以开始用了。
