----------------------------
INSTALLATION TROUBLESHOOTING
----------------------------

This file includes instructions on how to troubleshoot some of the most common
installation problems.

Contents
--------
1. I'm getting an 'Internal Server Error'
2. I'm getting a 404 file not found on the website links
3. None of the website links work

###################################
1. I'm getting an 'Internal Server Error'
###################################

This is usually caused by something in the .htaccess file that
your server doesn't want to allow. 

There are a few steps that can be taken to see if this can be 
quickly resolved.

Step 1.
-------
Open the .htaccess file (in the same directory as this file)

Find this line (should be the first line):

Options -MultiViews +FollowSymlinks

And delete it.

Save the file and upload. Check if you stil get the error.

If you still get the error, move onto Step 2.

Step 2
-------
Open the .htaccess file again and find this code:

<IfModule mod_security.c>
	# Turn off mod_security filtering.  
	SecFilterEngine Off

	# The below probably isn't needed, but better safe than sorry.
	SecFilterScanPOST Off
</IfModule>

Delete that, and retry uploading the file. If that doesn't work either, try
step 3.

Step 3
-------

In this step we're going to try the most basic configuration. 

Delete everything in the .htaccess file and replace it with this:

RewriteEngine On

RewriteCond %{REQUEST_URI} categories.*
RewriteRule ^categories(.*)$ categories.php?$1 [T=application/x-httpd-php,L]

RewriteCond %{REQUEST_URI} articles.*
RewriteRule ^articles(.*)$ articles.php?$1 [T=application/x-httpd-php,L]

RewriteCond %{REQUEST_URI} pages.*
RewriteRule ^pages(.*)$ pages.php?$1 [T=application/x-httpd-php,L]

RewriteCond %{REQUEST_URI} blogs.*
RewriteRule ^blogs(.*)$ blogs.php?$1 [T=application/x-httpd-php,L]

RewriteCond %{REQUEST_URI} search.*
RewriteRule ^search(.*)$ search.php?$1 [T=application/x-httpd-php,L]

RewriteCond %{REQUEST_URI} authors.*
RewriteRule ^authors(.*)$ authors.php?$1 [T=application/x-httpd-php,L]

RewriteCond %{REQUEST_URI} articlerss.*
RewriteRule ^articlerss(.*)$ articlerss.php?$1 [T=application/x-httpd-php,L]

RewriteCond %{REQUEST_URI} news.*
RewriteCond %{REQUEST_URI} !newsrss
RewriteRule ^news(.*)$ news.php?$1 [T=application/x-httpd-php,L]

RewriteCond %{REQUEST_URI} contact.*
RewriteRule ^contact(.*)$ contact.php?$1 [T=application/x-httpd-php,L]

Try that. If it works, you are now right to use your website. If not, continue
on below:

The last thing is to delete your .htaccess file from the server to be sure it is
the above code causing the error.

If you website works after removing the file, the your host does not support
.htaccess files or mod_rewrite. You will need to contact them to get this sorted
or move to a host that does support these abilities. There is a list of 
recommended hosts at: http://www.interspire.com/hosts

###################################
2. I'm getting a 404 file not found on the website links
###################################

This will be a .htaccess issue.

Step 1
-------
Ensure there is infact a .htaccess file uploaded. Some servers may hide the 
file, and so will some operating systems. If you can't find the file in the 
ArticleLive zip then you download another copy from:

http://www.interspire.com/support/kb/questions/557/

Step 2
-------
Are you installing in a sub-directory? e.g. http://www.website.com/subdirectory/
If not, and you are just installing on a domain like: http://www.website.com, 
skip to step 3.

In order to get the rewrite rules in the .htaccess file to work you will need to
edit the file.

Open the .htaccess file. Find this line:

RewriteEngine On

On a new line underneath, add this line:

RewriteBase /subdirectory/

Where 'subdirectory' is the name of the folder ArticleLive is instaled in.

Put all the directories leading from the domain. e.g.
If you're using: http://www.website.com/subdirectory/second/

Use:

RewriteEngine On
RewriteBase /subdirectory/second/

Step 3
------
On this step we need to check that .htaccess files are even being read by your
server.

Edit the .htaccess file and on the first line put just random characters. 
Anything besides a # symbol, as that designates a comment line.
e.g.

DFSRWS$%&^@%!&&(

If you place that in the file, upload and find your website is still working,
then the file is not being read.

If you do that and then get an 'Internal Server Error', your server is correctly
reading the .htaccess file, it is just not parsing the rewrite rules. For this
you will need to send in a support ticket via your client area.

###################################
3. None of the website links work
###################################

Please refer to "I'm getting a 404 file not found on the website links" above.