Start of Content Area

Procedure documentation Specifying the Address of the TREX Name Server  Locate the document in its SAP Library structure

Use

TREX provides APIs (Application Programming Interfaces) for Java and ABAP. The APIs allow access to all TREX functions. As the TREX service, the Java interface (TREX Java client) is part of the SAP Application Server (AS) Java. The TREX Java client needs to know the address of the TREX name server in order to communicate with the TREX servers.

The following procedure describes how you determine the TREX name server address and how you specify it in the Visual Administrator.

This graphic is explained in the accompanying text

The TREX Java client communicates with the TREX server using HTTP and TCP/IP. Make sure that the TCP port that the name server uses is open.

Procedure

...

You have to specify the address of the TREX name server in the Visual Administrator by naming the following values in the form <host_name_of_trex_host>:<name_server_port>:

      <host_name_of_trex_host>: Name of the host on which TREX is installed and where the TREX name server runs.

      <name_server_port>: Port of the TREX name server

       1.      You can determine the address of the TREX name server in two ways:

                            a.      Start the TREX admin tool (see Starting the TREX Admin Tool) and determine the address of the name server using Landscape Tree ® topology ® globals ® all_masters.

This graphic is explained in the accompanying text

For example: mytrexhost:34801

                            b.      Determine the port of the TREX name server by means of the following rule: <name_server_port>: 3<instance_number>01

This graphic is explained in the accompanying text

The value <instance_number> signifies the TREX instance number specified during the TREX installation:

Installation directory for TREX.

       On UNIX: /usr/sap/<sapsid>/trx<instance_number>

       On Windows: <disk_drive>:\usr\sap\<SAPSID>\TRX<instance_number>

The value for <host_name_of_trex_host> is the host where TREX is installed (mytrexhost).

       2.      Use the <j2eeadm> user to log onto the host on which the AS Java is running.

       3.      Start the Visual Administrator.

       4.      Click Cluster and navigate to Services ® TREX Service.

       5.      Enter the address of the TREX name server into the nameserver.address parameter:

tcpip://<host_name_of_trex_host>:<name_server_port>

You either enter only the host name or the host name and the domain depending on your network environment.

Example

tcpip://mytrexhost:34801 or tcpip://mytrexhost.mydomain:34801

Caution

The address of the TREX name server must be configured for all server processes of the cluster. Otherwise the connection between the AS Java and TREX cannot be established.

       6.      In a scenario with several hosts for a distributed TREX landscape, enter the addresses of the TREX backup name servers in the nameserver.backuplist parameter. When doing so, separate the TREX backup name servers using a comma and use the following format: tcpip://<host1>:<port1>,tcpip://<host2>:<port2>, …

Caution

For a TREX single-host installation you do not need to specify backup name servers.

       7.      Save your changes and confirm the restart of the service. 

 

 

End of Content Area