[cvs] [Wiki] changed: FAQ/Admin/Troubleshoot
Jan Schneider
jan at horde.org
Tue Dec 13 01:18:27 PST 2005
jan Tue, 13 Dec 2005 01:18:27 -0800
Modified page: http://wiki.horde.org/FAQ/Admin/Troubleshoot
New Revision: 4.0
Change log: Sort error messages alphabetically
@@ -6,32 +6,35 @@
[[toc]]
+++ Common error messages
-++++ "Unable to load dynamic library php_whatever.dll - The specified module could not be found."
+++++ "Call to undefined function: _( )"
+**[Horde 2.0]:** This error occurs when PHP is not compiled with gettext support. As of version Horde 2.0, PHP needs to be compiled with gettext support. Rebuild PHP with the {{--with-gettext}} option to {{configure}}, or if using RPM's install the php-gettext RPM. ({{_()}} is a synonym for {{gettext()}} in PHP.)
-This error message is a misrepresentation of the actual problem. Often occurs when some dependency needed for php_whatever.dll is missing.e.g. need to copy iconv.dll (from the dlls folder under to the php install directory) to windows\system32 to get php_gettext.dll to load.
+++++ "Call to unsupported function page_open"
+**[Horde 1.2]:** This error occurs when PHPlib is missing from the PHP include path. Make sure you have followed the instructions in the {{README}} file in your PHPlib directory.
-++++ "Only variable references should be returned by reference"
-++++ "Only variables can be passed by reference"
-These messages appear after upgrading to PHP 4.4 or PHP 5.1. These PHP versions raise notices about reference usage that older version accepted happily. Only Horde 3.x and the H3 application versions will be fixed to not cause this messages, so either upgrade to the latest versions, or set your error reporting level in PHP to exclude E_NOTICE level messages.
+++++ "Cannot extend nonexistent class !HordeDefaults"
+This error is often the result of using incompatible versions of Horde and IMP. The appropriate Horde version to use with a given version of IMP is that with a version number one less than IMP's; for instance, IMP 2.2-pre13 used Horde 1.2-pre13, and IMP 3.0 uses Horde 2.0.
-E.g. in {{php.ini}}:
+Information on choosing the appropriate //IMP// version for your site can be found in Section 3.2.1
-<code>
-error_reporting = E_ALL & ~E_NOTICE
-</code>
+++++ "Cannot instantiate non-existent class: hordect"
+**[IMP 2.2]:** This error is caused by an incorrect PHPlib configuration. Make sure that the appropriate section for your chosen storage class is fully uncommented in the {{local.inc}} file in your PHPlib directory. Frequently, during configuration, the !HordeCT part of the PHPlib configuration (located below the !HordeDB section for your storage class) is accidentally left commented out.
-You can also turn off the display of error reporting entirely, although this might cause problems diagnosing problems in the future. After you get a good, working installation you can turn off the display of error messages to the browser and just log them.
-
-E.g. in {{php.ini}}:
+++++ "Database error (!HordeDB): Session: freeze() failed"
+**[IMP 2.2]:** Occasionally, the following message will be produced upon login or logout:
<code>
-display_errors = Off
-log_errors = On
-error_log = syslog ; goes to NT event log on NT-based machines
-; error_log = /var/log/php_error
+Database error (HordeDB): Invalid SQL: INSERT INTO active_sessions
+VALUES ('562493df1fa64bc81db7b0deb86fc019','HordeSession',
+'70ee728055533b7ad9fc0bacfb8ecde01718b97968eb65bc79b418d12c0dc0e9')
+Database error (HordeDB): Session: freeze() failed.
</code>
+
+This is produced by a race condition in PHPlib. When two pages try to update the session table at once, the update can sporadically fail. This is more likely to happen at logout from IMP (due to the multiple framesets) than in other use. Charles Wright came up with a [http://www.horde.org/faq/contrib/mysql_phplib_freeze.patch patch against PHPlib] which should fix this for !MySQL users.
+
+Kari Asikainen reports that using !PostgreSQL in place of !MySQL, or downgrading from PHP 4.0.2 to 4.0.1pl2, eliminates the condition as well.
++++ "Document contains no data"
The Netscape error message, "Document contains no data", only tells you that nothing was sent from the web server to the browser. In other words, something went quite wrong, yet you've no idea what.
@@ -42,60 +45,63 @@
</code>
Don't confuse PHP's IMAP support with Apache's {{mod_imap}}, which refers to image maps.
-++++ "Database error (!HordeDB): Session: freeze() failed"
-**[IMP 2.2]:** Occasionally, the following message will be produced upon login or logout:
+++++ "Failed opening test.php3 for inclusion"
+**[Horde 1.2]:** The IMP setup script changes the permissions on the {{test.php3}} script so that it can't be run. This increases the security of your web server by not revealing to intruders information about how PHP is compiled/configured. To use the script while setting up Horde, PHPLIB, or IMP, add read permission for all users to the script:
<code>
-Database error (HordeDB): Invalid SQL: INSERT INTO active_sessions
-VALUES ('562493df1fa64bc81db7b0deb86fc019','HordeSession',
-'70ee728055533b7ad9fc0bacfb8ecde01718b97968eb65bc79b418d12c0dc0e9')
-Database error (HordeDB): Session: freeze() failed.
+chmod a+r horde/test.php3
</code>
-This is produced by a race condition in PHPlib. When two pages try to update the session table at once, the update can sporadically fail. This is more likely to happen at logout from IMP (due to the multiple framesets) than in other use. Charles Wright came up with a [http://www.horde.org/faq/contrib/mysql_phplib_freeze.patch patch against PHPlib] which should fix this for !MySQL users.
+Remember to remove read permission ({{chmod a-r}}) from the file when you have finished testing.
-Kari Asikainen reports that using !PostgreSQL in place of !MySQL, or downgrading from PHP 4.0.2 to 4.0.1pl2, eliminates the condition as well.
+++++ "Fatal error: Allowed memory size of ### bytes exhausted..."
+Either recompile PHP //without// the {{--enable-memory-limit}} option, or increase the value of {{memory_limit}} in your {{php.ini}} file.
-++++ "Cannot instantiate non-existent class: hordect"
-**[IMP 2.2]:** This error is caused by an incorrect PHPlib configuration. Make sure that the appropriate section for your chosen storage class is fully uncommented in the {{local.inc}} file in your PHPlib directory. Frequently, during configuration, the !HordeCT part of the PHPlib configuration (located below the !HordeDB section for your storage class) is accidentally left commented out.
+++++ "Fatal error: Call to undefined function: iswarning() in ..."
+**[Horde 2.x]:** After the release of Horde 2.1, the isWarning() function was removed from PEAR, resulting in this error when using a PHP/PEAR released after Horde 2.1 was released. Possible solutions are:
-++++ "top.opener.parent is not an object"
-This error is the result of a bug in Internet Explorer. [mailto:stuart at eclipse.net.uk Stuart] suggests that the following commands (executed on the Windows system on which Internet Explorer is installed) will solve the problem:
+* Upgrade to a newer Horde (e.g. 2.2 or newer)
+* Remove all references to PEAR::isWarning() from the code manually.
+* Downgrade to an older PHP/PEAR version.
-<code>
-regsvr32 c:\windows\system32\actxprxy.dll
-regsvr32 c:\windows\system32\shdocvw.dll
-</code>
+The same problem exists in some other Horde applications also (e.g. in Kronolith 1.0). The solution is the same (e.g. upgrade to a newer Kronolith version, remove the isWarning() calls, downgrade PEAR).
-The FAQ maintainer has //not// tested the above! Make sure you have a backup of your system before playing with deep Windows magic.
+++++ "Fatal error: Call to undefined function: quote()"
+**[Horde 2.x]:** You are using too old a version of PHP which doesn't support some needed functions such as the quote() function. Upgrade to a supported version of PHP.
-++++ "undefined function: mysql_pconnect()"
-This error occurs when IMP is configured to use !MySQL, but PHP was not built with support for !MySQL. Rebuild PHP, ensuring that !MySQL support is compiled in, and that the line
+++++ "Fatal error: Undefined class name 'log' in ..."
+**[Horde 2.x]:** Your PHP PEAR implementation is missing the PEAR Log package. This is a common problem with the PHP 4.2.1 PEAR for example. You can install it via the network if you have a standalone php/pear command. See the file {{[http://www.horde.org/horde/docs/?f=INSTALL.html horde/docs/INSTALL]}} for more information on how to install the required PEAR packages this way. Otherwise you can download the Log package (e.g. from http://pear.php.net/get/Log) and manually install them inside your PEAR directory. You may also need to install the modules Mail_Mime and Net_Socket as well.
-<code>
-extension = mysql.so
-</code>
+For more detailed instructions on installing PEAR modules, see the PEAR documentation at http://pear.php.net/manual/.
-appears in your {{php.ini}} (or {{php3.ini}} in PHP version 3).
+++++ "imap_utf7_decode: Unexpected end of string"
+This error is another symptom of the ampersand question described in the section above.
-++++ "undefined function: bindtextdomain()"
-This error occurs when PHP is not compiled with gettext support. As of Horde 2.0, PHP needs to be compiled with gettext support. Rebuild PHP with the {{--with-gettext}} option to configure, or if using RPM's install the php-gettext RPM.
+++++ "Only variable references should be returned by reference"
+++++ "Only variables can be passed by reference"
+These messages appear after upgrading to PHP 4.4 or PHP 5.1. These PHP versions raise notices about reference usage that older version accepted happily. Only Horde 3.x and the H3 application versions will be fixed to not cause this messages, so either upgrade to the latest versions, or set your error reporting level in PHP to exclude E_NOTICE level messages.
-++++ "undefined function: imap_utf7_encode()"
-This error most often occurs when IMP tries to use a folder name with an ampersand (&) in it. The easiest solution is to rename the folder to something without an ampersand in it (on the server, or with a different IMAP client).
+E.g. in {{php.ini}}:
-The error can also occur if IMAP support has not been compiled into PHP. Ensure that your PHP installation supports IMAP.
+<code>
+error_reporting = E_ALL & ~E_NOTICE
+</code>
-++++ "imap_utf7_decode: Unexpected end of string"
-This error is another symptom of the ampersand question described in the section above.
+You can also turn off the display of error reporting entirely, although this might cause problems diagnosing problems in the future. After you get a good, working installation you can turn off the display of error messages to the browser and just log them.
-++++ "undefined function: imap_open"
-This error is the result of using IMP without compiling IMAP support into PHP. Be sure that your PHP installation supports IMAP, and rebuild it with the {{--with-imap}} flag to configure if it does not (or install the php-imap RPM in an RPM installation).
+E.g. in {{php.ini}}:
-++++ "Wrong parameter count for imap_delete"
-This error is caused by a bug in older versions of PHP. Upgrade to the current version of PHP, or if you must stay with PHP3, use version 3.0.18.
+<code>
+display_errors = Off
+log_errors = On
+error_log = syslog ; goes to NT event log on NT-based machines
+; error_log = /var/log/php_error
+</code>
+
+++++ "output handler 'ob_gzhandler' cannot be used twice in..."
+**[Horde 2.x]:** You enabled output compression in both your php.ini configuration file and in your horde configuration file (either horde/config/horde.php or horde/config/conf.php). Disable it in one of these two locations.
++++ "!PostgreSQL Error: attribute 'val' not found"
If IMP produces an error similar to
@@ -109,70 +115,64 @@
</code>
the usual cause is not a missing attribute nor invalid SQL, but a failure to successfully authenticate with the database. Check your !PostgreSQL logs for authentication errors, and make sure you can log in to the database manually using {{psql}} with the Horde username and password.
-++++ "Call to unsupported function page_open"
-**[Horde 1.2]:** This error occurs when PHPlib is missing from the PHP include path. Make sure you have followed the instructions in the {{README}} file in your PHPlib directory.
+++++ "top.opener.parent is not an object"
+This error is the result of a bug in Internet Explorer. [mailto:stuart at eclipse.net.uk Stuart] suggests that the following commands (executed on the Windows system on which Internet Explorer is installed) will solve the problem:
-++++ "Cannot extend nonexistent class !HordeDefaults"
-This error is often the result of using incompatible versions of Horde and IMP. The appropriate Horde version to use with a given version of IMP is that with a version number one less than IMP's; for instance, IMP 2.2-pre13 used Horde 1.2-pre13, and IMP 3.0 uses Horde 2.0.
+<code>
+regsvr32 c:\windows\system32\actxprxy.dll
+regsvr32 c:\windows\system32\shdocvw.dll
+</code>
-Information on choosing the appropriate //IMP// version for your site can be found in Section 3.2.1
+The FAQ maintainer has //not// tested the above! Make sure you have a backup of your system before playing with deep Windows magic.
-++++ "Warning: errflg=2, text=Can't get status of mailbox"
-This error usually results from a bug in PHP version 3.0.17. Use version 3.0.18 instead, or upgrade to PHP4.
+++++ "Unable to load dynamic library php_whatever.dll - The specified module could not be found."
-++++ "Warning: Undefined index: Send Message"
-This error occurs on Red Hat 7 systems, and results from a bug in Red Hat's php-4.0.4pl1-3 RPM. Update your PHP to the latest available from Red Hat.
+This error message is a misrepresentation of the actual problem. Often occurs when some dependency needed for php_whatever.dll is missing.e.g. need to copy iconv.dll (from the dlls folder under to the php install directory) to windows\system32 to get php_gettext.dll to load.
-++++ "Warning: Undefined variable: sid in .../session.inc"
-**[Horde 1.2]:** Horde ships with its own customized (read: fixed) version of PHPLIB (the {{horde/phplib}} directory). You //must// use that version of PHPLIB; it is the only version that is supported, and most of the other versions of PHPLIB will not work.
+++++ "Unable to open VFS file for writing"
+If you see this message from kronolith or trean (or any other application hat uses crontabs) you are running a crontab script as a different user as you did in the first run. Adjust your crontab (running it as same user as the webserver is a good idea) and also change the ownship of {{<your_vfs_root>/.horde}}.
-This particular error is a sign that Horde is finding a version of PHPLIB other than the one that ships with it. Make sure that session.inc has version 1.1.2.x in the Id tag at the top. Also make sure that your PHP include_path and auto_prepend_file are set properly so that Horde is finding the correct instance of PHPLIB.
+++++ "undefined function: bindtextdomain()"
+This error occurs when PHP is not compiled with gettext support. As of Horde 2.0, PHP needs to be compiled with gettext support. Rebuild PHP with the {{--with-gettext}} option to configure, or if using RPM's install the php-gettext RPM.
-++++ "Warning: Unable to open '/tmp/...'" when attaching
-On some systems (commonly Solaris and !FreeBSD), the {{upload_tmp_dir}} setting in {{php.ini}} (PHP 4.x) or {{php3.ini}} (PHP 3.x) must be set to {{/var/tmp}}.
+++++ "undefined function: imap_open"
+This error is the result of using IMP without compiling IMAP support into PHP. Be sure that your PHP installation supports IMAP, and rebuild it with the {{--with-imap}} flag to configure if it does not (or install the php-imap RPM in an RPM installation).
-++++ "Call to undefined function: _( )"
-**[Horde 2.0]:** This error occurs when PHP is not compiled with gettext support. As of version Horde 2.0, PHP needs to be compiled with gettext support. Rebuild PHP with the {{--with-gettext}} option to {{configure}}, or if using RPM's install the php-gettext RPM. ({{_()}} is a synonym for {{gettext()}} in PHP.)
+++++ "undefined function: imap_utf7_encode()"
+This error most often occurs when IMP tries to use a folder name with an ampersand (&) in it. The easiest solution is to rename the folder to something without an ampersand in it (on the server, or with a different IMAP client).
-++++ "Failed opening test.php3 for inclusion"
-**[Horde 1.2]:** The IMP setup script changes the permissions on the {{test.php3}} script so that it can't be run. This increases the security of your web server by not revealing to intruders information about how PHP is compiled/configured. To use the script while setting up Horde, PHPLIB, or IMP, add read permission for all users to the script:
+The error can also occur if IMAP support has not been compiled into PHP. Ensure that your PHP installation supports IMAP.
+
+++++ "undefined function: mysql_pconnect()"
+This error occurs when IMP is configured to use !MySQL, but PHP was not built with support for !MySQL. Rebuild PHP, ensuring that !MySQL support is compiled in, and that the line
<code>
-chmod a+r horde/test.php3
+extension = mysql.so
</code>
-Remember to remove read permission ({{chmod a-r}}) from the file when you have finished testing.
+appears in your {{php.ini}} (or {{php3.ini}} in PHP version 3).
-++++ "Fatal error: Call to undefined function: quote()"
-**[Horde 2.x]:** You are using too old a version of PHP which doesn't support some needed functions such as the quote() function. Upgrade to a supported version of PHP.
+++++ "Warning: errflg=2, text=Can't get status of mailbox"
+This error usually results from a bug in PHP version 3.0.17. Use version 3.0.18 instead, or upgrade to PHP4.
-++++ "Fatal error: Undefined class name 'log' in ..."
-**[Horde 2.x]:** Your PHP PEAR implementation is missing the PEAR Log package. This is a common problem with the PHP 4.2.1 PEAR for example. You can install it via the network if you have a standalone php/pear command. See the file {{[http://www.horde.org/horde/docs/?f=INSTALL.html horde/docs/INSTALL]}} for more information on how to install the required PEAR packages this way. Otherwise you can download the Log package (e.g. from http://pear.php.net/get/Log) and manually install them inside your PEAR directory. You may also need to install the modules Mail_Mime and Net_Socket as well.
+++++ "Warning: Unable to open '/tmp/...'" when attaching
+On some systems (commonly Solaris and !FreeBSD), the {{upload_tmp_dir}} setting in {{php.ini}} (PHP 4.x) or {{php3.ini}} (PHP 3.x) must be set to {{/var/tmp}}.
-For more detailed instructions on installing PEAR modules, see the PEAR documentation at http://pear.php.net/manual/.
-
-++++ "Fatal error: Call to undefined function: iswarning() in ..."
-**[Horde 2.x]:** After the release of Horde 2.1, the isWarning() function was removed from PEAR, resulting in this error when using a PHP/PEAR released after Horde 2.1 was released. Possible solutions are:
-
-* Upgrade to a newer Horde (e.g. 2.2 or newer)
-* Remove all references to PEAR::isWarning() from the code manually.
-* Downgrade to an older PHP/PEAR version.
-
-The same problem exists in some other Horde applications also (e.g. in Kronolith 1.0). The solution is the same (e.g. upgrade to a newer Kronolith version, remove the isWarning() calls, downgrade PEAR).
-
-++++ "output handler 'ob_gzhandler' cannot be used twice in..."
-**[Horde 2.x]:** You enabled output compression in both your php.ini configuration file and in your horde configuration file (either horde/config/horde.php or horde/config/conf.php). Disable it in one of these two locations.
+++++ "Warning: Undefined index: Send Message"
+This error occurs on Red Hat 7 systems, and results from a bug in Red Hat's php-4.0.4pl1-3 RPM. Update your PHP to the latest available from Red Hat.
++++ "Warning: Undefined property: _iv in..."
**[Horde 2.2]:** This is a bug in Horde 2.2 when used without php mcrypt support. Either upgrade to Horde 2.2.1, or install the mcrypt php extension.
-++++ "Fatal error: Allowed memory size of ### bytes exhausted..."
-Either recompile PHP //without// the {{--enable-memory-limit}} option, or increase the value of {{memory_limit}} in your {{php.ini}} file.
+++++ "Warning: Undefined variable: sid in .../session.inc"
+**[Horde 1.2]:** Horde ships with its own customized (read: fixed) version of PHPLIB (the {{horde/phplib}} directory). You //must// use that version of PHPLIB; it is the only version that is supported, and most of the other versions of PHPLIB will not work.
-++++ "Unable to open VFS file for writing"
-If you see this message from kronolith or trean (or any other application hat uses crontabs) you are running a crontab script as a different user as you did in the first run. Adjust your crontab (running it as same user as the webserver is a good idea) and also change the ownship of {{<your_vfs_root>/.horde}}.
+This particular error is a sign that Horde is finding a version of PHPLIB other than the one that ships with it. Make sure that session.inc has version 1.1.2.x in the Id tag at the top. Also make sure that your PHP include_path and auto_prepend_file are set properly so that Horde is finding the correct instance of PHPLIB.
+
+++++ "Wrong parameter count for imap_delete"
+This error is caused by a bug in older versions of PHP. Upgrade to the current version of PHP, or if you must stay with PHP3, use version 3.0.18.
+++ Verifying Components
++++ How can I tell if my Web server works?
More information about the cvs
mailing list