Changes between Version 3 and Version 4 of TracStandalone


Ignore:
Timestamp:
2019-02-22T10:54:46+10:00 (6 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • TracStandalone

    v3 v4  
    4747{{{#!cmd
    4848 C:\path\to\instsrv.exe tracd C:\path\to\srvany.exe
    49  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>"
     49 reg add HKLM\SYSTEM\CurrentControlSet\Services\tracd\Parameters /v Application /d "\"C:\path\to\python.exe\" \"C:\path\to\python\scripts\tracd.exe\" <your tracd parameters>"
    5050 net start tracd
    5151}}}
    5252
    53 '''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}}}.
     53{{{#!div style="border: 1pt dotted; margin: 1em;"
     54**Attention:** Do not use `tracd.exe` directly.  Instead register `python.exe` directly with `tracd.exe` 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`.
     55}}}
    5456
    5557If you want tracd to start automatically when you boot Windows, do:
     
    6567
    6668Three (string) parameters are provided:
    67 ||!AppDirectory ||C:\Python26\ ||
     69||!AppDirectory ||C:\Python27\ ||
    6870||Application ||python.exe ||
    69 ||!AppParameters ||scripts\tracd-script.py -p 8080 ... ||
     71||!AppParameters ||scripts\tracd.exe -p 8080 ... ||
    7072
    7173Note that, if the !AppDirectory is set as above, the paths of the executable ''and'' of the script name and parameter values are relative to the directory.  This makes updating Python a little simpler because the change can be limited, here, to a single point.
     
    7577For Windows 7 User, srvany.exe may not be an option, so you can use [http://www.google.com/search?q=winserv.exe WINSERV] utility and run:
    7678{{{#!cmd
    77 "C:\path\to\winserv.exe" install tracd -displayname "tracd" -start auto "C:\path\to\python.exe" c:\path\to\python\scripts\tracd-script.py <your tracd parameters>"
     79"C:\path\to\winserv.exe" install tracd -displayname "tracd" -start auto "C:\path\to\python.exe" c:\path\to\python\scripts\tracd.exe <your tracd parameters>"
    7880net start tracd
    7981}}}
     
    200202Here's the online help, as a reminder (`tracd --help`):
    201203{{{
    202 Usage: tracd [options] [projenv] ...
    203 
    204 Options:
     204usage: tracd [-h] [--version] [-e PARENTDIR | -s]
     205             [-a DIGESTAUTH | --basic-auth BASICAUTH] [-p PORT] [-b HOSTNAME]
     206             [--protocol {http,scgi,ajp,fcgi}] [-q] [--base-path BASE_PATH]
     207             [--http10 | --http11] [-r | -d] [--pidfile PIDFILE]
     208             [--umask MASK] [--group GROUP] [--user USER]
     209             [envs [envs ...]]
     210
     211positional arguments:
     212  envs                  path of the project environment(s)
     213
     214optional arguments:
     215  -h, --help            show this help message and exit
    205216  --version             show program's version number and exit
    206   -h, --help            show this help message and exit
    207   -a DIGESTAUTH, --auth=DIGESTAUTH
     217  -e PARENTDIR, --env-parent-dir PARENTDIR
     218                        parent directory of the project environments
     219  -s, --single-env      only serve a single project without the project list
     220  -a DIGESTAUTH, --auth DIGESTAUTH
    208221                        [projectdir],[htdigest_file],[realm]
    209   --basic-auth=BASICAUTH
     222  --basic-auth BASICAUTH
    210223                        [projectdir],[htpasswd_file],[realm]
    211   -p PORT, --port=PORT  the port number to bind to
    212   -b HOSTNAME, --hostname=HOSTNAME
     224  -p PORT, --port PORT  the port number to bind to
     225  -b HOSTNAME, --hostname HOSTNAME
    213226                        the host name or IP address to bind to
    214   --protocol=PROTOCOL   http|scgi|ajp|fcgi
    215   -q, --unquote         unquote PATH_INFO (may be needed when using ajp)
    216   --http10              use HTTP/1.0 protocol version instead of HTTP/1.1
    217   --http11              use HTTP/1.1 protocol version (default)
    218   -e PARENTDIR, --env-parent-dir=PARENTDIR
    219                         parent directory of the project environments
    220   --base-path=BASE_PATH
     227  --protocol {http,scgi,ajp,fcgi}
     228                        the server protocol (default: http)
     229  -q, --unquote         unquote PATH_INFO (may be needed when using the ajp
     230                        protocol)
     231  --base-path BASE_PATH
    221232                        the initial portion of the request URL's "path"
     233  --http10              use HTTP/1.0 protocol instead of HTTP/1.1
     234  --http11              use HTTP/1.1 protocol (default)
    222235  -r, --auto-reload     restart automatically when sources are modified
    223   -s, --single-env      only serve a single project without the project list
    224236  -d, --daemonize       run in the background as a daemon
    225   --pidfile=PIDFILE     when daemonizing, file to which to write pid
    226   --umask=MASK          when daemonizing, file mode creation mask to use, in
    227                         octal notation (default 022)
    228   --group=GROUP         the group to run as
    229   --user=USER           the user to run as
     237  --pidfile PIDFILE     file to write pid when daemonizing
     238  --umask MASK          when daemonizing, file mode creation mask to use, in
     239                        octal notation (default: 022)
     240  --group GROUP         the group to run as
     241  --user USER           the user to run as
    230242}}}
    231243