= System Requirements =

Please ensure that your version of MySQL is greater than 4.1 and that your version of PHP is greater than 4.4.4 before upgrading.

= How to Upgrade =

This document is for users who are upgrading from a previous version of the LTK. If this is your first time installing you don't need this document. If you are trying to upgrade from ePEARL version 2.0, read the file "ReadMe-How to upgrade from ePEARL version 2"

== No Data will be Lost ==

When you update ePEARL or the LTK student portfolios *will not* be lost or changed. All data that was present before the update will be present after the update.

== Step by Step ==

1. Download the latest version of the LTK from here:

 http://grover.concordia.ca/eportfolio/ltk_versions/

 *NOTE: LTK upgrades happen regularly. Only download the 
 latest version right before you update. If you've downloaded 
 it earlier, please make sure it is still the most recent.

2. Backup your current LTK installation. 
   
 - Make a new folder 'ltk_backup' somewhere (not inside the 'ltk' folder!).
 - If you already have a backup folder, empty everything inside it (it should be completely empty).
 - Open the 'ltk' folder, select all files and folders and *move* them to 'ltk_backup'.
 - The ltk folder should now be empty.

3. Unzip the latest version and *replace* the 'ltk' folder.
   
 - Make sure all the files and folders are under "ltk/" 
   and not under "ltk/ltk/".

<span style="color:green">
UPDATED
4. Copy the following file from 'ltk_backup' into 'ltk'. 

 - ltk/config.php
 NOTE: Make sure you put it in the right folder!
 NOTE: Do not copy any other files!
 NOTE: Yes, you want to overwrite the old file that has the same names.
 NOTE: You no longer need to copy portal_config.php or your schoolboard logo (see "ATTENTION" below)
</span>

5. Open the LTK in a browser.  

Open a browser and navigate to the ltk. It will probably be at 'http://mysever.com/ltk/'.

If database changes are needed, you will be taken to LTK Setup. At the bottom of the page you will see a purple box with an "Upgrade Now" button. Click the button to upgrade. After upgrade is complete, click "Welcome to the LTK" to return to the login screen. You should log in as the admin user to confirm that everything still works as expected. You're done!

If no database changes are included in the upgrade then you will be taken to the login screen. You should log in as the admin user to confirm that everything still works as expected. That's it!

<span style="color:green">
UPDATED
== ATTENTION: First Upgrade Since February 2010? ==

If this is your first upgrade since February 15th of 2010, you have might have two more steps to do. Please log in as the admin user and then follow the steps below.

1. If you had installed a custom schoolboard logo: 
From the Main Menu of the Admin evironment, choose the LTK Settings section and then click the "Your Logo" tab. Upload your schoolboard logo into this section.

2. If some of your users are logging in from a portal:
From the Main Menu of the Admin evironment, choose the LTK Settings section, and then click the "Portal Login" tab. Activiate portal login links and customize the settings. Once complete, copy the link shown under "Here is your code" and update the link used to connect from your portal.
</span>

== ATTENTION: First Upgrade Since August 2009? ==

If this is the first time you are upgrading since August or  
January of this year, you will also have to recopy your connection information
from your old config file into the new one.

1. Open the files ltk/config.php and ltk/xtras/config.default.php
2. Copy the contents of config.default.php and overwrite the contents of config.php.
3. Open config.php from your backup installation ltk_backup/config.php 
4. Manually copy the mysql login inforamation from ltk_backup/config.php to ltk/config.php
5. Close ltk_backup/config.ph and save ltk/config.php.
6. Log in as the admin user to confirm that everything is working.

== Troubleshooting ==

If you have any questions, email 'epearlhelp@education.concordia.ca'.