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

Timestamp:

Jan 9, 2015, 10:24:41 PM (9 years ago)

Author:

figaro

Comment:

Cosmetic changes

CookBook/Installation/TracOnWindowsWithAccountManager

@@ -1 +1 @@
 = Trac On Windows =
-''Last modified: 2009-11-09 17:05:28 GMT''
 
 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.
 [[PageOutline(2-3)]]
+
 == 1. Install Python ==
- 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).
+ 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.
  1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
- 1. Click the '''Next >''' button to ''Install for all users''
- 1. Click the '''Next >''' button to use ''C:\Python26'' as the destination directory
- 1. Click the '''Next >''' button to install all of the Python components
- 1. Wait for the installation to complete, and then click the '''Finish''' button
+ 1. Click the '''Next >''' button to ''Install for all users''.
+ 1. Click the '''Next >''' button to use ''C:\Python26'' as the destination directory.
+ 1. Click the '''Next >''' button to install all of the Python components.
+ 1. Wait for the installation to complete, and then click the '''Finish''' button.
  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):
   a. Click the Windows '''Start''' button
@@ -24 +24 @@
   a. Click the '''OK''' button in the ''System Properties'' window
 
-== 2. Setuptools ==
- 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.
- 1. Open a command window
+== 2. Setup tools ==
+ 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'''.
+ 1. Open a command window:
   a. Click the Windows '''Start''' button
   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
-  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
- 1. Type '''cd C:\Python26''' and press the ''Return'' key
- 1. Type '''ez_setup.py''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
+  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
+ 1. Type '''cd C:\Python26''' and press the ''Return'' key.
+ 1. Type '''ez_setup.py''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
 
 == 3. Subversion (optional) ==
@@ -37 +37 @@
 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.
 
-=== Subversion Server & Client ===
- 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).
+=== Subversion Server and Client ===
+
+ 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.
  1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
- 1. Click the '''__N__ext''' button on the ''Welcome to the Subversion Setup Wizard'' screen
- 1. Click the '''__N__ext''' button on the ''Information'' screen
- 1. Click the '''__N__ext''' button to select ''Binding for Apache 2.0.x''
- 1. Type '''C:\Subversion\''' in to the ''Install subversion to:'' field, and click the '''__N__ext''' button
- 1. Click the '''Finish''' button
- 1. Open a command window
+ 1. Click the '''__N__ext''' button on the ''Welcome to the Subversion Setup Wizard'' screen.
+ 1. Click the '''__N__ext''' button on the ''Information'' screen.
+ 1. Click the '''__N__ext''' button to select ''Binding for Apache 2.0.x''.
+ 1. Type '''C:\Subversion\''' in to the ''Install subversion to:'' field, and click the '''__N__ext''' button.
+ 1. Click the '''Finish''' button.
+ 1. Open a command window:
   a. Click the Windows '''Start''' button
   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
-  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
- 1. Type '''cd C:\Subversion\bin''' and press the ''Return'' key
- 1. Type '''mkdir C:\svnrepositories''' and press the ''Return'' key
- 1. Type '''svnadmin create C:\svnrepositories\myproject''' and press the ''Return'' key
- 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
- 1. Type '''net start svnserver''' and press the ''Return'' key
+  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
+ 1. Type '''cd C:\Subversion\bin''' and press the ''Return'' key.
+ 1. Type '''mkdir C:\svnrepositories''' and press the ''Return'' key.
+ 1. Type '''svnadmin create C:\svnrepositories\myproject''' and press the ''Return'' key.
+ 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.
+ 1. Type '''net start svnserver''' and press the ''Return'' key.
 
 === Subversion Bindings ===
- 1. Open a command window
+ 1. Open a command window:
   a. Click the Windows '''Start''' button
   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
-  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
- 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
- 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
+  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
+ 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key.
+ 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.
 
 == 4. mod_python (optional, and only available for Python v2.5 right now) ==
+
 mod_python is needed if you want to use Apache HTTP server.
- 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).
+ 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.
  1. Click the '''__R__un''' button in the ''Open File - Security Warning'' dialogue box, if it appears.
- 1. Click the '''__N__ext >''' button
- 1. Click the '''__N__ext >''' button to confirm the Python directory
- 1. Click the '''__N__ext >''' button to install
- 1. Select the directory where ''Apache'' is installed
- 1. Click the '''OK''' button
- 1. Click the '''Finish''' button
+ 1. Click the '''__N__ext >''' button.
+ 1. Click the '''__N__ext >''' button to confirm the Python directory.
+ 1. Click the '''__N__ext >''' button to install.
+ 1. Select the directory where ''Apache'' is installed.
+ 1. Click the '''OK''' button.
+ 1. Click the '''Finish''' button.
 
 == 5. Plug-ins (optional) ==
+
 See TracPlugins for details about plugin installation.
-For example: to install the SpamFilter plugin
- 1. Open a command window
+For example, to install the SpamFilter plugin, perform the following actions:
+ 1. Open a command window:
   a. Click the Windows '''Start''' button
   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
-  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
- 1. Type '''mkdir C:\src''' and press the ''Return'' key
- 1. Type '''cd C:\src''' and press the ''Return'' key
- 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
- 1. Type '''cd spam-filter''' and press the ''Return'' key
- 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
+  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
+ 1. Type '''mkdir C:\src''' and press the ''Return'' key.
+ 1. Type '''cd C:\src''' and press the ''Return'' key.
+ 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.
+ 1. Type '''cd spam-filter''' and press the ''Return'' key.
+ 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared.
 
 == 6. Genshi ==
- 1. Open a command window
+
+To install the Genshi templating engine, perform the following actions:
+ 1. Open a command window:
   a. Click the Windows '''Start''' button
   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
-  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
- 1. Type '''mkdir C:\src''' and press the ''Return'' key
- 1. Type '''cd C:\src''' and press the ''Return'' key
- 1. Type '''svn checkout !http://svn.edgewall.org/repos/genshi/trunk genshi''' and press the ''Return'' key
- 1. Type '''cd genshi''' and press the ''Return'' key
- 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
+  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
+ 1. Type '''mkdir C:\src''' and press the ''Return'' key.
+ 1. Type '''cd C:\src''' and press the ''Return'' key.
+ 1. Type '''svn checkout !http://svn.edgewall.org/repos/genshi/trunk genshi''' and press the ''Return'' key.
+ 1. Type '''cd genshi''' and press the ''Return'' key.
+ 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
 
 == 7. Trac ==
- 1. Open a command window
+
+ 1. Open a command window:
   a. Click the Windows '''Start''' button
   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
-  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
+  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
  1. Choose '''__ONE__''' of the following options:
 === Option 1 ===
- 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
- 1. Type '''easy_install Trac''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
+ 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key.
+ 1. Type '''easy_install Trac''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
 === Option 2 ===
- 1. Type '''mkdir C:\src''' and press the ''Return'' key
- 1. Type '''cd C:\src''' and press the ''Return'' key
- 1. Type '''svn checkout !http://svn.edgewall.org/repos/trac/trunk trac''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
- 1. Type '''cd trac''' and press the ''Return'' key
- 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
+ 1. Type '''mkdir C:\src''' and press the ''Return'' key.
+ 1. Type '''cd C:\src''' and press the ''Return'' key.
+ 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.
+ 1. Type '''cd trac''' and press the ''Return'' key.
+ 1. Type '''python setup.py install''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
 === Configure Trac environment ===
- 1. Type '''mkdir C:\trac''' and press the ''Return'' key
- 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
- 1. Type '''trac-admin \trac initenv''' and press the ''Return'' key
- 1. Type in your project name (keep it succinct) and press the ''Return'' key
- 1. Press the '''Return''' key to select the default ''Database connection string''
- 1. Press the '''Return''' key to select ''svn'' as the default ''Repository type''
- 1. Type in the full path of your repository; e.g. ''/svnrepositories/myproject'', and press the '''Return''' key
+ 1. Type '''mkdir C:\trac''' and press the ''Return'' key.
+ 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key.
+ 1. Type '''trac-admin \trac initenv''' and press the ''Return'' key.
+ 1. Type in your project name (keep it succinct) and press the ''Return'' key.
+ 1. Press the '''Return''' key to select the default ''Database connection string''.
+ 1. Press the '''Return''' key to select ''svn'' as the default ''Repository type''.
+ 1. Type in the full path of your repository; e.g. ''/svnrepositories/myproject'', and press the '''Return''' key.
  1. Verify the installation of Trac works:
   a. Type in '''tracd --port 8000 C:\trac''' to start the Trac daemon
@@ -129 +135 @@
 
 == 8. Account Manager Plug-in ==
- 1. Open a command window
+
+To install the [http://trac-hacks.org/wiki/AccountManagerPlugin AccountManager plugin], perform the following actions:
+ 1. Open a command window:
   a. Click the Windows '''Start''' button
   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
-  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear
- 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key
- 1. Type '''easy_install !http://trac-hacks.org/svn/accountmanagerplugin/trunk''' and press the ''Return'' key[[BR]]Verify no messages containing errors appeared
- 1. Type '''trac-admin C:\trac permission add anonymous TRAC_ADMIN''' and press the ''Return'' key
- 1. Click the Windows '''Start''' button
- 1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
- 1. Type '''notepad C:\trac\conf\trac.ini''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button
- 1. Copy the block of text below
+  a. Type '''cmd''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button[[BR]]A black window should appear.
+ 1. Type '''cd C:\Python26\Scripts''' and press the ''Return'' key.
+ 1. Type '''easy_install !http://trac-hacks.org/svn/accountmanagerplugin/trunk''' and press the ''Return'' key[[BR]]Verify that no messages containing errors appeared.
+ 1. Type '''trac-admin C:\trac permission add anonymous TRAC_ADMIN''' and press the ''Return'' key.
+ 1. Click the Windows '''Start''' button.
+ 1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear.
+ 1. Type '''notepad C:\trac\conf\trac.ini''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button.
+ 1. Copy the block of text below.
 {{{
 [components]
@@ -152 +160 @@
 trac.web.auth.loginmodule = disabled
 }}}
- 1. Scroll down to the ''[header_logo]'' section, and place the cursor on the blank line above it
- 1. Paste the text you copied above in to the document
- 1. Save the file, and close notepad
- 1. Create an empty '''C:\trac\conf\passwords.txt'''
+ 1. Scroll down to the ''[header_logo]'' section, and place the cursor on the blank line above it.
+ 1. Paste the text you copied above in to the document.
+ 1. Save the file, and close notepad.
+ 1. Create an empty '''C:\trac\conf\passwords.txt''':
   a. Click the Windows '''Start''' button
   a. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
   a. Type '''notepad C:\trac\conf\passwords.txt''' in to the ''__O__pen'' drop-down field, and click the '''OK''' button
-  a. Save the file, and close notepad
- 1. Click the Windows '''Start''' button
- 1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear
- 1. Type '''!http://localhost:8000/trac/admin''' [[BR]]A browser window should open to an ''Administration'' page
- 1. Click the '''Configuration''' hyperlink under ''Accounts'' in the menu on the left-hand side of the page
- 1. Select '''1''' from the drop-down list-box next to the ''!HtDigestStore'' heading
- 1. Select '''1''' from the drop-down list-box next to the ''!SessionStore'' heading
- 1. Type '''C:\trac\conf\passwords.txt''' in to the ''filename:'' field in the ''!HtDigestStore'' section
- 1. Type '''trac''' in to the ''realm:'' field under the ''!HtDigestStore'' section
- 1. Click the '''Save''' button
- 1. Click the '''Users''' hyperlink under the ''Accounts'' section in the menu on the left-hand side of the page
- 1. Type a username in to the ''Username:'' field on the right-hand side of the page in the ''Add Account:'' section
- 1. Type a password in to the ''Password:'' field on the right-hand side of the page in the ''Add Account:'' section
- 1. Type the password in to the ''Confirm password:'' field on the right-hand side of the page in the ''Add Account:'' section
- 1. Type a name in to the ''Name:'' field on the right-hand side of the page in the ''Add Account:'' section
- 1. Type an e-mail address in to the ''Email:'' field on the right-hand side of the page in the ''Add Account:'' section
- 1. Click the '''Add''' button
- 1. Click the '''Permissions''' hyperlink under the ''General'' section in the menu on the left-hand side of the page
- 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)
- 1. Select '''TRAC_ADMIN''' from the ''Action:'' drop-down list-box
- 1. Click the '''Add''' button
- 1. Check '''TRAC_ADMIN''' in the ''Action'' section in the center of the page, for the '''anonymous''' ''Subject''
- 1. Click the '''Remove selected items''' button
+  a. Save the file, and close Notepad.
+ 1. Click the Windows '''Start''' button.
+ 1. Click '''__R__un'''[[BR]]A dialogue box titled ''Run'' should appear.
+ 1. Type '''!http://localhost:8000/trac/admin''' [[BR]]A browser window should open to an ''Administration'' page.
+ 1. Click the '''Configuration''' hyperlink under ''Accounts'' in the menu on the left-hand side of the page.
+ 1. Select '''1''' from the drop-down list-box next to the ''!HtDigestStore'' heading.
+ 1. Select '''1''' from the drop-down list-box next to the ''!SessionStore'' heading.
+ 1. Type '''C:\trac\conf\passwords.txt''' in to the ''filename:'' field in the ''!HtDigestStore'' section.
+ 1. Type '''trac''' in to the ''realm:'' field under the ''!HtDigestStore'' section.
+ 1. Click the '''Save''' button.
+ 1. Click the '''Users''' hyperlink under the ''Accounts'' section in the menu on the left-hand side of the page.
+ 1. Type a username in to the ''Username:'' field on the right-hand side of the page in the ''Add Account:'' section.
+ 1. Type a password in to the ''Password:'' field on the right-hand side of the page in the ''Add Account:'' section.
+ 1. Type the password in to the ''Confirm password:'' field on the right-hand side of the page in the ''Add Account:'' section.
+ 1. Type a name in to the ''Name:'' field on the right-hand side of the page in the ''Add Account:'' section.
+ 1. Type an e-mail address in to the ''Email:'' field on the right-hand side of the page in the ''Add Account:'' section.
+ 1. Click the '''Add''' button.
+ 1. Click the '''Permissions''' hyperlink under the ''General'' section in the menu on the left-hand side of the page.
+ 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.
+ 1. Select '''TRAC_ADMIN''' from the ''Action:'' drop-down list-box.
+ 1. Click the '''Add''' button.
+ 1. Check '''TRAC_ADMIN''' in the ''Action'' section in the center of the page, for the '''anonymous''' ''Subject''.
+ 1. Click the '''Remove selected items''' button.
 
-(You will need to log in as your admin user to access the admin panels from this point forward)
-
+You will need to log in as your admin user to access the admin panels from this point forward.
 
 More information about the TracEnvironment setup, and the TracStandalone web front-end is available.
+
 ----
 See also: TracOnWindows