Installation de l'agent

L'installation de l'agent et la mise en œuvre de redirection.io sont plutôt simples et directes. Cette page vous guidera à travers les étapes d'installation de l'agent redirection.io.

Prérequis et plateformes compatibles

L'utilisation de redirection.io nécessite la capacité d'exécuter l'agent de redirection.io sur votre serveur. Dans la plupart des cas, cela signifie que vous avez besoin d'un accès SSH avec les permissions root. Si votre site web utilise un hébergement partagé sans accès SSH, vous ne pourrez pas utiliser les fonctionnalités de redirection.io.

Notre agent fonctionne sur Linux et FreeBSD.

Distributions basées sur Debian et APT

Installez le paquet apt-transport-https :

sudo apt-get install apt-transport-https

Importez notre clé de dépôt apt :

sudo mkdir -p /etc/apt/keyrings
wget -qO- https://packages.redirection.io/gpg.key | sudo tee /etc/apt/keyrings/redirectionio-archive-keyring.asc

Ajoutez le dépôt debian :

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/redirectionio-archive-keyring.asc] https://packages.redirection.io/deb/stable/2 any main" | sudo tee -a /etc/apt/sources.list.d/packages_redirection_io_deb.list > /dev/null

Mettez à jour le cache apt et installez l'agent redirection.io :
```
sudo apt update && sudo apt install redirectionio-agent
```
Une fois l'agent installé, modifiez son fichier de configuration (dans /etc/redirectionio/agent.yml - en gros, vous n'avez qu'à modifier le nom de l'instance, ce qui vous aidera à identifier l'origine des logs collectés par redirection.io), et démarrez le service - cela dépend du gestionnaire de services utilisé dans votre distribution. Il peut s'agir par exemple de :
```
sudo systemctl --system daemon-reload
sudo systemctl restart redirectionio-agent
```

Vous devrez redémarrer le service chaque fois que vous modifiez la configuration de l'agent. Si quelque chose ne va pas, si vous avez besoin d'aide ou si vous avez des questions, n'hésitez pas à contacter notre support !

Une note sur le fichier de service systemd

Si vous souhaitez utiliser des variables d'environnement dans l'environnement d'exécution de l'agent lorsque l'agent est lancé via systemctl (par exemple, pour utiliser un proxy HTTPS), vous pouvez modifier le contenu du fichier de service systemd.

Distributions basées sur Red Hat et RPM

Importez la clé de signature :

wget -qO- https://packages.redirection.io/gpg.key -O /tmp/redirectionio-gpg.key && sudo rpm --import /tmp/redirectionio-gpg.key && rm /tmp/redirectionio-gpg.key

Ajoutez le dépôt :

sudo yum-config-manager --add-repo https://packages.redirection.io/rpm/stable/2/any

# or (Fedora)
sudo dnf config-manager --add-repo https://packages.redirection.io/rpm/stable/2/any

Installez l'agent redirection.io :

sudo yum install redirectionio-agent

# or (Fedora)
sudo dnf install redirectionio-agent

Une fois l'agent installé, modifiez son fichier de configuration (dans /etc/redirectionio/agent.yml - en gros, vous n'avez qu'à modifier le nom de l'instance, ce qui vous aidera à identifier l'origine des logs collectés par redirection.io), et démarrez le service - cela dépend du gestionnaire de services utilisé dans votre distribution. Il peut s'agir par exemple de :
```
sudo systemctl --system daemon-reload
sudo systemctl restart redirectionio-agent
```

Installation manuelle

Dans des cas particuliers, une installation manuelle pourrait être la meilleure solution.

Téléchargez la dernière version de l'agent redirection.io ici : https://packages.redirection.io/dist/stable/2/any/redirectionio-agent-latest_any_amd64.tar.gz
Extrayez l'archive, déplacez les fichiers et modifiez la configuration selon vos besoins
Exécutez l'agent

Windows

Au moment de la rédaction de cet article, nous n'avons pas de binaire Windows de l'agent, mais nous pourrions étudier le sujet à l'avenir. N'hésitez pas à nous contacter !

Ansible

Un rôle Ansible est disponible. Vous pouvez l'installer en utilisant Ansible Galaxy :

ansible-galaxy install redirectionio.agent

Script d'initialisation system V

Nos paquets ne fournissent pas de scripts d'initialisation SysV. Cependant, si votre système nécessite un tel script, vous pouvez créer un fichier /etc/init.d/redirectionio-agent :

#!/bin/sh
#
# redirectionio-agent start stop daemon for CentOS (sysvinit)
#
# chkconfig: - 64 36
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 2 3 4 6
# Required-Start:
# description: redirectionio-agent start stop daemon for CentOS
# processname: redirectionio-agent
# pidfile: none
# lockfile: /var/lock/subsys/redirectionio-agent

# Source function library.
. /etc/rc.d/init.d/functions

# Source networking configuration.
. /etc/sysconfig/network

# Check that networking is up.
[ "$NETWORKING" = "no" ] && exit 0

USER="redirectionio"
APPNAME="redirectionio-agent"
APPBIN="/usr/bin/redirectionio-agent"
APPARGS=""
LOGFILE="/var/log/redirectionio.log"
LOCKFILE="/var/lock/subsys/$APPNAME"

LOGPATH=$(dirname $LOGFILE)

start() {
        [ -x $prog ] || exit 5
        [ -d $LOGPATH ] || mkdir $LOGPATH
        [ -f $LOGFILE ] || touch $LOGFILE

        echo -n $"Starting $APPNAME: "
        daemon --user=$USER "$APPBIN $APPARGS >>$LOGFILE &"
        RETVAL=$?
        echo
        [ $RETVAL -eq 0 ] && touch $LOCKFILE
        return $RETVAL
}

stop() {
        echo -n $"Stopping $APPNAME: "
        killproc $APPBIN
        RETVAL=$?
        echo
        [ $RETVAL -eq 0 ] && rm -f $LOCKFILE
        return $RETVAL
}

restart() {
        stop
        start
}

rh_status() {
        status $prog
}

rh_status_q() {
        rh_status >/dev/null 2>&1
}

case "$1" in
        start)
                rh_status_q && exit 0
                $1
        ;;
        stop)
                rh_status_q || exit 0
                $1
        ;;
        restart)
                $1
        ;;
        status)
                rh_status
        ;;
        *)
                echo $"Usage: $0 {start|stop|status|restart}"
                exit 2
esac

Cette page a été mise à jour le 30 juin 2025

Vous ne trouvez pas votre réponse ?

Contactez notre support