Single host upgrades

This article provides steps for upgrading single host TeamForge EventQ installations to the latest release.

The following steps pertain to TeamForge EventQ upgrades when all services are located on a single machine. Upon successful completion, TeamForge EventQ will be upgraded to the latest available release.

Important: The upgrade process stops the TeamForge EventQ App server while upgrading. Anticipate up to 20 minutes of end-user downtime from the time services are shut down.

Upgrade EventQ: Do this on the EventQ Server (my.eventq.host)

Configure your TeamForge installation repository.
2. Install the repository package.
  - yum install -y /tmp/collabnet-teamforge-repo-16.7-1.noarch.rpm
3. Refresh your repository cache.
  - yum clean all
1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 16.7 disconnected installation and save it in /tmp.
  - Red Hat Enterprise Linux/CentOS 7.2 64 bit RPM package:
    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.7 disconnected media installation on CentOS 7.2 profile: .
2. Unpack the disconnected installation package.
  - rpm -Uvh <package-name>
3. Unpack the package if you are installing TeamForge 16.7 on CentOS 7.2.
  - rpm -ivh compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm
4. 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.
5. 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
```
6. Verify your yum configuration files.
  - yum list httpd
  - yum list apr
Once the yum repository is configured, update the EventQ RPM.
- yum update CN-eventq

Back up the TeamForge EventQ system

Before upgrading, backup TeamForge EventQ system and data, see Back up and restore EventQ data

Upgrade process

Log into the TeamForge EventQ application server (App server) with a privileged account.
Perform the upgrade by running upgrade-eventq-16.7.sh, passing the all flag.
/opt/collabnet/eventq/bin/upgrade-eventq-16.7.sh all

Note: The TeamForge EventQ web interface will be unavailable to end-users until after the upgrade process.

Services will be restarted automatically upon completion.
Verify that all services are running after upgrade-eventq-16.7.sh terminates
The upgrade script should display a list of all services with [OK] denoting a successful restart.