@@ -20,6 +20,8 @@ <h2>Requirements</h2>
2020Wt for Windows uses the built-in web server connector or the ISAPI connector.
2121The fastcgi connector is not supported. The built-in web server is more
2222convenient during development and is easier to setup than the ISAPI connector.
23+ It is also designed for production environments, where it is often used in
24+ combination with a reverse proxy server.
2325To use the built-in server, you have to link your projects against libwt
2426and libwthttp. To use the ISAPI connector, you have to link to libwtisapi
2527instead of libwthttp.</ p >
@@ -41,8 +43,6 @@ <h2>Requirements</h2>
4143< li > Postgres, mysql, firebird client libraries for Dbo database backends</ li >
4244< li > < a href ="http://libharu.org/ "> Haru Free PDF Library</ a > , which is used to
4345provide support for rendering PDF (WPdfImage, WPdfRenderer).</ li >
44- < li > < a href ="http://www.graphicsmagick.org/ "> GraphicsMagick</ a > , for
45- supporting painting to raster images (PNG, GIF, ...) (WRasterImage).</ li >
4646</ ul >
4747</ p >
4848
@@ -99,26 +99,102 @@ <h4>1. Run the example in the MSVC IDE </h4>
9999
100100< pre >
101101General options:
102- -h [ --help ] produce help message
103- -t [ --threads ] arg (=10) number of threads
104- --docroot arg document root for static files
105- --no-compression do not compress dynamic text/html and text/plain
106- responses
107- --deploy-path arg (=/) location for deployment
108-
109- HTTP server options:
110- --http-address arg IPv4 (e.g. 0.0.0.0) or IPv6 Address (e.g. 0::0)
111- --http-port arg (=80) HTTP port (e.g. 80)
112-
113- HTTPS server options:
114- --https-address arg IPv4 (e.g. 0.0.0.0) or IPv6 Address (e.g. 0::0)
115- --https-port arg (=443) HTTPS port (e.g. 443)
116- --ssl-certificate arg SSL server certificate chain file
117- e.g. "/etc/ssl/certs/vsign1.pem"
118- --ssl-private-key arg SSL server private key file
119- e.g. "/etc/ssl/private/company.pem"
120- --ssl-tmp-dh arg File for temporary Diffie-Hellman parameters
121- e.g. "/etc/ssl/dh512.pem"
102+ -h [ --help ] produce help message
103+ -t [ --threads ] arg (=-1) number of threads (-1 indicates that
104+ num_threads from wt_config.xml is to be
105+ used, which defaults to 10)
106+ --servername arg (=diffie) servername (IP address or DNS name)
107+ --docroot arg document root for static files,
108+ optionally followed by a
109+ comma-separated list of paths with
110+ static files (even if they are within a
111+ deployment path), after a ';'
112+
113+ e.g. --docroot=".;/favicon.ico,/resourc
114+ es,/style"
115+
116+ --approot arg application root for private support
117+ files; if unspecified, the value of the
118+ environment variable $WT_APP_ROOT is
119+ used, or else the current working
120+ directory
121+ --errroot arg root for error pages
122+ --accesslog arg access log file (defaults to stdout),
123+ to disable access logging completely,
124+ use --accesslog=-
125+ --no-compression do not use compression
126+ --deploy-path arg (=/) location for deployment
127+ --session-id-prefix arg prefix for session IDs (overrides
128+ wt_config.xml setting)
129+ -p [ --pid-file ] arg path to pid file (optional)
130+ -c [ --config ] arg location of wt_config.xml; if
131+ unspecified, the value of the
132+ environment variable $WT_CONFIG_XML is
133+ used, or else the built-in default
134+ (c:/witty/wt_config.xml) is tried, or
135+ else built-in defaults are used
136+ --max-memory-request-size arg (=131072)
137+ threshold for request size (bytes), for
138+ spooling the entire request to disk, to
139+ avoid DoS
140+ --gdb do not shutdown when receiving Ctrl-C
141+ (and let gdb break instead)
142+
143+ HTTP/WebSocket server options:
144+ --http-address arg IPv4 (e.g. 0.0.0.0) or IPv6 Address
145+ (e.g. 0::0). You must specify either
146+ this option or --https-address (or
147+ both)
148+ --http-port arg (=80) HTTP port (e.g. 80)
149+
150+ HTTPS/Secure WebSocket server options:
151+ --https-address arg IPv4 (e.g. 0.0.0.0) or IPv6 Address
152+ (e.g. 0::0). You must specify either
153+ this option or --http-address (or both)
154+ --https-port arg (=443) HTTPS port (e.g. 443)
155+ --ssl-certificate arg SSL server certificate chain file
156+ e.g. "/etc/ssl/certs/vsign1.pem"
157+ --ssl-private-key arg SSL server private key file
158+ e.g. "/etc/ssl/private/company.pem"
159+ --ssl-tmp-dh arg File for temporary Diffie-Hellman
160+ parameters
161+ e.g. "/etc/ssl/dh512.pem"
162+ --ssl-enable-v3 Switch on SSLv3 support (not
163+ recommended; disabled by default)
164+ --ssl-client-verification arg (=none) The verification mode for client
165+ certificates.
166+ This is either 'none', 'optional' or
167+ 'required'. When 'none', the server
168+ will not request a client certificate.
169+ When 'optional', the server will
170+ request a certificate, but the client
171+ does not have to supply one. With
172+ 'required', the connection will be
173+ terminated if the client does not
174+ provide a valid certificate.
175+ --ssl-verify-depth arg (=1) Specifies the maximum length of the
176+ server certificate chain.
177+
178+ --ssl-ca-certificates arg Path to a file containing the
179+ concatenated trusted CA certificates,
180+ which can be used to authenticate the
181+ client. The file should contains a a
182+ number of PEM-encoded certificates.
183+
184+ --ssl-cipherlist arg List of acceptable ciphers for SSL.
185+ This list is passed as-is to the SSL
186+ layer, so see openssl for the proper
187+ syntax. When empty, the default
188+ acceptable cipher list will be used.
189+ Example cipher list string:
190+ "TLSv1+HIGH:!SSLv2"
191+
192+ --ssl-prefer-server-ciphers arg (=0) By default, the client's preference is
193+ used for determining the cipher that is
194+ choosen during a SSL or TLS handshake.
195+ By enabling this option, the server's
196+ preference will be used.
197+
122198</ pre >
123199</ p >
124200
0 commit comments