Servertec iws.ini
Content
Introduction
Release Notes
Features
FAQs
Requirements
Installation
How To
Change Log
Future Plans
Knowledge Base
Documentation
Conventions
Command Line
Administrator
Localization
Programming
Security
Performance
Deployment
Server API
Servlet / JSP API
Xerces API
CGI
SSI
Servlets
Config Files
acl.ini
aliases.ini
archives.ini
computers.ini
contexts.ini
dbpools.ini
groups.ini
hosts.ini
iws.ini
locales.ini
logger.ini
messages.ini
mimetypes.ini
realms.ini
resources.ini
rights.ini
servlets.ini
session.ini
templates.ini
users.ini
workgroup.ini

Log Files
Classes
Directory Tree
Examples
Legal
Contact Us

 

iws.ini, contains general parameters used by Servertec Information Server.

Syntax

backlog = backlog
connections = connections
connection_pool_interval = connection_pool_interval
content_encodings = content_encodings
content_negotiation = content_negotiation
content_types = content_types
contextdir = contextdir
debug = debug
default = default_files
default_charset = default_charset
default_content_encoding = default_content_encoding
default_content_type = default_content_type
default_country = default_country
default_language = default_language
default_variant = default_variant
dns_lookup = dns_lookup_enabled
input_buffer_size = input_buffer_size
ip_address = ip_address
keep_alive = keep_alive_enabled
keep_alive_timeout = keep_alive_timeout
keep_alive_requests = keep_alive_requests
linger = linger
max_client_requests = max_client_requests
max_connections = max_connections
max_request_content_length = max_request_content_length
max_request_header_count = max_request_header_count
max_request_header_length = max_request_header_length
multiline_request_headers = multiline_request_headers
nodelay = nodelay
obscure_server = obscure_server
output_buffer_size = output_buffer_size
password = password
plain_socket_handler = plain_socket_handler
port = port
preload_servlets = servlets
remote_admin = remote_admin_enabled
security = security_enabled
send_vary = send_vary
server_protocol = server_protocol
server_socket_timeout = server_socket_timeout
servlet_chaining = servlet_chaining_enabled
shell = shell_access_enabled
shutdown_delay = shutdown_delay
socket_receive_buffer_size = socket_receive_buffer_size
socket_send_buffer_size = socket_send_buffer_size
socket_source = socket_source
socket_timeout = socket_timeout
templatesdir = templatesdir
username = user_name
wait_on_close = wait_on_close
wait_on_full = wait_on_full

backlog the maximum number of pending request to queue.

50 is the default value.

The number specified must be greater than or equal to 0.

connections the default number of worker threads to startup.

25 is the default value.

The number specified must be greater than or equal to 5.

connection_pool_interval the number of minutes between running the Connection Pool Monitor.

5 minutes is the default value.

-1 can be used to keep connections open in the pool. Using this value may result in database connection timeouts.

The number must be at least 1.

Setting this value too small may impact performance and setting this value too large can result in database connection timeouts.

content_encodings zero or more comma delimited key=value pairs representing supported content encoding and associated file extension.

Used when determining which content encodings are supported by stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet when responding to requests.

Normally not set.

If not set then stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet do not send the Content-Encoding response header when responding to requests.

Used when content_negotiation is set to y.

content_negotiation whether to use Accept, Accept-Language, Accept-Charset and Accept-Encoding request headers when determining which file or directory to return to the browser.

y use Accept, Accept-Language, Accept-Charset and Accept-Encoding.

n is the default value.

Setting this value to y may have a negative impact on performance.

If content_negotiation is set to y then stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet will try to return the file or directory that best matches the content type, language, charset and content encoding specified in the request or the default_content_type, default_language, default_charset and default_content_encoding.

If content_negotiation is set to y then stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet will set Content-Type, Content-Language and Content-Encoding response header to the file or directory that best matches the content type, language, charset and content encoding specified in the request or the default_content_type default_language, default_charset and default_content_encoding.

If content_negotiation is set to n then stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet will set Content-Type, Content-Language and Content-Encoding response header to any default_language, default_charset and default_content_encoding specified.

If content_negotiation is set to y the search order will be:

uri.content_type_extension.language
  .charset.content_encoding_extension
uri.content_type_extension.language
  .charset
uri.content_type_extension.language
  .content_encoding_extension
uri.content_type_extension.language
uri.content_type_extension
  .content_encoding_extension
uri.content_type_extension
uri.language.charset
  .content_encoding_extension
uri.language.charset
uri.language.content_encoding_extension
uri.language
uri.content_encoding_extension
uri.default_content_type_extension
  .default_language.default_charset
  .default_content_encoding_extension
uri.default_content_type_extension
  .default_language.default_charset
uri.default_content_type_extension
  .default_language
  .default_content_encoding_extension
uri.default_content_type_extension
  .default_language
uri.default_content_type_extension
  .default_content_encoding_extension
uri.default_content_type_extension
uri.default_language.default_charset
  .default_content_encoding_extension
uri.default_language.default_charset
uri.default_language
  .default_content_encoding_extension
uri.default_language
uri.default_content_encoding_extension
uri

  • uri - the uri requested.
  • content_type_extension - the content type extension as derived from content_types from the content type specified in Accept request header. If more than one content type was specified then the content types specified will be ordered by importance.
  • language - the language encoding as specified in Accept-Language request header. If more than one language was specified then the languages specified will be ordered by importance.
  • charset - the charset as specified in Accept-Charset request header. If more than one charset was specified then the charsets specified will be ordered by importance.
  • content_encoding_extension - the content encoding extension as derived from content_encodings from the content encoding specified in Accept-Encoding request header. If more than one content encoding was specified then the content encodings specified will be ordered by importance.
  • default_content_type_extension - the default content type extension as specified in default_content_type.
  • default_language - the default language encoding as specified in default_language.
  • default_charset - the default charset as specified in default_charset.
  • default_content_encoding_extension - the default content encoding extension as specified in default_content_encoding.

    For example, if the requested uri was /index and Accept was text/html, Accept-Language was ru, Accept-Charset was IBM866, Accept-Encoding was gzip, default_content_type was text/html=.html, default_language was en, default_charset was iso-8859-1, default_content_encoding was gzip and content_encodings was gzip=.gz then the seach order would be:

    index.html.ru.IBM866.gz
    index.html.ru.IBM866
    index.html.ru.gz
    index.html.ru
    index.html.gz
    index.gz
    index.html.en.iso-8859-1.gz
    index.html.en.iso-8859-1
    index.html.en.gz
    index.html.en
    index.html.gz
    index.html
    index.gz
    index

  • content_types zero or more comma delimited key=value pairs representing supported content type and associated file extension.

    Used when determining which content types are supported by stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet when responding to requests.

    Normally not set.

    Used when content_negotiation is set to y.

    contextdir the directory used by the Servlet Context Manager as a temporary work area for servlet contexts and session store.

    ./contexts is the default value.

    If a relative directory is specified then the directory is relative to the server's base directory.

    debug whether to capture all requests made to the server and all responses made by the server.

    n is the default value.

    Setting this value to y may have a negative impact on performance.

    When set to y each request and corresponding numbered response is saved in separate flat files in iws_dir/debug, where iws_dir is the directory where Servertec Internet Server was installed or deployed.

    default_charset the character encoding used when responding to requests.

    Used when determining which content type stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet should use when responding to requests.

    Normally not set.

    If not set then stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet do not send the Content-Type response header when responding to requests.

    Used when content_negotiation is set to y.

    default_content_encoding key=value pair representing the default content encoding and associated file extension.

    Used when determining which content encoding stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet should use when responding to requests.

    Normally not set.

    If not set then stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet does not send the Content-Encoding response header when responding to requests.

    Used when content_negotiation is set to y.

    default_content_type key=value pair representing the default content type and associated file extension.

    Used when determining which content type stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet should use when responding to requests.

    Normally not set.

    Used when content_negotiation is set to y.

    default_country the country used when setting the server's Locale.

    Normally not set.

    If not set then the default country is used when setting the server's Locale.

    default_files the name of the default html document to use when one is not specified.

    index.html is the default value for Servertec Internet Server.

    Zero or more comma delimited file names can be specified.

    default_language the language used when setting the server's Locale and when determining which language stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet should use when responding to requests.

    Normally not set.

    If not set then the default Locale is used and stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet do not send the Language response header when responding to requests.

    default_variant the variant used when setting the server's Locale.

    Normally not set.

    If not set then the default variant is used when setting the server's Locale.

    dns_lookup_enabled whether to lookup the name of the remote client.

    Use y to enable and n to disable.

    If set to n then the IP address of the remote client will be used.

    n is the default value.

    Setting this value to y may have a negative impact on performance.

    input_buffer_size the size of the request input buffer in bytes.

    Must be at least 0.

    -1 is the default value.

    -1 is used to specify the default request input buffer size.

    Setting this value too small or too large may impact performance.

    ip_address the IP address or the host name to listen to.

    * indicates any IP address or host name.

    * is the default value.

    IP addresses in the form N.N.N.N, where N is a number from 0 to 255.

    keep_alive_enabled used to indicate whether the connection should be kept opened between requests.

    Use y to enable and n to disable.

    y is the default value.

    Setting this value to n may have a negative impact on performance.

    keep_alive_requests the maximum number of consecutive requests that will be allowed before the connection is closed.

    100 is the default value.

    -1 can be used to always keep the connection alive. Using this value is dangerous and opens the server to Denial of Service (DOS) attacks.

    The number must be at least 5.

    Setting this value too large may result in Denial of Service (DOS) attacks.

    keep_alive_timeout the maximum number of seconds to service a client requests before closing the connection.

    15 seconds is the default value.

    -1 can be used to always keep the connection alive. Using this value is dangerous and opens the server to Denial of Service (DOS) attacks.

    The number must be 15 or more seconds.

    Setting this value too large may result in Denial of Service (DOS) attacks.

    linger the number of seconds to wait when closing the socket if data is present.

    0 specifies that the socket should be close as soon as possible.

    -1 specifies that the platform's default value should be used.

    -1 is the default value.

    Used when wait_on_close is set to y.

    Changing this value may have a negative impact on performance and on the server's reliability.

    max_client_requests the maximum number of concurrent requests that a client can make.

    Must be at least 1.

    -1 is the default value.

    -1 is used to specify unlimited number of concurrent requests.

    Setting this value too small will result in the server blocking valid requests.

    Setting this value to -1 weakens security and can be exploited by Denial Of Service (DOS) attacks.

    max_connections the maximum number of worker threads to startup.

    50 is the default value.

    The value must be greater than or equal to the number of connections.

    max_request_header_length the maximum length allowed for request headers.

    Must be at least 128.

    -1 is the default value.

    -1 is used to specify unlimited header length.

    Setting this value too small will result in the server blocking valid requests.

    Setting this value too large may impact performance.

    Setting this value to -1 weakens security and can be exploited by Denial Of Service (DOS) attacks.

    max_request_header_count the maximum number of request headers allowed.

    Must be at least 32.

    -1 is the default value.

    -1 is used to allow unlimited number of headers.

    Setting this value too small will result in the server blocking valid requests.

    Setting this value too large may impact performance.

    Setting this value to -1 weakens security and can be exploited by Denial Of Service (DOS) attacks.

    max_request_content_length the maximum content length allowed for post data.

    Must be at least 128.

    -1 is the default value.

    -1 is used to specify unlimited content length.

    Setting this value too small will result in the server blocking valid requests.

    Setting this value too large may impact performance.

    Setting this value to -1 weakens security and can be exploited by Denial Of Service (DOS) attacks.

    multiline_request_headers whether to support multiline request headers as used by Content-Type: Multipart/Related.

    Required by SOAP applications.

    y specifies that multiline request headers will be supported.

    n specifies that multiline request headers will not be supported.

    Normally set to n.

    Setting this value to y may have a negative impact on performance and may result in the server not properly processing request headers.

    no_delay whether data written to the network is not buffered pending acknowledgement of previsouly written data.

    y specifies that Nagle's algorithm should be used, TCP_NODELAY is enabled.

    n specifies that Nagle's algorithm should not be used, TCP_NODELAY is disabled.

    If not set then the platform's default value should be used.

    Normally not set.

    Changing this value may have a negative impact on performance and on the server's reliability.

    obscure_server whether to obscure the identity of the server.

    n is the default value.

    Setting this value to y results in the Server response header not being sent and the FileServlet responding with 404 Not Found for requests for directories when directory access is disabled.

    output_buffer_size the size of the response output buffer in bytes.

    Must be at least 0.

    8192 is the default value.

    -1 is used to specify the default response output buffer size.

    Setting this value too small or too large may impact performance.

    password the password of the administrator.

    admin is the default password.

    plain_socket_handler in the form class_file{?parameter{&parameter}...}

    class_file the Class in the form package.class of the Socket Handler to use.
    parameter any parameters used during the initialization of the Socket Handler.

    Zero or more & delimited key=value pairs can be specified.

    stec.iws.PlainSocketHandler is the default value.

    port the port number to use, a value from 1 to 65536.

    8080 is the default port for Servertec Information Server.

    80 is the default port for Web Servers.

    Only one application at a time can use any given port number.

    remote_admin_enabled whether to allow computers other than localhost (127.0.0.1) to administer the server.

    Use y to enable and n to disable.

    y is the default value.

    Setting this value to y is potentially a security hole.

    security_enabled whether to check if a client can access resources being requested.

    Use y to enable and n to disable.

    y is the default value.

    Setting this value to y may have a negative impact on performance.

    send_vary whether stec.iws.FileServlet, stec.iws.ServletTagServlet and stec.iws.SSIncludeServlet will send the Vary response header when Content Negotiation is set to y.

    The Vary response header details the content type, language, charset and content encoding of the response.

    n is the default value.

    Setting this value to y may have a negative impact on performance and may not work with all Web browsers.

    server_protocol the HTTP server protocol to use.

    Dynamic is the default value for Servertec Internet Server.

    HTTP/1.0 allows compatibility with legacy Proxy Servers.

    Dynamic allows the server to determine the protocol to use based on the client's request.

    Some Web browsers supporting HTTP/1.1 make requests using HTTP/1.0 until the server response with HTTP/1.1.

    Setting this value incorrectly may have a negative impact on performance.

    server_socket_timeout the number of milliseconds to wait for a client to make a requesst before timing out.

    -1 is the default value.

    If -1 is used then the server socket will never timeout. Using this value may result in the server hanging during shutdown when the server is restarted or stopped.

    If the value is less 1000 then 1000 will be used.

    servlet_chaining_enabled whether to allow Servlet chaining.

    Use y to enable and n to disable.

    n is the default value.

    Setting this value to y may have a negative impact on performance.

    servlets any Servlets defined in servlets.ini to preload.

    Zero or more comma delimited list of Servlet aliases.

    Normally FileServlet is loaded.

    shell_access_enabled whether to allow CGI scripts and SSI #exec to have shell access.

    Use y to enable and n to disable.

    n is the default value.

    Setting this value to y is potentially a security hole.

    shutdown_delay the number of seconds to wait for requests being processed to complete before shutting down the server.

    60 seconds is the default value.

    -1 can be used to wait for all requests to finish processing. Using this value may result in the server hanging while trying to shutdown waiting for a request the will never complete.

    socket_receive_buffer_size the size in bytes of the socket receive buffer, SO_RCVBUF.

    -1 is the default value.

    -1 is used to specify the default socket receive buffer size.

    Setting this value too small or too large may impact performance.

    socket_send_buffer_size the size in bytes of the socket send buffer, SO_SNDBUF

    -1 is the default value.

    -1 is used to specify the default socket send buffer size.

    Setting this value too small or too large may impact performance.

    socket_source The method used to obtain a socket.

    main specifies that the server's main thread waits for client requests and deligates requests to a pool of waiting worker threads.

    queue specifies that the server's main thread waits for client requests and queues the requests for a pool or waiting worker threads and that the next available worker thread processes the next request. This value opens the server to Denial of Service (DOS) attacks.

    worker specifies that a pool of worker threads wait for client requests and that the operating system determines which worker thread should process the next request.

    main is the default value.

    Changing this value may have a negative impact on performance.

    socket_timeout the number of milliseconds to wait for the client to respond before closing the connection.

    300000 milliseconds (5 minutes) is the default value.

    If -1 is used then the connection will never timeout. Using this value is dangerous and opens the server to Denial of Service (DOS) attacks.

    If the value is less 1000 then 1000 will be used.

    templatesdir the directory where templates used by the server are located.

    ./templates is the default value.

    If a relative directory is specified then the directory is relative to the server's base directory.

    user_name the username of the administrator.

    admin is the default username.

    wait_on_close whether to wait on close if data is present, SO_LINGER.

    y specifies that the thread should wait on close if data is present, SO_LINGER is enabled.

    n specifies that the thread should not wait on close if data is present, SO_LINGER is disabled.

    If not set then the platform's default value should be used.

    If y then linger is used to specify the number of seconds to wait.

    Changing this value may have a negative impact on performance and on the server's reliability.

    wait_on_full whether the main thread should wait for the next available worker or close the socket when the server is unable to process the next request because all worker threads are currently processing requests.

    n is the default value.

    Setting this value to y may have a negative impact on performance and opens the server to Denial of Service (DOS) attacks.

    Notes

    Administrators should immediately change the default Username/Password from the Server form [Login > Monitor > Control Panel > Manage > Server].

    Username/Password should not be any obvious word, easily guessed terms, should be at least 8 characters and should contain letters, numeric and symbols.

    Additionally Username/Password should be kept private, with limited disclosure and should be changed frequently.

    Changes made to configuration files will not be used until the server is restarted.

    Example

    connections = 25
    max_connections = 50
    socket_timeout = 300000
    ip_address = *
    port = 8080
    default = index.html
    shell = n
    username = admin
    password = admin
    keep_alive = y
    keep_alive_timeout = 15
    keep_alive_requests = 100
    preload_servlets = FileServlet
    security = y
    shutdown_delay = 60
    dns_lookup = n
    backlog = 50
    remote_admin = y
    servlet_chaining = n
    connection_pool_interval = 5
    contextdir = ./contexts
    templatesdir = ./templates
    plain_socket_handler = stec.iws.PlainSocketHandler
    server_socket_timeout = -1
    input_buffer_size = -1
    output_buffer_size = -1
    server_protocol =
    wait_on_full = n
    wait_on_close =
    linger =
    nodelay =
    debug = n
    content_negotiation = n
    send_vary = n
    default_language =
    default_country =
    default_variant =
    default_charset =
    max_request_header_length = -1
    max_request_header_count = -1
    max_request_content_length = -1
    socket_send_buffer_size = -1
    socket_receive_buffer_size = -1
    socket_source = main
    default_content_encoding =
    content_encodings =
    default_content_type =
    content_types =
    multiline_request_header = n
    obscure_server = n
    max_client_requests = -1
     top of page
    Copyright © 1998-2005 Servertec. All rights reserved.
    Privacy Statement.
    Last Modified: Sun Sep 04 14:57:18 EDT 2005