Changes between Version 24 and Version 25 of TracOnWindowsIis6

Timestamp:

Oct 27, 2006, 8:02:17 PM (18 years ago)

Author:

markus

Comment:

Various updates for milestone:0.10

TracOnWindowsIis6

@@ -1 @@
-== Windows Installation Instructions for Subversion w/Trac 0.9.4 ==
+== Windows Installation Instructions for Subversion w/ Trac 0.10 ==
 
 For::
  * Windows Server 2003 SP1
  * IIS 6
- * Trac 0.9.4
-
-There are some documented issues regarding running Trac on Microsoft's Internet Information Server (IIS), however it does work (albeit slowly). Refer to the following issues for details: #692 #693 and #697. 
-
-
-----
+ * Trac 0.10
+
+
 Note 1: Before continuing to set up Trac to run using IIS6, be warned that python running under IIS6 is painfully slow. It is recommended that the use of [source:trunk/README.tracd#latest tracd] be used for performance reasons. See http://lazutkin.com/blog/2006/feb/18/setting-tools-windows/ -> Section "Trac" -> Step 4. This results in a ''significant'' performance boost over CGI.
 ----
 Note 2: This example installs to F: (for extra points, then goes DarkReign hard with a separate application pool and so on.)
 ----
-Note 3: If you want to use Trac 0.10 please take a look [http://groups.google.com/group/trac-users/browse_thread/thread/98dbacece22365e2/1385d5e1e43a938c?lnk=gst&q=IIS&rnum=1#1385d5e1e43a938c here]. Do not make the modifications described in this article.
-----
+
 
 === Arm Yourself ===
@@ -22 +18 @@
 
 === Install Subversion Pre-Requisites ===
-2. Download and Install Python (Get version 2.3.5, because v2.4 doesn't have appropriate SVN plugins available).
-  http://www.python.org/download/releases/2.3.5/
+2. Download and Install Python (Get version 2.4.4, because v2.5 doesn't have appropriate SVN plugins available).
+  http://www.python.org/download/releases/2.4.4/
   
   Add F:\Python23 to path
@@ -35 +31 @@
   http://subversion.tigris.org (remember to get the python bindings as well)
 
-5. Install docutils
+5. Install docutils (optional for WikiRestructuredText)
   http://docutils.sourceforge.net/ 
 {{{
@@ -114 +110 @@
 === Install Trac Prerequisites ===
 17. Install Subversion Python Bindings
-  (Get from same download page as Subversion - http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91. Currently only supports Python 2.3 - NOT 2.4)
+  (Get from same download page as Subversion - http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91. Currently only supports Python 2.3 and Python 2.4 - NOT 2.5)
   [[br]]Copy libsvn and svn directories to F:\Python23\Lib
 
@@ -140 +136 @@
 {{{
 try:
-    from trac.web import cgi_frontend
     # PATCH IIS6 - start
     import os
-    os.environ['TRAC_ENV'] = 'F:\\tracsvn\\Trac.db'
+    os.environ['TRAC_ENV'] = "F:/tracsvn"
     # PATCH IIS6 - end
+    from trac.web import cgi_frontend
     cgi_frontend.run()
-except Exception, e:
-}}}
-
-The TRAC_ENV line is important as IIS6 won't pass this environment variable to the script when it runs. 
+except SystemExit:
+}}}
+
+The TRAC_ENV line is important as IIS6 won't pass this environment variable to the script when it runs.
+In case you're going to make use of plugins, also add `os.environ['PYTHON_EGG_CACHE'] = "F:/path/to/eggcache"`.
 
 23. Fix Python file - api.py
 
-In [F:\Python23\Lib\site-packages\trac\web\api.py], in the [redirect] function on the Request class, replace the entire function with:
-{{{
-    def redirect(self, url):
-        """Send a redirect to the client, forwarding to the specified URL. The
-        `url` may be relative or absolute, relative URLs will be translated
-        appropriately.
-        """
-        base_url = '%s://%s' % ("http", os.getenv('SERVER_NAME'))
-        if self.session:
-            self.session.save() # has to be done before the redirect is sent
-        self.send_response(302)
-        if not url.startswith('http://') and not url.startswith('https://'):
-            # Make sure the URL is absolute
-            url = absolute_url(self, url)
-        self.send_header('Location', base_url + url)
-        self.send_header('Content-Type', 'text/plain')
-        self.send_header('Pragma', 'no-cache')
-        self.send_header('Cache-control', 'no-cache')
-        self.send_header('Expires', 'Fri, 01 Jan 1999 00:00:00 GMT')
-        self._send_cookie_headers()
-        self.end_headers()
-
-        if self.method != 'HEAD':
-            self.write('Redirecting...')
-
-        raise RequestDone
-}}}
-
-
-24. Fix Python file - cgi_frontend.py
-
-In [F:\Python23\Lib\site-packages\trac\web\cgi_frontend.py], class CGIRequest, change the real_cgi_start function  where it says :
-{{{
-        self.path_info = self.__environ.get('PATH_INFO', '')
-}}}
-
-  Change this to:
-{{{
-
-        # IIS 6 Change
-        self.path_info = self.__environ.get('PATH_INFO', '')
-        self.path_info = self.path_info.replace(os.getenv('SCRIPT_NAME'),"")
-        # End IIS 6 Change
-
+In [F:\Python23\Lib\site-packages\trac\web\api.py], change [source:/tags/trac-0.10/trac/web/api.py@4070#L217 "line 217"] to:
+{{{
+path_info = property(fget=lambda self: self.environ.get('PATH_INFO','').decode('utf-8').replace(self.environ.get('SCRIPT_NAME', ''), ''),
+                     doc='Path inside the application') 
+}}}
+
+
+24. Fix Python file - main.py
+
+In [F:\Python23\Lib\site-packages\trac\web\main.py], change [source:/tags/trac-0.10/trac/web/main.py@4070#L315 "line 315"] to:
+{{{
+path_info = environ.get('PATH_INFO', '').replace(environ.get('SCRIPT_NAME', ''), '').lstrip('/').split('/') 
 }}}
 
@@ -205 +170 @@
 25. Run trac-admin 
 {{{
-f:\Python23\Scripts> python trac-admin f:/tracsvn/trac.db
+f:\Python23\Scripts> python trac-admin f:/tracsvn/
 }}}
 
@@ -213 +178 @@
 
 {{{
-Trac [f:/tracsvn/trac.db]> initdb
+Trac [f:/tracsvn]> initdb
 }}}
 or 
 {{{
-Trac [f:/tracsvn/trac.db]> initenv
+Trac [f:/tracsvn]> initenv
 }}}
 {{{
@@ -232 +197 @@
 If you get an error here stating that libdb42.dll was not found, copy ''[SVN PATH]''\bin\libdb42.dll to ''[PYTHON PATH]''\lib\libsvn\, then try again.
 
-27. (BUG) Load Wiki
-{{{
-Trac [f:/tracsvn/trac.db]> wiki load f:/python23/share/trac/wiki-default
-}}}
-
-28. Add administrative permissions (the below adds all permissions for 'admin' user)
-{{{
-Trac [f:/tracsvn/trac.db]> permission add admin TRAC_ADMIN
+27. Add administrative permissions (the below adds all permissions for 'admin' user)
+{{{
+Trac [f:/tracsvn]> permission add admin TRAC_ADMIN
 }}}
 
@@ -249 +209 @@
 
 === Finally... ===
-29. Install Subversion clients as necessary (try [http://rapidsvn.tigris.org RapidSVN] & [http://tortoisesvn.tigris.org/ TortoiseSVN])
-
-30. Don't forget to lock down the security on the box!
-
-31. Now go get a *real* drink
+28. Install Subversion clients as necessary (try [http://rapidsvn.tigris.org RapidSVN] & [http://tortoisesvn.tigris.org/ TortoiseSVN])
+
+29. Don't forget to lock down the security on the box!
+
+30. Now go get a *real* drink
+
+----
+See also:  TracGuide, TracCgi, TracFastCgi, TracUpgrade, TracPermissions, #692, #693, #697