first import
[projectpier.git] / upgrade.txt
blob370a87012ccc96bbc9910ad39c10461550409736
1                         \r
2 ~~~~~~~~~~~~~~~~~~~~~\r
3 Upgrading ProjectPier\r
4 ~~~~~~~~~~~~~~~~~~~~~\r
5 \r
6 General Notice: We are not changing the built-in upgrade checker in ProjectPier for pre-release\r
7 versions of 0.8.  0.8.0-dev and 0.8.0-RC1 and 0.8.0 (the final release) will all be\r
8 considered 0.8 as far as the upgrade checking utility is concerned.  That means that if you\r
9 have installed a pre-release version -dev or -RC1, you will not receive upgrade notification \r
10 within ProjectPier.\r
12 All versions of ProjectPier 0.8 are database compatible with each other and with activeCollab 0.7.1.\r
14 There is not an upgrade script for ProjectPier 0.8.  A set of instructions is provided below, but use\r
15 them at your own risk.  Make sure you have backed up all your data (files and database) so that you\r
16 can return to your previous version if necessary.  \r
18 When upgrading, do NOT run the installation scripts!\r
21 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
22 Instructions are for upgrading from ProjectPier 0.8-dev or activeCollab 0.7.1 to \r
23 ProjectPier 0.8-final.\r
24 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
26 1) Backup your database\r
28 2) Backup your installation files (you will need your existing /config/config.php to complete this \r
29    installation).\r
31 3) Unzip the ProjectPier package to a new directory on your hard drive, then upload to your server, \r
32    overwriting the existing activeCollab or ProjectPier installation files.\r
34 4) Add the following lines to /config/config.php that you backed up in step 2 (NOT the one you just\r
35    unzipped, the one you backed up from your existing installation!!)\r
36    define('SHOW_MESSAGE_BODY', true); \r
37    define('SHOW_COMMENT_BODY', true); \r
38    define('SHOW_MILESTONE_BODY', true); \r
39    define('TOKEN_COOKIE_NAME', '93c65403ce6b695a583e9e4c8c5b25e687283ee8');\r
41    SHOW_MESSAGE_BODY = Set this to true or false, it determines whether to include message text in new \r
42                        message notification emails.\r
44    SHOW_COMMENT_BODY = Set this to true or false, it determines whether to include comment text in new \r
45                        comment notification emails.\r
47    SHOW_MILESTONE_BODY = Set this to true or false, it determines whether to include milestone text in new\r
48                          milestone notification emails.\r
50    TOKEN_COOKIE_NAME = set this to any unique string of characters, the exact length is not important.  This\r
51                        is required, but only used to differentiate between installations when there are\r
52                        multiple installations on the same server.\r
53    Change from: define('PRODUCT_VERSION', '0.7.1');\r
54             to: define('PRODUCT_VERSION', '0.8.0');\r
56 5) Upload /config/config.php that you just edited to your server, overwriting the existing file.\r
58 6) You should be ready to go now.\r
60 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
61 Instructions are for upgrading from ProjectPier 0.8-RC1 ProjectPier 0.8-final.\r
62 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\r
64 1) Backup your database\r
66 2) Backup your installation files.\r
68 3) Unzip the ProjectPier package to a new directory on your hard drive, then upload the following files\r
69    or directories to your server.\r
71    *(mandatory) - bug fix\r
72       /environment/functions/files.php\r
74    *(optional) if you want to make sure you have the latest documentation on your server, \r
75     copy the following files  \r
76       changes.txt\r
77       readme.txt\r
78       upgrade.txt     \r
80    *(optional) if you want to add Continental Portuguese language files, copy the following\r
81       /language/pt_pt.php\r
82       /language/pt_pt/ (directory) \r
84 4) You should be ready to go now.\r