![(please configure [header_logo] section in trac.ini)](https://lpsc.in2p3.fr/trac/chrome/common/logo_LPSC.png){kind=logo}
Changes between Version 18 and Version 19 of TracInstall
- Timestamp:
- 22/07/2019 15:54:52 (5 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracInstall
v18 v19 2 2 [[TracGuideToc]] 3 3 4 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.4 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. 5 5 6 6 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. … … 16 16 To install Trac, the following software packages must be installed: 17 17 18 * [http ://www.python.org/ Python], version >= 2.6 and < 3.018 * [https://www.python.org/ Python], version >= 2.6 and < 3.0 19 19 (note that we dropped the support for Python 2.5 in this release) 20 * [http ://pypi.python.org/pypi/setuptools setuptools], version >= 0.621 * [http ://genshi.edgewall.org/wiki/DownloadGenshi], version >= 0.620 * [https://pypi.org/project/setuptools setuptools], version >= 0.6 21 * [https://pypi.org/project/Genshi Genshi], version >= 0.6 22 22 23 23 You also need a database system and the corresponding python bindings. The database can be either SQLite, PostgreSQL or MySQL. … … 27 27 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). 28 28 29 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.29 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. 30 30 31 31 ==== For the PostgreSQL database #ForPostgreSQL 32 32 33 33 You need to install the database and its Python bindings: 34 * [http ://www.postgresql.org/ PostgreSQL], version 8.0 or later35 * [http ://pypi.python.org/pypi/psycopg2 psycopg2], version 2.0 or later34 * [https://www.postgresql.org/ PostgreSQL], version 8.0 or later 35 * [https://pypi.org/project/psycopg2 psycopg2], version 2.0 or later 36 36 37 37 See [trac:DatabaseBackend#Postgresql DatabaseBackend] for details. … … 41 41 Trac works well with MySQL, provided you follow the guidelines: 42 42 43 * [http ://mysql.com/ MySQL], version 5.0 or later44 * [http ://sf.net/projects/mysql-python MySQLdb], version 1.2.2 or later43 * [https://www.mysql.com/ MySQL], version 5.0 or later 44 * [https://sf.net/projects/mysql-python MySQLdb], version 1.2.2 or later 45 45 46 46 Given the caveats and known issues surrounding MySQL, read carefully the [trac:MySqlDb] page before creating the database. … … 50 50 ==== Subversion 51 51 52 [http ://subversion.apache.org/ Subversion], 1.6.x or later and the '''''corresponding''''' Python bindings.53 54 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.)52 [https://subversion.apache.org/ Subversion], 1.6.x or later and the '''''corresponding''''' Python bindings. 53 54 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.) 55 55 56 56 For troubleshooting information, see the [trac:TracSubversion#Troubleshooting TracSubversion] page. … … 64 64 ==== Git 65 65 66 [http ://git-scm.com/ Git] 1.5.6 or later is supported. More information is available on the [trac:TracGit] page.66 [https://git-scm.com/ Git] 1.5.6 or later is supported. More information is available on the [trac:TracGit] page. 67 67 68 68 ==== Other Version Control Systems … … 74 74 75 75 Alternatively you can configure Trac to run in any of the following environments: 76 * [http ://httpd.apache.org/ Apache] with77 * [https://github.com/GrahamDumpleton/mod_wsgi mod_wsgi], see [wiki:TracModWSGI] and [http ://code.google.com/p/modwsgi/wiki/IntegrationWithTrac ModWSGI IntegrationWithTrac].76 * [https://httpd.apache.org/ Apache] with 77 * [https://github.com/GrahamDumpleton/mod_wsgi mod_wsgi], see [wiki:TracModWSGI] and [https://code.google.com/p/modwsgi/wiki/IntegrationWithTrac ModWSGI IntegrationWithTrac]. 78 78 * [http://modpython.org/ mod_python 3.5.0], see TracModPython 79 79 * a [http://www.fastcgi.com/ FastCGI]-capable web server (see TracFastCgi) 80 * an [http ://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web80 * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web 81 81 server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp]) 82 82 * Microsoft IIS with FastCGI and a FastCGI-to-WSGI gateway (see [trac:CookBook/Installation/TracOnWindowsIisWfastcgi IIS with FastCGI]) … … 110 110 111 111 === Using `easy_install` 112 Trac can be installed from PyPI or the Subversion repository using [http ://pypi.python.org/pypi/setuptools setuptools].112 Trac can be installed from PyPI or the Subversion repository using [https://pypi.org/project/setuptools setuptools]. 113 113 114 114 A few examples: … … 120 120 - Install latest development version: 121 121 {{{#!sh 122 $ easy_install http ://download.edgewall.org/trac/Trac-latest-dev.tar.gz122 $ easy_install https://download.edgewall.org/trac/Trac-latest-dev.tar.gz 123 123 }}} 124 124 Note that in this case you won't have the possibility to run a localized version of Trac; … … 186 186 }}} 187 187 188 Also see [http ://docs.python.org/2/install/index.html Installing Python Modules] for detailed information.188 Also see [https://docs.python.org/2/install/index.html Installing Python Modules] for detailed information. 189 189 190 190 Specifically, you might be interested in: … … 273 273 - [TracCgi CGI] //(should not be used, as the performance is far from optimal)// 274 274 275 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.275 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. 276 276 277 277 ==== Generating the Trac cgi-bin directory #cgi-bin … … 296 296 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. 297 297 298 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.298 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. 299 299 300 300 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.
