Edge Delta on macOS
3 minute read
Standard Installation
Select the macOS template option in the following steps:
- Click Pipelines.
- Click New Fleet.
- Select Edge Fleet.
- Optionally, expand Advanced Fleet Configuration and select a pipeline with a configuration you want to duplicate.
- Click Continue.
- Select the appropriate template and click Continue.
- Specify a name to identify the Fleet.
- Click Generate Config.
- Execute the installation commands, they include the unique ID for the Fleet.
- Expand the namespaces and select the input sources you want to monitor.
- Select the Destination Outputs you want to send processed data to, such as the Edge Delta Observability Platform.
- Click Continue.
- Click View Dashboard.
The installation process will deploy Edge Delta into the /opt/edgedelta/agent/
path. Additionally, the edgedelta
system service will start automatically with default configurations.
The ED_ENV_VARS
special variable is used in the installation command to pass one or more persistent environment variables to the Fleet, which will run as the system service:
sudo ED_API_KEY=<your Pipeline ID> \
ED_ENV_VARS="MY_VAR1=MY_VALUE_1,MY_VAR2=MY_VALUE_2" \
bash -c "$(curl -L https://release.edgedelta.com/release/install.sh)"
To view a full list of variables that the fleet supports, see Environment Variables.
Install in a Custom Path
You can use the ED_INSTALL_PATH
environment variable to install the agent in a custom path rather than the default path. Add the environment variable to the installation instructions provided by the Edge Delta app, for example:
sudo ED_API_KEY=12345 \
ED_ENV_VARS="ED_INSTALL_PATH=/opt/custom/edgedelta/agent" \
bash -c "$(curl -L https://release.edgedelta.com/release/install.sh)"
Script
The https://release.edgedelta.com/release/install.sh release package detects your architecture and operating system, and then chooses and downloads the latest version of the fleet self-extracting script, which includes the content to be extracted at the end of the script.
The script’s content and extractable scripts are available for inspection at https://release.edgedelta.com/release/install.sh.
To check the package’s integrity, the script header will extract commands and content checksum.
The script will fail if the content has been tempered with.
For example, the v0.1.19/edgedelta-linux-amd64.shheader includes:
CRCsum="1944320463"
MD5="a98b537444f18d97a06b428b9cb223ce"
If the package has not been tempered with, then the script will extract the fleet into a temporary directory, set the apikey file with the given ED_API_KEY environment variable, and run unix_install.sh
. This command will copy the content to /opt/edgedelta/agent/
and run the following commands to install edgedelta as a system service and start the service:
/edgedelta -s install
./edgedelta -s start
(Alternative) Offline Installation
- Follow the steps outlined in Standard Installation in a non-production machine with the same architecture and OS as the target production machine.
- Use the following command to compress the fleet folder:
sudo tar -czvf agent_archive.tgz /opt/edgedelta
- Copy
agent_archive.tgz
to the target machine via SSH or other means. - Use the following command to extract the archive under
/opt/edgedelta
:
sudo tar -xzvf agent_archive.tgz -C /
- Use the following command to install and start the service:
sudo cd /opt/edgedelta/agent/sudo
./edgedelta -s installsudo
./edgedelta -s start
Troubleshooting
Description | Command |
---|---|
To check the status of the Fleet, switch to root user then inspect Edge Delta’s status: | sudo su launchctl list edgedelta |
To check the Fleet’s log file for any errors that may indicate an issue with the Fleet, configuration, or deployment settings, run the following command on the Edge Delta service log file path: | cat /var/log/edgedelta/edgedelta.log |
To check the Fleet’s configuration file to ensure the configuration does not contain any issue, run the following command on the configuration file path: | cat /opt/edgedelta/agent/config.yml |
Upgrading
To upgrade the Fleet, you run the installation command that you previously used to deploy the Fleet.
Uninstalling
The following script uninstalls the fleet as the root user:
#!/bin/bash
set -uex
install_path="/opt/edgedelta/agent"
if [[ ! -z "${ED_INSTALL_PATH:-}" ]]; then
install_path="$ED_INSTALL_PATH"
fi
BITS=$(getconf LONG_BIT)
if [ "$BITS" == "32" ]; then
echo "This script does not support 32 bit OS. Contact info@edgedelta.com"
fi
echo "Stopping agent service"
sudo $install_path/edgedelta -s stop
echo "Removing agent service"
sudo $install_path/edgedelta -s uninstall
echo "Removing edgedelta folder"
sudo rm -rf $install_path
echo "Done"