Known Issues

This page does not cover bugs in individual releases. Rather, it is for pre-installation errors and problems that both arise under very specific circumstances and cannot be fixed by updating to the latest version (due to how they either prevent updating or cause fatal errors, or because updates cannot fix the issue).

If you saw error messages about missing system requirements during installation and disregarded them, first refer to Installing Without All Requirements: What Won't Work

This page is a work in progress. As new common/recurring issues are encountered, they will be addressed here.

Troubleshooting

Description	Affected Instances	How to Fix
Cannot update, and requirements check script passes	Installed at or updated to version 3.5.5	Patch the updater utility to the latest version.
Prompt to update doesn't go away after updating	X2CRM versions before 2.1 (check for the version number being the same as before the update)	After updating, edit the file protected/config/X2Config.php. For the $version variable, put the current version between the pair of single quotes. For example, for version x.y.z, it should look like this: $version = 'x.y.z';
Cannot log in after update	X2CRM versions before 2.0, after updating to a version after 2.0	Empty the x2_sessions table (delete all records) DELETE FROM `x2_sessions`;
Invalid path in "protected/runtime/..."	PHP built without posix library Windows-based servers	This is caused by installing with a directory ownership mismatch that wasn't caught and reported in the requirements check. In some PHP builds, the necessary POSIX functions for running this check are unavailable due to one of the following reasons: The --disable-posix flag is enabled and the POSIX library hasn't been separately installed The server's operating system is Windows To see if this is the case, upload requirements.php to your server again and search for "posix" in the phpinfo() output.
Installation error: deprecated function "mysql_escape_string"	All versions up to 2.2.1 on some servers	Install a newer version of X2CRM (recommended) or replace all instances of "mysql_escape_string" with "addslashes" in initialize.php, or simply remove those function calls. Note that if you perform the latter action, you must ensure that the values you put in the "Application Name" and "Administrator Email" fields of the installation form do not contain any apostrophes (otherwise, the resulting installation will be broken).
"No input file specified"	All versions, on GoDaddy hosting	All web applications featuring human-friendly URLs (i.e. Joomla!, Drupal, Wordpress) will have this issue on GoDaddy. The error is caused by the URL rewriting engine being disabled in GoDaddy's hosting environment. See the following articles on how to rectify the issue using .htaccess overrides: Magento: "No Input File Specified" GoDaddy — Enabling Joomla! Search Engine Friendly URLs
Update notifications do not work, cannot enable them	Installed at 1.6.1 or earlier and updated to a version in the range 1.6.5 - 2.0	Set value of the column unique_id in table x2_admin to "none", i.e. UPDATE `x2_admin` SET `unique_id`='none' Then, go to "Updater Settings" ("General Settings" in versions earlier than 2.0), ensure "Enable Software Update Notifications" is checked, and submit the form. Run the update manually if all else fails
Cannot view or create quotes	Installed at 1.6.1 or earlier and updated to a version in the range 1.6.5 - 1.6.6	Run the following SQL: Versions earlier than 2.0: INSERT INTO x2_fields (modelName, fieldName, attributeLabel, modified, custom, type, required, readOnly, linkType, searchable, relevance) VALUES ("Quote", "products", "Products", 0, 0, "varchar", 0, 0, NULL, 0, ""), ("Quote", "existingProducts", "Existing Products", 0, 0, "varchar", 0, 0, NULL, 0, "") Versions 2.0 and later: INSERT INTO x2_fields (modelName, fieldName, attributeLabel, modified, custom, type, required, readOnly, linkType, searchable, relevance,isVirtual) VALUES ("Quote", "products", "Products", 0, 0, "varchar", 0, 0, NULL, 0, "", 1), ("Quote", "existingProducts", "Existing Products", 0, 0, "varchar", 0, 0, NULL, 0, "", 1)

Running Updates Manually

This section is obsolete as of 12/10/2013. Refer to the Updating guide.

In some cases, it may be desirable to bypass the update notifications and go straight to the updater to check if there is a new version available, because of update notifications disabled or an improperly set unique_id in the x2_admin table. To run an update or check for an update manually, log in as the admin user and in the browser's address bar, replace "index.php/site/whatsNew" with "index.php/admin/updater", and hit enter to run the action.

Note: in versions 2.2 and later, it is possible to go directly to the updater through a link in the admin console under the "System Settings" section.