Table of Contents

Upgrade Instructions

This page contains instructions for upgrading from the last known release for Timesheet.php, 1.2.1, which Timesheet Next Gen has been based on.

If you have been following the updates within the SVN Repository then you will have to manually update your installation. There are a number of SQL scripts in the /dev directory that give a guide on the database changes, or the upgrade_to-XXX.sql.in files used during the upgrade.

The release at the time of writing is 1.3.1

Upgrade from 1.2.1

Step 1: Backup

The very first step (whenever updating anything) is that you should backup your database. In the case MySQL, the easiest way is with the mysqldump command

Also, it is recommended that you back up the file structure as well

Step 2: Replace File Structure

Download and extract the latest release of Timesheet Next Gen. Once extracted, copy the extracted files over the top of your existing file structure.

Step 3: Run the Install Script

The easiest way to upgrade your system is to navigate to your browser to the starting page of your installation, e.g: http://your-host/timesheet

Once there, you will be asked if you want to Upgrade Your System.

Make sure that the files database_credentials.inc and table_names.inc are both writeable by the webserver. Once they are you can proceed to the next step in the upgrade script.

Database Configuration

The upgrade script will ask you to confirm your database details. These details are extracted from your existing configuration files, but please check to mnake sure that they are all correct. Once all the details are correct, proceed to the next step in the upgrade script

Final Bits: Remove Unneeded File

The final stage of the upgrade script is to remove the install directory and all of its contents. Also, it is wise to make sure that the configurations files database_credentials.inc and table_names.inc are no longer writeable by the webserver.

That's It!

Your copy of Timesheet Next Gen should be fully updated to the latest version. Enjoy

Final Thoughts

If you have any questions about installing or upgrading Timesheet Next Gen, please ask a question on our forums.

If you find a bug in the install or upgrade scripts, please report it in the bug tracker