Atlassian Software Installation (Crowd + JIRA + Confluence + Bitbucket + Bamboo)

Companies use software development and collaboration tools for Atlassian software series, recent Tencent need to migrate from cloud to cloud Ali, simply record the installation and configuration process. (Atlassian very detailed document, the process ran into problems a solution can be found.)

Brief introduction

name	Brief introduction
Crowd	Easy to use, manage and integrated single sign-on and identity management tools. In addition to supporting Atlassian family of software, also supports SonarQube, Jenkins, Nexus, etc.
JIRA	Agile teams use the tool of choice for software development, planning, tracking and publish world-class software.
Confluence	East looking west can reduce the time spent, the more of their time to complete the work. You can work in the same finishing position, create a document and discuss everything.
Bitbucket	Through the embedded comments and requests pulling collaborate to write code. The entire management team and shared Git repository to build and deliver software.
Bamboo	Continuous integration, deployment and release management.

Precautions

Written on the front, avoiding the installation process pit pit pit.

Tips: run into any problems during installation, Atlassian directly on the official website or google search, generally have detailed documentation support

Operating system character set : when to migrate backup data, unknown error may occur, such as: When you import a backup Crowd, date conversion error.

Mysql drive : support Mysql database, but not integrated Mysql jdbc driver, please prepare in advance.

Mysql character sets : database table character set: utf8, sorting character sets: utf8_bin.

Ali cloud RDS console, UTF8 database created, the default character set for sorting: utf8_general_ci, need to be modified to: utf8_bin.

Git version : When installing Bitbucket, Git version 2.2.0+ is required.

Installation Environment

software	version	Explanation
Centos	V7.7	Ali cloud ECS
Oracle JDK	V1.8.0_171
Git	V2.8.3	Bitbucket rely Git 2.2.0+
Mysql	V5.7	Ali cloud RDS

Crowd

Crowd installation

# 创建独立安装账号
$ useradd crowd
$ passwd crowd
$ su - crowd

# 下载
$ wget https://product-downloads.atlassian.com/software/crowd/downloads/atlassian-crowd-3.2.3.tar.gz

# 解压
$ tar -zxvf atlassian-crowd-3.2.3.tar.gz

# 设置 crowd.home
$ vi /home/crowd/atlassian-crowd-3.2.3/crowd-webapp/WEB-INF/classes/crowd-init.properties
###############
##           ##
##  UNIX     ##
##           ##
###############
## On Unix-based operating systems, uncomment the following
## line and set crowd.home to a directory Crowd should use to
## store its configuration.

crowd.home=/home/crowd/atlassian-crowd-3.2.3

# Crowd 支持 Mysql 数据库，但是未集成 Mysql jdbc 驱动
$ cp mysql-connector-java-5.1.46.jar /home/crowd/atlassian-crowd-3.2.3/apache-tomcat/lib

# 启动 crowd
$ sh /home/crowd/atlassian-crowd-3.2.3/start_crowd.sh

Crowd Set

1. Browser to access http: // yourip: 8095 to enter the initial page, enter License
   

2. Select Import backup
   

3. Set Database Information
   

4. parameter settings
   

5. Setting administrator account
   

6. Setup is complete
   

Crowd migration

1. Before the backup data Crowd
   

2. You can import the backup data
   

Operating system character set inconsistencies

# 修改操作系统字符集一致
$ echo 'LANG=zh_CN.UTF-8' > /etc/locale.conf
$ source /etc/locale.conf

JIRA

JIRA AnSo

# 创建独立安装账号
$ useradd jira
$ passwd jira
$ su - jira

# 下载
$ wget https://product-downloads.atlassian.com/software/jira/downloads/atlassian-jira-software-7.10.0-x64.bin

# 安装，一路回车即可
$ ./atlassian-jira-software-7.10.0-x64.bin
Unpacking JRE ...
Starting Installer ...
三月 26, 2020 7:00:44 下午 java.util.prefs.FileSystemPreferences$1 run
信息: Created user preferences directory.
三月 26, 2020 7:00:44 下午 java.util.prefs.FileSystemPreferences$2 run
信息: Created system preferences directory in java.home.
You do not have administrator rights to this machine and as such, some installation options will not be available. Are you sure you want to continue?
Yes [y, Enter], No [n]
y

This will install JIRA Software 7.10.0 on your computer.
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

Where should JIRA Software be installed?
[/home/jira/atlassian/jira]

Default location for JIRA Software data
[/home/jira/atlassian/application-data/jira]

Configure which ports JIRA Software will use.
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]

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

Extracting files ...

Please wait a few moments while JIRA Software is configured.
Installation of JIRA Software 7.10.0 is complete
Start JIRA Software 7.10.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 7.10.0 is complete
Your installation of JIRA Software 7.10.0 is now ready and can be accessed
via your browser.
JIRA Software 7.10.0 can be accessed at http://localhost:8080
Finishing installation ...

# 与 Crowd 类似，需要把 Mysql 驱动包 放到 atlassian/jira/lib 目录下，需要重启生效。
$ cp mysql-connector-java-5.1.46.jar /home/jira/atlassian/jira/lib

# 重启
$ sh /home/jira/atlassian/jira/bin/stop-jira.sh
$ sh /home/jira/atlassian/jira/bin/start-jira.sh

JIRA settings

The setup procedure is similar to the Crowd.

1. Browser to access http: // yourip: 8080 to enter the initial page;
2. Select the custom settings, select the database Mysql (utf8 character set, utf8_bin collation), the relevant input parameters, test connection, click Next;
3. Enter the license, set the administrator account, click Next;
4. Skip mail notification, set the language, avatars, you can officially use the JIRA

Confluence

Confluence installation

# 创建独立安装账号
$ useradd confluence
$ passwd confluence
$ su - confluence

# 下载
$ wget https://product-downloads.atlassian.com/software/confluence/downloads/atlassian-confluence-6.9.1-x64.bin

# 安装过程与 JIRA 类似
$ ./atlassian-confluence-6.9.1-x64.bin

# 与 JIRA 类似，需要把 Mysql 驱动包 放到 /home/confluence/atlassian/confluence/confluence/WEB-INF/lib 目录下，需要重启生效。
$ cp mysql-connector-java-5.1.46.jar /home/confluence/atlassian/confluence/confluence/WEB-INF/lib

# 重启
$ sh /home/confluence/atlassian/confluence/bin/stop-confluence.sh
$ sh /home/confluence/atlassian/confluence/bin/stop-confluence.sh

Confluence Set

The setup procedure is similar to JIRA.

1. Browser to access http: // yourip: 8090 to enter the initial page;
2. Select the production installation, select additional plug according to the situation, click Next;
3. Enter the license, select the database Mysql (utf8 character set, utf8_bin collation), enter the relevant parameters, test connection, click Next;
4. Select the initial content, where you can select "Example Site", will initially create a new sample project;
5. Select the user policy, because we will follow an integrated Crowd, so here choose "Manage users and groups within Confluence";
6. Set the administrator account on the official use Confluence.

Bitbucket

Bitbucket installation

# 创建独立安装账号
$ useradd bitbucket
$ passwd bitbucket
$ su - bitbucket

# 下载
$ wget https://product-downloads.atlassian.com/software/stash/downloads/atlassian-bitbucket-5.11.1-linux-x64.bin

# 安装前提条件：Git 版本需要 2.2.0+
# 安装过程与 JIRA 和 Confluence 类似
$ ./atlassian-bitbucket-5.11.1-linux-x64.bin

# 与 JIRA 类似，需要把 Mysql 驱动包 放到 /home/bitbucket/atlassian/bitbucket/5.11.1/app/WEB-INF/lib 目录下，需要重启生效。
$ cp mysql-connector-java-5.1.46.jar /home/bitbucket/atlassian/bitbucket/5.11.1/app/WEB-INF/lib

# 重启
$ sh /home/bitbucket/atlassian/bitbucket/5.11.1/bin/stop-bitbucket.sh
$ sh /home/bitbucket/atlassian/bitbucket/5.11.1/bin/start-bitbucket.sh

Bitbucket settings

The setup procedure is similar to the JIRA and Confluence.

1. Browser to access http: // yourip: 7990 to enter the initial page;
2. Select Database Mysql (utf8 character set, utf8_bin collation), the relevant input parameters, test connection, click Next;
3. Enter the license, set the administrator account on the official use of Bitbucket.

Bamboo

Bamboo installation

# 创建独立安装账号
$ useradd bamboo
$ passwd bamboo
$ su - bamboo

# 下载
$ wget https://product-downloads.atlassian.com/software/bamboo/downloads/atlassian-bamboo-6.6.0.tar.gz

# 解压
$ tar -zxvf atlassian-bamboo-6.6.0.tar.gz

# 设置 bamboo.home
$ vi /home/bamboo/atlassian-bamboo-6.6.0/atlassian-bamboo/WEB-INF/classes/bamboo-init.properties
bamboo.home=/home/bamboo/atlassian-bamboo-6.6.0

# Crowd 支持 Mysql 数据库，但是未集成 Mysql jdbc 驱动
$ cp mysql-connector-java-5.1.46.jar /home/crowd/atlassian-crowd-3.2.3/apache-tomcat/lib

# 启动 crowd
$ sh atlassian-crowd-3.2.3/start_crowd.sh

Bamboo Set

The setup procedure is similar to Bitbucket so.

1. Browser to access http: // yourip: 8085 to enter the initial page;
2. License input, select the database Mysql (connection parameters need to add: autoReconnect = true), the input parameters, the test connection, click Next;
3. Set the administrator account on the official use of Bamboo.

Crowd integration with JIRA, Confluence, Bitbucket, Bamboo

Crowd integration with JIRA

1. Using the administrator user login Crowd, New Group.
   Click on "Groups" -> "Add group ", enter a group name, description, attribution directory, click Create.
   

Add user

2. New Application
   Click on "Applications" -> "Add application ", enter a name, description, password, click Create.
   

3. JIRA enter their address and ip address, click Next.
   

4. Select Allow group access JIRA, and to join in
   

5. Confirmation message, click on the "Add application", added the application is complete.
   

6. Use JIRA administrator, log in JIRA.
   Click User Management -> User Directory -> Add directory and select "Atlassian crowd" and click Next.
   

7. Crowd input configuration server, click the Test and save.
   

Name: Crowd Server
the URL of the server: URL address Crowd, such as: http://www.example.com:8095/crowd/
Application Name: Application Name and configured in the Crowd in the same
application passwords: and in the Crowd Application password consistent configuration

8. The default user per hour (system administrator can modify), click on the Sync button can also be manually synchronized once the synchronization from the Crowd.

9. Administrator user logs off the user, using Crowd in the attempt landing JIRA, found to be able to log into it.

Crowd and Confluence, Bitbucket, Bamboo integration

Reference Crowd integration with JIRA.

context-path configuration

Atlassian each application installed by default is this:

• Crowd：http://ip:8095/crowd
• Waiting: http: // ip: 8080
• Confluence：http://ip:8090
• Bitbucket：http://ip:7990
• Bamboo：http://ip:8085

For quick access, we need to set access to Atlassian each application address is standardized, as follows:

• Crowd：http://www.xxx.com/crowd
• JIRA：http://www.xxx.com/jira
• Confluence：http://www.xxx.com/confluence
• Bitbucket：http://www.xxx.com/bitbucket
• Bamboo：http://www.xxx.com/bamboo

Program

1. Setting of each application's context-path is "/" + "application name"
2. Use nginx proxy, pointing to the www.xxx.com/xxx HTTP: // ip : Port / xxx

# jira 的 nginx 设置，其他类似
location ^~ /jira {

        proxy_pass http://x.x.x.x:8080/jira;

        sendfile off;

        proxy_set_header   Host             $host:$server_port;
        proxy_set_header   X-Real-IP        $remote_addr;
        proxy_set_header   X-Forwarded-For  $proxy_add_x_forwarded_for;
        proxy_max_temp_file_size 0;

        # This is the maximum upload size
        client_max_body_size       10m;
        client_body_buffer_size    128k;

        proxy_connect_timeout      90;
        proxy_send_timeout         90;
        proxy_read_timeout         90;

        proxy_temp_file_write_size 64k;

        # Required for new HTTP-based CLI
        proxy_http_version 1.1;
        proxy_request_buffering off;
        proxy_buffering off; # Required for HTTP-based CLI to work over SSL
    }

Modify context-path

Crowd

Supported by default, without modification.

JIRA

# server.xml，在 Context 标签中添加 path="/jira"
$ vi /home/jira/atlassian/jira/conf/server.xml
<Context path="/jira" docBase="${catalina.home}/atlassian-jira" reloadable="false" useHttpOnly="true">

# 重启生效

Confluence

# server.xml，在 Context 标签中添加 path="/confluence"
$ vi /home/confluence/atlassian/confluence/conf/server.xml
<Context path="/confluence" docBase="../confluence" debug="0" reloadable="false" useHttpOnly="true">

# 重启生效

Bitbucket

# bitbucket.properties
$ echo "server.context-path=/bitbucket" >> /home/bitbucket/atlassian/application-data/bitbucket/shared/bitbucket.properties

# 重启生效

Bamboo

# server.xml，在 Context 标签中添加 path="/bamboo"
$ vi /home/bamboo/atlassian-bamboo-6.6.0/conf/server.xml
<Context path="/bamboo" docBase="${catalina.home}/atlassian-bamboo" reloadable="false" useHttpOnly="true">

# 重启生效

Single sign-on (SSO) Configuration

Single sign-on (SSO) support the need for domain names, that is, before configuring sso, each application system has been configured the appropriate domain name.

Confluence configure SSO

# 编辑 seraph-config.xml
$ vi /home/confluence/atlassian/confluence/confluence/WEB-INF/classes/seraph-config.xml
# 注释掉
<!--<authenticator class="com.atlassian.confluence.user.ConfluenceGroupJoiningAuthenticator"/>-->

# 打开注释
<authenticator class="com.atlassian.confluence.user.ConfluenceCrowdSSOAuthenticator"/>

# 修改 crowd.properties
$ vi /home/confluence/atlassian/confluence/confluence/WEB-INF/classes/crowd.xml
application.name：配置 crowd 里该 Application 的名称
application.password：配置 crowd 里该 Application 的密码
application.login.url：配置 crowd 的地址

crowd.server.url：配置 crowd 的 services 地址
crowd.base.url：配置 crowd 的 baseurl 地址

session.tokenkey：与 crowd 管理页面的SSO cookie name保持一致

# 重启 Confluence 生效

verification

Be logged crowd, and then open a page, enter confluence address, we found no need to manually enter the account password, go directly to board

Note : You must use the address of the domain name, the user must be logged on user synchronization before.

JIRA placed SSO

Reference Confluence configuration sso, basically the same, but the installation directory JIRA's no crowd.properties files from Confluence or Crowd copy, then you can modify the contents of the configuration.

Bitbucket configure SSO

# 编辑 bitbucket.properties
$ vi /home/bitbucket/atlassian/application-data/bitbucket/shared/bitbucket.properties
# 添加下面的属性
plugin.auth-crowd.sso.enabled=true

# 重启 Bitbucket 生效

Bamboo configure SSO

# 编辑 seraph-config.xml
$ vi /home/bamboo/atlassian-bamboo-6.6.0/atlassian-bamboo/WEB-INF/classes/seraph-config.xml
# 注释掉
<!--<authenticator class="com.atlassian.bamboo.user.authentication.BambooAuthenticator"/>-->

# 打开注释
<authenticator class="com.atlassian.crowd.integration.seraph.v25.BambooAuthenticator"/>

# 修改 crowd.properties
$ vi /home/bamboo/atlassian-bamboo-6.6.0/xml-data/configuration/crowd.properties
application.name：配置 crowd 里该 Application 的名称
application.password：配置 crowd 里该 Application 的密码
application.login.url：配置 crowd 的地址

crowd.server.url：配置 crowd 的 services 地址
crowd.base.url：配置 crowd 的 baseurl 地址

session.tokenkey：与 crowd 管理页面的SSO cookie name保持一致

# 重启 Bamboo 生效