1) Download the latest version and unzip to your chosen server directory
Or if you use git, use git clone when installing for the first time:
git clone firstname.lastname@example.org:openenergymonitor/emoncms3.git
and then all you need to call is git pull and it will download and update the latest changes.
2) Copy over your settings.php file
3) Open setup.php in the emoncms root directory
4) Uncomment line 17:
// $runnable = TRUE;
5) Save and run emoncms3/setup.php
6) The script will list the changes if any, It will also tell you if you need to convert any feeds from the old datetime format to the new integer timestamp format. If you do have feeds that need converting make sure you backup your old database before you continue running conv.php incase anything goes wrong.
7) Re-comment line 17 again so that the script is not runnable by anyone.
8) Continue to emoncms
See how the setup script works:
New dashboard implementation: With the new dashboard implementation and the new visual dashboard editor dashboards created in versions of emoncms before mid-july 2012 no longer work with the current version as the dashboard renderer has been reworked to quite an extent.
It is best to rebuild any dashboards using the new visual dashboard editor or the new ckeditor rebuild, there is a guide on how to do this in the using emoncms documentation.
Upgrading feed tables to use integer timestamp
In case you have an old table setup (i.e. pre 13th of April where timedate is used instead of integers for the time field in the feed tables), also run the conv.php script in the emoncms root directory. For this script line 13 needs to be uncommented before running it. See also http://openenergymonitor.blogspot.com/2012/04/speeding-up-emoncms-feed-data-requests.html.