(Additional Resources)
(PHP 5.2)
(48 intermediate revisions by one user not shown)
Line 5: Line 5:
 
Helios Calendar is written in PHP, uses a MySQL database and will run on any OS that both PHP and MySQL are available for. Helios Calendar is developed and tested with Windows(IIS), Linux(Apache) and Mac(Apache) Operating Systems.
 
Helios Calendar is written in PHP, uses a MySQL database and will run on any OS that both PHP and MySQL are available for. Helios Calendar is developed and tested with Windows(IIS), Linux(Apache) and Mac(Apache) Operating Systems.
  
'''Important:''' The following information addresses many commonly asked questions related to hosting Helios Calendar, however, this document is not exhaustive. If you have a question that is not addressed by the information below please [http://www.refreshmy.com/contact.php contact us for assistance].
+
'''Important:''' The following information addresses many commonly asked questions related to hosting Helios Calendar, however, this document is not exhaustive. If you have a question that is not addressed by the information below, or if you have questions about a specific aspect of your unique hosting service/server, please [http://www.refreshmy.com/contact.php contact us] to discuss hosting Helios Calendar in further detail.
  
 
== Minimum Versions ==
 
== Minimum Versions ==
<div style="float:left;width:48%;">
+
<div style="float:left;width:33%;">
 
=== Required ===
 
=== Required ===
* [http://www.php.net PHP] (5.2.17+)  
+
* [http://www.php.net PHP] (5.2.x+)  
* [http://www.mysql.com MySQL] (5.1.x+)
+
* [http://www.mysql.com MySQL] (5.0.x+)
 
</div>
 
</div>
<div style="float:left;width:48%;">
+
<div style="float:left;width:33%;">
 +
=== Supported ===
 +
* PHP (5.2.17+)
 +
* MySQL (5.1.x+)
 +
</div>
 +
<div style="float:left;width:33%;">
 
=== Recommended ===
 
=== Recommended ===
 
* PHP (5.3.x+)
 
* PHP (5.3.x+)
Line 19: Line 24:
 
</div>
 
</div>
  
=== Additional Resources ===
+
=== What's the Difference? ===
[http://www.refreshmy.com/forum/showthread.php?t=1560 Refresh Web Development's Support Discontinuation Roadmap]
+
 
 +
* '''Required''' - Minimum for Helios Calendar to function.
 +
* '''Supported''' - Oldest version currently eligible for support.
 +
* '''Recommended''' - Recommended for the best experience.
  
 
== PHP ==
 
== PHP ==
=== PHP 4 ===
+
=== PHP 4, 5.0 & 5.1 ===
  
The PHP Group terminated development of PHP4 on 31 December 2007 and support on 08 August 2008. Refresh Web Development discontinued support for Helios Calendar on PHP4 effective 1 January 2009.
+
Helios Calendar will not work on these older versions of PHP and Refresh does not support them.
  
Helios Calendar '''will not work''' on a server using PHP4.
+
=== PHP 5.2 ===
 +
The PHP Group ended support for version 5.2 in July 2010 with the release of 5.2.14. To facilitate the transition to 5.3 Refresh has extended support for this platform (just as we did with PHP4). Our current support roadmap provides support for PHP 5.2 until at least the release date of PHP 5.4.
  
=== PHP 5 ===
+
=== PHP 5.3 ===
 +
Helios Calendar 2.0+ offers full support for 5.3 and does not make use of any features deprecated in this release.
  
'''Supported:''' 5.3.x, 5.2.x
+
=== PHP 5.4 ===
 
+
This version is currently in development and Refresh does not support it yet. When support for this version is available this documentation will be updated.
'''Not Supported:''' 5.1.x & 5.0.x
+
 
+
==== PHP 5.2 ====
+
The PHP Group terminated support for for version 5.2 in July 2010 with the release of 5.2.14. To facilitate the transition to 5.3 Refresh has extended support for this platform (just as we did with PHP4). Our current support roadmap provides support for PHP 5.2 until at least December 31st 2011.
+
 
+
==== PHP 5.3 ====
+
Helios Calendar offers full support for 5.3 and does not make use of any features depreciated in this release.
+
 
+
==== PHP 5.4 ====
+
PHP 5.4 is currently in alpha and is not supported by Refresh Web Development for Helios Calendar. When support for this version is available this documentation will be updated.
+
  
 
=== Additional Resources ===
 
=== Additional Resources ===
* [http://www.php.net/archive/2007.php PHP 4 End of Life Announcement]
+
* [http://www.php.net/archive/2007.php#2007-07-13-1 PHP 4 End of Life Announcement]
 
* [http://www.php.net/archive/2010.php#id2010-07-22-1 PHP 5.2 End of Life Announcement]
 
* [http://www.php.net/archive/2010.php#id2010-07-22-1 PHP 5.2 End of Life Announcement]
 
* [http://php.net/manual/en/migration53.deprecated.php PHP 5.3 Deprecated Features]
 
* [http://php.net/manual/en/migration53.deprecated.php PHP 5.3 Deprecated Features]
* [http://en.wikipedia.org/wiki/PHP#Release_history Release History] (Wikipedia)
+
* [http://en.wikipedia.org/wiki/PHP#Release_history PHP Release History] (Wikipedia)
  
 
== MySQL ==
 
== MySQL ==
  
=== MySQL 4.0, 4.1 & 5.0 ===
+
Through version 2.0 Helios Calendar did '''not''' support MySQL running in ONLY_FULL_GROUP_BY mode. Users requiring support for this MySQL configuration should upgrade to version [[Helios:_2.0.1|2.0.1]] (or newer).
  
MySQL AB has discontinued extended support for these versions and Refresh does not support them.
+
=== MySQL 4.0, 4.1 ===
 +
Helios Calendar will not work on these older versions of MySQL and Refresh does not support them.
 +
 
 +
=== MySQL 5.0 ===
 +
Support for this version of MySQL has been discontinued. While there are currently no known performance issues on this platform it's use is not recommended.
  
 
=== MySQL 5.1 & 5.5 ===
 
=== MySQL 5.1 & 5.5 ===
Line 60: Line 64:
  
 
=== MySQL 5.6 ===
 
=== MySQL 5.6 ===
This version is currently in preview and Refresh does not support it yet.
+
This version is currently in development and Refresh does not support it yet. When support for this version is available this documentation will be updated.
  
 
=== Additional Resources ===
 
=== Additional Resources ===
Line 76: Line 80:
  
 
=== Unnecessary ===
 
=== Unnecessary ===
* '''register_globals''' - Helios Calendar has no dependence on register_globals. It may remain in it's default "off" setting.
+
* '''register_globals''' - Helios Calendar has no dependence on register_globals. It may remain in it's default "off" setting. (Note: This has been depreciated in PHP 5.3 and removed as of 5.4.)
 
* '''short_open_tag''' - Helios Calendar offers full support for the default PHP5 setting of short_open_tag = off.
 
* '''short_open_tag''' - Helios Calendar offers full support for the default PHP5 setting of short_open_tag = off.
  
 
== Sending Email ==
 
== Sending Email ==
Helios Calendar supports authenticated &amp; secure SMTP server connections. Email settings can be configured within the admin console [[Helios:_Preferences|Preferences]]
+
Helios Calendar supports authenticated &amp; secure SMTP server connections. Email settings can be configured, and tested, within the admin console [[Helios:_Preferences|Preferences]]
 +
 
 +
== Timezone Configuration ==
 +
 
 +
In some instances, dependent on PHP install configuration, users may see an error similar to:
 +
 
 +
''date() [function.date]: It is not safe to rely on the system's timezone settings.''
 +
 
 +
This error requires Helios Calendar users to:
 +
 
 +
# Identify their timezone. ([http://www.php.net/manual/en/timezones.php List of PHP Timezones.])
 +
# Add the following code to their config.php file.
 +
 
 +
<pre>ini_set('date.timezone','Your_Timezone');</pre>
 +
 
 +
Where ''Your_Timezone'' is the PHP supported timezone setting appropriate for your timezone.
  
 
== Session Save Path Configuration ==
 
== Session Save Path Configuration ==
Line 87: Line 106:
  
 
# Identify their temporary directory path
 
# Identify their temporary directory path
# Copy & paste the following code into their config.php file.
+
# Add the following code into their config.php file.
  
 
To make this change add the following code to your Helios Calendar's ''/inc/config.php'' file.
 
To make this change add the following code to your Helios Calendar's ''/inc/config.php'' file.
  
 
<pre>session_save_path("YOUR_HOME_DIRECTORY_PATH/cgi-bin/tmp");</pre>
 
<pre>session_save_path("YOUR_HOME_DIRECTORY_PATH/cgi-bin/tmp");</pre>
 +
 +
'''Note:''' Insert the above code, updated for your unique server path, to your config.php file below line 11.
  
 
=== Finding YOUR_HOME_DIRECTORY_PATH ===
 
=== Finding YOUR_HOME_DIRECTORY_PATH ===
Line 125: Line 146:
 
== Website Building Services ==
 
== Website Building Services ==
  
Helios Calendar is not compatible with "build a website" services. Because these services only allow users to manipulate simple HTML content within a predefined framework and not upload custom files or site components (specifically: PHP applications) Helios Calendar will not work with these services.
+
Helios Calendar is not compatible with hosted "build a website" services. Because these services only allow users to manipulate simple HTML content within a predefined framework and not upload custom files or site components (specifically: PHP applications) Helios Calendar will not work with these services.
  
'''Please Note:''' It may be possible for you to utilize a subdomain to host Helios Calendar outside of the following services, however, you should speak with your system administrator or web host support to discuss this in detail and confirm what types of deployment your existing service(s) support. Refresh cannot assist with DNS or server configurations as part of our Helios Calendar support services.
+
It may be possible for you to utilize a subdomain to host Helios Calendar outside of these types of services, however, you should speak with your system administrator or service support to discuss this in detail and confirm what types of deployment your existing service(s) support.
  
=== Confirmed Incompatible Services ===
+
=== Incompatible Services ===
 
The following list is not exhaustive, if you are uncertain about the compatibility of your website or hosting please [http://www.refreshmy.com/contact.php contact us with questions].
 
The following list is not exhaustive, if you are uncertain about the compatibility of your website or hosting please [http://www.refreshmy.com/contact.php contact us with questions].
  
 +
* Blogger (and Google Sites)
 
* Homestead (and Intuit branded variations: Intuit Websites, Intuit Website Builder, etc.)
 
* Homestead (and Intuit branded variations: Intuit Websites, Intuit Website Builder, etc.)
 
* Moonfruit
 
* Moonfruit
Line 138: Line 160:
 
* Viviti
 
* Viviti
 
* Webs (Formerly Freewebs)
 
* Webs (Formerly Freewebs)
 +
* Weebly
  
 
== Server Level Support ==
 
== Server Level Support ==
  
For your safety and ours, Refresh does not provide server level assistance as part of our support services. If you have questions about any aspect of your server or hosting service (including, but not limited to, installing or configuring PHP & MySQL) you should contact your web host support or system administrator.
+
For your safety and ours, Refresh does not provide server level assistance as part of our software support services. If you have questions about any aspect of your server or hosting service (including, but not limited to: DNS or server configurations, installing or configuring PHP & MySQL, etc.) you should contact your web host support, system administrator or internal IT support staff.

Revision as of 15:54, 12 January 2012

Refresh Software Documentation » Helios Calendar » Server Requirements

Helios Calendar is written in PHP, uses a MySQL database and will run on any OS that both PHP and MySQL are available for. Helios Calendar is developed and tested with Windows(IIS), Linux(Apache) and Mac(Apache) Operating Systems.

Important: The following information addresses many commonly asked questions related to hosting Helios Calendar, however, this document is not exhaustive. If you have a question that is not addressed by the information below, or if you have questions about a specific aspect of your unique hosting service/server, please contact us to discuss hosting Helios Calendar in further detail.

Contents

Minimum Versions

Required

Supported

  • PHP (5.2.17+)
  • MySQL (5.1.x+)

Recommended

  • PHP (5.3.x+)
  • MySQL (5.5.x+)

What's the Difference?

  • Required - Minimum for Helios Calendar to function.
  • Supported - Oldest version currently eligible for support.
  • Recommended - Recommended for the best experience.

PHP

PHP 4, 5.0 & 5.1

Helios Calendar will not work on these older versions of PHP and Refresh does not support them.

PHP 5.2

The PHP Group ended support for version 5.2 in July 2010 with the release of 5.2.14. To facilitate the transition to 5.3 Refresh has extended support for this platform (just as we did with PHP4). Our current support roadmap provides support for PHP 5.2 until at least the release date of PHP 5.4.

PHP 5.3

Helios Calendar 2.0+ offers full support for 5.3 and does not make use of any features deprecated in this release.

PHP 5.4

This version is currently in development and Refresh does not support it yet. When support for this version is available this documentation will be updated.

Additional Resources

MySQL

Through version 2.0 Helios Calendar did not support MySQL running in ONLY_FULL_GROUP_BY mode. Users requiring support for this MySQL configuration should upgrade to version 2.0.1 (or newer).

MySQL 4.0, 4.1

Helios Calendar will not work on these older versions of MySQL and Refresh does not support them.

MySQL 5.0

Support for this version of MySQL has been discontinued. While there are currently no known performance issues on this platform it's use is not recommended.

MySQL 5.1 & 5.5

Both versions are currently supported.

MySQL 5.6

This version is currently in development and Refresh does not support it yet. When support for this version is available this documentation will be updated.

Additional Resources

PHP & Hosting Settings/Requirements

Required

  • fsockopen & Internet Connection - If fsockopen is disabled, or your server is not connected to the internet (or it's outgoing connection is restricted by a firewall), Helios will not install or upgrade successfully.
  • Directory Permissions - Helios Calendar requires the ability to write files to a limited number of directories for caching & image upload. Without the ability to write these files Helios Calendar will not function. Contact your web host support or system administrator to confirm PHP write privileges in your environment and to discuss the best practice for configuring PHP application write access on your server.

Recommended

  • GD Graphics Library - Helios' native CAPTCHA image creation and newsletter tracking image require support for the GD Graphics Library. If the library is not available you will have the option to use the reCAPTCHA API for CAPTCHA functionality but tracking newsletters read by subscribers will not function correctly.

Unnecessary

  • register_globals - Helios Calendar has no dependence on register_globals. It may remain in it's default "off" setting. (Note: This has been depreciated in PHP 5.3 and removed as of 5.4.)
  • short_open_tag - Helios Calendar offers full support for the default PHP5 setting of short_open_tag = off.

Sending Email

Helios Calendar supports authenticated & secure SMTP server connections. Email settings can be configured, and tested, within the admin console Preferences

Timezone Configuration

In some instances, dependent on PHP install configuration, users may see an error similar to:

date() [function.date]: It is not safe to rely on the system's timezone settings.

This error requires Helios Calendar users to:

  1. Identify their timezone. (List of PHP Timezones.)
  2. Add the following code to their config.php file.
ini_set('date.timezone','Your_Timezone');

Where Your_Timezone is the PHP supported timezone setting appropriate for your timezone.

Session Save Path Configuration

Some hosts require users to configure PHP applications to write session data to a temporary directory assigned to their hosting account. This process requires Helios Calendar users to:

  1. Identify their temporary directory path
  2. Add the following code into their config.php file.

To make this change add the following code to your Helios Calendar's /inc/config.php file.

session_save_path("YOUR_HOME_DIRECTORY_PATH/cgi-bin/tmp");

Note: Insert the above code, updated for your unique server path, to your config.php file below line 11.

Finding YOUR_HOME_DIRECTORY_PATH

If you are unsure what your home directory path is please contact your hosting support or system administrator and they will be able to assist you further.

Confirmed Hosts That Require Session Save Path Configuration

BizLand
FatCow
iPage
iPower
StartLogic

Hosting Provider Specific Notes

Fasthosts Hosting Customers

It has been brought to Refresh's attention that under the Windows hosting service offered by Fasthosts they do not permit users to allow write access to directories for hosted apps. As a result Helios Calendar will not work with Fasthosts Windows hosting service.

Please reference this knowledge base article for more information.

GoDaddy Hosting Customers

Helios Calendar users have experienced anomalies with GoDaddy's PHP & MySQL configuration on their Windows Hosting Packages. GoDaddy hosting customers should use their Linux Hosting Package to host Helios, all reported issues related to GoDaddy hosting have been resolved by switching.

Yahoo Hosting Customers

PHP5 is now available as an "Additional Feature" for Yahoo Hosting customers. Helios Calendar users on Yahoo Hosting are encouraged to contact Yahoo support to inquire as to the specific version of PHP5 available to them (as this is not listed on their site) to ensure that it conforms to the minimum requirements listed above.

As a result of Yahoo's service upgrades Refresh Web Development is now providing support to Helios Calendar users on Yahoo Hosting when their hosting package conforms to the stated requirements above. For further details please contact us with any questions.

BizLand, FatCow, iPage, iPower and StartLogic Customers

Please see the note above about Session Save Path Configuration

Website Building Services

Helios Calendar is not compatible with hosted "build a website" services. Because these services only allow users to manipulate simple HTML content within a predefined framework and not upload custom files or site components (specifically: PHP applications) Helios Calendar will not work with these services.

It may be possible for you to utilize a subdomain to host Helios Calendar outside of these types of services, however, you should speak with your system administrator or service support to discuss this in detail and confirm what types of deployment your existing service(s) support.

Incompatible Services

The following list is not exhaustive, if you are uncertain about the compatibility of your website or hosting please contact us with questions.

  • Blogger (and Google Sites)
  • Homestead (and Intuit branded variations: Intuit Websites, Intuit Website Builder, etc.)
  • Moonfruit
  • Ning
  • Squarespace
  • Viviti
  • Webs (Formerly Freewebs)
  • Weebly

Server Level Support

For your safety and ours, Refresh does not provide server level assistance as part of our software support services. If you have questions about any aspect of your server or hosting service (including, but not limited to: DNS or server configurations, installing or configuring PHP & MySQL, etc.) you should contact your web host support, system administrator or internal IT support staff.