Changes between Version 437 and Version 438 of TracInstall
- Timestamp:
- Oct 19, 2018, 10:56:53 AM (6 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracInstall
v437 v438 3 3 [[TranslatedPages]] 4 4 5 Trac is written in the Python programming language and needs a database, [http ://sqlite.org/ SQLite], [http://www.postgresql.org/ PostgreSQL], or [http://mysql.com/ MySQL]. For HTML rendering, Trac uses the [http://genshi.edgewall.orgGenshi] templating system.5 Trac is written in the Python programming language and needs a database, [https://sqlite.org/ SQLite], [https://www.postgresql.org/ PostgreSQL], or [https://www.mysql.com/ MySQL]. For HTML rendering, Trac uses the [https://genshi.edgewall.org/ Genshi] templating system. 6 6 7 7 Trac can also be localized, and there is probably a translation available in your language. If you want to use the Trac interface in other languages, then make sure you have installed the optional package [#OtherPythonPackages Babel]. Pay attention to the extra steps for localization support in the [#InstallingTrac Installing Trac] section below. Lacking Babel, you will only get the default English version. … … 17 17 To install Trac, the following software packages must be installed: 18 18 19 * [http ://www.python.org/ Python], version >= 2.6 and < 3.019 * [https://www.python.org/ Python], version >= 2.6 and < 3.0 20 20 (note that we dropped the support for Python 2.5 in this release) 21 * [http ://pypi.python.org/pypi/setuptools setuptools], version >= 0.622 * [http ://genshi.edgewall.org/wiki/DownloadGenshi], version >= 0.621 * [https://pypi.org/project/setuptools setuptools], version >= 0.6 22 * [https://pypi.org/project/Genshi Genshi], version >= 0.6 23 23 24 24 You also need a database system and the corresponding python bindings. The database can be either SQLite, PostgreSQL or MySQL. … … 28 28 As you must be using Python 2.6 or 2.7, you already have the SQLite database bindings bundled with the standard distribution of Python (the `sqlite3` module). 29 29 30 Optionally, you may install a newer version of [http ://pypi.python.org/pypi/pysqlite pysqlite] than the one provided by the Python distribution. See [trac:PySqlite#ThePysqlite2bindings PySqlite] for details.30 Optionally, you may install a newer version of [https://pypi.org/project/pysqlite pysqlite] than the one provided by the Python distribution. See [trac:PySqlite#ThePysqlite2bindings PySqlite] for details. 31 31 32 32 ==== For the PostgreSQL database #ForPostgreSQL 33 33 34 34 You need to install the database and its Python bindings: 35 * [http ://www.postgresql.org/ PostgreSQL], version 8.0 or later36 * [http ://pypi.python.org/pypi/psycopg2 psycopg2], version 2.0 or later35 * [https://www.postgresql.org/ PostgreSQL], version 8.0 or later 36 * [https://pypi.org/project/psycopg2 psycopg2], version 2.0 or later 37 37 38 38 See [trac:DatabaseBackend#Postgresql DatabaseBackend] for details. … … 42 42 Trac works well with MySQL, provided you follow the guidelines: 43 43 44 * [http ://mysql.com/ MySQL], version 5.0 or later45 * [http ://sf.net/projects/mysql-python MySQLdb], version 1.2.2 or later44 * [https://www.mysql.com/ MySQL], version 5.0 or later 45 * [https://sf.net/projects/mysql-python MySQLdb], version 1.2.2 or later 46 46 47 47 Given the caveats and known issues surrounding MySQL, read carefully the [trac:MySqlDb] page before creating the database. … … 51 51 ==== Subversion 52 52 53 [http ://subversion.apache.org/ Subversion], 1.6.x or later and the '''''corresponding''''' Python bindings.54 55 There are [http ://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. (Good luck finding precompiled SWIG bindings for any Windows package at that listing. [trac:TracSubversion] points you to [http://alagazam.net Alagazam], which works for me under Python 2.6.)53 [https://subversion.apache.org/ Subversion], 1.6.x or later and the '''''corresponding''''' Python bindings. 54 55 There are [https://subversion.apache.org/packages.html pre-compiled SWIG bindings] available for various platforms. (Good luck finding precompiled SWIG bindings for any Windows package at that listing. [trac:TracSubversion] points you to [https://alagazam.net Alagazam], which works for me under Python 2.6.) 56 56 57 57 For troubleshooting information, see the [trac:TracSubversion#Troubleshooting TracSubversion] page. … … 65 65 ==== Git 66 66 67 [http ://git-scm.com/ Git] 1.5.6 or later is supported. More information is available on the [trac:TracGit] page.67 [https://git-scm.com/ Git] 1.5.6 or later is supported. More information is available on the [trac:TracGit] page. 68 68 69 69 ==== Other Version Control Systems … … 75 75 76 76 Alternatively you can configure Trac to run in any of the following environments: 77 * [http ://httpd.apache.org/ Apache] with78 * [https://github.com/GrahamDumpleton/mod_wsgi mod_wsgi], see [wiki:TracModWSGI] and [http ://code.google.com/p/modwsgi/wiki/IntegrationWithTrac ModWSGI IntegrationWithTrac].77 * [https://httpd.apache.org/ Apache] with 78 * [https://github.com/GrahamDumpleton/mod_wsgi mod_wsgi], see [wiki:TracModWSGI] and [https://code.google.com/p/modwsgi/wiki/IntegrationWithTrac ModWSGI IntegrationWithTrac]. 79 79 * [http://modpython.org/ mod_python 3.5.0], see TracModPython 80 80 * a [http://www.fastcgi.com/ FastCGI]-capable web server (see TracFastCgi) 81 * an [http ://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web81 * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web 82 82 server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp]) 83 83 * Microsoft IIS with FastCGI and a FastCGI-to-WSGI gateway (see [trac:CookBook/Installation/TracOnWindowsIisWfastcgi IIS with FastCGI]) … … 111 111 112 112 === Using `easy_install` 113 Trac can be installed from PyPI or the Subversion repository using [http ://pypi.python.org/pypi/setuptools setuptools].113 Trac can be installed from PyPI or the Subversion repository using [https://pypi.org/project/setuptools setuptools]. 114 114 115 115 A few examples: … … 121 121 - Install latest development version: 122 122 {{{#!sh 123 $ easy_install http ://download.edgewall.org/trac/Trac-latest-dev.tar.gz123 $ easy_install https://download.edgewall.org/trac/Trac-latest-dev.tar.gz 124 124 }}} 125 125 Note that in this case you won't have the possibility to run a localized version of Trac; … … 187 187 }}} 188 188 189 Also see [http ://docs.python.org/2/install/index.html Installing Python Modules] for detailed information.189 Also see [https://docs.python.org/2/install/index.html Installing Python Modules] for detailed information. 190 190 191 191 Specifically, you might be interested in: … … 274 274 - [TracCgi CGI] //(should not be used, as the performance is far from optimal)// 275 275 276 Trac also supports [trac:TracOnWindowsIisAjp AJP] which may be your choice if you want to connect to IIS. Other deployment scenarios are possible: [trac:TracNginxRecipe nginx], [http ://projects.unbit.it/uwsgi/wiki/Example#Traconapacheinasub-uri uwsgi], [trac:TracOnWindowsIisIsapi Isapi-wsgi] etc.276 Trac also supports [trac:TracOnWindowsIisAjp AJP] which may be your choice if you want to connect to IIS. Other deployment scenarios are possible: [trac:TracNginxRecipe nginx], [https://uwsgi-docs.readthedocs.io/en/latest/#Traconapacheinasub-uri uwsgi], [trac:TracOnWindowsIisIsapi Isapi-wsgi] etc. 277 277 278 278 ==== Generating the Trac cgi-bin directory #cgi-bin … … 297 297 Without additional configuration, Trac will handle requests for static resources such as stylesheets and images. For anything other than a TracStandalone deployment, this is not optimal as the web server can be set up to directly serve the static resources. For CGI setup, this is '''highly undesirable''' as it causes abysmal performance. 298 298 299 Web servers such as [http ://httpd.apache.org/ Apache] allow you to create //Aliases// to resources, giving them a virtual URL that doesn't necessarily reflect their location on the file system. We can map requests for static resources directly to directories on the file system, to avoid Trac processing the requests.299 Web servers such as [https://httpd.apache.org/ Apache] allow you to create //Aliases// to resources, giving them a virtual URL that doesn't necessarily reflect their location on the file system. We can map requests for static resources directly to directories on the file system, to avoid Trac processing the requests. 300 300 301 301 There are two primary URL paths for static resources: `/chrome/common` and `/chrome/site`. Plugins can add their own resources, usually accessible at the `/chrome/<plugin>` path.