Views: 14556
Last Modified: 17.08.2021

System check

Settings -> Tools -> System check

The System check form helps to thoroughly examine the parameters compliance of system on which Bitrix Framework runs.

Click on image to enlarge

The form displays information grouped in the following sections.

  • Required parameters - shows parameters that are critical for proper functioning of Bitrix Site Manager.
  • Access check - displays results of checking the file system objects for reading and writing.
  • Recommended settings - contains missing parameters which are not critical for the system operation, but you should set them to recommended values if possible.
  • Modules - lists installed modules, or modules that can be installed.
  • Technical support - you can use this mini-form to quickly send a request to the Bitrix helpdesk. Describe the problem in detail in the text input field, and type your e-mail address.

    Most problems can be solved faster if the message contains information about the system kernel and the PHP extensions, which can be obtained via calling phpinfo(). You are strongly recommended to leave the option Attach phpinfo() return to message enabled.

File check

Settings -> Tools -> File checker

The File check form helps administrators control changes in the system files. Here an administrator can enter a check word (in fact, the word is a password which is known to the administrator only) and calculate the checksum of all files of the site. The checksum depends on the password. The password is not stored anywhere.

The check result file contains information on each file checksum and status. Store the file on your local computer to prevent its loss. In future, you can always perform the check again using the same check word and compare results.

Click on image to enlarge

PHP Settings

Settings -> Tools -> PHP Settings

This form displays the current PHP settings obtained by calling phpinfo().

SQL Query

Settings -> Tools -> SQL Query

You can use the SQL Query form to execute an arbitrary SQL command.

The system does not place any restrictions on your SQL queries. You must be extremely attentive when running statements like UPDATE, DELETE, DROP etc.

PHP Command Line

This form (Settings > Tools > PHP Command Line) can be used to run a PHP script on the server side.


Settings -> Tools -> Agents

The Agents technology allows running PHP functions (agents) at a specified time interval. When a page starts execution, the system automatically checks for pending agents and executes them if required.

The agent run time precision depends on the site traffic density and uniformity. If you need to precisely run any PHP function at the time specified, you should use cron, which is permitted by most hosting providers.

The report displays agents that currently exist in the system:

Click on image to enlarge

To add a new agent, click Add on the toolbar.


Settings -> Tools -> Backup

To help developers move their sites between servers, the system offers a special facility allowing to create back-up copies of the site. It can:

  • create back-up copy of all files (tar.gz);
  • exclude kernel folders;
  • exclude files exceeding the specified limit;
  • export (dump) database tables (tar.gz);
  • exclude statistics and the search index from the dump.

Click on image to enlarge

All created files can be downloaded from the site and used on the other server.

To extract files from the archive, you will use the special script which is uploaded to the server with the archive.

Database check

If you encounter errors with MySQL /MyISAM tables, you can use the built-in database tool to check and repair tables.

Please note the following.
  1. The database check tool can be used with MySQL / MyISAM tables only.
  2. To run the database check tool, open Settings -> Tools -> Database check and click Check /repair tables:

    Click on image to enlarge

    Click on image to enlarge

    In case the statistics tables are damaged and you cannot access the Control Panel, you can disable statistics by supplying ?no_keep_statistic_LICENSE-KEY=Y in the page URL. Replace LICENSE-KEY with your valid license key, literally.

  3. As a last remedy, you can run the database check script (/bitrix/admin/repair_db.php) without having to access the Control Panel.

    To run the script, you will need to supply the database login and password in the URL. For example: password=DB_Password

    If these parameters are omitted, their default values will be taken from /bitrix/php_interface/dbconn.php.

    Situations may happen when a site denies to reply and returns an empty page to visitors. In this case, open bitrix/php_interface/dbconn.php (contains the database connection parameters), and set the following parameter: $DBDebug = true;

    This will cause the error message to be printed. The message usually contains names of damaged tables. If the database damage is the case, you are recommended to use the built-in database check and repair tool. This will allow you to restore the site functionality in the shortest possible time.

Courses developed by «Bitrix», Inc.