Context Navigation

Changes between Version 212 and Version 213 of TracOnWindows

Timestamp:: Dec 18, 2007, 6:46:05 PM (16 years ago)
Author:: Christian Boos
Comment:: Restructured the manual installation section and move one Trac install subsection in method 1, as it was talking about the installer

Legend:

: Unmodified
: Added
: Removed
: Modified

TracOnWindows

-              v212
+              v213
 || '''ClearSilver''' || [http://www.clearsilver.net/downloads/win32/clearsilver-0.9.14.win32-py2.4.exe  clearsilver-0.9.14.win32-py2.4.exe] (or the [http://www.clearsilver.net/downloads/win32/clearsilver-0.9.14.win32-py2.3.exe Python 2.3 version]) ||
+Notes:
+'''Notes:'''
  - You don't necessarily need Subversion. You can use Trac with other [VersioningSystemBackend versioning system backends] or none at all
  - You need at least one [DatabaseBackend database backend]. If you don't want to use SQLite, see the TracOnWindows/Advanced instructions for other options.
+ - Do '''not''' run easy_install on the Trac installer.  This is not currently supported and Trac will not work correctly when installed this way.
 If you want to install plugins (WebAdmin and SpamFilter highly recommended!), you also need to install Setuptools manually (see below).
+Download and run the latest stable Trac Windows installer: ''not yet available, see TracDownload#Tracdevel''
+[[comment([http://ftp.edgewall.com/pub/trac/trac-0.10.win32.exe trac-0.10.3.win32.exe])]]
+When you run the installer, it displays a window titled '''Setup Trac 0.11'''. On the first window of the installation dialog, click Next to get started. Confirm your Python directory and your intended installation directory. Click Next. Click Next again to start the installation. When the process is over, click Finish to complete the installation.
 == Method 2: Manual Installation ==
+This methods is about using `easy_install` (from Setuptools) at the command line.
+Ideally, once everything will have settle down, this will be a matter of doing `easy_install Trac`
+Don't try that yet, though, rather go through the following steps.
 === Setuptools ===
 …
 == Installing Genshi ==
+=== Installing Genshi ===
 [http://genshi.edgewall.org/wiki/Download#Zippackage Download] the zip package:
 …
 Unzip to a folder and then from that folder run `python setup.py install` in a command window. (Make sure you have added the Python install path (e.g. C:\Program Files\Python25) to your system PATH variable. You can do this by right clicking on My Computer, clicking on Properties, selecting the Advanced tab, clicking the Environment Variables button, scrolling down the second list window until you see the 'Path' variable, then editing the string to add the Python install path. Then start command line for Genshi installation.)
+== Installing Trac ==
+=== Install PySQLite ===
+Install the [http://pysqlite.org PySqlite] database driver:
+{{{
+easy_install pysqlite
+}}}
+If you want to use another database than SQLite, you need to read the TracOnWindows/Advanced instructions.
+Note: When installing PySQLite this way, you may see the following error:
+>Error: Setup script exited with error: Python was built with version 7.1
+>of Visual Studio, and extensions need to be built with the same version
+>of the compiler, but it isn't installed.
+If so, try installing PySQLite with the Windows executable installer referenced earlier:
+|| ''PySqlite'' ||  [http://initd.org/pub/software/pysqlite/releases/2.3/2.3.2/pysqlite-2.3.2.win32-py2.4.exe pysqlite-2.3.2.win32-py2.4.exe] (or the [http://initd.org/pub/software/pysqlite/releases/2.3/2.3.2/pysqlite-2.3.2.win32-py2.3.exe Python 2.3 version]) ||
+Download the installer pysqlite-2.3.2.win32-py2.4.exe to your usual download directory.
+When it has finished downloading, double-click on it to run the installer. The installer window will appear, labeled '''Setup pysqlite-2.3.2'''.
+On the first window of the installation dialog, click Next to begin the installation process.
+On the second window, confirm the Python install directory. If you have followed the instructions above, it will be "c:\python24\". The default install directory will show as "c:\python24\Lib\site-packages\". Accept the defaults or change them to match your own directory structure. Click Next to proceed.
+The next window in the dialog gives you a chance to cancel or continue. To continue, click Next.
+On the next window, the installer shows you installation progress as files are written to the target locations. When the processing is complete, click Finish. If you check the contents of c:\python24\Lib\site-packages\ directory, you should see the directory '''pysqlite2''', which contains the database scripts.
+=== Install Subversion (optional) === #Subversion
+====  ==== #svntools
+Trac can integrate with the [http://subversion.tigris.org Subversion] version control software.  Follow these steps if you'd like to use Trac with Subversion.  You can learn more about how they can integrate from the wiki: TracSubversion.
+This document covers using the Subversion command line tools, but you can also use the [http://tortoisesvn.net/ TortoiseSVN] Windows GUI.
+Download and run the installer for the Subversion command line tools:
+[http://subversion.tigris.org/files/documents/15/35379/svn-1.4.2-setup.exe svn-1.4.2-setup.exe]
+The installation begins by displaying a small dialog titled '''Setup'''. It asks you whether you wish to continue. Click Yes.
+A larger window appears, titled '''Setup - Subversion'''. The first window of the dialog says "Welcome to the Subversion Setup Wizard". Click Next. Click "I accept the agreement" and then click Next. On the next window, read the important information and click Next.
+Select your destination directory for the Subversion installation. Click Next. You will then have the option of installing a Subversion menu item on the Start Menu, and a selection of places to put Subversion icons. Click Next. Finally you are ready to install. Click Next and the files will be copied to your selected destination. A couple more windows follow the install process, and then you're done.
+====  ==== #svnbindings
+Go back to your command line to install the Subversion Python library:
+{{{
+easy_install -Z http://subversion.tigris.org/downloads/svn-python-1.4.2.win32-py2.4.exe
+}}}
+'''Note:''' the "-Z" option is necessary when installing Subversion so that it is "unzipped".  Trac will not be able to access Subversion if it is zipped.
+The installation process will begin with "Downloading http://subversion.tigris.org/downloads/svn-python-1.4.2.win32-py2.4.exe" and -- if successful -- ends with "Processing dependencies for svn-python==1.4.2".
+=== Install ClearSilver (optional) ===
+Install the [http://www.clearsilver.net/ ClearSilver] template language:
+{{{
+easy_install -f http://clearsilver.net/downloads clearsilver==0.9.14
+}}}
+=== Installing mod_python for use with the Apache HTTP server (optional) ===
+If you are using an Apache server, you will need the latest mod_python for windows, built against Python v2.5.  Currently version 3.3.1 is available at the [http://httpd.apache.org/download.cgi Apache] website (click on "Other Files" and surf to `modpython/win/3.3.1/`).  However, you can also get other versions [http://nicolas.lehuen.com/download/mod_python/ here], courtesy of a very kind and wise gentleman called Nicolas Lehuen.
+=== Installing plugins ===
+There's no need to install the WebAdmin plugin, as it has now been integrated in Trac proper.
+Quite to the contrary, you should remove it if you're upgrading (it will be automatically disable though, so don't worry).
+See TracPlugins for details about plugin installation.
+For example, you can install the SpamFilter plugin. For that, you can grab them directly from the repository, and install it the same way you did for Trac:
+{{{
+> cd C:\src
+> svn checkout http://svn.edgewall.org/repos/trac/sandbox/spam-filter
+> cd spam-filter
+> python setup.py install
+}}}
+Note if you catch an error:"ImportError: No module named setuptools" please download http://peak.telecommunity.com/dist/ez_setup.py and install the setuptools.
+If for some reason the above step fails, either because there's no package for the Windows platform you're using or the setuptools don't manage to read information from your svn working copy (if you used Subversion 1.4 for doing the checkout), you'll probably need to install first a recent `setuptools` package, itself available from `http://svn.python.org/projects/sandbox/trunk/setuptools`. Version 0.7a1 (!r51948) from the repository worked for me.
+=== Installing Trac ===
 You simply need the latest trunk (0.11dev) (beta1 to come ''very'' soon) - to get this type the following in the command window. (Make sure you have added the Python install path (e.g. C:\Program Files\Python25) to your system PATH variable.  You can do this by right clicking on My Computer, clicking on Properties, selecting the Advanced tab, clicking the Environment Variables button, scrolling down the second list window until you see the 'Path' variable, then editing the string to add the Python install path).  Make sure you have [http://peak.telecommunity.com/DevCenter/EasyInstall#installation-instructions setuptools] installed before proceed.
 …
 And you'll be able to see the Admin tab if you log in with 'adm'[[BR]]
-== Installing mod_python for use with the Apache HTTP server ==
-If you are using an Apache server, you will need the latest mod_python for windows, built against Python v2.5.  Currently version 3.3.1 is available at the [http://httpd.apache.org/download.cgi Apache] website (click on "Other Files" and surf to `modpython/win/3.3.1/`).  However, you can also get other versions [http://nicolas.lehuen.com/download/mod_python/ here], courtesy of a very kind and wise gentleman called Nicolas Lehuen.
-== Installing plugins ==
-There's no need to install the WebAdmin plugin, as it has now been integrated in Trac proper.
-Quite to the contrary, you should remove it if you're upgrading (it will be automatically disable though, so don't worry).
-See TracPlugins for details about plugin installation.
-For example, you can install the SpamFilter plugin. For that, you can grab them directly from the repository, and install it the same way you did for Trac:
-{{{
-> cd C:\src
-> svn checkout http://svn.edgewall.org/repos/trac/sandbox/spam-filter
-> cd spam-filter
-> python setup.py install
-}}}
-Note if you catch an error:"ImportError: No module named setuptools" please download http://peak.telecommunity.com/dist/ez_setup.py and install the setuptools.
-If for some reason the above step fails, either because there's no package for the Windows platform you're using or the setuptools don't manage to read information from your svn working copy (if you used Subversion 1.4 for doing the checkout), you'll probably need to install first a recent `setuptools` package, itself available from `http://svn.python.org/projects/sandbox/trunk/setuptools`. Version 0.7a1 (!r51948) from the repository worked for me.
-=== Install PySQLite ===
-Install the [http://pysqlite.org PySqlite] database driver:
-{{{
-easy_install pysqlite
-}}}
-If you want to use another database than SQLite, you need to read the TracOnWindows/Advanced instructions.
-Note: When installing PySQLite this way, you may see the following error:
->Error: Setup script exited with error: Python was built with version 7.1
->of Visual Studio, and extensions need to be built with the same version
->of the compiler, but it isn't installed.
-If so, try installing PySQLite with the Windows executable installer referenced earlier:
-|| ''PySqlite'' ||  [http://initd.org/pub/software/pysqlite/releases/2.3/2.3.2/pysqlite-2.3.2.win32-py2.4.exe pysqlite-2.3.2.win32-py2.4.exe] (or the [http://initd.org/pub/software/pysqlite/releases/2.3/2.3.2/pysqlite-2.3.2.win32-py2.3.exe Python 2.3 version]) ||
-Download the installer pysqlite-2.3.2.win32-py2.4.exe to your usual download directory.
-When it has finished downloading, double-click on it to run the installer. The installer window will appear, labeled '''Setup pysqlite-2.3.2'''.
-On the first window of the installation dialog, click Next to begin the installation process.
-On the second window, confirm the Python install directory. If you have followed the instructions above, it will be "c:\python24\". The default install directory will show as "c:\python24\Lib\site-packages\". Accept the defaults or change them to match your own directory structure. Click Next to proceed.
-The next window in the dialog gives you a chance to cancel or continue. To continue, click Next.
-On the next window, the installer shows you installation progress as files are written to the target locations. When the processing is complete, click Finish. If you check the contents of c:\python24\Lib\site-packages\ directory, you should see the directory '''pysqlite2''', which contains the database scripts.
-=== Install Subversion (optional) === #Subversion
-====  ==== #svntools
-Trac can integrate with the [http://subversion.tigris.org Subversion] version control software.  Follow these steps if you'd like to use Trac with Subversion.  You can learn more about how they can integrate from the wiki: TracSubversion.
-This document covers using the Subversion command line tools, but you can also use the [http://tortoisesvn.net/ TortoiseSVN] Windows GUI.
-Download and run the installer for the Subversion command line tools:
-[http://subversion.tigris.org/files/documents/15/35379/svn-1.4.2-setup.exe svn-1.4.2-setup.exe]
-The installation begins by displaying a small dialog titled '''Setup'''. It asks you whether you wish to continue. Click Yes.
-A larger window appears, titled '''Setup - Subversion'''. The first window of the dialog says "Welcome to the Subversion Setup Wizard". Click Next. Click "I accept the agreement" and then click Next. On the next window, read the important information and click Next.
-Select your destination directory for the Subversion installation. Click Next. You will then have the option of installing a Subversion menu item on the Start Menu, and a selection of places to put Subversion icons. Click Next. Finally you are ready to install. Click Next and the files will be copied to your selected destination. A couple more windows follow the install process, and then you're done.
-====  ==== #svnbindings
-Go back to your command line to install the Subversion Python library:
-{{{
-easy_install -Z http://subversion.tigris.org/downloads/svn-python-1.4.2.win32-py2.4.exe
-}}}
-'''Note:''' the "-Z" option is necessary when installing Subversion so that it is "unzipped".  Trac will not be able to access Subversion if it is zipped.
-The installation process will begin with "Downloading http://subversion.tigris.org/downloads/svn-python-1.4.2.win32-py2.4.exe" and -- if successful -- ends with "Processing dependencies for svn-python==1.4.2".
-=== Install ClearSilver (optional) ===
-Install the [http://www.clearsilver.net/ ClearSilver] template language:
-{{{
-easy_install -f http://clearsilver.net/downloads clearsilver==0.9.14
-}}}
-=== Install Trac ===
-Download and run the latest stable Trac Windows installer: ''not yet available, see TracDownload#Tracdevel''
-[[comment([http://ftp.edgewall.com/pub/trac/trac-0.10.win32.exe trac-0.10.3.win32.exe])]]
-'''Note:''' do '''not''' run easy_install on the Trac installer.  This is not currently supported and Trac will not work correctly when installed this way.
-When you run the installer, it displays a window titled '''Setup Trac 0.10'''. On the first window of the installation dialog, click Next to get started. Confirm your Python directory and your intended installation directory. Click Next. Click Next again to start the installation. When the process is over, click Finish to complete the installation.
-----
-----
-See also: TracOnWindows/Advanced, ["0.10/TracOnWindows"], ["0.9/TracOnWindows"]
 …
 It appears you can successfully install Trac by following a combination of Method 3: Manual Installation and Method 2: Using Installers, above. The critical step for installing PySQLite is to use the self-installing EXE version, which does not trigger the bogus compile step. As noted above, download and execute the appropriate file:
+It appears you can successfully install Trac by following a combination of Method 2: Manual Installation and Method 1: Using Installers, above. The critical step for installing PySQLite is to use the self-installing EXE version, which does not trigger the bogus compile step. As noted above, download and execute the appropriate file:
 …
 ----
+See also: the TracOnWindows/Advanced instructions, TracOnWindows/Rewrite for discussing improvements to this page and ["Trac0.9/TracOnWindows"] for the previous version of this document.
+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.