Changes between Version 1 and Version 2 of TracStandalone


Ignore:
Timestamp:
Dec 7, 2010, 10:14:17 PM (14 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracStandalone

    v1 v2  
    4040To exit the server on Windows, be sure to use {{{CTRL-BREAK}}} -- using {{{CTRL-C}}} will leave a Python process running in the background.
    4141
     42== Installing as a Windows Service ==
     43
     44To install as a Windows service, get the [http://www.google.com/search?q=srvany.exe SRVANY] utility and run:
     45{{{
     46 C:\path\to\instsrv.exe tracd C:\path\to\srvany.exe
     47 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>"
     48 net start tracd
     49}}}
     50
     51'''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}}}.
     52
     53If you want tracd to start automatically when you boot Windows, do:
     54{{{
     55 sc config tracd start= auto
     56}}}
     57
     58The spacing here is important.
    4259
    4360== Using Authentication ==
     
    5269then for additional users:
    5370{{{
    54 sudo htpasswd /var/www/html/.htpasswd-users username2
     71sudo htpasswd /path/to/env/.htpasswd username2
    5572}}}
    5673then for starting the tracd:
     
    95112{{{
    96113 $ tracd -p 8080 \
    97    --auth=*,/path/to/users.htdigest,mycompany.com \
     114   --auth="*",/path/to/users.htdigest,mycompany.com \
    98115   /path/to/project1 /path/to/project2
    99116}}}
     117If using the `-s` parameter for serving a Trac environment from the root of a domain, one must use `*` for the project name
    100118
    101119== How to set up an htdigest password file ==
     
    112130#!python
    113131from optparse import OptionParser
    114 import md5
     132# The md5 module is deprecated in Python 2.5
     133try:
     134    from hashlib import md5
     135except ImportError:
     136    from md5 import md5
     137realm = 'trac'
    115138
    116139# build the options
     
    121144parser.add_option("-p", "--password",action="store", dest="password", type = "string",
    122145                  help="the password to use")
     146parser.add_option("-r", "--realm",action="store", dest="realm", type = "string",
     147                  help="the realm in which to create the digest")
    123148(options, args) = parser.parse_args()
    124149
     
    126151if (options.username is None) or (options.password is None):
    127152   parser.error("You must supply both the username and password")
     153if (options.realm is not None):
     154   realm = options.realm
    128155   
    129156# Generate the string to enter into the htdigest file
    130 realm = 'trac'
    131 kd = lambda x: md5.md5(':'.join(x)).hexdigest()
     157kd = lambda x: md5(':'.join(x)).hexdigest()
    132158print ':'.join((options.username, realm, kd([options.username, realm, options.password])))
    133159}}}
     
    144170It is possible to use md5sum utility to generate digest-password file using such method:
    145171{{{
    146 echo -e "${user}:trac:${password}\c" | md5sum - >>to-file
    147 }}}
    148 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.
     172 $ printf "${user}:trac:${password}" | md5sum - >>user.htdigest
     173}}}
     174and manually delete " -" from the end and add "${user}:trac:" to the start of line from 'to-file'.
    149175
    150176== Tips ==
     
    172198
    173199=== Serving a different base path than / ===
    174 Tracd supports serving projects with different base urls then /<project>. The parameter name to change this is
    175 {{{
    176 tracd --base-path=/some/path
     200Tracd supports serving projects with different base urls than /<project>. The parameter name to change this is
     201{{{
     202 $ tracd --base-path=/some/path
    177203}}}
    178204
    179205----
    180 See also: TracInstall, TracCgi, TracModPython, TracGuide
     206See also: TracInstall, TracCgi, TracModPython, TracGuide, [trac:TracOnWindowsStandalone?version=13#RunningTracdasservice Running tracd.exe as a Windows service]