Deploy Director Service on a Separate Node

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

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 the ad-director (Agents must be configured). If it’s already deployed, uninstall it using accelo deploy add-ons and unselect Director (Agents MUST be configured).
• You have already configured the standalone node. If not, run accelo set standalone after the initial prompt to run accelo init.

Deploy ad-director as a Standalone add-on

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

1. On the standalone node, run the following command to generate ad-director.yml if it doesn’t exist. If Director (Agents MUST be configured) is already deployed and ad-director.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-director
Open the file in a text editor and make changes to the value of the following fields:

• ACTIONS_DB_URI: Set it to the value of the environment variable MONGO_URI, which by default, is encrypted.
• ACTIONS_EXTERNAL_URL: Replace the value of localhost with the hostname of the core node.
• 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-director.yml.orig ad-director.yml
- NOTIFICATIONS_HOST=ad-notifications | - NOTIFICATIONS_HOST=plat03.acceldata.dvl
- ACTIONS_EXTERNAL_URL=http://localhost:4000 | - ACTIONS_EXTERNAL_URL=http://plat01.acceldata.dvl:4000
- ACTIONS_DB_URI=ZN4v8cuUTXYvdnDJIDp+R8Z+ZsVXXjv8zDOvh8Uw | - ACTIONS_DB_URI=ZN4v8cuUTXYvdnDJIDp+R8Z+ZsVXXjv8zDOvh8Uw

1. On the core node, backup $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 = [
........
Make changes to the value of the following fields using a text editor:

• uri: Change its value to the value of ACTIONS_DB_URI, which you have done in the previous step.
• host: Change its value from ad-elastic to the host/hosts where Logsearch is deployed.

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

accelo admin database push-config -a

1. 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:

• ACTIONS_IP: Set its value to the hostname of the node where you’ll deploy ad-director.
• ACTIONS_PORT: Set its value to 19016.

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
> - ACTIONS_IP=plat03.acceldata.dvl
> - ACTIONS_PORT=19016

1. On the standalone node where ad-notifications is deployed, run the following command to generate ad-notifications.yml if it doesn’t exist.

accelo admin makeconfig ad-notifications
Open the file in a text editor and make changes to the value of the following fields.

• DIRECTOR_HOST: Set it to the hostname of the node where the ad-director will be deployed.
• DIRECTOR_PORT: Set it to 19016.

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

[root@plat03:addons (ad-default)]$ diff -y --suppress-common-lines ad-notifications.yml.orig ad-notifications.yml
- DIRECTOR_HOST=ad-director | - DIRECTOR_HOST=plat03.acceldata.dvl
- DIRECTOR_PORT=8000 | - DIRECTOR_PORT=19016

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

tar -cvf work_dir2.tar.gz $(ls -d work/*/director) config/krb/security/krb5.conf
It generates a tar file in $AcceloHome named work_dir2.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.

tar -xvf work_dir2.tar.gz

1. On the standalone node, run the following command and select Director (Agents MUST be configured).

accelo deploy addons

1. On the standalone node, deploy Playbooks. For details, see Deploy Playbooks.
2. On the core node, run the following command.

accelo restart ad-graphql

tar -cvf work_dir2.tar.gz $(ls -d work/*/director) config/krb/security/krb5.conf

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_dir2.tar.gz
3. On the standalone node, run accelo restart ad-director.

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

tar -cvf work_dir2.tar.gz $(ls -d work/*/director) config/krb/security/krb5.conf

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_dir2.tar.gz.
3. On the standalone node, run accelo restart ad-director.