close Warning: Can't synchronize with repository "(default)" (Unsupported version control system "svn": libapr-1.so.0: failed to map segment from shared object: Cannot allocate memory). Look in the Trac log for more information.

Changes between Version 4 and Version 5 of TracStandalone


Ignore:
Timestamp:
2009-03-31T20:06:22+02:00 (6 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracStandalone

    v4 v5  
    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]