Documentation
Table of Contents
6 Web interface installation
This section provides step-by-step instructions for installing Áú»¢¶Ä²© web interface. Áú»¢¶Ä²© frontend is written in PHP, so to run it a PHP supported webserver is needed.
You can find out more about setting up SSL for Áú»¢¶Ä²© frontend by referring to these best practices.
Welcome screen
Open Áú»¢¶Ä²© frontend URL in a browser. If you have installed Áú»¢¶Ä²© from packages, the URL is:
- for Apache: http://<server_ip_or_name>/zabbix
- for Nginx: http://<server_ip_or_name>
You should see the first screen of the frontend installation wizard.
Check of pre-requisites
Make sure that all software prerequisites are met.
| Pre-requisite | Minimum value | Description |
|---|---|---|
| PHP version | 7.2.0 | |
| PHP memory_limit option | 128MB | In php.ini: memory_limit = 128M |
| PHP post_max_size option | 16MB | In php.ini: post_max_size = 16M |
| PHP upload_max_filesize option | 2MB | In php.ini: upload_max_filesize = 2M |
| PHP max_execution_time option | 300 seconds (values 0 and -1 are allowed) | In php.ini: max_execution_time = 300 |
| PHP max_input_time option | 300 seconds (values 0 and -1 are allowed) | In php.ini: max_input_time = 300 |
| PHP session.auto_start option | must be disabled | In php.ini: session.auto_start = 0 |
| Database support | One of: MySQL, Oracle, PostgreSQL. | One of the following modules must be installed: mysql, oci8, pgsql |
| bcmath | php-bcmath | |
| mbstring | php-mbstring | |
| PHP mbstring.func_overload option | must be disabled | In php.ini: mbstring.func_overload = 0 |
| sockets | php-net-socket. Required for user script support. | |
| gd | 2.0.28 | php-gd. PHP GD extension must support PNG images (--with-png-dir), JPEG (--with-jpeg-dir) images and FreeType 2 (--with-freetype-dir). |
| libxml | 2.6.15 | php-xml |
| xmlwriter | php-xmlwriter | |
| xmlreader | php-xmlreader | |
| ctype | php-ctype | |
| session | php-session | |
| gettext | php-gettext Since Áú»¢¶Ä²© 2.2.1, the PHP gettext extension is not a mandatory requirement for installing Áú»¢¶Ä²©. If gettext is not installed, the frontend will work as usual, however, the translations will not be available. |
|
Optional pre-requisites may also be present in the list. A failed optional prerequisite is displayed in orange and has a Warning status. With a failed optional pre-requisite, the setup may continue.
If there is a need to change the Apache user or user group, permissions to the session folder must be verified. Otherwise Áú»¢¶Ä²© setup may be unable to continue.
Configure DB connection
Enter details for connecting to the database. Áú»¢¶Ä²© database must already be created.
If the TLS encryption option is checked, then additional fields for configuring the TLS connection to the database appear in the form (MySQL or PostgreSQL only).
Áú»¢¶Ä²© server details
Enter Áú»¢¶Ä²© server details.
Entering a name for Áú»¢¶Ä²© server is optional, however, if submitted, it will be displayed in the menu bar and page titles.
Pre-installation summary
Review a summary of settings.
Install
If installing from sources, download the configuration file and place it under conf/ in the webserver HTML documents subdirectory where you copied Áú»¢¶Ä²© PHP files to.
Providing the webserver user has write access to conf/ directory the configuration file would be saved automatically and it would be possible to proceed to the next step right away.
Finish the installation.
Log in
Áú»¢¶Ä²© frontend is ready! The default user name is Admin, password zabbix.
Proceed to getting started with Áú»¢¶Ä²©.