Skip to Content

Operação

Operação local

Se você não quiser manter o appliance conectado à internet, sempre pode usar um navegador na mesma rede local e acessar o endereço IP ou hostname do appliance:

http://<appliance-host>

Faça login como usuário admin:

  • Usuário: admin
  • Senha: a senha inicial de admin gerada para o seu appliance

O ironflock appliance install exibe essa senha uma única vez, no terminal, no final da instalação. Ela também fica armazenada como APPLIANCE_ADMIN_PASSWORD em /opt/ironflock/.env no host do appliance, um arquivo que somente o root pode ler:

sudo grep '^APPLIANCE_ADMIN_PASSWORD=' /opt/ironflock/.env

Altere a senha após o seu primeiro login.

Esqueceu a senha de admin? Execute isto no host do appliance para definir uma nova:

sudo ironflock appliance reset-admin-password

O appliance precisa estar rodando. O comando define a nova senha e encerra todas as sessões ativas do admin. Ele exibe a nova senha uma única vez, e somente em um terminal; sem terminal, ou com --json, ele diz em vez disso onde a senha está armazenada. Veja ironflock appliance reset-admin-password.

Appliances mais antigos: um appliance instalado antes de a instalação gerar a senha de admin começa com a senha ironflock. O primeiro login com ela pede que você defina uma nova senha.

UIs web dos apps

Quando um app em um dispositivo conectado expõe uma interface web, o appliance a torna acessível através do seu túnel embutido. De fábrica, isso não exige nada da TI corporativa — cada UI de app é publicada por HTTP simples em uma porta atribuída automaticamente do endereço do appliance (http://<appliance-host>:<port>), e a IronFlock UI mostra o link. O acesso continua protegido pelo login do appliance.

Para URLs https:// confiáveis em uma rede corporativa compartilhada — usando um certificado wildcard da sua CA ou um proxy reverso que termina o TLS — veja UIs de apps e HTTPS.

Vinculando contas

Crie contas de usuário locais para sua equipe convidando-os por e-mail nas configurações do seu projeto no appliance. O e-mail de convite contém tudo o que o convidado precisa:

  • Um link de conexão pessoal — ao abri-lo em ironflock.com, a conta do ironflock.com do convidado é conectada ao appliance. Se ele ainda não tiver uma conta no ironflock.com, primeiro cria uma usando o endereço de e-mail convidado (a conexão só é concedida quando os dois endereços de e-mail coincidem). Uma vez conectado, o appliance aparece no seu seletor de projetos do ironflock.com e ele já pode trabalhar remotamente de imediato — sem chaves manuais, sem necessidade de cadastro local.
  • Um link de cadastro local — opcional: concluir o cadastro local permite, adicionalmente, fazer login diretamente na interface do appliance (http://<appliance-host>).

Alguns pontos importantes:

  • Usuários locais existentes não precisam de um novo convite do proprietário do projeto. Na interface do appliance, eles abrem seu Perfil e clicam em Enviar o link de conexão por e-mail na seção Conectar ao ironflock.com.
  • Reenvio: convidar o mesmo endereço de e-mail novamente (ou clicar de novo no botão do perfil) emite um novo link de conexão. Apenas o link do e-mail mais recente é válido.
  • Se o appliance não conseguir enviar e-mails — por exemplo, em uma rede corporativa restrita que bloqueia o relay de e-mail — o link de conexão é exibido diretamente na interface: quem convida o copia e o entrega por qualquer canal. O link deve ser aberto em um navegador com acesso à internet.
  • Desconectando: um usuário pode remover a conexão a qualquer momento no ironflock.com em Perfil → Instâncias → Instâncias Conectadas. Reabrir o link de conexão mais recente a restaura.

O proprietário da instância — o usuário que criou a Instance Key em ironflock.com — é conectado automaticamente à conta local de admin da instância; nenhum convite é necessário para o proprietário.

Sincronizando apps da loja online

O Appliance inclui uma local App Store — um catálogo privado de apps e registro de containers que serve apps para dispositivos na rede local. Você pode popular essa loja local sincronizando apps da IronFlock Store pública online, desde que o Appliance tenha uma conexão à internet disponível no momento da sincronização. Nenhuma conexão permanente à internet é necessária; uma conexão temporária é suficiente para baixar os apps de que você precisa.

Pré-requisitos

  • Uma conta na plataforma pública ironflock.com.
  • Sua conta do appliance está conectada à sua conta do ironflock.com (veja Vinculando contas). A conta de admin do proprietário da instância é conectada automaticamente.

Como funciona a sincronização de apps

┌────────────────────┐ ┌────────────────────┐ │ Online IronFlock │ ◄──── account ─────► │ Appliance │ │ Store (cloud) │ connection │ local Store │ └────────────────────┘ └────────────────────┘ │ │ apps available to sync button shown the connected account instead of install
  1. Abra a local App Store — Quando o Appliance tiver uma conexão ativa à internet, a App Store mostrará todos os apps disponíveis para a sua conta conectada do ironflock.com na plataforma online.
  2. Sincronize os apps de que você precisa — Em vez de um botão Install, cada app mostra um botão Sync. Clicando nele, o app é baixado — incluindo suas imagens de container e metadados — da loja online para a loja local.
  3. Adicione dispositivos — Uma vez sincronizado, o app está totalmente disponível na sua loja local e você pode adicionar dispositivos a ele normalmente, sem necessidade de conexão à internet.

Fluxo de atualização

Quando uma nova versão de um app sincronizado for publicada na loja online, um botão Sync aparecerá novamente para aquele app. Conecte o Appliance à internet brevemente, sincronize a versão atualizada e então distribua-a para seus dispositivos pelo fluxo padrão de atualização de apps.

Este design dá a você controle total sobre o que entra na sua rede — nada é baixado automaticamente, e a conexão à internet é necessária apenas durante a etapa de sincronização.

Remetente de e-mail personalizado (SMTP)

Por padrão, todos os e-mails da plataforma — verificação de conta, recuperação de senha, convites e notificações de alarme — são enviados através do proxy SMTP em nuvem da IronFlock e aparecem como [email protected]. Para que os e-mails apareçam como enviados pela sua própria empresa, aponte o appliance para o seu próprio servidor SMTP.

No host do appliance, edite o arquivo de ambiente do appliance em /opt/ironflock/.env e defina as seguintes variáveis:

SMTP_CONNECTION_URI=smtps://USERNAME:[email protected]:465/ SMTP_FROM_ADDRESS=[email protected] SMTP_FROM_NAME=Your Company
  • Use smtps:// para TLS implícito (normalmente porta 465), ou smtp:// com STARTTLS (porta 587).
  • Codifique em URL os caracteres especiais no usuário ou na senha (por exemplo, @ → %40).
  • SMTP_FROM_ADDRESS e SMTP_FROM_NAME são o que os destinatários veem no cabeçalho De de cada e-mail da plataforma.

Aplique as alterações reiniciando o appliance:

sudo ironflock appliance restart

Após o reinício, todos os e-mails de autenticação, notificações da plataforma e e-mails de alarme são enviados pelo seu servidor SMTP com o endereço e o nome de remetente da sua empresa.

Se SMTP_CONNECTION_URI não estiver definido, o appliance continua roteando os e-mails através do proxy SMTP em nuvem da IronFlock autenticado com sua chave de licença — não é necessária configuração adicional, mas os e-mails terão a marca IronFlock.

Manutenção

Para atualizar o sistema IronFlock no seu appliance, o admin pode usar o botão de atualização na seção de licença do seu perfil sempre que uma nova versão estiver disponível. No host do appliance, a mesma atualização roda com:

sudo ironflock appliance update

O appliance precisa de conexão à internet para baixar a atualização. O IronFlock reinicia automaticamente quando a atualização termina. O appliance só instala uma atualização com uma assinatura válida da IronFlock e, se uma atualização falhar, volta à versão que rodava antes (veja Atualizações e ironflock appliance update).

O botão de atualização também executa o ironflock em /usr/local/bin no host do appliance. Quando uma versão precisa de um ironflock mais novo, a atualização o instala primeiro, com as verificações do ironflock self-update, e continua com ele (Um ironflock mais novo). Um ironflock da versão 2.2.0 ou anterior não consegue fazer isso: execute a linha de instalação uma vez para levá-lo à versão atual (Vindo da release 2.2.0 ou anterior).

As atualizações do sistema operacional Linux são de sua responsabilidade.

Conexão à cloud

O appliance mantém uma conexão de saída com o ironflock.com. Por meio dela, você trabalha na instância a partir do ironflock.com (veja Acesse sua instância pelo ironflock.com), abre remotamente as interfaces de usuário e os arquivos dos apps e inicia atualizações e a transferência de licença a partir da nuvem. Se o appliance não deve ser acessível a partir do ironflock.com, desligue essa conexão.

Enquanto a conexão à cloud estiver desligada:

  • O appliance não fica acessível a partir do ironflock.com. A lista de instâncias no ironflock.com o mostra como Conexão à cloud desligada.
  • O acesso remoto às interfaces de usuário e aos arquivos dos apps pelo ironflock.com é interrompido.
  • Atualizações do appliance e a transferência de licença não podem ser iniciadas a partir da nuvem. O admin ainda pode atualizar o appliance localmente (veja Manutenção).
  • Os relatórios de uso ficam no appliance e são enviados assim que a conexão for ligada novamente.
  • Dispositivos, operação local, sincronização de apps da loja online e validação da licença continuam funcionando.

A configuração se mantém após reinicializações e atualizações do appliance.

Ligar e desligar no appliance

O admin liga e desliga a conexão à cloud na seção Conexão à cloud da seção de licença do seu perfil, na UI do appliance (http://<appliance-host>). Somente a conta de admin pode alterá-la, e somente localmente — não enquanto trabalha na instância a partir do ironflock.com.

Desligar pelo ironflock.com

O dono da instância — a conta do ironflock.com que criou a instance key — pode desligar a conexão à cloud a partir da nuvem: abra Perfil → Instâncias em ironflock.com e clique em Desligar a conexão à cloud na instância. O appliance precisa estar online.

Isso não pode ser desfeito a partir da nuvem. Somente o admin do appliance pode ligar a conexão novamente, localmente no appliance.

Ciclo de vida da licença

Sua licença está vinculada a um único Appliance físico. A mesma licença não pode executar uma segunda instância IronFlock em hardware diferente ao mesmo tempo. Na operação do dia a dia, o Appliance funciona offline — dados de produção, dashboards, gerenciamento de apps e controle dos dispositivos de borda permanecem todos localmente no equipamento.

Quando o Appliance precisa de internet

A conexão com a internet só é necessária nestes momentos:

  • Instalação inicial e atualizações do Appliance — necessária de qualquer forma para baixar o software dos servidores de distribuição do IronFlock; a licença é ativada nessa mesma etapa.
  • Reverificação periódica da licença — depende do seu plano:
    • Licença mensal: uma vez a cada 30 dias.
    • Licença anual: uma vez a cada 365 dias.
    • Licença perpétua: sem reverificação periódica — a internet só é necessária na instalação e nas atualizações.
  • Transferência de licença para um novo hardware (veja abaixo).
  • Serviço AI Multi Agent — somente enquanto estiver sendo usado ativamente.

Período de tolerância e bloqueio

Se uma reverificação periódica não conseguir alcançar a nuvem (falha de rede, erro transitório na nuvem), o Appliance entra em um período de tolerância de 7 dias. Durante esse período, o Appliance continua funcionando normalmente e tenta novamente de forma automática.

Se sete dias completos se passarem sem uma reverificação bem-sucedida, o Appliance se bloqueia: a maioria das operações é recusada e a interface mostra a licença como inválida. Para recuperar, restabeleça a conexão do Appliance com a internet e clique em Revalidar agora no painel de licença do seu perfil na interface do Appliance (a visualização local http://<appliance-host>, ou sua instância acessada pelo ironflock.com).

Mover sua licença para um novo hardware (transferência)

Uma licença está vinculada à impressão digital de hardware de uma máquina. Para movê-la para outra máquina, você inicia uma transferência a partir do seu perfil na nuvem IronFlock:

  1. Abra Perfil → Instâncias em ironflock.com.
  2. Clique em Redefinir impressão digital do hardware na instância que você deseja mover.

A transferência exige que o Appliance atualmente vinculado esteja online com a sua conexão à cloud ligada. A nuvem se conecta de volta a ele, pede que ele se revogue localmente e só então limpa a impressão digital do lado da nuvem. Esse handshake garante que o Appliance antigo não continue funcionando enquanto um novo se vincula — evitando o uso duplo acidental da mesma licença.

Assim que o desbloqueio for concluído:

  1. Configure o novo hardware seguindo os passos de Instalação, usando a mesma instance key.
  2. O novo Appliance faz a validação, vincula sua impressão digital e se torna o dispositivo ativo.

Quando o hardware antigo está com defeito ou inacessível

Se o Appliance vinculado anteriormente estiver inoperante ou inacessível por outro motivo, o handshake atinge o tempo limite e a interface da nuvem mostra appliance_unreachable_contact_support. Nesse caso, entre em contato com a equipe IronFlock — podemos remover o vínculo manualmente após verificar a titularidade.

Dica: acione a transferência antes de desativar o hardware antigo, enquanto ele ainda está online. O processo é muito mais rápido — para você e para nossa equipe de suporte — quando o Appliance antigo ainda pode ser alcançado.

Last updated on