Changes between Version 2 and Version 3 of TracStandalone

Timestamp:

20/07/2009 15:24:02 (15 years ago)

Author:

trac

Comment:

--

TracStandalone

@@ -40 +40 @@
 To exit the server on Windows, be sure to use {{{CTRL-BREAK}}} -- using {{{CTRL-C}}} will leave a Python process running in the background.
 
+== Installing as a Windows Service ==
+
+To install as a Windows service, get the [http://www.google.com/search?q=srvany.exe SRVANY] utility and run:
+{{{
+ C:\path\to\instsrv.exe tracd C:\path\to\srvany.exe
+ reg add HKLM\SYSTEM\CurrentControlSet\Services\tracd\Parameters /v Application /d "\"C:\path\to\python.exe\" \"C:\path\to\python\scripts\tracd-script.py\" <your tracd parameters>"
+ net start tracd
+}}}
+
+'''DO NOT''' use {{{tracd.exe}}}.  Instead register {{{python.exe}}} directly with {{{tracd-script.py}}} as a parameter.  If you use {{{tracd.exe}}}, it will spawn the python process without SRVANY's knowledge.  This python process will survive a {{{net stop tracd}}}.
+
+If you want tracd to start automatically when you boot Windows, do:
+{{{
+ sc config tracd start= auto
+}}}
+
+The spacing here is important.
 
 == Using Authentication ==
@@ -52 +69 @@
 then for additional users:
 {{{
-sudo htpasswd /var/www/html/.htpasswd-users username2
+sudo htpasswd /path/to/env/.htpasswd username2
 }}}
 then for starting the tracd:
@@ -95 +112 @@
 {{{
  $ tracd -p 8080 \
-   --auth=*,/path/to/users.htdigest,mycompany.com \
+   --auth="*",/path/to/users.htdigest,mycompany.com \
    /path/to/project1 /path/to/project2
 }}}
+If using the `-s` parameter for serving a Trac environment from the root of a domain, one must use `*` for the project name
 
 == How to set up an htdigest password file ==
@@ -112 +130 @@
 #!python
 from optparse import OptionParser
-import md5
+# The md5 module is deprecated in Python 2.5
+try:
+    from hashlib import md5
+except ImportError:
+    from md5 import md5
+realm = 'trac'
 
 # build the options
@@ -121 +144 @@
 parser.add_option("-p", "--password",action="store", dest="password", type = "string",
                   help="the password to use")
+parser.add_option("-r", "--realm",action="store", dest="realm", type = "string",
+                  help="the realm in which to create the digest")
 (options, args) = parser.parse_args()
 
@@ -126 +151 @@
 if (options.username is None) or (options.password is None):
    parser.error("You must supply both the username and password")
+if (options.realm is not None):
+   realm = options.realm
    
 # Generate the string to enter into the htdigest file
-realm = 'trac'
-kd = lambda x: md5.md5(':'.join(x)).hexdigest()
+kd = lambda x: md5(':'.join(x)).hexdigest()
 print ':'.join((options.username, realm, kd([options.username, realm, options.password])))
 }}}
@@ -144 +170 @@
 It is possible to use md5sum utility to generate digest-password file using such method:
 {{{
-echo -e "${user}:trac:${password}\c" | md5sum - >>to-file
-}}}
-and manually delete " -" from the end and add "${user}:trac:" to the start of line from 'to-file'. You can see attachment:trac-digest-corrected.sh for detail.
+ $ printf "${user}:trac:${password}" | md5sum - >>user.htdigest
+}}}
+and manually delete " -" from the end and add "${user}:trac:" to the start of line from 'to-file'.
 
 == Tips ==
@@ -172 +198 @@
 
 === Serving a different base path than / ===
-Tracd supports serving projects with different base urls then /<project>. The parameter name to change this is
-{{{
-tracd --base-path=/some/path
+Tracd supports serving projects with different base urls than /<project>. The parameter name to change this is
+{{{
+ $ tracd --base-path=/some/path
 }}}
 
 ----
-See also: TracInstall, TracCgi, TracModPython, TracGuide
+See also: TracInstall, TracCgi, TracModPython, TracGuide, [trac:TracOnWindowsStandalone?version=13#RunningTracdasservice Running tracd.exe as a Windows service]