Skip to Content

Installation

Mettre en place votre propre instance IronFlock locale à l’usine ne prend que quelques minutes. D’un PC industriel nu à une plateforme entièrement opérationnelle — quelques étapes, aucune configuration manuelle.

Prérequis

  • Un PC industriel (ou une machine virtuelle) sous Linux basé sur Debian ou Ubuntu avec systemd, avec accès internet pendant l’installation.
  • Architecture ARM64 ou AMD64.
  • gpgv ou sqv sur l’hôte : le script d’installation d’ironflock s’en sert pour vérifier la signature d’IronFlock. Toute installation Debian et Ubuntu dispose de l’un des deux. ironflock lui-même vérifie chaque version de l’appliance avant de l’installer.
  • Stockage SSD, de préférence NVMe. Les données machine sont conservées dans une base de données de séries temporelles, qui devient lente sur un disque dur mécanique.
  • CPU, RAM et stockage selon le tableau ci-dessous.
UsageCPURAMStockage
Évaluation et tests2 cœurs4 Go64 Go SSD
Pilote avec quelques machines4 cœurs8 Go128 Go SSD
Production4 cœurs16 Go256–512 Go SSD NVMe

Ces tailles supposent que la machine n’exécute que l’appliance. Les apps que vous installez sur l’appliance elle-même nécessitent des ressources supplémentaires.

Au repos, sans données machine entrantes, l’appliance et son système d’exploitation utilisent environ 2,5 Go de RAM et une petite partie d’un cœur CPU. La charge vient de vos données machine : le nombre d’appareils qui envoient des données et leur fréquence, les transformations et alarmes qui s’exécutent sur ces données, et le nombre de personnes qui utilisent des tableaux de bord en même temps.

Le stockage augmente avec les données que vous conservez : l’historique des données machine, les fichiers et les images d’apps dans le registre de l’appliance. Pour de longs historiques de données machine, prévoyez plus de 500 Go. Gardez de l’espace libre : lorsqu’il reste moins de 3 Go, l’appliance n’accepte plus de nouvelles données jusqu’à ce que vous libériez de l’espace.

L’installation adapte les bases de données de l’appliance à la RAM et aux cœurs CPU de la machine, lors de l’installation et à chaque mise à jour. Si vous ajoutez plus tard de la RAM ou des cœurs CPU, ou si vous agrandissez la machine virtuelle, les bases de données les utilisent après la prochaine mise à jour vers une nouvelle version, ou immédiatement après sudo ironflock appliance install --version <version> avec la version qu’exécute l’appliance (ironflock status l’affiche).

Synchronisation horaire (NTP)

Faites pointer l’hôte de l’appliance vers un serveur de temps qu’il peut réellement joindre avant l’installation. L’horloge système n’est pas cosmétique : la validation des certificats TLS, la revérification périodique de la licence, les jetons d’accès distant et l’horodatage de chaque point de données produit par vos machines en dépendent. Un hôte décalé de quelques minutes provoque des erreurs de certificat, des connexions refusées et un historique qui ne correspond plus à ce qui s’est passé en atelier.

Dans un réseau d’entreprise, les serveurs de temps publics fournis par le système d’exploitation sont généralement injoignables, car le NTP sortant sur le port UDP 123 est bloqué par le pare-feu. Rien n’échoue bruyamment : l’hôte ne se synchronise tout simplement jamais et dérive. Demandez le serveur de temps interne à votre service informatique et configurez-le sur l’hôte, ou faites autoriser l’UDP 123 sortant.

Avec systemd-timesyncd (valeur par défaut sur Debian et Ubuntu) :

sudo mkdir -p /etc/systemd/timesyncd.conf.d sudo tee /etc/systemd/timesyncd.conf.d/corporate.conf > /dev/null <<'EOF' [Time] NTP=ntp.your-company.com EOF sudo systemctl restart systemd-timesyncd timedatectl status

Avec chrony :

echo "server ntp.your-company.com iburst" | sudo tee -a /etc/chrony/chrony.conf sudo systemctl restart chrony chronyc sources

timedatectl status doit indiquer System clock synchronized: yes avant que vous installiez l’appliance.

Les machines virtuelles dérivent plus vite que le matériel physique. Si l’appliance tourne dans une VM, activez également la synchronisation horaire invité de l’hyperviseur, et configurez malgré tout NTP dans l’invité.

Étapes

  1. Créez un compte sur ironflock.com.

  2. Générez une Instance Key — dans l’interface IronFlock, ouvrez votre Profil → Instances, choisissez le plan adapté à votre cas d’usage et créez une nouvelle Instance Key. Copiez la clé et enregistrez-la dans un fichier sur l’hôte de votre appliance, par exemple license.txt. La commande ironflock appelle l’Instance Key la clé de licence : c’est la même clé.

  3. Installez ironflock sur l’hôte de votre appliance. Ouvrez un terminal sur votre PC industriel et exécutez :

    curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bash

    Cela installe la commande ironflock sous /usr/local/bin/ironflock, là où l’appliance en a besoin. La page Installation de l’outil en ligne de commande décrit ce que fait le script, et comment le vérifier avant son exécution (Vérifier d’abord le script d’installation).

  4. Installez l’appliance :

    # Derrière un proxy d'entreprise ? Consultez la note ci-dessous avant d'exécuter ceci. sudo ironflock appliance install --license-file license.txt

    La commande télécharge la version la plus récente, la vérifie avec la clé de publication de l’appliance d’IronFlock, installe Docker s’il manque ainsi que l’agent d’appareil propre à l’hôte, et démarre l’appliance. Elle attend que chaque service soit en bonne santé et qu’ironflock.com joigne l’appliance, puis affiche l’identifiant administrateur de l’interface web, une seule fois, dans le terminal. L’appliance conserve l’Instance Key dans /opt/ironflock/license.env : vous pouvez donc supprimer license.txt ensuite. Si la commande s’arrête en cours de route, exécutez à nouveau la même commande : elle reprend là où elle s’est arrêtée.

    Ses options (HTTPS, le canal de publication, un proxy et autres) sont décrites dans ironflock appliance install.

    Derrière un proxy d’entreprise ? Si l’appliance n’atteint internet qu’à travers un proxy HTTP d’entreprise, vous devez le fournir dans la commande d’installation afin que le démon Docker puisse récupérer les images — sinon l’installation s’arrête à l’étape de connexion. Voir Derrière un proxy d’entreprise.

C’est tout. Une fois l’installation terminée, la plateforme IronFlock complète tourne sur l’appliance et redémarre à chaque démarrage de la machine.

Note : Les commandes de l’appliance sont nouvelles dans la version 2.1.0 d’ironflock. Elles ont passé un cycle de test, de l’installation à la suppression, sur une machine virtuelle Ubuntu 24.04 vierge (amd64) ; voir Commandes de l’appliance.

Choisir un mode

L’installation configure l’appliance en mode HTTP en clair, qui ne demande rien à l’informatique d’entreprise. Pour des adresses https:// de confiance — avec une CA que l’appliance émet elle-même ou avec votre certificat d’entreprise — voir HTTPS et certificats. Si l’appliance n’atteint internet qu’à travers un proxy HTTP, voir Derrière un proxy d’entreprise.

Last updated on