diff --git a/docs/administration/troubleshooting.md b/docs/administration/troubleshooting.md index eca7599ba..8e8f21119 100644 --- a/docs/administration/troubleshooting.md +++ b/docs/administration/troubleshooting.md @@ -6,8 +6,10 @@ In this article: * [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 clear cache from CLI](#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) * [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) @@ -26,7 +28,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 @@ -68,14 +70,28 @@ 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). +#### Problem #3: Cron is disabled + +Check in Administration -> Settings -> Disable Cron parameter. + ## Running rebuild from CLI Sometimes you need to run rebuild from the command line interface when the application is not loading. +* To rebuild: ```bash php rebuild.php ``` +## Running clear cache 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 +``` + ## EspoCRM is not loading after upgrade Sometimes it can happen on some shared hostings. @@ -95,6 +111,15 @@ 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 + +1. Press Ctrl + F5 -> 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. + ## 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.