Show TOC

Adding a Master HostLocate this document in the navigation structure


You can add a new master host to a distributed system. You need to do this if the capacity of the existing master hosts is insufficient.

This has the following effect on the distribution of the indexes:

  • The assignment of existing indexes remains unchanged.

  • The new master index server receives all new indexes until all master index servers have the same number of indexes. TREX then distributes the new indexes among all master index servers according to a round robin procedure.

The same principle is used for queues.


If you previously had one master host and add another, the indexes are distributed as follows:


If you are using backup hosts, the new master host needs to receive a backup host.

  • If there is one backup host for all master hosts, this backup host is automatically made backup host for the new master host.

  • If each master host has its own backup host, you have to add a new backup host for the new master host.


  1. Install TREX on the host that you want to add.
  2. For centralized data storage: Only UNIX: Mounting the Central TREX Data Directory or
  3. Start TREX on the new host.
  4. Start the TREX admin tool on a host that is already configured in the distributed system.
  5. Go to the Landscape Configuration window.
  6. Use Add Host to add the new host.
  7. Configure the new host in the Hosts table as follows:
    1. Mark it as a master index/master queue server.

    2. If you are using centralized data storage: In the column Base Path enter the central TREX data directory on the file server.

  8. If you are using backup hosts and every master has its own backup host: Adding a New Backup Host..
  9. Check the configuration. If the check does not find any errors, activate the configuration using Deploy.