Difference between revisions of "Installation FAQs Version 1.0"

From Joomla! Documentation

m (→‎How do I upgrade 1.0.x versions?: clean up categories with <noinclude> tags)
 
(8 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{review}}
 
 
==Should I install the 1.0.x or 1.5 version of Joomla!?==
 
 
Your needs and experience should determine which version you install. Factors you might wish to consider include:
 
 
* the importance of specific features or extensions for your site
 
* the expected life span of your site
 
* you and your user's familiarity with Joomla!
 
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider
 
 
 
==How much webspace do I need to install Joomla!?==
 
==How much webspace do I need to install Joomla!?==
  
Line 21: Line 10:
  
 
If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.  
 
If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.  
 
==How do I install Joomla! 1.5?==
 
 
Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/
 
  
 
==How can I avoid having to upload configuration.php in a manual install?==
 
==How can I avoid having to upload configuration.php in a manual install?==
 
===Joomla! 1.0===
 
  
 
If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.
 
If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.
Line 55: Line 38:
 
Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.
 
Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.
  
{{inuse}}
+
==How do I fix the "Max Execution Time Exceeded" error?==
==How can I set up/install Joomla! on Win XP for local testing?==
 
 
 
There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:
 
 
 
*[http://www.apachefriends.org/en/xampp.html Xampp]
 
*[http://bitnami.org/stack/joomla Bitnami Stack]
 
*[http://www.wampserver.com/index.php WampServer]
 
  
<b>XAMPP</b>
+
Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local xampp development environment this file is located in  c:\xampp\php. To make all necessary changes you must do the following:
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
+
#Locate and open php.ini with any text editor.
#Create an xampp directory at the root of C:\
+
#Locate max_execution_time as seen in figure below.
#Extract downloaded xampp zip file into newly created xampp directory
+
#Modify the settings according to your needs.
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.  
+
#Save Changes.
#Select services that you would like to start
+
#Restart Xampp for new settings to take effect.
#Click Start
 
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]
 
#Click on Apache Admin button to view local web server main page
 
[[Image:Xampp-success.jpg|Xampp after successful local Installation]]
 
  
<b><i>**Apply Xampp Post Installation Security Recommendations provided by apache friends</i></b>
+
[[Image:Php-max-exec.jpg|Php-max-exec.jpg]]
{{inuse}}
 
 
 
==How do I fix the "Max Execution Time Exceeded" error?==
 
 
 
Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local a xampp development environment this file is located in  c:\xampp\php. Open php.ini with any text editor and locate option as seen in the image below.
 
[[Php-max-exec.jpg]]
 
{{inuse}}
 
  
 
==How do I upgrade 1.0.x versions?==
 
==How do I upgrade 1.0.x versions?==
 
  
 
In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.
 
In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.
Line 135: Line 99:
 
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html
 
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html
  
<noinclude>[[Category:FAQ]]</noinclude>
+
<noinclude>[[Category:FAQ]]
 +
[[Category:Installation FAQ]]
 +
[[Category:Version 1.0 FAQ]]</noinclude>

Latest revision as of 15:52, 1 September 2012

How much webspace do I need to install Joomla!?[edit]

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

How do I install Joomla! 1.0?[edit]

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

How can I avoid having to upload configuration.php in a manual install?[edit]

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

  1. upload your core files to the directory of the server where you want to install Joomla
  2. create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
  3. do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

How do you pre-install extensions?[edit]

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

  1. Install Joomla! as normal.
  2. RENAME instead of delete installation folder (you will need to add it to the zip).
  3. Install all extentions as per instructions for each.
  4. Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
  5. Rename the installation folder to installation from whatever you renamed it.
  6. Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
  7. Upload that zip and extract all the files to the webroot of the target site.
  8. Install as normal.
  9. Check to see if there are any patches since the time you made this package and patch accordingly.
  10. Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

How do I fix the "Max Execution Time Exceeded" error?[edit]

Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local xampp development environment this file is located in c:\xampp\php. To make all necessary changes you must do the following:

  1. Locate and open php.ini with any text editor.
  2. Locate max_execution_time as seen in figure below.
  3. Modify the settings according to your needs.
  4. Save Changes.
  5. Restart Xampp for new settings to take effect.

Php-max-exec.jpg

How do I upgrade 1.0.x versions?[edit]

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

What is a patch?
A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.
How do I know which version I use?
Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.
Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
There is a separate migration procedure to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.
Do I need to install one or more patches to go to the latest version?
When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.
Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.
Does a patch overwrite my configuration?
No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.
When do I need to update my language file?
You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.
What about the configuration.php-dist file?
This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.
How do I patch Joomla! for a local installation?
  • Create a back-up of both data and database before starting!
  • Check the forum if any problems have been found.
  • Download the patch in question.
  • Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
  • It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
  • Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
  • Set your site online again, your Joomla! installation should be patched to the latest version.
  • Check the version in the administrator backend. The version should be changed.
How do I patch for a Joomla! installation at a hoster?
  • Create a back-up of both data and database before starting!
  • Check the forum if any problems have been found.
  • Download the patch in question.
  • Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
  • It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
  • You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
  • Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
  • Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
  • Set your site online again. Your Joomla! installation should be patched to the latest version.
  • Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html