Secondary Index Server (Indexing Version 1)

Secondary index server automatically creates a copy of an index onto another MediaAgent, called a secondary MediaAgent, which is usually physically separate from the MediaAgent on which the primary index was created. Having a copy of an index ensures that it remains available if the primary index gets erased during a cleanup operation. Each secondary index server can support multiple MediaAgents.

This feature is useful for setups that would otherwise rely on tape recalls when a primary index is no longer available (for example, it was aged off or otherwise deleted from the primary MediaAgent).


Implementing secondary index server requires a MediaAgent, which in most cases will be a separate MediaAgent, to hold a copy of the primary index. The secondary MediaAgent should have sufficient storage space in its index cache directory to store indexes for all of the MediaAgents for which it serves as a secondary index server. If the secondary MediaAgent is also serving as a primary MediaAgent for clients of its own, it should have additional sufficient storage space to act as a MediaAgent.


The following are secondary index server examples:

  • MediaAgents MA1 and MA2 perform backups for clients. Each MediaAgent index directory has 500 GB of storage space.
  • MediaAgent MA3 performs backups for clients, and requires 500 GB for its own indexes.
  • If MA3 is deployed as the secondary index server for MA1 and MA2, then MA3 should have 1.5 TB total space allocated to its index directory.

Operational Information

The following is operational information related to secondary index server:

  • During a backup job, an index is created on the primary index server MediaAgent. This MediaAgent copies the completed index to the secondary index server MediaAgent every 30 minutes in the background.
  • An index restore operation automatically copies the restored index to the secondary MediaAgent.
  • During browse, find, or restore operations, if the required index is not present on the primary MediaAgent, the copy of the index is automatically downloaded from the secondary index server.
  • Indexes present on the primary MediaAgent at the time that the secondary index server feature is enabled are not uploaded to the secondary index server. Jobs that are run after the secondary index server feature is enabled will upload their indexes to the secondary index server.
  • If the client name of the secondary index server MediaAgent is changed (via the Client Properties dialog box for the secondary MediaAgent), the sSECONDARYINDEXSERVERNAME additional setting on each primary MediaAgent that uses that secondary MediaAgent must be updated with the new name, and the MediaAgent Services on those primary MediaAgents must be restarted.

Retention and Cleanup

Index copies are saved in the CatalogServer folder, which is in the index cache directory. To ensure availability, the secondary copy of an index is subject to the following retention rules:

  • Secondary indexes are not subject to event-based cleanup operations, but scheduled cleanups are performed on them. Aging for each index is determined by the retention rules set on the secondary MediaAgent. See Index Directory Cleanup.
  • Setting a longer retention time on the secondary MediaAgent ensures that secondary indexes are retained longer than primary indexes.

Last modified: 5/17/2019 7:31:28 PM