Appendix A: Install a Fleet-managed Elastic Agent
editAppendix A: Install a Fleet-managed Elastic Agent
editThis guide describes how to:
- Install an Elastic Agent that will be managed with Fleet
- Enroll the Elastic Agent in Fleet
These steps assume that Elastic Stack is running and an Elastic Integration has been added in Kibana. If this is not true — don’t worry, check out one of the Quick Starts and get started with Elastic Cloud.
You can install only a single Elastic Agent per host.
Prerequisites
edit- The Elastic Stack is running.
- You have added an integration in Kibana and are now ready to download and enroll Elastic Agent on your system.
Step 1: Add an Elastic Agent to Fleet
editElastic Agent is a single, unified agent that you can deploy to hosts or containers to collect data and send it to the Elastic Stack. Behind the scenes, Elastic Agent runs the Beats shippers or Elastic Endpoint required for your configuration.
Choose the operating system and run the provided commands to download and extract Elastic Agent on your system.
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.12.2-darwin-x86_64.tar.gz tar xzvf elastic-agent-8.12.2-darwin-x86_64.tar.gz
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.12.2-linux-x86_64.tar.gz tar xzvf elastic-agent-8.12.2-linux-x86_64.tar.gz
# PowerShell 5.0+ wget https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.12.2-windows-x86_64.zip -OutFile elastic-agent-8.12.2-windows-x86_64.zip Expand-Archive .\elastic-agent-8.12.2-windows-x86_64.zip
Or manually:
- Download the Elastic Agent Windows zip file from the download page.
- Extract the contents of the zip file.
To simplify upgrading to future versions of Elastic Agent, we recommended that you use the tarball distribution instead of the DEB distribution.
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.12.2-amd64.deb sudo dpkg -i elastic-agent-8.12.2-amd64.deb
To simplify upgrading to future versions of Elastic Agent, we recommended that you use the tarball distribution instead of the RPM distribution.
curl -L -O https://artifacts.elastic.co/downloads/beats/elastic-agent/elastic-agent-8.12.2-x86_64.rpm sudo rpm -vi elastic-agent-8.12.2-x86_64.rpm
Step 2: Enroll and start the Elastic Agent
editReturn to Kibana and follow the Enroll and start the Elastic Agent instructions. The command provided in Kibana includes the information that Elastic Agent needs to connect and authenticate with the Elastic Stack. When the Elastic Agent enrolls it will be configured to send the data associated with the policy that you created.