Step by step instructions on how to update your phpCAS library to the most current, secure version.
For this example, we will update from version 1.3.2 to version 1.3.3. But the same steps should apply to updating between any versions of the phpCAS library (which allows logins with GTaccounts to our drupal sites).
- Download the latest version from http://downloads.jasig.org/cas-clients/php/current/
- If you don't want to use ssh/command line, "extract" the files from this compressed archive on your computer (Windows users can use the free 7-zip program to do so), which will create a folder called "CAS-1.3.3", that has another "CAS-1.3.3" and a "package.xml" file inside it.
- Change the name the second "CAS-1.3.3" folder (that is inside the other) to "CAS".
- Zip up that re-named "CAS" folder...usually by right-clicking and choosing either "Compress 'CAS'" or "Send to" > "Compressed (zipped) folder".
- Now that you have a friendly zipped file, named "CAS.zip", find where the CAS library lives on your server. The best practices location on a Drupal site is under the "sites/all/libraries" folder (which often requires you to add the "libraries" module to your Drupal site, first).
- Then, turn on your TEST site's maintenance mode (because, of course, you are not trying this out on your live site). For Drupal 7, you can enable this at: admin/config/development/maintenance
- Delete the current version of phpCAS that lives at "sites/all/libraries", so that there is no "CAS" folder anymore.
- Upload your new "CAS.zip" file to your Test site's libraries folder, so that it looks like this: "sites/all/libraries/CAS.zip".
- Check the box next to CAS.zip in your web hosting panel and then, from the menu of options at the top of your file list, choose "More" > "Extract Files" and then click "Okay".
- Once you see your new "CAS" folder, you can then delete the "CAS.zip" file from this directory and your library has been updated.
- Remove your Test site from maintenance mode and make sure it works correctly.
- If all goes well, follow the same process on your Live site.