sources/appweb/appWeb.conf

   1 #
   2 #       normal.conf -- Default Configuration for the Mbedthis AppWeb HTTP Server
   3 #
   4 #       This configuration file controls the operation of the AppWeb
   5 #       server. The order of configuration directives matters as this
   6 #       file is parsed only once. You must put the server root and error
   7 #       log definitions first to ensure configuration errors are logged.
   8 #
   9
  10 #
  11 #       Root directory for AppWeb to find necessary files and DLLs.
  12 #       AppWeb will change directory to this location when it runs.
  13 #
  14 ServerRoot "/opt/var/appWeb"
  15
  16 #
  17 #       Log all AppWeb errors and trace to this file. This is the error
  18 #       file for the whole server including all virtual hosts.
  19 #
  20 ErrorLog logs/error.log
  21
  22 #
  23 #       The log level can be a number between 0 and 9 (most verbose level).
  24 #
  25 LogLevel 2
  26
  27 #
  28 #       Name of the server to use for redirects and error responses to the
  29 #       clients. Uncomment this line and replace it with the public name of your
  30 #       server. This host name and port do not get used for listening on
  31 #       sockets.
  32 #
  33 #       ServerName http://localhost:7777
  34
  35 #
  36 #       Location for documents for the primary server host. Virtual hosts
  37 #       may define their own DocumentRoot directives.
  38 #
  39 DocumentRoot "./web"
  40
  41 #
  42 #       Bind AppWeb to listen for incoming requests on this address.
  43 #       Formats include (IP, IP:PORT, PORT). If an IP address is omitted,
  44 #       AppWeb will listen on all interfaces. If a port is omitted, then
  45 #       port 80 is used.
  46 #
  47 Listen 7777
  48
  49 #
  50 #       This will listen on port 4443 for SSL requests
  51 #
  52 Listen 4443
  53
  54 #
  55 #       Set the thread limit to 0 for single-threaded use
  56 #
  57 ThreadLimit 4
  58
  59 #
  60 #       Location of the mime translation file to map content types to
  61 #       file extensions.
  62 #
  63 TypesConfig mime.types
  64
  65 #
  66 #       DLL / Dynamic Shared Object (DSO) support. If the modules has been
  67 #       statically linked into AppWeb, these directive will be ignored.
  68 #
  69 LoadModulePath /opt/lib
  70 LoadModule admin libadminModule
  71 LoadModule auth libauthModule
  72 LoadModule cgi libcgiModule
  73 LoadModule copy libcopyModule
  74 LoadModule egi libegiModule
  75 LoadModule esp libespModule
  76 LoadModule capi libcapiModule
  77 # LoadModule compat libcompatModule
  78 # LoadModule php4 libphp4Module
  79 # LoadModule php5 libphp5Module
  80 LoadModule ssl libsslModule
  81 # LoadModule matrixSsl libmatrixSslModule
  82 LoadModule openSsl libopenSslModule
  83
  84 #
  85 #       Map handlers to file extensions. If the extension is ommitted, the
  86 #       handler itself will determine if a match to a given URL occurs. For
  87 #       example: authHandler is always run on all URLs. Handler matching
  88 #       to extensions occurs after the URL is descaped but before aliases
  89 #       are applied.
  90 #
  91 # AddHandler adminHandler
  92 AddHandler authHandler
  93 AddHandler egiHandler .egi
  94
  95 #
  96 #       For Scripts, such as your Perl scripts make sure that you have
  97 #       "#!/PerlPath" as the first line. This works on Windows as well.
  98 #       The .bat and .cmd extensions are really only for Windows.
  99 #
 100 AddHandler cgiHandler .cgi .cgi-nph .bat .cmd .pl .py
 101 AddHandler espHandler .esp .asp
 102 # AddHandler php4Handler .php
 103 # AddHandler php5Handler .php
 104 AddHandler copyHandler
 105
 106 #LINUX
 107 #
 108 #       These actions specify the program to run for each Perl or Python
 109 #       script. They map to the extensions specified in the mime.types for for
 110 #       these mime types. Alternatively, you may use put all your scripts in
 111 #       the subdirectories specified by the releavant Location blocks below.
 112 #       For perl and python, you can also put "#!/path/to/program" as the first
 113 #       line. This works on Windows as well. The .bat and .cmd extensions are
 114 #       really only for Windows. For Windows, update the program paths with
 115 #       the right paths.
 116 #
 117 Action application/x-appWeb-perl /usr/bin/perl
 118 Action application/x-appWeb-python /usr/bin/python
 119 #LINUX
 120
 121 #
 122 #       For other types, you can use AddType or edit mime.types
 123 #
 124 #       AddType application/x-appWeb-other other
 125
 126 #
 127 #       Apply handlers to given URL prefixes. I.e. this will run the Esp
 128 #       handler for all URLs that begin with "/esp".
 129 #
 130 <Location /esp>
 131         SetHandler espHandler
 132 </Location>
 133
 134 <Location /egi>
 135         SetHandler egiHandler
 136 </Location>
 137
 138 #
 139 #       This location block is equivalent to the more compact declaration:
 140 #
 141 #               ScriptAlias /cgi-bin/ "$DOCUMENT_ROOT/cgi-bin"
 142 #
 143 <Location /cgi-bin>
 144         Alias /cgi-bin/ "$DOCUMENT_ROOT/cgi-bin/"
 145         SetHandler cgiHandler
 146 </Location>
 147
 148 #
 149 #       Delete this section if you don't want the documentation visible
 150 #
 151 Redirect seeother /doc/ "http://www.appwebserver.org/products/appWeb/doc/"
 152
 153 #
 154 #       Define the log format for the access log.
 155 #
 156 CustomLog logs/access.log "%h %l %u %t \"%r\" %>s %b"
 157
 158 #
 159 #       Define persisten connections where one TCP/IP connection may serve
 160 #       multiple HTTP requests. (A definite performance boost)
 161 #
 162 KeepAlive on
 163
 164 #
 165 #       Number of seconds to wait for the next HTTP request before closing
 166 #       the TCP/IP connection.
 167 #
 168 KeepAliveTimeout 30
 169
 170 #
 171 #       Number of HTTP requests to accept on a single TCP/IP connection
 172 #
 173 MaxKeepAliveRequests 200
 174
 175 #
 176 #       Send and receive inactivity timeout to close a TCP/IP connection
 177 #
 178 Timeout 60
 179
 180 #
 181 #       The user name and group to switch to once AppWeb has started.
 182 #
 183 Group nobody
 184 User nobody
 185
 186 #
 187 #       Default directory index to serve when a directory (URL ends in "/")
 188 #        is requested.
 189 #
 190 DirectoryIndex index.html
 191
 192 #
 193 #       Uncomment this section if you do want to use SSL
 194 #       This virtual host will process SSL requests on port 4443
 195 #
 196 <VirtualHost *:4443>
 197         DocumentRoot "./web"
 198         SSLEngine on
 199         SSLCipherSuite ALL:!ADH:!EXPORT56:RC4+RSA:+HIGH:+MEDIUM:+LOW:+SSLv2:+EXP:+eNULL
 200         SSLProtocol ALL -SSLV2
 201
 202         #
 203         #       WARNING: you must regenerate the server.crt and server.key.pem
 204         #
 205         SSLCertificateFile "$SERVER_ROOT/server.crt"
 206
 207         #
 208         #       WARNING: we are using the decrypted key here so it won't prompt for the
 209         #       password. Replace with server.key for higher security
 210         #
 211         SSLCertificateKeyFile "$SERVER_ROOT/server.key.pem"
 212
 213         # Add these directives to verify client certificates
 214         #SSLVerifyClient require
 215         #SSLCACertificateFile "$SERVER_ROOT/ca.crt"
 216         #SSLCACertificatePath "$SERVER_ROOT/certs"
 217         Alias /doc/ "../doc/"
 218 </VirtualHost>
 219
 220 #
 221 #       Other useful directives. See the documentation for details.
 222 #               Alias /esp/ "$DOCUMENT_ROOT/"
 223 #               Alias /SimpleAlias/ "$DOCUMENT_ROOT/"
 224 #               Alias /AliasForMyDocuments/ "$DOCUMENT_ROOT/My Documents/"
 225 #
 226 #       Performance and security directives
 227 #               LimitResponseBody 65536
 228 #               LimitRequestBody 4194304
 229 #               LimitRequestFields 512
 230 #               LimitRequestFieldSize 1048576
 231 #               LimitRequestLine 65536
 232 #               LimitUrl 60000
 233 #               SendBufferSize 8192
 234 #               StartThreads 4
 235 #               ThreadLimit 10
 236 #               ThreadStackSize 65536
 237
 238 #       Authorization directives for basic or digest authentication
 239 #               AuthGroupFile groups.db
 240 #               AuthUserFile users.db
 241 #               AuthDigestQop auth
 242 #               <Directory $DOCUMENT_ROOT/basic/acme>
 243 #                       AuthType basic
 244 #                       AuthName "Acme Inc"
 245 #                       Require valid-user
 246 #               </Directory>
 247 #               <Directory $DOCUMENT_ROOT/digest/acme>
 248 #                       AuthType digest
 249 #                       AuthName "Acme Inc"
 250 #                       Require valid-user
 251 #               </Directory>
 252 #
 253 #
 254 #       Virtual Host directives supporting both Named and IP virtual hosts
 255 #       Note: you can nest Directory and Location directives inside
 256 #       VirtuaHost directives. To use these, you will need to add the
 257 #       relevant Listen directives. E.g. (Listen 5556).
 258 #
 259 #               NameVirtualHost *:5556
 260 #               <VirtualHost *:5556>
 261 #                       ServerName              www.myHost.com
 262 #                       DocumentRoot    "$SERVER_ROOT/myHost"
 263 #                       ScriptAlias     "/cgi-bin/" "$SERVER_ROOT/web/cgi-bin/"
 264 #               </VirtualHost>
 265 #
 266 #               <VirtualHost *:5556>
 267 #                       ServerName              www.yourHost.com
 268 #                       DocumentRoot    "$SERVER_ROOT/yourHost"
 269 #                       ResetHandlers
 270 #                       AddHandler espHandler .myEsp
 271 #                       AddHandler egiHandler
 272 #                       DirectoryIndex index.myEsp
 273 #                       <Location /myEgi>
 274 #                               SetHandler egiHandler
 275 #                       </Location>
 276 #               </VirtualHost>
 277 #
 278 #               #
 279 #               #       This virtual host will process all requests on port 5557
 280 #               #
 281 #               <VirtualHost *:5557>
 282 #                       DocumentRoot    "$SERVER_ROOT/vhostWeb/acme"
 283 #                       <Directory $DOCUMENT_ROOT/protected>
 284 #                               AuthType basic
 285 #                               AuthName "Acme Inc"
 286 #                               Require user mary
 287 #                       </Directory>
 288 #               </VirtualHost>