Show TOC Start of Content Area

Background documentation Installing a TREX Global File System with a First TREX Instance  Locate the document in its SAP Library structure

The tables below show the names of the screens that are displayed during the installation of a TREX global file system with first TREX instance and the entries that you need to make.

Note

For more information about the concept of the central TREX instance, see TREX Global File System and TREX Instances.

After SAPinst starts, the screen Welcome to SAP installation master appears.

Screen

Input

Welcome to SAP Installation Master

...

       1.         In the folder hierarchy, choose SAP NetWeaver 7.0 Support Release 2 ® Standalone Engines  ® Search and Classification (TREX) ® TREX Global File System with First TREX Instance

       2.      Choose Next.

The screen DVD/CD Browser > Software Package Request appears.

DVD/CD Browser > Software Package Request

...

...

       1.      Insert the CD containing the TREX installation files (Windows) or mount the CD (UNIX).

       2.      Package Location

Specify the path to the CD containing the TREX installation files.

This graphic is explained in the accompanying text

During the TREX installation, which you perform as the root user (UNIX) or as a user with administration rights (Windows), the operating system user <SAPSID>adm is created. For all operating systems, make sure that the user <SAPSID>adm has at least read-access to the TREX installation CD. Otherwise, a Python error message can occur during installation.

If the <SAPSID>adm user does not have at least read-access for the CD containing the TREX installation files, you can copy the CD to your local hard-drive. To do this, specify in CopyPackageTo the path to the directory to which you want to copy the files on the TREX installation CD.

       3.      Choose Next.

 

Typical Installation with Default Settings (Parameter Mode: Typical)

If you choose a typical TREX installation with default settings (parameter mode: typical), SAPinst runs mostly with automatic default settings. You only have to respond to a minimum number of prompts. However, you can still change any of the default settings on the Parameter Summary screen. During installation of a TREX global file system with a first TREX instance, you only have to provide the values for the following parameters:

      SAP System ID (SAPSID)

      Master Password (password for all users of this SAP system)

SAPinst sets all other parameter values automatically with the default configuration settings. You can change the default configuration settings before you start the installation process.

 

After SAPinst starts, the screen Welcome to SAP installation masterappears.

Screen

Input

Parameter Mode > Default Settings

...

       1.      Choose Parameter Mode: Typical

       2.      Choose Next.

SAP System > General Parameters

SAP System Parameters ® SAP System ID (SAPSID)

Enter an SAP system ID <SAPSID>.

The system ID consists of three characters and must begin with a capital letter, after that it can contain numbers.

This graphic is explained in the accompanying text

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. Do not use a system ID <SAPSID> that is already used for another SAP system landscape. Otherwise an error message will occur.

SAP System > Master Passwords

...

...

       1.      Password for all users of this SAP system

       2.      Confirm

Specifies one password for both SAP system administrator and SAP system service user.

The password is used for all accounts, that SAPinst creates and for the secure store key phrase. The password has to be 8-14 characters long. Depending on your installation scenario, there might be more restrictions.

You can choose a different value for each password by choosing to edit the relevant parameter section on the summary screen. If you already set one password to a different value and change then the master password in this dialog, the individually set passwords are NOT overwritten with the new master password.

Choose Next.

Parameter Summary

SAPinst displays all settings before you start the installation procedure: The settings chosen by you and the default configuration settings automatically filled by SAPinst.

      You can check the settings and choose Revise to change any of them if necessary. In this case, SAPinst goes back to the installation screen where you can enter the specific settings you want to change (for details, see Installation Screens for Changing the Default Configuration Settings section).

      To start the installation with the selected parameters,
choose Start.

 

Configuration Settings Shown on the Parameter Summary Screen

Screen/Parameter

Default Value/Value Set By User

Parameter Mode > Default Settings

Parameter Mode: Typica

Value set by user

SAP System > General Parameters:
SAP System ID (SAPSID)

Value set by user

SAP System > Master Password:
Password for all users of this SAP system

Value set by user

SAP System > Windows Domain:
Domain Model/Windows Domain

Default values

Domain Modell: Local installation

Windows Domain: none

SAP System > OS User Password:
Password of SAP System Administrator 
Password of SAP System Service User 

Values set by user in screen
SAP System > Master Passwords

TREX > Instance: Instance Number

Default value: The next free instance number will be chosen.

TREX > Instance Details: Install HTTP Server

Default value: Activated

TREX > Proxy Settings: Proxy Server/Proxy User/Password of Proxy User/Proxy Exclusions

Default values: None

TREX > Languages for Document Analysis

Default values: English/German/ French/ Spanish

 

Custom TREX Installation (Parameter Mode: Custom)

If you choose a custom TREX installation (parameter mode: custom) all parameter screens are shown and you have to specify all required installation and configuration parameters of the TREX installation.

 

Screen

Input

Parameter Mode > Default Settings

...

       1.      Choose Parameter Mode: Custom

       2.      Choose Next.

TREX > Installation

Confirm the installation of TREX Search and Classification

Choose Next.

SAP System > General Parameters

SAP System Parameters ® SAP System ID (SAPSID)

Enter an SAP system ID <SID>.

The system ID consists of three characters and must begin with a capital letter, after that it can contain numbers.

Caution

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 will be installed. Do not use a system ID <SAPSID> that is already used for another SAP system landscape for your TREX installation and landscape. Otherwise an error message will occur.

SAP System > Master Passwords

...

       1.      Password for all users of this SAP system

       2.      Confirm

Specifies one password for both SAP system administrator and SAP system service user.

The password is used for all accounts, that SAPinst creates and for the secure store key phrase. The password has to be 8-14 characters long. Depending on your installation scenario, there might be more restrictions.

You can choose a different value for each password by choosing to edit the relevant parameter section on the summary screen. If you already set one password to a different value and change then the master password in this dialog, the individually set passwords are NOT overwritten with the new master password.

       3.      Choose Next.

SAP System > Windows Domain

...

Caution

This screen and these entries are not required on UNIX

       1.      In SAP System User Domain ® Domain Model, 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 the TREX global file system with first TREX instance locally on a host.

       Installation in Domain for Current User

You choose this setting if you are installing the TREX global file system with first TREX instance in the Windows domain of the current user.

       Installation in Different Domain

You choose this setting if you are installing the TREX global file system with first TREX instance in a different Windows domain to that of the current user.

Caution

You must note that, in both cases involving installation in a Windows domain, you must have domain administrator rights in order to be able to create the required operating system users.

       2.      Choose Next.

.

SAP System > OS User Passwords

...

       1.      Enter passwords for the operating system users:

                            a.      SAP System Administrator ® SAP System Administrator Password

Here you enter a password for the operating system user <sapsid>adm that you log on with to administrate TREX.

                            b.      SAP System Administrator ® Confirm

Confirm the password you entered.

                            c.      SAP System Service User ® SAP System Service User Password

Here you enter a password for the operating system user SAPService<SAPSID> under which the TREX processes run.

                            d.      SAP System Service User ® Confirm

Confirm the password you entered.

       2.      Choose Next.

TREX > Instance

Choose a new TREX instance to install or an existing TREX instance to upgrade

      TREX Installation Mode ® SAP System ID (SAPSID)

The SAP system ID <SAPSID> that you created previously is displayed here.

      TREX Installation Mode ® Install a new TREX instance

You cannot change this option because you are installing a new TREX instance and not updating an existing instance.

...

       1.      New TREX Instance ® 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.

       The instance number must be unique on the host. 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. If instances have already been installed, the system suggests the next available number.

       2.      Only Windows: Choose the drive on which the TREX software is to be installed.

SAPinst checks whether the installation directory already exists. If not, it creates it. The directory is:

      On UNIX /usr/sap/<SAPSID>/trx<instance_number>

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

The path to the directory is fixed and cannot be changed (apart from the Windows disk drive).

Caution

The directory should not be available before the installation unless you explicitly created it for space reasons previously (see Checking Disk Space).

This allows you to ensure that the directory does not contain any data that does not belong to TREX, which would then also be deleted if TREX were uninstalled.

TREX > Instance Details

Enter values to configure settings for the following TREX installation components

You can configure the following setting for the TREX installation:

...

      Install HTTP Server

If the application communicates with TREX using an HTTP connection, select the field Install HTTP Server.

Caution

Only Windows: You have to ensure that the Internet Information Server (IIS) is installed and that the Default Web Site is running. To check this navigate to Control Panel ® Administrative Tools ® Computer Management ® Services and Application ® Internet Information Services (IIS) Manager.

TREX > Proxy Settings

Enter the proxy configuration settings

If there is a proxy server between the TREX servers and the documents to be indexed, specify the proxy server and define exclusion rules if necessary.

Example

You want to index the following:

       Documents on internal servers that can be accessed without a proxy server

       Web pages on external servers that can only be accessed using a proxy server

In this case, specify the proxy server. Define exclusion rules for company-internal addresses, because the proxy server should not be used for those addresses,

      Proxy Server – host name and domain of the proxy server

Example: proxy.mylocation.mycompany.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

      Proxy Exclusions – exclusion rules. These rules define when TREX is not to use the proxy server. Use a semicolon to separate multiple entries.

Example

Examples of exclusion rules:

       Do not use the proxy server to get URLs that end in mycompany.com:

mycompany.com

       Do not use the proxy server to get IP addresses that start with 10.: 10.

Caution

Do not use asterisks as placeholders.

TREX > Languages for Document Analysis

Enter the document analysis languages

TREX supports the following languages for indexing and searching:

English, German, French, Spanish, Portuguese, Dutch, Swedish, Finnish, Danish, Bokmal and Nynorsk (the two Norwegian languages), Italian, Japanese, Korean, Simplified Chinese, Traditional Chinese, Russian, Arabic, Catalan, Croatian, Serbian, Slovakian, Slovenian, and Czech

If the application does not transmit the document language to TREX, TREX has to identify the language before indexing. You can select the languages that you want TREX to recognize.

Caution

Only select the languages that are relevant. 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.

Note

However, TREX can also index documents whose language is not specified here. TREX then inserts the documents in question into the index for the default language (normally English). For example, if you select English and German and a document in Spanish is then indexed, the document is inserted into the English index.

This affects the documents in question in the following manner:

       A linguistic search is not possible.

       TREX may extract keywords (document features) that are not characteristic of the document.

Parameter Summary

SAPinst displays all settings before you start the installation procedure: The settings chosen by you and the default configuration settings automatically filled by SAPinst.

      You can check the settings and choose Revise to change any of them if necessary. In this case, SAPinst goes back to the installation screen where you can enter the specific settings you want to change.

      To start the installation with the selected parameters, choose Start.

 

Configuration Settings Shown on the Parameter Summary Screen

Screen/Parameter

Default Value/Value Set By User

Parameter Mode > Default Settings

Parameter Mode: Typica

Value set by user

SAP System > General Parameters:
SAP System ID (SAPSID)

Value set by user

SAP System > Master Password:
Password for all users of this SAP system

Value set by user

SAP System > Windows Domain:
Domain Model/Windows Domain

Default values

Domain Modell: Local installation

Windows Domain: none

SAP System > OS User Password:
Password of SAP System Administrator 
Password of SAP System Service User 

Values set by user in screen
SAP System > Master Passwords

TREX > Instance: Instance Number

Default value: The next free instance number will be chosen.

TREX > Instance Details: Install HTTP Server

Default value: Activated

TREX > Proxy Settings: Proxy Server/Proxy User/Password of Proxy User/Proxy Exclusions

Default values: None

TREX > Languages for Document Analysis

Default values: English/German/ French/ Spanish

 

End of Content Area