Starting and Stopping TREX on Windows

Using the SAP Management Console to Start TREX

...

       1.      Log on with the user <sapsid>adm.

       2.      Launch the SAP Management console by double-clicking the program icon on your desktop or by choosing Start  → Programs   → SAP Management Console.

       3.      In the tree structure, choose the node for the central SAP instance <SAPSID> and navigate to the subnode for the TREX instance <host>_<instance_number> (for example,p123456_77).

       4.      Choose the right-hand mouse button to access the context menu.

       5.      Choose Start.

Using startsap.exe to Start TREX

       1.      Log on with the user <sapsid>adm.

       2.      Open a command prompt by choosing Start  → Programs  → Instance_number  → Tools  → TREX_<instance_number> so that the environment variables are set correctly.

       3.      Switch to the   <TREX_DIR>/exedirectory and enter the following:

startsap.exe name=<SAPSID> nr=TRX<instance_number> SAPDIAHOST =<host>

In the SAPDIAHOST parameter, you specify the host name on which the TREX instance should be started.

 startsap.exe name=ABC nr=TRX77 SAPDIAHOST =p123456

Using the SAP Management Console to Stop TREX

       1.      Log on with the user <sapsid>adm.

       2.      Launch the SAP Management console by double-clicking the program icon on your desktop or by choosing Start  → Programs   → SAP Management Console.

       3.      In the tree structure, choose the node for the central SAP instance <SAPSID> and navigate to the subnode for the TREX instance <host>_<instance_number> (for example,p123456_77).

       4.      Choose the right-hand mouse button to access the context menu.

       5.      Choose Shutdown.

Note(s):  The Shutdown command only stops the TREX processes once current transactions have been completed. Do not use the Stop command because this terminates the TREX processes abruptly and there is a risk of data loss.

Using stopsap.exe to Stop TREX

       1.      Log on with the user <sapsid>adm.

       2.      Open a command prompt by choosing Start  → Programs  → Instance_number  → Tools  → TREX_<instance_number> so that the environment variables are set correctly.

       3.      Switch to the  <TREX_DIR>/exe directory and enter the following:

stopsap.exe name=<SAPSID> nr=TRX<instance_number> SAPDIAHOST =<host>

In the SAPDIAHOST parameter, you specify the host name on which the TREX instance should be stopped.

   stopsap.exe name=ABC nr=TRX77 SAPDIAHOST =p123456

Note(s):  Do not use the Task Manager to stop the SAP service or the individual TREX servers. Otherwise, data can be lost. Affected indexes can be irreparably damaged.

 Certain processing steps, for example, writing an index, cannot be interrupted. Such steps are completed before TREX is stopped. This process can take a while to complete. With large indexes, it can take up to a few hours to stop the TREX servers if lots of documents are currently being indexed.

Starting and Stopping Individual TREX servers:

Use

You can start individual TREX servers for test purposes and for troubleshooting. You can then track the program output on the screen.

Starting the TREX Servers

...

       1.      Stop TREX (see Stopping TREX).

       2.      Open a separate prompt for each TREX server.

       3.      Go to the TREX directory and start the TREX server.

TREX Server

 Command

Index server

 TREXIndexServer.exe

Name server

 TREXNameServer.exe

Preprocessor

 TREXPreprocessor.exe

Queue server

 TREXQueueServer.exe

Only relevant for an RFC connection: RFC server

 TREXRfcServer.exe -r

 In the properties of the prompt, deactivate the QuickEdit Mode option.

 Leave the prompt open. If you want, you can minimize the window so that it is shown as a pushbutton in the Windows task bar.

Stopping the TREX Servers

       1.      Display the window in which you started the TREX server.

       2.      Use CTRL + C or close the window.

Note(s): Certain processing steps, for example, writing an index, cannot be interrupted. Such steps are completed before the TREX servers are stopped. This process can take a while to complete.

With large indexes, it can take up to a few hours to stop the TREX servers if lots of documents are currently being indexed.

 Do not use the Task Manager to stop the TREX servers. Otherwise, data can be lost. Affected indexes can be irreparably damaged.

Starting the Web Server:

Procedure

...

       1.      Choose:

Windows 2000: Start  →Settings  →Control Panel  →Administrative Tools  →Services.

Windows Server 2003: Start  → Administrative Tools  → Services.

       2.      Select IIS Admin Service and choose Start from the context menu.

If the World Wide Web Publishing Service doesn’t run even though you have started it, try to start it using a prompt.

       1.      Open a prompt.

       2.      Execute the following command:  net start w3svc

Stopping the Web Server:

Procedure

       1.      Choose:

Windows 2000: Start  →Settings  →Control Panel  →Administrative Tools  →Services.

Windows Server 2003: Start  → Administrative Tools  → Services.

       2.      Select IIS Admin Service and choose Stop from the context menu.