Instalação
Subir sua própria instância IronFlock local de fábrica leva apenas alguns minutos. De um PC industrial sem nada instalado a uma plataforma totalmente operacional — alguns passos, sem configuração manual.
Requisitos
- Um PC industrial (ou uma máquina virtual) com um Linux baseado em Debian ou Ubuntu com systemd, e acesso à internet durante a instalação.
- Arquitetura ARM64 ou AMD64.
gpgvousqvno host: o script de instalação doironflockverifica a assinatura da IronFlock com ele. Toda instalação de Debian e Ubuntu tem um dos dois. O próprioironflockverifica cada versão do appliance antes de instalá-la.- Armazenamento SSD, de preferência NVMe. Os dados das máquinas ficam em um banco de dados de séries temporais, que fica lento em um disco rígido mecânico.
- CPU, RAM e armazenamento conforme a tabela abaixo.
| Uso | CPU | RAM | Armazenamento |
|---|---|---|---|
| Avaliação e testes | 2 núcleos | 4 GB | 64 GB SSD |
| Piloto com poucas máquinas | 4 núcleos | 8 GB | 128 GB SSD |
| Produção | 4 núcleos | 16 GB | 256–512 GB SSD NVMe |
Esses tamanhos pressupõem que a máquina execute apenas o appliance. Apps que você instala no próprio appliance precisam de recursos adicionais.
Em repouso, sem dados de máquinas chegando, o appliance e seu sistema operacional usam cerca de 2,5 GB de RAM e uma pequena parte de um núcleo de CPU. A carga vem dos dados das suas máquinas: quantos dispositivos enviam dados e com que frequência, as transformações e alarmes que rodam sobre eles e quantas pessoas usam dashboards ao mesmo tempo.
O armazenamento cresce com os dados que você mantém: o histórico de dados das máquinas, arquivos e as imagens de apps no registro do appliance. Para históricos longos de dados de máquinas, planeje mais de 500 GB. Mantenha espaço livre: quando há menos de 3 GB livres, o appliance deixa de aceitar novos dados até que você libere espaço.
A instalação adapta os bancos de dados do appliance à RAM e aos núcleos de CPU da máquina, na instalação e a cada atualização. Se você adicionar RAM ou núcleos de CPU depois, ou ampliar a máquina virtual, os bancos de dados passam a usá-los após a próxima atualização para uma nova versão, ou de imediato após sudo ironflock appliance install --version <version> com a versão que o appliance executa (o ironflock status a mostra).
Sincronização de horário (NTP)
Aponte o host do appliance para um servidor de horário que ele realmente consiga alcançar antes de instalar. O relógio do sistema não é cosmético: a validação de certificados TLS, a reverificação periódica da licença, os tokens de acesso remoto e o carimbo de tempo de cada ponto de dado produzido pelas suas máquinas dependem dele. Um host com desvio de minutos gera erros de certificado, logins recusados e um histórico que já não corresponde ao que aconteceu no chão de fábrica.
Em uma rede corporativa, os servidores de horário públicos que acompanham o sistema operacional costumam ser inalcançáveis, porque o NTP de saída na porta UDP 123 está bloqueado no firewall. Nada falha de forma visível: o host simplesmente nunca sincroniza e vai se desviando. Peça ao seu departamento de TI o servidor de horário interno e configure-o no host, ou peça que liberem o UDP 123 de saída.
Com systemd-timesyncd (padrão no Debian e no 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 statusCom chrony:
echo "server ntp.your-company.com iburst" | sudo tee -a /etc/chrony/chrony.conf
sudo systemctl restart chrony
chronyc sourcestimedatectl status deve informar System clock synchronized: yes antes de você instalar o appliance.
Máquinas virtuais se desviam mais rápido que hardware físico. Se o appliance roda em uma VM, habilite também a sincronização de horário do convidado no hipervisor — e ainda assim configure o NTP dentro do convidado.
Passos
-
Crie uma conta em ironflock.com.
-
Gere uma Instance Key — na interface do IronFlock, abra seu Perfil → Instâncias, escolha o plano que se ajusta ao seu caso de uso e crie uma nova Instance Key. Copie a chave e salve-a em um arquivo no host do appliance, por exemplo
license.txt. O comandoironflockchama a Instance Key de chave de licença: é a mesma chave. -
Instale o
ironflockno host do appliance. Abra um terminal no seu PC industrial e execute:curl -fsSL https://instance-registry.ironflock.com/dl/cli/install.sh | sudo bashIsso instala o comando
ironflockcomo/usr/local/bin/ironflock, onde o appliance precisa dele. A página Instalação da ferramenta de linha de comando descreve o que o script faz e como verificá-lo antes que ele rode (Verificar o script de instalação antes). -
Instale o appliance:
# Atrás de um proxy corporativo? Veja a nota abaixo antes de executar isto. sudo ironflock appliance install --license-file license.txtO comando baixa a versão mais nova, verifica-a com a chave de release do appliance da IronFlock, instala o Docker quando ele falta e o agente de dispositivo do próprio host, e inicia o appliance. Ele espera até que todos os serviços estejam saudáveis e que o ironflock.com alcance o appliance, e então mostra o login de administrador da interface web, uma única vez, no terminal. O appliance guarda a Instance Key em
/opt/ironflock/license.env, então você pode excluir olicense.txtdepois. Se o comando parar no meio do caminho, execute o mesmo comando novamente: ele continua de onde parou.As suas opções (HTTPS, o canal de versões, um proxy e mais) estão descritas em
ironflock appliance install.Atrás de um proxy corporativo? Se o appliance só alcança a internet através de um proxy HTTP corporativo, você precisa informá-lo no comando de instalação para que o daemon do Docker consiga baixar as imagens — caso contrário, a instalação para na etapa de login. Veja Atrás de um Proxy Corporativo.
Pronto. Assim que a instalação termina, a plataforma IronFlock completa roda no appliance e inicia novamente a cada boot.
Nota: Os comandos do appliance são novos na versão 2.1.0 do
ironflock. Eles passaram por uma execução de teste, da instalação à remoção, em uma máquina virtual Ubuntu 24.04 nova (amd64); veja Comandos do appliance.
Escolhendo um modo
A instalação configura o appliance no modo HTTP simples, que não exige nada da TI corporativa. Para endereços https:// confiáveis — com uma CA que o próprio appliance emite ou com o seu certificado corporativo — veja HTTPS e certificados. Se o appliance só alcança a internet através de um proxy HTTP, veja Atrás de um proxy corporativo.