Skip to main content
Instala e atualiza o painel de controle, que serve tanto as telas do operador quanto o portal do cliente.
O painel edita configuração e lê registros de chamadas. Ele não está no caminho da mensagem: um painel fora do ar custa a você a capacidade de fazer alterações, não a capacidade de enviar.Instale-o depois do gateway. O gateway é dono do schema do banco de dados; o painel apenas lê e escreve linhas nele.

​
Os cinco verbos

O install pergunta antes o que precisa e não altera nada até você concordar.

​
Por que passwd existe como verbo

Não há tabela de usuários. OPERATOR_USERNAME e OPERATOR_PASSWORD no panel.env são a conta de operador inteira. O passwd é portanto a forma suportada de alterá-la — ele reescreve o arquivo de ambiente e reinicia a unidade em uma única etapa, em vez de deixar você editar um arquivo que o instalador, por outro lado, promete nunca substituir.

​
Layout

--tenant é o ponto do vocabulário compartilhado: a mesma palavra nomeia a mesma instância para o instalador do gateway. Um nome por cliente, dois produtos. As três flags de diretório ainda prevalecem sobre qualquer esquema.
--vhost sozinho preserva um significado plano mais antigo, para que painéis já instalados sob /home/<name> sejam alcançados exatamente como antes — uma atualização não deve realocar uma instalação em execução. Para um tenant novo, isso quase nunca é o que você quer: coloca o painel em PATH/{app,conf,data} enquanto o gateway fica em PATH/gateway, e o update --tenant NAME depois não encontra mais o painel. Passe as duas flags juntas.
Flags aceitam valores separados por espaço. --vhost=/home/acme é rejeitado como opção desconhecida.

​
O que ele deriva, e a única coisa que ele não deriva

Dado o diretório de configuração do gateway (--gateway-conf-dir), o instalador deriva três coisas em vez de pedir para você copiá-las: ambos os tokens operacionais, a conexão de banco somente leitura e a URL de ops. A URL de ops é construída a partir do FIREFLO_OPS_PORT registrado desse gateway, então uma instância em --ops-port não-padrão não precisa de uma segunda flag aqui. Antes se assumia que era 9000, e o sintoma de errar é “Could not reach the gateway: fetch failed” em toda página que mostra estado em tempo real — o que se parece com o gateway estar fora do ar em vez de o painel estar olhando para a porta errada.
--config-url nunca é derivada. A conexão de leitura e escrita para as tabelas de configuração é a que pode alterar o que é cobrado dos clientes, portanto ela é sempre informada em vez de inferida. Sem ela, o painel reporta cada domínio de configuração como não editável, em vez de falhar no primeiro salvamento.Passada como flag, ela coloca a senha do banco no histórico do shell e na saída do ps. Omita-a e o instalador pergunta — e esse prompt aceita a palavra literal same, significando “reutilize a conexão recém-derivada do gateway”, o que é correto sempre que uma única role for dona do banco do tenant.
Veja Instalando o painel de controle para o passo a passo e Ambiente do painel de controle para cada variável que ele escreve.