Changes between Version 8 and Version 9 of CookBook/easyTrac
- Timestamp:
- Aug 4, 2015, 8:14:38 PM (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
CookBook/easyTrac
v8 v9 1 = easyTrac installer = 1 [[PageOutline(2-5,Contents,pullout)]] 2 3 = easyTrac installer 2 4 3 5 The easyTrac installer is a source-installation kit that installs a complete Trac environment and all its dependencies. … … 7 9 * Twitter: http://twitter.com/mviera 8 10 9 == Downloading easyTrac ==11 == Downloading easyTrac 10 12 11 13 You can download easyTrac in either [http://github.com/mviera/easyTrac/zipball/master zip] or [http://github.com/mviera/easyTrac/tarball/master tar] formats. … … 19 21 20 22 The 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:22 23 23 === Dependencies === 24 === Dependencies 25 26 To compile Nginx and uWSGI a few dependencies need to be installed in the system: 24 27 * python-dev 25 28 * libpcre3-dev … … 32 35 * libaprutil1-dev 33 36 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. 35 38 36 39 The installer configuration works out of the box, but if you want, you can edit buildout.cfg and modify the following parameters: … … 47 50 48 51 Once you have installed all required dependencies, continue with the installation process and execute the following command: 49 {{{ 52 {{{#!sh 50 53 $ python bootstrap.py 51 54 }}} 52 55 53 56 You should have the buildout environment ready to be installed: 54 {{{ 57 {{{#!sh 55 58 $ ./bin/buildout 56 59 }}} 57 60 58 '''N OTE''': 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. 59 62 60 == How to start, stop, restart services ==63 == How to start, stop, restart services 61 64 62 65 Supervisor provides a control script to start, stop or restart services. In our supervisor there are two services: nginx and uwsgi. 63 66 64 67 The supervisorctl syntax is: 65 {{{ 68 {{{#!sh 66 69 $ ./bin/supervisorctl <command> <service-name> 67 70 }}} 68 === start services === 69 {{{ 71 72 === Start services 73 74 {{{#!sh 70 75 $ ./bin/supervisorctl start nginx 71 76 }}} 72 === stop services === 73 {{{ 77 78 === Stop services 79 80 {{{#!sh 74 81 $ ./bin/supervisorctl stop nginx 75 82 }}} 76 === restart services === 77 {{{ 83 84 === Restart services 85 86 {{{#!sh 78 87 $ ./bin/supervisorctl restart nginx 79 88 }}} 89 80 90 Also, 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 82 92 $ ./bin/supervisorct restart all 83 93 }}} 84 94 85 Supervisor has an admin panel on where we can control our services via web. This admin control panel is accessible at :95 Supervisor has an admin panel on where we can control our services via web. This admin control panel is accessible at `http://localhost:9000`. 86 96 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. 88 98 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 90 100 91 == How to create a Trac project == 92 {{{ 101 {{{#!sh 93 102 $ ./bin/trac-admin opt/trac/demo initenv demo sqlite:db/trac.db 94 103 }}} 95 104 96 == How to create a svn code repository == 97 {{{ 105 == How to create a svn code repository 106 107 {{{#!sh 98 108 $ ./bin/svnadmin create opt/svn/demo 99 109 }}} 100 110 101 == Uninstall instructions ==111 == Uninstall instructions 102 112 103 113 1. Stop supervisord by running: 104 {{{ 114 {{{#!sh 105 115 $ ./bin/supervisorctl shutdown 106 116 }}} 107 117 1. Remove the folder <installdir>/easyTrac. 108 118 109 == Backup instructions ==119 == Backup instructions 110 120 111 121 easyTrac includes a backup script. So, to make a backup execute the following command: 112 {{{ 122 {{{#!sh 113 123 $ ./bin/backup 114 124 }}} 125 115 126 and all the Trac projects will be backed up into a tarball to the backups directory, called '''backups'''. 116 127 117 == Restore instructions ==128 == Restore instructions 118 129 119 130 Also, easyTrac provides a restore script for backups: 120 {{{ 131 {{{#!sh 121 132 $ ./bin/restore backups/backup-file.tar.gz 122 133 }}} 123 and all the trac projects will be restored. 134 135 and all the Trac projects will be restored.