Troubleshooting typical EgoWeb Problems

Installation


Q: I installed EgoWeb and it looks like it installed correctly but I'm getting this "Error 500" error when I try to go to the admin page:

javascript not defined.png
javascript is not defined error

A: This error (and other similar "Error 500" errors, see below) comes up when there has been a change in the database structure. This doesn't happen very often. When it comes up, the fix is easy. Type the following after your EgoWeb url in the browser address bar: "~/admin/migrate" and hit return/enter. For example, if you have a url running EgoWeb such as "egoweb.organization.org", run "egoweb.organization.org/admin/migrate". If you have a local installation, run "localhost/admin/migrate". This command will update the SQL file with the new database structure. We are making plans to figure out a way to make this happen automatically without having to run this url in a browser. For now this manual fix will solve the problem.

The error message fixed by running ~/admin/migrate might not have exactly the same wording each time. Here is another example of an "Error 500" error that is fixed with this step:


study header not defined.jpg


If in doubt, run ~/admin/migrate and see if the problem is fixed. It will not cause any problems if the error is something else.

Reset admin password


If attempts to login with an administrative passwords fail, access can be regained to an EgoWeb installation by deleting all entries in the "user" table. If this table is blank when a user attempts to open an EgoWeb instance, the user is immediately prompted to create an administrative account name and password. Deleting entries in the "user" table can be done using mysql for Linux installations, WAMP for Windows installations, and MAMP for Mac installations.

After re-entry into EgoWeb, any users that were deleted would have to be re-created using the new administrator account.


Step 1: Open Wamp:
re-initiate admin 3.png
Launch the WAMP Server application from the Windows tray.

Step 2: Run "phpMyAdmin"


re-initiate admin 4.png
Select the WAMP Amin application.

Step 3: Click "Databases"....




reset admin user 3.jpg
Launch Databases in phpMyAdmin


....and then click on "egoweb" either under "Databases" or over on the left hand side of the page under "(Recent tables)".


reset admin user 4.jpg


Step 4. Click on the "user" table to open up the table with the user properties.

re-initiate admin 2.png
Select the "user" table from SQL.

Step 5. Delete all users in the user table.
re-initiate admin 1.png
Delete all users in "user" table. This triggers the request for a new admin password after launching EgoWeb (launching "localhost" in a browser).

Step 6. Re-launch egoweb. This will trigger the initial request for an admin user id and password. Previous users will have to be re-created by the new admin account.


Page not loading properly


If EgoWeb code has changed, browsers may still load old versions of pages because they are storing page data in the cache. Somtimes there is a mixture of old and new page code, which can cause the page to appear broken in different ways.

To remedy this problem, do a hard browswer refresh, which clears the browser’s cache for that page and forces the browser to load the current page code. Browsers hang onto old code so that they do not have to load everything each time you visit the same page, but it sometimes hangs onto too much.

Doing a hard refresh depends on the browser and the operating system. For Windows and Chrome, hold down the “ctrl” key and click the browser refresh (or F5) and this should make the menu bar load properly. For Mac, do the same but instead of "ctrl" hold down "shift".


Problems timing out when exporting and importing files (CSRF error, Maximum execution time errors, etc.)


This is a (LAMP/WAMP/MAMP) server setting problem preventing going above time limits, exporting or importing more than a small number of files, etc. Editing the php.ini file to raise the limits will fix the problem.

For Mac/MAMP:
1. Start MAMP
2. Open Webstart Page
3. go to phpInfo (top menu)
4. find file location of php.ini (search for "php.ini")
5. edit php.ini file found above
6. Search for these settings and change values after the "=" and save the changes. This should prevent timing out.

max_input_vars = 10000
max_execution_time = 5000
post_max_size = 2000M
upload_max_filesize = 2000M
memory_limit = 3072M
max_file_uploads = 5000

7. Restart MAMP

Windows:
1. Find the wampmanager icon, which sits in the system tray has a menu system. Use that to edit your php.ini file that is used with Apache.
(left click ) wampmanager icon -> PHP -> php.ini
2. Search for these settings and change values after the "=" and save the changes. This should prevent timing out.

max_input_vars = 10000
max_execution_time = 5000
post_max_size = 2000M
upload_max_filesize = 2000M
memory_limit = 3072M
max_file_uploads = 5000

3. Restart WAMP


Return to the EgoWeb 2.0 Wikispaces Home