Changes between Version 1 and Version 2 of TracStandalone


Ignore:
Timestamp:
06/03/10 15:59:46 (14 years ago)
Author:
zeiss
Comment:

Importing pages from "/var/lib/svn/trac/etsicheck2" using WikiImport plugin.

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  
    44 To 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  
    53 If you want tracd to start automatically when you boot Windows, do: 
    54 {{{ 
    55  sc config tracd start= auto 
    56 }}} 
    57  
    58 The spacing here is important. 
    5942 
    6043== Using Authentication == 
     
    6952then for additional users: 
    7053{{{ 
    71 sudo htpasswd /path/to/env/.htpasswd username2 
     54sudo htpasswd /var/www/html/.htpasswd-users username2 
    7255}}} 
    7356then for starting the tracd: 
     
    11295{{{ 
    11396 $ tracd -p 8080 \ 
    114    --auth="*",/path/to/users.htdigest,mycompany.com \ 
     97   --auth=*,/path/to/users.htdigest,mycompany.com \ 
    11598   /path/to/project1 /path/to/project2 
    11699}}} 
    117 If using the `-s` parameter for serving a Trac environment from the root of a domain, one must use `*` for the project name 
    118100 
    119101== How to set up an htdigest password file == 
     
    130112#!python 
    131113from optparse import OptionParser 
    132 # The md5 module is deprecated in Python 2.5 
    133 try: 
    134     from hashlib import md5 
    135 except ImportError: 
    136     from md5 import md5 
    137 realm = 'trac' 
     114import md5 
    138115 
    139116# build the options 
     
    144121parser.add_option("-p", "--password",action="store", dest="password", type = "string", 
    145122                  help="the password to use") 
    146 parser.add_option("-r", "--realm",action="store", dest="realm", type = "string", 
    147                   help="the realm in which to create the digest") 
    148123(options, args) = parser.parse_args() 
    149124 
     
    151126if (options.username is None) or (options.password is None): 
    152127   parser.error("You must supply both the username and password") 
    153 if (options.realm is not None): 
    154    realm = options.realm 
    155128    
    156129# Generate the string to enter into the htdigest file 
    157 kd = lambda x: md5(':'.join(x)).hexdigest() 
     130realm = 'trac' 
     131kd = lambda x: md5.md5(':'.join(x)).hexdigest() 
    158132print ':'.join((options.username, realm, kd([options.username, realm, options.password]))) 
    159133}}} 
     
    170144It is possible to use md5sum utility to generate digest-password file using such method: 
    171145{{{ 
    172  $ printf "${user}:trac:${password}" | md5sum - >>user.htdigest 
     146echo -e "${user}:trac:${password}\c" | md5sum - >>to-file 
    173147}}} 
    174 and manually delete " -" from the end and add "${user}:trac:" to the start of line from 'to-file'. 
     148and 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. 
    175149 
    176150== Tips == 
     
    198172 
    199173=== Serving a different base path than / === 
    200 Tracd supports serving projects with different base urls than /<project>. The parameter name to change this is 
     174Tracd supports serving projects with different base urls then /<project>. The parameter name to change this is 
    201175{{{ 
    202  $ tracd --base-path=/some/path 
     176tracd --base-path=/some/path 
    203177}}} 
    204178 
    205179---- 
    206 See also: TracInstall, TracCgi, TracModPython, TracGuide, [trac:TracOnWindowsStandalone?version=13#RunningTracdasservice Running tracd.exe as a Windows service] 
     180See also: TracInstall, TracCgi, TracModPython, TracGuide