Edgewall Software

Changes between Version 8 and Version 9 of CookBook/Installation/TracOnWindowsWithAccountManager


Ignore:
Timestamp:
Jan 9, 2015, 10:24:41 PM (5 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • CookBook/Installation/TracOnWindowsWithAccountManager

    v8 v9  
    11= Trac On Windows =
    2 ''Last modified: 2009-11-09 17:05:28 GMT''
    32
    43The following instructions use 32-bit software packages. The 64-bit software packages do not yet integrate seamlessly with each other, so are not recommended.
    54[[PageOutline(2-3)]]
     5
    66== 1. Install Python ==
    7  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).
     7 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 by double-clicking ''python-2.6.4.msi'' in your download folder.
    88 1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
    9  1. Click the '''Next >''' button to ''Install for all users''
    10  1. Click the '''Next >''' button to use ''C:\Python26'' as the destination directory
    11  1. Click the '''Next >''' button to install all of the Python components
    12  1. Wait for the installation to complete, and then click the '''Finish''' button
     9 1. Click the '''Next >''' button to ''Install for all users''.
     10 1. Click the '''Next >''' button to use ''C:\Python26'' as the destination directory.
     11 1. Click the '''Next >''' button to install all of the Python components.
     12 1. Wait for the installation to complete, and then click the '''Finish''' button.
    1313 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):
    1414  a. Click the Windows '''Start''' button
     
    2424  a. Click the '''OK''' button in the ''System Properties'' window
    2525
    26 == 2. Setuptools ==
    27  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.
    28  1. Open a command window
     26== 2. Setup tools ==
     27 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 directory. Default is '''C:\Python26'''.
     28 1. Open a command window:
    2929  a. Click the Windows '''Start''' button
    3030  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    31   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    32  1. Type '''cd C:\Python26''' and press the ''Return'' key
    33  1. Type '''ez_setup.py''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
     31  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
     32 1. Type '''cd C:\Python26''' and press the ''Return'' key.
     33 1. Type '''ez_setup.py''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
    3434
    3535== 3. Subversion (optional) ==
     
    3737Trac can integrate with [http://subversion.tigris.org Subversion] version control software. Read more about the integration between Trac and Subversion from the wiki: TracSubversion.
    3838
    39 === Subversion Server & Client ===
    40  1. Download [http://alagazam.net/Setup-Subversion-1.6.6.msi Setup-Subversion-1.6.6.msi] (Alagazam) [http://www.collab.net/downloads/subversion/ CollabNet Subversion Edge 1.1 (for Windows 32 bit)] to your computer, and run it (double-click on ''CollabNetSubversionEdge-1.1.0_setup.exe'' in your download folder)(Warning: CollabNet Edge will install Python25 and rewrite system and env variables, as well as change registry entries).
     39=== Subversion Server and Client ===
     40
     41 1. Download [http://alagazam.net/Setup-Subversion-1.6.6.msi Setup-Subversion-1.6.6.msi] (Alagazam) [http://www.collab.net/downloads/subversion/ CollabNet Subversion Edge 1.1 (for Windows 32 bit)] to your computer, and run it by double-clicking on ''CollabNetSubversionEdge-1.1.0_setup.exe'' in your download folder. Warning: CollabNet Edge will install Python25 and rewrite system and env variables, as well as change registry entries.
    4142 1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
    42  1. Click the '''__N__ext''' button on the ''Welcome to the Subversion Setup Wizard'' screen
    43  1. Click the '''__N__ext''' button on the ''Information'' screen
    44  1. Click the '''__N__ext''' button to select ''Binding for Apache 2.0.x''
    45  1. Type '''C:\Subversion\''' in to the ''Install subversion to:'' field, and click the '''__N__ext''' button
    46  1. Click the '''Finish''' button
    47  1. Open a command window
     43 1. Click the '''__N__ext''' button on the ''Welcome to the Subversion Setup Wizard'' screen.
     44 1. Click the '''__N__ext''' button on the ''Information'' screen.
     45 1. Click the '''__N__ext''' button to select ''Binding for Apache 2.0.x''.
     46 1. Type '''C:\Subversion\''' in to the ''Install subversion to:'' field, and click the '''__N__ext''' button.
     47 1. Click the '''Finish''' button.
     48 1. Open a command window:
    4849  a. Click the Windows '''Start''' button
    4950  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    50   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    51  1. Type '''cd C:\Subversion\bin''' and press the ''Return'' key
    52  1. Type '''mkdir C:\svnrepositories''' and press the ''Return'' key
    53  1. Type '''svnadmin create C:\svnrepositories\myproject''' and press the ''Return'' key
    54  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
    55  1. Type '''net start svnserver''' and press the ''Return'' key
     51  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
     52 1. Type '''cd C:\Subversion\bin''' and press the ''Return'' key.
     53 1. Type '''mkdir C:\svnrepositories''' and press the ''Return'' key.
     54 1. Type '''svnadmin create C:\svnrepositories\myproject''' and press the ''Return'' key.
     55 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.
     56 1. Type '''net start svnserver''' and press the ''Return'' key.
    5657
    5758=== Subversion Bindings ===
    58  1. Open a command window
     59 1. Open a command window:
    5960  a. Click the Windows '''Start''' button
    6061  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    61   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    62  1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
    63  1. Type '''easy_install -Z !http://subversion.tigris.org/files/documents/15/47859/svn-python-1.6.6.win32-py2.6.exe''' (If you get an infinite loop error, download the file and point easy_install to it.) and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
     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:\Python26\Scripts''' and press the ''Return'' key.
     64 1. Type '''easy_install -Z !http://subversion.tigris.org/files/documents/15/47859/svn-python-1.6.6.win32-py2.6.exe'''. If you get an infinite loop error, download the file and point easy_install to it. Press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
    6465
    6566== 4. mod_python (optional, and only available for Python v2.5 right now) ==
     67
    6668mod_python is needed if you want to use Apache HTTP server.
    67  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).
     69 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 by double-clicking on ''mod_python-3.3.1.win32-py2.5-Apache2.0.exe'' in your download folder.
    6870 1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
    69  1. Click the '''__N__ext >''' button
    70  1. Click the '''__N__ext >''' button to confirm the Python directory
    71  1. Click the '''__N__ext >''' button to install
    72  1. Select the directory where ''Apache'' is installed
    73  1. Click the '''OK''' button
    74  1. Click the '''Finish''' button
     71 1. Click the '''__N__ext >''' button.
     72 1. Click the '''__N__ext >''' button to confirm the Python directory.
     73 1. Click the '''__N__ext >''' button to install.
     74 1. Select the directory where ''Apache'' is installed.
     75 1. Click the '''OK''' button.
     76 1. Click the '''Finish''' button.
    7577
    7678== 5. Plug-ins (optional) ==
     79
    7780See TracPlugins for details about plugin installation.
    78 For example: to install the SpamFilter plugin
    79  1. Open a command window
     81For example, to install the SpamFilter plugin, perform the following actions:
     82 1. Open a command window:
    8083  a. Click the Windows '''Start''' button
    8184  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    82   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    83  1. Type '''mkdir C:\src''' and press the ''Return'' key
    84  1. Type '''cd C:\src''' and press the ''Return'' key
    85  1. Type '''svn checkout !http://svn.edgewall.org/repos/trac/plugins/0.11/spam-filter''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    86  1. Type '''cd spam-filter''' and press the ''Return'' key
    87  1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
     85  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
     86 1. Type '''mkdir C:\src''' and press the ''Return'' key.
     87 1. Type '''cd C:\src''' and press the ''Return'' key.
     88 1. Type '''svn checkout !http://svn.edgewall.org/repos/trac/plugins/0.11/spam-filter''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
     89 1. Type '''cd spam-filter''' and press the ''Return'' key.
     90 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared.
    8891
    8992== 6. Genshi ==
    90  1. Open a command window
     93
     94To install the Genshi templating engine, perform the following actions:
     95 1. Open a command window:
    9196  a. Click the Windows '''Start''' button
    9297  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    93   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    94  1. Type '''mkdir C:\src''' and press the ''Return'' key
    95  1. Type '''cd C:\src''' and press the ''Return'' key
    96  1. Type '''svn checkout !http://svn.edgewall.org/repos/genshi/trunk genshi''' and press the ''Return'' key
    97  1. Type '''cd genshi''' and press the ''Return'' key
    98  1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
     98  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
     99 1. Type '''mkdir C:\src''' and press the ''Return'' key.
     100 1. Type '''cd C:\src''' and press the ''Return'' key.
     101 1. Type '''svn checkout !http://svn.edgewall.org/repos/genshi/trunk genshi''' and press the ''Return'' key.
     102 1. Type '''cd genshi''' and press the ''Return'' key.
     103 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
    99104
    100105== 7. Trac ==
    101  1. Open a command window
     106
     107 1. Open a command window:
    102108  a. Click the Windows '''Start''' button
    103109  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    104   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
     110  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
    105111 1. Choose '''__ONE__''' of the following options:
    106112=== Option 1 ===
    107  1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
    108  1. Type '''easy_install Trac''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
     113 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key.
     114 1. Type '''easy_install Trac''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
    109115=== Option 2 ===
    110  1. Type '''mkdir C:\src''' and press the ''Return'' key
    111  1. Type '''cd C:\src''' and press the ''Return'' key
    112  1. Type '''svn checkout !http://svn.edgewall.org/repos/trac/trunk trac''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    113  1. Type '''cd trac''' and press the ''Return'' key
    114  1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
     116 1. Type '''mkdir C:\src''' and press the ''Return'' key.
     117 1. Type '''cd C:\src''' and press the ''Return'' key.
     118 1. Type '''svn checkout !http://svn.edgewall.org/repos/trac/trunk trac''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
     119 1. Type '''cd trac''' and press the ''Return'' key.
     120 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
    115121=== Configure Trac environment ===
    116  1. Type '''mkdir C:\trac''' and press the ''Return'' key
    117  1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
    118  1. Type '''trac-admin \trac initenv''' and press the ''Return'' key
    119  1. Type in your project name (keep it succinct) and press the ''Return'' key
    120  1. Press the '''Return''' key to select the default ''Database connection string''
    121  1. Press the '''Return''' key to select ''svn'' as the default ''Repository type''
    122  1. Type in the full path of your repository; e.g. ''/svnrepositories/myproject'', and press the '''Return''' key
     122 1. Type '''mkdir C:\trac''' and press the ''Return'' key.
     123 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key.
     124 1. Type '''trac-admin \trac initenv''' and press the ''Return'' key.
     125 1. Type in your project name (keep it succinct) and press the ''Return'' key.
     126 1. Press the '''Return''' key to select the default ''Database connection string''.
     127 1. Press the '''Return''' key to select ''svn'' as the default ''Repository type''.
     128 1. Type in the full path of your repository; e.g. ''/svnrepositories/myproject'', and press the '''Return''' key.
    123129 1. Verify the installation of Trac works:
    124130  a. Type in '''tracd --port 8000 C:\trac''' to start the Trac daemon
     
    129135
    130136== 8. Account Manager Plug-in ==
    131  1. Open a command window
     137
     138To install the [http://trac-hacks.org/wiki/AccountManagerPlugin AccountManager plugin], perform the following actions:
     139 1. Open a command window:
    132140  a. Click the Windows '''Start''' button
    133141  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    134   a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
    135  1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
    136  1. Type '''easy_install !http://trac-hacks.org/svn/accountmanagerplugin/trunk''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
    137  1. Type '''trac-admin C:\trac permission add anonymous TRAC_ADMIN''' and press the ''Return'' key
    138  1. Click the Windows '''Start''' button
    139  1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    140  1. Type '''notepad C:\trac\conf\trac.ini''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button
    141  1. Copy the block of text below
     142  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
     143 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key.
     144 1. Type '''easy_install !http://trac-hacks.org/svn/accountmanagerplugin/trunk''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
     145 1. Type '''trac-admin C:\trac permission add anonymous TRAC_ADMIN''' and press the ''Return'' key.
     146 1. Click the Windows '''Start''' button.
     147 1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear.
     148 1. Type '''notepad C:\trac\conf\trac.ini''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button.
     149 1. Copy the block of text below.
    142150{{{
    143151[components]
     
    152160trac.web.auth.loginmodule = disabled
    153161}}}
    154  1. Scroll down to the ''[header_logo]'' section, and place the cursor on the blank line above it
    155  1. Paste the text you copied above in to the document
    156  1. Save the file, and close notepad
    157  1. Create an empty '''C:\trac\conf\passwords.txt'''
     162 1. Scroll down to the ''[header_logo]'' section, and place the cursor on the blank line above it.
     163 1. Paste the text you copied above in to the document.
     164 1. Save the file, and close notepad.
     165 1. Create an empty '''C:\trac\conf\passwords.txt''':
    158166  a. Click the Windows '''Start''' button
    159167  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    160168  a. Type '''notepad C:\trac\conf\passwords.txt''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button
    161   a. Save the file, and close notepad
    162  1. Click the Windows '''Start''' button
    163  1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
    164  1. Type '''!http://localhost:8000/trac/admin''' [[BR]]A browser window should open to an ''Administration'' page
    165  1. Click the '''Configuration''' hyperlink under ''Accounts'' in the menu on the left-hand side of the page
    166  1. Select '''1''' from the drop-down list-box next to the ''!HtDigestStore'' heading
    167  1. Select '''1''' from the drop-down list-box next to the ''!SessionStore'' heading
    168  1. Type '''C:\trac\conf\passwords.txt''' in to the ''filename:'' field in the ''!HtDigestStore'' section
    169  1. Type '''trac''' in to the ''realm:'' field under the ''!HtDigestStore'' section
    170  1. Click the '''Save''' button
    171  1. Click the '''Users''' hyperlink under the ''Accounts'' section in the menu on the left-hand side of the page
    172  1. Type a username in to the ''Username:'' field on the right-hand side of the page in the ''Add Account:'' section
    173  1. Type a password in to the ''Password:'' field on the right-hand side of the page in the ''Add Account:'' section
    174  1. Type the password in to the ''Confirm password:'' field on the right-hand side of the page in the ''Add Account:'' section
    175  1. Type a name in to the ''Name:'' field on the right-hand side of the page in the ''Add Account:'' section
    176  1. Type an e-mail address in to the ''Email:'' field on the right-hand side of the page in the ''Add Account:'' section
    177  1. Click the '''Add''' button
    178  1. Click the '''Permissions''' hyperlink under the ''General'' section in the menu on the left-hand side of the page
    179  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)
    180  1. Select '''TRAC_ADMIN''' from the ''Action:'' drop-down list-box
    181  1. Click the '''Add''' button
    182  1. Check '''TRAC_ADMIN''' in the ''Action'' section in the center of the page, for the '''anonymous''' ''Subject''
    183  1. Click the '''Remove selected items''' button
     169  a. Save the file, and close Notepad.
     170 1. Click the Windows '''Start''' button.
     171 1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear.
     172 1. Type '''!http://localhost:8000/trac/admin''' [[BR]]A browser window should open to an ''Administration'' page.
     173 1. Click the '''Configuration''' hyperlink under ''Accounts'' in the menu on the left-hand side of the page.
     174 1. Select '''1''' from the drop-down list-box next to the ''!HtDigestStore'' heading.
     175 1. Select '''1''' from the drop-down list-box next to the ''!SessionStore'' heading.
     176 1. Type '''C:\trac\conf\passwords.txt''' in to the ''filename:'' field in the ''!HtDigestStore'' section.
     177 1. Type '''trac''' in to the ''realm:'' field under the ''!HtDigestStore'' section.
     178 1. Click the '''Save''' button.
     179 1. Click the '''Users''' hyperlink under the ''Accounts'' section in the menu on the left-hand side of the page.
     180 1. Type a username in to the ''Username:'' field on the right-hand side of the page in the ''Add Account:'' section.
     181 1. Type a password in to the ''Password:'' field on the right-hand side of the page in the ''Add Account:'' section.
     182 1. Type the password in to the ''Confirm password:'' field on the right-hand side of the page in the ''Add Account:'' section.
     183 1. Type a name in to the ''Name:'' field on the right-hand side of the page in the ''Add Account:'' section.
     184 1. Type an e-mail address in to the ''Email:'' field on the right-hand side of the page in the ''Add Account:'' section.
     185 1. Click the '''Add''' button.
     186 1. Click the '''Permissions''' hyperlink under the ''General'' section in the menu on the left-hand side of the page.
     187 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.
     188 1. Select '''TRAC_ADMIN''' from the ''Action:'' drop-down list-box.
     189 1. Click the '''Add''' button.
     190 1. Check '''TRAC_ADMIN''' in the ''Action'' section in the center of the page, for the '''anonymous''' ''Subject''.
     191 1. Click the '''Remove selected items''' button.
    184192
    185 (You will need to log in as your admin user to access the admin panels from this point forward)
    186 
     193You will need to log in as your admin user to access the admin panels from this point forward.
    187194
    188195More information about the TracEnvironment setup, and the TracStandalone web front-end is available.
     196
    189197----
    190198See also: TracOnWindows