Deploying the Alerts Component on a Standalone Node

This documentation provides the steps needed to deploy ad-alerts as a standalone add-on.

You can deploy ad-alerts as a standalone add-on when its CPU usage is higher, which leads to constraints on the node.

Prerequisites

Ensure the following criteria are met:

  • You are using “Pulse 3.5.0 or higher” or “Pulse 3.4.3 or higher”.
  • You have not deployed Alerts (Agents must be configured). If it’s already deployed, uninstall it using accelo deploy add-ons and unselect Alerts (Agents must be configured).
  • You have already deployed ad-director.
  • You have already configured the standalone node. If not, run accelo set standalone after the initial prompt to run accelo init.

Deploy ad-alerts as a Standalone add-on

Follow the steps listed below to successfully deploy ad-alerts as a standalone add-on.

  1. On the standalone node, run the following command to generate ad-alerts.yml if it doesn’t exist already. If Alerts (Agents MUST be configured) is already deployed and ad-alerts.yml does exist under $AcceloHome/config/docker/addons on the node where it was previously deployed, copy it over to the same location i.e. $AcceloHome/config/docker/addons on the standalone node.
Bash
Copy

Open the file in a text editor and make changes to the value of the following fields.

  • ALERTS_DB_URI: Set it to the value of the environment variable MONGO_URI, which by default, is encrypted.
  • NOTIFICATIONS_HOST: Set it to the node's hostname where ad-notifications is deployed.

If done correctly, the following details appear on the screen.

Bash
Copy
  1. On the core node, back up $AcceloHome/config/acceldata_<cluster_name>.conf. Open the file in a text editor and navigate to the following section.
Bash
Copy

Under connections, make the following changes:

  • mongo:

    • uri: Change its value for all Mongo connections to the value of ALERTS_DB_URI, whose value you have changed in the previous step.
  • elastic:

    • host: Change its value from ad-elastic to the host/hosts where Logsearch is deployed.

For the connection named fsanalytics, it's the host where FS Elasticis deployed.

- port: Change its value to 19013.

  • Vm:
    • readURL: In this field, replace the following details:
      • ad-vmselect with a hostname of the node where the core services are deployed.
      • 8481 with 19042.

Save your changes. If done correctly, the following details appear on the screen.

Bash
Copy

Repeat the above steps for all cluster configuration files.

  1. Run the following command to push the configuration.
Bash
Copy
  1. On the core node, run the following command to generate ad-core.yml if it doesn’t exist already.
Bash
Copy

Open the file in a text editor and navigate to the following section.

Bash
Copy

Add the following environment variables under the section environment:

  • ALERTS_IP: Set its value to the hostname of the node where you’ll deploy ad-alerts.
  • ALERTS_PORT: Set its value to 19015.

Save your changes. If done correctly, the following details appear on the screen.

Bash
Copy
  1. On the core node, navigate to $AcceloHome and run the following command.
Bash
Copy

It generates a tar file in $AcceloHome named work_dir.tar.gz which needs to be copied over to $AcceloHome on the standalone node. One way to copy would be using SCP or an NFS export.

  1. On the standalone node, navigate to $AcceloHome and run the following command.
Bash
Copy
  1. On the core node, restart all services by running the following command.
Bash
Copy
  1. On the standalone node, run the following command and select Alerts (Agents MUST be configured).
Bash
Copy

When you run accelo reconfig cluster or accelo reconfig cluster -a to perform the following steps:

  1. Update the value of readURL $AcceloHome/config/acceldata_<cluster_name>.conf.
  2. Run accelo admin database push-config -a.
  3. On the core node, navigate to $AcceloHome and run the following command.

tar -cvf work_dir.tar.gz $(ls -d work/*/alerts)

  1. Copy work_dir.tar.gz over to the standalone node.
  2. On the standalone node, navigate to $AcceloHome and run the following command.

tar -xvf work_dir.tar.gz

  1. On the standalone node, run accelo restart ad-alerts.

Ensure that you do not run accelo config alerts notifications on the standalone node.

When you run accelo config alerts notifications to perform the following steps:

  1. On the core node, navigate to $AcceloHome and run the following command.

tar -cvf work_dir.tar.gz $(ls -d work/*/alerts)

  1. Copy work_dir.tar.gz over to the standalone node.
  2. On the standalone node, navigate to $AcceloHome and run the following command.
  3. On the standalone node, run accelo restart ad-alerts.
Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard