Collector Installation
This document covers installation of the Collector. For more information on Collectors and how they fit into the SIFF Platform refer to the Collectors & Agents section in Getting Started.
Download / Install
Note: To add a repository and install packages sudo or root access is required.
Install via Package Repository
- For yum (rpm) based distributions:
- Download the appropriate repository file for your system. Refer to the SIFF Repositories table below.
- Install the repository file: copy the
.repo
file to/etc/yum.repos.d/
. - Update the packages: run
sudo yum update
- Install the Collector package: run
sudo yum install siff-collector
- For apt (deb) based distributions:
- Install the SIFF repository signing key:
curl https://downloads.siff.io/repo/deb/repo/conf/siff.gpg.key | sudo apt-key add -
- Download the appropriate repository file for your system. Refer to the SIFF Repositories table below.
- Install the repository file: copy the
.list
file to/etc/apt/sources.list.d/
. - Update the packages: run
sudo apt-get update
- Install the Collector package: run
sudo apt-get install siff-collector
- Install the SIFF repository signing key:
SIFF Repositories
Distribution | Architecture | Type | Repository |
---|---|---|---|
RHEL 8 | x86_64 | yum | siff_rhel_8.repo |
RHEL 7 | x86_64 | yum | siff_rhel_7.repo |
RHEL 6 | x86_64 | yum | siff_rhel_6.repo |
CentOS 8 | x86_64 | yum | siff_centos_8.repo |
CentOS 7 | x86_64 | yum | siff_centos_7.repo |
CentOS 6 | x86_64 | yum | siff_centos_6.repo |
Amazon Linux, Amazon Linux 2 | x86_64 | yum | siff_amzn2.repo |
Ubuntu LTS: 16.04, 18.04, 20.04, 22.04 | x86_64 | apt | siff.list |
Manual Installation
For systems that cannot access the package repository directly then the latest package can be downloaded and installed manually:
- Download the appropriate package for your system:
- .rpm (RedHat, CentOS, Amazon Linux): siff-collector-latest.x86_64.rpm
- .deb (Ubuntu): siff-collector.deb
- Copy the package to the target system
- Install the package:
- .rpm:
sudo rpm -Uvh siff-collector-latest.x86_64.rpm
- .deb:
sudo dpkg -i siff-collector.deb
- .rpm:
Note: For Windows installation the collector configuration can be provided during install time. To use this option make sure to have a copy of collector.yml
before running the installer (see Configure below)
- Download the Windows installer: siffcollector-latest.exe
- Run the installer to complete the installation.
- Download the macOS installer: siff-collector-latest.img
- Run the installer to complete the installation.
Configure
The collector must be configured to connect to SIFF and, in particular, your organization instance within the SIFF Platform.
- Within the Admin app, browse to the Setup page -> Collector Setup tab
- Click the Download collector.yml button to download the Collector configuration for your environment.
- Copy this file onto the Collector system in the installation directory:
/opt/siff/
- Update file ownership (as root):
chown siff:siff /opt/siff/collector.yml
- Restart the Collector service (as root):
service siff-collector start
The collector must be configured to connect to SIFF and, in particular, your organization instance within the SIFF Platform.
- Within the Admin app, browse to the Setup page -> Collector Setup tab
- Click the Download collector.yml button to download the Collector configuration for your environment.
- Copy this file onto the Collector system in the installation directory:
C:\Program Files\siff\
- Restart the Collector service.
The collector must be configured to connect to SIFF and, in particular, your organization instance within the SIFF Platform.
- Within the Admin app, browse to the Setup page -> Collector Setup tab
- Click the Download collector.yml button to download the Collector configuration for your environment.
- Copy this file onto the Collector system in the installation directory:
/Applications/siff/
- Restart the Collector service.