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)

  1. Configure your TeamForge installation repository.
    • TeamForge installation repository configuration for sites with internet access
    1. Contact the CollabNet Support and download the TeamForge 17.1 installation repository package to /tmp.
    2. Install the repository package.
      • yum install -y /tmp/collabnet-teamforge-repo-17.1-1.noarch.rpm
    3. Refresh your repository cache.
      • yum clean all
    • TeamForge installation repository configuration for sites without internet access
    1. Contact the CollabNet Support to get the auxiliary installer package for TeamForge 17.1 disconnected installation and save it in /tmp.
      • Red Hat Enterprise Linux/CentOS 7.3 64 bit RPM package: CTF-Disconnected-media-17.1.524-23.rhel7.x86_64.rpm
        Note: In addition to the above CentOS 7.3 64 bit RPM package, you must get the following CentOS 7.3 compatibility RPM, which is required for TeamForge 17.1 disconnected media installation on CentOS 7.3 profile: compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm.
    2. Unpack the disconnected installation package.
      • rpm -Uvh <package-name>
    3. Unpack the compat-ctf-dc-media-1.0-1.el7.centos.noarch.rpm package if you are installing TeamForge 17.1 on CentOS 7.3.
      • 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
  2. Once the yum repository is configured, update the EventQ RPM.
    • yum update CN-eventq

Back up the TeamForge EventQ system

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

Upgrade process

  1. Log into the TeamForge EventQ application server (App server) with a privileged account.
  2. Perform the upgrade by running upgrade-eventq-17.1.sh, passing the all flag.

    /opt/collabnet/eventq/bin/upgrade-eventq-17.1.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.

  3. Verify that all services are running after upgrade-eventq-17.1.sh terminates

    The upgrade script should display a list of all services with [OK] denoting a successful restart.