Persist the Child Process

By default, in out-of-process filtering, the parent process maintains a persistent connection with the child server after each file is filtered. When the connection is preserved in this way, subsequent filtering requests are processed more quickly because the server is already prepared to receive data.

You can restart the server at regular intervals by using a method or a configuration setting.

In the API

To force KeyView to restart, call the refreshFilterKVOOP() method.

public void refreshFilterKVOOP();

In the formats.ini File

To control whether Filter persists the server, use the kvoopRefresh parameter in the [FilterSDK_Config] section of the formats.ini file:

kvoopRefresh=0 When this is set to 0 (zero), the connection to the server is persisted for as long as the parent process is running or until the server fails. This is the default.
kvoopRefresh=n

When this is set to n, the connection is persisted for n filter requests. After the nth request, the server is shutdown and restarted before processing the next request.

For example, if kvooprefresh=5, the connection to the server is persisted for 5 filter requests. For the 6th request, the server is shutdown and restarted.

To control whether the parent process attempts to filter a file after the file has caused the server to fail, use the kvoopRetry parameter in the [FilterSDK_Config] section of the formats.ini file:

kvoopRetry=0 When this option is set to 0 and the server fails, the parent process does not resend the file to a new server.
kvoopRetry=n When this option is set to n (a positive number) and the server fails, the parent process resends the file to a new server n times. By default, the kvoopRetry is set to 1, and the file is resent to a server once.

The formats.ini file is in the directory install\OS\bin, where install is the path name of the Filter installation directory and OS is the name of the operating system.

NOTE:

The kvoopRefresh and kvoopRetry parameters do no apply when running the File Extraction functions out of process. See Run File Extraction Functions Out of Process.


_HP_HTML5_bannerTitle.htm