Joomla 1.5 Installation Problems and Tips.

Need help installing Joomla! 1.5? For all Joomla! 1.5 installation issues please use this forum.

Moderator: General Support Moderators

Forum rules
Forum Rules
Absolute Beginner's Guide to Joomla! <-- please read before posting, this means YOU.
Forum Post Assistant - If you are serious about wanting help, you will use this tool to help you post.
dpminusa
Joomla! Guru
Joomla! Guru
Posts: 907
Joined: Sun Dec 21, 2008 6:35 pm
Location: USA

Joomla 1.5 Installation Problems and Tips.

Postby dpminusa » Mon Mar 02, 2009 12:48 pm

This article's only potential value is saving you some time in getting your Joomla site up. I hope this helps you.

NOTE: For an companion illustrated Installation Aid look here: viewtopic.php?f=429&t=376407. That would be a place to start before using the notes here. If your installation fails, come back and look at the steps in more detail here.

Your Joomla 1.5 installation is designed to be very easy for you. It can often be completed in less that 15 minutes.

This article outlines common problems that can occur with running the 1.5 installer with Apache 2 and MySQL. It concentrates on the Linux remote server but applies to local installs also. It suggests some possible resources and techniques for dealing with them.

There are some resource links at the end of the article for related topics.

If you are installing on Linux or another *NIX class server your may need an understanding of file and directory permissions. There is a good article on this by Brad Baker at: http://www.joomlatutorials.com/faq/view ... on/60.html.

Windows does not use permissions.

If you are on a shared host some of the defaults listed may be different. If you have multiple webserver domains already, there may be additional considerations. See the Joomla Forum for the topic virtualhost.

If your server uses mod CGI instead of running PHP as an Apache process (most common) there may be additional considerations. One major difference is that .htaccess is not available. mod CGI is sometimes selected because of the security advantages. This article has some references:
http://blog.rochen.com/2008/09/joomla-s ... -now-know/

System Configuration/Setup Problems.
1. You need a functioning webserver. The common choice is Apache. Version 1.x or Version 2.x. If you have a choice, use 2.x. This should have been installed as part of your XAMPP installation, MAMP installation, Linux Server installation, or other installation.

Make sure you know the location of your webserver's top-level html directory or server root. Joomla needs to be loaded there, or in a sub-directory, to be accessible. This is a directory path name, like the default /var/www/localhost/htdocs in Linux.

For XAMPP users, you may want to watch: http://www.veoh.com/collection/screenca ... 0A7Mnpe7z# . Ignore the commercial.

Try the webserver with your browser and make sure you can see its default home page. For example, http://localhost or http://127.0.0.1 works on most local hosts. If your server is remote you should use the domain name you were assigned. For example, http://www.mydomain.com or http://186.100.100.200, use what your host provided. If this is OK go to point 2.

There may be a specific port number that is needed to reach the webserver. Webservers are setup to listen on specific ports for requests. The default for most servers is 80, this is what your browser will default to. If you have a local server, it may be in the range 8080 - 8889, to avoid conflicts with other servers. If you cannot reach the webserver with this test, make sure you have the correct webserver URL and port number.

The port number is appended to the domain in your URL with a colon. For example:
http://lcoalhost:8080.

If you cannot find a note in your installation instructions on port numbers, look in the Apache configuration file httpd.conf for the the Listen statement. For Linux users the default is in /etc/apache2. The port number should be listed. You can either append it to your URL when using the browser or change it to 80. If you change it make sure it will not conflict with other servers you are running.

There is documentation on Apache directives at: http://httpd.apache.org/docs/2.2/mod/directives.html. You will see Listen in the list.

If you more documentation on port numbers, there is a regulatory agency that lists all the port number assignments: http://www.iana.org/assignments/port-numbers. Look in the left column for your software type you suspect and across for the port number. This may provide some guidance. You will see that 8080 is an alternate for port 80 and 8089 - 8096 are unassigned, for example.

2. You need a functioning PHP language installation of 4.3.10 or newer with the defaults Joomla suggests. These are usually the PHP installation defaults. These can be viewed in the php.ini file. For Linux users the default is in /etc/php/apache2-php5.

Make sure your PHP is running. Use your browser to check this with the phpinfo() function. Most sites have a default script for this purpose. For example, http://localhost/phpinfo.php or php-info.php or a similar command for your configuration. If phpinfo does not produce a browser page with the PHP configuration details, you should troubleshoot this first.

It may be that your installation uses a different name for the phpinfo script, or one is not present. You can make your own with a text editor. Open notepad, or vi (or vim) on Linux and create this simple one line PHP script named phpinfo.php:

Code: Select all

<?php  phpinfo();  ?>


Then copy it to the document root of your webserver. Retest the URL with the browser again.
There is documentation at: http://us2.php.net/manual/en/index.php.

3. You need an empty, writable database for Joomla to create its tables and store your content. Make sure your user name has adequate permissions to create and write to new tables. The most common database is MySQL. It should have been installed for you with one of the methods mentioned above. To create a database for Joomla use an administration tool such as phpMyAdmin, also should have been installed with the database. Make sure to select the UTF-8 collating sequence to get the correct storage and retrieval from your database.

You will need the exact user name and password used to create the database during the installation. Make a note of them and the database name. If you do not have this information you cannot install Joomla. It does NOT create the database for you. There should be online documentation for the phpMyAdmin program at: http://www.phpmyadmin.net/home_page/docs.php.

There are other tools to use to create the database. In Linux your system may have webmin installed, for example. You can access it at port 10000, http://www.mysite.com:10000.

4. Download the latest Joomla stable release from http://www.joomla.org. Copy it to your webserver document root or a sub-directory of that path. Then unzip it. If there are any unzip errors, don't ignore them. Replace the download and try again.

5. You also need a blank, writable, file called configuration.php. If it is not totally empty is must not have more than 10 characters in it. The configuration.php-dist file is not a candidate. Just create a new file and copy it to the webserver document root or where you unzipped Joomla.

6. Check that your Apache webserver DirectoryIndex directive list contains index.php. It is best to make it the first entry. This is in your httpd.conf file at the location mentioned above. If this is missing you will not get the Joomla installer to start. Instead you will just get a list of the files in the directory, your default home page, or perhaps nothing. Point 1 above has a link to the Apache directives that include this.

You should be ready for your Joomla installation now.

To start the installation just browser to the location where you unzipped Joomla. If your DirectoryIndex is setup as above, and you use the correct URL (similar of the same as the Webserver test step above) the Joomla installation Language selection page should come up. If it does not, review the steps above, and make sure the browser address you are using is correct.

For example, http://localhost, or http://www.mysite.com, or http://www.mysite.com/joomla depending on your configuration.

Joomla Installer Problems.
The installer has a seven step sequence it leads you through. Let's look at each step for its potential challenges.

One finer point is that the installer uses 15 minute session timeouts. If you pause on an installer page for more than 15 minutes, you will get a cookie error. To recover click previous. You will have to start at step 1 again. There is nothing wrong with your browser setup, unless you have cookies disabled. This should have raised an error at the outset, anyway.

You can open another window while in the installer, and try to resolve problems and perform forgotten preparation. For example, creating the database or the configuration.php, write enabling configuration.php, or removing the installation directory at the end before launching the admin pages.

Step 1: Language Selection. There are over 30 language choices. If one of these is not your written language, you have a couple of choices. Have a friend help you with the installation who understands one of the languages listed. Use the Google translation tools to work with each page as you proceed. It may be able to translate to your written language.

There are only 7 or 8 pages to contend with. The translation page link is
http://translate.google.com/translate_t#

Step 2: Pre Installation Check. If there are any RED NO values these are best dealt with before proceeding. There are a couple of basic ways to to do this. You can edit your php.ini file at the location mentioned above, or add a statement to your .htaccess file. The former may be easier. The latter requires you edit htaccess.txt and rename it to .htaccess (note leading dot). Copy htaccess.txt to your local system for editing and back to the server, if necessary.

Code: Select all

For example ,
php_flag register_globals off

Turns off the Register Globals if they are on, using the .htaccess file 


The php.ini directives are documented at: http://us3.php.net/manual/en/ini.core.php.

The .htaccess statements are documented at: http://us3.php.net/manual/en/configuration.changes.php.

If you cannot make a blank, writable configuration.php, you can still complete the installation. There is a text box that will contain the configuration information for this file at the end of the installation. You need to paste this information to a file called configuration.php BEFORE leaving the installer.

Step 3: License. Should not be a issue unless you take more than 15 minutes to read it. If so, you will get a cookie error, as discussed above.

Step 4: Database Configuration. The database user name, password, and database name must be EXACTLY as in the previous section point 3. above, where the database was created. The installer will automatically preserve your existing tables, if this is a reinstall, as a bak_ set unless told to erase them. Note: backup has only one level. If you run the installer several times, and do not do your own backup, your backup tables may be empty.

Step 5: FTP Configuration. You can skip this step and still install Joomla. For Linux installations this is not recommended, unless you do not have the details requested. One of the first things you may want to do with your system is add some extensions that are not part of the installer procedure. The FTP layer is used for this. This step enables the use of this layer. The auto find and verify tools available are great to simplify setting up the FTP layer.

The FTP user name and password requested are not necessarily the same as your database. For Linux users, these should be the same as those used with your FTP client, when Joomla was uploaded to your server. When the values are entered, use the verify button check them. If they are correct the yes radio position will be set. Make sure the root path is your webserver document root.

Step 6: Site Configuration. You define the administrator and load sample data here. Joomla is much easier to learn with sample data. You should load this by CLCKING the button for it.

Pick a secure password. A simple rule of thumb is to use alternating upper and lower case letters and at least two numbers. A minimum length of eight is best. There is a nice site that will generate user passwords and .htaccess passwords at: http://tips-scripts.com/free.

When you define the site and administrator details make sure you are providing the site name that reaches your server. Most hosted sites will reach you with or without the leading www. node names, but not all.

Note that NO administrator name is requested. The default used is "admin". This is what you use to get logged into the administrator pages at first. Change it for better security on your first session.

The email address will be used in all the administration email generated by Joomla. Pick one that you want to be public.

Step 7: Finished. If you did not provide a writable configuration.php, look for the text box with the details to be copied to this file now. Your site cannot come up without a configuration.php.

Before you can use your new Joomla site you need to remove the installation directory. Joomla uses this and the configuration.php as flags to indicate your sites status.

If configuration.php is present and has more than 10 characters it assumed your site is installed and proceeds to try to load it. If the installation directory is found, it requests you remove it first. For example, if you are reinstalling you need to empty the configuration.php file before starting over, or you will get the remove installation directory message instead.

There are two options at the top of this page to use to proceed. Selecting one of these is intended. The admin option let's you go to the Joomla back-end and tune your settings. Exiting without either choice is not preferred. If you do this remember that the administrator pages are reached with:
http://www.mysite.com/administrator.

You may want to backup your configuration.php separate from the server root, as a precaution. If this file is lost, damaged, or hijacked you can restore it to the original. You may also want to double check it for errors and typos.

You will be tuning it for a while, from the global configuration in the administrator pages, so it will need to be writable. As soon as possible you should protect this file. It is one of the ways that hackers hijack your site. There are several ways to do this. The simplest is to set its permissions to 666, so that it is only readable. You can also use .htaccess to restrict it to you and/or your IP address, etc. Finally you can hide it in another directory and have Joomla reference it indirectly when it loads. See the security FAQ for details.

Hopefully you are up and enjoying your new Joomla site at this point.

Reinstalling Problems.
If you were not successful on your first installation attempt, or you decide to start over to get a fresh copy after experimenting, there is a simple procedure for this. You need to empty your configuration.php file and add your installation directory back to the site.

If you want to preserve any content you created, it is best to backup your database first with your phpMyAdmin or other software. Joomla will build a copy of your tables with prefix bak_ automatically, but this is a good precaution as well. If you restart more than once the data may be lost, otherwise. If you do not want the database Joomla will empty the tables for you automatically.

To restore your database you can use your phpMyAdmin tool, or MySQL from the command line. See this for procedures: http://video.google.com/videoplay?docid ... 6318372444, or: http://docs.joomla.org/Copying_a_Joomla_website.

If you have added extensions, that you want to preserve, this is a bit complicated. Joomla will write over the existing copies of its directories. This will prevent use of most of the extensions that were added after the last install. Some modules will still be usable but probably none of the plugins and components that were added.

Unfortunately you will need to remove these extensions manually by deleting the directories and files associated with them. The extension installer will NOT reinstall doing an automatic uninstall first. Since it does not know about the extensions you had in the last install, it will fail with an "ALREADY EXISTS" message. The best practice may be to backup your existing Joomla directory, or move it out of the way, and add the extensions back after the installation.

If you have any tweaks they will be lost by overwites. Back them up first.

Upgrade Problems.
Upgrades have a separate set of files and procedures to use. The upgrade files can be downloaded from the same loacations as he full release. A backup of the complete site before this procedure is a good practice.

Some guidelines are provided here: http://docs.joomla.org/Upgrading_1.5_fr ... 5x_version.

Once the new files are in place there may be a number of finer points to deal with. Your templates and extensions should not be assumed to be OK with the changes. There are several steps that should be checked, or you may waste a lot of time chasing phantoms.

1. Use the template manager to double check all of your menu assignments. Links can get broken. Assume this is almost like a new template install.
2. Visit your extension providers site and check the documentation and forums for any compatibility issues. Do the same on the Joomla Forum.
3. Consider running a series of tests on a duplicate site before bringing the upgraded site online.

In short the upgrade procedure does not handle all issues by itself. It has no knowledge of the specifics of your site, just the Joomla released software.

Administering Your Joomla System
There are many great articles on how to administer your system. Some of the most useful at first may be include the following.

1. http://docs.joomla.org/Beginners
2. http://docs.joomla.org/Category:FAQ
3. http://docs.joomla.org/How_do_you_choos ... ensions%3F
4. http://docs.joomla.org/How_do_you_recov ... assword%3F
5. http://docs.joomla.org/Installation_FAQs_Version_1.0
6. http://docs.joomla.org/Category:Security_Checklist
7. http://help.joomla.org/ghop/feb2008/task167/index.html
8. http://community.joomla.org/magazine/ar ... -data.html
9. https://www.opensourcesupportdesk.com/o ... os?catid=6
10. http://joomlaforbeginners.com/joomla-1. ... /index.php

Use the Joomla Forum to share an learn. There are over 100,000 members. Some of them will share your level of experience and concerns.

Customizing/Tuning Your New Joomla Site.
Out of the box, Joomla has a tremedous amount of value. You can now concentrate on making the site have the look and feel you wish, without as much coding to perform, or contract for. There may still be some tweaking to do. Some useful articles on this, perhaps, include the following.

1. http://docs.joomla.org/How_do_you_add_a ... osition%3F
2. http://docs.joomla.org/How_do_you_put_a ... article%3F
3. http://www.w3schools.com/html/default.asp
4. http://www.w3schools.com/css/default.asp
5. http://docs.joomla.org/Tutorial:Creating_a_submenu
6. http://docs.joomla.org/Template_FAQs
7. http://docs.joomla.org/Tutorial:Creatin ... Joomla_1.5
8. http://docs.joomla.org/Tutorial:More_on ... 21_modules
9. http://docs.joomla.org/How_to_create_a_content_plugin
10. http://docs.joomla.org/Setting_up_your_ ... evelopment

If this information has any value, if may be to save you time. I hope it helps you get a faster start.

Enjoy - dpminusa.

User avatar
dizzi
Joomla! Virtuoso
Joomla! Virtuoso
Posts: 3136
Joined: Fri Dec 21, 2007 9:36 pm
Location: Yorkshire, UK

Re: Joomla 1.5 Installation Problems and Tips.

Postby dizzi » Tue Mar 03, 2009 11:07 am

Top job m8! The sad thing though is that those who really need the information provided, will simply not read it.
Freedom of expression ... some may try to suppress it but they can never take it away ...
There is no problem a good miracle can't fix.

User avatar
Rochen
Joomla! Enthusiast
Joomla! Enthusiast
Posts: 142
Joined: Wed Aug 17, 2005 3:19 pm
Location: United Kingdom
Contact:

Re: Joomla 1.5 Installation Problems and Tips.

Postby Rochen » Tue Mar 03, 2009 11:19 am

Good post dpminusa! :)

Just to clarify one point though -
dpminusa wrote:If your server uses mod CGI instead of running PHP as an Apache process (most common) there may be additional considerations. One major difference is that .htaccess is not available. mod CGI is sometimes selected because of the security advantages. This article has some references:
http://blog.rochen.com/2008/09/joomla-s ... -now-know/
You can still use .htaccess files (e.g. for J! SEF) when PHP is running in CGI mode with su_php. The only difference is that if you want to change any PHP directives (e.g. upload_max_filesize) then this needs to be done through a separate php.ini file.

This is pretty simple to do and the user still has full control over PHP directives as they would via a .htaccess file. Having PHP running this way though gives a huge security benefit, particularly in a shared hosting environment.

- Chris
Chris Adams - CEO - Rochen Ltd.
http://www.rochen.com - Performance Joomla Hosting Solutions - Make your Joomla! install fly.
http://blog.rochen.com - Great security tips and more for Joomla!
Follow us on Twitter @rochenhost

dpminusa
Joomla! Guru
Joomla! Guru
Posts: 907
Joined: Sun Dec 21, 2008 6:35 pm
Location: USA

Re: Joomla 1.5 Installation Problems and Tips.

Postby dpminusa » Tue Mar 03, 2009 11:34 am

Thanks for the clarification Chris. You have several great articles that I have read on the Rochen Blogs.

dpminusa

tidusx
Joomla! Apprentice
Joomla! Apprentice
Posts: 15
Joined: Wed Feb 04, 2009 12:14 am

Re: Joomla 1.5 Installation Problems and Tips.

Postby tidusx » Wed Apr 22, 2009 12:45 am

Hi, great post.

I was wondering if I can re-name the Joomla install directory? I am assuming that renaming it would break file paths and what not, but if there is a way that would be great.

I'm trying to do this because I have a site on one host and would like to move it to another host that already has a Joomla powered site. The problem is that both Joomla install directories are named...joomla :P so if I do a backup and restore with joomla pack, it will mess everyting up...right?

so yea...let me know if this is possible. :D

Thanks!

User avatar
RussW
Joomla! Exemplar
Joomla! Exemplar
Posts: 9350
Joined: Sun Oct 22, 2006 4:42 am
Location: Sunshine Coast, Queensland, Australia
Contact:

Re: Joomla 1.5 Installation Problems and Tips.

Postby RussW » Wed Apr 22, 2009 1:20 am

Great stuff, nice compilation of a lot of information;

Minor suggestions/updates for your consideration;

Thank you for the considerable time and effort you have put in to produce this post.
Joomla! on the fabulous Sunshine Coast...
hotmango, web & print http://www.hotmango.me/
The Styleguyz https://www.thestyleguyz.com/

demonmind
Joomla! Fledgling
Joomla! Fledgling
Posts: 1
Joined: Wed Apr 22, 2009 8:50 am

Re: Joomla 1.5 Installation Problems and Tips.

Postby demonmind » Wed Apr 22, 2009 8:54 am

Hello!
I try to install Jomla and after i specify the database details and i press next i get the following screen.

Internal Server Error
The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator, postmaster@nifalb.com and inform them of the time the error occurred, and anything you might have done that may have caused the error.

More information about this error may be available in the server error log.

What should i do?

User avatar
RussW
Joomla! Exemplar
Joomla! Exemplar
Posts: 9350
Joined: Sun Oct 22, 2006 4:42 am
Location: Sunshine Coast, Queensland, Australia
Contact:

Re: Joomla 1.5 Installation Problems and Tips.

Postby RussW » Wed Apr 22, 2009 10:30 am

demonmind wrote:Hello!
I try to install Jomla and after i specify the database details and i press next i get the following screen.

Internal Server Error
The server encountered an internal error or misconfiguration and was unable to complete your request.

Please contact the server administrator, postmaster@nifalb.com and inform them of the time the error occurred, and anything you might have done that may have caused the error.

More information about this error may be available in the server error log.

What should i do?



How about;
- Try opening your own post in the instance and not hijacking an unrelated post.
- Read the stikies in the form
- Use the search function
- Describe the problem in more detail

Are you sure you entered the correct details for the database host and databse?
Joomla! on the fabulous Sunshine Coast...
hotmango, web & print http://www.hotmango.me/
The Styleguyz https://www.thestyleguyz.com/

tidusx
Joomla! Apprentice
Joomla! Apprentice
Posts: 15
Joined: Wed Feb 04, 2009 12:14 am

Re: Joomla 1.5 Installation Problems and Tips.

Postby tidusx » Wed Apr 22, 2009 4:12 pm

I already posting in this thread, but I think everyone mised it :(

I was wondering if I can re-name the Joomla install directory? I am assuming that renaming it would break file paths and what not, but if there is a way that would be great.

I'm trying to do this because I have a site on one host and would like to move it to another host that already has a Joomla powered site. The problem is that both Joomla install directories are named...joomla :P so if I do a backup and restore with joomla pack, it will mess everyting up...right?

so yea...let me know if this is possible. :D

Thanks!

dpminusa
Joomla! Guru
Joomla! Guru
Posts: 907
Joined: Sun Dec 21, 2008 6:35 pm
Location: USA

Re: Joomla 1.5 Installation Problems and Tips.

Postby dpminusa » Thu Apr 23, 2009 12:22 am

@ tidusx
Can you provide the URL for your previous post. I will try to help on it.

@ russw
Thank you for your comments. Rest assured that I have read many of the great articles on your site. I realize my treatment of the topic here is not unique or the first time it has been covered.

I find that I benefit from reading several articles on the same topics. Perhaps other do as well. My interest in publishing this, or any other articles I do, is to share what I am learning. Joomla is free, so this is one way I can pay Joomla.org back. I seek to gain NO economic benefits. I own several companies and wish to keep them separate. Joomla is something I enjoy for its value to some of those companies independently.

I realize that Windows DOES have a permissions system. My intent was to say that it was not "IN YOUR FACE", like *NIX, but rather in the background and not normally an issue.

I reference your site, and articles by you or Brad often, when I am on the forum.

dpminusa

User avatar
RussW
Joomla! Exemplar
Joomla! Exemplar
Posts: 9350
Joined: Sun Oct 22, 2006 4:42 am
Location: Sunshine Coast, Queensland, Australia
Contact:

Re: Joomla 1.5 Installation Problems and Tips.

Postby RussW » Thu Apr 23, 2009 1:11 am

@dpminusa

not a problem, as you do, I think re-emphiasis and continued learning.study/reading the way to go, your post was accurate, poinient and will be very useful to many newcomers and veterans alike. This type of information is particulalrly difficult to "summarise" and still make useful, a great job. Thank you for your efforts in the forums and in this post, always appreciated.

[edit] there is no, one way, to present or deliver information and there certainly is not ever "one source" as many people as possible that can assist with Joomla1 and the topic of security is always a bonus.
Joomla! on the fabulous Sunshine Coast...
hotmango, web & print http://www.hotmango.me/
The Styleguyz https://www.thestyleguyz.com/

tidusx
Joomla! Apprentice
Joomla! Apprentice
Posts: 15
Joined: Wed Feb 04, 2009 12:14 am

Re: Joomla 1.5 Installation Problems and Tips.

Postby tidusx » Thu Apr 23, 2009 2:11 am

uuuh....my post was the one you replied to lol...

well heres my question again...

I was wondering if I can re-name the Joomla install directory? I am assuming that renaming it would break file paths and what not, but if there is a way that would be great.

I'm trying to do this because I have a site on one host and would like to move it to another host that already has a Joomla powered site. The problem is that both Joomla install directories are named...joomla :P so if I do a backup and restore with joomla pack, it will mess everyting up...right?

Thanks...

dpminusa
Joomla! Guru
Joomla! Guru
Posts: 907
Joined: Sun Dec 21, 2008 6:35 pm
Location: USA

Re: Joomla 1.5 Installation Problems and Tips.

Postby dpminusa » Thu Apr 23, 2009 12:01 pm

@react2media, tidusx

There is an extension that allows you to have several sites in the same directory and share the database. Take a look at it.

http://extensions.joomla.org/extensions ... 50/details

dpminusa

PS: Pls start a new thread and send me the URL. Thx.

tidusx
Joomla! Apprentice
Joomla! Apprentice
Posts: 15
Joined: Wed Feb 04, 2009 12:14 am

Re: Joomla 1.5 Installation Problems and Tips.

Postby tidusx » Thu Apr 23, 2009 3:28 pm

Thanks for the extension tip.

Heres the link...

http://forum.joomla.org/viewtopic.php?f=428&t=394988


Return to “Installation 1.5”

Who is online

Users browsing this forum: No registered users and 7 guests