Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Troubleshooting #698

Open
wants to merge 5 commits into
base: master
Choose a base branch
from
Open

Troubleshooting #698

Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
6fe799b
troubleshooting upgrade
Apr 12, 2021
d99ee7e
troubleshooting upgrade
Apr 12, 2021
3593656
troubleshooting upgrade
Apr 12, 2021
32e0c7b
troubleshooting upgrade
Apr 12, 2021
357970d
troubleshooting upgrade
Apr 12, 2021
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 26 additions & 1 deletion docs/administration/troubleshooting.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand All @@ -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.
Copy link
Contributor

@yurikuzn yurikuzn Apr 13, 2021 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should > be used instead of ->. Everywhere in all articles.


## Scheduled Jobs are not working

Expand Down Expand Up @@ -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.
Expand All @@ -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;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Inconsistency. Having ending with ; in items 1 and 2 but . in 3 and 4.


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