Mercurial > p > roundup > code
comparison doc/installation.txt @ 3153:fdcba2ef2673
missed in checkin
| author | Richard Jones <richard@users.sourceforge.net> |
|---|---|
| date | Mon, 14 Feb 2005 00:11:36 +0000 |
| parents | 69aebefddb2b |
| children | d5fa5a0b5216 ae7ddb3eb091 |
comparison
equal
deleted
inserted
replaced
| 3151:6feac4fcf883 | 3153:fdcba2ef2673 |
|---|---|
| 30 | 30 |
| 31 | 31 |
| 32 Prerequisites | 32 Prerequisites |
| 33 ============= | 33 ============= |
| 34 | 34 |
| 35 Roundup requires Python 2.1.3 or newer with a functioning anydbm | 35 Roundup requires Python 2.3 or newer with a functioning anydbm |
| 36 module. Download the latest version from http://www.python.org/. | 36 module. Download the latest version from http://www.python.org/. |
| 37 It is highly recommended that users install the latest patch version | 37 It is highly recommended that users install the latest patch version |
| 38 of python as these contain many fixes to serious bugs. | 38 of python as these contain many fixes to serious bugs. |
| 39 | 39 |
| 40 If you're on windows, you will either need to be using the ActiveState python | 40 If you're on windows, you will either need to be using the ActiveState python |
| 41 distribution (at http://www.activestate.com/Products/ActivePython/), or you'll | 41 distribution (at http://www.activestate.com/Products/ActivePython/), or you'll |
| 42 have to install the win32all package separately (get it from | 42 have to install the win32all package separately (get it from |
| 43 http://starship.python.net/crew/mhammond/win32/). | 43 http://starship.python.net/crew/mhammond/win32/). |
| 44 | |
| 45 If you're using a version of Python older than 2.3, you may need | |
| 46 to `install the "CSV" module`_. | |
| 47 | |
| 48 Install the "CSV" module | |
| 49 ------------------------ | |
| 50 | |
| 51 .. hint:: | |
| 52 CSV stands for Comma-Separated-Value. These files are used by all | |
| 53 manner of programs (eg. spreadsheets) to exchange data. | |
| 54 | |
| 55 The "CSV" module is required if you wish to import or export data in the | |
| 56 tracker, or if you wish to use the online generic class editing facility. | |
| 57 | |
| 58 If you're using a version of Python older than 2.3, then you will need to | |
| 59 install the "CSV" module from `Object Craft`_. Users of Python2.3 and later | |
| 60 don't need to. If you have a C compiler installed, then download the source | |
| 61 and follow their installation instructions (simply ``python setup.py | |
| 62 install``.) | |
| 63 | |
| 64 If you're on Windows and don't have a C compiler, then you'll need to | |
| 65 download the pre-compiled ``csv.pyd`` file and install it. To install, just | |
| 66 copy it to your Python installation in the ``lib\site-packages`` directory. | |
| 67 For Python 2.2, this would be:: | |
| 68 | |
| 69 c:\python22\lib\site-packages | |
| 70 | |
| 71 Once the CSV module is installed, you *must* restart roundup-server if it | |
| 72 is already running, or the new module won't be detected. | |
| 73 | |
| 74 If you're on some other platform and don't have a C compiler, you'll need | |
| 75 to ask for help on the roundup-users mailing list. | |
| 76 | |
| 77 .. _`Object Craft`: http://object-craft.com.au/ | |
| 78 | 44 |
| 79 | 45 |
| 80 Getting Roundup | 46 Getting Roundup |
| 81 =============== | 47 =============== |
| 82 | 48 |
| 93 | 59 |
| 94 | 60 |
| 95 For The Really Impatient | 61 For The Really Impatient |
| 96 ======================== | 62 ======================== |
| 97 | 63 |
| 98 .. note:: | |
| 99 The ``demo.py`` script is packaged in Roundup's source distribution - | |
| 100 users of the Windows installer may use the ``roundup-demo`` program. | |
| 101 Users of other binary distributions or pre-installed Roundup will need | |
| 102 to download the source to use it. | |
| 103 | |
| 104 If you just want to give Roundup a whirl Right Now, then simply run | 64 If you just want to give Roundup a whirl Right Now, then simply run |
| 105 ``python demo.py``. This will set up a simple demo tracker on your | 65 ``python demo.py``. If you used the Windows installer, you should run the |
| 106 machine. When it's done, it'll print out a URL to point your web browser | 66 ``roundup-demo`` program instead. Users of other binary distributions or |
| 107 at so you may start playing. Three users will be set up: | 67 pre-installed Roundup will need to download the source to use it. |
| 68 | |
| 69 This will set up a simple demo tracker on your machine. When it's done, | |
| 70 it'll print out a URL to point your web browser at so you may start | |
| 71 playing. Three users will be set up: | |
| 108 | 72 |
| 109 1. anonymous - the "default" user with permission to do very little | 73 1. anonymous - the "default" user with permission to do very little |
| 110 2. demo (password "demo") - a normal user who may create issues | 74 2. demo (password "demo") - a normal user who may create issues |
| 111 3. admin (password "admin") - an administrative user who has complete | 75 3. admin (password "admin") - an administrative user who has complete |
| 112 access to the tracker | 76 access to the tracker |
| 734 Linux | 698 Linux |
| 735 ----- | 699 ----- |
| 736 | 700 |
| 737 Make sure you read the instructions under `UNIX environment steps`_. | 701 Make sure you read the instructions under `UNIX environment steps`_. |
| 738 | 702 |
| 739 Python 2.1.1 as shipped with SuSE7.3 might be missing module | |
| 740 ``_weakref``. | |
| 741 | |
| 742 | 703 |
| 743 Solaris | 704 Solaris |
| 744 ------- | 705 ------- |
| 745 | 706 |
| 746 You'll need to build Python. | 707 You'll need to build Python. |