Technical Upgrade

Upgrading a current Helios Calendar install is a two step process to update files (HTML, PHP, CSS, etc.) and the database.

Before making any changes to a live website always backup your site files and database.

Note: These instructions assume a 2.x install is already present. If you are upgrading a 1.x version of Helios Calendar please see the Upgrading from 1.x instructions.

Step 1 Uploading New Files

Before upgrading a production installation it is recommended to make a backup of your existing site before uploading new files to it.

Upgrade-proof Themes & Hacks

Click here for tips on upgrade-proofing your customization.

Step 2 Performing the Database Upgrade

After uploading the new files to your server, in your web browser of choice, open your Helios Calendar URL with /setup added to the end.

Example:

• If your Helios Calendar is installed at: www.yourdomain.com, open: www.yourdomain.com/setup
• If your Helios Calendar is installed at: www.yourdomain.com/calendar, open: www.yourdomain.com/calendar/setup

Enter Install Code

Enter the install code (HC_Install) from your config.php file to begin the upgrade.

Select Upgrade

Select the upgrade to run from the select list options. Helios will attempt to identify the current installed version (and output it for review), however, the selection must be performed manually.

When you have selected the upgrade to run click “Run Upgrade”.

Upgrade Results

The upgrade results for each step performed will be output for review. Once each step is completed successfully with a status of “Finished” you can proceed with clean up to complete the upgrade. If any steps of the process are unsuccessful they will be identified with a status of “Failed”.

Clean Up

Once the database upgrade is completed successfully delete the /setup directory and your cache files (keep the directory and the index.html file, but delete all other files within the /cache directory). Congratulations, your upgrade is complete.

Note: After completing your upgrade you should review the current list of Deprecated Functions and apply any appropriate updates to your theme(s)/hack(s).

Version Specific Notices

Version 2.0.2 or Older

In Helios Calendar 2.0.2 and older we included hardcoded Consumer Key & Secret for Twitter API access. Beginning with version 2.1 of Helios Calendar all users must register their Helios install with Twitter for API access. Registration instructions are available here. Twitter API access for installs upgraded from 2.0.2 or older will be unavailable until registration & setup is completed.