Suggested Update for Technical Requirements Page

Joomla! Documentation Workgroup

Moderator: Documentation

Locked
User avatar
ozneilau
Joomla! Guru
Joomla! Guru
Posts: 858
Joined: Tue Aug 04, 2009 9:05 am
Location: Tasmania, Australia
Contact:

Suggested Update for Technical Requirements Page

Post by ozneilau » Tue Oct 02, 2012 4:14 am

I have recently spent a lot of time explaining and fixing hosting environments for clients because the default Apache PHP file handler was being used instead of suPHP or FastCGI or similar.

As pointed out to me in the forums at http://forum.joomla.org/viewtopic.php?f ... 0#p2909712, there is nowhere obvious where this information can be found by Joomla beginners.

The Technical Requirements page might be a good place for beginners to find this information and help them make the right decision about choosing or setting up a suitable hosting platform.

Neil.

User avatar
Chris Davenport
Joomla! Ace
Joomla! Ace
Posts: 1385
Joined: Thu Aug 18, 2005 8:57 am
Location: Shrewsbury, Shropshire, United Kingdom

Re: Suggested Update for Technical Requirements Page

Post by Chris Davenport » Tue Oct 02, 2012 6:48 am

What is your suggested wording?

Chris.
Chris Davenport

Davenport Technology Services http://www.davenporttechnology.com/
Lion Coppice http://www.lioncoppice.org/

User avatar
ozneilau
Joomla! Guru
Joomla! Guru
Posts: 858
Joined: Tue Aug 04, 2009 9:05 am
Location: Tasmania, Australia
Contact:

Re: Suggested Update for Technical Requirements Page

Post by ozneilau » Tue Oct 02, 2012 7:40 am

Chris Davenport wrote:What is your suggested wording?
Hi Chris,

How about amending the text on the Technical Requirements page from this:
  • "Apache(with mod_mysql, mod_xml, and mod_zlib)"
to this:
  • "Apache(with mod_mysql, mod_xml, mod_zlib and either mod_suphp or mod_fcgid)"
with a footnote explanation as follows:
  • "The mod_suphp and mod_fcgid extensions provide Joomla with sufficient authority to upload and execute files using the recommended file permissions of 755 for folders and 644 for files."
A link to an article with more technical detail would be even better. I could write something if needed.

What do you think?

Neil.

sovainfo
Joomla! Exemplar
Joomla! Exemplar
Posts: 8808
Joined: Sat Oct 01, 2011 7:06 pm

Re: Suggested Update for Technical Requirements Page

Post by sovainfo » Tue Oct 02, 2012 8:08 am

Is it rue that it is a requirement? Or is it just a possible configuration!

Also is mod_mysql still a requirement now mssql and postgresSQL are supported?
Issue with migrating? Include logs/joomla_update.php in your report!
Blank screen? Verify pagesource for HTML code (javascript error)
Installation failing on populating database? Install with set_time_limit(0)
Document your customizations!

User avatar
ozneilau
Joomla! Guru
Joomla! Guru
Posts: 858
Joined: Tue Aug 04, 2009 9:05 am
Location: Tasmania, Australia
Contact:

Re: Suggested Update for Technical Requirements Page

Post by ozneilau » Tue Oct 02, 2012 8:44 am

Joomla can be installed on a server without suPHP or FastCGI but without these, Joomla doesn't have sufficient authority to update files. Installing or updating extensions or even updating the Global Configuration is impossible. In effect you have just installed a static website that can't be changed.

The only way around this is to amend all the file and folder permissions to world writeable / 777 and enable FTP in Global configuration. While technically possible, there are very few scenarios where this would be desirable.

I do understand your logic that this may not strictly be regarded by some as a requirement.

If that's the case, then maybe a note similar to the one about mod_rewrite on the Technical Requirements page at http://www.joomla.org/technical-requirements.html would suffice. For example:

  • ***In order to provide Joomla with sufficient authority to upload and execute files using the recommended file permissions of 755 for folders and 644 for files, you will need to have the Apache mod_suphp or mod_fcgid extension installed.


Neil.

User avatar
Chris Davenport
Joomla! Ace
Joomla! Ace
Posts: 1385
Joined: Thu Aug 18, 2005 8:57 am
Location: Shrewsbury, Shropshire, United Kingdom

Re: Suggested Update for Technical Requirements Page

Post by Chris Davenport » Tue Oct 02, 2012 8:53 am

suPHP/FastCGI are certainly not requirements, but we could add something about them being recommended.

For Joomla 3 MySQL, MSSQL and PostgresSQL are all listed under "Supported databases". I think MSSQL is an alternative for Joomla 2.5, but PostgresSQL is not, is that right?

Chris.
Chris Davenport

Davenport Technology Services http://www.davenporttechnology.com/
Lion Coppice http://www.lioncoppice.org/

User avatar
ozneilau
Joomla! Guru
Joomla! Guru
Posts: 858
Joined: Tue Aug 04, 2009 9:05 am
Location: Tasmania, Australia
Contact:

Re: Suggested Update for Technical Requirements Page

Post by ozneilau » Tue Oct 02, 2012 8:58 am

Chris Davenport wrote:suPHP/FastCGI are certainly not requirements, but we could add something about them being recommended.
Yes please!

I think this will help save a lot of grief for many Joomla beginners.

Thanks for listening. :)

Neil.

User avatar
Chris Davenport
Joomla! Ace
Joomla! Ace
Posts: 1385
Joined: Thu Aug 18, 2005 8:57 am
Location: Shrewsbury, Shropshire, United Kingdom

Re: Suggested Update for Technical Requirements Page

Post by Chris Davenport » Tue Oct 02, 2012 9:05 am

ozneilau wrote:The only way around this is to amend all the file and folder permissions to world writeable / 777 and enable FTP in Global configuration. While technically possible, there are very few scenarios where this would be desirable
Or you leave the permissions at 755/644 and just change ownership (chown) as required. I work with a couple of servers where Apache not being able to modify its own files is considered a security plus. So, not a requirement, but I would agree that suPHP/FastCGI is recommended for the majority of users.

Chris.
Chris Davenport

Davenport Technology Services http://www.davenporttechnology.com/
Lion Coppice http://www.lioncoppice.org/

User avatar
Chris Davenport
Joomla! Ace
Joomla! Ace
Posts: 1385
Joined: Thu Aug 18, 2005 8:57 am
Location: Shrewsbury, Shropshire, United Kingdom

Re: Suggested Update for Technical Requirements Page

Post by Chris Davenport » Tue Oct 02, 2012 9:08 am

There is a shadow copy of the technical requirements on the wiki: http://docs.joomla.org/Technical_requirements

If someone would like to amend that page along the lines discussed here I'll pass it on so we can update http://www.joomla.org/technical-requirements.html too.

Thanks,
Chris.
Chris Davenport

Davenport Technology Services http://www.davenporttechnology.com/
Lion Coppice http://www.lioncoppice.org/

User avatar
ozneilau
Joomla! Guru
Joomla! Guru
Posts: 858
Joined: Tue Aug 04, 2009 9:05 am
Location: Tasmania, Australia
Contact:

Re: Suggested Update for Technical Requirements Page

Post by ozneilau » Tue Oct 02, 2012 10:06 am

Chris Davenport wrote:If someone would like to amend that page along the lines discussed here
Done!

Thanks for your help with this.

Neil.

sovainfo
Joomla! Exemplar
Joomla! Exemplar
Posts: 8808
Joined: Sat Oct 01, 2011 7:06 pm

Re: Suggested Update for Technical Requirements Page

Post by sovainfo » Tue Oct 02, 2012 10:30 am

The real requirement is write access on the filesystem (folder and files) by the Webserver.
How people implement that is their choice and very much depending on their environment.
The provider should be asked whether this is allowed and how this is implemented.
Issue with migrating? Include logs/joomla_update.php in your report!
Blank screen? Verify pagesource for HTML code (javascript error)
Installation failing on populating database? Install with set_time_limit(0)
Document your customizations!


Locked

Return to “docs.joomla.org - Feedback/Information”