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.
- 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.
accelo admin makeconfig ad-alerts
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.
[root@plat03:addons (ad-default)]$ diff -y --suppress-common-lines ad-alerts.yml.original ad-alerts.yml
- ALERTS_DB_URI=ZN4v8cuUTXYvdnDJIDp+R8Z+ZsVXXjv8zDOvh8UwQ | - ALERTS_DB_URI=ZN4v8cuUTXYvdnDJIDp+R8Z+ZsVXXjv8zDOvh8UwQ
- NOTIFICATIONS_HOST=ad-notifications | - NOTIFICATIONS_HOST=plat01.acceldata.dvl
- 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.
# General dependencies are expressed as accessible service url's. Spark, Yarn,
# ATS, Hive Metastore, Spark and Webhdfs urls are required.
# At this point in time, AccelData does not support compression by default.
group {
name = "odp_zoro"
displayName = "odp_zoro"
originalName = "ODP_Zoro"
distroType = "HWX"
onprem = true
active = true
priority = 1000
connections = {
mongo = [
........
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.
Important
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.
- readURL: In this field, replace the following details:
Save your changes. If done correctly, the following details appear on the screen.
[root@plat01:config (ad-default)]$ diff -y --suppress-common-lines acceldata_odp_zoro.conf.orig acceldata_odp_zoro.conf
uri = "ZN4v8cuUTXYvdnDJIDp+R8Z+ZsVXXjv8zDOvh8UwQXosC8 | uri = "ZN4v8cuUTXYvdnDJIDp+R8Z+ZsVXXjv8zDOvh8UwQXrMzw
uri = "ZN4v8cuUTXYvdnDJIDp+R8Z+ZsVXXjv8zDOvh8UwQXosC8 | uri = "ZN4v8cuUTXYvdnDJIDp+R8Z+ZsVXXjv8zDOvh8UwQXrMzw
host = "ad-elastic" | host = "plat01.acceldata.dvl"
port = 9200 | port = 19013
host = "ad-elastic" | host = "plat01.acceldata.dvl"
port = 9200 | port = 19013
host = "ad-elastic" | host = "plat01.acceldata.dvl"
port = 9200 | port = 19013
readURL = "http://ad-vmselect:8481/select/1385609323/ | readURL = "http://plat01.acceldata.dvl:19042/select/1
Important
Repeat the above steps for all cluster configuration files.
- Run the following command to push the configuration.
accelo admin database push-config -a
- On the core node, run the following command to generate ad-core.yml if it doesn’t exist already.
accelo admin makeconfig ad-core
Open the file in a text editor and navigate to the following section.
ad-graphql:
image: ad-graphql
container_name: ""
environment:
....................
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.
[root@plat01:docker (ad-default)]$ diff -y --suppress-common-lines ad-core.yml.orig ad-core.yml
> - ALERTS_IP=plat03.acceldata.dvl
> - ALERTS_PORT=19015
- On the core node, navigate to $AcceloHome and run the following command.
tar -cvf work_dir.tar.gz $(ls -d work/*/alerts)
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.
- On the standalone node, navigate to $AcceloHome and run the following command.
tar -xvf work_dir.tar.gz
- On the core node, restart all services by running the following command.
accelo restart all -d
- On the standalone node, run the following command and select Alerts (Agents MUST be configured).
accelo deploy addons
Info
When you run accelo reconfig cluster or accelo reconfig cluster -a to perform the following steps:
- Update the value of readURL $AcceloHome/config/acceldata_<cluster_name>.conf.
- Run accelo admin database push-config -a.
- On the core node, navigate to $AcceloHome and run the following command.
tar -cvf work_dir.tar.gz $(ls -d work/*/alerts)
- Copy work_dir.tar.gz over to the standalone node.
- On the standalone node, navigate to $AcceloHome and run the following command.
tar -xvf work_dir.tar.gz
- On the standalone node, run accelo restart ad-alerts.
Ensure that you do not run accelo config alerts notifications on the standalone node.
Info
When you run accelo config alerts notifications to perform the following steps:
- On the core node, navigate to $AcceloHome and run the following command.
tar -cvf work_dir.tar.gz $(ls -d work/*/alerts)
- Copy work_dir.tar.gz over to the standalone node.
- On the standalone node, navigate to $AcceloHome and run the following command.
- On the standalone node, run accelo restart ad-alerts.
