From 6fe799bd3e5e7a5ee0f07080f00d86c0c46212c7 Mon Sep 17 00:00:00 2001 From: Max Date: Mon, 12 Apr 2021 15:12:27 +0300 Subject: [PATCH 1/5] troubleshooting upgrade --- docs/administration/troubleshooting.md | 76 +++++++++++++++++++++++++- 1 file changed, 73 insertions(+), 3 deletions(-) diff --git a/docs/administration/troubleshooting.md b/docs/administration/troubleshooting.md index eca7599ba..55c4c836d 100644 --- a/docs/administration/troubleshooting.md +++ b/docs/administration/troubleshooting.md @@ -5,9 +5,12 @@ In this article: * [Check logs](#check-logs) * [Check system requirements](#check-system-requirements) * [Scheduled Jobs are not working](#scheduled-jobs-are-not-working) -* [Running rebuild from CLI](#running-rebuild-from-cli) +* [Running rebuild or clear cache from CLI](#running-rebuild-or-clear-cache-from-cli) * [EspoCRM is not loading after upgrade](#espocrm-is-not-loading-after-upgrade) * [MySQL error: The server requested authentication method unknown to the client](#mysql-error-the-server-requested-authentication-method-unknown-to-the-client) +* [Web browser cache stucking](#web-browser-cache-issue) +* [Page elements are corrupted or JavaScript scenario doesn't work](#page-elements-are-corrupted-or-javascript-scenario-doesnt-work) +* [Blank page with Bad server responce error](#blank-page-with-bad-server-responce-error) * [Emails are not being fetched](#emails-are-not-being-fetched) * [Enabling debug mode for a logger](#enabling-debug-mode-for-a-logger) * [Admin password is lost, can't log in](#admin-password-is-lost-cant-log-in) @@ -68,13 +71,22 @@ where `www-data` is a web-server user. 4\. If there are no errors, check Scheduled Jobs to see if any job was executed (see a Log panel). -## Running rebuild from CLI +#### Problem #3: Cron is disabled -Sometimes you need to run rebuild from the command line interface when the application is not loading. +Check in Administration -> Settings -> Disable Cron parameter. +## Running rebuild or clear cache from CLI + +Sometimes you need to run rebuild or clear cache from the command line interface when the application is not loading. + +* To rebuild: ```bash php rebuild.php ``` +* To clear cache: +```bash +php clear_cache.php +``` ## EspoCRM is not loading after upgrade @@ -95,6 +107,64 @@ More information about file permissions can be found [here](server-configuration MySQL 8.0.4 has changed default authentication method to `caching_sha2_password` which is not supported by PHP. This issue can be solved by this [solution](server-configuration.md#mysql-8-support). +## Web browser cache issue + +Sometimes you can start getting the errors something like Error 500 or error page loading upon new record creation. + +#### Possible causes and fixes + +#### Problem #1: Old request cached + +Errors 500, 400, etc. could appear if a browser cached your previous request's parameters (fields, data, role, etc.) and use them for the current request with the deprecated or non valid values. +Open your instance in a web browser incognito mode window and try to reproduce the error. If it won't be reproduced, then clear the browser cache with its advanced settings. Note that Ctrl + F5 will not help. + +#### Problem #2: Page loading issue upon new record creation + +Open a Developer tools panel in your web browser (F12 button in Chrome) and press F5. Open the console tab and try to create a record again. In the console tab you might be faced with such statement as: +``` +Error: Could not load file 'client/src/views/user/fields/contact.js?r=1578581862' +``` +To make sure that this issue applies to the cache stucking problem do: +1. Open a web browser incognito mode window and try to reproduce the error. If it won't be reproduced then ... +2. Open the `client/src/views/user/fields` directory and make sure that the `contact.js` file exists. If so then... +3. Clear cache with a web browser advanced settings. + +Sometimes such an issue could be even reproduced in the incognito mode window and doesn't disappeared after you clear a cache. In this case there is one more way to fix it. Please try to open this file in your web browser directly. For example: +``` +www.my-site.com/crm/client/src/views/user/fields/contact.js +``` +or +``` +localhost/crm/client/src/views/user/fields/contact.js +``` +After this reload a web page and try reproduce the error again. + +## Page elements are corrupted or JavaScript scenario doesn't work + +1. Open a Developer tools panel in your web browser (F12 button in Chrome) and press F5. Check the console and network tabs for any errors. +2. Check whether you don't have enabled any browser plugins (e.g. Ad-Block) or installed any other software that can restrict executing the javascript code. + +## Blank page with Bad server responce error + +The possible problem is the connection to database is lost or corrupted. +1. Open the ./data/config.php file and check the database connection params: +``` +'database' => [ + 'driver' => 'pdo_mysql', + 'host' => 'localhost', + 'port' => '', + 'charset' => 'utf8mb4', + 'dbname' => 'espocrm', + 'user' => 'espocrm', + 'password' => '123GhjOe33h' +], +``` +2. If the params are correct, then check whether the mysql service runs. You can do it: +* By any database manager like phpMyAdmin etc. +* By terminal using this command `service mysql status`. + +After fix, you should press F5 to reload a web page. + ## Emails are not being fetched 1. Make sure [cron](server-configuration.md#setting-up-crontab) is running. You will see the error notification on the main administration page if cron is not running. From d99ee7e74ef9f0ff2e042f930130af31648502bd Mon Sep 17 00:00:00 2001 From: Max Date: Mon, 12 Apr 2021 15:19:01 +0300 Subject: [PATCH 2/5] troubleshooting upgrade --- docs/administration/troubleshooting.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/administration/troubleshooting.md b/docs/administration/troubleshooting.md index 55c4c836d..00bbc8ad1 100644 --- a/docs/administration/troubleshooting.md +++ b/docs/administration/troubleshooting.md @@ -8,7 +8,7 @@ In this article: * [Running rebuild or clear cache from CLI](#running-rebuild-or-clear-cache-from-cli) * [EspoCRM is not loading after upgrade](#espocrm-is-not-loading-after-upgrade) * [MySQL error: The server requested authentication method unknown to the client](#mysql-error-the-server-requested-authentication-method-unknown-to-the-client) -* [Web browser cache stucking](#web-browser-cache-issue) +* [Web browser cache issue](#web-browser-cache-issue) * [Page elements are corrupted or JavaScript scenario doesn't work](#page-elements-are-corrupted-or-javascript-scenario-doesnt-work) * [Blank page with Bad server responce error](#blank-page-with-bad-server-responce-error) * [Emails are not being fetched](#emails-are-not-being-fetched) @@ -29,7 +29,7 @@ For Ubuntu server, an apache error log is located at `/var/log/apache2/error.log ## Check system requirements -At Admiistration > System Requirements. It's important to have all required extensions installed. +At Administration > System Requirements. It's important to have all required extensions installed. ## Scheduled Jobs are not working From 359365658d32d586d86f07eaa395fc4c72e1cb7f Mon Sep 17 00:00:00 2001 From: Max Date: Mon, 12 Apr 2021 16:03:20 +0300 Subject: [PATCH 3/5] troubleshooting upgrade --- docs/administration/troubleshooting.md | 72 ++++++-------------------- 1 file changed, 15 insertions(+), 57 deletions(-) diff --git a/docs/administration/troubleshooting.md b/docs/administration/troubleshooting.md index 00bbc8ad1..a2b7325c5 100644 --- a/docs/administration/troubleshooting.md +++ b/docs/administration/troubleshooting.md @@ -5,12 +5,14 @@ In this article: * [Check logs](#check-logs) * [Check system requirements](#check-system-requirements) * [Scheduled Jobs are not working](#scheduled-jobs-are-not-working) -* [Running rebuild or clear cache from CLI](#running-rebuild-or-clear-cache-from-cli) +* [Running rebuild from CLI](#running-rebuild-from-cli) +* [Running clear cache from CLI](#running-clear-cache-from-cli) +* [EspoCRM is not loading after upgrade]( +#running-clear-cache-from-cli) * [EspoCRM is not loading after upgrade](#espocrm-is-not-loading-after-upgrade) * [MySQL error: The server requested authentication method unknown to the client](#mysql-error-the-server-requested-authentication-method-unknown-to-the-client) * [Web browser cache issue](#web-browser-cache-issue) -* [Page elements are corrupted or JavaScript scenario doesn't work](#page-elements-are-corrupted-or-javascript-scenario-doesnt-work) -* [Blank page with Bad server responce error](#blank-page-with-bad-server-responce-error) +(#page-elements-are-corrupted-or-javascript-scenario-doesnt-work) * [Emails are not being fetched](#emails-are-not-being-fetched) * [Enabling debug mode for a logger](#enabling-debug-mode-for-a-logger) * [Admin password is lost, can't log in](#admin-password-is-lost-cant-log-in) @@ -75,7 +77,7 @@ where `www-data` is a web-server user. Check in Administration -> Settings -> Disable Cron parameter. -## Running rebuild or clear cache from CLI +## Running rebuild from CLI Sometimes you need to run rebuild or clear cache from the command line interface when the application is not loading. @@ -83,6 +85,10 @@ Sometimes you need to run rebuild or clear cache from the command line interface ```bash php rebuild.php ``` +## Running rebuild from CLI + +Sometimes you need to run clear cache from the command line interface when the application is not loading. + * To clear cache: ```bash php clear_cache.php @@ -109,61 +115,13 @@ MySQL 8.0.4 has changed default authentication method to `caching_sha2_password` ## Web browser cache issue -Sometimes you can start getting the errors something like Error 500 or error page loading upon new record creation. - -#### Possible causes and fixes - -#### Problem #1: Old request cached - -Errors 500, 400, etc. could appear if a browser cached your previous request's parameters (fields, data, role, etc.) and use them for the current request with the deprecated or non valid values. -Open your instance in a web browser incognito mode window and try to reproduce the error. If it won't be reproduced, then clear the browser cache with its advanced settings. Note that Ctrl + F5 will not help. - -#### Problem #2: Page loading issue upon new record creation - -Open a Developer tools panel in your web browser (F12 button in Chrome) and press F5. Open the console tab and try to create a record again. In the console tab you might be faced with such statement as: -``` -Error: Could not load file 'client/src/views/user/fields/contact.js?r=1578581862' -``` -To make sure that this issue applies to the cache stucking problem do: -1. Open a web browser incognito mode window and try to reproduce the error. If it won't be reproduced then ... -2. Open the `client/src/views/user/fields` directory and make sure that the `contact.js` file exists. If so then... -3. Clear cache with a web browser advanced settings. +1\. Press Ctrl + F5 > try to check again; -Sometimes such an issue could be even reproduced in the incognito mode window and doesn't disappeared after you clear a cache. In this case there is one more way to fix it. Please try to open this file in your web browser directly. For example: -``` -www.my-site.com/crm/client/src/views/user/fields/contact.js -``` -or -``` -localhost/crm/client/src/views/user/fields/contact.js -``` -After this reload a web page and try reproduce the error again. - -## Page elements are corrupted or JavaScript scenario doesn't work - -1. Open a Developer tools panel in your web browser (F12 button in Chrome) and press F5. Check the console and network tabs for any errors. -2. Check whether you don't have enabled any browser plugins (e.g. Ad-Block) or installed any other software that can restrict executing the javascript code. - -## Blank page with Bad server responce error - -The possible problem is the connection to database is lost or corrupted. -1. Open the ./data/config.php file and check the database connection params: -``` -'database' => [ - 'driver' => 'pdo_mysql', - 'host' => 'localhost', - 'port' => '', - 'charset' => 'utf8mb4', - 'dbname' => 'espocrm', - 'user' => 'espocrm', - 'password' => '123GhjOe33h' -], -``` -2. If the params are correct, then check whether the mysql service runs. You can do it: -* By any database manager like phpMyAdmin etc. -* By terminal using this command `service mysql status`. +2\. Clear a browser's cache with its advanced settings > try to check again; -After fix, you should press F5 to reload a web page. +3\. Open a developer tools panel (F12 key in Firefox/Chrome) > +refresh a web page > investigate the `Console` and the `Network` tabs. +4\. If some page elements are corrupted or JavaScript scenario doesn't work, then make sure you don't have enabled any browser plugins (e.g. Ad-Block) or installed any other software that can restrict executing the javascript code. ## Emails are not being fetched From 32e0c7b76c36314302280393fda696b9a8b51cba Mon Sep 17 00:00:00 2001 From: Max Date: Mon, 12 Apr 2021 16:06:33 +0300 Subject: [PATCH 4/5] troubleshooting upgrade --- docs/administration/troubleshooting.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) diff --git a/docs/administration/troubleshooting.md b/docs/administration/troubleshooting.md index a2b7325c5..2cc78634e 100644 --- a/docs/administration/troubleshooting.md +++ b/docs/administration/troubleshooting.md @@ -79,7 +79,7 @@ Check in Administration -> Settings -> Disable Cron parameter. ## Running rebuild from CLI -Sometimes you need to run rebuild or clear cache from the command line interface when the application is not loading. +Sometimes you need to run rebuild from the command line interface when the application is not loading. * To rebuild: ```bash @@ -115,13 +115,12 @@ MySQL 8.0.4 has changed default authentication method to `caching_sha2_password` ## Web browser cache issue -1\. Press Ctrl + F5 > try to check again; +1. Press Ctrl + F5 -> check again; -2\. Clear a browser's cache with its advanced settings > try to check again; +2. Clear a browser's cache with its advanced settings -> check again; -3\. Open a developer tools panel (F12 key in Firefox/Chrome) > -refresh a web page > investigate the `Console` and the `Network` tabs. -4\. If some page elements are corrupted or JavaScript scenario doesn't work, then make sure you don't have enabled any browser plugins (e.g. Ad-Block) or installed any other software that can restrict executing the javascript code. +3. Open a developer tools panel (F12 key in Firefox/Chrome) -> refresh a web page -> investigate the `Console` and the `Network` tabs. +4. If some page elements are corrupted or JavaScript scenario doesn't work, then make sure you don't have enabled any browser plugins (e.g. Ad-Block) or installed any other software that can restrict executing the javascript code. ## Emails are not being fetched From 357970d7e6fd9720354aa7abf3eddb35bb52334e Mon Sep 17 00:00:00 2001 From: Max Date: Mon, 12 Apr 2021 16:10:44 +0300 Subject: [PATCH 5/5] troubleshooting upgrade --- docs/administration/troubleshooting.md | 8 +++----- 1 file changed, 3 insertions(+), 5 deletions(-) diff --git a/docs/administration/troubleshooting.md b/docs/administration/troubleshooting.md index 2cc78634e..8e8f21119 100644 --- a/docs/administration/troubleshooting.md +++ b/docs/administration/troubleshooting.md @@ -7,12 +7,9 @@ In this article: * [Scheduled Jobs are not working](#scheduled-jobs-are-not-working) * [Running rebuild from CLI](#running-rebuild-from-cli) * [Running clear cache from CLI](#running-clear-cache-from-cli) -* [EspoCRM is not loading after upgrade]( -#running-clear-cache-from-cli) * [EspoCRM is not loading after upgrade](#espocrm-is-not-loading-after-upgrade) * [MySQL error: The server requested authentication method unknown to the client](#mysql-error-the-server-requested-authentication-method-unknown-to-the-client) * [Web browser cache issue](#web-browser-cache-issue) -(#page-elements-are-corrupted-or-javascript-scenario-doesnt-work) * [Emails are not being fetched](#emails-are-not-being-fetched) * [Enabling debug mode for a logger](#enabling-debug-mode-for-a-logger) * [Admin password is lost, can't log in](#admin-password-is-lost-cant-log-in) @@ -31,7 +28,7 @@ For Ubuntu server, an apache error log is located at `/var/log/apache2/error.log ## Check system requirements -At Administration > System Requirements. It's important to have all required extensions installed. +At Administration -> System Requirements. It's important to have all required extensions installed. ## Scheduled Jobs are not working @@ -85,7 +82,8 @@ Sometimes you need to run rebuild from the command line interface when the appli ```bash php rebuild.php ``` -## Running rebuild from CLI + +## Running clear cache from CLI Sometimes you need to run clear cache from the command line interface when the application is not loading.