Show TOC

Changing the TREX Host Name of the Master Name ServerLocate this document in the navigation structure

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

  • 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.

Change the TREX configuration files

Process Flow for Decentralized Data Storage

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

    For decentralized data storage, you first change the host name of a master name server in the configuration filestopology.ini, sapprofile.ini andTREXWebServer.ini (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.

    Then you 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 thetopology.ini files of the master index servers.

Example Scenario

Procedure

  1. Change the host name of the master name server.
    1. Change the file<TREX_INSTANCE>\topology.ini on this TREX host with the master name server.
      • You have to change the TREX host name in several places in the configuration filetopology.ini (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.
    2. Change the file<TREX_INSTANCE>\sapprofile.ini on this TREX host with the master 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.

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

      You have to change the fileTREXWebServer.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>:....

  2. Change the host name of the master name server on each host in your landscape.

    Change the file<TREX_INSTANCE>\sapprofile.ini on all hosts in your TREX landscape. The host names of all master name servers in a TREX landscape are listed in the filesapprofile.ini on each host of your landscape.

    Tip

    # 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 file<TREX_INSTANCE>\topology.ini of the master index server.

    • You have to do this in the configuration filetopology.ini on 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 filetopology.ini (for example:<host>,url=,user=,sap_retrieval_path=).

Overview of TREX Configuration Files to Be Changed

  Host topology.ini sapprofile.ini TREXWebServer.ini

1.

Master host 2 as master name server

change old host name to new host name

change old host name to new host name

change old host name 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 name 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 Data Storage

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

    For centralized data storage, you first change the host name of a master name server in the configuration filessapprofile.ini andTREXWebServer.ini (if 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.

    Then you change the host name of this master name server in allsapprofile.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 thetopology.ini file which is stored centrally on the file server.

Example Scenario

Procedure

  1. Change the host name of the master name server on the host of the master name server.
    1. Change the file<TREX_INSTANCE>\sapprofile.ini on the TREX host with the master 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= toSAPLOCALHOST= <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 file<TREX_INSTANCE>\TREXWebServer.ini.
      Note

      You have to change the fileTREXWebServer.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>:....

  2. Change the host name of the master name server on each host in your landscape.

    Change<TREX_INSTANCE>\sapprofile.ini on all hosts in your TREX landscape. The host names of all master name servers of a TREX landscape are listed in the filesapprofile.ini on each host in your landscape.

    Tip

    # TREX-NameServer

    . . .

    TREX/NameServer/Master=pwdf2832:30001 pwdf2833:30101 pwdf2834:30201

    Replace the old host name of the master name server of your TREX landscape in this list with the new host name. You have to do this on every host of 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 file<TREX_INSTANCE>\topology.ini on the central file server.

    • You have to do this once in the configuration filestopology.ini on the file server in your distributed TREX landscape. In thetopology.ini files, the host names of all the slave name servers in your TREX landscape are listed.
    • You have to change the TREX host name in several places in the 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

Master host as master name server

Change the old host name to new host name

# TREX-Name Server Change the host names of the master name servers

---------------

Slave host 1

Change the old host name to the new host name

---------------

---------------

Slave host 2

Change the old host name to the new host name

---------------

---------------

Backup host

Change the old host name to the new host name

---------------

---------------

File server

---------------

---------------

Change the old host name to the 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

Change the profiles settings

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

Result

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