1 to 3 of 3
Topics Covered:
* Setup Errors
* File Permission Errors
Last updated: 29th March, 2009
Links: Tutorials | Troubleshooting | Bug TrackerSetup Errors:
When first installing OIOpublisher, setup errors may be flagged up. These are perfectly normal, and are to let you know that there are certain things you need to do to complete setup of the script. You should only receive these messages when installing in "standalone" mode.
1.) Fatal / Parsing error:
This error occurs when you have edited the config file, but used invalid php code. The most common cause is that you have not entered the plugin url or database details inside the quotation marks provided, or you have accidentally deleted a quotation mark.
2.) Fill in the plugin_url variable where indicated:
This error occurs when you have not filled in the url of your OIO install directory in the "plugin url" section of the config file. Also remember that the url should not end with a trailing slash.
3.) Fill in the database connection info where indicated:
This error occurs when you have not filled in all four of the fields required in the "database" section of the config file.
4.) Cannot Connect to database:
This error occurs when you have filled in all four fields in the "database" section of the config file, BUT the details are incorrect. Check that the host, username, password and database name are all exactly the same as the values in your web hosting control panel.
5.) Please make the directory writable:
This error occurs when either the "cache" or "uploads" directories cannot be written to by the web server. You'll need to login to the web server using an FTP client and change the permissions of these folders. Navigate to the directory you installed OIO in, and right click on the directory the error relates to. You should see a menu option called "file permissions" (or something similar). Select that option to bring up the permissions menu.
>> Tutorial on changing permissions available here
Frist, try switching the permissions from 755 to 766, and see if the error in OIO disappears. If it doesn't, you'll need to try 777 instead.
Please be aware that setting a folder's permissions to 777 is a security risk. Properly configured servers should allow a directory to be writable with permissions set to 755 or 766. [more info]
6.) A "memory exhausted" error
This error can sometimes occur when activating OIO as a Wordpress plugin. If your blog already consumes a lot of memory (eg. using lots of plugins), then you may run out of memory trying to use OIO. To fix this problem, try increasing the memory in your wp-config.php file using the line of code below:
define('WP_MEMORY_LIMIT', "64M");
Last updated: 18th October, 2009
Links: Tutorials | Troubleshooting | Bug TrackerFile Permission Errors:
File permissions can cause a lot of headaches, and is the most common (if not the only) cause of strange behaviour (eg. website slowdown, a crash, or scheduled tasks not running).
Each file and folder you upload to your web server is given a set of permissions, indicating how they can be accessed. Wrongly set permissions can mean files become inaccessible.
1.) How To Check
To check file permissions, login to the web server using an FTP client and right click on the file or folder you wish to check. A menu should appear, from which you can select / edit file permissions. [tutorial here]
2.) Checking Files
The OIO files (ending in .php) should all have permissions set to 644.
3.) Checking Folders
Most folders in OIO (eg. admin, include, templates) should have permissions set to 755. Some folders (eg. cache, uploads) may require permissions set to 766 (or 777), however OIO will let you know if that's the case, so make sure everything is set to 755 initially.
Even if the files and folders within OIO itself are set correctly, you should still check the permissions of containing folders (eg. public_html, wp-content, plugins). If any of those folders are set to 777, try changing them back to 755.
4.) .htaccess file
If you have an .htaccess file on your website, it can sometimes affect whether pages are found or not (eg. through the use of rewriting rules). To check whether an .htacces file may be the cause of the problem, rename it temporarily to something like .htaccess.old and see if the problem continues to occur.
------
You can also search the main forum for other possible solutions.
Links: Tutorials | Troubleshooting | Bug Tracker1 to 3 of 3