Fossil SCM

Added docs for IIS + CGI server configuration.

wyoung 2019-08-18 03:53 server-docs
Commit 9098ebba2d32218a25420132d8a343d910ea5b42b3dc4fe9e38f33ecd27b90ed
Parent 1670e5fac609dba…
6 files changed +1 -1 +28 +3
~ www/server.wiki + www/server/windows/cgi-bin-perm.png + www/server/windows/cgi-exec-perm.png + www/server/windows/cgi-script-map.png + www/server/windows/cgi.md ~ www/server/windows/iis.md
M www/server.wiki
+1 -1
--- www/server.wiki
+++ www/server.wiki
@@ -129,11 +129,11 @@
129129
 <th style="background-color: #e8e8e8; padding: 6px; text-align: right">Windows</th>
130130
 <td style="text-align: center">❌</td>
131131
 <td style="text-align: center">❌</td>
132132
 <td style="text-align: center">❌</td>
133133
 <td style="text-align: center"><a href="./server/windows/stunnel.md">✅</a></td>
134
- <td style="text-align: center">❌</td>
134
+ <td style="text-align: center"><a href="./server/windows/cgi.md">✅</a></td>
135135
 <td style="text-align: center">❌</td>
136136
 <td style="text-align: center">❌</td>
137137
 <td style="text-align: center">❌</td>
138138
 <td style="text-align: center">❌</td>
139139
 <td style="text-align: center"><a href="./server/windows/iis.md">✅</a></td>
140140
141141
ADDED www/server/windows/cgi-bin-perm.png
142142
ADDED www/server/windows/cgi-exec-perm.png
143143
ADDED www/server/windows/cgi-script-map.png
144144
ADDED www/server/windows/cgi.md
--- www/server.wiki
+++ www/server.wiki
@@ -129,11 +129,11 @@
129 <th style="background-color: #e8e8e8; padding: 6px; text-align: right">Windows</th>
130 <td style="text-align: center">❌</td>
131 <td style="text-align: center">❌</td>
132 <td style="text-align: center">❌</td>
133 <td style="text-align: center"><a href="./server/windows/stunnel.md">✅</a></td>
134 <td style="text-align: center">❌</td>
135 <td style="text-align: center">❌</td>
136 <td style="text-align: center">❌</td>
137 <td style="text-align: center">❌</td>
138 <td style="text-align: center">❌</td>
139 <td style="text-align: center"><a href="./server/windows/iis.md">✅</a></td>
140
141 DDED www/server/windows/cgi-bin-perm.png
142 DDED www/server/windows/cgi-exec-perm.png
143 DDED www/server/windows/cgi-script-map.png
144 DDED www/server/windows/cgi.md
--- www/server.wiki
+++ www/server.wiki
@@ -129,11 +129,11 @@
129 <th style="background-color: #e8e8e8; padding: 6px; text-align: right">Windows</th>
130 <td style="text-align: center">❌</td>
131 <td style="text-align: center">❌</td>
132 <td style="text-align: center">❌</td>
133 <td style="text-align: center"><a href="./server/windows/stunnel.md">✅</a></td>
134 <td style="text-align: center"><a href="./server/windows/cgi.md">✅</a></td>
135 <td style="text-align: center">❌</td>
136 <td style="text-align: center">❌</td>
137 <td style="text-align: center">❌</td>
138 <td style="text-align: center">❌</td>
139 <td style="text-align: center"><a href="./server/windows/iis.md">✅</a></td>
140
141 DDED www/server/windows/cgi-bin-perm.png
142 DDED www/server/windows/cgi-exec-perm.png
143 DDED www/server/windows/cgi-script-map.png
144 DDED www/server/windows/cgi.md
A www/server/windows/cgi.md
+28
--- a/www/server/windows/cgi.md
+++ b/www/server/windows/cgi.md
@@ -0,0 +1,28 @@
1
+# Serving via IIS + CGI
2
+
3
+## This Is Not the Method You Are Looking For
4
+
5
+Setting up CGI service under IIS is surprisingly complicated compared to
6
+running Fossil as a CGI under most other operating systems. We recommend
7
+that you use the simpler [reverse proxying method](./iis.md) instead
8
+unless there is some compelling reason why that method cannot work for
9
+you, such as its dependence on non-stock IIS extensions. (Keep in mind
10
+that both extensions it requires are by Microsoft, not third parties!)
11
+
12
+Once you’ve got this scheme working, it gives the same benefits as those
13
+listed at the top of the linked-to document.
14
+
15
+There is a small benefit you get from using CGI over reverse proxying on
16
+other OSes, which is that the Fossil program only runs briefly in order
17
+to serve each HTTP hit. Onon steps below
18
+ assume you’re using the Windows and IIS GUIs, which have RAM
19
+ requirements well in excess of this, making Fossil’s resource
20
+ requirements a drop in the bucket next to them. On the [Azure
21
+ B1s][b1s] virtual machine I used to prepare these instructions, the
22
+ Windows Server Managr GUI kept filling the VM’s 1&nbsp;GiB of RAM
23
+ during feature installation and crashing. I had to upgrade the VM’s
24
+ RAM to 2&nbsp;GiB just to get useful work done!
25
+
26
+2. Process creation on Windows is [much test VM I
27
+ a Fossil
28
+
--- a/www/server/windows/cgi.md
+++ b/www/server/windows/cgi.md
@@ -0,0 +1,28 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
--- a/www/server/windows/cgi.md
+++ b/www/server/windows/cgi.md
@@ -0,0 +1,28 @@
1 # Serving via IIS + CGI
2
3 ## This Is Not the Method You Are Looking For
4
5 Setting up CGI service under IIS is surprisingly complicated compared to
6 running Fossil as a CGI under most other operating systems. We recommend
7 that you use the simpler [reverse proxying method](./iis.md) instead
8 unless there is some compelling reason why that method cannot work for
9 you, such as its dependence on non-stock IIS extensions. (Keep in mind
10 that both extensions it requires are by Microsoft, not third parties!)
11
12 Once you’ve got this scheme working, it gives the same benefits as those
13 listed at the top of the linked-to document.
14
15 There is a small benefit you get from using CGI over reverse proxying on
16 other OSes, which is that the Fossil program only runs briefly in order
17 to serve each HTTP hit. Onon steps below
18 assume you’re using the Windows and IIS GUIs, which have RAM
19 requirements well in excess of this, making Fossil’s resource
20 requirements a drop in the bucket next to them. On the [Azure
21 B1s][b1s] virtual machine I used to prepare these instructions, the
22 Windows Server Managr GUI kept filling the VM’s 1&nbsp;GiB of RAM
23 during feature installation and crashing. I had to upgrade the VM’s
24 RAM to 2&nbsp;GiB just to get useful work done!
25
26 2. Process creation on Windows is [much test VM I
27 a Fossil
28
M www/server/windows/iis.md
+3
--- www/server/windows/iis.md
+++ www/server/windows/iis.md
@@ -20,10 +20,13 @@
2020
 your static content into Fossil as versioned or unversioned
2121
 artifacts.
2222
2323
 This article shows how you can get any combination of those benefits by
2424
 using IIS as a reverse proxy for `fossil server`.
25
+
26
+There are other ways to use IIS to serve Fossil, such as [via
27
+CGI](./cgi.md).
2528
2629
2730
 ## Background Fossil Service Setup
2831
2932
 You will need to have the Fossil HTTP server running in the background,
3033
--- www/server/windows/iis.md
+++ www/server/windows/iis.md
@@ -20,10 +20,13 @@
20 your static content into Fossil as versioned or unversioned
21 artifacts.
22
23 This article shows how you can get any combination of those benefits by
24 using IIS as a reverse proxy for `fossil server`.
 
 
 
25
26
27 ## Background Fossil Service Setup
28
29 You will need to have the Fossil HTTP server running in the background,
30
--- www/server/windows/iis.md
+++ www/server/windows/iis.md
@@ -20,10 +20,13 @@
20 your static content into Fossil as versioned or unversioned
21 artifacts.
22
23 This article shows how you can get any combination of those benefits by
24 using IIS as a reverse proxy for `fossil server`.
25
26 There are other ways to use IIS to serve Fossil, such as [via
27 CGI](./cgi.md).
28
29
30 ## Background Fossil Service Setup
31
32 You will need to have the Fossil HTTP server running in the background,
33

Keyboard Shortcuts

Open search /
Next entry (timeline) j
Previous entry (timeline) k
Open focused entry Enter
Show this help ?
Toggle theme Top nav button