diff --git a/docs/index.rst b/docs/index.rst index 644e678a23..9804d126c7 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -17,4 +17,5 @@ Table of contents infra/puppet_master_deployment infra/seed_server_deployment infra/third_party + infra/zabbix_server_deployment packaging diff --git a/docs/infra/zabbix_server_deployment.rst b/docs/infra/zabbix_server_deployment.rst new file mode 100644 index 0000000000..777ce25052 --- /dev/null +++ b/docs/infra/zabbix_server_deployment.rst @@ -0,0 +1,58 @@ +Zabbix server +============= + +Zabbix is an open source tool designed for servers, services, and network +monitoring. + +Deployment +---------- + +Zabbix can be deployed on a virtual machine with at least 1 GB RAM and 1 CPU. +The HW requirements vary and depend on the potential Zabbix's server load and +place of the database engine, for example, MySQL, regardless of whether it is +located on the same host or on a dedicated one. + +The puppet-manifests repository contains an example ``zbxserver`` role +that can be used as a starting point for Zabbix server deployment. + +To deploy Zabbix, perform the following tasks: + +#. Install base Ubuntu 14.04 with SSH service and set appropriate FQDN. + +#. Install puppet agent package: + + .. code-block:: console + + apt-get update; apt-get install -y puppet + +#. Enable puppet agent: + + .. code-block:: console + + puppet agent --enable + +#. Run the Jenkins Master deployment: + + .. code-block:: console + + FACTER_ROLE=zbxserver FACTER_LOCATION=us1 puppet agent -tvd \ + --server puppet-master.test.local --waitforcert 60 + +The last action requests the client's certificate. To continue the puppet run, +the certificate should be signed from the Puppet Master. + +Import templates +---------------- + +You can import templates and related items, such as triggers, that comes from +Fuel's Zabbix production server. To do this, complete the following tasks: + +#. Clone the ``tools/zabbix-maintenance`` repository: + + .. code-block:: console + + git clone https://review.fuel-infra.org/tools/zabbix-maintenance + +#. In the Zabbix server web UI, navigate to :guilabel:`Configuration -> + Templates`. Import the required template file using the :guilabel:`Import` + button.