Edgewall Software

Changes between Version 8 and Version 9 of CookBook/easyTrac


Ignore:
Timestamp:
Aug 4, 2015, 8:14:38 PM (4 years ago)
Author:
figaro
Comment:

Cosmetic changes

Legend:

Unmodified
Added
Removed
Modified
  • CookBook/easyTrac

    v8 v9  
    1 = easyTrac installer =
     1[[PageOutline(2-5,Contents,pullout)]]
     2
     3= easyTrac installer
    24
    35The easyTrac installer is a source-installation kit that installs a complete Trac environment and all its dependencies.
     
    79 * Twitter: http://twitter.com/mviera
    810
    9 == Downloading easyTrac ==
     11== Downloading easyTrac
    1012
    1113You can download easyTrac in either [http://github.com/mviera/easyTrac/zipball/master zip] or [http://github.com/mviera/easyTrac/tarball/master tar] formats.
     
    1921
    2022The installer will compile '''Nginx''' and '''uWSGI''' and it will install all required python dependencies also.
    21 But to compile Nginx and uWSGI a few dependencies are required to be installed in the system:
    2223
    23 === Dependencies ===
     24=== Dependencies
     25
     26To compile Nginx and uWSGI a few dependencies need to be installed in the system:
    2427 * python-dev
    2528 * libpcre3-dev
     
    3235 * libaprutil1-dev
    3336
    34 PLEASE 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.
     37'''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.
    3538
    3639The installer configuration works out of the box, but if you want, you can edit buildout.cfg and modify the following parameters:
     
    4750
    4851Once you have installed all required dependencies, continue with the installation process and execute the following command:
    49 {{{
     52{{{#!sh
    5053$ python bootstrap.py
    5154}}}
    5255
    5356You should have the buildout environment ready to be installed:
    54 {{{
     57{{{#!sh
    5558$ ./bin/buildout
    5659}}}
    5760
    58 '''NOTE''': Also, easyTrac compiles Subversion and installs the subversion bindings needed for Trac to manage and browse through svn code repositories.
     61'''Note''': Also, easyTrac compiles Subversion and installs the subversion bindings needed for Trac to manage and browse through svn code repositories.
    5962
    60 == How to start, stop, restart services ==
     63== How to start, stop, restart services
    6164
    6265Supervisor provides a control script to start, stop or restart services. In our supervisor there are two services: nginx and uwsgi.
    6366
    6467The supervisorctl syntax is:
    65 {{{
     68{{{#!sh
    6669$ ./bin/supervisorctl <command> <service-name>
    6770}}}
    68 === start services ===
    69 {{{
     71
     72=== Start services
     73
     74{{{#!sh
    7075$ ./bin/supervisorctl start nginx
    7176}}}
    72 === stop services ===
    73 {{{
     77
     78=== Stop services
     79
     80{{{#!sh
    7481$ ./bin/supervisorctl stop nginx
    7582}}}
    76 === restart services ===
    77 {{{
     83
     84=== Restart services
     85
     86{{{#!sh
    7887$ ./bin/supervisorctl restart nginx
    7988}}}
     89
    8090Also, 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:
    81 {{{
     91{{{#!sh
    8292$ ./bin/supervisorct restart all
    8393}}}
    8494
    85 Supervisor has an admin panel on where we can control our services via web. This admin control panel is accessible at:
     95Supervisor has an admin panel on where we can control our services via web. This admin control panel is accessible at `http://localhost:9000`.
    8696
    87 http://localhost:9000
     97'''Note''': 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.
    8898
    89 NOTE: 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.
     99== How to create a Trac project
    90100
    91 == How to create a Trac project ==
    92 {{{
     101{{{#!sh
    93102$ ./bin/trac-admin opt/trac/demo initenv demo sqlite:db/trac.db
    94103}}}
    95104
    96 == How to create a svn code repository ==
    97 {{{
     105== How to create a svn code repository
     106
     107{{{#!sh
    98108$ ./bin/svnadmin create opt/svn/demo
    99109}}}
    100110
    101 == Uninstall instructions ==
     111== Uninstall instructions
    102112
    103113 1. Stop supervisord by running:
    104 {{{
     114{{{#!sh
    105115$ ./bin/supervisorctl shutdown
    106116}}}
    107117 1. Remove the folder <installdir>/easyTrac.
    108118
    109 == Backup instructions ==
     119== Backup instructions
    110120
    111121easyTrac includes a backup script. So, to make a backup execute the following command:
    112 {{{
     122{{{#!sh
    113123$ ./bin/backup
    114124}}}
     125
    115126and all the Trac projects will be backed up into a tarball to the backups directory, called '''backups'''.
    116127
    117 == Restore instructions ==
     128== Restore instructions
    118129
    119130Also, easyTrac provides a restore script for backups:
    120 {{{
     131{{{#!sh
    121132$ ./bin/restore backups/backup-file.tar.gz
    122133}}}
    123 and all the trac projects will be restored.
     134
     135and all the Trac projects will be restored.