|
1 | | -# MapServer and Apache |
2 | | - |
3 | | -!!! warning |
4 | | - |
5 | | - This page is currently in a draft form. |
6 | | - |
7 | | -## Overview |
8 | | - |
9 | | -The Apache web server is used by the workshop Docker image. Since version 8.0 MapServer has a global config file. |
10 | | - |
11 | | -At its heart MapServer is a command-line application that can be accessed through a web server. |
12 | | - |
13 | | -Apache has a [configuration file](https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/etc/apache2/conf-enabled/mapserver.conf). |
14 | | -The Docker image uses a [start-up script(https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/usr/local/bin/start-server). |
15 | | - |
16 | | -MapServer uses the [mod_fcgid module](https://httpd.apache.org/mod_fcgid/), which is an Apache module that provides FastCGI support. |
17 | | - |
18 | | -``` |
19 | | -FcgidMaxRequestsPerProcess ${MAX_REQUESTS_PER_PROCESS} |
20 | | -FcgidMinProcessesPerClass ${MIN_PROCESSES} |
21 | | -FcgidMaxProcessesPerClass ${MAX_PROCESSES} |
22 | | -FcgidBusyTimeout ${BUSY_TIMEOUT} |
23 | | -FcgidIdleTimeout ${IDLE_TIMEOUT} |
24 | | -FcgidIOTimeout ${IO_TIMEOUT} |
25 | | -``` |
26 | | - |
27 | | -These are all documented on the [reference page(https://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html). |
28 | | - |
29 | | -These all have defaults in the Docker file, but can be overridden using environment variables. |
30 | | - |
31 | | -``` |
32 | | -ENV MS_DEBUGLEVEL=0 \ |
33 | | - MS_ERRORFILE=stderr \ |
34 | | - MAPSERVER_CONFIG_FILE=/etc/mapserver.conf \ |
35 | | - MAPSERVER_BASE_PATH= \ |
36 | | - MAX_REQUESTS_PER_PROCESS=1000 \ |
37 | | - MIN_PROCESSES=1 \ |
38 | | - MAX_PROCESSES=5 \ |
39 | | - BUSY_TIMEOUT=300 \ |
40 | | - IDLE_TIMEOUT=300 \ |
41 | | -``` |
42 | | - |
43 | | - |
44 | | -All requests to the server are mapped to [mapserv_wrapper](https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/usr/local/bin/mapserv_wrapper) - a small wrapper script. |
45 | | - |
46 | | -``` |
47 | | -ScriptAliasMatch "^${MAPSERVER_BASE_PATH}/(.*)" /usr/local/bin/mapserv_wrapper/$1 |
48 | | -ScriptAliasMatch "^${MAPSERVER_BASE_PATH}" /usr/local/bin/mapserv_wrapper |
49 | | -``` |
50 | | - |
51 | | -Restarting Apache: |
52 | | - |
53 | | -```bash |
54 | | -docker restart mapserver |
55 | | -``` |
56 | | - |
57 | | -## Other Web Servers |
58 | | - |
59 | | -* [IIS](https://mapserver.org/installation/iis.html) |
| 1 | +# MapServer and Apache |
| 2 | + |
| 3 | +!!! warning |
| 4 | + |
| 5 | + This page is currently in a draft form. |
| 6 | + |
| 7 | +## Overview |
| 8 | + |
| 9 | +The Apache web server is used by the workshop Docker image. Since version 8.0 MapServer has a global config file. |
| 10 | + |
| 11 | +At its heart MapServer is a command-line application that can be accessed through a web server. |
| 12 | + |
| 13 | +Apache has a [configuration file](https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/etc/apache2/conf-enabled/mapserver.conf). |
| 14 | +The Docker image uses a [start-up script(https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/usr/local/bin/start-server). |
| 15 | + |
| 16 | +MapServer uses the [mod_fcgid module](https://httpd.apache.org/mod_fcgid/), which is an Apache module that provides FastCGI support. |
| 17 | + |
| 18 | +``` |
| 19 | +FcgidMaxRequestsPerProcess ${MAX_REQUESTS_PER_PROCESS} |
| 20 | +FcgidMinProcessesPerClass ${MIN_PROCESSES} |
| 21 | +FcgidMaxProcessesPerClass ${MAX_PROCESSES} |
| 22 | +FcgidBusyTimeout ${BUSY_TIMEOUT} |
| 23 | +FcgidIdleTimeout ${IDLE_TIMEOUT} |
| 24 | +FcgidIOTimeout ${IO_TIMEOUT} |
| 25 | +``` |
| 26 | + |
| 27 | +These are all documented on the [reference page(https://httpd.apache.org/mod_fcgid/mod/mod_fcgid.html). |
| 28 | + |
| 29 | +These all have defaults in the Docker file, but can be overridden using environment variables. |
| 30 | + |
| 31 | +``` |
| 32 | +ENV MS_DEBUGLEVEL=0 \ |
| 33 | + MS_ERRORFILE=stderr \ |
| 34 | + MAPSERVER_CONFIG_FILE=/etc/mapserver.conf \ |
| 35 | + MAPSERVER_BASE_PATH= \ |
| 36 | + MAX_REQUESTS_PER_PROCESS=1000 \ |
| 37 | + MIN_PROCESSES=1 \ |
| 38 | + MAX_PROCESSES=5 \ |
| 39 | + BUSY_TIMEOUT=300 \ |
| 40 | + IDLE_TIMEOUT=300 \ |
| 41 | +``` |
| 42 | + |
| 43 | + |
| 44 | +All requests to the server are mapped to [mapserv_wrapper](https://github.com/MapServer/getting-started-with-mapserver/blob/main/docker/runtime/usr/local/bin/mapserv_wrapper) - a small wrapper script. |
| 45 | + |
| 46 | +``` |
| 47 | +ScriptAliasMatch "^${MAPSERVER_BASE_PATH}/(.*)" /usr/local/bin/mapserv_wrapper/$1 |
| 48 | +ScriptAliasMatch "^${MAPSERVER_BASE_PATH}" /usr/local/bin/mapserv_wrapper |
| 49 | +``` |
| 50 | + |
| 51 | +Restarting Apache: |
| 52 | + |
| 53 | +```bash |
| 54 | +docker restart mapserver |
| 55 | +``` |
| 56 | + |
| 57 | +## Other Web Servers |
| 58 | + |
| 59 | +* [IIS](https://mapserver.org/installation/iis.html) |
0 commit comments