© 2015 X2Engine Inc.

Difference between revisions of "Known Issues"

From X2Engine
Jump to: navigation, search
(Troubleshooting)
(Troubleshooting)
Line 5: Line 5:
 
|-
 
|-
 
! scope="col" | Description
 
! scope="col" | Description
! scope="col" | Affected Installations
+
! scope="col" style="width: 40%;" | Affected Installations
 
! scope="col" | How to Fix
 
! scope="col" | How to Fix
 
|-
 
|-
! scope="row" |Update notifications do not work
+
! scope="row" | Update notifications do not work
 
|
 
|
* Installed at 1.6.1 or earlier and updated to a version in 1.6.5 - 2.0
+
* Installed at 1.6.1 or earlier and updated to a version in the range 1.6.5 - 2.0
 
* Installed at 2.0 - 2.1 without "Enable Software Update Notifications" in the install process
 
* Installed at 2.0 - 2.1 without "Enable Software Update Notifications" in the install process
* Installed on any server where the PHP option fopen_allow_url is disabled  
+
* Installed on any server where the PHP option allow_url_fopen is disabled
 
|
 
|
 
* Enable fopen_allow_url in the hosting environment (updates themselves won't work without this option; it's the crux of the remote update process)
 
* Enable fopen_allow_url in the hosting environment (updates themselves won't work without this option; it's the crux of the remote update process)
 
* Set value of the column <tt>unique_id</tt> in table <tt>x2_admin</tt> to a string other than "none" or null, i.e. <syntaxhighlight lang="sql">UPDATE `x2_admin` SET `unique_id`='[something]'</syntaxhighlight>
 
* Set value of the column <tt>unique_id</tt> in table <tt>x2_admin</tt> to a string other than "none" or null, i.e. <syntaxhighlight lang="sql">UPDATE `x2_admin` SET `unique_id`='[something]'</syntaxhighlight>
 +
* Run the update manually
 
|-
 
|-
 +
! scope="row" | 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:
 +
: <syntaxhighlight lang="sql">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)
 +
</syntaxhighlight>
 +
;Versions 2.0 and later:
 +
: <syntaxhighlight lang="sql">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, "");
 +
</syntaxhighlight>
 
|}
 
|}
 +
 +
= 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. 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.

Revision as of 19:50, 17 October 2012


Troubleshooting

Description Affected Installations How to Fix
Update notifications do not work
  • Installed at 1.6.1 or earlier and updated to a version in the range 1.6.5 - 2.0
  • Installed at 2.0 - 2.1 without "Enable Software Update Notifications" in the install process
  • Installed on any server where the PHP option allow_url_fopen is disabled
  • Enable fopen_allow_url in the hosting environment (updates themselves won't work without this option; it's the crux of the remote update process)
  • Set value of the column unique_id in table x2_admin to a string other than "none" or null, i.e.
    UPDATE `x2_admin` SET `unique_id`='[something]'
    
  • Run the update manually
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,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)
Versions 2.0 and later
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, "");

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. 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.