FireFlo SMS/SMPP Gateway

O caminho mais rápido para ter um FireFlo em execução. Para uma implantação real, vá para Instalar em um comando. Este guia deixa de fora a conta de serviço, a unit do systemd, retenção de logs e TLS.

O que você precisa

Docker.
Um diretório de trabalho com subdiretórios conf, data e logs.
Os arquivos de configuração em conf. Copie o diretório conf.example distribuído e substitua todos os valores REPLACE_WITH_*.

fireflo-runtime/
  conf/
    credentials.yml
    smsg.properties
    routingTable.conf
    rates.conf
  data/
  logs/

Inicie-o

docker run -d --name fireflo \
  -e QUARKUS_LOG_FILE_ENABLE=true \
  -e QUARKUS_LOG_CONSOLE_ENABLE=false \
  -e QUARKUS_LOG_FILE_PATH=/work/logs/smsg.log \
  -e QUARKUS_LOG_FILE_SMPPCLIENT_PATH=/work/logs/smppclient.log \
  -e QUARKUS_LOG_FILE_SMPPSERVER_PATH=/work/logs/smppserver.log \
  -e QUARKUS_HTTP_ACCESS_LOG_DIRECTORY=/work/logs \
  -p 8080:8080 \
  -p 127.0.0.1:9000:9000 \
  -p 27777:27777 \
  -v ./conf:/work/conf \
  -v ./data:/work/data \
  -v ./logs:/work/logs \
  edgeservers/fireflo:latest

edgeservers/fireflo:latest-native é a build nativa da mesma coisa.

Observe que 9000 é publicado apenas em loopback. Ele carrega estado de binds, profundidades de fila e nomes de vendors, e os dois tokens são a única coisa à frente dele.

Verifique se subiu

O container está em execução

docker ps

Em execução, não em restart.

A API HTTP responde

curl -s http://localhost:8080/ping

Se não iniciou, leia smsg.log primeiro

tail -50 logs/smsg.log

Um gateway sem routing table não inicia de forma alguma, e diz isso nomeando uma estrutura interna — no default routing table in new targets! — em vez da configuração ausente. Essa mensagem significa que seu routingTable.conf está vazio, ausente, ou falhou no parse.

Envie algo através dele

curl -s -u 'your-login:your-password' \
  -X POST http://localhost:8080/secure/send \
  -H 'Content-Type: application/json' \
  -d '{"to":"61400000000","content":"hello from FireFlo"}'

Um 200 com um message id significa que foi aceita, cobrada e enfileirada. Não significa que foi entregue. A entrega é uma resposta separada que chega como recibo. Veja Enviar uma mensagem.

O que este quickstart não oferece

Faltando	Por que importa	Onde
Um banco de dados	Sem crédito pré-pago, sem varredura de expiração, sem edição no painel	Database
O painel de controle	Sem telas, sem statements, sem portal do cliente	Instalar o painel
Retenção de logs	`httpapi.log` cresce indefinidamente	Logging
Um vendor real	Nada sai do prédio	Vendors
TLS	Tudo em texto claro	Instalar manualmente

A seguir

Conceitos

As palavras que o restante deste site usa. Leia antes das páginas de instalação.

Instalar corretamente

Conta de serviço, systemd, banco de dados, firewall, smoke test.

Start here

The control panel

Install and run

Connections

Routing

Customers and approvals

Billing

Operations

Troubleshooting

Migrating

Project

Quickstart

O que você precisa

Inicie-o

Verifique se subiu

Envie algo através dele

O que este quickstart não oferece

A seguir

Conceitos

Instalar corretamente

​O que você precisa

​Inicie-o

​Verifique se subiu

​Envie algo através dele

​O que este quickstart não oferece

​A seguir

Conceitos

Instalar corretamente

O que você precisa

Inicie-o

Verifique se subiu

Envie algo através dele

O que este quickstart não oferece

A seguir