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.
    • /opt/collabnet/teamforge/bin/teamforge 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. 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.

  5. Start TeamForge.
    • /opt/collabnet/teamforge/bin/teamforge start

Do this on the TeamForge Indexer Server.

  1. Set up the server with an operating system supported by TeamForge 16.10.
  2. Configure the installation repository package.
    1. Configure your TeamForge 16.10 installation repository. See TeamForge installation repository configuration for Red Hat/CentOS.
  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. 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.

  8. Start the TeamForge Indexer.
    • /opt/collabnet/teamforge/bin/teamforge 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.
      • /opt/collabnet/teamforge/bin/teamforge status
Parent topic: TeamForge System Administration