Edgewall Software

Changes between Version 7 and Version 8 of CookBook/easyTrac


Ignore:
Timestamp:
Jan 9, 2015, 10:44:46 PM (9 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified

  • CookBook/easyTrac

    v7 v8  
    11= easyTrac installer =
    22
    3 The easyTrac installer is a source-installation kit that installs a complete Trac environment and all its dependecies.
     3The easyTrac installer is a source-installation kit that installs a complete Trac environment and all its dependencies.
    44
    5 Feedback/bugs to:
     5Send feedback or bugs to:
    66 * Email: manuel.viera.tirado at gmail.com
    77 * Twitter: http://twitter.com/mviera
    … …  
    1111You can download easyTrac in either [http://github.com/mviera/easyTrac/zipball/master zip] or [http://github.com/mviera/easyTrac/tarball/master tar] formats.
    1212
    13 You can also clone the project with Git from my [https://github.com/mviera Github] by running:
     13You can also clone the project with Git from [https://github.com/mviera Github] by running:
    1414{{{
    1515$ git clone git://github.com/mviera/easyTrac
    … …  
    1919
    2020The installer will compile '''Nginx''' and '''uWSGI''' and it will install all required python dependencies also.
    21 But for compile Nginx and uWSGI a few dependencies are required to be installed in the system. This dependencies
    22 are the following:
     21But to compile Nginx and uWSGI a few dependencies are required to be installed in the system:
    2322
    2423=== Dependencies ===
    … …  
    3534PLEASE NOTE: You can run the easyTrac installation as root or as a normal user. Personally, I prefer to run the installation as a normal user.
    3635
    37 The installer config works out of the box, but if you want, you can edit buildout.cfg and
    38 modify the following parameters:
     36The installer configuration works out of the box, but if you want, you can edit buildout.cfg and modify the following parameters:
    3937
    4038 * '''nginx-http-port''': http port that will be used for Nginx.
    41  * '''nginx-https-port''': https port that will be used for Nginx (in case you want to use https).
     39 * '''nginx-https-port''': https port that will be used for Nginx, in case you want to use https.
    4240 * '''supervisor-http-port''': http port that will be used for supervisor.
    4341 * '''host''': host ip address of fqdn.
    … …  
    4846 * '''svn-repository-directory''': directory where the svn repositories will be created. This directory is {{{<installdir>/opt/svn/}}}, by default.
    4947
    50 Once you have installed all required dependencies, you can continue with the installation process.
    51 So you execute the following command:
     48Once you have installed all required dependencies, continue with the installation process and execute the following command:
    5249{{{
    5350$ python bootstrap.py
    5451}}}
    5552
    56 You should have the buildout environment ready to go. Now, you must execute the buildout installation:
     53You should have the buildout environment ready to be installed:
    5754{{{
    5855$ ./bin/buildout
    … …  
    6360== How to start, stop, restart services ==
    6461
    65 Supervisor provides a control script to start, stop or restart our
    66 services. In our supervisor we only get two services: nginx and uwsgi.
     62Supervisor provides a control script to start, stop or restart services. In our supervisor there are two services: nginx and uwsgi.
    6763
    6864The supervisorctl syntax is:
    … …  
    8278$ ./bin/supervisorctl restart nginx
    8379}}}
    84 Also, supervisor provides an especial word 'all', so we don't need to specify
    85 every service name. For example, if we need to restart all services:
     80Also, supervisor provides a special word 'all', so we don't need to specify every service name. For example, if we need to restart all services:
    8681{{{
    8782$ ./bin/supervisorct restart all
    8883}}}
    8984
    90 Supervisor has an admin panel on where we can control our services via web. This admin control
    91 panel is accesible at:
     85Supervisor has an admin panel on where we can control our services via web. This admin control panel is accessible at:
    9286
    9387http://localhost:9000
    9488
    95 NOTE: by default, the username is 'admin' and the password is 'admin.' To change the admin password,
    96 edit the [supervisor] part in buildout.cfg and run bin/buildout.
     89NOTE: by default, the username is 'admin' and the password is 'admin'. To change the admin password, edit the [supervisor] part in buildout.cfg and run bin/buildout.
    9790
    9891== How to create a Trac project ==
    … …  
    112105$ ./bin/supervisorctl shutdown
    113106}}}
    114  1. Remove the folder <installdir>/easyTrac
     107 1. Remove the folder <installdir>/easyTrac.
    115108
    116109== Backup instructions ==
    117110
    118 easyTrac includes a backup script. So, if you want to make a backup you only must to
    119 execute the following command:
     111easyTrac includes a backup script. So, to make a backup execute the following command:
    120112{{{
    121113$ ./bin/backup
    122114}}}
    123 and all the trac projects will be backed up into a tarball to the backups directory, called '''backups'''.
     115and all the Trac projects will be backed up into a tarball to the backups directory, called '''backups'''.
    124116
    125117== Restore instructions ==
    126118
    127 Also, easyTrac provides a restore script, useful to restore old backups. Its usage is as simple as follow:
     119Also, easyTrac provides a restore script for backups:
    128120{{{
    129121$ ./bin/restore backups/backup-file.tar.gz