Install Indexer on a separate server

In this task, we install the TeamForge Indexer on a separate server.

Pre-requisite: Ensure that there is no firewall restriction between the TeamForge application server and the new Indexer server.
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 TeamForge application server.

  1. Stop TeamForge.
    • /etc/init.d/collabnet stop
  2. Move the Indexer directory [/opt/collabnet/teamforge/var/searchIndex] to the new Indexer server.
    Note: You can either use tar or NFS to back up and restore the searchIndex directory. Copy or transfer the searchIndex backup to the Indexer server. See the example below.
    • cd /opt/collabnet/teamforge/var
    • tar -zcvf /tmp/searchIndex.tgz searchIndex
    • scp /tmp/searchIndex.tgz user@indexer.box:/tmp/
  3. Edit the site-options.conf file. 
    HOST_my.host.name=app etl database datamart subversion cvs gerrit
    HOST_<domain/hostname of indexer box>=indexer
  4. Create the runtime environment.
    • /opt/collabnet/teamforge/installer/install.sh
  5. Start TeamForge.
    • /etc/init.d/collabnet start all

Do this on the TeamForge Indexer server.

  1. Set up the server with an operating system supported by TeamForge 16.7.
  2. Configure the installation repository package for the OS of your choice.
    1. Configure your TeamForge 16.7 installation repository. See TeamForge installation repository configuration for Red Hat/CentOS.
    2. Configure your TeamForge 16.7 installation repository. See TeamForge installation repository configuration for SUSE.
  3. Run the following command to install the TeamForge Indexer packages.
    • yum install teamforge-indexer
  4. Copy the master site-options.conf file from the application server and modify these tokens: 
    HOST_my.host.name=indexer
    DOMAIN_my.host.name=<myindexerbox.domain.com>
    HOST_<myappboxdomain.com>=app etl database datamart subversion cvs gerrit
    Important:
    • It is recommended to use a separate netapp volume for the Indexer server.
    • The Indexer server should have the required permissions to access the NFS volume of the application server.
  5. Create the Indexer and filestorage directories.
    • mkdir /opt/collabnet/teamforge/var/searchIndex -p
    • mkdir /opt/collabnet/teamforge/var/filestorage -p
  6. Restore the Indexer data. Run the following command to restore the backup index data from the application server.
    • cd /opt/collabnet/teamforge/var/
    • tar -zxvf /tmp/searchIndex.tgz
  7. Create the runtime environment.
    • /opt/collabnet/teamforge/installer/install.sh
  8. Start the TeamForge Indexer.
    • /etc/init.d/collabnet start
    1. Run the following command and ensure that app filestorage directory is exported to indexer server.
      • mount -l
    2. Run the following command and ensure that the Indexer services are up and running.
      • /etc/init.d/collabnet status
Parent topic: TeamForge System Administration