© 2015 X2Engine Inc.
Difference between revisions of "Known Issues"
(→Troubleshooting) |
|||
| Line 11: | Line 11: | ||
! scope="col" | Affected Instances | ! scope="col" | Affected Instances | ||
! scope="col" | How to Fix | ! scope="col" | How to Fix | ||
| + | |- | ||
| + | ! scope="row" | "Invalid path": <tt>protected/runtime</tt> | ||
| + | | | ||
| + | This is caused by installing in the case of an uncaught directory ownership mismatch. In some PHP builds, the <tt>--disable-posix</tt> flag may be enabled. To see if this is the case, upload [[x2doc]] | ||
| + | | | ||
|- | |- | ||
! scope="row" | Installation error: deprecated function "mysql_escape_string" | ! scope="row" | Installation error: deprecated function "mysql_escape_string" | ||
Revision as of 20:44, 31 January 2013
This page is a work in progress. As new common/recurring issues are encountered, they will be addressed here. This page will not be used for bugs in individual releases, but for pre-installation problems and problems that arise under very specific circumstances, which cannot be fixed by updating to the latest version.
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
Troubleshooting
| Description | Affected Instances | How to Fix |
|---|---|---|
| "Invalid path": protected/runtime |
This is caused by installing in the case of an uncaught directory ownership mismatch. In some PHP builds, the --disable-posix flag may be enabled. To see if this is the case, upload x2doc |
|
| Installation error: deprecated function "mysql_escape_string" |
All versions up to 2.2.1 on some servers |
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: |
| Update notifications do not work, cannot enable them |
|
|
| Cannot view or create quotes |
|
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
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.
