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 unselectAlerts
(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 runaccelo 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. IfAlerts
(Agents MUST be configured) is already deployed andad-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 variableMONGO_URI
, which by default, is encrypted.NOTIFICATIONS_HOST
: Set it to the node's hostname wheread-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 ofALERTS_DB_URI,
whose value you have changed in the previous step.
elastic:
host
: Change its value fromad-elastic
to the host/hosts whereLogsearch
is deployed.
For the connection named fsanalytics
, it's the host where FS Elastic
is 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
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
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.
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.