Joomla! installation

From gvSIG CE Wiki

Jump to: navigation, search

Joomla! serves as the Content Management System (CMS) for the gvSIG CE Internet home page at http://www.gvsigce.org.

Sourceforge.net's Project Web hosting space service has been improved as of February 2011. It is now possible to set up write permissions in the file system and to allow hosted applications to sent email out, making a fully working Joomla! installation possible on SF.net.


Contents

Installation

This documentation contains a full protocol of all installation steps. This information can be used to understand and replicate the installation in case of problems. There are no passwords or other confidential information on this page. Never publish sensitive information on our Wiki!. If you wish to take over administrative tasks for gvSIG CE, contact one of our project members directly.

The official (outdated!) Joomla installation guide is available here.

Command line work

Note: Please make sure to read the page on Working with Project Web first, before attempting to replicate the steps detailed here.

Create a shell and log into SF terminal service:

 ssh -t <user>,gvsice@shell.sourceforge.net

Go into the right directory and create a Joomla! installation directory:

 cd /home/project-web/gvsigce/htdocs
 mkdir joomla
 cd joomla

Make sure that you are now within the new joomla installation directory! This director is called the joomla root directory from now on.

Get the Joomla files and unzip them.

 wget -c http://joomlacode.org/gf/download/frsrelease/14659/64120/Joomla_1.6.3-Stable-Full_Package.zip
 unzip Joomla_1.6.3-Stable-Full_Package.zip
 

Create a writable configuration file in the Joomla root directory:

 cp installation/models/configuration.php .
 chmod g+w configuration.php  

Web-based confifuratio

Next, go through the Joomla setup process. Browse to: http://gvsigce.sourceforge.net/joomla/installation/index.php, then:

  1. Set language, press "Next".
  2. The next page is the pre-installation check. Everything should check out in green here, except global PHP options (the second group) which we have no influence on, since they are set by SF. Press "Next", ignoring any non-fatal PHP setting problems.
  3. This is the license. Press "Next".
  4. Choose the database settings. The database name MUST be prefixed with the SF-assigned database prefix, as displayed on the SF configuration page for your Project Database, including the "_" underscore (see Working with Project Web):
 Database Type = MySQL
 Host Name = mysql-o
 Username = [MySQL admin name]
 Password = [MySQL admin password]
 Database Name = [MySQL_prefix]_joomla (see note below)
 Table Prefix = jos_
 Old Database Process = Backup
     
  1. Press "Next" to complete the database setup.
  2. FTP setup. Not needed. Leave blank and press "Next".
  3. Main Configuration page. Choose a site name, Open the "Advanced Settings" for metadata, and enter the details for the admin account. Press "Next"
  4. Final page. You need to remove the Joomla! installation directory now. This will not work via the button on this page. Instead, issue the following shell command within the Joomla! root directory.
       rm installation/ -rf

This concludes the basic installation.

Tuning the installation

Once the basic installation is done, some fine tuning is in order.

File permissions

We now need to set some file system access permissions in order to allow the installation of modules, plugins and templates later on, from within the CMS. Essentially, we need to allow the group "apache", under which Joomla! runs, write access to some files and directories.

Assuming that you have a shell running and are within the root directory of your Joomla! installation:

 chmod g+w components images logs modules plugins templates tmp
 chmod g+w language language/* -R

Note: It is possible that more write permissions will be needed for some extensions or templates to function. However, refrain from simply giving write access to all files and folders, as this would open up a huge security gap! Better check each error message in the CMS individually. It will tell you exactly which file or folder had the problem and you can fix it manually as above.

Make a note of your additions, because after a Joomla! upgrade, you may have to set all those permissions again!

To use Joomla's Media Manager, simply create some new folder(s) from within the Media Manager web interface and put your stuff in there.

Editing template files

The main Joomla! template definition files are: home/project-web/gvsigce/htdocs/joomla/templates/holiday4ever-et/index.php and /home/project-web/gvsigce/htdocs/joomla/templates/holiday4ever-et/css/styles.css.

Edit them directly to make any settings not available through the Joomla! web administration front-end.


Outbound email

Log into Joomla! as admin and then go to "Site > Global Configuration".

On the page "Server", you can set your SMTP Username and SMTP Password to match the name of the Sourceforge project ("gvsigce") and the password set for outbound email. Use "prwebmail" (without quotes" as the SMTP Host. Don't forget to set the "Mailer" to "SMTP". Also, set "SMTP Authentication" to "Yes" and "SMTP Security" to "TLS".

Redirection

To redirect the user straight from the SF.net main page at http://gvsigce.sourceforge.net to the Joomla! pages, a minimal index.html file has been created in htdocs, with only this content:

 <html>
 <head>
 <meta HTTP-EQUIV="REFRESH" content="0;url=http://gvsigce.sourceforge.net/joomla/index.php">
 </head>
 <title>Redirect to Joomla pages</title>
 <body>
You will now be redirected to our Joomla pages.

If redirection does not work, click <a href="http://gvsigce.sourceforge.net/joomla/index.php">this link</a>. </body> </html>

Using Joomla!

You can get to the Joomla site by simply going to the main web site of the project. The administrator login is here.

TODO: Add more usage/admin info here