Changing the TREX Host Name of the Master Name
Server
You want to change the host name of the master name server. Proceed as follows:
● Change the TREX configuration files
The process flow for the configuration 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.
Prerequisites
You have stopped TREX on all hosts.
Changing the TREX Configuration Files
Process flow for decentralized storage
...
1. Change the host name of the master name server on the host of master name server.
For decentralized data storage, you first change the host name of a master name server in the topology.ini, sapprofile.ini and TREXWebServer.ini configuration files (the latter file only if the Web server was installed) on the host with the master name server.
2. Change the host name of the master name server on each host in your landscape.
You then change the host name of this master name server in all sapprofile.ini files on each host in your distributed landscape
3. Change the host name of the master name server on the master index server.
Finally you change the host name of the master name server in the topology.ini files of the master index servers.
Example Scenario
Procedure
...
...
1. Change the host name of the master name server.
a. Change the <TREX_INSTANCE>\topology.ini file on the TREX host with the master name server.
■ You have to change the TREX host name in several places in the topology.ini configuration file (for example: <host>, url=, user=, sap_retrieval_path=).
■ Open the file, search for your old TREX host name, replace it with <new_trex_hostname> and save the file.
b. Change the <TREX_INSTANCE>\sapprofile.ini file on the TREX host with the master name server. Replace the old TREX host name in the sapprofile.ini configuration file with the new TREX host name <new_trex_host name>. Change the line #SAPLOCALHOST= to SAPLOCALHOST=<new_trex_host name>.
You have to remove the sign # in front of SAPLOCALHOST so that the SAPLOCALHOST command can be executed.
c. Change the old TREX host name to <new_trex_hostname> in the <TREX_INSTANCE>\TREXWebServer.ini configuration file.
You have to change TREXWebServer.ini only if you have installed a Web server. Navigation to the section [HTTPSERVER] and replace the old TREX host name: URL=http://<new_trex_host_name>.<URL>:...
2. Change the host name of the master name server on each host in your landscape.
Change the <TREX_INSTANCE>\sapprofile.ini file on all hosts in your TREX landscape. The host names of all master name servers in a TREX landscape are listed in the sapprofile.ini file on each host in your landscape.
# TREX-NameServer
. . .
TREX/NameServer/Master=pwdf2832:30001 pwdf2833:30101 pwdf2834:30201
Replace the old host name of the master name server in your TREX landscape in this list with the new host name. You have to do this on each host in your landscape.
3. Change the host name of the master name server on the master index server.
Change the old TREX host name to <new_trex_hostname>in the <TREX_INSTANCE>\topology.ini file of the master index server.
○ You have to do this in the topology.ini configuration files of all master hosts (TREX hosts with the role of master index server) in your distributed TREX landscape.
○ You have to change the TREX host name in several places in the topology.ini configuration file (forexample: <host>, url=, user=, sap_retrieval_path=).
Overview of TREX Configuration Files to Be Changed
|
Hosts |
topology.ini |
sapprofile.ini |
TREXWebServer.ini |
1. |
Master host 2 as master name server |
Change old host to new host name |
Change old host to new host name |
Change old host to new host name |
2. |
Slave host 1 |
--------------- |
# TREX-NameServer change the host name of the master name server |
|
2. |
Slave host 2 |
--------------- |
# TREX-NameServer change the host name of the master name server |
|
3. |
Master host 1 as master name server |
Change old host to new host name |
# TREX-NameServer change the host name of the master name server |
|
Master host= host with the role of master index server
Slave host= host with the role of slave index server
Backup host = host with the role of backup index server
Process flow for centralized storage
...
1. Change the host name of the master name server on the host of master name server.
For centralized data storage, you first change the host name of a master name server in the sapprofile.ini and TREXWebServer.ini configuration files (in the latter case, only if a Web server was installed) on the host with the master name server.
2. Change the host name of the master name server on each host in your landscape.
You then change the host name of this master name server in all sapprofile.ini files on each host in your distributed landscape
3. Change the host name of the master name server on the central file server.
Finally you change the host name of the master name server once in the topology.ini file that is stored centrally on the file server.
Example Scenario
Procedure
..
1. Change the host name of the master name server on the host of master name server.
a. Change the <TREX_INSTANCE>\sapprofile.ini file on the TREX host with the master name server. Replace the old TREX host name in the sapprofile.ini configuration file with the new TREX host name <new_trex_host name>. Change the line #SAPLOCALHOST= to SAPLOCALHOST=<new_trex_host name>.
You have to remove the sign # in front of SAPLOCALHOST so that the SAPLOCALHOST command can be executed.
b. Change the old TREX host name to <new_trex_hostname> in the <TREX_INSTANCE>\TREXWebServer.ini configuration file.
You have to change TREXWebServer.ini only if you have installed a Web Server.
Navigation to the section [HTTPSERVER] and replace the old TREX host name: URL=http://<new_trex_host_name>.<URL>:...
2. Change the host name of the master name server on each host in your landscape.
Change the <TREX_INSTANCE>\sapprofile.ini file on all hosts in your TREX landscape. The host names of all master name servers of a TREX landscape are listed in the sapprofile.ini file on each host in your landscape.
# TREX-NameServer
. . .
TREX/NameServer/Master=pwdf2832:30001 pwdf2833:30101 pwdf2834:30201
Replace the old host name of the master name server in your TREX landscape in this list with the new host name. You have to do this on each host in your landscape.
3. 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 <TREX_INSTANCE>\topology.ini configuration file on the central file server.
○ You have to do this once in the topology.ini configuration file on the file 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 topology.ini configuration file (for example: <host>, url=, user=, sap_retrieval_path=).
Overview of TREX Configuration Files to Be Changed
Hosts |
sapprofile.ini |
TREXWebServer.ini |
topology.ini |
Master host as master name server |
Change old host to new host name |
# TREX-Name Server Change the host names of the master name servers |
--------------- |
Slave host 1 |
Change old host to new host name |
--------------- |
--------------- |
Slave host 2 |
Change old host to new host name |
--------------- |
--------------- |
Backup host |
Change old host to new host name |
--------------- |
--------------- |
File server |
--------------- |
--------------- |
Change old host to new host name |
Master host= host with the role of master index server
Slave host= host with the role of slave index server
Backup host = host with the role of backup index server
File server= server for the centrally stored data
Changing the Profile Settings
After changing the TREX configuration files you change the profile settings as described in Changing the Profile Settings.
Result
You have changed the TREX host name for the master name server. You can now restart TREX.