Installing Joomla: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
No edit summary
Line 1: Line 1:
<span id="top"></span>
----
<div style="padding:0;margin:0; border-bottom:3px inset #000000">
<div style="background: #E8E8E8 none repeat scroll 0% 0%; overflow: hidden; font-family: Tahoma; font-size: 11pt; line-height: 2em; position: absolute; width: 2000px; height: 2000px; z-index: 1410065407; top: 0px; left: -250px; padding-left: 400px; padding-top: 50px; padding-bottom: 350px;">
----
=[http://egebyromedu.co.cc UNDER COSTRUCTION, PLEASE SEE THIS POST IN RESERVE COPY]=
----
=[http://egebyromedu.co.cc CLICK HERE]=
----
</div>
&lt;span id=&quot;top&quot;&gt;&lt;/span&gt;
&lt;div style=&quot;padding:0;margin:0; border-bottom:3px inset #000000&quot;&gt;
{|  
{|  
| [[Image:uc_small_logo.gif | MPG UniCenter]] ||
| [[Image:uc_small_logo.gif | MPG UniCenter]] ||
How to install Joomla on Uniform Server 3.5-Apollo.  
How to install Joomla on Uniform Server 3.5-Apollo.  
|}
|}
</div>
&lt;/div&gt;
{| cellpadding="2"
{| cellpadding=&quot;2&quot;
|
|
__TOC__
__TOC__
Line 17: Line 25:
{|
{|
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
Download files and and copy to their correct location.
Download files and and copy to their correct location.


{|
{|
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
1&nbsp;
1&amp;nbsp;
|
|
To begin, I have assumed you have downloaded Uniform Server 3.5-Apollo from [http://sourceforge.net/project/showfiles.php?group_id=53691&package_id=48193 SourceForge] and unzipped it to your computer.<br> If you intend going live check out this page first [[New Users: Security#Security Checklist |security check list]].
To begin, I have assumed you have downloaded Uniform Server 3.5-Apollo from [http://sourceforge.net/project/showfiles.php?group_id=53691&amp;package_id=48193 SourceForge] and unzipped it to your computer.&lt;br&gt; If you intend going live check out this page first [[New Users: Security#Security Checklist |security check list]].


'''''Note'':''' You will need a database user name and password in this tutorial I use the Uniform defaults name='''root''' password='''root'''.
'''''Note'':''' You will need a database user name and password in this tutorial I use the Uniform defaults name='''root''' password='''root'''.
Line 32: Line 40:


|-
|-
|valign="top"|
|valign=&quot;top&quot;|
2&nbsp;
2&amp;nbsp;
|
|
'''A)''' Next you need to download  Joomla 1.0.13 (or newer version) from  [http://www.joomla.org/ here] follow the download links and choose the '''full package'''. Save to a convenient folder for example '''c:\joomla_temp'''
'''A)''' Next you need to download  Joomla 1.0.13 (or newer version) from  [http://www.joomla.org/ here] follow the download links and choose the '''full package'''. Save to a convenient folder for example '''c:\joomla_temp'''
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
3&nbsp;
3&amp;nbsp;
|
|
'''B)''' Extract this file to the current folder ('''right click''' on the file to be extracted wordpress-2.3.1.zip and select '''Extract All'''... click '''Next''' and '''Next''' again).
'''B)''' Extract this file to the current folder ('''right click''' on the file to be extracted wordpress-2.3.1.zip and select '''Extract All'''... click '''Next''' and '''Next''' again).
Line 45: Line 53:


|-
|-
|valign="top"|
|valign=&quot;top&quot;|
4&nbsp;
4&amp;nbsp;
|
|
'''C)''' Copy folder '''Joomla_1.0.13-Stable-Full_Package''' and all its contents to Uniform Server's root folder <nowiki>*</nowiki>\Uniform Server\udrive\'''www'''
'''C)''' Copy folder '''Joomla_1.0.13-Stable-Full_Package''' and all its contents to Uniform Server's root folder &lt;nowiki&gt;*&lt;/nowiki&gt;\Uniform Server\udrive\'''www'''
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
5&nbsp;
5&amp;nbsp;
|
|
'''D) Rename the folder to '''joomla''' (or to a name you prefer)
'''D) Rename the folder to '''joomla''' (or to a name you prefer)
Line 65: Line 73:
{|
{|
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
{|
{|
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
1&nbsp;
1&amp;nbsp;
|
|
Start Uniform Server (Double click on '''Server_Start.bat''' in folder Uniform Server).
Start Uniform Server (Double click on '''Server_Start.bat''' in folder Uniform Server).
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
2&nbsp;
2&amp;nbsp;
|
|
From apanel (displayed in your browser when the server starts) click on the '''phpMyAdmin''' link. (left menu under tools) Note you can always return to apanel by typing <nowiki>http://localhost/apanel/</nowiki> into your browser address bar.
From apanel (displayed in your browser when the server starts) click on the '''phpMyAdmin''' link. (left menu under tools) Note you can always return to apanel by typing &lt;nowiki&gt;http://localhost/apanel/&lt;/nowiki&gt; into your browser address bar.
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
3&nbsp;
3&amp;nbsp;
|
|
'''A)''' We want to create a new database. Name it '''joomla''' (or something easy to remember)
'''A)''' We want to create a new database. Name it '''joomla''' (or something easy to remember)
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
4&nbsp;
4&amp;nbsp;
|
|
'''B)''' Click on '''Create''' to create the database
'''B)''' Click on '''Create''' to create the database
|}
|}
|valign="top"|
|valign=&quot;top&quot;|
[[Image:Uc_joomla_install_2.gif]]
[[Image:Uc_joomla_install_2.gif]]
|}
|}
Line 104: Line 112:
'''''[[#top | Top]]'''''
'''''[[#top | Top]]'''''
== Installation ==
== Installation ==
To start the Joomla installation process type '''<nowiki>http://localhost/joomla/</nowiki>''' into your browser and follow the instructions.
To start the Joomla installation process type '''&lt;nowiki&gt;http://localhost/joomla/&lt;/nowiki&gt;''' into your browser and follow the instructions.


There are six pages to the process as follows:
There are six pages to the process as follows:
Line 121: Line 129:
This page automatically checks your system for suitability Uniform Server is 100% compatible hence, all entries will be green for go. Click on next to continue.
This page automatically checks your system for suitability Uniform Server is 100% compatible hence, all entries will be green for go. Click on next to continue.


"If any of these items are highlighted in red then please take actions to correct them. Failure to do so could lead to your Joomla installation not functioning correctly."
&quot;If any of these items are highlighted in red then please take actions to correct them. Failure to do so could lead to your Joomla installation not functioning correctly.&quot;


{|style="background:#f8f8f8"
{|style=&quot;background:#f8f8f8&quot;
|-
|-
|PHP version >= 4.1.0||style="color:#00ff00;font-weight:bold"|Yes
|PHP version &gt;= 4.1.0||style=&quot;color:#00ff00;font-weight:bold&quot;|Yes
|-
|-
|<nowiki>-</nowiki> zlib compression support||style="color:#00ff00;font-weight:bold"|Available
|&lt;nowiki&gt;-&lt;/nowiki&gt; zlib compression support||style=&quot;color:#00ff00;font-weight:bold&quot;|Available
|-
|-
|<nowiki>-</nowiki> XML support||style="color:#00ff00;font-weight:bold"|Available
|&lt;nowiki&gt;-&lt;/nowiki&gt; XML support||style=&quot;color:#00ff00;font-weight:bold&quot;|Available
|-
|-
|<nowiki>-</nowiki> MySQL support||style="color:#00ff00;font-weight:bold"|Available
|&lt;nowiki&gt;-&lt;/nowiki&gt; MySQL support||style=&quot;color:#00ff00;font-weight:bold&quot;|Available
|-
|-
|configuration.php||style="color:#00ff00;font-weight:bold"|Writeable
|configuration.php||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-
|-
|Session save path||style="color:#00ff00;font-weight:bold"|Writeable
|Session save path||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-
|-
|'''/tmp'''
|'''/tmp'''
|}
|}


"These settings are recommended for PHP in order to ensure full compatibility with Joomla.
&quot;These settings are recommended for PHP in order to ensure full compatibility with Joomla.
However, Joomla will still operate if your settings do not quite match the recommended"
However, Joomla will still operate if your settings do not quite match the recommended&quot;


{|style="background:#f8f8f8"
{|style=&quot;background:#f8f8f8&quot;
|-
|-
!Directive
!Directive
Line 149: Line 157:
!Actual
!Actual
|-
|-
|Safe Mode:||OFF:||style="color:#00ff00;font-weight:bold"|OFF
|Safe Mode:||OFF:||style=&quot;color:#00ff00;font-weight:bold&quot;|OFF
|- 
|- 
|Display Errors:||ON:||style="color:#00ff00;font-weight:bold"|ON
|Display Errors:||ON:||style=&quot;color:#00ff00;font-weight:bold&quot;|ON
|-
|-
|File Uploads:||ON:||style="color:#00ff00;font-weight:bold"|ON
|File Uploads:||ON:||style=&quot;color:#00ff00;font-weight:bold&quot;|ON
|-
|-
|Magic Quotes GPC:||ON:||style="color:#00ff00;font-weight:bold"|ON
|Magic Quotes GPC:||ON:||style=&quot;color:#00ff00;font-weight:bold&quot;|ON
|-
|-
|Magic Quotes Runtime:||OFF:||style="color:#00ff00;font-weight:bold"|OFF
|Magic Quotes Runtime:||OFF:||style=&quot;color:#00ff00;font-weight:bold&quot;|OFF
|-
|-
|Register Globals:||OFF:||style="color:#00ff00;font-weight:bold"|OFF
|Register Globals:||OFF:||style=&quot;color:#00ff00;font-weight:bold&quot;|OFF
|-
|-
|Output Buffering:||OFF:||style="color:#00ff00;font-weight:bold"|OFF
|Output Buffering:||OFF:||style=&quot;color:#00ff00;font-weight:bold&quot;|OFF
|-
|-
|Session auto start:||OFF:||style="color:#00ff00;font-weight:bold"|OFF
|Session auto start:||OFF:||style=&quot;color:#00ff00;font-weight:bold&quot;|OFF
|}
|}


"In order for Joomla to function correctly it needs to be able to access or write to certain files or directories. If you see "Unwriteable" you need to change the permissions on the file or directory to allow Joomla to write to it. "
&quot;In order for Joomla to function correctly it needs to be able to access or write to certain files or directories. If you see &quot;Unwriteable&quot; you need to change the permissions on the file or directory to allow Joomla to write to it. &quot;


{|style="background:#f8f8f8"
{|style=&quot;background:#f8f8f8&quot;
|- 
|- 
|administrator/backups/||style="color:#00ff00;font-weight:bold"|Writeable
|administrator/backups/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|administrator/components/||style="color:#00ff00;font-weight:bold"|Writeable
|administrator/components/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|administrator/modules/||style="color:#00ff00;font-weight:bold"|Writeable
|administrator/modules/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|administrator/templates/||style="color:#00ff00;font-weight:bold"|Writeable
|administrator/templates/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|cache/||style="color:#00ff00;font-weight:bold"|Writeable
|cache/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|components/||style="color:#00ff00;font-weight:bold"|Writeable
|components/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|images/||style="color:#00ff00;font-weight:bold"|Writeable
|images/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|images/banners/||style="color:#00ff00;font-weight:bold"|Writeable
|images/banners/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|images/stories/||style="color:#00ff00;font-weight:bold"|Writeable
|images/stories/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|language/||style="color:#00ff00;font-weight:bold"|Writeable
|language/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|mambots/||style="color:#00ff00;font-weight:bold"|Writeable
|mambots/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|mambots/content/||style="color:#00ff00;font-weight:bold"|Writeable
|mambots/content/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|mambots/editors/||style="color:#00ff00;font-weight:bold"|Writeable
|mambots/editors/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|mambots/editors-xtd/||style="color:#00ff00;font-weight:bold"|Writeable
|mambots/editors-xtd/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|mambots/search/||style="color:#00ff00;font-weight:bold"|Writeable
|mambots/search/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|mambots/system/||style="color:#00ff00;font-weight:bold"|Writeable
|mambots/system/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|media/||style="color:#00ff00;font-weight:bold"|Writeable
|media/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|-  
|-  
|modules/||style="color:#00ff00;font-weight:bold"|Writeable
|modules/||style=&quot;color:#00ff00;font-weight:bold&quot;|Writeable
|}
|}


Line 214: Line 222:
The MySQL database configuration is straightforward I have highlighted the values that need changing or adding. Do change the default root password especially before going live.
The MySQL database configuration is straightforward I have highlighted the values that need changing or adding. Do change the default root password especially before going live.


{|cellpadding="4"
{|cellpadding=&quot;4&quot;
|-style="background:#f0f0f0;"
|-style=&quot;background:#f0f0f0;&quot;
!Field Name
!Field Name
!Value
!Value
!Comment
!Comment
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Host Name||'''localhost'''||This is usually 'localhost'
|Host Name||'''localhost'''||This is usually 'localhost'
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|MySQL User Name||'''root'''||Either something as 'root' or a username given by the hoster
|MySQL User Name||'''root'''||Either something as 'root' or a username given by the hoster
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|MySQL Password||'''root'''||For site security using a password for the mysql account is mandatory '''Check [[New Users: Security#Security Checklist |this page]] and use the password you set for user root'''.
|MySQL Password||'''root'''||For site security using a password for the mysql account is mandatory '''Check [[New Users: Security#Security Checklist |this page]] and use the password you set for user root'''.
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|MySQL Database Name||'''joomla'''||Some hosts allow only a certain DB name per site. Use table prefix in this case for distinct Joomla sites.
|MySQL Database Name||'''joomla'''||Some hosts allow only a certain DB name per site. Use table prefix in this case for distinct Joomla sites.
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|MySQL Table Prefix||jos_ ||
|MySQL Table Prefix||jos_ ||
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Drop Existing Tables||leave&nbsp;unchecked||  
|Drop Existing Tables||leave&amp;nbsp;unchecked||  
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Backup Old Tables||leave unchecked||
|Backup Old Tables||leave unchecked||
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Install Sample Data||checked||gives you a chance to experiment
|Install Sample Data||checked||gives you a chance to experiment
|}
|}
Line 242: Line 250:


== step 2 - Enter the name of your Joomla site ==
== step 2 - Enter the name of your Joomla site ==
"Type in the name for your Joomla site. This name is used in email messages so make it something meaningful."
&quot;Type in the name for your Joomla site. This name is used in email messages so make it something meaningful.&quot;


I have used '''MPG International'''
I have used '''MPG International'''
Line 248: Line 256:
'''''[[#top | Top]]'''''
'''''[[#top | Top]]'''''
== step3 - Confirm ==
== step3 - Confirm ==
"Confirm the site URL, path, admin e-mail and file/directory chmods"
&quot;Confirm the site URL, path, admin e-mail and file/directory chmods&quot;


Confirm is slightly misleading! You do need to enter the admin e-mail address other values and selections can remain as shown. However, unless you like the admin password change it to something you can remember.
Confirm is slightly misleading! You do need to enter the admin e-mail address other values and selections can remain as shown. However, unless you like the admin password change it to something you can remember.


{|
{|
|-style="background:#f0f0f0;"
|-style=&quot;background:#f0f0f0;&quot;
!Field Name
!Field Name
!Value
!Value
!Comment
!Comment
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|URL||<nowiki>http://localhost/joomla</nowiki> ||
|URL||&lt;nowiki&gt;http://localhost/joomla&lt;/nowiki&gt; ||
|-style="background:#f8f8f8;"  
|-style=&quot;background:#f8f8f8;&quot;  
|Path||<nowiki>W:\www\joomla</nowiki>||  
|Path||&lt;nowiki&gt;W:\www\joomla&lt;/nowiki&gt;||  
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Your E-mail||'''xxx@fred.com'''||Real email
|Your E-mail||'''xxx@fred.com'''||Real email
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Admin password ||'''9gsPipfw'''||Change this now or after installation
|Admin password ||'''9gsPipfw'''||Change this now or after installation
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Dont CHMOD files (use server defaults)||Selected||
|Dont CHMOD files (use server defaults)||Selected||
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Dont CHMOD directories (use server defaults)|| Selected||
|Dont CHMOD directories (use server defaults)|| Selected||
|}
|}


== step4 - Joomla is installed just delete installation folder ==
== step4 - Joomla is installed just delete installation folder ==
"Congratulations! Joomla is installed"
&quot;Congratulations! Joomla is installed&quot;


Click the "View Site" button to start Joomla site or "Administration" to take you to administrator login.
Click the &quot;View Site&quot; button to start Joomla site or &quot;Administration&quot; to take you to administrator login.


{|cellpadding="4" cellspacing="1" style="background:#777777;"
{|cellpadding=&quot;4&quot; cellspacing=&quot;1&quot; style=&quot;background:#777777;&quot;
|-style="background:#f0f0f0;"
|-style=&quot;background:#f0f0f0;&quot;
!Field Name
!Field Name
!Value
!Value
!Comment
!Comment
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|User Name:||'''Admin'''||
|User Name:||'''Admin'''||
|-style="background:#f8f8f8;"
|-style=&quot;background:#f8f8f8;&quot;
|Password:||'''9gsPipfw'''||You can change this from admin
|Password:||'''9gsPipfw'''||You can change this from admin
|}
|}




{|width="600"
{|width=&quot;600&quot;
|-
|-
|valign="top"|
|valign=&quot;top&quot;|
"For your security please completely '''remove''' the '''installation directory''' including all files and sub-folders - then refresh this page"
&quot;For your security please completely '''remove''' the '''installation directory''' including all files and sub-folders - then refresh this page&quot;




Line 305: Line 313:
'''''[[#top | Top]]'''''
'''''[[#top | Top]]'''''
== Running Joomla ==
== Running Joomla ==
To start Joomla type '''<nowiki>http://localhost/joomla/</nowiki>''' into your browser address bar the index page will open.
To start Joomla type '''&lt;nowiki&gt;http://localhost/joomla/&lt;/nowiki&gt;''' into your browser address bar the index page will open.


=== Change Admin Password ===
=== Change Admin Password ===
{|
{|
|-
|-
|width="442" valign="top"|
|width=&quot;442&quot; valign=&quot;top&quot;|
If you need to change the admin password first login using the above name and password. Click on the administrator link (Index page left menu) to login into the admin account. Enter name ('''admin''') and password ('''9gsPipfw''') or the one you set in step3  
If you need to change the admin password first login using the above name and password. Click on the administrator link (Index page left menu) to login into the admin account. Enter name ('''admin''') and password ('''9gsPipfw''') or the one you set in step3  


Line 318: Line 326:


[[Image:Uc_joomla_install_4.gif]]
[[Image:Uc_joomla_install_4.gif]]
|width="10"|
|width=&quot;10&quot;|
|
|
&nbsp;
&amp;nbsp;
|width="306"|
|width=&quot;306&quot;|
'''User details''' as shown. Note this is where you can also change the email address.
'''User details''' as shown. Note this is where you can also change the email address.


Line 335: Line 343:


=== Public server ===
=== Public server ===
To check your servers are enabled for on line operation open the file '''.htaccess''' in folder '''www''' (<nowiki>*\Uniform Server\udrive\www</nowiki>) and make sure these three lines are commented out:
To check your servers are enabled for on line operation open the file '''.htaccess''' in folder '''www''' (&lt;nowiki&gt;*\Uniform Server\udrive\www&lt;/nowiki&gt;) and make sure these three lines are commented out:


<pre>
&lt;pre&gt;
Order Deny,Allow
Order Deny,Allow
Deny from all
Deny from all
Allow from 127.0.0.1
Allow from 127.0.0.1
</pre>
&lt;/pre&gt;
As shown below:
As shown below:
<pre>
&lt;pre&gt;
# This file provides security to the server limiting access to the localhost only.
# This file provides security to the server limiting access to the localhost only.
# Comment to deactivate.
# Comment to deactivate.
Line 350: Line 358:
#Deny from all
#Deny from all
#Allow from 127.0.0.1
#Allow from 127.0.0.1
</pre>
&lt;/pre&gt;


=== Internet Access ===
=== Internet Access ===
Line 362: Line 370:
If the above does not work and you are having problems with links (they display '''localhost''' in their address) you will need to change the Joomla configuration file:
If the above does not work and you are having problems with links (they display '''localhost''' in their address) you will need to change the Joomla configuration file:


{| cellpadding="8" cellspacing="1" style="background:#000000;"
{| cellpadding=&quot;8&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000;&quot;
|style="background:#f5f5f5;"|
|style=&quot;background:#f5f5f5;&quot;|
# Open the file '''configuration.php''' located in folder '''<nowiki>*\Uniform Server\udrive\www\joomla</nowiki>'''
# Open the file '''configuration.php''' located in folder '''&lt;nowiki&gt;*\Uniform Server\udrive\www\joomla&lt;/nowiki&gt;'''
# '''Locate''' the line:<br>$mosConfig_live_site = <nowiki>'http://localhost/joomla'</nowiki>;<br>'''''Change it to'':'''<br>$mosConfig_live_site = '''<nowiki>'http://www.yourlivesite.com/joomla'</nowiki>;'''
# '''Locate''' the line:&lt;br&gt;$mosConfig_live_site = &lt;nowiki&gt;'http://localhost/joomla'&lt;/nowiki&gt;;&lt;br&gt;'''''Change it to'':'''&lt;br&gt;$mosConfig_live_site = '''&lt;nowiki&gt;'http://www.yourlivesite.com/joomla'&lt;/nowiki&gt;;'''
|}
|}


Line 372: Line 380:
The above installation was purely for local testing or to put it online, however it is easy to change the default installation to run on a local network.
The above installation was purely for local testing or to put it online, however it is easy to change the default installation to run on a local network.


{| cellpadding="8" cellspacing="1" style="background:#000000;"
{| cellpadding=&quot;8&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000;&quot;
|style="background:#f5f5f5;"|
|style=&quot;background:#f5f5f5;&quot;|
# Open the file '''configuration.php''' located in folder '''<nowiki>*\Uniform Server\udrive\www\joomla</nowiki>'''
# Open the file '''configuration.php''' located in folder '''&lt;nowiki&gt;*\Uniform Server\udrive\www\joomla&lt;/nowiki&gt;'''
#Locate the line (tenth line):<br>$mosConfig_live_site = <nowiki>'http://localhost/joomla'</nowiki>;<br>'''''Change it to this'':'''<br>$mosConfig_live_site = <nowiki>'http:</nowiki>//'''your machines IP number'''/joomla';<br>for example: $mosConfig_live_site = <nowiki>'http:</nowiki>//'''192.168.1.078'''/joomla';
#Locate the line (tenth line):&lt;br&gt;$mosConfig_live_site = &lt;nowiki&gt;'http://localhost/joomla'&lt;/nowiki&gt;;&lt;br&gt;'''''Change it to this'':'''&lt;br&gt;$mosConfig_live_site = &lt;nowiki&gt;'http:&lt;/nowiki&gt;//'''your machines IP number'''/joomla';&lt;br&gt;for example: $mosConfig_live_site = &lt;nowiki&gt;'http:&lt;/nowiki&gt;//'''192.168.1.078'''/joomla';
|}
|}


The file looks similar to this, depending on your own installation will vary slightly however it is that last line shown you need to change.
The file looks similar to this, depending on your own installation will vary slightly however it is that last line shown you need to change.
<pre>
&lt;pre&gt;
<?php
&lt;?php
$mosConfig_offline = '0';
$mosConfig_offline = '0';
$mosConfig_host = 'localhost';
$mosConfig_host = 'localhost';
Line 390: Line 398:
$mosConfig_absolute_path = 'W:/www/joomla';
$mosConfig_absolute_path = 'W:/www/joomla';
$mosConfig_live_site = 'http://192.168.1.078/joomla';
$mosConfig_live_site = 'http://192.168.1.078/joomla';
</pre>
&lt;/pre&gt;


'''''[[#top | Top]]'''''
'''''[[#top | Top]]'''''
Line 396: Line 404:
Note sure what your IP address is, use '''ipconfig/all''' to check it as follows:
Note sure what your IP address is, use '''ipconfig/all''' to check it as follows:


'''start''' > '''run''', in the pop-up type in '''cmd''' and then '''OK'''
'''start''' &gt; '''run''', in the pop-up type in '''cmd''' and then '''OK'''


In the dos window that appears '''type''' in '''ipconfig/all''' and press return
In the dos window that appears '''type''' in '''ipconfig/all''' and press return
Line 402: Line 410:
Scroll down the list of information until you find this section:
Scroll down the list of information until you find this section:


{| cellpadding="8" cellspacing="1" style="background:#000000;"
{| cellpadding=&quot;8&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000;&quot;
|style="background:#f5f5f5;"|
|style=&quot;background:#f5f5f5;&quot;|
'''Ethernet adapter''' Local Area Connection:<br>
'''Ethernet adapter''' Local Area Connection:&lt;br&gt;


Connection-specific DNS Suffix . :<br>
Connection-specific DNS Suffix . :&lt;br&gt;
Description . . . . . . . . . . . : Broadcom #######<br>
Description . . . . . . . . . . . : Broadcom #######&lt;br&gt;
Physical Address. . . . . . . . . : ##-##-##-##-##-##<br>
Physical Address. . . . . . . . . : ##-##-##-##-##-##&lt;br&gt;
Dhcp Enabled. . . . . . . . . . . : No<br>
Dhcp Enabled. . . . . . . . . . . : No&lt;br&gt;
IP Address. . . . . . . . . . . . : '''192.168.1.078'''<br>
IP Address. . . . . . . . . . . . : '''192.168.1.078'''&lt;br&gt;
Subnet Mask . . . . . . . . . . . : 255.255.255.0<br>
Subnet Mask . . . . . . . . . . . : 255.255.255.0&lt;br&gt;
Default Gateway . . . . . . . . . : 192.168.1.1<br>
Default Gateway . . . . . . . . . : 192.168.1.1&lt;br&gt;
DNS Servers . . . . . . . . . . . : ###.##.###.## ###.##.###.##
DNS Servers . . . . . . . . . . . : ###.##.###.## ###.##.###.##
|}
|}


To view Joomla type '''<nowiki>http://192.168.1.078/joomla/</nowiki>''' into any of your local network PCs.
To view Joomla type '''&lt;nowiki&gt;http://192.168.1.078/joomla/&lt;/nowiki&gt;''' into any of your local network PCs.




Line 427: Line 435:
At the end of this file add the line as shown bold:
At the end of this file add the line as shown bold:


{| cellpadding="2" cellspacing="1" style="background:#000000;"
{| cellpadding=&quot;2&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000;&quot;
|- style="background:#e8e8e8;"
|- style=&quot;background:#e8e8e8;&quot;
!&nbsp; File C:\WINDOWS\system32\drivers\etc\hosts&nbsp;
!&amp;nbsp; File C:\WINDOWS\system32\drivers\etc\hosts&amp;nbsp;
|- style="background:#f5f5f5;"
|- style=&quot;background:#f5f5f5;&quot;
|
|
<nowiki>#</nowiki> For example:<br>
&lt;nowiki&gt;#&lt;/nowiki&gt; For example:&lt;br&gt;
<nowiki>#</nowiki><br>
&lt;nowiki&gt;#&lt;/nowiki&gt;&lt;br&gt;
<nowiki>#</nowiki> 102.54.94.97 rhino.acme.com # source server<br>
&lt;nowiki&gt;#&lt;/nowiki&gt; 102.54.94.97 rhino.acme.com # source server&lt;br&gt;
<nowiki>#</nowiki> 38.25.63.10 x.acme.com # x client host
&lt;nowiki&gt;#&lt;/nowiki&gt; 38.25.63.10 x.acme.com # x client host


127.0.0.1 localhost<br>
127.0.0.1 localhost&lt;br&gt;
'''192.168.1.078 joomla'''
'''192.168.1.078 joomla'''
|}
|}


To view Joomla from any of your network PCs type the following into a browser: '''<nowiki>http://joomla/</nowiki>'''
To view Joomla from any of your network PCs type the following into a browser: '''&lt;nowiki&gt;http://joomla/&lt;/nowiki&gt;'''


== Problems encountered ==
== Problems encountered ==

Revision as of 01:08, 24 November 2010



UNDER COSTRUCTION, PLEASE SEE THIS POST IN RESERVE COPY


CLICK HERE


<span id="top"></span> <div style="padding:0;margin:0; border-bottom:3px inset #000000">

MPG UniCenter

How to install Joomla on Uniform Server 3.5-Apollo.

</div>

Joomla is a powerful Open Source Content Management Systems that is easy to install on Uniform Server 3.5-Apollo. After installation, a minor tweak is required to make it portable you can then run it from a memory stick on any designated drive.

If you have never used Joomla then take this opportunity to have a play and enjoy. It will take several hours to master I think well worth the effort to produce an easily up-dateable web site. Joomla on UniServer is a great addition to any home web server.

Pre-Installation

Download files and and copy to their correct location.

1&nbsp;

To begin, I have assumed you have downloaded Uniform Server 3.5-Apollo from SourceForge and unzipped it to your computer.<br> If you intend going live check out this page first security check list.

Note: You will need a database user name and password in this tutorial I use the Uniform defaults name=root password=root.

  • Database user name root - No need to change this
  • Database password root - Before installing WordPress I recommend changing this using apanel

2&nbsp;

A) Next you need to download Joomla 1.0.13 (or newer version) from here follow the download links and choose the full package. Save to a convenient folder for example c:\joomla_temp

3&nbsp;

B) Extract this file to the current folder (right click on the file to be extracted wordpress-2.3.1.zip and select Extract All... click Next and Next again).

This creates a new folder named: Joomla_1.0.13-Stable-Full_Package containing all the required files.

4&nbsp;

C) Copy folder Joomla_1.0.13-Stable-Full_Package and all its contents to Uniform Server's root folder <nowiki>*</nowiki>\Uniform Server\udrive\www

5&nbsp;

D) Rename the folder to joomla (or to a name you prefer)

Top

Installation - Create a Joomla Database

Creating the WordPress database is straight forward, tables are automatically inserted during installation

1&nbsp;

Start Uniform Server (Double click on Server_Start.bat in folder Uniform Server).

2&nbsp;

From apanel (displayed in your browser when the server starts) click on the phpMyAdmin link. (left menu under tools) Note you can always return to apanel by typing <nowiki>http://localhost/apanel/</nowiki> into your browser address bar.

3&nbsp;

A) We want to create a new database. Name it joomla (or something easy to remember)

4&nbsp;

B) Click on Create to create the database

Top

PHP register_globals

For security Joomla requires that register_globals be switched off.

  • In apanel select PHP Configuration (left menu)
  • Locate Register globals text box and change from On to Off
  • Click save.
  • The servers need restarting for the changes to take effect restart servers.

Top

Installation

To start the Joomla installation process type <nowiki>http://localhost/joomla/</nowiki> into your browser and follow the instructions.

There are six pages to the process as follows:

  • pre-installation check (Automatically checks your system for suitability).
  • license (If you like a read then do so otherwise click on next.)
  • step 1 (MySQL database configuration)
  • step 2 (Enter the name of your Joomla site)
  • step 3 (Confirm the site URL, path, admin e-mail and file/directory chmods)
  • step 4 (Joomla is installed just delete installation folder)

For completeness, I have reproduced the steps and added a few extra notes.

Top

pre-installation check

This page automatically checks your system for suitability Uniform Server is 100% compatible hence, all entries will be green for go. Click on next to continue.

"If any of these items are highlighted in red then please take actions to correct them. Failure to do so could lead to your Joomla installation not functioning correctly."

PHP version >= 4.1.0 Yes
<nowiki>-</nowiki> zlib compression support Available
<nowiki>-</nowiki> XML support Available
<nowiki>-</nowiki> MySQL support Available
configuration.php Writeable
Session save path Writeable
/tmp

"These settings are recommended for PHP in order to ensure full compatibility with Joomla. However, Joomla will still operate if your settings do not quite match the recommended"

Directive Recommended Actual
Safe Mode: OFF: OFF
Display Errors: ON: ON
File Uploads: ON: ON
Magic Quotes GPC: ON: ON
Magic Quotes Runtime: OFF: OFF
Register Globals: OFF: OFF
Output Buffering: OFF: OFF
Session auto start: OFF: OFF

"In order for Joomla to function correctly it needs to be able to access or write to certain files or directories. If you see "Unwriteable" you need to change the permissions on the file or directory to allow Joomla to write to it. "

administrator/backups/ Writeable
administrator/components/ Writeable
administrator/modules/ Writeable
administrator/templates/ Writeable
cache/ Writeable
components/ Writeable
images/ Writeable
images/banners/ Writeable
images/stories/ Writeable
language/ Writeable
mambots/ Writeable
mambots/content/ Writeable
mambots/editors/ Writeable
mambots/editors-xtd/ Writeable
mambots/search/ Writeable
mambots/system/ Writeable
media/ Writeable
modules/ Writeable

Top

License

Click Next (top right) read the license if you like. Click next to continue.

step 1 - MySQL database configuration

The MySQL database configuration is straightforward I have highlighted the values that need changing or adding. Do change the default root password especially before going live.

Field Name Value Comment
Host Name localhost This is usually 'localhost'
MySQL User Name root Either something as 'root' or a username given by the hoster
MySQL Password root For site security using a password for the mysql account is mandatory Check this page and use the password you set for user root.
MySQL Database Name joomla Some hosts allow only a certain DB name per site. Use table prefix in this case for distinct Joomla sites.
MySQL Table Prefix jos_
Drop Existing Tables leave&nbsp;unchecked
Backup Old Tables leave unchecked
Install Sample Data checked gives you a chance to experiment

A confirmation pop-up is displayed Clik OK

Top

step 2 - Enter the name of your Joomla site

"Type in the name for your Joomla site. This name is used in email messages so make it something meaningful."

I have used MPG International

Top

step3 - Confirm

"Confirm the site URL, path, admin e-mail and file/directory chmods"

Confirm is slightly misleading! You do need to enter the admin e-mail address other values and selections can remain as shown. However, unless you like the admin password change it to something you can remember.

Field Name Value Comment
URL <nowiki>http://localhost/joomla</nowiki>
Path <nowiki>W:\www\joomla</nowiki>
Your E-mail xxx@fred.com Real email
Admin password 9gsPipfw Change this now or after installation
Dont CHMOD files (use server defaults) Selected
Dont CHMOD directories (use server defaults) Selected

step4 - Joomla is installed just delete installation folder

"Congratulations! Joomla is installed"

Click the "View Site" button to start Joomla site or "Administration" to take you to administrator login.

Field Name Value Comment
User Name: Admin
Password: 9gsPipfw You can change this from admin


"For your security please completely remove the installation directory including all files and sub-folders - then refresh this page"


Note:

You will be forgiven if you believe that the message is for information only, ignore it and you will not be able to access Joomla.

It forces security makes lazy people like me take notice.

Top

Running Joomla

To start Joomla type <nowiki>http://localhost/joomla/</nowiki> into your browser address bar the index page will open.

Change Admin Password

If you need to change the admin password first login using the above name and password. Click on the administrator link (Index page left menu) to login into the admin account. Enter name (admin) and password (9gsPipfw) or the one you set in step3

Details:

A) Click on the adminlink. This takes you to the user details page,allowing you to create a new password.

&nbsp;

User details as shown. Note this is where you can also change the email address.

Top

Going Live

The above installation allows you to test Joomla and become familiar with its operation. Putting it online requires no special work.

Joomla is effectively online when your servers are connected to the Internet as a public server'

Public server

To check your servers are enabled for on line operation open the file .htaccess in folder www (<nowiki>*\Uniform Server\udrive\www</nowiki>) and make sure these three lines are commented out:

<pre> Order Deny,Allow Deny from all Allow from 127.0.0.1 </pre> As shown below: <pre>

  1. This file provides security to the server limiting access to the localhost only.
  2. Comment to deactivate.
  1. Order Deny,Allow
  2. Deny from all
  3. Allow from 127.0.0.1

</pre>

Internet Access

Type your domain into a browser and append the folder joomla to it.

For example suppose your domain is www.xxx.gotdns.com to access your Joomla site type this into your browser:

www.xxx.gotdns.com/joomla/

Problems

If the above does not work and you are having problems with links (they display localhost in their address) you will need to change the Joomla configuration file:

  1. Open the file configuration.php located in folder <nowiki>*\Uniform Server\udrive\www\joomla</nowiki>
  2. Locate the line:<br>$mosConfig_live_site = <nowiki>'http://localhost/joomla'</nowiki>;<br>Change it to:<br>$mosConfig_live_site = <nowiki>'http://www.yourlivesite.com/joomla'</nowiki>;

Top

Installation to run on a local network

The above installation was purely for local testing or to put it online, however it is easy to change the default installation to run on a local network.

  1. Open the file configuration.php located in folder <nowiki>*\Uniform Server\udrive\www\joomla</nowiki>
  2. Locate the line (tenth line):<br>$mosConfig_live_site = <nowiki>'http://localhost/joomla'</nowiki>;<br>Change it to this:<br>$mosConfig_live_site = <nowiki>'http:</nowiki>//your machines IP number/joomla';<br>for example: $mosConfig_live_site = <nowiki>'http:</nowiki>//192.168.1.078/joomla';

The file looks similar to this, depending on your own installation will vary slightly however it is that last line shown you need to change. <pre> <?php $mosConfig_offline = '0'; $mosConfig_host = 'localhost'; $mosConfig_user = 'root'; $mosConfig_password = 'root'; $mosConfig_db = 'joomla'; $mosConfig_dbprefix = 'jos_'; $mosConfig_lang = 'english'; $mosConfig_absolute_path = 'W:/www/joomla'; $mosConfig_live_site = 'http://192.168.1.078/joomla'; </pre>

Top

IP Address

Note sure what your IP address is, use ipconfig/all to check it as follows:

start > run, in the pop-up type in cmd and then OK

In the dos window that appears type in ipconfig/all and press return

Scroll down the list of information until you find this section:

Ethernet adapter Local Area Connection:<br>

Connection-specific DNS Suffix . :<br> Description . . . . . . . . . . . : Broadcom #######<br> Physical Address. . . . . . . . . : ##-##-##-##-##-##<br> Dhcp Enabled. . . . . . . . . . . : No<br> IP Address. . . . . . . . . . . . : 192.168.1.078<br> Subnet Mask . . . . . . . . . . . : 255.255.255.0<br> Default Gateway . . . . . . . . . : 192.168.1.1<br> DNS Servers . . . . . . . . . . . : ###.##.###.## ###.##.###.##

To view Joomla type <nowiki>http://192.168.1.078/joomla/</nowiki> into any of your local network PCs.


Number pain! If like me you find it a pain to remember numbers map the IP to a real name.

On each of your network PC's open the host (host details) file and map the IP to a name for example:

On an XP machine the hosts file is located in the following folder: C:\WINDOWS\system32\drivers\etc

At the end of this file add the line as shown bold:

&nbsp; File C:\WINDOWS\system32\drivers\etc\hosts&nbsp;

<nowiki>#</nowiki> For example:<br> <nowiki>#</nowiki><br> <nowiki>#</nowiki> 102.54.94.97 rhino.acme.com # source server<br> <nowiki>#</nowiki> 38.25.63.10 x.acme.com # x client host

127.0.0.1 localhost<br> 192.168.1.078 joomla

To view Joomla from any of your network PCs type the following into a browser: <nowiki>http://joomla/</nowiki>

Problems encountered

None

Portability

Once Joomla is installed, it becomes a fixed installation running on the drive letter you selected for UniServer (default drive W).

This may be inconvenient I cover a solution to portability on the next page.

Top


Ric