Search server configurator

DssCss configurator provides easy changes of Search server configuration. You can run it from Start menu -> CallChange Server -> Css configurator or by \Program Files\Common Files\Datasys\DsCssSrv\DsCssCfg.exe.

Program displays a few tabs, which enable to configure common settings, searched sets and individual data providers.

General tab contains common settings:

Log - if checked, Search server generates log about its work (used for debugging)
Log directory - folder where log file is written to
XML port - port for client to server communication using XML RPC protocol
Normalizer custom configuration - opens dialog for setting phone number normalizer
Cache reload - time in seconds, when this time expires, contact cache is updated (refreshed)
Automatic cache reload - if checked, automatic cache update is enabled
Cache directory - folder, where contact database (cache) is located
ADO connection - configuration of search server ADO database connection
ADO user - DB user for ADO connection (optional; takes precedence over user in ADO connection)
synchronous connection - setting for synchronous/asynchronous connection
ADO password - open dialog for entering DB password (optional; takes precedence over password in ADO connection)

When program is being closed, ADO connection is tested for correctness - user is notified about error.

Description of normalizer settings - see installation.

Sets tab allows searched set of contacts definition:

Insert button adds a new set into the list
Edit button opens dialog for set editation
Remove button removes selected set from the list

Sets can be renamed: click on the set to highlight the line and then click it again - name will be offered for change (easier way is to press F2 key). If you doubleclick on the set, you start set editation.

During editation of existing set you can not change the provider Type - it is possible only for newly created set (or sets which contain no connection string). Using Edit/Insert/Remove buttons you can edit, add or remove connection strings in the set.
Dialogs for connection string setting differ according used provider type - enter desired information. Deeper description of individual parameters (also mentioned further) can be found here.

When configuring set with EX provider, program tries to connect to the mailbox specified in the EX provider configuration (if you are logged on under account used by Search server). If attempt is unsuccessful, it tries to use active Outlook session (Outlook must be configured and running). If connection is successful, list of public folders and GAL addresslists is offered for set configuration.

WARNING - if you are connected using active Outlook session, you can see in GAL addresslist also items from Outlook Address Book. If you select such item for searching, Search server will not be able to use it (it is available only to client, not to server). Therefore you should be logged in using the same account as Search server uses for its work.

Another tabs contain individual providers configuration. Some parts of configuration are similar for all providers:

Enable ADO/EX/LDAP/LN provider checkbox - enables this provider usage by Search server
Custom properties - list of custom properties, which will be read in addition to default properties. This list can be changed by Edit/Insert/Remove buttons

Specific settings:
ADO, LN a LDAP provider have Required properties - list of properties which are read by default. It can not be changed, you only may change mapping of required fields (Symbolic name) to fields of ADO, LN or LDAP source (Field name) using Edit button. Also you may change Default value of any field (it is used, if given field doesn't exist in source).

EX provider requires for its function mailbox - it can be specified using EX server (Exchange server name) and Mailbox (mailbox name) parameters or when Use profile is checked, enter name of configured Outlook profile. Search server must have right to use this mailbox / profile.

Public folders prefix - name of public folders root folder. Select correct value based on language version of Outlook you are using.

LDAP provider needs to specify code pages on LDAP side (Source CP - set according reality) and Search server side (Destination CP - usually CP1250). Last parameter is LDAP filter - limiting condition for getting data from LDAP complying to RFC 2254.

LN provider configuration contains additional button Number costs for setting various phone number costs (see here).
Select one from Custom properties in "Property Name" field, which gives document type. Using Edit/Insert/Remove buttons you can edit cost assignment based on document type and phone number types (example on the picture: office phone found in Firm document has cost 1, mobile phone found in Person document has cost 2).
After parameter change is necessary to restart Search server (UMS.Search service) to make new settings active. If you change list of Custom properties, you must also delete current database, otherwise database column number doesn't match and Search server doesn't work.