Changes between Version 8 and Version 9 of TracOnOpenSolaris
- Timestamp:
- Jan 26, 2015, 9:58:54 PM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
TracOnOpenSolaris
v8 v9 1 = Trac Installation Guide for OpenSolaris =1 = Installing Trac on !OpenSolaris 2 2 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. 7 4 5 Note that you should also read the TracInstall documentation file present in the source distribution. 6 If you're upgrading an already installed environment, please also read TracUpgrade. 8 7 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 13 9 14 15 16 17 = Bill of Materials = 18 19 * OpenSolaris 134 10 * !OpenSolaris 134 20 11 {{{ 21 12 tjyang@os132:~$ cat /etc/release … … 24 15 Use is subject to license terms. 25 16 Assembled 01 March 2010 26 tjyang@os132:~$ 17 }}} 27 18 28 }}} 29 30 To install Trac on OpenSolaris, the following software packages must be installed: 19 To install Trac on !OpenSolaris, the following software packages must be installed: 31 20 32 21 * Getting Trac-0.11.7.tar.gz … … 40 29 tjyang@os132:~$ 41 30 }}} 42 * setuptools, version >= 0.6, OpenSolaris snv134doesn't have setuptool bundled.31 * setuptools, version >= 0.6, !OpenSolaris snv134 doesn't have setuptool bundled. 43 32 {{{ 44 33 /usr/bin/wget http://peak.telecommunity.com/dist/ez_setup.py … … 50 39 tjyang@os132:~$ svn --version --quiet 51 40 1.6.5 52 tjyang@os132:~$ 41 }}} 53 42 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). 57 44 * 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 60 46 * psycopg2 version 2.0.x for the PostgreSQL database 61 47 * 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. 64 49 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: 50 Any of the above python libraries can be installed using `easy_install`, which itself can be installed using the following bootstrap script: 67 51 52 {{{ 68 53 $ wget http://peak.telecommunity.com/dist/ez_setup.py 54 $ python ez_setup.py 55 }}} 69 56 70 $ python ez_setup.py 71 72 After that, you can do for example: easy_install Genshi 73 {{{ 57 After that, you can do for example `easy_install Genshi`: 58 {{{ 74 59 tjyang@os132:~$ sudo easy_install Genshi 75 60 Searching for Genshi … … 81 66 Processing dependencies for Genshi 82 67 Finished processing dependencies for Genshi 83 tjyang@os132:~$84 85 68 }}} 86 69 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: 70 If 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: 90 71 72 {{{ 91 73 $ tar xvfz <version>.tar.gz 74 $ cd <version> 75 $ python setup.py build_static install 76 }}} 92 77 93 $ cd <version> 78 That way, the latest SQLite version will be downloaded and built into the bindings. 94 79 95 $ python setup.py build_static install 80 == Installing Trac 96 81 97 That way, the latest SQLite version will be downloaded and built into the98 bindings.99 100 101 = Installing Trac =102 ---------------103 82 The command: 104 83 105 $ python ./setup.py install 84 {{{ 85 $ python ./setup.py install 86 }}} 106 87 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/``. 88 will 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/`. 110 89 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. 90 The 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. 113 91 114 92 Note: you'll need root permissions or equivalent for this step. 115 93 116 To install Trac in a different location, or use other advanced installation 117 options, run: 94 To install Trac in a different location, or use other advanced installation options, run: 118 95 119 $ python ./setup.py --help 96 {{{ 97 $ python ./setup.py --help 98 }}} 120 99 100 == Creating a Project Environment 121 101 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, 102 A 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, 129 103 and more. 130 104 131 105 A new Trac environment is created with trac-admin: 132 106 133 $ trac-admin /path/to/projectenv initenv 107 {{{ 108 $ trac-admin /path/to/projectenv initenv 109 }}} 134 110 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. 111 Note: The user account under which the web server is run needs write permission to the environment directory and all the files inside. 137 112 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. 113 trac-admin will prompt you for the name of the project, where your subversion repository is located, what database you want to use, etc. 140 114 115 == Running the Standalone Server 141 116 142 = Running the Standalone Server = 117 After having created a Trac environment, you can easily try the web interface by running the standalone server tracd: 143 118 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 }}} 146 122 147 $ tracd --port 8000 /path/to/projectenv 123 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. 148 124 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 152 126 127 Once you have your Trac site up and running, you should be able to browse your subversion repository, create tickets, view the timeline, etc. 153 128 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. 129 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 permissions to authenticated users to see the full set of features. 163 130 164 131 For further documentation, see the TracGuide wiki page. 165 166 167 168