Difference between revisions of "Common Installation Errors"

(Created page with "===Be assured that=== # Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, e...")
 
Line 1: Line 1:
===Be assured that===
+
==Overview==
 +
This article covers most basic questions and errors you might have or already experienced trying to install, or update your site
 +
 
 +
==Preserving the site state==
 
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
 
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
 
# It will not interfere with non-JomSocial database tables.
 
# It will not interfere with non-JomSocial database tables.
 
+
<font color=red>'''WARNING'''</font>
===<font color=red>WARNING</font>===
+
Be advised however, that:
 
* All '''''template customizations''''' which do not follow our [[Customizing Template|template override instructions]] '''will be deleted'''.
 
* All '''''template customizations''''' which do not follow our [[Customizing Template|template override instructions]] '''will be deleted'''.
 
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3.0 functionality. Please consult your template developer(s) for updates.
 
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3.0 functionality. Please consult your template developer(s) for updates.
Line 10: Line 13:
 
* Always consult third-party developers for updated version of their plugins.
 
* Always consult third-party developers for updated version of their plugins.
  
===<font color=red>Known Upgrade Errors</font>===
+
==Known Upgrade Errors==
  
 
'''There was an error uploading this file to the server.'''<br/>
 
'''There was an error uploading this file to the server.'''<br/>

Revision as of 07:30, 9 December 2013

Overview

This article covers most basic questions and errors you might have or already experienced trying to install, or update your site

Preserving the site state

  1. Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
  2. It will not interfere with non-JomSocial database tables.

WARNING Be advised however, that:

  • All template customizations which do not follow our template override instructions will be deleted.
  • All template overrides need to be updated; otherwise you will have a crippled JomSocial with limited JomSocial 3.0 functionality. Please consult your template developer(s) for updates.
  • All modifications to any file in /components/com_community and /administrator/components/com_community will be deleted.
  • Third party extensions that rely on hacking JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
  • Always consult third-party developers for updated version of their plugins.

Known Upgrade Errors

There was an error uploading this file to the server.
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 4MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.

  1. upload_max_filesize = 4M  ; Maximum allowed size for uploaded files.
  2. post_max_size = 4M ; Maximum size of POST data that PHP will accept.

ERROR: Could not find an XML setup file in the package.
Make sure you have unpacked com_community_pro_unzip_first_(VERSION).zip before installing the package. You will see four files:

  1. apps_unzip_first_version.zip
  2. com_community_pro_version.zip (Use this file to install JomSocial)
  3. modules_unzip_first_version.zip
  4. ReadMe.txt