Edgewall Software

Changes between Initial Version and Version 1 of CookBook/Installation/TracOnWindowsWithAccountManager


Ignore:
Timestamp:
Dec 17, 2009, 11:44:15 PM (13 years ago)
Author:
Christian Boos
Comment:

Moved TracOnWindows@300 written originally by "trac@…" to a dedicated recipe

Legend:

Unmodified
Added
Removed
Modified
  • CookBook/Installation/TracOnWindowsWithAccountManager

    v1 v1  
     1= Trac On Windows =
     2''Last modified: 2009-11-09 17:05:28 GMT''
     3
     4The following instructions use 32-bit software packages. The 64-bit software packages do not yet integrate seamlessly with each other, so are not recommended.
     5[[PageOutline(2-3)]]
     6== 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).
     8 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
     13 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):
     14  a. Click the Windows '''Start''' button
     15  a. Right-click the '''My Computer''' icon
     16  a. Click the '''P__r__operties''' option at the bottom of the pop-up menu
     17  a. Click the '''Advanced''' tab
     18  a. Click the '''Enviro__n__ment Variables''' button
     19  a. Scroll down the ''__S__ystem variables'' listbox to the '''Path''' ''Variable''
     20  a. Select the '''Path''' ''Variable'' and click the ''Ed__i__t'' button below it - DO NOT click on the edit button above
     21  a. Scroll to the right-hand end of the ''Variable __v__alue'' field, and type ''';C:\Python26;C:\Python26\Scripts'''
     22  a. Click the '''OK''' button in the ''Edit System Variable'' window
     23  a. Click the '''OK''' button in the ''Environment Variables'' window
     24  a. Click the '''OK''' button in the ''System Properties'' window
     25
     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
     29  a. Click the Windows '''Start''' button
     30  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
     34
     35== 3. Subversion (optional) ==
     36
     37Trac can integrate with [http://subversion.tigris.org Subversion] version control software. Read more about the integration between Trac and Subversion from the wiki: TracSubversion.
     38
     39=== Subversion Server & Client ===
     40 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).
     41 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
     48  a. Click the Windows '''Start''' button
     49  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
     56
     57=== Subversion Bindings ===
     58 1. Open a command window
     59  a. Click the Windows '''Start''' button
     60  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/46888/svn-python-1.6.6.win32-py2.6.exe''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
     64
     65== 4. mod_python (optional, and only available for Python v2.5 right now) ==
     66mod_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).
     68 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
     75
     76== 5. Plug-ins (optional) ==
     77See TracPlugins for details about plugin installation.
     78For example: to install the SpamFilter plugin
     79 1. Open a command window
     80  a. Click the Windows '''Start''' button
     81  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/sandbox/spam-filter/trunk 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
     88
     89== 6. Genshi ==
     90 1. Open a command window
     91  a. Click the Windows '''Start''' button
     92  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
     99
     100== 7. Trac ==
     101 1. Open a command window
     102  a. Click the Windows '''Start''' button
     103  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
     105 1. Choose '''__ONE__''' of the following options:
     106=== 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
     109=== 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
     115=== 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
     123 1. Verify the installation of Trac works:
     124  a. Type in '''tracd --port 8000 C:\trac''' to start the Trac daemon
     125  a. Click the Windows '''Start''' button
     126  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
     127  a. Type '''!http://localhost:8000''' [[BR]]A browser window should open to a page with ''Available Projects''
     128  a. Click on your project's name, and you should be taken to your project's Trac home page.
     129
     130== 8. Account Manager Plug-in ==
     131 1. Open a command window
     132  a. Click the Windows '''Start''' button
     133  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{{{
     143[components]
     144acct_mgr.admin.accountmanageradminpage = enabled
     145acct_mgr.api.accountmanager = enabled
     146acct_mgr.db.sessionstore = enabled
     147acct_mgr.htfile.htdigeststore = enabled
     148acct_mgr.pwhash.htdigesthashmethod = enabled
     149acct_mgr.web_ui.accountmodule = enabled
     150acct_mgr.web_ui.loginmodule = enabled
     151acct_mgr.web_ui.registrationmodule = enabled
     152trac.web.auth.loginmodule = disabled
     153}}}
     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'''
     158  a. Click the Windows '''Start''' button
     159  a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
     160  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
     184
     185(You will need to log in as your admin user to access the admin panels from this point forward)
     186
     187
     188More information about the TracEnvironment setup, and the TracStandalone web front-end is available.
     189----
     190See also: TracOnWindows