{"id":35438,"date":"2023-10-05T11:36:28","date_gmt":"2023-10-05T16:36:28","guid":{"rendered":"https:\/\/www.filecloud.com\/blog\/?p=35438"},"modified":"2025-04-16T07:37:36","modified_gmt":"2025-04-16T12:37:36","slug":"monitor-filecloud-server-with-zabbix","status":"publish","type":"post","link":"https:\/\/www.filecloud.com\/blog\/monitor-filecloud-server-with-zabbix\/","title":{"rendered":"Monitor FileCloud Server with Zabbix"},"content":{"rendered":"

Note: this blog post is intended for system and IT administrators who manage FileCloud Server environments.<\/em><\/p>\n

FileCloud Server is a powerful on-prem file sharing and data governance solution for enterprises and institutions around the world. One of FileCloud\u2019s strengths is the ability to integrate with third-party applications<\/a> to better serve an organization; these include Active Directory and LDAP, Windows file servers, Salesforce, Microsoft and Google productivity apps, even security tools for SAML SSO, antivirus, malware protection, and SIEM.<\/p>\n

In this article, we will describe how Zabbix, an open-source software, can be used to monitor a FileCloud Server environment.<\/p>\n

What is Zabbix?<\/h2>\n

Zabbix<\/a> is an open-source monitoring software tool for diverse IT components, including networks, servers, virtual machines (VMs), and cloud services. Zabbix provides monitoring metrics, such as network utilization, CPU load, and disk space consumption.<\/p>\n

The software is capable of monitoring operations across operating systems, including Linux, Hewlett Packard Unix (HP-UX), Mac OS X, and Solaris; however, Windows monitoring is only possible through agents.<\/p>\n

Zabbix can be deployed for agent-based and agentless monitoring:<\/p>\n

Agent-based Monitoring<\/h3>\n

Agents are installed on IT components to check performance and collect data. The agent then reports back to a centralized Zabbix management server. That information is included in reports or presented visually in the Zabbix graphical user interface (GUI). If any issues are detected, Zabbix will notify or alert the user.<\/p>\n

Agentless Monitoring<\/h3>\n

Agentless monitoring accomplishes the same type of monitoring by leveraging the existing resources within a system or device to emulate an agent. The Zabbix web-based GUI enables users to view their IT environment via customizable dashboards based on widgets, graphs, network maps, slideshows, and reports<\/p>\n

Requirements to Configure FileCloud and Zabbix<\/h2>\n

In this scenario, FileCloud Server has been installed in three nodes, as per the table below. (Note: MongoDB works in replica sets, and a minimum of 3 nodes are required.)<\/em><\/p>\n

You can monitor a single node installation using the same steps. The FileCloud Server nodes are following the FileCloud Requirements<\/a>.<\/p>\n\n\n\n\n\n\n
Server name<\/strong><\/td>\nIP<\/strong><\/td>\nServer Role<\/strong><\/td>\n<\/tr>\n
FCserver1.localdomain<\/strong><\/td>\n192.168.10.241<\/strong><\/td>\nWeb, DB<\/strong><\/td>\n<\/tr>\n
FCserver2.localdomain<\/strong><\/td>\n192.168.10.242<\/strong><\/td>\nWeb, DB<\/strong><\/td>\n<\/tr>\n
FCserver3.localdomain<\/strong><\/td>\n192.168.10.243<\/strong><\/td>\nWeb, DB<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

We also have a Zabbix Appliance which is installed under AlmaLinux 8 (x86_64):<\/p>\n\n\n\n\n
Server name<\/strong><\/td>\nIP<\/strong><\/td>\n<\/tr>\n
appliance<\/strong><\/td>\n192.168.10.230<\/strong><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Configure FileCloud and Zabbix<\/h2>\n
    \n
  1. Install FileCloud Server.<\/a><\/li>\n
  2. Configure the FileCloud instance.<\/a><\/li>\n
  3. Configure FileCloud High-Availability<\/a> (skip this step if you are using a FileCloud Server single-node installation).<\/li>\n
  4. Install Zabbix Appliance<\/a> (this provides all the required Zabbix components in the fastest deployment. Download the ISO and use it as a source installation image. You can read more detailed installation instructions in the Zabbix documentation<\/a>.)<\/li>\n<\/ol>\n

    The default user\/password for Zabbix Appliance and Zabbix Frontend are below:<\/p>\n

    Zabbix Appliance<\/strong><\/p>\n

    root:zabbix<\/p>\n

    Zabbix Frontend<\/strong><\/p>\n

    Admin:zabbix<\/p>\n

    Specify Static IP Address<\/h3>\n

    The appliance uses DHCP to obtain the IP address by default. Follow the below steps to specify a static IP address:<\/p>\n

      \n
    1. Log in as root user.<\/li>\n
    2. Open \/etc\/sysconfig\/network-scripts\/ifcfg-eth0 <\/strong>file.<\/li>\n
    3. Replace BOOTPROTO=dhcp<\/strong> with BOOTPROTO=none<\/strong>.<\/li>\n
    4. Add the following lines:<\/li>\n<\/ol>\n
      IPADDR=<IP address of the appliance>\r\nPREFIX=<CIDR prefix>\r\nGATEWAY=<gateway IP address>\r\nDNS1=<DNS server IP address><\/strong><\/pre>\n
      Example:<\/p>\n
      [root@appliance network-scripts]# cat ifcfg-eth0\r\nDEVICE=\"eth0\"\r\nBOOTPROTO=none\r\nNM_CONTROLLED=\"no\"\r\nPERSISTENT_DHCLIENT=1\r\nONBOOT=\"yes\"\r\nTYPE=Ethernet\r\nDEFROUTE=yes\r\nPEERDNS=yes\r\nPEERROUTES=yes\r\nIPV4_FAILURE_FATAL=yes\r\nNAME=\"eth0\"\r\nIPADDR=192.168.10.230\r\nPREFIX=24\r\nGATEWAY=192.168.10.1\r\nDNS1=192.168.10.230\r\nDNS2=192.168.10.230<\/pre>\n
      After making these changes, run the systemctl restart network<\/strong> command to implement the new IP settings.<\/p>\n
      Set the System Clock<\/h3>\n
      By default, the appliance uses UTC for the system clock. To change the time zone, copy the appropriate file from \/usr\/share\/zoneinfo<\/strong> to \/etc\/localtime<\/strong> as per the below example:<\/p>\n
      (here, we are using \u201cSao Paulo.\u201d)<\/p>\n
      [root@appliance ~]# cp \/usr\/share\/zoneinfo\/America\/Sao_Paulo \/etc\/localtime\r\ncp: overwrite '\/etc\/localtime'? y\r\n[root@appliance ~]#<\/pre>\n
      Log in to Zabbix<\/h3>\n
      Log in to the Zabbix Frontend by opening http:\/\/host<\/a>; for our example, we are using http:\/\/192.168.10.230<\/a>:<\/p>\n
      <\/p>\n
      Install Zabbix on FileCloud Server Node(s)<\/h2>\n
        \n
      1. Install the Zabbix agent on each FileCloud Server node, as per the below steps:<\/li>\n
      2. Install the Zabbix repository by running the below commands:<\/li>\n<\/ol>\n
        rpm -Uvh https:\/\/repo.zabbix.com\/zabbix\/6.4\/rhel\/9\/x86_64\/zabbix-release-6.4-1.el9.noarch.rpm \r\ndnf clean all<\/pre>\n
          \n
        1. Install Zabbix Agent 2 by running the below command:<\/li>\n<\/ol>\n
          yum install -y zabbix-agent2.x86_64<\/pre>\n
            \n
          1. Edit the file \/etc\/zabbix\/zabbix_agent2.conf <\/strong>on each FileCloud Server node and change the following parameters as per the below example:<\/li>\n<\/ol>\n
            Server=192.168.10.230<\/strong>\r\nServerActive=192.168.10.230<\/strong>\r\nHostMetadata=Linux<\/strong>\r\nHostnameItem=system.hostname\u00a0 <\/strong><\/pre>\n
            (The \u201cHostnameITEM\u201d parameter does not exist in zabbix_agentd.conf \u2014 you need to manually add it)<\/p>\n
              \n
            1. Restart the Zabbix Agent on each FileCloud Server node by running the below command:<\/li>\n<\/ol>\n
              systemctl restart zabbix-agent2.service<\/pre>\n
                \n
              1. Enable the Zabbix agent to be started upon boot:<\/li>\n<\/ol>\n
                systemctl enable --now zabbix-agent2.service<\/pre>\n
                  \n
                1. Add a firewall rule for Zabbix agent (FileCloud servers) and HTTP\/HTTPS protocols:<\/li>\n<\/ol>\n
                  firewall-cmd --add-service={http,https} \u2013permanent\r\nfirewall-cmd --add-port={10051\/tcp,10050\/tcp} \u2013permanent\r\nfirewall-cmd \u2013reload<\/pre>\n
                  Create Hosts in Zabbix GUI<\/h2>\n
                  Now, let\u2019s create a new host in Zabbix GUI following the below steps:
                  \n(These steps will need to be done for each FileCloud Server node.)<\/em><\/p>\n
                    \n
                  1. Click on \u201cMonitoring<\/strong>\u201d > \u201cHosts<\/strong>\u201d > \u201cCreate Host<\/strong>\u201d. <\/li>\n
                  2. Add the \u201cHost name<\/strong>\u201d of each FileCloud Server node. <\/li>\n
                  3. On \u201cTemplates<\/strong>\u201d, find \u201cApache by Zabbix agent,<\/strong>\u201d \u201cMongoDB node by Zabbix agent2,<\/strong>\u201d and \u201cLinux by Zabbix agent<\/strong>\u201d.<\/li>\n
                  4. On \u201cHost groups<\/strong>\u201d, click on \u201cSelect\u201d<\/strong> then choose \u201cLinux servers<\/strong>\u201d.<\/li>\n
                  5. On \u201cInterfaces,<\/strong>\u201d click on \u201cAdd<\/strong>\u201d > \u201cAgent<\/strong>\u201d then replace \u201c127.0.0.1\u201d by each FileCloud Server node\u2019s IP.<\/li>\n
                  6. Click on \u201cAdd<\/strong>\u201d.<\/li>\n<\/ol>\n
                    The FileCloud Server nodes were successfully added to Zabbix:<\/p>\n
                    <\/p>\n
                    Configure Apache Monitoring on FileCloud<\/h2>\n
                    Follow the below steps to have Apache monitoring in place:
                    \n(This needs to be executed on each FileCloud Server node.)<\/em><\/p>\n
                      \n
                    1. Create the file \/etc\/httpd\/conf.modules.d\/status.conf<\/strong>.<\/li>\n
                    2. Add the below lines and replace 168.10.230<\/strong> with your Zabbix Appliance IP:<\/li>\n<\/ol>\n
                      <Location \"\/server-status\">\r\nSetHandler server-status\r\nRequire ip 192.168.10.230\r\n<\/Location><\/pre>\n
                        \n
                      1. Restart the httpd service using the below command:<\/li>\n<\/ol>\n
                        systemctl restart httpd<\/pre>\n
                        Configure MongoDB Monitoring on FileCloud<\/h2>\n
                        Follow the below steps to have MongoDB monitoring in place:
                        \n(This needs to be executed on the primary MongoDB node if you are using HA in FileCloud; if not, run this command on the single MongoDB node.)<\/em><\/p>\n
                        Here, we are creating the zabbix_mon<\/strong> user with zabbix_mon<\/strong> as the password.<\/p>\n
                        db.createUser(\r\n{\r\nuser: \"zabbix_mon\",\r\npwd: \"zabbix_mon\",\r\nroles: [ { role: \"userAdminAnyDatabase\", db: \"admin\" } ]\r\n}\r\n)<\/pre>\n
                        Install the Zabbix MongoDB plugin running the below command on each FileCloud Server node:<\/p>\n
                        yum install zabbix-agent2-plugin-mongodb -y<\/pre>\n
                        Configure the MongoDB Template<\/h3>\n
                          \n
                        1. Go to \u201cData collection<\/strong>\u201d > \u201cHosts<\/strong>\u201d, then click on any FileCloud Server node.<\/li>\n
                        2. Click on \u201cMongoDB cluster by Zabbix agent 2.<\/strong>\u201d<\/li>\n
                        3. A new browser window will be opened as per the image below; click on \u201cMacros.\u201d<\/li>\n
                        4. Change the parameters \u201c{$MONGODB.CONNSTRING}\u201d<\/strong> | \u201c{$MONGODB.PASSWORD}\u201d<\/strong> and \u201c{$MONGODB.USER}\u201d<\/strong> as per the below example:\n