Install Agents Using Ambari UI

This page describes the installation of Pulse Hydra Agent using the Ambari UI with Mpack.

Deploy the Hydra Agent

1. Download the Tarball in the Ambari server and save it as /tmp/hystaller_mpack<version>.tar.gz .

wget <S3 LINK FROM LICENSE UI> -O "hystaller_mpack<version>.tar.gz"

2. Install hystaller_mpack<version>.tar.gz in Ambari Server.

ambari-server install-mpack --mpack=/tmp/hystaller_mpack<version>.tar.gz -v

3. Add the Hydra Service symlink in the service list of Ambari.

cd /var/lib/ambari-server/resources/stacks/<Cluster_type>/<Cluster_version>/services

ln -s /var/lib/ambari-server/resources/mpacks/ambari-hydra-agent-mpack-<hydra_version>/common-services/PULSE_HYDRA_AGENT/<hydra_version> PULSE_HYDRA_AGENT

4. Restart ambari-server.

ambari-server restart

It must now restart the server with logs stating Server started listening on 8080.

5. Navigate to the Ambari UI and select Add Service .

6. Select Hydra from the services list and select the nodes to deploy hydra.

7. Edit the configurations as per the requirements.

8. Select Deploy to install and start Hydra in respective hosts.

9. Once deployment is successful, we can get the status of each hydra agent as well as the status of pulsenode, pulselog, pulsejmx.

Install the Hydra Agent on Newly Added Hosts

The Hydra Agent must be installed on at least one node in a cluster.

1. Run the following commands on the Ambari node.

curl -s -u admin:admin http://0.0.0.0:8080/api/v1/hosts|grep host_name|sed -n 's/.*"host_name" : "\([^\"]*\)".*/\1/p'>hostcluster.txt

​

while read line ; do j=$line;  mkdir -p $j;  curl -u admin:admin -H "X-Requested-By:ambari" -i -X  POST http://0.0.0.0:8080/api/v1/clusters/<CLUSTER_NAME>/hosts/$j/host_components/PULSE_HYDRA_AGENT; done < hostcluster.txt

​

while read line ; do j=$line;  mkdir -p $j;  curl -u admin:admin -H "X-Requested-By:ambari" -i -X  PUT -d '{"HostRoles": {"state": "INSTALLED"}}' http://0.0.0.0:8080/api/v1/clusters/<CLUSTER_NAME>/hosts/$j/host_components/PULSE_HYDRA_AGENT; done < hostcluster.txt

​

while read line ; do j=$line;  mkdir -p $j;  curl -u admin:admin -H "X-Requested-By:ambari" -i -X  PUT -d '{"HostRoles": {"state": "STARTED"}}' http://0.0.0.0:8080/api/v1/clusters/<CLUSTER_NAME>/hosts/$j/host_components/PULSE_HYDRA_AGENT; done < hostcluster.txt

The Hydra Agent is installed on all the nodes. Restart if required.

Test your Agent Configuration Changes

If you made any changes to telegraph(node agent), filebeat(logs agent) or jmx(jmx agent), and you want to test your feature, then:

1. Build the Hydra test image from bitbucket and tag to running ad-hydra container and restart ad-hydra.
2. From the Ambari server, stop the Hydra service.
3. Delete the Hydra service.
4. Add the Hydra Service, follow the above Images and provide Hydra Server URL, Hydra Installer Repository, PULSE UI URL and deploy.
5. From Pulse node, do reconfig cluster, wait for ~2 minutes.
6. Then check your changes on the nodes for your changes.

Uninstall Pulse Hydra Agent using Ambari UI

You can uninstall Hydra Agents from the nodes directly using the Ambari UI.

The Pulse Hydra Agent comprises all agents, including Node, Logs, JMX, AXN, YARN Metrics, and Hydra.

Steps to uninstall Hydra Agents:

1. In the Amabari UI, navigate to Services > Hydra.

2. In the Hydra Summary page, click Hydra Agents. The list of hosts where Hydra Agents are installed appears on the screen.

3. Select each host and click Components. The list of components installed appears. Locate Hydra Agents and click the three dots next to them, and repeat the steps below for each host in the same order.

   1. Select Stop. This stops all Hydra Agents installed on the host.
   2. Select Uninstall. This uninstalls all Hydra Agents from each host.
   3. Select Delete. This deletes all Hydra Agents from each host.

4. In the Hydra Summary, click Actions > Delete Service.

5. Run the uninstall Mpack command of the Ambari host using the CLI

ambari-server uninstall-mpack --mpack-name=ambari-hydra-agent-mpack -v

Validate Pulse Installations

Run the following command to validate Pulse installation.

accelo info

You get output as shown in the following image.