TREX Admin Tool in the SAP System (TREXADMIN)

In SAP systems, you can call a tool for administrating TREX by calling transaction TREXADMIN. You can use this tool to administrate the queues, monitor TREX, and display information about the components in a TREX system.

Prerequisites

You are authorized to start the tool.

You configure the TREX admin tool in the SAP system for secure use by creating a user on the basis of the predefined SAP_BC_TREX_ADMIN role for transaction TREX_ADMIN. The SAP_BC_TREX_ADMIN role is delivered with the TREX ABAP client as part of SAP NetWeaver Application Servers ABAP. The user you create in this manner then has the necessary authorization for the secure use of the TREX admin tool in the SAP system (transaction TREXADMIN).

Note Note

For more information about assigning authorizations, see Creating SAP Users for the TREX Admin Tool in the SAP System.

End of the note.

Features

Call the TREX admin tool in the SAP system by launching transaction TREXADMIN.

The upper window area contains the following functions:

In the Connection to RFC Server field, use the RFC destination to choose which TREX system you want to administrate.

Once you have selected the RFC destination, the administration areas become active.
Using the RFC Administration button, you can create a new RFC destination if required, or display and change existing RFC destinations.
Choose TREX ABAP Customizing to configure whether communication between TREX and the application using TREX is to take place using RFC or HTTP with the Internet Communication Manager (ICM). Communication with ICM is mainly used when using TREX as SAP NetWeaver BI Accelerator for the transmission of certain data.

Note

For more information about the SAP NetWeaver BI Accelerator, visit the SAP Developers Network (SDN) at www.sdn.sap.com/irj/sdn/bia.

End of the note.

The documentation for both tools is structured in the same way to facilitate the use of the tools and documentation for users. For both admin tools, the documentation corresponds to the administration areas of the user interface of the TREX admin tool (standalone).

This graphic is explained in the accompanying text.

Note Note

The light gray administration areas (Backup and Preprocessor) are currently only available in the TREX admin tool (standalone).

End of the note.

The TREX admin tool in the SAP system displays the various administration functions as tab pages. This tool contains the most frequently required functions, which form a subset of the more extensive functions that are available in the TREX admin tool (standalone). Note that the sequence of the displayed tab pages does not correspond to the sequence of the described administration areas.

Note Note

Detailed status displays and configuration options are available in the TREX Admin Tool (Standalone).

End of the note.

The following administration areas are available in the TREX admin tool in the SAP system (transaction TREXADMIN):

	Tab	Description
Queue Administration
	Queue Administration	This tab page is only relevant if indexing takes place using the queue server. You can monitor queues, configure queue parameters, and troubleshoot here. More information: Queue Administration Tab Page.
	Queue Landscape	This tab page is relevant only for distributed TREX systems and only if indexing is done using a queue server. Here you can see the distribution of the queues among the different queue servers. More information: Queue Landscape Tab Page.
Index Administration
	Index Admin	This tab page displays technical information on indexes. For example, here you can see the time of the last indexing, the number of searchable documents, or the disk space taken up by the index.
	Index Hierarchy	This tab page displays the hierarchical structure of an index. It shoes the index type of an index. In the case of a split index, you can see which index parts it consists of. More information: Index Types.
	Join Index Info	This tab page displays technical information about compound indexes and BIA indexes.
	Index Landscape	This tab page is only relevant for distributed TREX systems. Here you can see the distribution of the indexes among the different index servers. In addition, you can check the index replication status. For more information, see Index Distribution and Index Replication Status.
	Usage	This area displays information about index use and statistics.
	Search	You can trigger searches from the Search tab page. You use this function for test purposes only.
	Attribute Mining	You can use this TREX function to display the statistical distribution of attributes in an index.
Cruiser Administration
	Cruiser	You use this tab page to administrate and configure the TREX cruiser components. The TREX cruiser enables a file search on file servers and Web servers. TREX then indexes the files that are extracted from the searched file and Web servers. More information: Cruiser Administration. Note For more information on using and optimizing the TREX cruiser, see SAP Note 1110112 – TREX 7.0/7.1: How to use the TREX Cruiser. End of the note.
Landscape Administration
	Summary	This tab page provides an overview of the TREX status with information on the TREX version, operating system, and current error messages.
	Alert	This tab page is used to monitor TREX. Checks are performed periodically and in the event of errors, you can be notified by e-mail. For more information, see TREX Alert Server.
	Reorg	This tab page enables the reorganization of the indexes in a TREX landscape. More information: Reorganization of the TREX Landscape.
	Topology	This tab page displays technical information on a TREX system. For more information, see Topology Information.
	Ini Files	Displays the TREX configuration files. You can display the content of the configuration files and change it if necessary. Caution Changing configuration files directly requires expert knowledge of the TREX architecture and TREX-internal processes. Only make direct changes to the configuration files if those changes are described in the TREX documentation. End of the caution.
	Hosts	This tab page displays information on the installation directory, operating system platform, and installed TREX release. More information: Information on TREX Servers (TREXADMIN)
	Services	Displays the load on the TREX servers in a table. There is a separate row for each TREX server. More information: Information on TREX Servers (TREXADMIN)
	Threads	On the Threads tab page, you can see which threads are currently executing which methods. You can also see how long processing of a method has taken so far. More information: Information on TREX Servers (TREXADMIN)
	Handles	On the Handles tab page, you can see the number of handles that a process has generated and is using. More information: Information on TREX Servers (TREXADMIN)
	Trace	Displays the trace files of the TREX servers. By default, the trace files contain all error messages that the TREX servers output. You can display the contents of a trace file by double-clicking it. You can download the trace files.
	Landscape	This tab page displays the configuration of a distributed TREX system. You can only display data here. You configure a distributed TREX system using the TREX admin tool (standalone). For more information about setting up and configuring a distributed TREX system, see Distributed TREX Systems (Multiple Host Installation) and Setting Up a Distributed System.
	RFC Monitoring	This tab page shows whether or not all of the SAP system application servers have a connection to the TREX system. If there are errors here, they can have the following causes: The application server is communicating through an SAP gateway that has not been started. The parameters of the RFC destination do not match the TREX configuration. No TREX RFC server has registered with the SAP gateway. Note The window shows only whether the connection from within the SAP system works. It does not display whether the connection works from within the TREX system. The TREX admin tool (standalone) displays the complete status of the RFC connection and allows you to configure the RFC connection and correct the error. For more information on the RFC connection between TREX and the application using TREX, see Configuring and Administrating the RFC Connection. End of the note.