Show TOC

Installing a TREX Instance on Another HostLocate this document in the navigation structure

Use

You want to install a TREX instance on another host using the addinstance.cmd TREX script (Windows) or the instance.sh TREX script (UNIX). The relevant script is located on the host on which you originally installed TREX using SAPInst.

The script is located in the following directory:

  • UNIX /<SAP System Mount Directory>/<sapsid>/SYS/global/ trex/install

  • Windows <SAPGLOBALHOST>\sapmnt\<SAPSID>\SYS\global\trex\install

    Caution

    This directory is part of the TREX global file system ( \...\<SAPSID>\SYS\global), which must be highly available. All instances of a TREX system must have permanent access to it. If you are installing TREX and want to have a distributed TREX system, you have to decide which host to use for the global file system. The global file system must always be accessible by all hosts on which you want to install additional TREX instances.

Prerequisites

You have mounted (UNIX) or shared (Windows) the <SAPSID>\SYS\global\trex\install directory on the host on which you want to install the additional TREX instance so that the directory can be accessed at all times.

Procedure
  1. Log on as root (UNIX) or as a local administrator (Windows) to the host on which you want to install the additional TREX instance. Then open an entry prompt.

  2. Navigate to the \...\ <SAPSID>\SYS\global\trex\install directory located on the host on which you originally installed TREX. On UNIX, you have to mount this directory manually first.

  3. Execute the addInstance.cmd script (Windows) or the instance.sh script (UNIX) in this directory.

This script automatically carries out the following actiosn:

  • Creates a directory structure for SAPSID and the TREX instance

  • Creates a <SAPSID>adm user

  • Configures the SAP system

  • Deploys the binaries

  • Creates the host configuration

  • Registers the host with the TREX landscape

  • Registers the sapstartsrv service and starts TREX

Result

Following the execution of the script, an additional TREX instance is installed on the host in question. No further configuration steps are required.