TREX is based on a client/server architecture. The client software is integrated into the application that uses the TREX functions, and allows communication with the TREX servers. The TREX servers execute the requests of the clients: They index and classify documents and respond to search queries.
TREX offers an ABAP and a Java client. This allows ABAP and Java applications to use TREX functions. ABAP and Java applications communicate with the TREX servers using different protocols and components.
- ABAP applications communicate with TREX servers using the RFC protocol. Communication takes place using an instance of the SAP Gateway and an RFC server.
- Java applications communicate with TREX using the HTTP or HTTPS protocol. This communication takes place using a Web server that is enhanced with TREX-specific functions
How to update TREX
Install package You can find here:
- Log on to the TREX host:
UNIX: As root user.
2. Navigate to the directory to which you unpacked the TREX binary files:
UNIX: <path to unpack directory>/tx_trex_content/TX_LINUX_X86_64
This directory was created by unpacking the TREX software package using SAPCAR.
3. Call the install.sh installation script (depending on your shell) as follows:
UNIX: ./install.sh --action=update --sid=<SAPSID> --password=<password for adm/service user> --restart
The installation procedure will take less than 15 minutes. You can find more information about using the installation script executing it with the –help
./install.sh –help
4. If the option restart wasn’t used, after the installation has finished you need to restart TREX:
UNIX: Log on as adm user. To stop TREX, enter: TREX stop To start TREX, enter: TREX start
Useful note: 2907622 – FAQ: installing or upgrading TREX
Example
[12678|root@hostname|Tue Mar 05 21:49:03 /mnt/nfs1/TREX/tx_trex_content/TX_LINUX_X86_64|0]
-> ./install.sh --action=update --sid=SID --password=1234 --restart
*
*
Installation script for TREX system
*
*
*
Script execution started at 2021-01-05 21:49:22
*
Log file /tmp/trex_install_2021-01-05_21.49.22/_install.log
*
running as: root (0)
*
Update of TREX installation to version 7.10.79.405037
*
[UNDEFINED]
*
*
Script execution started at 2021-01-05 21:49:22
*
Log file /tmp/trex_install_2021-01-05_21.49.22/_install.log
*
TrexConfigType is ESH
Cocktail is: TREX_ALONE
Persistence: FS
SarTrek: systemloc is: /usr/sap
Installing Version: 7.10.79.405037
SystemType is STANDALONE
IntegratedSystem: False
fsLayout: filer
linkedBinaries: True
sharedBinaries: True
configType: ESH
systemType: STANDALONE
Target dir: /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037
DearStructure: SYSTEMLOC is: /usr/sap
DearStructure: INSTANCELOC is: /usr/sap
*
Performing Step 1
*
Stopping the TREX landscape SID TRX on 0 hosts
*
Action: Stopping TREX
Stopwait: 2 sec : Running
Stopwait: 4 sec : Running
Stopwait: 6 sec : Running
Stopwait: 8 sec : Running
Stopwait: 10 sec : Running
Stopwait: 12 sec : Running
Stopwait: 14 sec : Running
Stopwait: 16 sec : Running
Stopwait: 18 sec : Running
Stopwait: 20 sec : Running
Stopwait: 22 sec : Running
Stopwait: 24 sec : Running
Stopwait: 26 sec : Running
Stopwait: 28 sec : Running
Stopwait: 30 sec : Running
Stopwait: 32 sec : Running
Stopwait: 34 sec : Running
Stopwait: 36 sec : Stopped
*
Performing Step 2
*
Update of TREX master instance
*
Preparing update for SAPSID SID Instance TREX admin user SIDadm.
Action: Extracting installation archives
DOC.SAR
-> create: /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/Apache
APACHE.SAR
EXTENSIONSPY.SAR
-> create: /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/filter
FILTER.SAR
LEXICON.SAR
POSTINSTALL.SAR
-> create: /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/Python
PYTHON.SAR
PYTHONSUPPORT.SAR
SOLUTIONMGMT.SAR
TOPICMAPS.SAR
TREXBIN.SAR
-> create: /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/config
INIFILES.SAR
typo config in /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/config
preparing config for ESH
copy /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/config/TREXIndexServer_ESH.ini to /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/config/TREXIndexServer.ini
copy /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/config/TREXPreprocessor_ESH.ini to /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/config/TREXPreprocessor.ini
Installing new version 7.10.79.405037, creating link: TREX_7.10.79.405037 -> /usr/sap/SID/exe/nuc/linuxx86_64/trex_new
possess: /usr/sap/SID/exe/nuc/linuxx86_64/trex_new
creating link in /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037: lexicon -> ../../../../global/trex/custom/config/lexicon
possess: /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/lexicon
Action: Configuring TREX
possess: /usr/sap/SID/TRX01
possess: /usr/sap/SID/TRX01/TREX
possess: /usr/sap/SID/TRX01/TREXAdmin.sh
possess: /usr/sap/SID/TRX01/xterms
possess: /usr/sap/SID/TRX01/dev_sapstart
possess: /usr/sap/SID/TRX01/TREXSettings.sh
possess: /usr/sap/SID/TRX01/TREXSettings.csh
adapt /usr/sap/SID/exe/nuc/linuxx86_64/trex/Apache/conf/httpd.conf-dist
possess: /home/SIDadm/trexenv.sh
possess: /home/SIDadm/trexenv.csh
possess: /home/SIDadm/TREXSettings.sh
possess: /home/SIDadm/TREXSettings.csh
Action: Changing file ownership to user SIDadm
systemloc is: /usr/sap
possess recursive: /usr/sap/SID/global/trex/install
possess: /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037/trex
possess recursive: /usr/sap/SID/exe/nuc/linuxx86_64/TREX_7.10.79.405037
possess: /usr/sap/SID/TRX01
possess: /usr/sap/SID/TRX01/TREX
possess: /usr/sap/SID/TRX01/TREXAdmin.sh
possess: /usr/sap/SID/TRX01/xterms
possess: /usr/sap/SID/TRX01/dev_sapstart
possess: /usr/sap/SID/TRX01/TREXSettings.sh
possess: /usr/sap/SID/TRX01/exe
possess: /usr/sap/SID/TRX01/TREXSettings.csh
Action: Updating installer tools
possess recursive: /usr/sap/SID/global/trex/install
activateNewVersion …
create symbolic link /usr/sap/SID/exe/nuc/linuxx86_64/trex_old--->TREX_7.10.75.404362
activateNewVersion completed.
*
Performing Step 3
*
Start the TREX landscape SID TRX on 0 hosts
*
Action: Starting TREX
Startwait: 2 sec : startup
Startwait: 4 sec : Running
restarting sapstartsrv SID via hostname.01
=== Script execution resumee === *
Step 1: Stopping the TREX landscape SID TRX on 0 hosts : SUCCESS
Step 2: Update of TREX master instance : SUCCESS
Step 3: Start the TREX landscape SID TRX on 0 hosts : SUCCESS
*
See also log file: /tmp/trex_install_2021-01-05_21.49.22/_install.log
[12679|root@hostname|Tue Mar 05 21:52:15 /mnt/nfs1/TREX/tx_trex_content/TX_LINUX_X86_64|0]