Troubleshooting

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.