PUBLIC

Installation Guide

SAP NetWeaver Standalone Engine Search and Classification TREX 7.10 Single Host
Target Audience • • System administrators Technology consultans

Document Version 1.4 – April 14, 2008

SAP AG Neurottstraße 16 69190 Walldorf Germany T +49/18 05/34 34 24 F +49/18 05/34 34 20 www.sap.com

© Copyright 2008 SAP AG. All rights reserved. No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. Microsoft, Windows, Outlook, PowerPoint, and SQL Server are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iSeries, pSeries, xSeries, zSeries, z/OS, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, and Informix are trademarks of IBM Corporation in the United States and/or other countries. ORACLE is a registered trademark of Oracle Corporation. UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group. Citrix, ICA, Program Neighborhood , MetaFrame, WinFrame, VideoFrame, and MultiWin are trademarks of Citrix Systems, Inc. HTML, XML, XHTML and W3Care trademarks or registered trademarks of W3C®, World Wide Web Consortium, Massachusetts Institute of Technology. Java is a registered trademark of Sun Microsystems, Inc. JavaScript is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. Disclaimer Some components of this product are based on Java™. Any code change in these components may cause unpredictable and severe malfunctions and is therefore expressively prohibited, as is any decompilation of these components. Any Java™ Source Code delivered with this product is only to be used by SAP’s Support Services and may not be modified or altered in any way. Documentation on SAP Service Marketplace You can find this documentation at the following address:
http://service.sap.com/instguides

SAP, R/3, mySAP, mySAP.com, SAP NetWeaver, xApps, xApp, and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are the trademarks of their respective companies. Data contained in this document serves information purposes only. National product specifications may vary. These materials are subject to change without notice. These materials are provided by SAP AG and its affiliated companies (“SAP Group”) for informational purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or omissions with respect to the materials. The only warranties for SAP Group products and services are those that are set forth in the express warranty statements accompanying such products and services, if any. Nothing herein should be construed as constituting an additional warranty.

Search and Classification TREX

April 2008

Icons in Body Text
Icon Meaning Caution Example Note Recommendation Syntax Additional icons are used in SAP Library documentation to help you identify different types of information at a glance. For more information, see Help on Help → General Information Classes and Information Classes for Business Information Warehouse on the first page of any version of SAP Library.

Typographic Conventions
Type Style Example text Description Words or characters quoted from the screen. These include field names, screen titles, pushbuttons labels, menu names, menu paths, and menu options. Cross-references to other documentation. Example text EXAMPLE TEXT Emphasized words or phrases in body text, graphic titles, and table titles. Technical names of system objects. These include report names, program names, transaction codes, table names, and key concepts of a programming language when they are surrounded by body text, for example, SELECT and INCLUDE. Output on the screen. This includes file and directory names and their paths, messages, names of variables and parameters, source text, and names of installation, upgrade and database tools. Exact user entry. These are words or characters that you enter in the system exactly as they appear in the documentation. Variable user entry. Angle brackets indicate that you replace these words and characters with appropriate entries to make entries in the system. Keys on the keyboard, for example, F2 or ENTER.

Example text

Example text <Example text>

EXAMPLE TEXT

Installing and Updating TREX – Single Host

3

Search and Classification TREX

April 2008

Installing and Updating TREX – Single Host............................................................................. 6 Implementation Considerations ............................................................................................. 7 Integration of TREX and Applications That Use It.............................................................. 7 SAP NetWeaver BI Accelerator (BIA) ................................................................................ 8 Minimal and Distributed TREX Systems .......................................................................... 11 Installation and Configuration of Server and Client Software .......................................... 12 Naming Conventions............................................................................................................ 13 Checklists for the Installation ............................................................................................... 14 Installation with an HTTP Connection .............................................................................. 15 Installation with an RFC Connection ................................................................................ 16 Installation with HTTP and RFC Connections.................................................................. 18 Installation Planning............................................................................................................. 20 Hardware and Software Requirements ............................................................................ 20 Required Documentation.................................................................................................. 23 Installation Preparations ...................................................................................................... 24 Downloading TREX .......................................................................................................... 24 TREX System and TREX Instances................................................................................. 25 Information on Installing Multiple TREX Instances........................................................... 28 Preparing the System for SAPinst GUI ............................................................................ 28 Checking Disk Space ....................................................................................................... 29 Installation and Update ........................................................................................................ 30 Installing with SAPinst ...................................................................................................... 30 Installing with SAPinst on UNIX.................................................................................... 32 Installing with SAPinst on Windows.............................................................................. 35 Handling SAPinst GUI ...................................................................................................... 37 Installing TREX................................................................................................................. 37 Installing an additional TREX Instance ............................................................................ 41 Installing TREX with a Virtual Host Name........................................................................ 42 Updating TREX ................................................................................................................ 43 Uninstalling TREX ............................................................................................................ 45 TREX Basic Configuration ................................................................................................... 46 Wizard-Based Basic Configuration for TREX................................................................... 47 TREX Post-Installation Configuration............................................................................... 48 Starting the TREX Admin Tool...................................................................................... 48 Configuring the TREX Web Server............................................................................... 48 Configuring TREX Proxy Settings ................................................................................ 50 Checking Proxy Settings............................................................................................... 50 Selecting Languages for TREX Language Recognition ............................................... 51 Configuring TREX for the System Landscape Directory (SLD).................................... 52 Installing and Updating TREX – Single Host 4

............................................... 74 Stopping the Web Server ......................................................................................... 65 Additional Information ......Search and Classification TREX April 2008 Checking Performance Settings for the Operating System..................................................... 66 Starting the TREX Admin Tool ............. 74 Stopping TREX ................. 56 Connecting TREX with an ABAP Application (RFC Connection) ............................................................. 74 Starting TREX .......................... 70 Starting TREX .............................. 62 Installation Check........... 77 Troubleshooting SAPinst.............................................................................................. 72 Starting and Stopping Individual TREX Servers .................................................................................................................................................................................................................................................................................................................... 57 Determining the SAP System Connection Information ......................................................................................................................................... 77 Information on SAPinst ..................... 76 Starting and Stopping the Web Server ........................ 64 Executing an Installation Test Script ............................................... 60 Connecting TREX with a Java Application (HTTP Connection) ....................................................................................................................................... 77 Interrupted Installation with SAPInst ...................................................................................................................................................................................................................................................................................................................................................................... 78 Installing and Updating TREX – Single Host 5 ............................. 66 Starting SAPinst GUI Separately.................. 75 Starting and Stopping Individual TREX Servers ................................................................................................. 55 Connecting TREX with an Application .. 73 Starting the Web Server....................................... 57 Creating a SAP System User for the TREX Admin Tool (Stand-Alone) ................................. 64 Checking Processes..................................................... 74 Starting and Stopping TREX on UNIX............................................. 69 Starting and Stopping TREX on Windows............................................ 67 Starting SAPinst on the Remote Host (Optional) .................................................................................................................................... 59 Configuring the RFC Connection in the TREX Admin Tool .............. 62 Specifying the Address of the TREX Name Server ........................................................................................................................................................ 68 Starting and stopping TREX......................................................................................... 71 Stopping TREX ..........................................................

The global file share basically consists of the SAP system directory usr/sap/<sapsid>/sys.0 offers the installation of a TREX central instance on a global file share.1 installation the customer can not specify the path to the global file share (SAP system directory usr/sap/<sapsid>/sys). By the TREX 7. The global file share will be installed only once on the host.1 for the end of 2008. including an overview of the installation steps. The section TREX Basic Configuration [Page 46] describes the configuration steps you have to perform after the TREX installation. especially how to download the TREX software package from SAP Service Marketplace.Search and Classification TREX April 2008 Installing and Updating TREX – Single Host Purpose This guide describes the single-host installation and update of SAP NetWeaver Search and Classification (TREX). You can use this functionality for setting up distributed TREX landscapes. The section Naming Conventions [Page 13] contains information on special naming conventions used in this guide. so that they can be accessed by other TREX dialog instances of a distributed landscape. but it can not be placed independently from the initial TREX 7. The section Additional Information [Page 66] contains information on troubleshooting problems that might occur during the installation and explains how to control the installation from another host. ● ● ● ● Installing and Updating TREX – Single Host 6 . On this global file share you can store SAP profile files centrally. installation screens. where TREX 7. The section Installation Check [Page 64] describes how to check whether the installation of the server software was successful.1 will be initially installed and can not be placed on other hosts.1 installation on other hosts of your distributed landscape.1 installation. and uninstall TREX.1 installation the global file share functionality is currently only supported in a restricted manner. TREX is developing the unrestricted global file share functionality for TREX 7. So there still is a global file share for the TREX 7. During the TREX 7. The section Checklists for the Installation [Page 14] contains a separate checklist for each installation variant. It also describes how to start. The section Installation and Update [Page 30] describes the necessary TREX installation and update steps. The guide is structured as follows: ● ● ● ● The section Implementation Considerations [Page 7] explains what you need to take into account before the installation.1 installation TREX 7. and input parameters. The target audience for the guide consists of system administrators and consultants. stop. Restricted support of global file share functionality by TREX 7. The section Installation Preparations [Page 24] describes what to do before the installation.

a business scenario. The client software is integrated into the application that uses the TREX functions. and send them on to the responsible TREX server. They also define the installation sequence. Installing and Updating TREX – Single Host 7 . and allows communication with the TREX servers. see Connecting TREX with a Java Application (HTTP Connection) [Page 62]. Master Guides If you are installing TREX as part of a mySAP Business Suite solution.Search and Classification TREX April 2008 Constraints Additional Configuration Steps Depending on the Application Additional configuration steps may be necessary depending on the application for which you are installing TREX. The TREX servers execute the requests of the clients: They index and classify documents and respond to search queries. They list the components and third-party applications that are necessary for a business scenario or an IT scenario. and IT scenarios. ● Java applications communicate with TREX using the HTTP or HTTPS protocol. These additional steps are not described in this guide. Master guides are the central documents for implementing mySAP Business Suite solutions. familiarize yourself with the relevant master guide before beginning the installation. or an IT scenario. business scenarios. see Connecting TREX with an ABAP Application (RFC Connection) [Page 57]. For more information. The graphic below depicts the interaction between applications and TREX. This communication takes place using a Web server that is enhanced with TREX-specific functions. You can find them in the documentation on the application in question. TREX offers an ABAP and a Java client. Communication takes place using an instance of the SAP Gateway and an RFC server. Integration of TREX and Applications That Use It TREX is based on a client/server architecture. convert them to a TREX-internal format. This allows ABAP and Java applications to use TREX functions. and refer to any necessary installation and upgrade guides. RFC and Web servers have similar functions: They receive the requests of the application. ABAP and Java applications communicate with the TREX servers using different protocols and components. For more information. Implementation Considerations Refer to the following information before starting the installation. ● ABAP applications communicate with TREX servers using the RFC protocol.

Note the following: ● ● The TREX system must have appropriate dimensions so that it can process the load of all the applications. Connecting TREX to More Than One Application In principle. BI accelerator benefits companies that handle large volumes of data. The following graphic depicts the relationship between the BI accelerator and the BI System: Installing and Updating TREX – Single Host 8 . SAP NetWeaver BI Accelerator SAP NetWeaver BI Accelerator: a Key Functionality for HighPerformance Analytics The BI accelerator is based on TREX technology. which belongs to the Enterprise Data Warehousing IT scenario. Only by using the same support packages you can ensure the integration and smooth collaboration between all systems. Use all installable units within SAP NetWeaver that have the same support package level.sap. The average response time is significantly improved in comparison with traditional approaches.Search and Classification TREX April 2008 ABAP application SES Search Engine Service Java application ABAP client RFC Java client HTTP/HTTPS & XML TCP/IP SAP gateway RFC server Web server Application TREX server TREX components Other components There is no dependency between TREX and the application using TREX with regard to the operating system used. The data of the BI InfoCubes is replicated to the TREX engine and stored as TREX indexes. and clients within SAP NetWeaver. stand-alone engines. A TREX aggregation engine for processing structured business data powers this functionality.com/instguides. a key functionality for high-performance analytics. You must take organizational measures to ensure that the applications use separate index namespaces. For more information see the SAP Net Weaver Master Guide on SAP Service Marketplace service. You can install TREX on a different operating system to the application that accesses TREX. It is the aggregation engine for the accelerator functionality of SAP NetWeaver Business Intelligence (BI). you can connect one TREX system to more than one application.

In order to use both the search functions and the BI accelerator.com/swdc → Download → Support Packages and Patches → Entry by Application Group → SAP NetWeaver → SAP NETWEAVER → SAP NETWEAVER 7. You must note that a TREX installation configured for searching metadata and documents based on a 32-Bit architecture cannot be used for the BI accelerator. you must enter the fixed RFC destination defined for this purpose (default: TREX_HPA) in table RSADMINA. The hardware partners deliver this variant in preconfigured form as the BI accelerator box. you require an installation based on a 64-Bit architecture.0 → TREX 7. you require two separate installations. you cannot use a BI accelerator box to search metadata and documents. which is delivered on preconfigured hardware. and Update the BI Accelerator ● Use only with BI The BI accelerator is based on TREX technology. In turn. In order to use the preinstalled BI Accelerator Box. They can download the updates and patches for the BI accelerator from the SAP Service Marketplace service. Install. All installation and configuration steps will be done during the preconfiguration of the hardware by the hardware vendor. ● Download update from SAP Service Marketplace BI customers have to update and patch the BI accelerator. ● Installation on preconfigured hardware The BI accelerator is a special LINUX 64-Bit version of SAP NetWeaver Search and Classification (TREX).00 → Linux on x86 64 64bit For more information about the BI accelerator.Search and Classification TREX April 2008 SAP NetWeaver RFC SAP NetWeaver BI accelerator BI System How To Use. You cannot use the BI accelerator for the regular TREX search and classification functions. For the BI accelerator.0 → SAP BI Accelerator → SAP BI Acelerator 7. see the following SAP notes: ■ ■ ■ 883726 Central Note BI accelerator 875400 Installing SAP NetWeaver BI accelerator 883725 Updating SAP NetWeaver BI accelerator Installing and Updating TREX – Single Host 9 .sap.

sdn. The graphic below depicts how data. The special feature of a TREX installation on a blade system is that both the TREX software and the TREX data can be stored centrally.com/irj/sdn/bia. This is referred to here as a file server. A blade system consists of hosts in the form of server blades. The configuration files in the directory <TREX_DIR> are only used as templates.. Blade System Master NS File Server <TREX_DIR> index exe Data 2nd Master NS /TRX<hostname_blade1> /TRX<hostname_blade2> /TRX<hostname_blade3> Master IS Programs Slave NS /TRX<hostname_blade4> Cloned Configuration Files .sap.Search and Classification TREX ■ ■ April 2008 902533 HowToGuide Connecting/Operating BI Accelerator Box 984034 BI Accelerator High Availability See also the SAP NetWeaver Developers Network (SDN) for detailed information about the BI accelerator https://www. programs. All server blades on which TREX is running access the same program files. This means that the software is installed only once on the file server.. each server blade has its own configuration files. NS = Name Server IS = Index Server Installing and Updating TREX – Single Host 10 . regardless of the underlying hardware. However. BI accelerator: Preconfigured Blade System The BI accelerator is installed on a preconfigured blade system. The server blades are connected to centralized disk storage. A script creates a separate subdirectory for each server blade and copies the configuration files to this subdirectory. and configuration files might be stored in a BI accelerator blade system. Maintaining the system is efficient because you have to implement software updates once only.

SAP therefore recommends that you calculate the expected load and availability requirements for your TREX system early on in the planning process and start with a distributed TREX installation immediately if that is what you require. In a distributed scenario. For a production system. You can use a minimal system as a demo. Installing and Updating TREX – Single Host 11 . You can use a distributed installation to achieve the following: ● ● Load balancing You can distribute the search and indexing load among several hosts. Mixed installations with different TREX versions are not supported. SAP recommends that you install the server software on a single host that is used exclusively for TREX. and production system. High availability You can make sure that both indexing and searching are highly available.Search and Classification TREX April 2008 Minimal and Distributed TREX Systems Minimal TREX System (Single-Host Installation) A minimal system consists of one TREX instance (one installation of the server software). the same TREX version and patch level must run on all TREX hosts. The server component is based on a flexible architecture that allows a distributed installation. Use the information in Hardware and Software Requirements [Page 20] as a basis for this. test. If TREX is running on the same host as other components. Your TREX system can quickly reach its performance limit if you install TREX on a single server in a productive scenario with large document sets and a large number of search queries. Sizing The required hardware for the server software depends on the following factors: ● ● ● How many documents of what type are to be indexed? What quantities of documents are to be indexed initially. you must make sure of the following: ■ ■ There is enough main memory for all components. TREX can use the required main memory space exclusively. and what quantities during routine operation? How many search queries are expected? How many parallel search queries are expected? Plan the required number of hosts and the equipping thereof with your SAP hardware partner. Distributed TREX System (Multiple Host Installation) Search and Classification (TREX) consists of a client component and a server component.

execute the installation and configuration steps necessary for an HTTP and an RFC connection. see Connecting TREX with a Java Application (HTTP Connection) [Page 62] and Connecting TREX with an ABAP Application (RFC Connection) [Page 57]. see Connecting TREX with an ABAP Application (RFC Connection) [Page 57].Search and Classification TREX April 2008 For more information on installing and configuring a distributed TREX system. For more information. ● The TREX servers are used by Java and ABAP applications. Installation and Configuration of the Client Software ● ABAP client The ABAP client is part of the SAP system. For more information. and must not be installed separately. you definitely need to carry out the installation and configuration steps that enable an HTTP connection. For more information. When you are installing TREX. you need to know the type of application and communication protocol. you definitely need to carry out the installation and configuration steps that enable an RFC connection. This guide contains a checklist with an overview of necessary installation and configuration steps for each case. ● The TREX servers are only used by ABAP applications. The documents to be indexed are sent by an ABAP application to TREX.sap. In this case. see Connecting TREX with an ABAP Application (RFC Connection) [Page 57]. see the SAP NetWeaver Distributed Search and Classification (TREX) Systems Installation Guide on the SAP Service Marketplace at service. Installation and Configuration of Server and Client Software Installation and Configuration of the Server Software The TREX servers can be used by one or more applications. Since ABAP applications communicate with the TREX servers using RFC. The search takes place using a Web application (Java application). see Connecting TREX with a Java Application (HTTP Connection) [Page 62]. The necessary configuration is described in this guide. Since Java applications communicate with the TREX servers using HTTP.com/instguides. There are the following possibilities: ● The TREX servers are only used by Java applications. ● Java client Installing and Updating TREX – Single Host 12 . For more information.

the Java client is part of the JEE engine of the SAP NetWeaver Application Server and does not have to be installed separately. Installing and Updating TREX – Single Host 13 . The path to the directory is: ● ● On UNIX /usr/sap/<sapsid>/trx<instance_number> On Windows <disk_drive>:\usr\sap\<SAPSID>\TRX<instance_num ber> <TREX_DOWNLOAD> Directory for storing the downloaded TREX software package from SAP Service Marketplace SAP system directory: ● ● On UNIX /<sapmnt>/<sapsid>/SYS On Windows <disk_drive>:\usr\sap\<SAPSID>\SYS <SAP_System_Directory> <DVD_DIR> <OS> Directory under which you insert a DVD. Operating system user that you log on with to administrate TREX. Operating system user that you use to log on to the host on which the J2EE Engine is running. User <sapsid>adm User SAPService<SAPSID> User <j2eeadm> The following example shows how variables are used. For more information. Operating system user under which the TREX processes run.Search and Classification TREX April 2008 As a TREX service. Go to the directory <DVD_DIR>/UNIX/<OS>. see Connecting TREX with a Java Application (HTTP Connection) [Page 62]. Name of the operating system in a path. Naming Conventions The following naming conventions are valid for this documentation: Terminology Term TREX host TREX instance Meaning Host on which the TREX server software is installed One installation of the TREX server software Variables Variable <SAPSID> <sapsid> <TREX_DIR> Meaning System ID in uppercase letters System ID in lowercase letters Installation directory for TREX. The necessary configuration is described in this guide.

you ensure that you do not overlook any important information. When the installation step has been successfully completed. enter them in one line.ini. By doing this. place a check (! ) next to the relevant entry in the table in order to record your progress.. Then continue with the next step listed in the table. Installing and Updating TREX – Single Host 14 . Use the links to the general descriptions of actions and to additional information that will help you when executing the actions. you have to go to the directory /sapdvd1/UNIX/LINUX_64. and post-installation activities) are listed in these tables.Search and Classification TREX April 2008 If the DVD is inserted under /sapdvd1 and you are using the operating system LINUX. Checklists for the Installation Purpose Use the tables below as checklists for the installation of the system. Carry out the installation steps in the order specified in the tables. preparation. Print the relevant checklists: ○ ○ ○ ○ ○ ○ ○ Installation with HTTP Connection [Page 15] Installation with RFC Connection [Page 16] Installation with HTTP and RFC Connections [Page 18] 2. Process Flow . Commands Commands such as script calls are sometimes distributed over several lines in this documentation. All necessary installation phases (planning. follow the link to the relevant section. When carrying out an obligatory step during the installation.. Then carry out the work steps described there. Path specifications The forward slash (/) is usually used in path specifications such as <TREX_DIR>/<host_name>/sapprofile. When you execute the commands. 1. installation.

TREX Languages Installing and Updating TREX – Single Host 15 . Install TREX with SAPinst [Page 30]. Post-Installation Configuration ! Activity Start the TREX Admin Tool [Page 66] You need the TREX admin tool (stand-alone) for post-installation configuration steps. Configure TREX Proxy Settings [Page 50] If there is a proxy server between the TREX servers and the documents to be indexed. Installation ! Activity Install TREX with a Virtual Host Name [Page 42] To make your TREX installation accessible using a virtual host name you change the host name of the host on which you intend to install TREX. Check which documentation [Page 23] you need for the installation. Installation Preparations ! Activity If you want to install multiple TREX instances. Check whether there is sufficient disk space [Page 29] for installing the TREX software. Prepare the system for the SAPinst interface [Page 28].Search and Classification TREX April 2008 Installation with an HTTP Connection Server Side Installation Planning ! Activity Check the Hardware and Software Requirements [Page 20]. As of TREX 7. HTTP communication Configure the TREX Web Server [Page 48] Java applications communicate with the TREX servers using HTTP/HTTPS by means of the TREX Web server. read the information [Page 28] on this. After installing TREX.1 the TREX admin tool runs independently of the TREX servers and services. specify the proxy server and define exclusion rules if necessary. you have to configure the TREX Web server so that your Java application can access TREX. TREX starts automatically if you restart the host. If you have not restarted the host. start TREX manually (see Starting and Stopping TREX on UNIX [Page 74]). You do this before you start the TREX installation with SAPinst.

Wizard-Based Configuration Wizard-Based Basic Configuration for TREX [Page 47] The configuration wizard enables automatic configuration of the settings that are required for the application using TREX to communicate with TREX using an HTTP or RFC connection. read the information [Page 28] on this. Installation Preparations ! Activity If you want to install multiple TREX instances. Installing and Updating TREX – Single Host 16 . The SAP service for the corresponding TREX instance is registered as a Windows service and starts automatically after installation. System Landscape Directory Configure TREX for the System Landscape Directory (SLD) [Page 52] General Windows Configuration Check Performance Settings for the Operating System (Windows) [Page 55] On Windows no further actions are needed to start TREX. Prepare the system for the SAPinst interface [Page 28]. Client Side Configuration ! Activity Connecting TREX with a HTTP Application Specify the Address of the TREX Name Server [Page 62] Enter the address of the TREX name server in the Java client configuration settings (TREX service in the NetWeaver Administrator of the JEE). Installation with an RFC Connection Server Side Installation Planning ! Activity Check the Hardware and Software Requirements [Page 20]. You select languages to be identified by TREX language recognition.Search and Classification TREX April 2008 Select Languages for TREX Language Recognition [Page 51] TREX supports the indexing and analysis of documents in different languages. it may be due to the application trying to access TREX through a proxy server. Check what documentation [Page 23] you need for the installation. Check Proxy Settings [Page 50] If an application is unable to communicate with TREX.

TREX Languages Select Languages for TREX Language Recognition [Page 51] TREX supports the indexing and analysis of documents in different languages. System Landscape Directory Configure TREX for the System Landscape Directory (SLD) [Page 52] General Windows Configuration Check Performance Settings for the Operating System (Windows) [Page 55] On Windows no further actions are needed to start TREX. You select languages to be identified by TREX language recognition. start TREX manually (see Starting and Stopping TREX on UNIX [Page 74]). Determine the SAP System Connection Information [Page 59] The TREX admin tool requires connection information for the SAP system. You do this before you start the TREX installation with SAPinst. Wizard-Based Configuration Wizard-Based Basic Configuration for TREX [Page 47] The configuration wizard enables automatic configuration of the settings that are Installing and Updating TREX – Single Host 17 . The SAP service for the corresponding TREX instance is registered as a Windows service and starts automatically after installation.1 the TREX admin tool runs independently of the TREX servers and services. As of TREX 7. Connecting TREX with an ABAP Application (Configuration of the RFC Connection) Create a SAP System User for the TREX Admin Tool (Stand-Alone) [Page 57] You must create an SAP user that the TREX admin tool (stand-alone) can use to log on to the SAP system.Search and Classification TREX April 2008 Check whether there is sufficient disk space [Page 29] for installing the TREX software. You determine the information and specify it in the TREX admin tool. Post-Installation Activities ! Activity Start the TREX Admin Tool [Page 66] You need the TREX admin tool (stand-alone) for post-installation configuration steps. If you have not restarted the host. Installation ! Activity Install TREX with a Virtual Host Name [Page 42] To make your TREX installation accessible using a virtual host name you change the host name of the host on which you intend to install TREX. TREX starts automatically if you restart the host. Install TREX with SAPinst [Page 37]. Configure the RFC Connection in the TREX Admin Tool [Page 60].

As of TREX 7. Installation with HTTP and RFC Connections Server Side Installation Planning ! Activity Check the Hardware and Software Requirements [Page 20]. Installation Preparations ! Activity If you want to install multiple TREX instances. Post-Installation Configuration ! Activity Start the TREX Admin Tool [Page 66] You need the TREX admin tool (stand-alone) for post-installation configuration steps. read the information [Page 28] on this. Client Side Configuration ! Activity On the client side. no further configuration steps are required. Installation ! Activity Install TREX with a Virtual Host Name [Page 42] To make your TREX installation accessible using a virtual host name you change the host name of the host on which you intend to install TREX.1 the TREX admin tool runs independently of the TREX servers and services. TREX starts automatically if you restart the host. start TREX manually (see Starting and Stopping Installing and Updating TREX – Single Host 18 . Check which documentation [Page 23] you need for the installation. If you have not restarted the host. You do this before you start the TREX installation with SAPinst. Prepare the system for the SAPinst interface [Page 28]. Check whether there is sufficient disk space [Page 29] for installing the TREX software. Install TREX with SAPinst [Page 37].Search and Classification TREX April 2008 required for the application using TREX to communicate with TREX using an HTTP or RFC connection.

) General Windows Configuration Check Performance Settings for the Operating System (Windows) [Page 55] On Windows no further actions are needed to start TREX. If you have not restarted the host. You determine the information and specify it in the TREX admin tool. Client Side – Java Application Installation and Configuration ! Activity Connecting TREX with a HTTP Application Installing and Updating TREX – Single Host 19 . The SAP service for the corresponding TREX instance is registered as a Windows service and starts automatically after installation. you have to configure the TREX Web server so that your Java application can access TREX. Connecting TREX with an ABAP Application (Configuration of the RFC Connection) Create a SAP System User for the TREX Admin Tool (Stand-Alone) [Page 57] You must create an SAP user that the TREX admin tool (stand-alone) can use to log on to the SAP system. TREX Languages Select Languages for TREX Language Recognition [Page 51] TREX supports the indexing and analysis of documents in different languages.Search and Classification TREX TREX on UNIX [Page 74]). You select languages to be identified by TREX language recognition. Configure the RFC Connection in the TREX Admin Tool [Page 60]. start TREX manually. specify the proxy server and define exclusion rules if necessary. Determine the SAP System Connection Information [Page 59] The TREX admin tool requires connection information for the SAP system. Configure TREX Proxy Settings [Page 50] If there is a proxy server between the TREX servers and the documents to be indexed. HTTP communication Configure the TREX Web Server [Page 48] April 2008 Java applications communicate with the TREX servers using HTTP/HTTPS by means of the TREX Web server. Wizard-Based Configuration Wizard-Based Basic Configuration for TREX [Page 47] The configuration wizard enables automatic configuration of the settings that are required for the application using TREX to communicate with TREX using an HTTP or RFC connection. (See Starting and Stopping TREX on UNIX [Page 74]. System Landscape Directory Configure TREX for the System Landscape Directory (SLD) [Page 52] TREX starts automatically if you have restarted the host. After installing TREX.

Client Side – ABAP Application Configuration ! Activity On the client side. You can find the Installation Guide – SAP NetWeaver TREX Multiple Hosts on the SAP Service Marketplace at service.com/instguides..Search and Classification TREX April 2008 Specify the Address of the TREX Name Server [Page 62] Enter the address of the TREX name server in the Java client configuration settings (TREX service in NetWeaver Administrator of the JEE). On Windows.. The requirements for hardware and software listed here are valid for a TREX installation on a single host (single-server system). no further configuration steps are required. it may be due to the application trying to access TREX using a proxy server.sap. 200 MB in the directory C:\Program Files SAP system directory ○ On UNIX. Installation Planning Purpose The following sections contain information that is relevant when planning the installation. Hardware Requirements Requirement Type Hard disk capacity: Requirement ● SAPinst work directory You require the following for the installation tool SAPinst: ○ ○ ● . Hardware and Software Requirements The tables below contain the hardware and software requirements for the TREX server software. 200 MB in temporary directories or in a directory of your choice. The requirements for a distributed system that supports load balancing and high availability are listed in the guide for the installation and configuration of a distributed TREX system. On UNIX. at least 1 GB in the directory Installing and Updating TREX – Single Host 20 . Check Proxy Settings [Page 50] If an application is unable to communicate with TREX.

SAP Note 658052 contains information on which configuration is suitable for which application. ○ On Windows. and so on). If you are not using a queue server. In addition. If documents exist in different formats (Microsoft Word. PDF. ○ ● On Windows. A document set that consists only of HTML documents and has a total size of 10 GB generates an index size of 20 GB (2 x 10GB). The three directories can be located on different partitions. The index directory and queue directory can also be located on a file server. you can use TREX with or without a queue server. at least 1 GB in the directory /usr/sap/<sapsid>/trx<instance_number>. depending on the number and type of documents to be indexed.Search and Classification TREX April 2008 Requirement Type Requirement /<sapmnt>/<sapsid>/SYS. The TREX host must be able to access the file server as quickly as it can access the local hard drive. RAM ● ● Demo or test system: At least 2 GB Production system: 8 GB. the index needs approximately half as much disk space as the documents. the same amount of disk space as for the index is needed temporarily for the optimization process. Therefore. at least 1 GB in the directory <disk_drive>:\usr\sap\<SAPSID>\ TRX<instance_number> You also need disk space in this directory for the trace files that TREX writes during routine operation ● Index directory A minimum of 80 GB. TREX directory You need the following for the TREX software: ○ On UNIX. For pure HTML documents. An additional 20 GB disk space is needed temporarily for optimization. In the case of an installation with an RFC connection. at least 4 GB per CPU With two index servers per TREX instance: At least 4 CPUs Installing and Updating TREX – Single Host 21 . the queue directory is not relevant. the index needs about twice as much disk space as the documents. The documents to be indexed are kept temporarily in the queue directory before being forwarded to actually be indexed. you need 40 GB disk space altogether: 20 GB permanently and 20 GB temporarily. at least 1 GB in the directory <disk_drive>:\usr\sap\<SAPSID>\SYS. ● Queue directory The queues require approximately three quarters of the disk space required by the indexes.

and HTTP SSL in the Windows Services tool. in the case of the index server.Search and Classification TREX April 2008 Requirement Type Requirement The amount of main memory that is actually used depends on several factors. Windows: Software Requirements Requirement Type Operating system Requirement TREX supports the following Windows version: Microsoft Windows Server 2003/X64 64BIT (US English version) For security reasons. For example.com/pam. Also make sure that the IIS is running correctly.sap. For the most up-to-date information about platform and operating system availability for TREX check the Platform Availability Matrix (PAM) on SAP Service Marketplace service.4. number of parallel search requests. It is installed by the TREX setup program in the directory <TREX_DIR>\exe\Python.0 The TREX delivery does not contain the Internet Information Server (IIS). Only relevant for an installation with an HTTP connection. influencing factors are index size. You must ensure that the Internet Information Server (IIS) is installed. and amount of the number of hits. To do this navigate to Control Panel → Administrative Tools → Computer Management → Services and Application → Internet Information Services (IIS) Manager. so you have to install an IIS 6. IIS Admin Service. the supported partition installed on Windows is NTFS (NT file system) not FAT32 (file allocation table). A Python version by ActiveState is part of the delivery. Activate the World Wide Web Publishing Service. Installing and Updating TREX – Single Host 22 . Python Python 2. Web server UNIX: Software Requirements Requirement Type Operating system Requirement TREX supports one of the following UNIX version: LINUX SUSE SLES9/ X86_64 64BIT Service Pack 1 (SP1) TREX only supports LINUX distributions that have been released by SAP. Microsoft Internet Information Server (IIS) 6.0 on your TREX host before configuring the TREX Web server.

3. and is installed by the TREX setup program in the <TREX_DIR>/exe/Apache directory. Relevant SAP Notes SAP Note Number 1003900 965097 1007349 983120 845974 Title TREX 7. A Python version by ActiveState is part of the delivery.1 platforms TREX 7.1 installations Contains information about the changed platform strategy for TREX 7.1/7.com/pam. Make sure that you use the current version of the SAP Notes.sap.Search and Classification TREX April 2008 Requirement Type Requirement For the most up-to-date information about platform and operating system availability for TREX check the Platform Availability Matrix (PAM) on SAP Service Marketplace service.36: The Web server is part of the delivery.1 100 Continue within Http body response TREX WebServer (IIS) ApplicationPool disabled after recycle TREX 6. Only relevant for an installation with an HTTP connection.1: Central note TREX 7.1 releases Contains information about how to set file handles for Linux adequately Contains information about problems with TREX Java Client and TREX web server Contains information about TREX web server and IIS application pool Contains information about additional runtime libraries and patches for the TREX installation 1158215 Installing and Updating TREX – Single Host 23 . Apache Web Server 1.1: Operating System Prerequisites Comments Contains information for all TREX 7. The SAP Notes contain current installation information and corrections to the installation documentation.1: Linux Kernel Parameters HTTP/1.sap. Python Python 2. The SAP Notes can be found on the SAP Service Marketplace at service.com/notes.0/7. It is installed by the TREX setup program in the directory <TREX_DIR>/exe/Python directory.4. Web server Required Documentation You require this installation guide and the following additional documentation for the installation: ● ● ● SAP Notes on installation The SAPinst Troubleshooting guide Information available on SAP Service Market Place SAP Notes on Installation You must read the SAP Notes on installation before you begin the installation.0/7.

com/platforms service. General Quick Links Description SAP Notes Released platforms System sizing Front-end installation Security Internet Address service.Search and Classification TREX April 2008 Information Available in SAP Service Marketplace Information on the following areas is available in the SAP Service Marketplace.sap.com/security Installation Preparations Purpose The following sections describe the steps you carry out before the TREX installation.SAR to the directory.10 → <operating_system> (Linux_on_X86_64_64bit/Windows Server_on_x64_64bit) → TREX71_<Revision>... Use SAPCAR to extract the downloaded TREX software archive TREX71_<REVISION>.sap. Access the SAP Software Distribution Center on SAP Service Marketplace at http://service. Download TREX Software Package .. ● ● Installing TREX [Page 37] Updating TREX [Page 43] You use SAPCAR to extract the downloaded TREX software archives. 2..sap.com/sizing service. Installing and Updating TREX – Single Host 24 . Unpack TREX Software Packages Using SAPCAR . Download the TREX software package from the specified folder on SMP into a temporary folder on your host.com/notes service.com/swdc 2.sap.. Navigate to SAP Software Distribution Center → Download → Support Packages and Patches → Entry by Application Group → SAP NetWeaver → SAP NetWeaver → SAP NetWeaver 7.com/instguides Title – – Quick Sizer tool Front End Installation Guide – service.sap. Create a directory <TREX_DOWNLOAD> for the TREX software package. (TREX) → TREX 7. Downloading TREX Use You download the most current TREX version from SAP Service Marketplace.sap.0 (2004s) → Entry by Component → Search and Classif. 1.. 1.SAR 3. You can use the downloaded TREX software package for two purposes: .

. in which information about the TREX system instances is stored.1 for the end of 2008. The global file share will be installed only once on the host. Go to the directory in which you have downloaded or copied the archive files: ○ ○ Linux: cd /<TREX_DOWNLOAD> Windows: cd \<TREX_DOWNLOAD> 2.sap.1 installation. All instances of a TREX system must have permanent access to it. For example.1 installation on other hosts of your distributed landscape. TREX System and TREX Instances Purpose The TREX server software comprises two parts: ● ● Installation files for the TREX instance These are the TREX program files.SAR You can use the option -R to specify a specific target directory. and so on. Start SAPCAR to extract the archive to the current directory: ○ ○ Linux: <path to SAPCAR>/sapcar –xvf <file_name>. sapcar -xvf <SAR_file> -R <target_dir>. you can download the unpackaged version of the SAPCAR tool at http://service.EXE>\sapcar. During the TREX 7. By the TREX 7..1 installation the global file share functionality is currently only supported in a restricted manner.1 will be initially installed and can not be placed on other hosts. . TREX Instance and SAP System Profile Directories During the installation of the TREX system. but it can not be placed independently from the initial TREX 7.SAR Windows: <path to SAPCAR. 1.exe –xvf <file_name>. the following directories are important: Installing and Updating TREX – Single Host 25 .Search and Classification TREX April 2008 SAPCAR is installed with each SAP Web AS in the kernel directory. If you do not have access to the currently installed SAPCAR tool.1 installation the customer can not specify the path to the global file share (SAP system directory usr/sap/<sapsid>/sys). So there still is a global file share for the TREX 7. TREX is developing the unrestricted global file share functionality for TREX 7. Global file system This is a directory structure. where TREX 7. The global file system must be highly available. configuration files. The global file share basically consists of the SAP system directory usr/sap/<sapsid>/sys. Directories in the archive are created as subdirectories of the target directory to retain the directory structure of the archive.com/patches → Entry by Application Group → Additional Components → SAPCAR. this information is required by management tools to start the TREX system. for instance.

both a TREX instances and a global file systems will be installed on your local host.. the global file system together with the first TREX instance on the one hand and the newly-installed TREX instance on the other hand form a unit from an Installing and Updating TREX – Single Host 26 . profile\ Global File System / SAP System Directory SAP Profile Directory – DEFAULT..Search and Classification TREX ● April 2008 SAP system profile directory in the global file system: ○ ○ On UNIX /<SAP System Mount Directory>/<sapsid>/SYS/profile On Windows <SAPGLOBALHOST>\sapmnt\<SAPSID>\SYS\profile ● Installation directory for the TREX instance: ○ ○ On UNIX /usr/sap/<sapsid>/trx<instance_number> On Windows <disk_drive>:\usr\sap\<SAPSID>\TRX<instance_number> Installation Procedure During the TREX installation. when you chose the installation option Install a TREX system..0 installation you can not decide where the global file system should be stored.PFL – <SAPSID>_TRX<instance_number>_<host> TRX<instance_number>\ . In this case. exe\python_support\ <trex_hostname>\ index\ queue\ TREX Instance/ <TREX_DIR> Additional TREX Instance An additional TREX instance consists of a TREX instance without a global file system on the local host.. see Installing TREX [Page 37] TREX System A TREX system consists of the installation of a TREX instance together with a global file system on the a local host where you initially install TREX. Basic information about a TREX landscape is stored in the directory for the SAP system profiles. Differing from the TREX 7. Directory structure and files On Windows the TREX installation creates a directory structure and SAP system profiles as shown in the graphic below: Folder Structure on TREX Single Host (Global File System and TREX Instance) usr\sap\<SAPSID>\ SYS\ . For details of TREX installation screens and procedures.

. <trex_hostname>/ . profile/ – DEFAULT. profile/ TRX<instance_number>/ exe/python_support/ <trex_hostname>/ index/ queue/ index/ queue/ TREX Instance # 2 usr\sap\<SAPSID>\ TRX<instance_number>\ exe/python_support/ .. <trex_hostname>/ index/ queue/ Global File System (SAP System Directory) You have to ensure that the global file system (SAP system directory usr/sap/<sapsid>/sys) is highly available and accessible for all TREX instances at all times.. Directory structure and files On Windows the installation creates directory structures as illustrated in the graphic below: Folder Structure on Global File system usr/sap/<SAPSID>/ SYS/ . For more information. You install an additional TREX instance by means of a TREX script.PFL – <SAPSID>_TRX<instance_number>_<host> Installing and Updating TREX – Single Host 27 .. This is visible in that they both have the same system ID (<SAPSID>) and use the same global file system...Search and Classification TREX April 2008 administration perspective. see Installing an additional TREX Instance [Page 41] Directory structure and files On Windows the installation creates directory structures as illustrated in the graphic below: TREX Instance # 1 First TREX Instance and Global File System usr/sap/<SAPSID>/ SYS/ usr\sap\<SAPSID>\ TRX<instance_number>\ exe/python_support/ ...

Preparing the System for SAPinst GUI Use You need to prepare your system for SAPinst.PFL The system profile contains settings and information that are important throughout the system. the system automatically generates an instance profile for the TREX instances installed. The TREX setup program ensures this by including the instance number in the directory name. The installation tool SAPinst uses the Java-based graphical user interface SAPinst GUI. The following configuration is required for this: ● Microsoft IIS 6. Each instance must be installed in its own directory. the system creates the following profiles: ● System profile DEFAULT. Information on Installing Multiple TREX Instances You can install several independent TREX instances on the same host.0: There must be a separate Web service extension for each instance. ● Instance profile <SAPSID>_TRX<instance_number>_<host> The instance profile contains specific information about the runtime environment for a TREX instance. The system profile exists once only in the global file system. This includes the installation of a Java Runtime Environment (JRE). In the SAP system profiles directory. Each instance must use a different port. The TREX setup program suggests suitable ports so that they do not clash with other TREX instances on the same host. Preparing the system for SAPinst GUI consists of checking your Java Runtime Environment (JRE) because the JRE could not be integrated in the SAPinst GUI executable due to licensing issues. After the installation (HTTP connection) If you are installing TREX on Windows. which is required both for SAPinst and the SAPinst GUI. The configuration steps are described in this guide.Search and Classification TREX April 2008 SAP System Profiles for the Global File System During installation of a TREX system the central directory for the SAP system profiles will be created as part of the global file system (SAP system directory). Depending on the entries made during installation. Each TREX Web site must also use its own application pool. Installing and Updating TREX – Single Host 28 . System profiles contain information about the configuration of individual SAP instances. This is useful for test purposes. Note the following: During the setup ● ● ● Give each instance a different instance number. you must make sure that the Web pages of the individual instances run independently of one another.

see Starting SAPinst on the Remote Host (Optional) [Page 68].source=file:/dev/random with securerandom.4. In this case. For additional information about the recommended JRE version. JRE is part of the JDK (Java Development Kit). Make sure a valid JRE version is installed. If necessary you need to download and install the required version. you need at least a JRE on the local host to start the SAPinst GUI there. UNIX/Linux only: If you use a Sun Java VM.Search and Classification TREX April 2008 If required. replacing entry securerandom. Check the JRE versions that are released for SAP systems on the SAP Service Marketplace at: service. you need to download and install it. JRE is not part of the SAP shipment. Checking Disk Space Use SAPinst creates the installation directory for the TREX software in the following directory: ● ● Windows – <disk_drive>:\usr\sap\<SAPSID> UNIX – /usr/sap/<sapsid> Installing and Updating TREX – Single Host 29 . controlling it with the SAPinst GUI from a local host. ○ If JRE is already installed: Check the installed version of JRE by entering: java -version SAPinst checks the environment variable SAPINST_JRE_HOME for a valid Java Runtime Environment. see SAP Note 709140. Platform All platforms Required JRE for the SAPinst GUI The required JRE is 1.. you have to edit the configuration file $JAVA_HOME/jre/lib/security/java. This lets you perform the installation on a remote host. SAPinst also checks JAVA_HOME. You have to check that there is of a released Java Runtime Environment (JRE) on the host on which SAPinst GUI should run. as follows: ○ If JRE is not already installed: Since JRE is not part of the SAP shipment.sap.com/pam → SAP NetWeaver → SAP NetWeaver → JSE Platforms 2. 1. If SAPINST_JRE_HOME is not found.source=file:/dev/urandom . If you want to perform a remote installation. you can perform a remote installation using a stand-alone SAPinst GUI on a separate Windows or UNIX host. Procedure .2 or higher..security.

It describes an installation where SAPinst GUI and SAPinst server are running on the same host. proceed as follows: . select a partition that has sufficient disk space for the TREX software and other SAP software if necessary. Generate a symbolic link to the directory sap in the directory /usr.Search and Classification TREX April 2008 Before the installation starts.. SAPinst GUI is running on another host. Procedure on UNIX Starting Point The directory /usr does not yet exist. The directory /usr/sap already exists. Installing with SAPinst Use This following sections tell you how to run SAPinst to install TREX on the released platforms. that is. ● Create the directory sap in a file system that has sufficient disk space. If there is not enough disk space. Procedure on Windows On Windows you can choose the target drive during the installation. Use the Windows Explorer to check whether there is sufficient disk space on the target drive. For information on the required disk space. Create the installation directory in a file system that has sufficient disk space. df –k . 1. Generate a symbolic link to the installation directory in the directory /usr/sap. Procedure For the directory /usr. but the directory /usr/sap does not.. If you want to perform a remote installation. see Starting SAPinst on the Remote Host (Optional) [Page 68]. <instance_number> must match the instance number that you specified during the installation. Choose one of the following options: ● Create a new partition with sufficient disk space for the directory sap. Go to the directory /usr/sap and check the amount of free disk space by executing the following command. make sure that there is enough disk space in this directory for the TREX software. Insert the directory sap into the directory /usr. You must assign the installation directory the name trx<instance_number>. Installing and Updating TREX – Single Host 30 . The directory /usr exists. see Hardware and Software Requirements [Page 20]. Installation and Update Purpose The sections that follow describe how to install and update TREX with SAPinst and tell you which entries are required during the setup. 2.

TMP. SAPinst uses /tmp as default installation directory. UNIX: If required. Windows: SAPinst creates a subdirectory for each installation service. do one of the following: ○ ○ ● Right-click the icon for the SAPinst output window located in the Windows tray and choose Exit. TMPDIR. which might be useful if an error occurs. you can terminate SAPinst and the SAPinst Self-Extractor by pressing Ctrl+C. and which is located directly below the Program Files directory. SAPinst tries to create sapinst_instdir in the directory defined by the environment variable TEMP. If SAPinst is not able to create sapinst_instdir directly below the Program Files directory. Directories with the name sapinst_exe. In the temporary directory you can also find the SAPinst Self-Extractor log file dev_selfex. The exact name of the subdirectory depends on the installation service chosen by you. ● Windows: If you want to terminate SAPinst and the SAPinst Self-Extractor.xxxxxx. SAPinst GUI connects via a secure SSL connection to the GUI server and the GUI server connects to SAPinst. The SAPinst Self-Extractor extracts the executables to a temporary directory (TEMP. Before you start the installation with the command sapinst make sure that all moint-points (UNIX) or network drives (Windows) are accessible.out. Click the icon for the SAPinst output window located in the Windows tray and choose File Exit. SAPinst normally creates the installation directory sapinst_instdir where it keeps its log files. These executables are deleted after SAPinst has stopped running. named <sapinst_instdir>\<installation_service> which is located below %ProgramFiles%\sapinst_instdir. or TMPDIR. TMP. or SystemRoot). If this does not work you may have to temporarily unmount the unaccessible mount points or mapped network drives. UNIX: SAPinst normally creates the installation directory sapinst_instdir directly below the temporary directory. the installation terminates with the error FCO-00058. ● ● ● ● ● ● If SAPinst cannot find a temporary directory. SAPinst finds the temporary directory by checking the value of the environment variables TEMP.xxxx sometimes remain in the temporary directory. SAPinst GUI and the GUI server also start. If no value is set for these variables. You can safely delete them. Procedure You now can start the installation with SAPinst: ● Installing with SAPinst on UNIX [Page 32] Installing and Updating TREX – Single Host 31 .Search and Classification TREX April 2008 Note the following about SAPinst: ● When you start SAPinst.

Search and Classification TREX ● April 2008 Installing with SAPinst on Windows [Page 35] Installing with SAPinst on UNIX This procedure tells you how to run SAPinst to install TREX on UNIX.out in the temporary directory. the installation terminates with the error FCO-00058. make sure that the SAPINST_JRE_HOME environment variable <UNIX: for user root> is set to the valid <JAVA_HOME> directory. delete any directories with the name sapinst_exe.xxxx after SAPinst has finished. Installing and Updating TREX – Single Host 32 . where <host_name> is the host on which the SAPinst GUI will be displayed. If you cannot provide 200 MB free space in the temporary directory. If SAPinst cannot find a temporary directory. SAPinst uses /tmp as default directory.0. you can terminate SAPinst and the SAPinst Self-Extractor by pressing Ctrl+C. TMP. or TMPDIR point. If you have more than one Java Virtual Machine (JVM) installed on your system (for example. In addition. ● ● ● Make sure that your DISPLAY environment variable is set to <host_name>:0. TEMP. SAPinst normally creates the installation directory sapinst_instdir directly below the temporary directory. TMPDIR or /tmp. you need 200MB free space for the SAPinst executables. The SAPinst Self-Extractor extracts the SAPinst executables to the temporary directory. TMP. If there are errors with SAPinst. If no value is set for these variables. These executables are deleted again after SAPinst has stopped running. TMP. you can find the Self-Extractor log file dev_selfex. or TMPDIR to another directory with 200 MB free space for the SAPinst executables. or TMPDIR. If required.xxxxxx. Prerequisites ● Make sure that your operating system does not delete the contents of the temporary directory /tmp or the contents of the directories to which the variables TEMP. for example by using a crontab entry. If required. TMP. ● Make sure that you have at least 60 MB of free space in the installation directory for each Java installation service. Each SAP instance requires a separate installation directory. Sometimes these remain in the temporary directory. SAPinst finds the temporary directory by checking the value of the environment variables TEMP. you have two JREs with different versions installed). ● Make sure that your SAPINST_JRE_HOME environment variable is set to a valid Java Runtime Environment (JRE). you can set one of the environment variables TEMP.

3. ○ Installing TREX by software package You install TREX using the TREX software package that can be downloaded from SAP Service Marketplace. If you want to install a central instance.. For example. 1. or a standalone gateway instance. You can start SAPInst and install TREX in the following way: ○ Start SAPinst from the Installation Master DVD You start SAPinst from the Installation Master DVD and install TREX thereafter using the CD containing the TREX installation files that will be part of the SAP NetWeaver delivery. Procedure . or TMPDIR point.. mount the Presentation DVD and replace “ Installation Master DVD” with “Presentation DVD” in this section. 2. Make sure that the root user has not set any environment variables for a different SAP system or database. In this case. the following constellation causes an error: $ cd /sapcd2/IM_HPUX_IA64 $ /sapcd2/IM_HPUX_PARISC/sapinst The correct constellation is as follows: $ cd /sapcd2/IM_HPUX_PARISC Installing and Updating TREX – Single Host 33 ./sapinst Make sure that your operating system does not delete the contents of the temporary directory /tmp or the contents of the directories to which the variables TEMP. a dialog instance. TMP. For details see Installing TREX [Page 37] and Downloading TREX [Page 24]) ○ Start SAPinst from the Installation Master DVD in one of the following ways: ■ Using the default installation directory (recommended) Enter the following commands: cd <Installation Master_DVD>/IM_<OS> . mount the Installation Master DVD. Log on to the installation host as root. a database instance. by using a crontab entry. for example. Make sure that your current working directory is not an IM_<OS> directory belonging to another operating system. Start SAPinst for installing TREX.Search and Classification TREX April 2008 We recommend that you keep all installation directories until you are fully satisfied that the system is completely and correctly installed. You can also install a gateway instance from the SAP Presentation DVD.

xxxxxx. i. For a list of all available SAPinst properties. log off and log on again. Follow the instructions in the SAPinst input dialogs and enter the required parameters. The GUI server uses port 21212 to communicate with SAPinst GUI.Search and Classification TREX $ /sapcd2/IM_HPUX_PARISC/sapinst April 2008 ■ Using an alternative installation directory. SAPinst GUI normally starts automatically by displaying the Welcome screen. which has been created by SAPCAR. ii. If SAPinst prompts you to log off from your system.xxxx after SAPinst has finished. the default ports 21200 and 21212 are used for communication between SAPinst. GUI server. SAPinst directly displays the first input dialog without presenting the Welcome screen. choose the respective path. To find more information about each parameter during the input phase of the installation. TMP. the screen Finished installation is displayed. Change to the directory <TREX_DOWNLOAD>/ ims_sapinst_standalone_trex/ <OS_DIR>. if there is only one component to install. position the cursor on the field of the respective parameter and choose F1. If required. In the screen Welcome to SAP Installation Master. you must execute sapinst using the following parameters: SAPINST_DIALOG_PORT=<free_port_number_sapinst_gui_to_gui_ser ver> GUISERVER_DIALOG_PORT=<free_port_number_gui_server_to_sapins t_gui>. If the installation was successful. set the environment variable TEMP./sapinst 4. SAPinst uses port 21200 to communicate with the GUI server. 8. Start SAPinst from this directory by entering the command cd <TREX_DOWNLOAD>/ims_sapinst_standalone_trex/ <OS_DIR> . During the installation. However. 7. 6. enter the following command: sapinst -p. SAPinst starts the installation and displays the installation progress during the processing phase. Installing and Updating TREX – Single Host 34 . If you want to use an alternative installation directory. delete directories with the name sapinst_exe. The respective paths and necessary input parameters are listed in the section Installing TREX [Page 37] 5. ○ Start SAPinst from the downloaded TREX software package (see Downloading TREX [Page 24]). In this case. Sometimes these remain in the temporary directory. You get an error message if one of these ports is already in use by another service. and SAPinst GUI. or TMPDIR. After you have maintained all input parameters.

Do not use any <sapsid>adm user for installing TREX. and at least 130 MB of free space in the installation directory for each Java installation service. We recommend that you to delete all files in the directory <user_home>/. This means. see Troubleshooting During the Installation [Page 77]. In addition. In addition. Installing and Updating TREX – Single Host 35 . ■ ABAP: You need at least 50 MB of free space in the installation directory for each ABAP installation service. In addition. see Granting User Rights for the Installation.Search and Classification TREX April 2008 If there are errors with SAPinst Self-Extractor. do not use the <sapsid>adm user of another SAP System and do not use the <sapsid>adm user of an already existing TREX installation for installing TREX. you can delete these files when the installation has successfully completed. make sure that the database is up and running before starting the installation. We recommend that you keep all installation directories until you are sure that the system is completely and correctly installed. you need 60-200 MB free space for the SAPinst executables. ● We recommend that you keep all installation directories until the system is completely and correctly installed. Each SAP instance requires a separate installation directory. Log on to the installation host as a user with administrator rights. If you have copied installation DVDs to your hard disk. you need 60-200 MB free space for the SAPinst executables. you need 60-200 MB free space for the SAPinst executables.. ■ ■ ■ Procedure .sdtgui/. you can find the self-extractor log file dev_selfex. If you are installing a second or subsequent SAP system on an existing database. Java: You need at least 130 MB of free space in the installation directory for each Java installation service. For more information. Installing with SAPinst on Windows This procedure tells you how to run SAPinst to install TREX on Windows.. Prerequisites ● You are logged on as user with the required rights and privileges that authorize you to install the SAPinst tool and the SAP system. If errors occur during the installation. ABAP+Java: You need at least 50 MB of free space in the installation directory for each ABAP installation service.out in the temporary directory. 9. 1.

When the installation was successful. . Installing and Updating TREX – Single Host 36 . Start SAPinst for installing TREX.exe.. (For details see Installing TREX [Page 37] and Downloading TREX [Page 24]). GUI server. log off and log on again. Double click sapinst. choose the respective path. Start SAPinst and install TREX by software package. 4. position the cursor on the field of the respective parameter and choose F1.. Follow the instructions in the SAPinst input dialogs and enter the required parameters. you must execute sapinst using the following parameters: SAPINST_DIALOG_PORT=<free_port_number_sapinst_gui_to_gui_server> GUISERVER_DIALOG_PORT=<free_port_number_gui_server_to_sapinst_gui >. if there is only one component to install. SAPinst directly displays the first input dialog without the Welcome screen. i. In the screen Welcome to SAP Installation Master. ii. If SAPinst prompts you to log off from your system. SAPinst GUI normally starts automatically by displaying the Welcome screen. In this case. Start SAPinst from the directory <TREX_DOWNLOAD>/ ims_sapinst_standalone_trex/ <OS_DIR> by double clicking sapinst. After you have entered all required input parameters. SAPinst starts the installation and displays the installation progress during the processing phase. 6. and SAPinst GUI. the default ports 21200 and 21212 are used for communication between SAPinst. However. The GUI server uses port 21212 to communicate with SAPinst GUI. During the installation. For a list of all available SAPinst properties. enter the following command: sapinst -p. the screen Finished installation is displayed. ii. The respective paths and necessary input parameters are listed in the section Installing TREX [Page 37]. ○ Insert the SAP Installation Master DVD with the installation files in your DVD drive or mount it locally. 5. You can start SAPInst and install TREX in the following way: ○ Start SAPinst from the Installation Master DVD. To find more information about each parameter during the input phase of the installation.exe from <DVD_DRIVE>:\IM_WINDOWS_<platform>. You install TREX using the TREX software package that can be downloaded from SAP Service Marketplace. 3. SAPinst uses port 21200 to communicate with the GUI server. You get an error message if one of these ports is already in use by another service.Search and Classification TREX 2. Change to the directory <TREX_DOWNLOAD>/ ims_sapinst_standalone_trex/<OS_DIR>. i. which has been created by SAPCAR. April 2008 You start SAPinst from the Installation Master DVD and install TREX thereafter using the CD containing the TREX installation files that will be part of the SAP NetWeaver delivery.

the installation continues while you are logged off. Handling SAPinst GUI Use The following push buttons are available on the different SAPinst GUI dialogs (input screens. You can continue the installation later from this point. If errors occur during the installation. installation progress screen. Log Off Stops the SAPinst GUI. If for some reason you need to log off during the installation from the host where you control the installation with SAPinst GUI. see Troubleshooting during the installation [Page 77]. For more information on running SAPinst GUI standalone. when restarting SAPinst. Cancels the installation with the following options: ● Stop Stops the installation without further changing the installation files. You can later reconnect to the same SAPinst installation from the same or another host. ● Continue Continues the installation. For more information. but SAPinst and the GUI server continue running.sdtgui/.Search and Classification TREX April 2008 We recommend that you to delete all files in the directory <user_home>/. Installing TREX You can initially install TREX in the following way: ● Installing TREX by CD You install TREX using the CD containing the TREX installation files that will be part of the SAP NetWeaver delivery. You can continue the installation later from this point. message box): Push Button/ Function Key F1 Exit Meaning Displays detailed information about each input parameter. ● Installing TREX by software package Installing and Updating TREX – Single Host 37 . see Starting SAPinst GUI Standalone [Page 67] Retry Stop Continue Performs the installation step again (if an error has occurred). Continues with the option you have chosen before. Stops the installation without further changing the installation files.

3. To do this. which you perform as the root user (UNIX) or as a user with administration rights (Windows). Screen Welcome to SAP Installation Input .. a Python error message can occur during installation. 2. see TREX Global File System and TREX Instances [Page 25]. For more information about the directories that the installation creates.0 → Initial Installation Tasks → Standalone Engines → Search and Classification (TREX) → TREX Installation The screen DVD/CD Browser > Software Package Request appears. the screen Welcome to SAP installation Master appears. . the operating system user <SAPSID>adm is created. In the folder hierarchy. 1. Installing TREX by CD You install TREX using the CD containing the TREX installation files that will be part of the SAP NetWeaver delivery. DVD/CD Browser > Software Package Request 1. After SAPinst starts.. The required input is the same for both installations... The tables below show the names of the screens that are displayed during the installation of TREX and the entries that you need to make. you can copy the CD to your local hard-drive. make sure that the user <SAPSID>adm has at least read-access to the TREX installation CD.Search and Classification TREX April 2008 You install TREX using the TREX software package that can be downloaded from SAP Service Marketplace (see Downloading TREX [Page 24]). During the TREX installation. For all operating systems. Package Location Specify the path to the CD containing the TREX installation files. Insert the CD containing the TREX installation files (Windows) or mount the CD (UNIX). specify in CopyPackageTo the path to the directory to which you want to copy the files on the TREX installation CD. Choose Next.. Otherwise. . Installing and Updating TREX – Single Host 38 . Both installation procedures only differ in the way you navigate through the initial screens. choose SAP NetWeaver 7. Choose Next. 2.. If the <SAPSID>adm user does not have at least read-access for the CD containing the TREX installation files. TREX Installation Confirm the installation of TREX Search and Classification Choose Next to continue.

SAPinst checks whether the installation directory already exists. . Otherwise an error message appears.. SAP System > General Parameters 1.Search and Classification TREX April 2008 Installing TREX by TREX Software Package You install TREX using the TREX software package that can be downloaded from SAP Service Marketplace (see Downloading TREX [Page 24]). Choose Next. In the folder hierarchy. TREX Installation Input Screens for Installing TREX The installation procedures for installing TREX by CD and by software package only differ in the way you navigate through the initial screens... . The required input is the same for both installations. After SAPinst starts.. 1. choose SAP NetWeaver 7. When you choose a system ID <SAPSID> for your TREX landscape check which system IDs are already in use by other SAP applications on the same host where TREX is to be installed. 3. the system suggests the next available number. 2. 2. The SAP system ID consists of three characters and must begin with a capital letter. If instances have already been installed. The directory is: ○ On UNIX /usr/sap/<SAPSID>/trx<instance_number> Installing and Updating TREX – Single Host 39 .. If not. The instance number must be unique on the host. Destination Drive (Windows Only) Choose the drive on which the TREX software is to be installed. SAP System ID (SAPSID) Enter an SAP system ID <SID>. the screen Welcome to SAP Installation Master appears. If several instances of a piece of SAP software are running on the same host (TREX instances or instances of other SAP systems) they must have different instance numbers. Do not use a system ID <SAPSID> that is already assigned to another SAP system landscape for your TREX installation and landscape. Instance Number Enter an instance number for the TREX instance that you are installing.. Note the following: ○ ○ You can choose any number between 00 and 98.0 TREX Search and Classification → Installation TREX global → Install a TREX System The screen TREX Installation appears. it creates it. Choose Next. Screen Welcome to SAP Installation Master Input . after that it can contain numbers.

1. enter the Windows domain in which the user accounts for the SAP system have been created: ○ Local Installation You choose this setting if you are installing TREX locally on a host. You must note that.. a. You can choose a different value for each password by Installing and Updating TREX – Single Host 40 . Master Password . you must have domain administrator rights in order to be able to create the required operating system users. .. 4. In SAP System User Domain → Domain Model. . This allows you to ensure that the directory does not contain any data that does not belong to TREX. ○ Use Different Domain You choose this setting if you are installing TREX in a different Windows domain to that of the current user. Depending on your installation scenario. Confirm Specifies one password for both SAP system administrator and SAP system service user.. ○ Use Domain for Current User You choose this setting if you are installing TREX in the Windows domain of the current user. which would then also be deleted if TREX were uninstalled. there might be more restrictions. The directory should not be available before the installation unless you explicitly created it for space reasons previously (see Checking Disk Space [Page 29]). The password is used for all accounts. SAP System > Windows Domain and Master Password 1. Choose Next. SAP System User Domain (Windows Only) The entries for an SAP system user domain are not required on UNIX.Search and Classification TREX April 2008 ○ On Windows <disk_drive>:\usr\sap\<SAPSID>\TRX<instance_n umber> The path to the directory is fixed and cannot be changed (apart from the Windows disk drive). Password for all users of this SAP system b.. The password must be 8-14 characters long. that SAPinst creates and for the secure store key phrase. in both cases involving installation in a Windows domain...

choose Next. The TREX system (first TREX instance together with the global file system (SAP system directory)) on the one hand and the newly-installed TREX instance on the other hand form a unit from an administration perspective.sh (UNIX). Parameter Summary SAPinst displays all settings before you start the installation procedure: The settings you have chosen and the default configuration settings automatically filled by SAPinst. All instances of a TREX system must have permanent access to it.cmd (Windows) or instance. Log in as root (UNIX) or local administrator (Windows) on the host where the additional TREX instance shall be installed and open a command prompt. The script is located in the following directory ○ ○ On UNIX /<SAP System Mount Directory>/<sapsid>/SYS/global/ trex/install On Windows <SAPGLOBALHOST>\sapmnt\<SAPSID>\SYS\global\ trex\install This directory is part of the global file system (SAP system directory) usr\sap\<SAPSID>\SYS. This is visible in that they both have the same system ID (<SAPSID>) and use the same global file system. 2. If you already set one password to a different value and the change the master password in this dialog.Search and Classification TREX April 2008 choosing to edit the relevant parameter section on the summary screen. To start the installation with the selected parameters.. 1. Choose Next. SAPinst goes back to the installation screen where you can enter the specific settings you want to change. The global file system must be accessible from all hosts on which you intend to install additional TREX instances.. Procedure . Prerequisites You have mounted (UNIX) or shared (Windows) the directory <SAPSID>\SYS\global\trex\install on the host where you intend to install the additional TREX instance so that the directory is accessible from this host. You will find this script on the host where you initially have installed TREX with SAPinst. Installing and Updating TREX – Single Host 41 . Installing an additional TREX Instance Use You install an additional TREX instance by means of the TREX script addinstance. ... 1. In this case. which must be highly available. 2. You can check the settings and choose Revise to change any of them if necessary. the individually set passwords are NOT overwritten with the new master password.

Open a command prompt and execute the following commands: ○ ○ UNIX . 1.\<SAPSID>\SYS\global\trex\install which is located on the host where you have installed TREX initially. .. Install TREX as described in the TREX Installation Guide (Single Host). Prerequisites The virtual host name must be valid at the operating system level and in the network the host is a part of. Stop TREX if necessary (incl. 3. sapstartsrv) Installing and Updating TREX – Single Host 42 .. It can be a new primary host name.com/instguides. 3.. You find the TREX Installation Guide (Single Host) on SAP Service Marketplace service. You do not need to do additional configuration steps. On UNIX you have to mount this directory manually..Search and Classification TREX April 2008 2.. Execute the script addInstance. The host must be accessible with this name using the ping command.cmd (Windows) or instance... or it’s IP address.sap.sh (UNIX) in this directory. Installing TREX with a Virtual Host Name Use You install TREX with a virtual host name by SAPinst. Only then TREX can monitor itself and can be used by other applications. You start SAPinst from the installation master DVD or from the directory of the downloaded TREX software package. . Procedure .. The script will automatically do the following: • • • • • • • Creating a directory structure for SAPSID and TREX instance Creating a <SAPSID>adm user Configuring the SAP system Deploying binaries Creating host configuration Registering with TREX Landscape Registering Service sapstartsrv and starting TREX Result After executing the script an additional TREX instance was installed on the host.. . an additional alias name.exe SAPINST_USE_HOSTNAME=<virtual_hostname> 2./sapinst SAPINST_USE_HOSTNAME=<virtual_hostname> Windows: sapinst. Navigate to the directory \..

which has been created by SAPCAR. Do not use the <SAPSID>adm user of another SAP system for updating a TREX system. In a distributed scenario. you download the TREX Revision update from the SP stack download page as described in section Downloading TREX [Page 24] in order to get the TREX update packages appropriate to the corresponding SP stack. Mixed installations with different TREX releases are not supported.XX..10. ● Procedure . 2. refer to the TREX admin tool Landscape → Hosts → Version to find the version of your TREX installation (see Starting the TREX Admin Tool [Page 66]). 1. all other TREX instances of the TREX system are updated automatically by replicating the updated binaries. you have to perform the update on the TREX host on which the TREX global file system is installed.. The TREX instance on this host is to be updated first. If you do not have TREX installed at all. Before starting the update.10 from scratch as described in this guide in section Installation and Update [Page 30]. Change to the directory <TREX_DOWNLOAD>/ims_sapinst_standalone_trex/<OS_DIR>. Otherwise those TREX instances would change the TREX configuration file toplogy. Start SAPinst from the directory <TREX_DOWNLOAD>/ims_sapinst_standalone_trex/ <OS_DIR>: Installing and Updating TREX – Single Host 43 . you have to close the TREX Admintool. With the restart of TREX after the update.Search and Classification TREX April 2008 As long as the host name is changed to the virtual host name do not start or stop any other TREX instances. The TREX Revision numbers no longer follow the SP stacks. Nevertheless. all TREX systems must have the same TREX release with the same patch level. 3. Updating TREX Use The update software package of TREX is named TREX Revision.ini so that the instances will be registered with the virtual host name there.10 release (Version 7. Log on to the host on which you want to apply the TREX update package as user <SAPSID>adm. For a distributed TREX system.XX) : ● If you have already installed TREX. install TREX 7. Prerequisites You have installed at least one previous TREX 7.

choose Next. choose SAP NetWeaver 7. After the update finishes successfully. You can check the settings and choose Revise to change any of them if necessary. To start the update with the selected parameters.0 TREX Search and Classification → Installation TREX global → Update a TREX system The screen TREX Update appears. In this case. you can restart TREX by means of the TREX Admintool if you have not chosen the option Restart the TREX landscape after update. Tass Progress When you have entered all input parameters.Search and Classification TREX ○ April 2008 UNIX: Entering the command cd <TREX_DOWNLOAD>/ims_sapinst_standalone_trex/<OS_DIR> .. all TREX instances of a distributed TREX system landscape are updated automatically by replication of the updated binaries. 2.. Parameter Summary SAPinst displays all settings you have chosen before you start the update procedure: .. SAPinst goes back to the installation screen where you can enter the specific settings you want to change. ● Password of SAP System Administrator: If the checkbox for restarting the TREX system is checked you have to specify the password of the SAP System Administrator to perform the TREX restart operation. In the folder hierarchy. Choose Next.exe in the directory <TREX_DOWNLOAD>/ims_sapinst_standalone_trex/<OS_DIR> ○ After SAPinst starts he screen Welcome to SAP Installation Master appears: Screen Welcome to SAP Installation Master Input . ● Restart TREX landscape after update: If you activate the check box the TREX system will be restarted after the completion of the update process. Update Parameter ● System to update: In the input field the TREX systems you can choose for update are displayed. 1. Finished Successfully Installing and Updating TREX – Single Host 44 . SAPinst displays the message The installation/update finished successfully./sapinst Windows: Double clicking sapinst. Choose Next. TREX Update Update > TREX System 1. After you restart TREX. If the update is successful. Choose the TREX system you intend to update. 2.. SAPinst starts the update and displays the update progress during the processing phase.

1. For Windows Server 2003 choose Start → Administrative Tools → Internet Information Services (IIS) Manager → Application Pools AppPool_TREX_<number> and restart the service. 2. Make sure that all of the TREX processes have stopped before you start the uninstallation process. see Installing with SAPinst [Page 37].. ○ ○ If you are installing from the DVD. all indexes and queues are deleted. For an installation with an HTTP connection: Check that the Web server (HTTP daemon) has stopped. Procedure on UNIX . mount the DVD containing the installation files first. 1. <host_name> is the host on which the SAPinst GUI is to be displayed. see Installing with SAPinst [Page 37]. Result Your TREX installation has been successfully updated. If you are installing from the SAP Service Marketplace. It can take a while to stop the TREX processes. For a detailed description of these steps.Search and Classification TREX April 2008 In some cases you may have to restart the Application Pool of the MS Internet Information Server. Start SAPinst... Stop TREX (see Starting and Stopping TREX [Page 69]). the entire TREX directory is deleted. ○ ○ If you are installing from the DVD. including all configuration data. Uninstalling TREX Use You can uninstall your TREX systems using SAPinst. If you are installing from the SAP Service Marketplace. Log on as an administrator. Make sure that the environment variable DISPLAY has been set for root on <host_name>. Start SAPinst. Installing and Updating TREX – Single Host 45 . mount the DVD containing the installation files first. If the index directory and queue directory are located in the TREX directory. You can use the following command to do this: ps –fu trx<instance_number> | grep httpd 3. Log on as root. 2. For a detailed description of these steps. 4. When you uninstall TREX. Procedure on Windows . navigate to the corresponding directory.. navigate to the corresponding directory.

Finished Successful< Result You have successfully removed all TREX instances for your TREX system. You can check the settings and choose Revise to change any of them if necessary.. choose Next. If the update is successful.0 TREX Search and Classification → Installation TREX global → Remove a TREX system. To start the update with the selected parameters.. SAPinst displays the message The installation/update finished successfully. 1. 2. TREX Basic Configuration The TREX basic configuration comprises the following areas: ● Wizard-Based Basic Configuration for TREX [Page 47] The configuration wizard enables the automatic configuration of the settings that are required if the application using TREX communicates with TREX using an HTTP or RFC connection. TREX Removal ● System to remove In the input field the TREX systems you can remove are displayed. In the folder hierarchy. SAPinst goes back to the installation screen where you can enter the specific settings you want to change. ● Remove the users of this TREX system: If you activate the check box all system users of this the TREX system will be deleted. Choose Next. Choose the TREX system you intend to remove. SAPinst starts the uninstalling process and displays the progress during the processing phase. The screen TREX Removal appears. ● Connecting TREX with an Application [Page 56] Installing and Updating TREX – Single Host 46 ..Search and Classification TREX April 2008 Input screens for uninstalling TREX After SAPinst starts. ● TREX Post-Installation Configuration [Page 48] After installing TREX. choose SAP NetWeaver 7. 1.. Screen Welcome to SAP Installation Master Input . In this case. you carry out various technical configuration steps that are required so that TREX runs correctly with the standard configuration on a single-host system and so that it can be used by an SAP application. the screen Welcome to SAP installation Master appears. Parameter Summary SAPinst displays all settings you have chosen before you start the removal procedure: . 2. Task Progress When you have entered all input parameters.

You can also carry out the configuration steps of the wizardbased configuration manually. There are therefore two procedures for connecting TREX with the application using it: ○ ○ Connecting TREX with a Java Application (HTTP Connection) [Page 62] Connecting TREX with an ABAP Application (RFC Connection) [Page 57] Wizard-Based Basic Configuration for TREX Use The configuration wizard enables the automatic configuration of the settings that are required so that the application using TREX can communicate with TREX using an HTTP connection. the Usage Type Overview – Selection of Configuration Flavors screen appears. Select Connect TREX in Further configuration tasks. Only execute template-based configuration if you have not configured TREX previously. see the following documentation: ● Connecting TREX with an Application [Page 56] ○ ○ Connecting TREX with an ABAP Application (RFC Connection) [Page 57] Connecting TREX with a Java Application (HTTP Connection) [Page 62] You carry out these steps manually if you have already carried out the wizardbased basic configuration previously and now want to configure settings at a later time.. A TREX name server controls and monitors the HTTP connection between TREX and the application using TREX. 1. Once you have selected the functional units that you want to configure using the configuration wizard. Procedure . After completing additional configuration steps. 2. The wizard-based configuration of the settings that are required to enable the application using TREX to communicate with TREX using an RFC connection is not currently supported.. Call the wizard-based configuration tool as described in the Configuration Wizard documentation. 3.Search and Classification TREX April 2008 TREX can communicate with the application using it by means of an HTTP connection or an RFC connection. You therefore carry out the configuration steps required for this manually (more information: Connecting TREX with an ABAP Application (RFC Connection) [Page 57]). Installing and Updating TREX – Single Host 47 . Result You have used the configuration wizard to configure the HTTP connection between TREX and the application using it. For information on this. you reach the Specifying the Address of the TREX Name Server page. Enter the address of one or more TREX name servers.

The TREX installation process installs this server in the <TREX_DIR>/Apache directory. such as telnet. you carry out various technical configuration steps that are required so that TREX runs correctly with the standard configuration on a single-host system and so that it can be used by an SAP application.sh Windows Start the TREX admin tool by double-clicking <TREX_DIR>\TREXAdmin. you need an X server. Log on with the user <sapsid>adm. 1. Configuring the TREX Web Server Use Java applications that use TREX communicate with the TREX servers using HTTP/HTTPS by means of a Web server that has TREX-specific functions. you have to configure the TREX Web server so that your Java application can access TREX..bat in Windows Explorer. Starting the TREX Admin Tool Prerequisites On UNIX: Since the TREX admin tool has a graphical interface./TREXAdmin.0 or higher. After installing TREX. Carry out one of the following steps: Operating system UNIX Procedure Enter the following: cd <TREX_DIR> . Prerequisites You must have installed a Web server to use a TREX Web server for HTTP communication with the application using TREX: ● UNIX: Apache Web Server The TREX delivery includes an Apache Web server. ● Windows: Internet Information Server (IIS) ○ TREX only supports Windows IIS Version 6. 2. Installing and Updating TREX – Single Host 48 . You cannot use a terminal program that only supports text mode.. Procedure .Search and Classification TREX April 2008 TREX Post-Installation Configuration Purpose After installing TREX.

Search and Classification TREX ○ April 2008 The TREX delivery does not contain the Internet Information Server (IIS). 4. 7. IIS Admin Service. Choose Refresh. Make sure that the Default Web Site runs on the IIS: To check whether this is the case. The Set Admin User and Password window appears. The Repair Results window appears and confirms that the system correctly created a TREX Web site and application pool. so you have to install an IIS 6. The Set Admin User and Password window appears. Choose Add HttpServer. ○ In a distributed TREX landscape.. Various error messages appear in the Configuration Status area of the window. Procedure . Choose Repair All again. Start the TREX admin tool (stand-alone). (See: Starting the TREX Admin Tool [Page 66]). Choose Reset to restore the previous settings. In the Landscape Connectivity window. This is also the case for the SAPService<SAPSID> user. 1. go to the http tab page. 6. The Set Admin User and Password window appears.0 on your TREX host before configuring the TREX Web server. The Set Admin User and Password window appears. the password for the <sapsid>adm user must be identical on all hosts. Choose Repair All. navigate to Control Panel → Administrative Tools → Computer Management → Services and Application → Internet Information Services (IIS) Manager. activate the World Wide Web Publishing Service. Choose Save to save your settings. telling you that the TREX Web server is not yet fully configured. 3. Installing and Updating TREX – Single Host 49 . During the subsequent configuration steps. the system repeatedly asks you for the password for the <SAPSID>adm user and the SAP system service user (SAPService<SAPSID>). 2. Result You have successfully configured the TREX Web server when the message No problems found appears in the Configuration Status area of the screen and a green traffic light appears. Make sure that the IIS is running correctly. 5. and HTTP SSL in the Windows Services tool. ○ ○ ○ ○ The Set SAPService <SAPSID> window appears. These users and corresponding passwords were created during the TREX installation process. To do so..

Do not use asterisks as placeholders. 2. Click Reset to restore the previous settings. If this is the case. Since the proxy server should not be used for internal addresses. Separate multiple entries using a semicolon. define exclusion rules for internal addresses.mylocation. 3. Click Save to save your settings. Procedure . Installing and Updating TREX – Single Host 50 .com ○ Proxy Server Port – port of the proxy server Example: 8080 ○ ○ ○ Proxy User – user name needed to access the proxy server Proxy User Password – password defined for the user ID Proxy Exclusions – exclusion rules. Examples of exclusion rules: ■ ■ Do not use the proxy server to get URLs that end in mycompany. specify the proxy server and define exclusion rules if necessary. you have to change the configuration so that access does not take place using the proxy server. Start the TREX admin tool [Page 66]. ○ Proxy Server – host name and domain of the proxy server Example: proxy. navigate to the Proxy Setting tab page. This configuration is important if you want to index the following items: ● ● Documents on internal servers that can be accessed without a proxy server.Search and Classification TREX April 2008 Configuring TREX Proxy Settings Use If there is a proxy server between the TREX servers and the documents to be indexed. Result You have configured the proxy server and the corresponding exclusion rules. Web pages on external servers that can only be accessed using a proxy server.com Do not use the proxy server to get IP addresses that start with 10: 10. Checking Proxy Settings Use If an application is unable to communicate with TREX.. These rules define when the proxy server is not to be used.com: mycompany. In the Preprocessor: Admin window.. Enter the proxy server in this area of the TREX admin tool. it may be due to the application trying to access TREX using a proxy server. 1.mycompany.

sap.ini) and in the configuration of the J2EE Engine as described above.<mydomain>|localhost You can change the Java parameters using the SAP J2EE Engine GUI Config Tool. If a proxy server is configured in the Java parameters. you have to check the configuration of the J2EE Engine. if you select English.portal.nonProxyHosts=<hostname>. enter the TREX host in the parameter nonProxyHosts. You can choose one of the following options: ● Alternative 1: D"http. navigate to the Languages tab page. Other Java applications based on J2EE 6. Start the TREX admin tool [Page 66].<domain>. German.Search and Classification TREX The procedure depends on the application concerned: ● ● SAP Enterprise Portal 6. In case you specify the TREX host name as fully qualified (e. PWDF12345. A mixed usage of host names does not work. For example.0 with Content Management Check the settings in the portal at System Administration → System Configuration → Service Configuration → Applications (Content Catalog) → com. see the SAP Library at the Internet address help. TREX creates one English.<mydomain>|localhost For <hostname>.com → Documentation → SAP NetWeaver Note that you have to specify the name of the TREX host in the same way both on TREX side in the TREX configuration files (topology. Installing and Updating TREX – Single Host 51 . For each language that you select.ivs.0 with Content Management Other Java applications based on J2EE 6. You can select languages to be identified by TREX language recognition. If a proxy server is entered there.40 For other Java applications. For more information about using this tool. 2.httpservice → Services → proxy.sap.. and French.. TREX creates a separate language index.ini. The proxy settings belong to the Java parameters.corp) you have to do so on both sides. In the Preprocessor: Admin window. you have to enter the TREX host in the field http – Bypass Proxy Servers. one German.g. enter the host name and domain (if necessary) of the TREX host.sap.40 April 2008 Procedure . Procedure 1. and one French language index. SAP Enterprise Portal 6. ● Alternative 2: D"http. Selecting Languages for TREX Language Recognition Use TREX supports the indexing and analysis of documents in different languages. sapprofile. The language of a document is needed so that the document in question can be placed in the correct language version of the index.nonProxyHosts=*.

Search and Classification TREX

April 2008

The Languages for Document Analysis area contains an overview of languages that TREX supports. In this area, select the languages that you want TREX to identify by means of document analysis. Only select the languages that are relevant for your scenario. This optimizes performance during the language recognition process, and therefore during the search and indexing process. The language recognition process gives better results if as few languages as possible are used. Languages for which TREX only provides restricted support are indicated by an asterisk (*).

Configuring TREX for the System Landscape Directory (SLD)
Use
A modern computing environment consists of a number of hardware and software components that depend on each other with regard to installation, software updates, and demands on interfaces. The SAP System Landscape Directory (SLD) simplifies the administration of your system landscape. The SLD is a server application that communicates with a client application using the Hypertext Transfer Protocol (HTTP). The SLD server contains component information, a landscape description, and a name reservation, which are based on the standard Common Information Model (CIM). The CIM standard is a general schema for describing the elements in a system landscape. This standard is independent of any implementation. The component description provides information about all available SAP software modules, as well as their combination options and dependencies. This includes version numbers, current patch level, and dependencies between landscape components. For more information about the SAP System Landscape Directory, see ■ ■ SAP Service Marketplace service.sap.com/sld → Media Library → SLD User Manual SAP NetWeaver SAP Help Portal help.sap.com → Documentation → SAP NetWeaver → SAP NetWeaver → SAP Library → SAP NetWeaver →SAP NetWeaver Library → SAP NetWeaver by Key Capability → Solution Life Cycle Management by Key Capability → Software Life Cycle Management → System Landscape Directory

To supply data to the SLD that originates from a system other than a J2EE or ABAP system, the executable sldreg is used. The sldreg sends data in XML format using a predefined DTD. For this purpose it uses an HTTP connection, as shown in the figure below:

Installing and Updating TREX – Single Host

52

Search and Classification TREX

April 2008

TREX
SAP Gateway

SAP J2EE Engine
RFC Server

XML

SLD Bridge

SAPOSCOL
HTTP

SLD

HTTP Servlet

sldreg

On the TREX host, there is an SLD client, which generates an XML file of this type and which registers itself with the SLD server using sldreg.

Prerequisites
● ● ● After the TREX installation, the SLD client and the associated executable files are located on your TREX host. The SLD server is running. You or your SLD administrator have generated the SLD configuration files slddest.cfg and slddest.cfg.key.

The slddest.cfg.key file is only available if the configuration of sldreg was generated using the - usekeyfile parameter. ● The user specified in the SLD configuration file slddest.cfg belongs to the DataSupplierLD user role, in order to have permission to send the files to the SLD.

Generating SLD Configuration Files
In case you generate the SLD configuration files (slddest.cfg and slddest.cfg.key) by yourself you have to know the host, port, user and password of the SLD server. You generate these configuration files by using the executable files which are located on your TREX host.
...

1. Set the environment variables required by TREX by executing the following scripts in a command prompt in the directory <TREX_DIR>: UNIX ○ Bourne shell sh, Bourne-again shell bash, Korn shell ksh: . TREXSettings.sh ○ C shell csh: source TREXSettings.csh

Installing and Updating TREX – Single Host

53

Search and Classification TREX Windows TREXSettings.bat 2. Execute the following commands: ○ ○

April 2008

Without usekeyfile: sldreg -configure <path>/slddest.cfg With usekeyfile: sldreg -usekeyfile -configure <path>/slddest.cfg

Copying the SLD Configuration Files to the Global SLD Directory
...

To configure TREX for the System Landscape Directory (SLD), you copy the SLD configuration files slddest.cfg and slddest.cfg.key (if available) to the global SLD directory on your TREX host. This directory is called <disk_drive>:\usr\sap\<SAPSID>\SYS\global on Windows and /usr/sap/<SAPSID>/SYS/global on UNIX. In the case of a distributed TREX installation on Windows, all TREX instances use the configuration files for the TREX global file system with first TREX instance as \\<host_central_instance>\sapmnt\<SAPSID>\SYS\global.

Result
By copying the files slddest.cfg and slddest.cfg.key, you have configured TREX for integration in the System Landscape Directory (SLD). TREX checks every five minutes whether anything has changed in the TREX system landscape and reports any changes automatically to the SLD server. If nothing has changed, TREX reports every twelve hours to the SLD server. This allows you to see that this landscape is still active.

Display Results
...

1. To display the information about TREX systems and services navigate to the screen Content Maintenance ○ ○ In the initial screen for the System Landscape Directory → Development: Content Maintenance In the initial screen for the System Landscape Directory → Administration → Content: Content Maintenance

2. In the screen Content Maintenance navigate to Subset and choose All With Instances in the dropdown list. 3. Navigate to Class. In the dropdown list you can display the TREX Services (for example TREX Index Service, TREX Name Service) and TREX systems known by SLD.

Information Transferred to the SLD Server
TREX transfers the following information to the SLD server: Information about naming and version ● ● ● Software component version (for example, TREX 7.0) SAP name (for example, TREX) Version (for example, 7.0)

Information about the TREX servers ● Host name, on which the server is running

Installing and Updating TREX – Single Host

54

Search and Classification TREX ● ● ● ●

April 2008

Port number that the server is using Type of server, for example, indexserver Web server URL (instead of the port) RFC destination of the RFC server (instead of the port)

Information about the TREX instances on individual hosts ● ● ● ● System ID Instance number Installation directory Version information for the TREX software

Information about the TREX configuration ● ● Name of the TREX hosts (Hosts) that belong to the TREX system landscape TREX server roles ○ Roles of the TREX name server (Name Server Mode) Possible roles are: 1st, 2nd, 3rd Master Name Server, Slave Server ○ ○ ● ● ● Use as master index server or master queue server Roles of the master, slave, and backup index servers

TREX preprocessor mode (Preprocessor Mode) Information about the TREX installation directory (Base Path) Services that have been started by the TREX daemon (Services)

Checking Performance Settings for the Operating System
Use
To optimize the performance of TREX when using the released Windows platform, you need to check your Windows configuration and make changes if necessary.

Optimizing Data Throughput For Network Applications
The Windows installation normally makes caching settings that are optimized for file servers. The operating system then reserves a large part of the main memory for the caching of files. Since this file-system cache impairs performance when indexing, you ought to change these settings.
...

1. Use the secondary mouse button to click on My Network Places on the Windows desktop, and choose Properties. 2. Use the secondary mouse button to click on the local network connection and choose Properties. 3. Select the entry File and Printer Sharing for Microsoft Networks and choose Properties. Installing and Updating TREX – Single Host 55

and then choose Performance Options. choose the Background Services field. 4. Under Application Response. Choose OK twice. and then choose Settings → Advanced. If you have installed one of these programs. 4. 2.. 1. Use the secondary mouse button to click on My Computer and choose Properties. This communication takes place using a Web server that is enhanced with TREX-specific functions. you do not need to make any changes. Choose the Advanced tab. April 2008 Optimizing Performance for Background Processes Programs such as Microsoft SQL Server and Microsoft Exchange make the setting described below automatically when they are installed.. 3. Windows Server 2003 .. Choose the Advanced tab. and choose Properties. ● A Java application accesses TREX by means of a Java client (HTTP connection) As a rule. Windows 2000 1. Select Background services under Adjust for best performance of. Java applications communicate with the TREX servers by means of the TREX Java client using the HTTP or HTTPS protocol. Select Maximize data throughput for network applications. ABAP applications communicate with the TREX servers by means of the TREX ABAP client using the RFC/SNC protocol. Communication takes place using an instance of the SAP Gateway and an RFC server. Connecting TREX with an Application Procedure TREX can communicate with the application using it by means of an HTTP connection or an RFC connection: ● An ABAP application accesses TREX by means of an ABAP client (RFC connection) As a rule. 5. 3.. The setting is only relevant if TREX is running as a Windows service. Choose OK twice. 2. Installing and Updating TREX – Single Host 56 . . Use the secondary mouse button to click on My Computer on the Windows desktop.Search and Classification TREX 4. Choose OK twice.

ABAP applications communicate with the TREX servers by means of the TREX ABAP client using the RFC/SNC protocol. CRM. EP. BW. PLM. Communication takes place using an instance of the SAP Gateway and an RFC server. You configure the RFC connection using the TREX admin tool (stand-alone).Search and Classification TREX April 2008 Applications Using TREX (for example. the SAP user is required so that the TREX alert server has permission to regularly test and check the RFC configuration. the user can Installing and Updating TREX – Single Host 57 . KM …) SES (Search Engine Service) Application Server (AS) ABAP/Java ABAP Client RFC/SNC Java Client SAP Gateway HTTP/HTTPS HTTP/HTTPS TCP/IP RFC Server Web Server with TREX Extension TCP/IP Queue Server TCP/IP Index Server TCP/IP Name Server Possible communication paths TREX components Other components Preprocessor There are therefore two procedures for connecting TREX with the application using it: ● ● Connecting TREX with an ABAP Application (RFC Connection) [Page 57] Connecting TREX with a Java Application (HTTP Connection) [Page 62] Connecting TREX with an ABAP Application (RFC Connection) As a rule. In addition. Creating a SAP System User for the TREX Admin Tool (Stand-Alone) Use You must create an SAP user that the TREX admin tool (stand-alone) can use to log on to the SAP system. When doing this.

The User Maintenance: Initial Screen appears. extended maintenance ALV standard layout Application log More Information Configuring the RFC Connection in the TREX Admin Tool [Page 60] Procedure Create an SAP system user for the TREX admin tool (stand-alone) and assign the SAP_BC_TREX_ADMIN role to this user. The TREX admin tool (stand-alone) is used to configure and monitor TREX. Overview of the Permissions Assigned by the SAP_BC_TREX_ADMIN Role Type and Scope of the Permission Permission check for RFC access Administration for the RFC destination Check on the transaction code at transaction launch Administrating TREX ABAP: Program run checks Change. Launch transaction SU01 (user maintenance) or choose Administration → System Administration → User Maintenance → User in the SAP menu. 2.. In this case. display. delete Activity Execute Explanation Name of the RFC object to be protected: SYST. On the Address tab page. maintain variants for and execute ABAP program Maintain Display. You also use this admin tool to configure the RFC connection between TREX and the ABAP application that is using TREX. TREXADMIN_AUTH Add or generate. TREXADMIN. assign the SAP_BC_TREX_ADMIN role and thus the permission to access the SAP system to the SAP system user for the TREX admin tool (standalone). 4.. display. TREX_ARW_ADMINISTRATION Type of entry in RFCDES: Start of an external program using TCP/IP Transaction code: SM59. . 3. For more information about the SAP_BC_TREX_ADMIN role. delete. enter the personal data for the user. execute ABAP program. execute Schedule programs for background processing. To use the TREX admin tool (stand-alone) to create the RFC destination. the admin tool requires an SAP system user that you create based on the predefined role SAP_BC_TREX_ADMIN. Enter a new user name and choose Create. make sure that you enter the associated client for the user during the configuration of the RFC connection in the TREX admin tool [Page 60]. This user then has the authorization required to configure the RFC connection. see SAP Note 766516. change. 1.Search and Classification TREX April 2008 have been created in the default client or in another client. Installing and Updating TREX – Single Host 58 . On the Roles tab page.

SAP Logon is the program that you use to log on to an SAP system. Connection Setup Type Through an application server (variant A) Required Connection Information ● ● ● SAP system ID (SID) System number Application server host name SAP system ID (SID) Logon group. The message server assigns the request from the TREX admin tool to any application server. 1. Open the SAP Logon.. the TREX admin tool requires different connection information for the SAP system. 2. Variant A has the disadvantage that the connection does not work if the application server is not available. ● ● Through a specific application server of the SAP system (variant A) Through the message server of the SAP system (variant B) This variant uses the load-balancing function for the SAP system.. You must determine the connection information and specify it later in the TREX admin tool. Depending on the variant used. Procedure . Determining the SAP System Connection Information Use The TREX admin tool (stand-alone) can connect to an SAP system in two ways.. such as PUBLIC Message server host name Through the message server (variant B) ● ● ● Installing and Updating TREX – Single Host 59 .Search and Classification TREX April 2008 Result This user for the TREX admin tool (stand-alone) now has the authorization required to configure the RFC connection. SAP recommends using variant B. Note the following connection information: ..

Enter the following parameters: Field SAP System Entry SAP system that you want to set up the connection to. 2. Specify the SAP system user. Creating an RFC Destination . The program ID must be unique for each SAP gateway. and the client that the TREX admin tool is to use to log on (see Creating a SAP System User for the TREX Admin Tool (Stand-Alone) [Page 57]). The list contains all SAP systems that you have registered using Create Connection. If the SAP system user in question exists in the default client.. RFC Destination Description Name of the RFC destination. Meaningful description of the purpose The program ID determines under which name the TREX RFC server registers with the SAP gateway. 3. you do not need to specify the client. Configuration of the RFC connection with the TREX admin tool (stand-alone) is only available as of SAP Basis Component SAP_BASIS 6. 6. 3.com/instguides → SAP NetWeaver → Released 04 → Installation → Cross-NW → Installation Guide Search and Classification TREX 6. choose the Create Connection function. Creating a Connection .. the associated password. you have to configure the RFC connection manually as described in the SAP NetWeaver 04 Installation Guide for Search and Classification (TREX) 6. On the RFC: Current tab page in the Landscape: Connectivity window. 2. and 7. To do this..20 SP58.sap. Specify the connection data for the SAP system (see Determining the SAP System Connection Information [Page 59]). Decide which SAP gateway you want to use.0 SP6.40 SP16. Choose connection type A or B.1. If you are using TREX with an SAP system based on an earlier support package. You have the following options: Option Comment Installing and Updating TREX – Single Host 60 . use the Create: RFC Destination (SM59) function on the RFC: Current tab page in the Landscape: Connectivity window. You can find this guide on the SAP Service Marketplace at service. The TREX admin tool ensures this by generating the program ID.. 1.1.Search and Classification TREX April 2008 Configuring the RFC Connection in the TREX Admin Tool Use You work through the steps below using the TREX admin tool (stand-alone). 1.

enter the following additional parameters: ● ● Host name (with domain name if necessary) or the IP address of the host on which the gateway is installed. yellow Because the RFC configuration is still incomplete.. After completion of the configuration process.” If you choose this option. the configuration status remains red. The TREX admin tool ensures that these are fulfilled. On the RFC: Current tab page in the Landscape: Connectivity window. The TREX admin tool completes the RFC configuration and starts the TREX RFC server. We advise against using a central SAP gateway for distributed TREX systems.Search and Classification TREX April 2008 Gateway local (Default setting) Gateway central Use local SAP gateways for the application servers. or 2. choose the Connect Admin Tool function. The central SAP gateway is a “single point of failure. Choose Repair All. If you nevertheless create the RFC destination directly in the SAP system. Name of the SAP gateway in the form sapgw<instance_number> We advise against creating the RFC destination directly in the SAP system. Use the central SAP gateway. Completing the RFC Configuration . Use the RFC Destinations function to register the RFC destination in the TREX admin tool. This can take several minutes. Installing and Updating TREX – Single Host 61 . Choose the activation type Registered Server Program. The name of the RFC destination and the program ID must satisfy certain naming conventions.. the status changes to yellow or green. 1. The TREX admin tool creates the connection to all SAP systems that are known to it. Choose a program ID that is unique for the SAP gateway used. During this time. note the following: ● ● ● ● We recommend starting the name of the RFC destination with TREX_. the configuration status is red.

Make sure that the TCP port that the name server uses is open. and. Connecting TREX with a Java Application (HTTP Connection) As a rule. This communication takes place using a Web server that is enhanced with TREX-specific functions.. The TREX Java client needs to know the address of the TREX name server in order to communicate with the TREX servers. Start the TREX admin tool (see Starting the TREX Admin Tool [Page 66]) and determine the address of the name server using Landscape → Tree → topology → globals → all_masters. For example: mytrexhost:34801 Installing and Updating TREX – Single Host 62 . You have to specify the address of the TREX name server in the SAP NetWeaver Administrator by naming the following values <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. You specify the address of the TREX name server. Check the progress by choosing Refresh to update the display. in the case of a distributed TREX installation. The TREX Java client communicates with the TREX server by HTTP and TCP/IP. You can determine the TREX name server address in two ways: a. of the TREX backup name server. Specifying the Address of the TREX Name Server Use TREX provides APIs (Application Programming Interfaces) for the languages Java and ABAP. which allow access to all TREX functions. This would trigger the configuration process more than once and delay it. 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 SAP NetWeaver Administrator. Procedure .. <name_server_port>: port of the TREX name server 1. in the SAP NetWeaver Administrator. Java applications communicate with the TREX servers by means of the TREX Java client using the HTTP or HTTPS protocol.Search and Classification TREX April 2008 Do not choose Repair All several times in quick succession. The Java interface (TREX Java client) is part of the SAP Web AS Java as TREX service. 3.

Navigate to Configuration Management → Infrastructure Management → Java System Properties. tcpip://mytrexhost:34801 or tcpip://mytrexhost. Use the user <j2eeadm> to log onto the host on which the Application Server Java is running. 8. 6. Specify the address of the TREX backup name servers. Save your changes and confirm the restart of the service. 3. Start the SAP NetWeaver Administrator and log on to the AS Java .com. Otherwise the connection between the AS Java and TREX cannot be established.backuplist. 2.address: tcpip://<host_name_of_trex_host>:<name_server_port> You enter only the host name or the host name and the domain depending on your network environment. In case of a multiple host scenario for a distributed TREX landscape you enter the addresses of the TREX backup name servers in the parameter nameserver.service to filter the available services. see SAP NetWeaver Administrator documentation on SAP Help Portal help. 7.Search and Classification TREX April 2008 b. 5. In the Extended Details area under the tabulator Properties enter the address of the TREX name server into the parameter nameserver.sap. separated by comma in the format: tcpip://<host1>:<port1>.tcpip://<host1>:<port1>. In the new screen go to the tabulator Services in the screen area Details and type in trex. For more information about using and starting the SAP NetWeaver Administrator. … For a TREX single-host installation you do not need to specify backup name servers.mydomain:34801 The address of the TREX name server must be configured for all server processes of the cluster. Determine the port of the TREX name server by means of the following rule: <name_server_port>: 3<instance_number>01 The value <instance_number> signifies the TREX instance number which had been 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> you know from the host where TREX is installed (mytrexhost). 4. Installing and Updating TREX – Single Host 63 .

Procedure On UNIX . Log on with the user <sapsid>adm.x TREXPreprocessor.x HTTP Connection ! ! ! RFC Connection For the process TREXDaemon. to check whether the following processes are running.x TREXNameServer.x TREXRfcServer.x TREXIndexServer.sap<SAPSID> _TRX<instance_number> will be shown. Use ps –fu <sapsid>adm..x TREXQueueServer. This is a symlink to usr/sap/<SAPSID>/TRX<instance_number>/exe/TR EXDaemon. If TREX had been successfully installed. Checking Processes Use You can check on operating systems whether the TREX daemon is running and whether the required process has started.Search and Classification TREX April 2008 Installation Check Purpose If you have carried out all the steps described. Process httpd TREXDaemon.x the symlink trx.x ! ! ! ! ! ! ! ! ! On Windows Open the Task Manager and check whether the following programs are running: Process HTTP Connection RFC Connection Installing and Updating TREX – Single Host 64 . TREX is ready for operation.. You can carry out checks to ascertain whether the installation was successful. you can use the command TREX info to display all currently running TREX processes.

the configuration files contain the necessary entries. cd /usr/sap/<SAPSID>/trx<instance_number> 3.. Run the test script in this directory: python runInstallationTest. 1. cd /usr/sap/<SAPSID>/TRX<instance_number> 3. enter the following: python runInstallationTest.exe TREXQueueServer.exe TREXPreprocessor. 1. 2. Korn shell ksh: .exe TREXNameServer. Log on with the user <SAPSID>adm.sh C shell csh: source TREXSettings.bat 4. If the Python script is executed successfully.. Set the environment variables required by TREX by executing one of the following scripts.Search and Classification TREX April 2008 TREXDaemon. 5. 2.csh 4.exe ! ! ! ! ! ! ! ! ! ! ! Executing an Installation Test Script Use TREX delivers a Python script that you can use to test the basic functions of TREX. you know that TREX has been installed properly.exe TREXIndexServer. Bourne-again shell bash. ○ ○ Bourne shell sh. Go to the TREX directory.py Procedure on Windows . Set the environment variables required by TREX by executing the following script: TREXSettings. Go to the TREX directory.exe TREXRfcServer. Go to the directory in which the test script is located: cd /usr/<SAPSID>/trx<instance_number>/exe/python_support 5..py Installing and Updating TREX – Single Host 65 . To run the test script. Procedure on UNIX . and the TREX servers are running. Go to the directory where the installation test script is located in: <disk_drive>:\usr\sap\<SAPSID>\TRX<instance_number>\ exe\python_support. TREXSettings.. Log on with the user <SAPSID>adm.

. and linguistic searches Search using Boolean operators such as AND and OR The results are displayed at the end of the script run. Carry out one of the following steps: Operating system Procedure Installing and Updating TREX – Single Host 66 . 1. the test was successful.. you need an X server. You see the tested calls and their statuses (OK or Failed). Procedure . 2.Search and Classification TREX April 2008 Result The script carries out the following tests: ● ● ● ● Deleting any test indexes that were generated for a previous script run Creating a test index Indexing documents Testing search functions ○ ○ Exact. Log on with the user <sapsid>adm. When you run the script for the first time. You cannot use a terminal program that only supports text mode. This is because there was no existing text index to be deleted. such as telnet. error-tolerant (fuzzy). If this is the only cell with the status Failed. the call “Delete Index” has the status Failed. Additional Information Purpose The sections below contain information on the following topics: ● ● ● ● Starting the TREX admin tool Controlling the installation from a remote computer Starting and stopping TREX Uninstalling TREX Starting the TREX Admin Tool Prerequisites On UNIX: Since the TREX admin tool has a graphical interface.

enter the following command: cd <DVD drive>:\IM_WINDOWS<platform> 4. SAPinst GUI uses the local host as default. Prerequisites You have done the step Preparing the System for SAPinst GUI [Page 28]. Insert the SAP Installation Master DVD into your DVD drive. You might need to start SAPinst GUI separately in the following cases: ● You have logged off from SAPinst. 1./TREXAdmin. Start SAPinst GUI in one of the following ways: ○ If SAPinst GUI runs on the same host as SAPinst and the GUI server.bat in Windows Explorer. enter the following command: startinstgui. To change to the relevant directory. Log on as a member of the local administrators group. Starting SAPinst GUI Separately Use You use this procedure to start SAPinst GUI separately. If you logged off during the installation and you later want to reconnect to the still running installation. If SAPinst GUI runs on a different host than SAPinst and the GUI server. 2.bat -host <host_name> <host_name> is the host name of the installation host. As SAPinst and the GUI server are running on another host.. you also have to start SAPinst GUI separately.Search and Classification TREX April 2008 UNIX Enter the following: cd <TREX_DIR> . SAPinst GUI cannot connect and the SAP Installation GUI Connection dialog appears.. you can start SAPinst GUI separately.bat SAPinst GUI uses the local host as default. ○ If SAPinst and the GUI server runs on a different host from SAPinst GUI (remote installation). Installing and Updating TREX – Single Host 67 . enter the following command: startinstgui. 3. SAPinst GUI starts and tries to connect to the GUI server and SAPinst. ● You want to perform a remote installation.sh Windows Start the TREX admin tool by double-clicking <TREX_DIR>\TREXAdmin. If you enter the command without additional parameters. Starting SAPinst on a Windows Platform .

The first dialog of the installation appears and you can perform the remote installation from your local host. Make sure that the root user has not set any environment variables for a different SAP system or database. enter the following command with additional parameters: .sh -h.bat -h. enter the following command without additional parameters: . enter the name of the host on which SAPinst is running and choose Log on. As SAPinst and GUI server are running on another host. Mount your installation DVD. 2. change to the same directory as your SAPinst executable and enter the command . Start SAPinst on a UNIX platform . 1./startInstGui. For a list of options to start SAPinst GUI.Search and Classification TREX April 2008 In this case. SAPinst GUI cannot connect and the SAP Installation GUI Connection dialog appears. enter the name of host on which SAPinst is running and choose Log on. For a list of options to start SAPinst GUI. SAPinst GUI uses the local host as default.sh SAPinst GUI uses as default the local host. change to the same directory as your SAPinst executable and enter the command startinstgui./startInstGui. In this case.. SAPinst GUI starts and tries to connect to the GUI server and SAPinst./startInstGui. Starting SAPinst on the Remote Host (Optional) Use You use this procedure to install your SAP system on a remote host..sh -host <host_name> where <host_name> is the host name of the installation host If you enter the command without additional parameters. ○ If SAPinst and the GUI server run on a different host from SAPinst GUI (remote installation). We do not recommend that you use Network File System (NFS). Log on as user root. SAPinst and the GUI server run on the remote host. 3. To change to the mount directory. In this case. enter the following command: cd <Installation_Master_DVD>/IM_<OS> 4. The first dialog of the installation appears and you can perform the remote installation from your local host. Mount the DVD locally. Installing and Updating TREX – Single Host 68 . The local host is the host from which you control the installation with SAPinst GUI. and SAPinst GUI runs on the local host. Start the SAPinst GUI in one of the following ways: ○ If SAPinst GUI runs on the same host as SAPinst and the GUI server.

Mount the Installation Master DVD. Log on to your remote host as user root. waiting for a connection on host <host_name>. as described in Starting SAPinst GUI Separately [Page 67].. Both computers are in the same network and can “ping” each other. Starting SAPinst on a Remote Windows Host .. You see the following at the command prompt: guiengine: no GUI connected. .. Log on to your remote host as a user who is a member of the local administrators group. Enter the following commands: cd <DVD drive>:\IM_WINDOWS_<platform> sapinst. Make sure that the root user has not set any environment variables for a different SAP system or database.. 1. port <port_number> to continue with the installation. You can now start the SAPinst GUI on your local host. port <port_number> to continue with the installation 4. 3. To test this: ○ ○ Log on to your remote host and enter the command ping <local host>.Search and Classification TREX April 2008 Prerequisites ● ● You have worked through the tasks in Preparing the System for SAPinst GUI [Page 28]. 2.. Starting SAPinst on a Remote UNIX Host . 4. You see the following at the command prompt: guiengine: no GUI connected. Insert the Installation Master DVD in the DVD drive on your remote host. Start SAPinst GUI on your local host. 3. Starting and stopping TREX You use the following methods to start and stop TREX: Windows ● TREX admin tool (standalone) Installing and Updating TREX – Single Host 69 . waiting for a connection on host <host_name>.. Enter the following commands: cd <Installation_Master_DVD>/IM_<OS> . as described in Starting SAPinst GUI Separately [Page 67]. Log on to the local host and enter the command ping <remote host>.exe –nogui SAPinst now starts and waits for the connection to the SAPinst GUI./sapinst –nogui SAPinst now starts and waits for the connection to the SAPinst GUI. 1. 2.

you must have installed the console in your TREX system first. and open alerts for the instances. a snap-in in the Microsoft Management Console (MMC). The executable files startsap. below which the various SAP systems and their TREX instances appear as subnodes. Installing and Updating TREX – Single Host 70 .exe and stopsap.Search and Classification TREX ● ● April 2008 The executable files startsap.exe You use the executable files startsap.exe and stopsap. to start and stop SAP systems and TREX instances. Starting and Stopping TREX on Windows Purpose The following sections explain how to start and stop TREX on Windows: On Windows. The snap-in consists of a root node of the SAP system. The system displays detailed information about the processes.exe to start and stop TREX. you must have installed the console in your TREX system first.exe and stopsap. the SAP Management Console is a snap-in in the Microsoft Management Console (MMC) and is no longer part of the TREX installation.exe and stopsap. UNIX ● ● TREX admin tool (standalone) The shell scripts startsap and stopsap Starting and Stopping the TREX Web Server and Individual TREX Servers When administrating TREX. these files are located in the <TREX_DIR>\exe directory and are executed from that directory. The procedures differ depending on whether you are using Windows or UNIX. Following the installation of the TREX instance. the SAP Management Console is a snap-in in the Microsoft Management Console (MMC) and is no longer part of the TREX installation. the current status.exe The SAP Management Console As of TREX 7. To start TREX with the SAP Management Console. To start TREX with the SAP Management Console. The SAP Management Console You use the SAP Management console. you may need to stop (and then restart) the TREX Web server (Windows: IIS/UNIX: Apache) and individual TREX servers.10.exe The SAP Management Console As of TREX 7.10. you can use the following methods to start and stop TREX: ● ● ● TREX admin tool (standalone) The executable files startsap.

you can start and stop the entire SAP system from a single host.exe name=ABC nr=TRX77 SAPDIAHOST =p123456 Starting TREX with the SAP Management Console .exe . double-click the <TREX_DIR>/TREXSettings. startsap. the SAP service for the corresponding TREX instance (SAP<sapsid>_TRX<instance_number>) is registered as a Windows service.bat in Windows Explorer. In the TREX admin tool. opening its context menu with the secondary mouse button. see the online application help and the SAP Library in the SAP Help Portal at help. Start the TREX admin tool by double-clicking <TREX_DIR>\TREXAdmin. Log on with the user <sapsid>adm. You can start Selected Hosts or All Hosts for a landscape. In Windows Explorer. For more information about the SAP Management console and the snap-in for the MMC. Log on with the user <sapsid>adm. 3. 3.sap. 1. and stops automatically when the host is shut down... and selecting the relevant option. 2. you specify the host name on which the TREX instance should be started. If the MMC is configured for central system administration.. Starting TREX Starting TREX with the TREX Admin Tool . Prerequisites During the installation of the global file system.com → SAP NetWeaver → . You can start TREX by clicking the SAP System: Start button or by selecting the TREX host. 1.. navigate to the Landscape Services area and then go to the MMC tab. Go to the <TREX_DIR>/exe directory and enter the following: startsap.bat batch file to set the environment variables correctly.Search and Classification TREX April 2008 A newly-installed MMC allows you only to start a locally-installed SAP instance on the host that you are logged on to. You can start and stop the service manually if necessary. a SAP Management console has been installed on your host machine.. You can also start the TREX servers individually for test purposes or troubleshooting. 2. Installing and Updating TREX – Single Host 71 .Solution Lifecycle Management → Solution Monitoring → Monitoring in CCMS → Microsoft Management Console As part of the installation of the global file system. The service is configured so that it starts automatically when the host is started up.. Starting TREX with startsap. 4.exe name=<SAPSID> nr=TRX<instance_number> SAPDIAHOST =<host> In the SAPDIAHOST parameter.

Start the TREX admin tool by double-clicking <TREX_DIR>\TREXAdmin.exe name=ABC nr=TRX77 SAPDIAHOST =p123456 Do not use the Task Manager to stop the SAP service or the individual TREX servers. Using the SAP Management Console to Stop TREX . Go to the <TREX_DIR>/exe directory and enter the following: stopsap. 3. p123456_77). 3.bat batch file to set the environment variables correctly. choose the node for the central SAP instance <SAPSID> and navigate to the subnode for the TREX instance <host>_<instance_number> (for example. April 2008 2. 1. You can stop TREX by clicking the SAP System: Stop button or by selecting the TREX host.. 2. 3. Affected indexes can be irreparably damaged. and selecting the relevant option. Use the secondary mouse button to access the context menu. In the tree structure. you specify the host name on which the TREX instance is to be stopped.. 5. Log on with the user <sapsid>adm. In the TREX admin tool. 1. data can be lost. Stopping TREX Stopping TREX with the TREX Admin Tool . Certain processing steps. With large indexes.exe to Stop TREX . Log on with the user <sapsid>adm. it can take up to a few hours to stop the TREX servers if lots of documents are currently being indexed. You can stop Selected Hosts or All Hosts for a landscape.. 4. double-click the <TREX_DIR>/TREXSettings. opening its context menu with the secondary mouse button.exe name=<SAPSID> nr=TRX<instance_number> SAPDIAHOST =<host> In the SAPDIAHOST parameter. This process can take a while to complete. Log on with the user <sapsid>adm.bat in Windows Explorer. Otherwise.. Choose Start. Launch the SAP Management console by double-clicking the program icon on your desktop or by choosing Start → Programs → SAP Management Console. Log on with the user <sapsid>adm. Using stopsap. cannot be interrupted. 2. for example.Search and Classification TREX 1. 1.. 4. navigate to the Landscape Services area and then go to the MMC tab. Such steps are completed before TREX is stopped. writing an index. In Windows Explorer. Installing and Updating TREX – Single Host 72 .. stopsap.

which means that there is a risk of data loss. Choose Shutdown. This process can take a while to complete. Certain processing steps. In the tree structure. 1.exe -r In the properties of the prompt. Starting the TREX Servers . TREX Server Index server Name server Preprocessor Queue server Only relevant for an RFC connection: RFC server Command TREXIndexServer. Leave the prompt open.. p123456_77). Starting and Stopping Individual TREX Servers Use You can start individual TREX servers for test purposes and for troubleshooting. Use CTRL + C or close the window.exe TREXNameServer. writing an index. You can then track the program output on the screen. you can minimize the window so that it is shown as a pushbutton in the Windows task bar.Search and Classification TREX April 2008 2.exe TREXPreprocessor. Go to the TREX directory and start the TREX server. Such steps are completed before the TREX servers are stopped. Stop TREX (see Stopping TREX [Page 72]). choose the node for the central SAP instance <SAPSID> and navigate to the subnode for the TREX instance <host>_<instance_number> (for example. 1. 3.exe TREXRfcServer.. Open a separate prompt for each TREX server. as this command terminates the TREX processes immediately. for example. cannot be interrupted.exe TREXQueueServer. 4... Installing and Updating TREX – Single Host 73 . If you want. The Shutdown command only stops the TREX processes once any running processes have been completed. Launch the SAP Management console by double-clicking the program icon on your desktop or by choosing Start → Programs → SAP Management Console. 3. 2. it can take up to a few hours to stop the TREX servers if lots of documents are currently being indexed. Stopping the TREX Servers . 2. 5. Display the window in which you started the TREX server. With large indexes. Use the secondary mouse button to access the context menu. Do not use the Stop command. deactivate the QuickEdit Mode option.

4. choose Start → Administrative Tools → Services. Otherwise.. Starting and Stopping TREX on UNIX Purpose The following sections explain how to start and stop TREX on UNIX. Affected indexes can be irreparably damaged. Starting TREX Starting TREX with the TREX Admin Tool On UNIX: Since the TREX admin tool has a graphical interface. For Windows Server 2003.Search and Classification TREX April 2008 Do not use the Task Manager to stop the TREX servers. Open a prompt. 2... Select IIS Admin Service and choose Stop from the context menu. If the World Wide Web Publishing Service does not run even though you have started it. choose Start → Administrative Tools → Services. 1. . you use the startsap and stopsap shell scripts or the TREX admin tool (standalone) to start and stop TREX. you need an X server. For Windows Server 2003. try to start it using a prompt: .. Select IIS Admin Service and choose Start from the context menu. such as telnet. 1. 2. Installing and Updating TREX – Single Host 74 . You cannot use a terminal program that only supports text mode.. Starting the Web Server Procedure . data can be lost. Execute the following command: net start w3svc Stopping the Web Server Procedure 3.. On UNIX.

navigate to the Landscape Services area and then go to the MMC tab. 2. Execute the startsap script in any directory: a. enter the following: Installing and Updating TREX – Single Host 75 . b.Search and Classification TREX 1. Log on locally to the host on which the TREX instance is installed with the user <sapsid>adm. you need an X server. 4. 2. 1.. You can start TREX by clicking the SAP System: Start button or by selecting the TREX host. Start the TREX admin tool by entering the following: cd <TREX_DIR> . opening its context menu with the secondary mouse button. Log on locally to the host on which the TREX instance is installed with the user <sapsid>adm. To start a single TREX instance.sh 3.. To start a single TREX instance. 1. Log on with the user <sapsid>adm.. To start all SAP instances – including all TREX instances – on a host. enter the following: startsap TRX<instance_number> In the parameter TRX<instance_number>.sh April 2008 3. you specify which TREX instance is to be started. navigate to the Landscape Services area and then go to the MMC tab. You can stop TREX by clicking the SAP System: Stop button or by selecting the TREX host. 2. Stopping TREX with the stopsap Shell Script . Execute the stopsap script in any directory: a./TREXAdmin. In the TREX admin tool. Log on with the user <sapsid>adm. ./TREXAdmin.. Starting TREX with the Shell Script . 4.. 1. and selecting the relevant option. You can stop Selected Hosts or All Hosts for a landscape. and selecting the relevant option. You can start Selected Hosts or All Hosts for a landscape. 2. such as telnet. opening its context menu with the secondary mouse button. enter the following: startsap Stopping TREX Stopping TREX with the TREX Admin Tool On UNIX: Since the TREX admin tool has a graphical interface. In the TREX admin tool. You cannot use a terminal program that only supports text mode.. Start the TREX admin tool by entering the following: cd <TREX_DIR> .

4. This process can take a while to complete. b. With large indexes.. Go to the TREX directory. 3..x TREXQueueServer.Search and Classification TREX stopsap TRX<instance_number> April 2008 In the parameter TRX<instance_number>. To stop all SAP instances – including all TREX instances – on a host. Starting the TREX Servers .. You can then track the program output on the screen. Installing and Updating TREX – Single Host 76 . writing an index. Stop TREX (see Stopping TREX [Page 75]). Do not stop the TREX server using kill – 9. TREX Server Index server Name server Preprocessor Queue server Only relevant for an RFC connection: RFC server Command TREXIndexServer. for example. as this can lead to data loss. it can take up to a few hours to stop the TREX servers if lots of documents are currently being indexed.x TREXNameServer. Display the window in which you started the TREX server.x TREXPreprocessor. Start each TREX server in a separate shell. you specify which TREX instance is to be stopped.. Use CTRL + C or close the window. Affected indexes can be irreparably damaged. enter the following: stopsap Starting and Stopping Individual TREX Servers Use You can start individual TREX servers for test purposes and for troubleshooting.x -r Stopping the TREX Servers . cannot be interrupted. 1.x TREXRfcServer. 2. Log on with the user <sapsid>adm. 2. Certain processing steps. Such steps are completed before the TREX servers are stopped. 1.

Stops the installation.. Starting the Web Server . 1. Procedure . choose View Logs.. Execute the following commands: cd <TREX_DIR>/Apache apachectl start Stopping the Web Server .. 1. To view the log file. Log on with the user <SAPSID>adm.. Execute the following commands: cd <TREX_DIR>/Apache apachectl stop Information on SAPinst Purpose The following sections contain information on solving errors that affect SAPinst... 1. 2. 2. Displays a dialog informing you about the error.. Installing and Updating TREX – Single Host 77 . do either of the following: ○ Try to solve the problem. Log on with the user <SAPSID>adm.. 1. 2. If an error occurs. 2.Search and Classification TREX April 2008 Starting and Stopping the Web Server Use You can start and stop the Apache Web server manually if necessary. SAPinst: . Troubleshooting SAPinst Use This section tells you how to proceed when errors occur during the installation with SAPinst. If an error occurs during the dialog or processing phase.

we do not recommend that you use Ctrl+C.xml file. the SAPinst GUI. Windows: Check the log and trace files of the GUI server and SAPinst GUI in the directory %userprofile%\. and the GUI server. See the procedure below. Stop SAPinst stops the installation. UNIX: Check the log and trace files of the GUI server and SAPinst GUI in the directory <user_home>/. However. Therefore. Procedure on UNIX ..sdtgui/ for errors. Installing and Updating TREX – Single Host 78 . This is possible because SAPinst records the installation progress in the keydb. SAPinst displays the same dialog box again. The dialog box contains a short description about the choices listed in the table below as well as a path to a log file that contains detailed information about the error.xml file. try to solve the problem and then choose Retry. you can continue the installation from the point of failure without repeating any of the previous steps. For more information. SAPinst records the installation progress in the keydb.. Prerequisites You solved the problem that caused the error situation. We recommend that you view the entries in the log files. SAPinst does not abort the installation in error situations. The following table describes the options in the dialog box: Meaning SAPinst retries the installation from the point of failure without repeating any of the previous steps. Interrupted Installation with SAPInst Use The SAP system installation might be interrupted for one of the following reasons: ● An error occurred during the processing phase.sdtgui\ for errors. Continue SAPinst continues the installation form the current point. closing the dialog box. If the same or a different error occurs again. Option Retry UNIX only: You can also terminate SAPinst by choosing Ctrl+C.Search and Classification TREX ○ ○ ● ● April 2008 Abort the installation with Exit. If an error occurs during the processing phase. because this kills the process immediately. see Interrupted Installation with SAPInst [Page 78]. ● You interrupted the installation by choosing Exit in the SAPinst menu. Continue the installation by choosing Retry. the installation will hold and a dialog box appears .

the Welcome screen does not appear. 5. Enter the following commands: cd <DVD_DRIVE>:\IM_WINDOWS<platform> sapinst..exe 4. If there is only one component to install. 2.Search and Classification TREX 1. From the tree structure in the Welcome screen. In the What do you want to do? screen. Afterwards. select the installation service that you want to continue and choose Next. 3. the following naming convention is used: <log_day_month_year_hours_minutes_seconds> (for example./sapinst 4. SAPinst moves the content of the old installation directory and all installation-specific files to the backup directory. Mount the DVD with the installation files. 2. From the tree structure in the Welcome screen.. The What do you want to do? screen appears.. Instead. Log on to your remote host as a user who is a member of the local administrators group. select the installation service that you want to continue and choose Next.. We do not recommend using Network File System (NFS). If there is only one component to install. 3. For the backup directory. log_01_Oct_2003_13_47_56). Insert the Installation Master DVD in your DVD drive. 1. Log on to the installation host as root. In the What do you want to do? screen. Alternative Behavior Installing and Updating TREX – Single Host 79 . Enter the following commands: cd <Installation_Master_DVD>/IM_<OS> . Alternative Run a new Installation Behavior The interrupted installation is not continued. Continue old installation . April 2008 Mount the DVD locally. you can no longer continue the old installation. Procedure on Windows . The What do you want to do? screen appears. decide between the following alternatives and choose OK. The installation that was interrupted is continued from the point of failure. the Welcome screen does not appear. decide between the following alternatives and choose OK. 5.

Instead. Continue old installation 6. log_01_Oct_2003_13_47_56). SAPinst moves the content of the old installation directory and all installation-specific files to the backup directory. The installation that was interrupted is continued from the point of failure. Installing and Updating TREX – Single Host 80 . Afterwards. the following naming convention is used: <log_day_month_year_hours_minutes_seconds> (for example. you can no longer continue the old installation. For the backup directory.Search and Classification TREX April 2008 Run a new Installation The interrupted installation is not continued.

Sign up to vote on this title
UsefulNot useful