Changing the TREX Host Name for the Slave Name Server

You want to change the host name of a slave name server. You have to do the following:

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.

Prerequisite

You have stopped TREX on all hosts.

Change the TREX configuration files

Process Flow for Decentralized Data Storage

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 filessapprofile.ini andTREXWebServer.ini (if the Web server was installed) on the host with the slave name server.
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 thetopology.ini files on all master index server hosts in your distributed landscape.

Example Scenario

Procedure

Change the host name of 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. Change the old TREX host name to the new TREX host name<new_trex_host name> in the configuration filesapprofile.ini. Change the line#SAPLOCALHOST= to SAPLOCALHOST= <new_trex_host name>.Caution You have to remove the sign# in front ofSAPLOCALHOST so that the commandSAPLOCALHOST 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 theTREXWebServer.ini only in case the Web Server was installed.
  
  Navigate to section[HTTPSERVER] and replace the old TREX host name:URL=http ://<new_trex_hostname> .<URL>:....
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 filestopology.ini of all master hosts (TREX hosts with the role of master index server) in your distributed TREX landscape. In thesetopology.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 filetopology.ini (for example:<host>,url=, user=, sap_retrieval_path=).
Start TREX on all hosts.

Overview TREX of TREX Configuration Files to Be Changed

	Host	sapprofile.ini	TREXWebServer.ini	topology.ini
1.	Slave host 2 as slave name server	Change old host name to new host name	Change old host name to new host name	---------------
2.	Master host 1	---------------	---------------	Change the host name of the slave name server
2.	Master host 2	---------------	---------------	Change the host name of slave name server

Master host= host with the role of master index server

Slave host= host with the role of slave index server

Process Flow for Centralized Data Storage

Change the host name of the slave name server on the host of the slave name server.
For centralized data storage, you first change the host name in the configuration filessapprofile.ini andTREXWebServer.ini (if the Web server was installed) on the host where the Slave Name Server is activated.
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 thetopology.ini file which is stored centrally on the file server.

Example Scenario

Procedure

Change the host name of the slave name server on the host of the slave name server.
1. Change the file<TREX_INSTANCE>\sapprofile.ini
  Change thesapprofile.ini on the TREX host with the slave name server. Change the old TREX host name to the new TREX host name<new_trex_host name> in the configuration filesapprofile.ini. Change the line#SAPLOCALHOST= to SAPLOCALHOST= <new_trex_host name>.
  
  Caution
  You have to remove the sign# in front ofSAPLOCALHOST so that the commandSAPLOCALHOST can be executed.
2. Change the file<TREX_INSTANCE>\TREXWebServer.ini.
  Change the old TREX host name to<new_trex_hostname> in theTREXWebServer.ini.
  
  Note
  You have to change theTREXWebServer.ini only if you have installed the Web server.
  
  Navigate to the section[HTTPSERVER] and replace the old TREX host name:URL=http ://<new_trex_hostname> .<URL>:....
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 filetopology.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 thetopology.ini file.
- You have to change the TREX host name in several places in the configuration filetopology.ini (for example:<host>,url=, user=, sap_retrieval_path=).

Overview of TREX Configuration Files to Be Changed

	Host	sapprofile.ini	TREXWebServer.ini	topology.ini
1.	Slave host with mode slave name server	Change old host name to new host name	Change old host name to new host name	---------------
2.	File server	---------------	---------------	Change host the name of the slave name server

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

Change the profiles settings

After changing the TREX configuration files you have to change the profile settings as described inChanging the Profile Settings.

Result

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