Install Tuleap on RHEL or CentOs 7.x¶

Attention

The install on RHEL or CentOS 7 is currently in beta and covers only a subset of Tuleap (see below).

You should not install it on production server

Requirements¶

To install Tuleap you will need a fully dedicated server. It can be virtualized or physical. It is not recommended to install Tuleap on a server that hosts other applications. Tuleap provides a full suite of software and is deeply integrated with its host system.

You must disable SELinux prior to the install.

The server will need an Internet connection as it will download external packages.

Installation¶

This configure the dependencies and download RPM packages

Install EPEL You will need EPEL for some dependencies.

yum install -y epel-release

If you use Red Hat, you will need to activate the Optional channel
Install the Software Collections repositories

On CentOS this is done by:

yum install centos-release-scl

On RedHat this is done by:

yum-config-manager --enable rhel-server-rhscl-7-rpms

Install Tuleap repositories Create a /etc/yum.repos.d/Tuleap.repo with this content:

[Tuleap]
name=Tuleap
baseurl=https://ci.tuleap.net/yum/tuleap/rhel/7/dev/$basearch
enabled=1
gpgcheck=1
gpgkey=https://ci.tuleap.net/yum/tuleap/gpg.key

Install Tuleap by running the following command:

yum install -y \
  rh-mysql57-mysql-server \
  tuleap-plugin-agiledashboard \
  tuleap-plugin-graphontrackers \
  tuleap-theme-burningparrot \
  tuleap-theme-flamingparrot \
  tuleap-plugin-git \
  tuleap-plugin-svn \
  tuleap-plugin-hudson\*

Attention

Despite almost all plugins are listed when you run a yum list tuleap-plugin-\* only a limited subset is currently usable. DO NOT INSTALL OR ACTIVATE OTHER PACKAGES or you are almost likely to shoot yourself in the foot now or later when they are made available.

Plugins that should work:

tuleap-plugin-tracker
tuleap-plugin-agiledashboard
tuleap-plugin-cardwall
tuleap-plugin-graphontrackers
tuleap-plugin-testmanagement
tuleap-plugin-git
tuleap-plugin-svn
tuleap-plugin-pullrequest
tuleap-plugin-hudson
tuleap-plugin-hudson-svn
tuleap-plugin-hudson-git

Configure the database

Ensure that /etc/opt/rh/rh-mysql57/my.cnf.d/rh-mysql57-mysql-server.cnf contains sql-mode=NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION in section [mysqld]

# Activate mysql on boot
systemctl enable rh-mysql57-mysqld

# Start it
systemctl start rh-mysql57-mysqld

# Set a password
scl enable rh-mysql57 "mysqladmin -u root password"

Setup¶

Please do not repeat this step twice. This script should only be executed once. If you have any errors in the previous steps, be sure to fix those before continuing.

As root, run:

/usr/share/tuleap/tools/setup.el7.sh \
  -y \
  -c \
  --server-name=FQDN \
  --mysql-server=localhost \
  --mysql-password=XXXXX

With:

FQND being the name of the server as you access it on your network (localhost for a local test, tuleap.example.com with a DNS entry 192.168.1.123 if you only have an IP address)
XXXXX being the password of root password of the db configured earlier.
Ensure the firewall is properly configured. Open needed ports:
- Web (TCP/80 & TCP/443)
- SSH (git, admin): TCP/22

First connection¶

Once these steps are completed, you can access the Tuleap server with the web interface. Go to your Tuleap domain name (e.g. https://tuleap.example.com)

Default site administrator credentials can be found in /root/.tuleap_passwd. Change it as soon as possible.

Report issues¶

Install on RHEL7/CentOs7 is in beta, please report issues you might find on request tracker.