Upgrading from Previous Versions

From Online Grades Documentation

Jump to: navigation, search



Contents

[edit] Upgrading from Previous Versions

This document assumes that you have a basic understanding of MySQL, and Windows or Linux. We also assume that you know both where your current version is installed and how to get your files from one place to another. If you would like to hire someone to upgrade your Online Grades installation, this can be arranged. Please contact bhuber@onlinegrades.org for more details.


Disclaimer: While we take every effort to ensure the accuracy of this document, we cannot be held responsible for any damage or data loss that may occur due to inaccuracies in the documentation or user skill. Be sure to follow any steps in bold so that you have a good backup to use in the unlikely event that your upgrade does not go smoothly.


If performed correctly the upgrade should take less than one hour. If you do run into trouble please see the section titled "If You Need Help". Determine what version of Online Grades you are currently running and then follow all the upgrade steps to get you from your version to the current version.

[edit] FROM 3.2.1 to 3.2.2 (or 3.2.1/3.2.2 to 3.2.4)

  1. Back up your database.
  2. Make sure you are running MySQL version 4.1.x or higher. We have begun using subqueries, which are only supported on MySQL version 4.1.x and higher as of Online Grades 3.2.1.
  3. Back up your installation.
  4. Remove all of the old files.
  5. Unpack the new version on your local computer or at the current installation site.
    1. Edit the new include/config.php file and fill the correct information for your Online Grades setup. If you are unsure of any of the values, refer to the config file from your backup (which you saved in Step 3).
  6. If you have created your own skin, follow the next few steps. If not, go to Step 9.
    1. I would suggest that you get a different program, like WinMerge ([1]), and then you can compare the differences of your files and the one of the skins. While this isn’t a perfect process, it should help you find out what has changed since the last version.
    2. Now that you know what has changed, you should be able to update or recreate your skin.
    3. If you need additional help with this step, please visit the Help & Support Forum on the project website ([2])
    4. For more information on skins, please see the "Server Setup" document.
  7. That’s it. You’re finished!

[edit] FROM 3.2.0 to 3.2.1

  1. Back up your database.
  2. Make sure you are running MySQL version 4.1.x or higher. We have begun using subqueries, which are only supported on MySQL version 4.1.x and higher.
  3. Back up your installation.
  4. Remove all of the old files.
  5. Unpack the new version on your local computer or at the current installation site.
  6. You need to update your database for the new features in this version of Online Grades. If you don’t upgrade the database your Online Grades install is not going to work. You can update your database using the MySQL command line or using a tool such as phpMyAdmin (fill in the correct data for your Online Grades install).
    1. Command Line -- mysql –p –u root ogdb < docs/update_3.2.1.sql
    2. phpMyAdmin – Select OG DB -> SQL -> Browse -> docs/update_3.2.1.sql
    3. Edit the new include/config.php file and fill the correct information for your Online Grades setup. If you are unsure of any of the values, refer to the config file from your backup (which you saved in Step 3).
  7. If you have created your own skin, follow the next few steps. If not, go to Step 9.
    1. I would suggest that you get a different program, like WinMerge ([3]), and then you can compare the differences of your files and the one of the skins. While this isn’t a perfect process, it should help you find out what has changed since the last version.
    2. Now that you know what has changed, you should be able to update or recreate your skin.
    3. If you need additional help with this step, please visit the Help & Support Forum on the project website ([4])
    4. For more information on skins, please see the "Server Setup" document.
  8. That’s it. You’re finished!

[edit] FROM 3.1.2 to 3.2.0

  1. Back up your database.
  2. Back up your installation.
  3. Remove all of the old files.
  4. Unpack the new version on your local computer or at the current installation site.
  5. You need to update your database for the new features in this version of Online Grades. If you don’t upgrade the database your Online Grades install is not going to work. You can update your database using the MySQL command line or using a tool such as phpMyAdmin (fill in the correct data for your Online Grades install).
    1. Command Line -- mysql –p –u root ogdb < docs/update_3.2.0.sql
    2. phpMyAdmin – Select OG DB -> SQL -> Browse -> docs/update_3.2.0.sql
  6. Edit the new include/config.php file and fill the correct information for your Online Grades setup. If you are unsure of any of the values, refer to the config file from your backup (which you saved in Step 2). In 3.2.0 many of the settings have moved to the database; you will fill in them later.
  7. If you have created your own skin, follow the next few steps. If not, go to Step 8.
    1. I would suggest that you get a different program, like WinMerge ([5]), and then you can compare the differences of your files and the one of the skins. While this isn’t a perfect process, it should help you find out what has changed since the last version.
    2. Now that you know what has changed, you should be able to update or recreate your skin.
    3. If you need additional help with this step, please visit the Help & Support Forum on the project website ([6]).
    4. For more information on skins, please see the "Server Setup" document.
  8. Log into the admin interface and fill in the blanks in the new Configuration section. Many of the values that were previously stored in the config.php file are now stored on this configuration screen in the admin interface.
  9. Let your users know about the changes in this version (parent center, per-class teacher memos, etc).
  10. That’s it. You’re finished!

[edit] FROM 3.1.1 to 3.1.2

  1. Back up your database.
  2. Back up your installation.
  3. Now you need to update your database to be able to support password resets. Even if you aren’t going to use password resets, you need to do this!
    1. You can update your database using the MySQL command line or using a tool such as phpMyAdmin.
    2. Command Line -- mysql –p –u root ogdb < docs/update_3.1.2.sql
    3. phpMyAdmin – Select OG DB -> SQL -> Browse -> docs/update_3.1.2.sqll
    4. Please remember to use the appropriate values in the above commands.
  4. Remove all of the old files.
  5. Unpack the new version on your local computer or in the current installation site.
  6. Change the values in config.php. If you are unsure of any of these values, refer to the one you saved in Step 2, when you backed up your installation. You should be able to figure out most of the configuration file yourself, as it’s well annotated.
  7. If you have created your own skin, follow the next few steps. If not, go to Step 8.
    1. I would suggest that you get a different program, like WinMerge ([7]), and then you can compare the differences of your files and the one of the skins. While this isn’t a perfect process, it should help you find out what has changed since the last version.
    2. Now that you know what has changed, you should be able to update or recreate your skin.
    3. If you need additional help with this step, please visit the Help & Support Forum on the project website ([8]).
    4. For more information on skins, please see the "Server Setup" document.
  8. In this version, we have added the ability to edit email that is sent out from the admin interface. For more information, please see the “Server Setup” document.
  9. In this version, we have included some default Teacher Footnotes for the “Comments” table. To finish the setup on the Teacher Footnotes, please read the "Server Setup" document.
  10. You will need to login to the admin interface and update all of the staff logins and email addresses.
    1. Note: In this version, logins and email addresses can be different, so even if you choose to have the email/username the same, you will need to update your installation!
    2. To do this, click on Edit/Delete Faculty -> Select User -> Update Address or Login -> Finish. You will need to repeat this for every user. You could also do this from the MySQL command line or phpMyAdmin.
    3. You will also need to do a similar process for all of your administrators.
  11. That’s it. You’re finished!

[edit] FROM 3.1.0 to 3.1.1

  1. Back up your database.
  2. Back up your installation.
  3. Remove all of the old files.
  4. Unpack the new version on your local computer or in the current installation site.
  5. Change the values in config.php. If you are unsure of any of these values, refer to the one you saved in Step 2. You should be able figure out most of the configuration file itself, as it’s well annotated.
  6. If you have created your own skin, follow the next few steps. If not, proceed to Step 7.
    1. I would suggest that you get a different program, like WinMerge ([9]), and then you can compare the differences of your files to the one of the skins. While this isn’t a perfect process, it should help you in find out what has changed since the last version.
    2. Now that you know what has changed, update or recreate your skin.
    3. If you need additional help with this step, please visit the Help & Support Forum on the project website (http://www.OnlineGrades.org)
    4. For more information on skins, please see the “Server Setup” document.
  7. That’s it. You’re finished!

[edit] FROM 3.0.1 to 3.1.0

  1. Back up your database.
  2. Backup your installation.
  3. Remove all of the old files.
  4. Unpack the new version on your local computer or in the current installation site.
  5. Change the values in config.php. If you are unsure of any of these values, refer to the one you saved in Step 2. You should be able to figure out most of the configuration file itself, as it’s well annotated.
  6. New in this version is an easier way for you to change the look of Online Grades. For more information on skins, please see the "Server Setup" document.
  7. That’s it. You’re finished!

[edit] FROM 3.0.0 to 3.0.1

  1. Back up your database.
  2. Back up your installation.
  3. Remove all of the old files.
  4. Unpack the new version on your local computer or in the current installation site.
  5. Change the values in basmaticonstants.php. If you are unsure of any of these values, refer to the one you saved in Step 2!
  6. That’s it. You’re finished!

From BASMATI

  1. Back up your database.
  2. Back up your BASMATI files.
  3. Now you need to update the BASMATI database to work with Online Grades. This is a relatively simple process. You still should have ##a backup of your data, and if everything goes well, all of your data should remain.
    1. Command Line -- mysql –p –u root ogdb < docs/basmati_to_og.sql
    2. phpMyAdmin – Select BASTAMTI DB -> SQL -> Browse -> docs/basmati_to_og.sql
    3. (Please replace the above information with the appropriate information for your installation.)
  4. At this point you can follow the install guide, minus the database portions.
  5. When you are going through the installation instructions, please note the following details:
    1. To login as an administrator the first time, do not set the email domain variable just yet. (If you use this feature.)
    2. This version includes some default Teacher Footnotes for the “Comments” table. To finish the setup on the Teacher Footnotes, please read the "Server Setup" document.
  6. You will need to login to the admin interface and update all of the staff logins and email addresses.
    1. Note: In this version, logins and email addresses can be different, so even if you choose to have the email/username the same, you will need to update your installation!
    2. To do this, click on Edit/Delete Faculty -> Select User -> Update Address or Login -> Finish. You will need to repeat this for every user. You could also do this from the MySQL command line or phpMyAdmin.
    3. You will also need to do a similar process for all of your administrators.
    4. You may want to edit your school(s) and add the website(s) to the database, if you haven’t already.

If you need any assistance, please don’t hesitate to ask!

Retrieved from "http://docs.onlinegrades.org/Upgrading_from_Previous_Versions"
Personal tools