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.

Log on to the server as root user always.

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. Run the installer.
    • cd /opt/collabnet/teamforge-installer/8.1.0.1
    • ./install.sh -r -I -d /opt/collabnet/teamforge
  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 8.1.
  2. Configure the installation repository package for the OS of your choice.
    1. Configure your TeamForge 8.1 installation repository. See TeamForge installation repository configuration for Red Hat/CentOS.
    2. Configure your TeamForge 8.1 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. Run the installer.
    • cd /opt/collabnet/teamforge-installer/8.1.0.1
    • ./install.sh -r -I -d /opt/collabnet/teamforge
  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