Changing the TREX Host Name (Single Host)

You change the TREX host name for a TREX single-host installation on the host where TREX has been installed. To rename the TREX host you have to do the following:

• Change the TREX configuration files.
• Change the profiles settings.

Prerequisites

You have stopped TREX.

Change the TREX Configuration Files

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

   You have to change the TREX host name in several places in the configuration filetopology.ini (for example:<host>,url=, user=, sap_retrieval_path=, master_hosts=).Open the file, search for your old TREX host name, replace it with<new_trex_hostname> and save the file.

2. Change the old TREX host name to<new_trex_hostname> in the configuration file<TREX_INSTANCE>\sapprofile.ini.
   1. If the new host name does not match the host name on operating system level (as returned by the commandhostname) then change the line#SAPLOCALHOST= to SAPLOCALHOST= <new_trex_hostname>
      Caution

      You have to remove the sign# in front ofSAPLOCALHOST so that the variableSAPLOCALHOST is used.

   2. If you have already specified this TREX name server as the master name server by choosing the Convert to Master function in the TREX admin tool (stand-alone), replace the old TREX host name in section# TREX-Name Server TREX/NameServer/Master= <new_trex_host name> :3XX01.<instance_number>
      Caution

      You have to remove the sign# in front of the line so that the variable is used.

      Note

      If you have not changed the role of the name server to master name server, you do not have to modify this section of the configuration file.

3. 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 if you have installed the Web Server.

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

Example Scenario for Single-Host Installation

Overview of TREX Configuration Files to Be Changed

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 a TREX single-host installation. You can now restart TREX.