Article ID: 130443, created on Mar 16, 2017, last review on Apr 18, 2017

  • Applies to:
  • Operations Automation

Deployment instruction

alttext

Installation of Zabbix Server

  1. Select a container or a VM with CentOS 7 (2 CPU, 2 GB RAM, 512 GB Disk).
  2. Run the setup-zabbix-server.sh script to install the Zabbix Server.
  3. The Zabbix Server's Web interface is available at http://<IP address of Zabbix Server>/zabbix.
  • Login: Admin
  • Password: zabbix
  1. Import the OA Zabbix Template:
    1. Go to Configuration > Templates in the Zabbix Sever Web.
    2. Click Import and select the OA Zabbix Template file.
    3. Click Import.

Configuring OA MN monitoring

Note: For monitoring OA 7.x, you need to create a local YUM repository with OA Zabbix Java Gateway. For instruction, see Creating local YUM repository with OA Zabbix Java Gateway.

  1. Run the setup-zabbix-for-os-monitoring.sh script to install the Zabbix Agent (monitoring system components: CPU load, Memory used/free/total, and so on):

    sh setup-zabbix-for-os-monitoring.sh <Zabbix Server IP or Host> <node name>

    Where:

    • <Zabbix Server IP or Host> - IP address or Hostname of the Zabbix Server (required to send metrics from MN to Zabbix Server);
    • <node name> - a host name that is displayed in the Zabbix Server (host name in Zabbix Hosts);

    For example:

    sh setup-zabbix-for-os-monitoring.sh "10.10.1.1" "MN"

    An output is:

    Zabbix Proxy:
      Name: <Proxy name>
      PSK Identity: <Proxy PSK Identity>
      PSK: <Proxy PSK>
    Zabbix Agent:
      Name: <Host Name>
      PSK Identity: <Host PSK Identity>
      PSK: <Host PSK>
  2. Run the setup-zabbix-for-java-monitoring.sh script to install the Zabbix Java Gateway (monitoring JVM);

    sh setup-zabbix-for-java-monitoring.sh <Zabbix Server IP or Host> <node name>

    Where:

    • <Zabbix Server IP or Host> - IP address or Hostname of the Zabbix Server (required to send metrics from MN to Zabbix Server);
    • <node name> - host name that is displayed in the Zabbix Server (host name in Zabbix Hosts);

    For example:

    sh setup-zabbix-for-java-monitoring.sh "10.10.1.1" "MN"

    An output is:

    Zabbix Proxy:
      Name: <Proxy name>
      PSK Identity: <Proxy PSK Identity>
      PSK: <Proxy PSK>
    Zabbix Java Gateway:
      Secret: <Secret of Zabbix Java Gateway>
  3. Add the Zabbix Proxy:
    1. In Zabbix Sever Web, go to Administration > Proxies.
    2. Click Create proxy.
    3. Enter a <Proxy name> from the script's output into the Proxy name field.
    4. Select Active in Proxy mode.
    5. Open the Encryption tab.
    6. Check only PSK in Connections from proxy.
    7. Enter a <Proxy PSK Identity> from the script's output into the PSK identity field.
    8. Enter a <Proxy PSK> from the script's output into the PSK field.
    9. Click Add.
  4. Add the Host:
    1. In Zabbix Sever Web, go to Configuration > Hosts.
    2. Click Create host.
    3. Enter a <Host Name> from the script's output into the Host name field.
    4. Enter the <Host Name> into the New group field, or select it from Groups.
    5. Enter 127.0.0.1 into IP address and 10050 into Port of the Agent interfaces field.
    6. Enter 127.0.0.1 into IP address and 9990 into Port of the JMX interfaces field.
    7. Select the <Proxy name> in Monitored by proxy.
    8. Open the Templates tab.
    9. Select the OA MN Template template in Link new templates, and then click Add in Link new templates.
    10. Open the Encryption tab.
    11. Check only PSK in Connections from host.
    12. Enter a <Proxy PSK Identity> from the script's output into the PSK identity field.
    13. Enter a <Proxy PSK> from the script's output into the PSK field.
    14. Click Add.
  5. Configure JMX access:
    1. In Zabbix Sever Web, go to Configuration > Hosts.
    2. Select the added host of MN.
    3. Open the Items tab.
    4. In the TYPES subfilter, select JMX agent.
    5. Select all items in the table.
    6. Click Mass update.
    7. Enter a <Secret of Zabbix Java Gateway> from the script's output into the Password field.
    8. Click Update.
  6. Restart Zabbix services:

    service zabbix-proxy restart
    service zabbix-agent restart
  7. Remove a local YUM repository with OA Zabbix Java Gateway, if it was created:

    rm -f /etc/yum.repos.d/oa-zabbix-local.repo

Configuring OA UI node monitoring

Repeat steps from Configuring OA MN monitoring, but for the step 4.i, select the OA UI Node Template template.

Configuring OA Billing nodes monitoring

  1. Run the setup-zabbix-for-os-monitoring.sh script to install the Zabbix Agent (monitoring system components: CPU load, Memory used/free/total, and so on):

    sh setup-zabbix-for-os-monitoring.sh <Zabbix Server IP or Host> <node name>

    Where:

    • <Zabbix Server IP or Host> - IP address or Hostname of the Zabbix Server (required to send metrics from BN to Zabbix Server);
    • <node name> - a host name that is displayed in the Zabbix Server (host name in Zabbix Hosts);
     

    For example:

    sh setup-zabbix-for-os-monitoring.sh "10.10.1.1" "BN"

    An output is:

    Zabbix Proxy:
      Name: <Proxy name>
      PSK Identity: <Proxy PSK Identity>
      PSK: <Proxy PSK>
    Zabbix Agent:
      Name: <Host Name>
      PSK Identity: <Host PSK Identity>
      PSK: <Host PSK>
  2. Add the Zabbix Proxy:

    1. In Zabbix Sever Web, go to Administration > Proxies.
    2. Click Create proxy.
    3. Enter a <Proxy name> from the script's output into the Proxy name field.
    4. Select Active in Proxy mode.
    5. Open the Encryption tab.
    6. Check only PSK in Connections from proxy.
    7. Enter a <Proxy PSK Identity> from the script's output into the PSK identity field.
    8. Enter a <Proxy PSK> from the script's output into the PSK field.
    9. Click Add.
  3. Add the Host:
    1. In Zabbix Sever Web, go to Configuration > Hosts.
    2. Click Create host.
    3. Enter a <Host Name> from the script's output into the Host name field.
    4. Enter the <Host Name> into the New group field, or select it from Groups.
    5. Enter 127.0.0.1 into IP address and 10050 into Port of the Agent interfaces field.
    6. Select the <Proxy name> in Monitored by proxy.
    7. Open the Templates tab.
    8. Select the Template OS Linux Active template in Link new templates, and then click Add in Link new templates.
    9. Open the Encryption tab.
    10. Check only PSK in Connections from host.
    11. Enter a <Proxy PSK Identity> from the script's output into the PSK identity field.
    12. Enter a <Proxy PSK> from the script's output into the PSK field.
    13. Click Add.
  4. Restart Zabbix services:

    service zabbix-proxy restart
    service zabbix-agent restart
  5. Remove a local YUM repository with OA Zabbix Java Gateway, if it was created:

    rm -f /etc/yum.repos.d/oa-zabbix-local.repo

How to monitor

  • Create a screen for each node with the following graphs:

    • Memory usage
    • CPU load
    • CPU utilization
    • Heap Memory
    • Garbage Collector collections per second
    • Memory used of OA MN processes and PostgreSQL
    • CPU core utilization percentage of OA MN processes and PostgreSQL
    • Network traffic on <private network device>
    • Network traffic on <public network device>
    • Number of active sessions

  • Observe and analyze events on the Dashboard tab of Zabbix Server Web.


Creating local YUM repository with OA Zabbix Java Gateway

  • Create the /tmp/localrepo/RPMS directory on a node:

    mkdir -p /tmp/oa-zabbix-localrepo/RPMS
  • Copy the OA Zabbix Java Gateway rpm file to the created directory.
  • Run createrepo to generate metadata:

    createrepo /tmp/oa-zabbix-localrepo
  • Create a /etc/yum.repos.d/local.repo file:

  • echo "[oa-zabbix-local]
    name=OA Zabbix Local Repository
    baseurl=file:///tmp/oa-zabbix-localrepo
    enabled=1
    gpgcheck=0" >  /etc/yum.repos.d/oa-zabbix-local.repo

5356b422f65bdad1c3e9edca5d74a1ae caea8340e2d186a540518d08602aa065 e12cea1d47a3125d335d68e6d4e15e07

Email subscription for changes to this article
Save as PDF