TREX Admin Tool in the SAP System (TREXADMIN)

Use

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 for transaction TREX_ADMIN based on the predefined role SAP_BC_TREX_ADMIN, which is delivered as part of the SAP NetWeaver Application Server ABAP together with the TREX ABAP client. 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

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

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.

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

Note

The greyed-out administration areas (the Backup and Preprocessor areas) are currently only available in the TREX admin tool (standalone).

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

More detailed status displays and configuration options are available in the TREX admin tool (stand-alone).

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

	Tabs	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. For more information, see Queue Administration.
	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. For more information, see Queue Landscape.
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 shows the index type of an index. In the case of a split index, you can see which index parts it consists of. For more information, see 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	Shows information about index use and statistics.
	Search	On the Search tab page, you can start search requests. 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. For more information, see 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.
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. More information: TREX Alert Server
	Reorg	This tab page enables the reorganization of the indexes in a TREX landscape. For more information, see Reorganizing the TREX System Landscape.
	Topology	This tab page displays technical information on a TREX system. For more information, see Topology Information.
	Ini Files	This tab page 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.
	Hosts	This tab page displays information on the installation directory, operating system platform, and installed TREX release. For more information, see 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. For more information, see 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 the processing of a method has taken so far. For more information, see 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. For more information, see Information on TREX Servers (TREXADMIN).
	Trace	This tab page 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)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 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 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 about the RFC connection between TREX and the application using TREX, see Configuring and Administrating the RFC Connection.