Edgewall Software

Changes between Version 8 and Version 9 of TracOnOpenSolaris


Ignore:
Timestamp:
Jan 26, 2015, 9:58:54 PM (5 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • TracOnOpenSolaris

    v8 v9  
    1 = Trac Installation Guide for OpenSolaris =
     1= Installing Trac on !OpenSolaris
    22
    3 Trac is a lightweight project management tool that is implemented as a
    4 web-based application. Trac is written in the Python programming language and
    5 can use SQLite, PostgreSQL or MySQL as database. For HTML rendering, Trac uses
    6 the Genshi templating system.
     3'''Note''': [http://en.wikipedia.org/wiki/OpenSolaris OpenSolaris] has been discontinued post the purchase by [http://www.oracle.com/index.html Oracle] in 2009.
    74
     5Note that you should also read the TracInstall documentation file present in the source distribution.
     6If you're upgrading an already installed environment, please also read TracUpgrade.
    87
    9 Note that you should also read the trac/wiki/default-pages/TracInstall
    10 documentation file present in the source distribution.
    11 If you're upgrading an already installed environment, please also read
    12 trac/wiki/default-pages/TracUpgrade.
     8== Prerequisites
    139
    14 
    15 
    16 
    17 = Bill of Materials =
    18 
    19  * OpenSolaris 134
     10 * !OpenSolaris 134
    2011{{{
    2112tjyang@os132:~$ cat /etc/release
     
    2415                        Use is subject to license terms.
    2516                             Assembled 01 March 2010
    26 tjyang@os132:~$
     17}}}
    2718
    28  }}}
    29 
    30 To install Trac on OpenSolaris, the following software packages must be installed:
     19To install Trac on !OpenSolaris, the following software packages must be installed:
    3120
    3221 * Getting Trac-0.11.7.tar.gz
     
    4029tjyang@os132:~$
    4130 }}}
    42  * setuptools, version >= 0.6, OpenSolaris  snv134 doesn't have setuptool bundled.
     31 * setuptools, version >= 0.6, !OpenSolaris snv134 doesn't have setuptool bundled.
    4332 {{{
    4433 /usr/bin/wget http://peak.telecommunity.com/dist/ez_setup.py
     
    5039tjyang@os132:~$ svn --version --quiet
    51401.6.5
    52 tjyang@os132:~$
     41}}}
    5342
    54  }}}
    55  * and the Subversion SWIG Python
    56    bindings (not PySVN, that's something different).
     43 * and the Subversion SWIG Python bindings (not PySVN, that's something different).
    5744 * One of the following Python bindings, depending on the database used:
    58     * pysqlite version 2.x for SQLite 3.x (is part of the standard library
    59       starting with Python 2.5)
     45    * pysqlite version 2.x for SQLite 3.x, part of the standard library starting with Python 2.5
    6046    * psycopg2 version 2.0.x for the PostgreSQL database
    6147    * MySQLdb, version 1.2.2 for the MySQL database
    62  * A web server capable of executing CGI/FastCGI scripts, or Apache HTTPD with
    63    mod_python or mod_wsgi. (Trac also comes with a standalone server, tracd)
     48 * A web server capable of executing CGI/FastCGI scripts, or Apache HTTPD with mod_python or mod_wsgi. Trac also comes with a standalone server, tracd.
    6449
    65 Any of the above python library can usually be installed using easy_install,
    66 which itself can be installed using the following bootstrap script:
     50Any of the above python libraries can be installed using `easy_install`, which itself can be installed using the following bootstrap script:
    6751
     52{{{
    6853  $ wget http://peak.telecommunity.com/dist/ez_setup.py
     54  $ python ez_setup.py
     55}}}
    6956
    70   $ python ez_setup.py
    71 
    72 After that, you can do for example: easy_install Genshi
    73  {{{
     57After that, you can do for example `easy_install Genshi`:
     58{{{
    7459tjyang@os132:~$ sudo easy_install Genshi
    7560Searching for Genshi
     
    8166Processing dependencies for Genshi
    8267Finished processing dependencies for Genshi
    83 tjyang@os132:~$
    84 
    8568}}}
    8669
    87 If you're using Python 2.3 or 2.4 and need pysqlite, you can download from
    88 http://code.google.com/p/pysqlite/downloads/list the Windows installers or the
    89 tar.gz archive for building from source:
     70If you're using Python 2.3 or 2.4 and need pysqlite, you can download from http://code.google.com/p/pysqlite/downloads/list the Windows installers or the tar.gz archive for building from source:
    9071
     72{{{
    9173  $ tar xvfz <version>.tar.gz
     74  $ cd <version>
     75  $ python setup.py build_static install
     76}}}
    9277
    93   $ cd <version>
     78That way, the latest SQLite version will be downloaded and built into the bindings.
    9479
    95   $ python setup.py build_static install
     80== Installing Trac
    9681
    97 That way, the latest SQLite version will be downloaded and built into the
    98 bindings.
    99 
    100 
    101 = Installing Trac =
    102 ---------------
    10382The command:
    10483
    105   $ python ./setup.py install
     84{{{
     85  $ python ./setup.py install
     86}}}
    10687
    107 will byte-compile the python source code and install it in the
    108 site-packages directory of your python installation. The directories cgi-bin,
    109 templates, htdocs and wiki-default are all copied to ``$prefix/share/trac/``.
     88will byte-compile the python source code and install it in the site-packages directory of your python installation. The directories cgi-bin, templates, htdocs and wiki-default are all copied to `$prefix/share/trac/`.
    11089
    111 The script will also install the trac-admin command-line tool, used to create
    112 and maintain project environments. Trac-admin is the command center of Trac.
     90The script will also install the trac-admin command-line tool, used to create and maintain project environments. Trac-admin is the command center of Trac.
    11391
    11492Note: you'll need root permissions or equivalent for this step.
    11593
    116 To install Trac in a different location, or use other advanced installation
    117 options, run:
     94To install Trac in a different location, or use other advanced installation options, run:
    11895
    119   $ python ./setup.py --help
     96{{{
     97  $ python ./setup.py --help
     98}}}
    12099
     100== Creating a Project Environment
    121101
    122 
    123 
    124 Creating a Project Environment
    125 ------------------------------
    126 A Trac environment is the backend storage format where Trac stores information
    127 like wiki pages, tickets, reports, settings, etc. A Trac environment consists
    128 of the environment configuration file (trac.ini), custom templates, log files,
     102A Trac environment is the backend storage format where Trac stores information like wiki pages, tickets, reports, settings, etc. A Trac environment consists of the environment configuration file (trac.ini), custom templates, log files,
    129103and more.
    130104
    131105A new Trac environment is created with trac-admin:
    132106
    133   $ trac-admin /path/to/projectenv initenv
     107{{{
     108  $ trac-admin /path/to/projectenv initenv
     109}}}
    134110
    135 Note: The user account under which the web server is run needs write permission
    136 to the environment directory and all the files inside.
     111Note: The user account under which the web server is run needs write permission to the environment directory and all the files inside.
    137112
    138 trac-admin will prompt you for the name of the project, where your subversion
    139 repository is located, what database you want to use, etc.
     113trac-admin will prompt you for the name of the project, where your subversion repository is located, what database you want to use, etc.
    140114
     115== Running the Standalone Server
    141116
    142 = Running the Standalone Server =
     117After having created a Trac environment, you can easily try the web interface by running the standalone server tracd:
    143118
    144 After having created a Trac environment, you can easily try the web interface
    145 by running the standalone server tracd:
     119{{{
     120  $ tracd --port 8000 /path/to/projectenv
     121}}}
    146122
    147   $ tracd --port 8000 /path/to/projectenv
     123Then, 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.
    148124
    149 Then, fire up a browser and visit http://localhost:8000/. You should get a
    150 simple listing of all environments that tracd knows about. Follow the link
    151 to the environment you just created, and you should see Trac in action.
     125== Using Trac
    152126
     127Once you have your Trac site up and running, you should be able to browse your subversion repository, create tickets, view the timeline, etc.
    153128
    154 = Using Trac =
    155 
    156 Once you have your Trac site up and running, you should be able to browse your
    157 subversion repository, create tickets, view the timeline, etc.
    158 
    159 Keep in mind that anonymous (not logged in) users can by default access most
    160 but not all of the features. You will need to configure authentication and
    161 grant additional permissions to authenticated users to see the full set of
    162 features.
     129Keep 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 permissions to authenticated users to see the full set of features.
    163130
    164131For further documentation, see the TracGuide wiki page.
    165 
    166 
    167 
    168