Mercurial > p > roundup > code
comparison doc/installation.txt @ 2742:8ac87d4092e2
more install doc tweaks
| author | Richard Jones <richard@users.sourceforge.net> |
|---|---|
| date | Fri, 08 Oct 2004 07:22:04 +0000 |
| parents | d2b5ebf53d08 |
| children | 2317e43609cb |
comparison
equal
deleted
inserted
replaced
| 2741:d2b5ebf53d08 | 2742:8ac87d4092e2 |
|---|---|
| 80 | 80 |
| 81 | 81 |
| 82 Getting Roundup | 82 Getting Roundup |
| 83 =============== | 83 =============== |
| 84 | 84 |
| 85 Download the latest version from http://roundup.sf.net/. | |
| 86 | |
| 87 If you're using WinZIP's "classic" interface, make sure the "Use | |
| 88 folder names" check box is checked before you extract the files. | |
| 89 | |
| 90 Testing your Python | |
| 91 ------------------- | |
| 92 | |
| 93 .. note:: | |
| 94 The Windows installer doesn't include the ``run_tests.py`` or ``demo.py`` | |
| 95 scripts - you will need to download the source to use them. | |
| 96 | |
| 97 Once you've unpacked roundup's source, run ``python run_tests.py`` in the | |
| 98 source directory and make sure there are no errors. If there are errors, | |
| 99 please let us know! | |
| 100 | |
| 101 If the above fails, you may be using the wrong version of python. Try | |
| 102 ``python2 run_tests.py``. If that works, you will need to substitute | |
| 103 ``python2`` for ``python`` in all further commands you use in relation to | |
| 104 Roundup -- from installation and scripts. | |
| 105 | |
| 106 | |
| 107 For The Really Impatient | |
| 108 ======================== | |
| 109 | |
| 110 .. note:: | |
| 111 The Windows installer doesn't include the ``demo.py`` script - you | |
| 112 will need to download the source to use it. | |
| 113 | |
| 114 If you just want to give Roundup a whirl Right Now, then simply run | |
| 115 ``python demo.py``. This will set up a simple demo tracker on your | |
| 116 machine. When it's done, it'll print out a URL to point your web browser | |
| 117 at so you may start playing. Three users will be set up: | |
| 118 | |
| 119 1. anonymous - the "default" user with permission to do very little | |
| 120 2. demo (password "demo") - a normal user who may create issues | |
| 121 3. admin (password "admin") - an administrative user who has complete | |
| 122 access to the tracker | |
| 123 | |
| 124 | |
| 125 Installation | |
| 126 ============ | |
| 127 | |
| 128 .. note:: | 85 .. note:: |
| 129 Some systems, such as Debian and NetBSD, already have Roundup | 86 Some systems, such as Debian and NetBSD, already have Roundup |
| 130 installed. Try running the command "roundup-admin" with no arguments, | 87 installed. Try running the command "roundup-admin" with no arguments, |
| 131 and if it runs you may skip the `Basic Installation Steps`_ | 88 and if it runs you may skip the `Basic Installation Steps`_ |
| 132 below and go straight to `configuring your first tracker`_. | 89 below and go straight to `configuring your first tracker`_. |
| 90 | |
| 91 Download the latest version from http://roundup.sf.net/. | |
| 92 | |
| 93 If you're using WinZIP's "classic" interface, make sure the "Use | |
| 94 folder names" check box is checked before you extract the files. | |
| 95 | |
| 96 Testing your Python | |
| 97 ------------------- | |
| 98 | |
| 99 .. note:: | |
| 100 The ``run_tests.py`` script is packaged in Roundup's source distribution | |
| 101 - users of the Windows installer, other binary distributions or | |
| 102 pre-installed Roundup will need to download the source to use it. | |
| 103 | |
| 104 Once you've unpacked roundup's source, run ``python run_tests.py`` in the | |
| 105 source directory and make sure there are no errors. If there are errors, | |
| 106 please let us know! | |
| 107 | |
| 108 If the above fails, you may be using the wrong version of python. Try | |
| 109 ``python2 run_tests.py``. If that works, you will need to substitute | |
| 110 ``python2`` for ``python`` in all further commands you use in relation to | |
| 111 Roundup -- from installation and scripts. | |
| 112 | |
| 113 | |
| 114 For The Really Impatient | |
| 115 ======================== | |
| 116 | |
| 117 .. note:: | |
| 118 The ``demo.py`` script is packaged in Roundup's source distribution - | |
| 119 users of the Windows installer, other binary distributions or | |
| 120 pre-installed Roundup will need to download the source to use it. | |
| 121 | |
| 122 If you just want to give Roundup a whirl Right Now, then simply run | |
| 123 ``python demo.py``. This will set up a simple demo tracker on your | |
| 124 machine. When it's done, it'll print out a URL to point your web browser | |
| 125 at so you may start playing. Three users will be set up: | |
| 126 | |
| 127 1. anonymous - the "default" user with permission to do very little | |
| 128 2. demo (password "demo") - a normal user who may create issues | |
| 129 3. admin (password "admin") - an administrative user who has complete | |
| 130 access to the tracker | |
| 131 | |
| 132 | |
| 133 Installation | |
| 134 ============ | |
| 133 | 135 |
| 134 Set aside 15-30 minutes. Please make sure you're using a supported version of | 136 Set aside 15-30 minutes. Please make sure you're using a supported version of |
| 135 Python -- see `testing your python`_. There's several steps to follow in your | 137 Python -- see `testing your python`_. There's several steps to follow in your |
| 136 installation: | 138 installation: |
| 137 | 139 |