Edgewall Software

Changes between Version 300 and Version 301 of TracOnWindows


Ignore:
Timestamp:
Dec 18, 2009, 12:29:07 AM (14 years ago)
Author:
Christian Boos
Comment:

restore the overview role of this page, after moving the recipe which took over this page from @283 to @300 to CookBook/Installation/TracOnWindowsWithAccountManager

Legend:

Unmodified
Added
Removed
Modified

  • TracOnWindows

    v300 v301  
    11{{{
    2 #!div style="margin-top: .5em; padding: 0 1em; background-color: #ffd; border:1px outset #ddc;"
     2#!comment
    33
    4 '''Please Note:''' These instructions are for '''Trac 0.11.5'''
     4Please consider using TracOnWindows/Rewrite for discussing improvements to this page,
     5especially before starting a complete rewrite / throw away  of the previous material,
     6as happened in TracOnWindows@283. Thanks!
     7}}}
     8= Trac on Windows =
    59
    6 The instructions for Trac 0.10 can be found at the ["0.10/TracOnWindows"] page.
     10== Installing Trac 0.11 on Windows ==
    711
    8 Note that this contributed page abuses a bit of the ''point-and-click'' style for my taste (at least there are no screenshots!) and will soon be moved to a CookBook page.
     12There are several different ways to get Trac up and running on Windows. This page will give you an overview.
    913
    10 While waiting for more concise installation instructions, you can also try to install Trac on Windows using BitNami, which is as simple as it can get, as it also installs Python, Apache and Subversion, all with compatible binaries of course) [[br]] -- cboos
    11 }}}
     14The CookBook/Installation#OnWindows lists several detailed '''step-by-step installation guides''' that are easy to follow, in the typical Windows point-and-click style.
    1215
    13 = Trac On Windows =
    14 ''Last modified: 2009-11-09 17:05:28 GMT''
     16If you're looking for an '''all-in-one installer''', then the BitNami Trac stack is probably what you're looking for. It provides a Windows installer (as well as Linux, Mac x86, and Mac PPC ones) that will install in a self-contained environment Python, Apache and Subversion, along with Trac and Genshi, and will let you create a new repository and a new Trac environment. Alternatively, you can also get the same software as a VMWare image or even an Amazon Machine Images.
    1517
    16 The following instructions use 32-bit software packages. The 64-bit software packages do not yet integrate seamlessly with each other, so are not recommended.
    17 [[PageOutline(2-3)]]
    18 == 1. Install Python ==
    19  1. Download [http://www.python.org/ftp/python/2.6.4/python-2.6.4.msi Python-2.6.4.msi] to your computer, and run it (double-click on ''python-2.6.4.msi'' in your download folder).
    20  1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
    21  1. Click the '''Next >''' button to ''Install for all users''
    22  1. Click the '''Next >''' button to use ''C:\Python26'' as the destination directory
    23  1. Click the '''Next >''' button to install all of the Python components
    24  1. Wait for the installation to complete, and then click the '''Finish''' button
    25  1. Add the install directory (default is '''C:\Python26'''), and '''C:\Python26\Scripts''' directory to the windows '''%PATH%''' environment variable (dont worry if it doesn't exist now):
    26   a. Click the Windows '''Start''' button
    27   a. Right-click the '''My Computer''' icon
    28   a. Click the '''P__r__operties''' option at the bottom of the pop-up menu
    29   a. Click the '''Advanced''' tab
    30   a. Click the '''Enviro__n__ment Variables''' button
    31   a. Scroll down the ''__S__ystem variables'' listbox to the '''Path''' ''Variable''
    32   a. Select the '''Path''' ''Variable'' and click the ''Ed__i__t'' button below it - DO NOT click on the edit button above
    33   a. Scroll to the right-hand end of the ''Variable __v__alue'' field, and type ''';C:\Python26;C:\Python26\Scripts'''
    34   a. Click the '''OK''' button in the ''Edit System Variable'' window
    35   a. Click the '''OK''' button in the ''Environment Variables'' window
    36   a. Click the '''OK''' button in the ''System Properties'' window
     18If all you want is a convenient '''list of the various installers''' you would need to install the different packages by yourself and stay in complete control, stay tuned (for now you can get some of them from an earlier version of this page, TracOnWindows@282).
    3719
    38 == 2. Setuptools ==
    39  1. Download [http://peak.telecommunity.com/dist/ez_setup.py ez_setup.py] from [http://peak.telecommunity.com/DevCenter/setuptools PEAK] (Python Enterprise Application Kit) to your Python (default is '''C:\Python26''') directory.
    40  1. Open a command window
    41   a. Click the Windows '''Start''' button
    42   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    43   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    44  1. Type '''cd C:\Python26''' and press the ''Return'' key
    45  1. Type '''ez_setup.py''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
     20Whichever method you pick, it will not hurt to familiarize yourself with some key concepts like the TracEnvironment, and also the TracStandalone web front-end, useful for testing or for setting up directly as a service.
    4621
    47 == 3. Subversion (optional) ==
     22The TracOnWindows/Advanced instructions cover in details alternative ways to install Trac on Windows, on different database backends or on different web server front-ends.
    4823
    49 Trac can integrate with [http://subversion.tigris.org Subversion] version control software. Read more about the integration between Trac and Subversion from the wiki: TracSubversion.
    50 
    51 === Subversion Server & Client ===
    52  1. Download [http://subversion.tigris.org/files/documents/15/46906/Setup-Subversion-1.6.6.msi Setup-Subversion-1.6.6.msi] to your computer, and run it (double-click on ''Setup-Subversion-1.6.6.msi'' in your download folder).
    53  1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
    54  1. Click the '''__N__ext''' button on the ''Welcome to the Subversion Setup Wizard'' screen
    55  1. Click the '''__N__ext''' button on the ''Information'' screen
    56  1. Click the '''__N__ext''' button to select ''Binding for Apache 2.0.x''
    57  1. Type '''C:\Subversion\''' in to the ''Install subversion to:'' field, and click the '''__N__ext''' button
    58  1. Click the '''Finish''' button
    59  1. Open a command window
    60   a. Click the Windows '''Start''' button
    61   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    62   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    63  1. Type '''cd C:\Subversion\bin''' and press the ''Return'' key
    64  1. Type '''mkdir C:\svnrepositories''' and press the ''Return'' key
    65  1. Type '''svnadmin create C:\svnrepositories\myproject''' and press the ''Return'' key
    66  1. Type '''sc create svnserver binpath= "C:\Subversion\bin\svnserve.exe --service -r c:\svnrepositories" displayname= "Subversion Server (svnserver)" depend= Tcpip start= auto''' and press the ''Return'' key
    67  1. Type '''net start svnserver''' and press the ''Return'' key
    68 
    69 === Subversion Bindings ===
    70  1. Open a command window
    71   a. Click the Windows '''Start''' button
    72   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    73   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    74  1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
    75  1. Type '''easy_install -Z !http://subversion.tigris.org/files/documents/15/46888/svn-python-1.6.6.win32-py2.6.exe''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    76 
    77 == 4. mod_python (optional, and only available for Python v2.5 right now) ==
    78 mod_python is needed if you want to use Apache HTTP server.
    79  1. Download [http://apache.deathculture.net/httpd/modpython/win/3.3.1/mod_python-3.3.1.win32-py2.5-Apache2.2.exe mod_python-3.3.1.win32-py2.5-Apache2.2.exe] to your computer from [http://httpd.apache.org/modules/python-download.cgi Apache], and run it (double-click on ''mod_python-3.3.1.win32-py2.5-Apache2.0.exe'' in your download folder).
    80  1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
    81  1. Click the '''__N__ext >''' button
    82  1. Click the '''__N__ext >''' button to confirm the Python directory
    83  1. Click the '''__N__ext >''' button to install
    84  1. Select the directory where ''Apache'' is installed
    85  1. Click the '''OK''' button
    86  1. Click the '''Finish''' button
    87 
    88 == 5. Plug-ins (optional) ==
    89 See TracPlugins for details about plugin installation.
    90 For example: to install the SpamFilter plugin
    91  1. Open a command window
    92   a. Click the Windows '''Start''' button
    93   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    94   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    95  1. Type '''mkdir C:\src''' and press the ''Return'' key
    96  1. Type '''cd C:\src''' and press the ''Return'' key
    97  1. Type '''svn checkout !http://svn.edgewall.org/repos/trac/sandbox/spam-filter/trunk spam-filter''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    98  1. Type '''cd spam-filter''' and press the ''Return'' key
    99  1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    100 
    101 == 6. Genshi ==
    102  1. Open a command window
    103   a. Click the Windows '''Start''' button
    104   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    105   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    106  1. Type '''mkdir C:\src''' and press the ''Return'' key
    107  1. Type '''cd C:\src''' and press the ''Return'' key
    108  1. Type '''svn checkout !http://svn.edgewall.org/repos/genshi/trunk genshi''' and press the ''Return'' key
    109  1. Type '''cd genshi''' and press the ''Return'' key
    110  1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    111 
    112 == 7. Trac ==
    113  1. Open a command window
    114   a. Click the Windows '''Start''' button
    115   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    116   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    117  1. Choose '''__ONE__''' of the following options:
    118 === Option 1 ===
    119  1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
    120  1. Type '''easy_install Trac''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    121 === Option 2 ===
    122  1. Type '''mkdir C:\src''' and press the ''Return'' key
    123  1. Type '''cd C:\src''' and press the ''Return'' key
    124  1. Type '''svn checkout !http://svn.edgewall.org/repos/trac/trunk trac''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    125  1. Type '''cd trac''' and press the ''Return'' key
    126  1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    127 === Configure Trac environment ===
    128  1. Type '''mkdir C:\trac''' and press the ''Return'' key
    129  1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
    130  1. Type '''trac-admin \trac initenv''' and press the ''Return'' key
    131  1. Type in your project name (keep it succinct) and press the ''Return'' key
    132  1. Press the '''Return''' key to select the default ''Database connection string''
    133  1. Press the '''Return''' key to select ''svn'' as the default ''Repository type''
    134  1. Type in the full path of your repository; e.g. ''/svnrepositories/myproject'', and press the '''Return''' key
    135  1. Verify the installation of Trac works:
    136   a. Type in '''tracd --port 8000 C:\trac''' to start the Trac daemon
    137   a. Click the Windows '''Start''' button
    138   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    139   a. Type '''!http://localhost:8000''' [[BR]]A browser window should open to a page with ''Available Projects''
    140   a. Click on your project's name, and you should be taken to your project's Trac home page.
    141 
    142 == 8. Account Manager Plug-in ==
    143  1. Open a command window
    144   a. Click the Windows '''Start''' button
    145   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    146   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    147  1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
    148  1. Type '''easy_install !http://trac-hacks.org/svn/accountmanagerplugin/trunk''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    149  1. Type '''trac-admin C:\trac permission add anonymous TRAC_ADMIN''' and press the ''Return'' key
    150  1. Click the Windows '''Start''' button
    151  1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    152  1. Type '''notepad C:\trac\conf\trac.ini''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button
    153  1. Copy the block of text below
    154 {{{
    155 [components]
    156 acct_mgr.admin.accountmanageradminpage = enabled
    157 acct_mgr.api.accountmanager = enabled
    158 acct_mgr.db.sessionstore = enabled
    159 acct_mgr.htfile.htdigeststore = enabled
    160 acct_mgr.pwhash.htdigesthashmethod = enabled
    161 acct_mgr.web_ui.accountmodule = enabled
    162 acct_mgr.web_ui.loginmodule = enabled
    163 acct_mgr.web_ui.registrationmodule = enabled
    164 trac.web.auth.loginmodule = disabled
    165 }}}
    166  1. Scroll down to the ''[header_logo]'' section, and place the cursor on the blank line above it
    167  1. Paste the text you copied above in to the document
    168  1. Save the file, and close notepad
    169  1. Create an empty '''C:\trac\conf\passwords.txt'''
    170   a. Click the Windows '''Start''' button
    171   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    172   a. Type '''notepad C:\trac\conf\passwords.txt''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button
    173   a. Save the file, and close notepad
    174  1. Click the Windows '''Start''' button
    175  1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    176  1. Type '''!http://localhost:8000/trac/admin''' [[BR]]A browser window should open to an ''Administration'' page
    177  1. Click the '''Configuration''' hyperlink under ''Accounts'' in the menu on the left-hand side of the page
    178  1. Select '''1''' from the drop-down list-box next to the ''!HtDigestStore'' heading
    179  1. Select '''1''' from the drop-down list-box next to the ''!SessionStore'' heading
    180  1. Type '''C:\trac\conf\passwords.txt''' in to the ''filename:'' field in the ''!HtDigestStore'' section
    181  1. Type '''trac''' in to the ''realm:'' field under the ''!HtDigestStore'' section
    182  1. Click the '''Save''' button
    183  1. Click the '''Users''' hyperlink under the ''Accounts'' section in the menu on the left-hand side of the page
    184  1. Type a username in to the ''Username:'' field on the right-hand side of the page in the ''Add Account:'' section
    185  1. Type a password in to the ''Password:'' field on the right-hand side of the page in the ''Add Account:'' section
    186  1. Type the password in to the ''Confirm password:'' field on the right-hand side of the page in the ''Add Account:'' section
    187  1. Type a name in to the ''Name:'' field on the right-hand side of the page in the ''Add Account:'' section
    188  1. Type an e-mail address in to the ''Email:'' field on the right-hand side of the page in the ''Add Account:'' section
    189  1. Click the '''Add''' button
    190  1. Click the '''Permissions''' hyperlink under the ''General'' section in the menu on the left-hand side of the page
    191  1. Type the username in to the ''Subject:'' field on the right-hand side of the page in the ''Grant Permissions:'' section (this will become your admin user)
    192  1. Select '''TRAC_ADMIN''' from the ''Action:'' drop-down list-box
    193  1. Click the '''Add''' button
    194  1. Check '''TRAC_ADMIN''' in the ''Action'' section in the center of the page, for the '''anonymous''' ''Subject''
    195  1. Click the '''Remove selected items''' button
    196 
    197 (You will need to log in as your admin user to access the admin panels from this point forward)
    198 
    199 
    200 More information about the TracEnvironment setup, and the TracStandalone web front-end is available.
    201 
    202 ----
    203 See also: the TracOnWindows/Advanced instructions, TracOnWindows/Rewrite for discussing improvements to this page, ["0.10/TracOnWindows"] and ["Trac0.9/TracOnWindows"] for the previous version of this document. [http://how-to-solutions.com/how-to-install-trac-on-windows.html Installing Trac on Windows]
     24Finally, the installation instructions for previous major versions of Trac can still be found in the ["Trac0.9/TracOnWindows"], ["0.10/TracOnWindows"] pages.