In this setup, we install the Git integration services on a separate server.
In this setup,
Git Integration Server
runs on the Git server (we call this server-03).
Note: For the ETL service to run as expected in a distributed TeamForge installation, all servers must have
the same time zone.
Attention: Installing or upgrading
TeamForge
needs root privileges. You must log on as root or use a root shell to install or upgrade
TeamForge.
Do this on the Git
server
(server-03)
-
Install Red Hat Enterprise Linux/CentOS 7.2 and log in as
root.
-
Check your basic networking setup.
See Set up networking for your TeamForge server for details.
-
If the Git server has SELinux enabled, disable it temporarily while installing
or upgrading Git.
-
Verify if SELinux is running in enforcing mode.
-
If the output of the getenforce command is
either "Disabled" or "Permissive", SELinux is already disabled.
-
If not disabled, run the following command to disable SELinux.
-
Configure your TeamForge installation repository.
- TeamForge installation repository configuration for sites with internet
access
-
Contact the CollabNet Support and download the TeamForge
16.10 installation repository package to /tmp.
-
Install the repository package.
- yum install -y
/tmp/collabnet-teamforge-repo-16.10-1.noarch.rpm
-
Refresh your repository cache.
- TeamForge installation repository configuration for sites without
internet access
-
Contact the CollabNet Support to get the auxiliary installer package for
TeamForge
16.10 disconnected installation and save it in
/tmp.
- Red Hat Enterprise Linux/CentOS
7.2 64 bit RPM package: CTF-Disconnected-media-16.10.658-76.rhel7.x86_64.rpm
Note: In
addition to the above CentOS
7.2 64 bit RPM package, you must get the following CentOS
7.2 compatibility RPM, which is required for TeamForge
16.10 disconnected media installation on CentOS
7.2 profile:
compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm.
-
Unpack the disconnected installation package.
-
Unpack the
compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm
package if you are installing TeamForge
16.10 on CentOS
7.2.
- rpm -ivh
compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm
-
Note: If the Red Hat Enterprise Linux/CentOS installation DVD is mounted already, skip the following instructions.
If not, mount the DVD.
Mount the Red Hat Enterprise Linux/CentOS installation DVD. The DVD contains the necessary software and
utilities required for installing TeamForge without internet access.
In the following commands, replace "cdrom" with the identifier for
your server's CD/DVD drive, if necessary.
- cd /media/
- mkdir cdrom
- mount /dev/cdrom ./cdrom/
If there are any spaces in the automount, unmount it first and mount
it as a filepath, with no spaces.
-
Create a yum configuration file that points to the Red Hat Enterprise Linux/CentOS installation DVD.
- vi /etc/yum.repos.d/cdrom.repo
Here's a sample yum configuration
file.[RHEL-CDROM]
name=RHEL CDRom
baseurl=file:///media/cdrom/Server/
gpgfile=file:///media/cdrom/RPM-GPG-KEY-redhat-release
enabled=1
gpgcheck=0
-
Verify your yum configuration files.
- yum list httpd
- yum list apr
-
Install the Git packages.
- yum install teamforge-git
-
Configure the token settings for Git in the
site-options.conf file.
- vi /opt/collabnet/teamforge/etc/site-options.conf
-
Modify the host token settings.
HOST_server-03=gerrit
DOMAIN_server-03=my.git.domain.com
HOST_my.app.domain.com=app database datamart etl indexer subversion cvs binary reviewboard
-
To enable the history protection feature of TeamForge Git integration, set the
GERRIT_FORCE_HISTORY_PROTECTION=true. For more information,
see GERRIT_FORCE_HISTORY_PROTECTION.
-
Turn on the SSL for your site by editing the relevant variables in the
site-options.conf file. To generate the SSL
certificates, see Generate SSL certificates.
SSL=on
SSL_CERT_FILE
SSL_KEY_FILE
SSL_CHAIN_FILE
Note: The SSL_CERT_FILE and SSL_KEY_FILE tokens need an absolute path.
The SSL_CHAIN_FILE token is
optional.
-
Make sure the PostgreSQL tokens in the
site-options.conf file are set as recommended
in the following topic: What are the right PostgreSQL settings for my site?
-
Enable the POSTGRES_INTERFACE token in the
site-options.conf file if the value of
"ifconfig -a" is not eth0/enp0*.
-
Save the site-options.conf file.
-
Deploy
services.
- /opt/collabnet/teamforge/bin/teamforge
provision
The "provision" command prompts for response before it bootstraps or migrates
data during TeamForge installation and upgrade respectively. Enter "Yes" or
"No" to proceed. For more information, see The teamforge script.
-
Run the TeamForge post installation script. For more information, see post-install.py.
- /opt/collabnet/teamforge/runtime/scripts/post-install.py