Interstage Shunsaku Data Manager Operator's Guide - Microsoft(R) Windows(R) 2000/ Microsoft(R) Windows Server(TM) 2003 - - UNIX -

B.3.1 Example of Setting Basic Configuration

This section shows how to set parameters in environment files for a basic configuration.

• Single Server Configuration
• Configuration in which Searchers Run on Separate Servers

Single Server Configuration

For a single server configuration, specifies the information of conductor, director, sorter and searcher at the system environment file.

Configuration
Shunsaku system name		shunsaku
Director server		DirSvr1
	Conductor identifier	shunc
	Director identifier	shund1
	Sorter identifier	shuno1
	Searcher identifier	shuns01

Examples of setting each configuration are shown below:

Condition
Shunsaku installation directory	C:\Program Files\Interstage Shunsaku\
Director data file storage directory	C:\Shunsaku\
Operation log file storage directory	C:\Shunbackup\ope\
Character code of the lookup data	UTF-8
Number of concurrent processes (number of search requests that is process at once + sort requests)	5 concurrent processes (search request: 3, sort request: 2)
Case sensitivity for alphanumeric characters	Do not match case
Case sensitivity for multi-byte alphabetic characters	Do not match case
Characters that will not be searched	Space (single-byte, multi-byte), linefeed character, horizontal tab
Maximum number of responses to the application	100 records
Outputting log file	Output the log file (switch the file at 100 MB)
Number of back up log file	100
Number of days that the log file will be switched	30 days
Outputting performance log file	Output the log file (switch the file at 100 MB)
Number of performance backup log file	100
Number of days that performance log file will be switched	30 days
Outputting operation log file	Output the log file
Maximum response wait time for the search process	60 seconds
Searching attribute value	Search the attribute value

(1) System Environment File

System environment file: shunsaku.cfg

Conductor          shunc DirSvr1 33101
Sorter             shuno1 DirSvr1 33201
Director           shund1 DirSvr1 33301 33302 33303
Searcher           shuns01 DirSvr1 33501 shund1
CharacterCode      UTF-8 ----------------------------------------(a)
ANKmix             1 --------------------------------------------(b)
KNJmix             1 --------------------------------------------(c)
SkipChar           "\s,\S,\n,\t" --------------------------------(d)
SearchAttribute    0 --------------------------------------------(e)

1. Specifies character code (UTF-8) for lookup data at the CharacterCode parameter.
2. Specifies 1 (Do not match case sensitivity for alphanumeric characters) at the ANKmix parameter.
3. Specifies 1 (Do not match case sensitivity for multi-byte alphabetic characters) at the KNJmix parameter.
4. Specifies the characters that are not part of the search target (\s: single-byte space, \S: multi-byte space, \n: linefeed, \t: horizontal tab) by enclosing those characters in double quotes at the SkipChar parameter.
5. Specifies 0 (search the attribute value) at the SearchAttribute parameter.

Specifies the ANKmix, KNJmix, and SkipChar parameters in the system environment file to omit the specification in director environment file.

(2) Conductor environment File

Conductor environment file: shunc.cfg

LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\conductor\" ------(a)
LogFileSize         100 -----------------------------------------------------------------(b)
LogFileBackup       100------------------------------------------------------------------(c)
LogFileSwitch       30 ------------------------------------------------------------------(d)
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\conductor\" ------(e)
PfmFileSize         100 -----------------------------------------------------------------(f)
PfmFileBackup       100 -----------------------------------------------------------------(g)
PfmFileSwitch       30 ------------------------------------------------------------------(h)
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\conductor\" -----(i)
AnsMax              100 -----------------------------------------------------------------(j)
MaxConnection       10 ------------------------------------------------------------------(k)

1. Specifies the storage directory of log files at the LogFileFolder parameter with the absolute path. Specifies at the LogFileFolder parameter in director, sorter, and searcher environment files as same as this conductor environment file.
2. Specifies the size (100 as a default) at which the conductor log file will switch over for the LogFileSize parameter. The unit of the number is megabyte.
3. Specifies the number of backup log file (100 as a default) at the LogFileBackup parameter. Specifies at the LogFileBackup parameter in director, sorter, and searcher environment files as same as this conductor environment file.
4. Specifies the Number of days that the log file will be switched (30 as a default) for the LogFileSwitch parameter. Specifies at the LogFileSwitch parameter in director, sorter, and searcher environment files as same as this conductor environment file.
5. Specifies the storage directory of performance log files at the PfmFileFolder parameter with the absolute path. Specifies at the PfmFileFolder parameter in director, sorter, and searcher environment files as same as this conductor environment file.
6. Specifies the size (100 as a default) at which the conductor performance log file will switch over for the PfmFileSize parameter. The unit of the number is megabyte.
7. Specifies the number of performance backup log file (100 as a default) at the PfmFileBackup parameter. Specifies at the PfmFileBackup parameter in director, sorter, and searcher environment files as same as this conductor environment file.
8. Specifies the Number of days that the performance log file will be switched (30 as a default) for the PfmFileSwitch parameter. Specifies at the PfmFileSwitch parameter in director, sorter, and searcher environment files as same as this conductor environment file.
9. Specifies the storage directory of core file at the CoreFileFolder parameter with the absolute path when an error occurs. Specifies at the CoreFileFolder parameter in director, sorter, and searcher environment files as same as this conductor environment file.
10. Specifies the maximum number of responses to the application (100 as a default). If Shunsaku API is used and is accessed through the conductor, specifies the AnsMax parameter in the conductor environment file.
    (Omit the AnsMax parameter in the director environment file)
11. Specifies the maximum number of connections to the conductor (10 as a default) at the MaxConnection parameter.

(3)Director Environment File

Director environment file: shund1.cfg

DataFileFolder      C:\Shunsaku\ --------------------------------------------------------(a)
LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\director\"
LogFileSize         100
LogFileBackup       100
LogFileSwitch       30
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\director\"
PfmFileSize         100
PfmFileBackup       100
PfmFileSwitch       30
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\director\"
OperationLogFolder  D:\Shunbackup\ope\---------------------------------------------------(b)
MultiMax            5 -------------------------------------------------------------------(c)
SearcherWTimer      60 ------------------------------------------------------------------(d)

1. Specifies the storage directory of the director data file at the DataFileFolder parameter with the absolute path.
2. Specifies the storage directory of the operation log file at the OperationLogFolder parameter with the absolute path.
3. Specifies the maximum number of search requests that can be received at once (5 as a default) for the MultiMax parameter.
4. Specifies the maximum time to wait for a search response from the searcher (60 as a default) at the SearcherWTimer parameter. The unit of the number is second.
   Also specifies the maximum wait time at the WaitTimer parameter in the API environment file.

(4)Sorter Environment File

Sorter environment file: shuno1.cfg

MultiMax            2 ------------------------------------------------------------------(a)
LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\sorter\"
LogFileSize         100
LogFileBackup       100
LogFileSwitch       30
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\sorter\"
PfmFileSize         100
PfmFileBackup       100
PfmFileSwitch       30
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\sorter\"

1. Specifies the maximum number of sort or aggregation requests (2 as a default) that can be received at once for the MultiMax parameter.

(5)Searcher Environment File

Searcher environment file: shuns01.cfg

LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\searcher\"
LogFileSize         100
LogFileBackup       100
LogFileSwitch       30
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\searcher\"
PfmFileSize         100
PfmFileBackup       100
PfmFileSwitch       30
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\searcher\"

Configuration in which Searchers Run on Separate Servers

If the conductor, director and sorter are allocated in the director server, and searchers run on separate servers, edit the system environment file in the director server that conductor is allocated. Then distributes it to the search servers.

Configuration
Shunsaku system name		shunsaku
Director server		DirSvr1
	Conductor identifier	shunc
	Director identifier	shund1
	Sorter identifier	shuno1
Search server		SchSvr01
	Searcher identifier	shuns01 shuns02

Examples of setting system environment file are shown below:

Condition
Shunsaku installation directory	C:\Program Files\Interstage Shunsaku\
Director data file storage directory	C:\Shunsaku\
Operation log file storage directory	C:\Shunbackup\ope\
Character code of the lookup data	UTF-8
Number of concurrent processes (number of search requests that is process at once + sort requests)	5 concurrent processes (search request: 3, sort request: 2)
Case sensitivity for alphanumeric characters	Do not match case
Case sensitivity for multi-byte alphabetic characters	Do not match case
Characters that will not be searched	Space (single-byte, multi-byte), linefeed character, horizontal tab
Maximum number of responses to the application	100 records
Outputting log file	Output the log file (switch the file at 100 MB)
Number of back up log file	100
Number of days that the log file will be switched	30 days
Outputting performance log file	Output the log file (switch the file at 100 MB)
Number of performance backup log file	100
Number of days that performance log file will be switched	30 days
Outputting operation log file	Output the log file
Maximum response wait time for the search process	60 seconds
Scope that is regarded as abnormal when searcher abnormalities occur	Regard only the target searcher as abnormal
Maximum number of searchers that is degradable	1

(1) System Environment File

System environment file: shunsaku.cfg

Conductor          shunc DirSvr1 33101
Sorter             shuno1 DirSvr1 33201
Director           shund1 DirSvr1 33301 33302 33303
Searcher           shuns01 SchSvr01 33501 shund1 ----------------(a)
Searcher           shuns02 SchSvr01 33502 shund1 ----------------(a)
CharacterCode      UTF-8 ----------------------------------------(b)
ANKmix             1 --------------------------------------------(c)
KNJmix             1 --------------------------------------------(d)
SkipChar           "\s,\S,\n,\t" --------------------------------(e)
SearcherFailureEscalation    0 ----------------------------------(f)
DegradableSearcherCnt  1 ----------------------------------------(g)

1. Adds all the searcher information on the search server (Searcher identifier, host name or IP address, port number for receiving requests from directors, director identifier of the connected director) at the Searcher parameter.
   If multiple searchers are allocated in one server, specifies different port number to each searcher. If multiple searchers are allocated in different servers, the same port number can be specified.
2. Specifies character code (UTF-8) for lookup data at the CharacterCode parameter.
3. Specifies 1 (Do not match case sensitivity for alphanumeric characters) at the ANKmix parameter.
4. Specifies 1 (Do not match case sensitivity for multi-byte alphabetic characters) at the KNJmix parameter.
5. Specifies the characters that are not part of the search target (\s: single-byte space, \S: multi-byte space, \n: linefeed, \t: horizontal tab) by enclosing those characters in double quotes at the SkipChar parameter.
6. When a searcher abnormality is detected on a search server where multiple searchers have been allocated, specifies 0 at the SearcherFailureEscalation parameter to regard only the target searcher as abnormal. Specifies 1 to regard entire search server where the target searcher is allocated as abnormal.
7. Specifies the maximum number of searchers that is degradable (1 as a default) at the DegradableSearcherCnt parameter.

Specifies the ANKmix, KNJmix, and SkipChar parameters in the system environment file to omit the specification in director environment file.

(2)Conductor Environment File

Conductor environment file: shunc.cfg

LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\conductor\" ------(a)
LogFileSize         100 -----------------------------------------------------------------(b)
LogFileBackup       100------------------------------------------------------------------(c)
LogFileSwitch       30 ------------------------------------------------------------------(d)
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\conductor\" ------(e)
PfmFileSize         100 -----------------------------------------------------------------(f)
PfmFileBackup       100 -----------------------------------------------------------------(g)
PfmFileSwitch       30 ------------------------------------------------------------------(h)
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\conductor\" -----(i)
AnsMax              100 -----------------------------------------------------------------(j)
MaxConnection       10 ------------------------------------------------------------------(k)

1. Specifies the storage directory of log files at the LogFileFolder parameter with the absolute path. Specifies at the LogFileFolder parameter in director, sorter, and searcher environment files as same as this conductor environment file.
2. Specifies the size (100 as a default) at which the conductor log file will switch over for the LogFileSize parameter. The unit of the number is megabyte.
3. Specifies the number of backup log file (100 as a default) at the LogFileBackup parameter. Specifies at the LogFileBackup parameter in director, sorter, and searcher environment files as same as this conductor environment file.
4. Specifies the Number of days that the log file will be switched (30 as a default) for the LogFileSwitch parameter. Specifies at the LogFileSwitch parameter in director, sorter, and searcher environment files as same as this conductor environment file.
5. Specifies the storage directory of performance log files at the PfmFileFolder parameter with the absolute path. Specifies at the PfmFileFolder parameter in director, sorter, and searcher environment files as same as this conductor environment file.
6. Specifies the size (100 as a default) at which the conductor performance log file will switch over for the PfmFileSize parameter. The unit of the number is megabyte.
7. Specifies the number of performance backup log file (100 as a default) at the PfmFileBackup parameter. Specifies at the PfmFileBackup parameter in director, sorter, and searcher environment files as same as this conductor environment file.
8. Specifies the Number of days that the performance log file will be switched (30 as a default) for the PfmFileSwitch parameter. Specifies at the PfmFileSwitch parameter in director, sorter, and searcher environment files as same as this conductor environment file.
9. Specifies the storage directory of core file at the CoreFileFolder parameter with the absolute path when an error occurs. Specifies at the CoreFileFolder parameter in director, sorter, and searcher environment files as same as this conductor environment file.
10. Specifies the maximum number of responses to the application (100 as a default). If Shunsaku API is used and is accessed through the conductor, specifies the AnsMax parameter in the conductor environment file.
    (Omit the AnsMax parameter in the director environment file)
11. Specifies the maximum number of connections to the conductor (10 as a default) at the MaxConnection parameter.

(3)Director Environment File

Director environment file: shund1.cfg

DataFileFolder      C:\Shunsaku\ --------------------------------------------------------(a)
LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\director\"
LogFileSize         100
LogFileBackup       100
LogFileSwitch       30
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\director\"
PfmFileSize         100
PfmFileBackup       100
PfmFileSwitch       30
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\director\"
OperationLogFolder  C:\Shunbackup\ope ---------------------------------------------------(b)
MultiMax            5 -------------------------------------------------------------------(c)
SearcherWTimer      60 ------------------------------------------------------------------(d)

1. Specifies the storage directory of the director data file at the DataFileFolder parameter with the absolute path.
2. Specifies the storage directory of the operation log file at the OperationLogFolder parameter with the absolute path.
3. Specifies the maximum number of search requests that can be received at once (5 as a default) for the MultiMax parameter.
4. Specifies the maximum time to wait for a search response from the searcher (60 as a default) at the SearcherWTimer parameter. The unit of the number is second.
   Also specifies the maximum wait time at the WaitTimer parameter in the API environment file.

(4)Sorter Environment File

Sorter environment file: shuno1.cfg

MultiMax            2 ------------------------------------------------------------------(a)
LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\sorter\"
LogFileSize         100
LogFileBackup       100
LogFileSwitch       30
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\sorter\"
PfmFileSize         100
PfmFileBackup       100
PfmFileSwitch       30
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\sorter\"

1. Specifies the maximum number of sort or aggregation requests (2 as a default) that can be received at once for the MultiMax parameter.

(5)Searcher Environment File

Searcher environment file: shuns01.cfg

LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\searcher\"
LogFileSize         100
LogFileBackup       100
LogFileSwitch       30
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\searcher\"
PfmFileSize         100
PfmFileBackup       100
PfmFileSwitch       30
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\searcher\"

(6)Searcher Environment File

Searcher environment file: shuns02.cfg

LogFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\searcher\"
LogFileSize         100
LogFileBackup       100
LogFileSwitch       30
PfmFileFolder       "C:\Program Files\Interstage Shunsaku\Shunsaku\log\searcher\"
PfmFileSize         100
PfmFileBackup       100
PfmFileSwitch       30
CoreFileFolder      "C:\Program Files\Interstage Shunsaku\Shunsaku\core\searcher\"