Changes between Version 36 and Version 37 of TracOnWindowsStandalone

Timestamp:

Oct 4, 2010, 12:36:40 PM (14 years ago)

Author:

Christian Boos

Comment:

oops, shouldn't use tracd.exe directly, as mentioned in TracStandalone#InstallingasaWindowsService, and we should somehow consolidate the two versions

TracOnWindowsStandalone

@@ -63 +63 @@
 
 == Running Tracd as service ==
-''Instructions also valid for 0.11, 0.12 and newer (see #7496)''
+
+See also TracStandalone#InstallingasaWindowsService and #7496.
+
+=== Using `instsrv`/`srvany`
  * download the Windows Server 2003 Resource Kit at [http://www.microsoft.com/downloads/details.aspx?FamilyID=9D467A69-57FF-4AE7-96EE-B18C4790CFFD&displaylang=en Microsoft]
- * run `!InstSrv <servicename> c:\path\to\resourcekit\!SrvAny.exe`, where you insert your own service name (without angle brackets, e.g. tracd) and the full path to the `SrvAny.exe`.
+ * run `InstSrv <servicename> c:\path\to\resourcekit\SrvAny.exe`, where you insert your own service name (without angle brackets, e.g. ''tracd'') and the full path to the `SrvAny.exe`.
  * open **HKEY_LOCAL_MACHINE\SYSTEM\!CurrentControlSet\Services\<servicename>** in !RegEdit
  * create subkey **Parameters**, below which you will create 2 string values:
   * create string value **Application** with the full path to `python.exe`
   * create string value **!AppParameters** with the set of desired tracd parameters, e.g. `c:\Python25\Scripts\tracd-script.py --port 8080 c:\path\to\trac"`
- * open the Services tool (somewhere in the administrative tools in the Windows control panel) and start your service
+ * open the Services tool (somewhere in the administrative tools in the Windows control panel) and start your service, or run `net start tracd`
 
-(tested with trac 0.11.2 on Windows XP)
+''(tested with trac 0.11.2 on Windows XP, Windows 7)''
 
+=== Using !FireDaemon
 You can also use [http://www.firedaemon.com FireDaemon] although there is no longer a free version available (FireDaemon Lite having been discontinued). No need to open the registry, FireDaemon GUI allows you to add parameters to your service command line. (tested with trac 0.11.2 on Windows Vista)
 
-''Instructions for Windows 7''
- * Download `instsrv.exe` and `srvany.exe` from Microsoft
- * `drive:\path\to\InstSrv.exe tracd drive:\path\to\SrvAny.exe`
- * open **HKEY_LOCAL_MACHINE\SYSTEM\!CurrentControlSet\Services\tracd** in !RegEdit
- * create subkey **Parameters**, below which you will create 2 string values:
-   * create string value **Application** - `drive:\path\to\tracd.exe`
-   * create string value **!AppParameters** with the set of desired tracd parameters, e.g. `--port 8080 --auth=proj_name,drive:\path\to\proj\digest.txt,trac drive:\path\to\proj\`
- * Run `net start tracd`
+=== Using `nssm`
 
-''Instructions for Windows 2008, using nssm (works with other Windows versions, e.g. Windows XP sp2 x64)''
- * download and extract nssm from http://iain.cx/src/nssm/
+ * download and extract `nssm` from http://iain.cx/src/nssm/
  * run 'nssm install tracd'
- * enter complete path to python.exe in Application field
-   - example 1: `c:\Python26\python.exe`
-   - example 2: `C:\Python27\Scripts\tracd.exe`
- * enter parameters in Options field 
-   - example 1: `c:\Python26\Scripts\tracd-script.py --port 8000 --basic-auth "*,c:\trac\.htpasswd,test" c:\trac\test`
-   - example 2: `-p 8000 --basic-auth "*,c:\trac\.htpasswd,test" c:\trac\test`
+ * enter complete path to python.exe in Application field (e.g. `c:\Python26\python.exe`)
+ * enter parameters in Options field (e.g. `c:\Python26\Scripts\tracd-script.py --port 8000 --basic-auth "*,c:\trac\.htpasswd,test" c:\trac\test`)
  * run 'net start tracd'
+
+''(tested with Windows 2008, Windows XP sp2 x64)''
  
 If you'd like to review or change those parameters later on, refer to the same registry keys as mentioned above (`srvany` and `nssm` use the same).
+
+Tip: don't try to be smart and use `...\Scripts\tracd.exe` instead of `...\python.exe`: if you do this, as tracd.exe starts a new python process, the server will survive a service stop.
 
 == Using Trac (and Subversion) ==
@@ -104 +100 @@
 Keep in mind that anonymous (not logged in) users can by default access most but not all of the features. You will need to configure authentication and grant additional [wiki:TracPermissions permissions] to authenticated users to see the full set of features.
 
-''Enjoy!''
+'' Enjoy! ''