OLT DATACOM

Criada por Danilo Tomich, Modificado em Sex, 12 Set na (o) 12:08 PM por Danilo Tomich

? Passo a Passo Instalação BeeSoft OLT Datacom + Zabbix + Grafana

1. Criar diretórios do projeto

mkdir -p /opt/bee/beesoftPro
mkdir -p /opt/bee/beesoftPro/tmp/logs/
mkdir -p /opt/bee/beesoftPro/tmp/datacom
mkdir -p /var/tmp/zabbix/
mkdir -p /var/tmp/zabbix/datacom
chown -R zabbix:zabbix /var/tmp/zabbix

2. Instalar dependências

apt update
apt install -y python3-dev default-libmysqlclient-dev build-essential python3-venv pkg-config dos2unix mariadb-server

3. Criar ambiente virtual e instalar libs

cd /opt/bee/beesoftPro
python3 -m venv venv

Ative o ambiente virtual e instale as dependencias

source venv/bin/activate

Faca o download das dependencias do projeto (Chame no PV para enviar o projeto) (Crie um arquivo chamado dependencias.txt e cole o conteudo do dependencias.txt que esta junto aos arquivos que voce baixou na pasta django)

cd /opt/bee/beesoftPro
nano dependencias.txt (cole o conteudo nesse novo arquivo)

pip install -r /opt/bee/beesoftPro/dependencias.txt

4. Criar banco MySQL

Crie o banco de dados que voce vai usar na aplicacao (Nesse exemplo coloquei um usuario para o grafana, pra caso voce queira consulta o banco de dados diretamente por la...)

mysql -u root -p
Vai pedir senha: Digite a senha root do linux
CREATE DATABASE beesoft_db_01 CHARACTER SET utf8mb4 COLLATE utf8mb4_bin; 
CREATE USER beesoftadmin@localhost IDENTIFIED BY 'Tomich.10'; ('AQUI-VOCE-COLOCA-SUA-SUPER-SENHA-PRA-APLICACAO')
GRANT ALL PRIVILEGES ON beesoft_db_01.* TO beesoftadmin@localhost; 
CREATE USER beesoftconsultor@localhost IDENTIFIED BY 'Tomich.100'; ('AQUI-VOCE-COLOCA-UMA-SENHA-BOA-PRA-USAR-NO-GRAFANA';)
GRANT SELECT ON beesoft_db_01.* TO beesoftconsultor@localhost;
quit;

5. Configurar Django

Crie o projeto django (Esse "." e importante)

cd /opt/bee/beesoftPro
django-admin startproject beesoft .

Crie um app django

django-admin startapp ftth

6. Ajuste o arquivo de configuração conforme exemplo junto aos arquivos

mv /opt/bee/beesoftPro/beesoft/settings.py /opt/bee/beesoftPro/beesoft/settings.py.bkp

# Cole aqui todo o conteudo do arquivo settings.py (Arquivo no diretorio django)

nano /opt/bee/beesoftPro/beesoft/settings.py

7. Crie o arquivo chave.py (Arquivo no diretorio django)

nano /opt/bee/beesoftPro/beesoft/chave.py

# Execute o script para gerar as chaves (Guarde essas chaves que você vai as utilizar em seguida)

python /opt/bee/beesoftPro/beesoft/chave.py

8. Crie o arquivo com as credenciais conforme exemplo junto aos arquivos (Arquivo no diretorio django) (Adicione o IP do seu servidor)

nano /opt/bee/beesoftPro/beesoft/.env

(Mude o dominimo monitor.tomich.com.br para o seu que vai acessar o sistema, se não tiver, basta remover esse dominio)

SECRET_KEY=COLE_AQUI
FERNET_KEY=COLE_AQUI
DEBUG=True
ALLOWED_HOSTS=127.0.0.1,localhost,SEU-IP, monitor.tomich.com.br
DB_NAME=beesoft_db_01
DB_USER=beesoftadmin
DB_PASSWORD=Tomich.10 (SENHA-DO-BD)
DB_HOST=127.0.0.1
DB_PORT=3306

6. Migrar banco e criar usuário Django

cd /opt/bee/beesoftPro python manage.py makemigrations python manage.py migrate python manage.py createsuperuser --username admin --email admin@tomich.com.br

7. Adicione o conteudo do models.py

mv /opt/bee/beesoftPro/ftth/models.py /opt/bee/beesoftPro/ftth/models.py.bkp

# Cole aqui todo o conteudo do arquivo models.py (Arquivo no diretorio django)

nano /opt/bee/beesoftPro/ftth/models.py

13. Adicione o conteudo do admin.py (Arquivo no diretorio django)

mv /opt/bee/beesoftPro/ftth/admin.py ftth/admin.py.bkp

# Cole aqui todo o conteudo do arquivo admin.py (Arquivo no diretorio django)

nano /opt/bee/beesoftPro/ftth/admin.py

# Crie o arquivo de template para o form de cadastro da OLT (Cole aqui o conteudo do arquivos forms.py disponivel junto aos arquivos)

nano /opt/bee/beesoftPro/ftth/forms.py

14. Faca a migracao dos dados

cd /opt/bee/beesoftPro

python manage.py makemigrations

python manage.py migrate

15. Crie um novo super-usuario para acessar o admin do django

python manage.py createsuperuser

Usuário (leave blank to use 'root'): admin

Endereço de email: danilo@tomich.com.br

Password:

Password (again):

A senha é muito parecida com endereço de email

Bypass password validation and create user anyway? [y/N]: y

Superuser created successfully.

(venv) root@zabbix[/opt/bee/beesoftPro]#

16. Realize um teste, e inicie o admin para poder cadastrar as OLTs (Nesse exemplo toda vez que voce precisar cadastrar uma nova OLT basta iniciar o Amin. Posso mostrar depois como deixar esse servico rodando em segundo plano. hehe)

python manage.py runserver IP-SEU-SERVIDOR:9000

Pode apertar o CTRL + C, mas certamente ele vai ficar travado. Precisa liberar.

Caso de esse erro:

Error: That port is already in use.

A porta esta sedo utilizada.

? Ver qual processo está na porta 9000

ss -ltnp | grep 9000

lsof -i:9000

Vai mostrar o PID do processo que está segurando a porta.

? Encerrar esse processo

Pegue o PID e mate o processo:

kill -9 PID_AQUI

Exemplo:

kill -9 1625

Confirme que a porta está livre:

ss -ltnp | grep 9000

(se não aparecer nada → porta liberada ✅

Para abrir via navegador, execute esse comando, deixa ele em aberto, e abra no navegador. Mas não precisa fazer nada no navegador, so mesmo par conferir.

cd /opt/bee/beesoftPro

source venv/bin/activate

python manage.py runserver 0.0.0.0:9000

Exemplo:

#Acesse a pagina do django admin via:

http://IP-SEU-SERVIDOR:9000/admin

User: admin

Senha: Tomich@.10

###Para deixar o Django sempre iniciando automatico

✅ Opção 2 – Criar um systemd service (recomendado)

Assim o Django sobe automático no boot e você pode gerenciar com systemctl.

Crie o arquivo de serviço:

nano /etc/systemd/system/beesoft.service

Cole o conteúdo:

[Unit]

Description=BeeSoft Django Service

After=network.target mariadb.service

[Service]

User=root

Group=root

WorkingDirectory=/opt/bee/beesoftPro

Environment="PATH=/opt/bee/beesoftPro/venv/bin"

ExecStart=/opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/manage.py runserver 0.0.0.0:9000

Restart=always

[Install]

WantedBy=multi-user.target

Recarregue o systemd e ative:

systemctl daemon-reload

systemctl enable beesoft

systemctl start beesoft

Verifique se está rodando:

systemctl status beesoft

Se der esse tipo de erro, é pq a porta ja esta utilizando.
Dae execute os comandos logo acima para encerrar o uso da porta.

E depois execute de novo:

Reinicie o serviço systemd:

systemctl restart beesoft 
systemctl status beesoft -l --no-pager

Confirmando:

Ele está habilitado para iniciar sempre:

systemctl is-enabled beesoft

Se retornar enabled, já está garantido no boot.

Caso queira cadastrar as olts

#Acesse a pagina do django admin via:

http://IP-SEU-SERVIDOR:9000/admin

User: admin

Senha: Tomich@.10

# Abra o admin e cadastre as suas OLT Datacom

#### Parte 2 ####

17. Crie um arquivo para acesso ao banco de dados

nano /opt/bee/beesoftPro/beesoft/.my.cnf

[client]

host = 127.0.0.1

user = beesoftadmin

password = Tomich.10 'AQUI-VOCE-COLOCA-SUA-SUPER-SENHA-PRA-APLICACAO'

19. Copie o script auxiliar (pondtc.sh), disponivel junto aos demais arquivos, para contabilizar a quantidade de onus por status (Optei por usar a consulta no BD do Beesoft, pois via telnet e ssh ficava muito pesado em olts maiores)

Mas antes vamos criar ele:

nano /usr/lib/zabbix/externalscripts/pondtc.sh

(Arquivo disponivel na pasta do projeto)

mv /usr/lib/zabbix/externalscripts/pondtc.sh /usr/lib/zabbix/externalscripts/pondtc

chmod +x /usr/lib/zabbix/externalscripts/pondtc

20. Converta o script para unix e de permissao de execucao

Antes vamos criar eles. Arquivos na pasta do projeto:

Local:

nano /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py

nano /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py

dos2unix /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py

chmod +x /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py

21. Teste o agente Datacom cache e geral

python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py IP-DA-SUA-OLT-AQUI

python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py IP-DA-SUA-OLT-AQUI

ou dessa forma:

/opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py 10.32.52.2

/opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py 10.32.52.2

22. Adicione as informacoes ao crontab (Ex: execucao a cada 15 minutos):

crontab -e

# Atualizando o status das ONUs a cada 15 minutos | Lista de Status

*/15 * * * * /opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py IP-DA-SUA-OLT-AQUI > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_cache_pro.txt

# Adicionando as informacoes de sinal das ONUs uma vez ao dia | Lista de ONUs

0 5 * * * /opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py IP-DA-SUA-OLT-AQUI > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_pro.txt

#OLT FUNDÃO

# Atualizando o status das ONUs a cada 30 minutos | Lista de Status

*/30 * * * * /opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py 10.32.52.2 > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_cache_pro.txt 2>&1

# Adicionando as informações de sinal das ONUs uma vez ao dia (às 05h00) | Lista de ONUs

0 5 * * * /opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py 10.32.52.2 > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_pro.txt 2>&1

###Para teste de esta rodando:

? Dica

Você não precisa esperar na tela. Pode rodar em segundo plano:

/opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py 10.32.52.2 > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_cache_pro.txt 2>&1 &

Note o & no final → assim ele roda em background.

Depois você acompanha o log:

tail -f /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_cache_pro.txt

23. Importe o template complementar no Zabbix e json no Grafana | Aproveite ;)

No grafana, não esqueça de criar um outro banco de dados para django no mysql.

exemplo:

Va em datasouce

add new data source

name: mysql-django

host URL: 127.0.0.1

Database name: beesoft_db_01

Username: beesoftconsultor

Password: Tomich.100

Depois no template mude para esse banco de dados as variaveis.

#######fim

########rascunho abaixo

? Esse script já instala dependências, cria venv, banco, usuários MySQL e configura o systemd. Depois é só colar seus arquivos (settings.py, models.py, admin.py, forms.py, .env, scripts Python e shell).

Quer que eu já monte também o comando SQL que cria a tabela ftth_onu no beesoft_db_01 (caso ainda não tenha sido populada)?

# OBSERVACAO IMPORTANTE #

-> OLT DATACOM TEM CPU FRACA PARA MONITORAMENTO, ENTAO ACOMPANHE O USO DE RECURSOS E AJUSTE OS INTERVALOS DE VERIFICACAO CONFORME CENARIO <-

#### Parte 1 ####

1. Crie os diretorios de base do projeto

mkdir -p /opt/bee/beesoftPro

mkdir -p /opt/bee/beesoftPro/tmp/logs/

mkdir -p /opt/bee/beesoftPro/tmp/datacom

mkdir -p /var/tmp/zabbix/

mkdir -p /var/tmp/zabbix/datacom

chown -R zabbix:zabbix /var/tmp/zabbix/

cd /opt/bee/beesoftPro

2. Instale as dependencias

apt update

apt-get install python3-dev default-libmysqlclient-dev build-essential python3-venv pkg-config dos2unix

3. Crie um ambiente virtual

python3 -m venv venv

4. Ative o ambiente virtual e instale as dependencias

source venv/bin/activate

5. Faca o download das dependencias do projeto (Crie um arquivo chamado dependencias.txt e cole o conteudo do dependencias.txt que esta junto aos arquivos que voce baixou na pasta django)

pip install -r /opt/bee/beesoftPro/dependencias.txt

6. Crie o banco de dados que voce vai usar na aplicacao (Nesse exemplo coloquei um usuario para o grafana, pra caso voce queira consulta o banco de dados diretamente por la...)

mysql -u root -p

mysql> create database beesoft_db_01 character set utf8mb4 collate utf8mb4_bin;

mysql> create user beesoftadmin@localhost identified by 'Tomich.10'; ('AQUI-VOCE-COLOCA-SUA-SUPER-SENHA-PRA-APLICACAO')

mysql> grant all privileges on beesoft_db_01.* to beesoftadmin@localhost;

mysql> create user beesoftconsultor@localhost identified by 'Tomich.100'; ('AQUI-VOCE-COLOCA-UMA-SENHA-BOA-PRA-USAR-NO-GRAFANA';)

mysql> grant SELECT on beesoft_db_01.* to beesoftconsultor@localhost;

mysql> quit

7. Crie o projeto django (Esse "." e importante)

django-admin startproject beesoft .

8. Crie um app django

django-admin startapp ftth

9. Ajuste o arquivo de configuração conforme exemplo junto aos arquivos

mv /opt/bee/beesoftPro/beesoft/settings.py /opt/bee/beesoftPro/beesoft/settings.py.bkp

# Cole aqui todo o conteudo do arquivo settings.py (Arquivo no diretorio django)

nano /opt/bee/beesoftPro/beesoft/settings.py

10. Crie o arquivo chave.py (Arquivo no diretorio django)

nano /opt/bee/beesoftPro/beesoft/chave.py

# Execute o script para gerar as chaves (Guarde essas chaves que você vai as utilizar em seguida)

python /opt/bee/beesoftPro/beesoft/chave.py

SNET:

(venv) root@zabbix[/opt/bee/beesoftPro/beesoft]# python /opt/bee/beesoftPro/beesoft/chave.py

Fernetkey: P1o_GuMfoRCWkR661Hvj0OlX-UhqBv00Zsa3ME_tWjY=

Secretkey: p4_4(@d+a44qu9v$8^^w(@*^l+e)g1q!!4skb7l3lw2x-ublib

11. Crie o arquivo com as credenciais conforme exemplo junto aos arquivos (Arquivo no diretorio django) (Adicione o IP do seu servidor)

nano /opt/bee/beesoftPro/beesoft/.env

SECRET_KEY=SECRET-KEY-AQUI

FERNET_KEY=FERNET-KEY-AQUI

DEBUG=True

ALLOWED_HOSTS=127.0.0.1, localhost, beesoft.provedor.com.br, SEU-IP-DO-SERVIDOR-AQUI

DB_NAME=beesoft_db_01

DB_USER=beesoftadmin

DB_PASSWORD=Tomich.10 (SENHA-DO-BD)

DB_HOST=127.0.0.1

DB_PORT=3306

12. Adicione o conteudo do models.py

mv /opt/bee/beesoftPro/ftth/models.py /opt/bee/beesoftPro/ftth/ftth/models.py.bkp

# Cole aqui todo o conteudo do arquivo models.py (Arquivo no diretorio django)

nano /opt/bee/beesoftPro/ftth/models.py

13. Adicione o conteudo do admin.py (Arquivo no diretorio django)

mv /opt/bee/beesoftPro/ftth/admin.py ftth/admin.py.bkp

# Cole aqui todo o conteudo do arquivo admin.py (Arquivo no diretorio django)

nano /opt/bee/beesoftPro/ftth/admin.py

# Crie o arquivo de template para o form de cadastro da OLT (Cole aqui o conteudo do arquivos forms.py disponivel junto aos arquivos)

nano /opt/bee/beesoftPro/ftth/forms.py

14. Faca a migracao dos dados

cd /opt/bee/beesoftPro

python manage.py makemigrations

python manage.py migrate

15. Crie um novo super-usuario para acessar o admin do django

python manage.py createsuperuser

Usuário (leave blank to use 'root'): admin

Email address: admin@tomich.com.br

Password: Tomich@.10

Password (again): Tomich@.10

Superuser created successfully.

python manage.py runserver IP-SEU-SERVIDOR:9000

Caso de esse erro:

Error: That port is already in use.

A porta esta sedo utilizada.

? Ver qual processo está na porta 9000

ss -ltnp | grep 9000

lsof -i:9000

Vai mostrar o PID do processo que está segurando a porta.

? Encerrar esse processo

Pegue o PID e mate o processo:

kill -9 PID_AQUI

Exemplo:

kill -9 12345

### Depois veja em cli se esta rodando.

cd /opt/bee/beesoftPro

source venv/bin/activate

python manage.py runserver 0.0.0.0:9000

Caso o navegador não abra mais o django pode ser que o serviço parou. execute>

cd /opt/bee/beesoftPro

source venv/bin/activate

python manage.py runserver 0.0.0.0:9000

###Para deixar o Django sempre iniciando automatico

✅ Opção 2 – Criar um systemd service (recomendado)

Assim o Django sobe automático no boot e você pode gerenciar com systemctl.

Crie o arquivo de serviço:

nano /etc/systemd/system/beesoft.service

Cole o conteúdo:

[Unit]

Description=BeeSoft Django Service

After=network.target mariadb.service

[Service]

User=root

Group=root

WorkingDirectory=/opt/bee/beesoftPro

Environment="PATH=/opt/bee/beesoftPro/venv/bin"

ExecStart=/opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/manage.py runserver 0.0.0.0:9000

Restart=always

[Install]

WantedBy=multi-user.target

Recarregue o systemd e ative:

systemctl daemon-reload

systemctl enable beesoft

systemctl start beesoft

Verifique se está rodando:

systemctl status beesoft

Teste no navegador:

http://172.31.100.18:9000/admin

#Acesse a pagina do django admin via:

http://IP-SEU-SERVIDOR:9000/admin

User: admin

Senha: Tomich@.10

# Abra o admin e cadastre as suas OLT Datacom

#### Parte 2 ####

17. Crie um arquivo para acesso ao banco de dados

nano /opt/bee/beesoftPro/beesoft/.my.cnf

[client]

host = 127.0.0.1

user = beesoftadmin

password = 'AQUI-VOCE-COLOCA-SUA-SUPER-SENHA-PRA-APLICACAO'

18. Copie os arquivos agente_beesoft_ftth_datacom_cache.py e agente_beesoft_ftth_datacom_geral.py para o diretorio do projeto (/opt/bee/beesoftPro/)

mv /usr/lib/zabbix/externalscripts/pondtc.sh /usr/lib/zabbix/externalscripts/pondtc

chmod +x /usr/lib/zabbix/externalscripts/pondtc

20. Converta o script para unix e de permissao de execucao

dos2unix /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py

chmod +x /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py

21. Teste o agente Datacom cache e geral

python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py IP-DA-SUA-OLT-AQUI

python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py IP-DA-SUA-OLT-AQUI

ou dessa forma:

/opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py 10.32.52.2

/opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py 10.32.52.2

22. Adicione as informacoes ao crontab (Ex: execucao a cada 15 minutos):

Lembre de adicionar de todas OLTs que tiver! E coloque o tempo diferente uma da outra.

crontab -e

# Atualizando o status das ONUs a cada 15 minutos | Lista de Status

# Adicionando as informacoes de sinal das ONUs uma vez ao dia | Lista de ONUs

0 5 * * * /opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py IP-DA-SUA-OLT-AQUI > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_pro.txt

#OLT FUNDÃO

# Atualizando o status das ONUs a cada 30 minutos | Lista de Status

*/30 * * * * /opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py 10.32.52.2 > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_cache_pro.txt 2>&1

# Adicionando as informações de sinal das ONUs uma vez ao dia (às 05h00) | Lista de ONUs

0 5 * * * /opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_geral.py 10.32.52.2 > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_pro.txt 2>&1

###Para teste de esta rodando:

? Dica

Você não precisa esperar na tela. Pode rodar em segundo plano:

/opt/bee/beesoftPro/venv/bin/python /opt/bee/beesoftPro/agente_beesoft_ftth_datacom_cache.py 10.32.52.2 > /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_cache_pro.txt 2>&1 &

Note o & no final → assim ele roda em background.

Depois você acompanha o log:

tail -f /opt/bee/beesoftPro/tmp/logs/log_agente_ftth_datacom_beesoft_cache_pro.txt

23. Importe o template complementar no Zabbix e json no Grafana | Aproveite ;)

No grafana, não esqueça de criar um outro banco de dados para django no mysql.

exemplo:

Va em datasouce

add new data source

name: mysql-django

host URL: 127.0.0.1

Database name: beesoft_db_01

Username: beesoftconsultor

Password: Tomich.100

Depois no template mude para esse banco de dados as variaveis.
Exemplo: