man estserver (Administration système) - web server featuring full-text search.

NAME

estserver - web server featuring full-text search.

SYNOPSIS

estserver [-host name] [-port num] [-div num] [-uid num] [-dtype type] [-auth user:pass] [index conffile tmplfile topfile]

DESCRIPTION

This manual page documents briefly the estserver commands.

estserver is a web server featuring full-text search.

It publishes contents under the current directory, and when the URL `/estsearch' is requested, it provides interfaces of full-text search as with `estsearch.cgi'. If no argument is specified, casket is read as the inverted index, `estsearch.conf' is read as the configuration file, `estsearch.tmpl' is read as the template file, and `estsearch.top' is read as the top page file.

index specifies an inverted index created with the command `estindex'. conffile specifies the configuration file commonly used by `estsearch.cgi'. tmplfile specifies the template file commonly used by `estsearch.cgi'. topfile specifies the top page file commonly used by `estsearch.cgi'.

OPTIONS

A summary of options is included below. For a complete description, see the /usr/share/doc/estraier/spex.html

-hostname
specifies the host name. By default, the server is binded to all network interfaces, and the host name is specified with the formal name of the system.
-portnum
specifies the port number of the server. By default, it is 4210.
-divnum
specifies the number of child processes. By default, it is 4.
-uidnum
specifies the user ID of child processes. By default, it is the same with the parent. This option is available only if the executant of the parent process is the super user.
-dtypetype
specifies the content type of files without any suffix. By default, it is `application/octet-stream'.
-authuser:pass
specifies a user and his password for the basic authentication. By default, no authentication is performed.

EXAMPLES

For example, if you run the server at the port 8888 of the host `estraier.foo.edu' and publish contents under `/home/mikio/public_html', install configuration files and the inverted index there, and perform the following command. After that, access `http://estraier.foo.edu:8888/estsearch'.

cd /home/mikio/public_html

estserver -host estraier.foo.edu -port 8888 casket estsearch.conf estsearch.tmpl estsearch.top

Supported methods are GET, POST, and HEAD. CGI is not supported. The setting of `indexname', `tmplfile', and `topfile' in the prime configuration file are ignored. Log messages are output to the standard output.

Processes of this command are composed of one parent and multiple children. Requests from clients are dealt by the children. Each child exits when he have dealt 128 requests. The parent generates an alternate child as soon as a child exits. According to this mechanism, safe and parallel processing is realized. To stop the service, send SIGINT signal (Control-C) to the parent. If 0 is specified as the number of children, the parent itself deals requests.

SEE ALSO

AUTHOR

estraier was written by Mikio Hirabayashi <mikio at users.sourceforge.net>.

This manual page was written by Fumitoshi UKAI <ukai@debian.or.jp>, for the Debian project (but may be used by others).