Changing the TREX Host Name for the Slave Name Server

You want to change the host name of a slave name server. Proceed as follows:

• Change the TREX configuration files.

  The process flow for the configuration of these files depends on the type of data storage that you have chosen for your distributed landscape:

  • Process flow for decentralized storage

  • Process flow for centralized storage

• Change the profile settings.

You have stopped TREX on all hosts.

Change the TREX Configuration Files

Process Flow for Decentralized Storage

1. Change the host name of the slave name server on the slave name server host.

   For decentralized data storage, you first change the host name in the configuration files sapprofile.ini and TREXWebServer.ini (if the Web server was installed) on the host with the slave name server.

2. Change the host name of the slave name server on all master index servers.

   Then you change the host name of this slave name server in the topology.ini files on all master index server hosts in your distributed landscape.

Procedure

1. Change the host name of the slave name server on the slave name server host.

   1. Change <TREX_INSTANCE>\sapprofile.ini on the TREX host with the mode slave name server. Replace the old TREX host name in the configuration file sapprofile.ini with the new TREX host name <new_trex_host name>. Change the line #SAPLOCALHOST= to SAPLOCALHOST= <new_trex_host name>.

      Caution

      You have to remove the sign # in front of SAPLOCALHOST so that the command SAPLOCALHOST can be executed.

   2. Change the old TREX host name to <new_trex_hostname> in the configuration file <TREX_INSTANCE>\TREXWebServer.ini.

      Note

      You have to change the TREXWebServer.ini only if you have installed the Web Server.

      Navigate to section [HTTPSERVER] and replace the old TREX host name: URL=http ://<new_trex_hostname> <URL>:....

2. Change the host name of the slave name server on all master index servers.

   Change the old TREX host name to <new_trex_hostname> in the configuration file <TREX_INSTANCE>\topology.ini.

   • You have to do this in the configuration files topology.ini of all master hosts (TREX hosts with the role of master index server) in your distributed TREX landscape. In these topology.ini files, the host names of all slave name server in your TREX landscape are listed.

   • You have to change the TREX host name in several places in the configuration file topology.ini (for example: <host>, url=, user=, sap_retrieval_path=)).

3. Start TREX on all hosts.

Master host= host with the role of master index server

Slave host= host with the role of slave index server

Process Flow for Centralized Storage

1. Change the host name of the slave name server on the slave name server host.

   For centralized data storage, you first change the host name in the configuration files sapprofile.ini and TREXWebServer.ini (if the Web server was installed) on the host where the slave name server is activated.

2. Change the host name of the slave name server on the central file server.

   Then you change the host name of the slave name server once in the topology.ini file which is stored centrally on the file server.

Procedure

1. Change the host name of the slave name server on the slave name server host.

   1. Change the <TREX_INSTANCE>\sapprofile.ini file.

      Change the sapprofile.ini on the TREX host with the slave name server. Replace the old TREX host name in the configuration file sapprofile.ini with the new TREX host name <new_trex_host name>. Change the line #SAPLOCALHOST= to SAPLOCALHOST= <new_trex_host name>.

      Caution

      You have to remove the sign # in front of SAPLOCALHOST so that the command SAPLOCALHOST can be executed.

   2. Change the file <TREX_INSTANCE>\TREXWebServer.ini.

      Change the old TREX host name to <new_trex_hostname> in the TREXWebServer.ini configuration file.

      Note

      You have to change the TREXWebServer.ini only if you have installed the Web Server.

      Navigate to section [HTTPSERVER] and replace the old TREX host name: URL=http ://<new_trex_hostname> <URL>:....

2. Change the host name of the slave name server on the central file server.

   Change the old TREX host name to <new_trex_hostname> in the configuration file <TREX_INSTANCE>\topology.ini on the central file server.

   • You have to do this once in the configuration file topology.ini on the file server in your distributed TREX landscape. The host names of all slave name server of your TREX landscape are listed in the topology.ini file.

   • You have to change the TREX host name in several places in the configuration file topology.ini (for example: <host>, url=, user=, sap_retrieval_path=)).

Master host= host with the role of master index server

Slave host= host with the role of slave index server

File server= server for the centrally stored data

You have changed the TREX host name for the slave name server. You can now restart TREX.