Edgewall Software

Changes between Version 437 and Version 438 of TracInstall


Ignore:
Timestamp:
Oct 19, 2018, 10:56:53 AM (5 weeks ago)
Author:
Jun Omae
Comment:

Use https links and update links

Legend:

Unmodified
Added
Removed
Modified
  • TracInstall

    v437 v438  
    33[[TranslatedPages]]
    44
    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.org Genshi] templating system.
     5Trac 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.
    66
    77Trac 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.
     
    1717To install Trac, the following software packages must be installed:
    1818
    19  * [http://www.python.org/ Python], version >= 2.6 and < 3.0
     19 * [https://www.python.org/ Python], version >= 2.6 and < 3.0
    2020   (note that we dropped the support for Python 2.5 in this release)
    21  * [http://pypi.python.org/pypi/setuptools setuptools], version >= 0.6
    22  * [http://genshi.edgewall.org/wiki/Download Genshi], version >= 0.6
     21 * [https://pypi.org/project/setuptools setuptools], version >= 0.6
     22 * [https://pypi.org/project/Genshi Genshi], version >= 0.6
    2323
    2424You also need a database system and the corresponding python bindings. The database can be either SQLite, PostgreSQL or MySQL.
     
    2828As 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).
    2929
    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.
     30Optionally, 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.
    3131
    3232==== For the PostgreSQL database #ForPostgreSQL
    3333
    3434You need to install the database and its Python bindings:
    35  * [http://www.postgresql.org/ PostgreSQL], version 8.0 or later
    36  * [http://pypi.python.org/pypi/psycopg2 psycopg2], version 2.0 or later
     35 * [https://www.postgresql.org/ PostgreSQL], version 8.0 or later
     36 * [https://pypi.org/project/psycopg2 psycopg2], version 2.0 or later
    3737
    3838See [trac:DatabaseBackend#Postgresql DatabaseBackend] for details.
     
    4242Trac works well with MySQL, provided you follow the guidelines:
    4343
    44  * [http://mysql.com/ MySQL], version 5.0 or later
    45  * [http://sf.net/projects/mysql-python MySQLdb], version 1.2.2 or later
     44 * [https://www.mysql.com/ MySQL], version 5.0 or later
     45 * [https://sf.net/projects/mysql-python MySQLdb], version 1.2.2 or later
    4646
    4747Given the caveats and known issues surrounding MySQL, read carefully the [trac:MySqlDb] page before creating the database.
     
    5151==== Subversion
    5252
    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
     55There 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.)
    5656
    5757For troubleshooting information, see the [trac:TracSubversion#Troubleshooting TracSubversion] page.
     
    6565==== Git
    6666
    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.
    6868
    6969==== Other Version Control Systems
     
    7575
    7676Alternatively you can configure Trac to run in any of the following environments:
    77  * [http://httpd.apache.org/ Apache] with
    78   * [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].
    7979  * [http://modpython.org/ mod_python 3.5.0], see TracModPython
    8080 * a [http://www.fastcgi.com/ FastCGI]-capable web server (see TracFastCgi)
    81  * an [http://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web
     81 * an [https://tomcat.apache.org/connectors-doc/ajp/ajpv13a.html AJP]-capable web
    8282   server (see [trac:TracOnWindowsIisAjp TracOnWindowsIisAjp])
    8383 * Microsoft IIS with FastCGI and a FastCGI-to-WSGI gateway (see [trac:CookBook/Installation/TracOnWindowsIisWfastcgi IIS with FastCGI])
     
    111111
    112112=== Using `easy_install`
    113 Trac can be installed from PyPI or the Subversion repository using [http://pypi.python.org/pypi/setuptools setuptools].
     113Trac can be installed from PyPI or the Subversion repository using [https://pypi.org/project/setuptools setuptools].
    114114
    115115A few examples:
     
    121121 - Install latest development version:
    122122 {{{#!sh
    123 $ easy_install http://download.edgewall.org/trac/Trac-latest-dev.tar.gz
     123$ easy_install https://download.edgewall.org/trac/Trac-latest-dev.tar.gz
    124124}}}
    125125   Note that in this case you won't have the possibility to run a localized version of Trac;
     
    187187}}}
    188188
    189 Also see [http://docs.python.org/2/install/index.html Installing Python Modules] for detailed information.
     189Also see [https://docs.python.org/2/install/index.html Installing Python Modules] for detailed information.
    190190
    191191Specifically, you might be interested in:
     
    274274 - [TracCgi CGI] //(should not be used, as the performance is far from optimal)//
    275275
    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.
     276Trac 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.
    277277
    278278==== Generating the Trac cgi-bin directory #cgi-bin
     
    297297Without 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.
    298298
    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.
     299Web 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.
    300300
    301301There 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.