1mod_mono(8) ASP.NET Support for Apache mod_mono(8)
3
7 mod_mono - apache module that enables ASP.NET pages. Works together
8 with mod-mono-server.exe
9
11 mod_mono is a simple module that works with both 1.3 and 2.0 versions
12 of apache.
13 It needs mod-mono-server.exe installed on the system. By default, it
15 will attemp to run mod-mono-server.exe if it doesn't find it's running.
16
18 All the directives but MonoSetServerAlias accept an optional first
19 argument that is the mod-mono-server instance alias for which the
20 directive applies. If only one argument is provided for them, thr
21 directive will apply to the 'default' mod-mono-server instance. Refer
22 to the monodoc documentation on configuring mod_mono for more examples.
23 MonoUnixUmask
26 It accepts an octal number as a parameter. The number must be a
27 valid unix file creation mask value (see umask(2)). The mask
28 will be applied whenever a directory or file is created from
29 within an ASP.NET application. Default value: "0077".
30 MonoUnixSocket
32 It accepts a file name as argument. That file will be a named
33 pipe used to send/receive data from/to mod_mono to/from mod-
34 mono-server. You cannot use MonoListenPort and MonoUnixSocket
35 at the same time. Default value: "/tmp/mod_mono_server".
36 MonoListenPort
38 TCP port on which mod-mono-server should listen/is listening on.
39 Mutually exclusive with MonoUnixSocket. When this options is
40 specified, mod-mono-server and mod_mono will use a TCP socket
41 for communication. Default value: none
42 MonoListenAddress
44 IP address where mod-mono-server should listen/is listening on.
45 Can only be used when MonoListenPort is specified. Default
46 value: "127.0.0.1"
47 MonoRunXSP
49 If the value is True, it tells mod_mono to spawn mod-mono-
50 server.exe if it's not already running. If set to False, most of
51 these directives are useless. Default value: True
52 MonoExecutablePath (Obsoleted, ignored)
54 Don't use this. It is ignored and has been left here for compat‐
55 ibility purposes. Default value: "/usr/bin/mono"
56 MonoPath
58 This value will be used to set the MONO_PATH environment vari‐
59 able. Default value: ""
60 MonoServerPath
62 The full path to the mod-mono-server script. Default value:
63 "/usr/bin/mod-mono-server"
64 MonoWapiDir
66 The directory where mono runtime will create the ".wapi" direc‐
67 tory used to emulate windows I/O. It's used to set
68 MONO_SHARED_DIR. Default value: "/tmp"
69 MonoDocumentRootDir
71 The directory passed in --root argument when launching mod-mono-
72 server.
73 MonoMaxCPUTime
75 If MonoRunXSP is True, CPU time limit in seconds allowed for the
76 spawned mono process. Beyond that, it will be restarted. If this
77 capability is not available on your system, the directive will
78 be ignored. Default value: system default
79 MonoMaxMemory
81 If MonoRunXSP is True, the maximum size of the process's data
82 segment (data size) in bytes allowed for the spawned mono
83 process. It will be restarted when the limit is reached. If
84 this capability is not available on your system, the directive
85 will be ignored. Default value: system default
86 MonoApplications
88 AddMonoApplications
90 This value will be passed to mod-mono-server.exe in the --appli‐
91 cations option. See xsp(1) manual page for details.
92 MonoApplicationsConfigFile
94 The argument passed in --appconfigfile argument to mod-mono-
95 server. Default value: NULL.
96 MonoApplicationsConfigDir
98 The argument passed in --appconfigdir argument to mod-mono-
99 server. Default value: config/mod-mono-applications
100 Note that you must specify at least one of MonoApplications, MonoAppli‐
102 cationsConfigFile and MonoApplicationsConfigDir.
103 MonoAutoApplication
105 Enables or disables automatic ASP.NET applications discovery. By
106 default it is enabled if you have no application configured.
107 Otherwise, it's disabled. The possible values are 'enabled' or
108 'disabled'.
109 MonoDebug
111 Runs mono in debug mode, which produces stack traces with line
112 numbers. Default value: false.
113 MonoSetServerAlias
115 Takes a server alias name. This is to be used inside <Directory>
116 or <Location>. Default value: 'default' if the directive is not
117 used.
118 MonoSetEnv
120 Takes a string of 'name=value' pairs separated by semicolons.
121 For each pair, it calls setenv (name, value) before running mod-
122 mono-server.
123
125 This one using <Directory>:
126 LoadModule mono_module /usr/lib/apache/1.3/libmod_mono.so
127 AddModule mod_mono.c
128 Alias /mono "/usr/lib/xsp/test"
129 AddMonoApplications default "/mono:/usr/lib/xsp/test"
130 <Directory /usr/lib/xsp/test>
131 SetHandler mono
132 <IfModule mod_dir.c>
133 DirectoryIndex index.aspx
134 </IfModule>
135 </Directory>
136 This one using <Location>:
138 LoadModule mono_module modules/libmod_mono.so
139 Alias /demo "/usr/lib/xsp/test"
140 AddMonoApplications default "/demo:/usr/lib/xsp/test"
141 <Location /demo>
142 SetHandler mono
143 </Location>
144 If you prefer to .webapp configuration file(s) (see manual page of
147 xsp), you can change MonoApplications in the above samples by:
148 MonoApplicationsConfigFile default "/var/www/applications.webapp"
150 replacing the path to the file with yours.
152 If you want to use several .webapp files, use this instead:
154 MonoApplicationsConfigDir default "/var/www/webapp"
156 and all the .webapp files found in the directory /var/www/webapp will
158 be loaded.
159 Refer to monodoc documentation on configuring mod_mono for more exam‐
161 ples.
162
164 mod_mono provides a simple web-based control panel for restarting the
165 mod-mono-server, which is useful when assemblies need to be reloaded
166 from disk after they have been changed. To activate the control panel,
167 place the following in your httpd.conf:
168 <Location /mono>
170 SetHandler mono-ctrl
171 Order deny,allow
172 Deny from all
173 Allow from 127.0.0.1
174 </Location>
175 The control panel is then accessible at http://yourdomain.com/mono.
177 Clicking the link to restart mod-mono-server will immediately restart
178 it.
179 The Order/Deny/Allow access controls above restrict access to the con‐
181 trol panel to the computer with IP address 127.0.0.1. Replace this (or
182 add more Allow lines) with the IP address of your own computer so that
183 you can access the control panel. You can also use Apache's htaccess
184 features to password protect it, too.
185
187 It may modify MONO_PATH, PATH and MONO_SHARED_DIR when starting mod-
188 mono-server.
189 The MOD_MONO_CCV variable may be used to select which component will do
191 client certificate validity (CCV) checks. By default both Apache and
192 Mono will verify the client certificates. This can be changed to either
193 "apache" or "mono" to limit the validity check to either environment.
194 This variable can be set using MonoSetEnv to allow different vhost to
195 use separate validation techniques.
196
198 httpd.conf
199
201 mod_mono was started by Daniel Ridruejo (daniel rawbyte com). Cur‐
202 rently, Gonzalo Paniagua Javier (gonzalo ximian.com) is the maintainer.
203
205 See http://mail.ximian.com/mailman/mono-list for details.
206
208 Visit http://www.go-mono.com for details.
209
211 xsp(1),mod-mono-server(1),mono(1),mcs(1)
212mod_mono 1.2.1 9 Feb 2005 mod_mono(8)