Table of Contents

Search

  1. Preface
  2. Introduction
  3. Servers
  4. Console Client
  5. Search Clients
  6. Table Loader
  7. Update Synchronizer
  8. Globalization
  9. Siebel Connector
  10. Web Services
  11. ASM Workbench
  12. System Backup and Restore
  13. Batch Utilities

Search and Rulebase Servers

Search and Rulebase Servers

Specify appropriate switches to start an XML Search Server, Synchronization Search Server, HTTP Search Server, Rulebase Server, or a combined Search and Rulebase Servers.
Run the following command to start a Search Server or a Rulebase Server:
  • On Windows:
    %SSABIN%\ssasrsv <Switches>
  • On UNIX:
    $SSABIN/ssasrsv <Switches>
If you want to start a Search Server or a Rulebase Server as a background process, run the following command:
  • On Windows:
    start "<Window Title>" %SSABIN%\ssasrsv <Switches>
  • On UNIX:
    $SSABIN/ssasrsv <Switches> &
Use the following switches when you start a Search Server or a Rulebase Server:
-n<SePort>
Starts a Search Server that listens for client connections on the specified port number.
-x<XmPort>
Starts an XML Search Server that listens for client connections on the specified port number.
-s<XsPort>
Starts a Synchronization Server that listens for client connections on the specified port number.
-disable-idtlock
Removes the lock on the Identity Table. If the Identity Table is not locked, you can run multiple Synchronization Servers in parallel. When you have multiple transactions for a record, different Synchronization Servers might process the transactions out of order, which can cause data integrity errors. Use this switch with caution.
-H<HtPort>
Starts a HTTP Search Server that listens for client connections on the specified port number.
-m<RbPort>
Starts a RuleBase Server that listens for client connections on the specified port number.
-h<Host>:<Port>
Starts a Search Server configured to access a remote Rulebase Server. Specify the host name of the Search Server and the port number on which the server listens for client connections. Use the
-h
switch with the
-m
switch.
-readonly
Starts the Search Server and the Rulebase Server, and runs the Rulebase Server in the read-only mode.
The following sample command runs the Rulebase Server in the read-only mode:
$SSABIN/ssasrsv -readonly -mlocalhost:1666 -nlocalhost:1667 &
-readonly-no-socket
Starts the Search Server and the Rulebase Server, and runs the Rulebase Server in the read-only mode. Use this switch when you do not want to specify a port number for the Rulebase Server.
The following sample command runs the Rulebase Server in the read-only mode:
$SSABIN/ssasrsv -n$SSA_SEPORT -readonly-no-socket &
-g<Rulebase Server Group>
Specifies the Rulebase Server Group.
-use-abort
Applicable only for UNIX. Performs a forced restart of the Rulebase Server. Use this switch only if the Rulebase Server does not restart after a database connection failure.
-w<n>
Specifies the polling frequency of a Rulebase Server Group in seconds. Default is 1.
-z<Host Name1>:<Port1>[,<Host Name2>:<Port2>,<Host Name3>:<Port3>…, <Host NameN>:<PortN>
List of ZooKeeper servers based on the host name of the ZooKeeper server and the port on which the host listens for connections.
-z<n>
Specifies the number of requested match threads. The default value is 1. Specify this argument if your typical usage is a small number of long running searches that might require multiple threads.
-y<Max>[,<Wait>]
Specifies the maximum number of times to retry (Max) when a connection to the database fails and the number of seconds (Wait) that a Search Server or the Rulebase Server waits to retry the connection. For example,
-y5,3
indicates that the Search Server or the Rulebase Server can try up to five times to connect to the database for every three seconds. The default value is
0,0
. If
Max=0
, the Search Server or the Rulebase Server retries indefinitely until the connection to the database succeeds.
-1<File>
Specifies the file that logs the standard output messages (
stdout
).
-2<File>
Specifies the file that logs the standard error messages (
stderr
).
-3<File>
Optional. Specifies the file that logs the error and debug messages.
-u<Rulebase Options>
Controls optional aspects of the Rulebase Server behavior.
Use the following Rulebase Server options:
  • 0x0001 (1
    10
    ). Stores the Rulebase cache in memory when no users are currently connected. Specifying this option improves the Rulebase Server performance, and omitting this option reduces the memory utilization.
  • 0x0100 (256
    10
    ). Forces the Rulebase Server to restart when a Rulebase read operation fails. This option is helpful when the database server bounces and disconnects the Rulebase Server’s connections. If you do not set this option, the Rulebase Server might fail a client’s requests that require database access. However, the clients that access the cached rules function normally.
The value that you specify with the
-u
switch is treated as a decimal value, unless you prefix the value with
x
. You can specify a combination of options by adding the values together. For example, to store the Rulebase cache in memory and force the server to restart on a read error, specify
-ux101
or
-u257
.
Use the following guidelines when you start a server:
  • To start a combined Search and Rulebase Servers, specify the
    -n
    and
    -m
    switches.
  • To start a standalone Search Server, specify the
    -n
    and
    -h
    switch.
  • To start a standalone Rulebase Server, specify the
    -m
    switch.
  • To start a standalone XML Search Server, specify the
    -x
    switch.
  • To start a standalone Synchronization Server, specify the
    -s
    switch.
  • To start a standalone HTTP Search Server, specify the
    -H
    switch.

0 COMMENTS

We’d like to hear from you!