# -----------------------------------------------------------------------------
# INSTALLATION TROUBLESHOOTING
# -----------------------------------------------------------------------------

This file contains 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"
		or "No 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. It may also be caused by file permissions on PHP files. 

Note: The .htaccess file allows the use of search engine friendly URLs. Without
it the application can not function, so it is a requirement of this software
that your server will allow and can run .htaccess files.

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

---------------------
| Step 1.
---------------------
Delete the .htaccess file (in the same directory as this file) from your server.

Try loading your website again. 

If the error is gone, move on to step 2 in order to track down what in the 
.htaccess file might be causing the problem.

If the error persists, then the .htaccess file is not the cause of the error.

The second most common cause of this error is PHP file permissions. Some servers
will not allow PHP files to run if they are writable as a security precaution.

To fix this problem you will need to ensure all PHP files in the base 
installation directory and in the /admin folder have permissions of 0644. This
can be changed in most FTP clients through an option called 'CHMOD' or 'Change
Mode' or 'Change File Permissions'.

If you require further assistance with chaning the permissions of files, or 
find that this does not solve your problem, please contact your web host's 
technical support service.
 
---------------------
| Step 2
---------------------

Open the .htaccess file.

Find this following line (it should be the first line) and delete it:

Options -MultiViews -Indexes +FollowSymlinks

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

If you do not see an error, and your website's links work, then it is safe to
leave this line out. Your website should now function normally.

If you still get the error, open the .htaccess file again then find and delete 
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>

Also find and remove:

AddDefaultCharset OFF

And also remove this:

<IfModule mod_deflate.c>
	AddOutputFilterByType DEFLATE application/x-javascript application/javascript text/css text/ html text/xml
</IfModule>

After that, reupload the .htaccess file to your website. If you find that you 
still have an error, then you will need to contact your web host's technical 
support service and they may be able to help you track down the problem.

If you do not see an error, and your website's links work, then it is safe to
leave this code out. Your website should now function normally.

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

This will be a .htaccess issue.

---------------------
| Step 1
---------------------
Ensure there is in fact a .htaccess file uploaded. Some servers may hide the 
file, and so will some operating systems. 

Are you installing in a sub-directory? e.g. http://www.example.com/subdirectory/
If so, go to step 2.1

Are you are just installing on your base domain? e.g. http://www.example.com 
If so, go to step 2.2

---------------------
| Step 2.1
---------------------
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 Interspire Website Publisher is 
installed in.

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

Use:

RewriteEngine On
RewriteBase /subdirectory/second/

If this does not resolve your problem, please raise a support ticket from your
client area: https://www.interspire.com/clientarea/

---------------------
| Step 2.2
---------------------

On this step we need to check that .htaccess files are 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.:

Rand0mt3&thi3r

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. You will
need to contact your web host to ensure mod_rewrite is enabled.