Changes between Initial Version and Version 1 of TracOnWindowsStandalone

Timestamp:

Sep 13, 2005, 10:20:32 PM (19 years ago)

Author:

jornh

Comment:

A guide for setting up Trac on Windows without Apache

TracOnWindowsStandalone

@@ +1 @@
+= Trac Standalone Server On Windows =
+
+''This Windows specific guide is heavily based on the generic TracInstall guide with bits and pieces borrowed from TracOnWindows''
+
+The goal of this guide is to get Windows users up and running as quickly as possible with the minimal amount of fuss.
+
+So if you just want to set up Trac on a Windows machine to play around with the features in Trac use this setup. 
+
+This setup uses the ''tracd'' stand alone server and does not require installation and configuration of a separate webserver like Apache. To read about the pro's and con's of a ''tracd'' based  install compared to other options see the generic TracStandalone page. That page also contains some additional tips for a Windows setup.
+
+For a more verbose guide including more options and possible hints if you run into problems see TracOnWindows
+
+This short guide takes you through these steps:
+
+ 1. Downloading other required binary packages and Trac itself
+ 1. Installing everything
+ 2. Creating a Project Environment
+ 3. Running ''tracd'' the Standalone Server
+ 4. Using Trac (and Subversion)
+
+== Downloading Requirements ==
+
+To install Trac, the following software packages must be installed:
+
+ * [http://www.python.org/2.3.5 Python], version 2.3.5.
+   * Note: Python 2.4 is __not__ recommended on Windows yet since there are no Subversion bindings compatible with Apache available.
+ * [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91 Subversion], version 1.2.3 
+ * [http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=91&filter=py Python bindings for Subversion], version 2.3-1.2.3 (must correspond to both Python and Subversion versions mentioned above)
+ * [http://www.clearsilver.net/downloads/win32/clearsilver-0.9.14.win32-py2.3.exe ClearSilver], version 0.9.14
+ * [http://initd.org/pub/software/pysqlite/releases/1.1/1.1.6/pysqlite-1.1.6.win32-py2.3.exe PySQLite], version 1.1.6
+ * [http://projects.edgewall.com/trac/wiki/TracDownload Trac], version 0.9b1
+ 
+== Installing Everything ==
+
+1. Install Subversion
+
+2. Install Python
+
+Add C:\Python23 to the PATH environment variable ''(or you will have to supply the path on every call to python in the sections below)''
+
+3. Install everything else by following the steps in the TracOnWindows#InstallTracPrerequisites section. 
+
+== Creating a Project Environment ==
+
+A [wiki:TracEnvironment Trac environment] is the backend storage where Trac stores information like wiki pages, tickets, reports, settings, etc. An environment is basically a directory that contains a human-readable configuration file and various other files and directories.
+
+A new environment is created using [wiki:TracAdmin trac-admin]:
+{{{
+C:\> svnadmin create C:\path\to\svn_project_env
+C:\Python23\Scripts> python trac-admin C:\path\to\trac_project_env initenv
+}}}
+
+[wiki:TracAdmin trac-admin] will prompt you for the information it needs to create the environment, such as the name of the project, the database connection string, and so on.
+
+
+== Running the Standalone Server ==
+
+After having created a Trac environment, you can easily try the web interface by running the standalone server [wiki:TracStandalone tracd]:
+{{{
+C:\Python23\Scripts> python tracd --port 8000 C:\path\to\projectenv
+}}}
+
+Then, fire up a browser and visit `http://localhost:8000/`. You should get a simple listing of all environments that tracd knows about. Follow the link to the environment you just created, and you should see Trac in action.
+
+
+== Using Trac (and Subversion) ==
+
+Once you have your Trac site up and running, you should be able to browse your subversion repository, create tickets, view the timeline, etc.
+
+Keep in mind that anonymous (not logged in) users can by default access most but not all of the features. You will need to configure authentication and grant additional [wiki:TracPermissions permissions] to authenticated users to see the full set of features.
+
+''Enjoy!''
+
+
+----
+See also:  TracGuide, TracStandalone, TracUpgrade, TracPermissions, TracOnWindows