Académique Documents
Professionnel Documents
Culture Documents
2 www.maxtrack.com.br
Utilizando este manual
Nas instruções a seguir, assumimos que o usuário detém de um extensivo conhecimento técnico, além de
ter sido treinado para manusear o produto.
SÍMBOLOS UTILIZADOS
DIREITOS AUTORAIS
3 www.maxtrack.com.br
Conteúdo
4 www.maxtrack.com.br
Indicação de erros. .................................................................................................................................35
Ausência de arquivo license.dat ou equipamento não licenciado. ........................................................35
Log do módulo Gateway. .......................................................................................................................36
Conexão com equipamento. ..................................................................................................................37
Erros associados ao arquivo de licença. .................................................................................................37
Atualização ............................................................................................................................................................ 38
Backup ....................................................................................................................................................38
Processo de atualização .........................................................................................................................39
Atualização dos Handlers .......................................................................................................................39
Atualização do License.dat .....................................................................................................................39
5 www.maxtrack.com.br
Conteúdo Ilustrativo
6 www.maxtrack.com.br
Introdução
Este manual tem por objetivo detalhar o processo de instalação e configuração do Maxtrack Gateway para
Linux.
Neste manual também poderão ser encontradas informações para manutenção e o funcionamento
adequado do Maxtrack Gateway.
7 www.maxtrack.com.br
Requisitos mínimos do servidor
Para o correto funcionamento do Maxtrack Gateway, devemos utilizar uma distribuição Linux homologada
para o seu correto funcionamento, podendo ser utilizada as seguintes distribuições:
Debian 6.0 Squeze x64
Opensuse x64
Importante: É recomendado que o Linux esteja atualizado com os últimos pacotes de up-
dates da versão. Caso se utilize uma distribuição diferente das recomendas, todos os
parâmetros de instalação e estabilidade de funcionamento do Maxtrack Gateway serão de
responsabilidade do usuário.
8 www.maxtrack.com.br
Na figura abaixo, temos uma ideia da estrutura proposta de funcionamento do Sistema.
Módulos de
rastreamento
veicular
Satélite
Internet GPRS /
Interface Interface
de rede 1 de rede 2
Servidor
Firewall Maxtrack
Gateway R
E
D
E Estações de
monitoramento
L
Servidor O
do banco C
de dados A
L
Servidor
de aplicação
(ACCWEB)
9 www.maxtrack.com.br
Visão geral de funcionamento do Maxtrack Gateway
O serviço do Maxtrack Gateway é responsável por receber, decodificar e gravar no servidor os dados
enviados dos módulos de rastreamento veicular. Através desse serviço, são enviados os comandos para o
módulo de rastreamento veicular (acionamento de saídas como: bloqueio, sirene, desativação do alerta,
mensagens para o terminal de dados, etc.). Assim, toda a comunicação com o módulo de rastreamento
veicular é feita pelo Maxtrack Gateway através de uma conexão TCP ou UDP conforme configuração e
especificação técnica do módulo de rastreamento veicular. Ao ser configurado em bancada, através do
Maxtrack Setup, o módulo de rastreamento veicular é programado para enviar os dados a um determinado
IP e PORTA. O Gateway receberá os dados enviados para esta porta e vai realizar o tratamento das
informações.
Estes dados podem ser tratados de diversas formas, dentre elas, podemos destacar:
Gravar em uma base de dados conhecida, por exemplo, a base de dados do Arena Control Center,
ACCWeb ou Maxtrack IT, que são Sistemas desenvolvidos pela Maxtrack para possibilitar a
visualização do estado atual do veículo, exibição de histórico e diversas outras funcionalidades.
Disponibilizar os dados em arquivos padronizados no formato XML.
Encaminhar estruturas definidas em um servidor de fila de mensagens.
Aplicações customizadas podem ser desenvolvidas para o tratamento destes dados. Para isso, pode se
processar os arquivos XML ou simplesmente obter os dados postados no servidor de fila de mensagens.
Nota: Caso opte pelo desenvolvimento de uma aplicação customizada, é necessário entrar
em contato com o Departamento Comercial da Maxtrack para obter maiores detalhes.
Além da comunicação via GPRS, alguns módulos de rastreamento veicular possuem a tecnologia de
comunicação via Satélite. Esta última é realizada pelo Gateway através de uma biblioteca de vínculo
dinâmico a ser abordada na seção, Configuração do Maxtrack Gateway (Ver página Erro! Indicador não
definido.).
10 www.maxtrack.com.br
Componentes do Maxtrack Gateway
O Maxtrack Gateway atualmente é composto por três aplicações:
Gateway (maxtrack_gateway): Aplicação responsável por realizar a comunicação com o
equipamento, receber e decodificar os dados e enviar comandos para os módulos.
Qpid (qpid): Aplicação responsável por gerenciar as filas de mensagens que são utilizadas
pelos processos Gateway e o Data Processor.
Data Processor (maxtrack_data_processor): Aplicação responsável por ler os dados decodificados
pelo gateway que se encontra em uma fila do servidor de mensagens e inserir na fila de
mensagens os comandos gerados pelo usuário que vão ser enviados para os módulos de
rastreamento veicular.
11 www.maxtrack.com.br
A figura a seguir exibe o fluxo de comunicação entre os processos do Maxtrack Gateway e os módulos de
rastreamento veicular.
Servidor
Maxtrack
Gateway
Servidor Maxtrack Gateway
maxtrack_gateway.exe
Firewall
qpidd.exe
Internet
maxtrack_data_processor.exe
Módulos de
Rastreamento
Pastas com
Veicular
arquivos XML
Aplicação
BD’s Maxtrack Proprietária
Estações de
Monitoramento
Aplicação
Maxtrack
O envio de comandos ocorre da seguinte forma, a aplicação do usuário insere o comando no banco de
dados (Accweb, Arena Control Center ou Maxtrack IT), ou é gerado um XML na pasta de comandos, em
seguida, a data handler específica do Data Processor detecta o comando inserido, codifica em uma
mensagem definida e insere na fila de mensagens de comandos do QPID, o processo Gateway consome
essa mensagem da fila, codifica para o formato do protocolo do módulo de rastreamento veicular e envia o
comando para este.
12 www.maxtrack.com.br
O fluxo demonstrado abaixo exemplifica a comunicação bidirecional entre os processos.
GATEWAY
CONNECTION
CONNECTION
PRODUCER CONSUMER
QPID
Módulos de
BROKER Rastreamento
Veicular
FILA DE FILA DE
MENSAGENS COMANDOS
CONSUMER PRODUCER
DATA HANDLER
DATA HANDLER
DATA PROCESSOR
13 www.maxtrack.com.br
Instalação do Maxtrack Gateway
Este é um guia de instalação que deve ser seguido passo a passo para efetivar a correta instalação do
Maxtrack Gateway.
1. Primeiramente, vamos resolver as dependências de aplicativos e bibliotecas necessárias
para a instalação dos componentes Maxtrack Gateway.
Nesta instalação, vamos utilizar uma distribuição Linux Debian 6.0 Squeeze x64. Devemos iniciar
instalando os seguintes pacotes:
mysql-client-5.1
libmysql++3
uuid-dev
pkg-config
build-essential
make
autoconf
automake
help2man
libtool
libmysql++3
mysql-client-5.1
doxygen
graphviz
ruby
sasl2-bin
libicu-dev
libsasl2-dev
g++
Isto pode ser feito pelo comando:
apt-get install mysql-client-5.1 libmysql++3 uuid-dev pkg-config build-essential make
autoconf automake help2man libtool doxygen graphviz ruby sasl2-bin libicu-dev libsasl2-dev g++
Atenção: Os pacotes acima mencionados são indispensáveis para dar sequência aos
demais procedimentos de instalação e execução do Maxtrack Gateway
3. Com a pasta do Maxtrack_Gateway copiada para o diretório /usr/local, acesse a pasta do Maxtrack
Gateway /usr/local/Maxtrack_gateway e, dentro da pasta do Maxtrack_gateway, irá conter a
seguinte arquitetura de pastas:
14 www.maxtrack.com.br
Exemplo de arquitetura mostrada em Windows:
4. Realize o download do seu arquivo license.dat no site do suporte da Maxtrack e copie-o para a
pasta license, dentro do diretório do Maxtrack Gateway.
5. Realize o download das libs correspondentes aos sistemas utilizados (XML, accweb) e copie-os para
o diretório data_handler dentro do diretório libs no diretório do Maxtrack Gateway.
6. Realize o download das dependências do Maxtrack Gateway Fila Linux através do site da Maxtrack,
o nome do arquivo é: dependencies.tar.g
7. Após o download das dependências, o arquivo compactado irá conter uma pasta chamada
dependencies, dentro dessa pasta, haverá outra pasta chamada lib. Todo o conteúdo da pasta lib
deve ser copiado para a pasta do sistema: /usr/lib .
8. Baixar e compilar o pacote de lib da libboost 1.53 com as opções date_time, filesystem, regex,
serialization, signals, system, thread, program_options.
15 www.maxtrack.com.br
Abaixo veremos os passos necessários para compilar esta biblioteca.
Baixando a libboost, versão 1.53.
# wget http://ufpr.dl.sourceforge.net/project/boost/boost/1.53.0/boost_1_53_0.tar.bz2
Descompactando o arquivo.
# tar xvjf boost_1_53_0.tar.gz
Acesse o diretório e de permissão de execução ao arquivo bootstrap.
# cd boost_1_53_0
# chmod a+x bootstrap.sh
Execute o bootstrap.sh.
# ./bootstrap.sh
O Comando abaixo irá compilar e instalar somente as bibliotecas necessárias, este processo é
demorado.
Arquitetura x64.
# ./b2 address-model=64 --prefix=/usr --layout=system --with-iostreams --with-chrono --with-
date_time --with-filesystem --with-regex --with-serialization --with-signals --with-system --with-
thread --with-program_options --with-test install
9. Baixar e compilar o pacote Qpid, deve se escolher onde instalar definindo na opção prefix.
Baixando o Qpid.
# wget http://www.apache.org/dyn/closer.cgi/qpid/0.20/qpid-cpp-0.20.tar.gz
Descompactando o arquivo.
# tar xvzf qpid-cpp-0.20.tar.gz
Acesse o diretório e configure os fontes.
# cd qpid-cpp-0.20
# ./configure --prefix=<caminho de instalação>
Compilando e instalando a aplicação no caminho configurado.
# make install
10. Baixar e compilar o pacote Protoburf, deve se escolher onde instalar definindo na opção prefix.
Baixando o Protobuf.
# wget http://code.google.com/p/protobuf/downloads/detail?name=protobuf-2.5.0.tar.gz
Descompactando o arquivo.
# tar zxvf protobuf-2.5.0.tar.gz
Acesse o diretório e configure os fontes.
# cd protobuf-2.5.0
# ./configure --prefix=<caminho de instalação>
Compilando e instalando a aplicação no caminho configurado.
# make install
11. Agora será necessário copiar as libs do Qpid e Protobuf para a pasta do sistema.
Copiando as bibliotecas
16 www.maxtrack.com.br
# cp /<caminho de instalação>/qpid-tools/lib/lib* /usr/lib
# cp /<caminho de instalação>/protobuf-tools/lib/lib* /usr/lib
# cd /usr/local/maxtrack_gateway
13. Para iniciar o Maxtrack Gateway corretamente, primeiramente, deve ser iniciado o serviço do
QPIDD, posteriormente, o Gateway e, por fim, o serviço do data_processor.
Iniciando o QPIDD
./maxtrack_gateway linux_gateway.conf
Iniciando o Data_Processor
./maxtrack_data_processor linux_data_processor.conf
17 www.maxtrack.com.br
Para iniciar o gateway em modo Debug.
./maxtrack_gateway -d linux_gateway.conf
Iniciando o Data_Processor
./maxtrack_data_processor -d linux_data_processor.conf
14. Após realização desses procedimentos, executar o comando abaixo para verificar se o qpidd
iniciou corretamente:
16. Acessar o diretório LOGS e verificar se os logs do gateway e do data processor estão
sendo gerados corretamente.
18 www.maxtrack.com.br
Configuração dos módulos
Atenção: Ao definir um valor para utilizar no campo porta de conexão, tenha certeza que
este não esteja sendo utilizado por outro aplicativo ou tenha alguma regra encaminhando
o tráfego para um destino diferente. Caso haja duas instalações do Maxtrack Gateway em
um mesmo servidor, deve se atentar para definir valores distintos nesta opção em cada
instalação.
Porta de espera por pedidos de status retorna informações do modulo maxtrack_gateway no padrão
XML. Exemplo de consulta: HTTP://HOSTNAME:PORTA
monitor_port = 9004
Atenção: Ao definir um valor para utilizar no campo porta de conexão, tenha certeza que
este não esteja sendo utilizado por outro aplicativo ou tenha alguma regra encaminhando
o tráfego para um destino diferente. Caso haja duas instalações do Maxtrack Gateway em
um mesmo servidor, deve se atentar para definir valores distintos nesta opção em cada
instalação.
Caminho da pasta de log ou arquivo onde todo o log será gerado. Caso especifique uma pasta os
arquivos vão ser gerados dentro dela no padrão aaaa-mês-dd_gateway.log.
log_file = logs
Atenção: Se for especificada uma pasta, o Gateway irá gerar arquivos por dia, se for
especificado um arquivo todo, o log será gravado naquele arquivo.
19 www.maxtrack.com.br
Aqui você define o caminho e nome da pasta de repositório onde o Gateway vai procurar por arquivos
a enviar ao módulo, estes podem ser, firmwares, ação embarcada, bibliotecas de motorista, etc.
repository_dir = repository
Aqui você informa ao gateway o tempo máximo que ele deve manter uma conexão aberta com um
módulo de rastreamento que não esteja transmitindo.
connection_timeout = 120
Período de tempo em segundos para cada tentativa de envio dos comandos que são inseridos no
diretório com os equipamentos off-line:
command_retry_timeout = 30
Aqui você informa ao gateway tempo de espera entre um comando e outro que aguarda para ser
enviado na fila de comandos.
time_between_commands = 3
Diretório das bibliotecas de protocolo:
protocol_library_dir = libs/protocol
Diretório para o arquivo de licenças:
lock_dir = license
IP de conexão com o Qpid.
broker_ip = 127.0.0.1
Porta de conexão com o Qpid.
broker_port = 5672
Nome da fila em que serão postadas as mensagens, posições e respostas de comando:
data_message_queue = mxt_data_qpid
Tamanho da fila. Este tamanho definirá a quantidade máxima de posições em espera, se este valor for
atingido, o gateway irá interromper o servidor de conexões para que os módulos armazenem as
posições em memória até que esta fila fique abaixo de 80% quando o gateway irá reabrir o servidor de
conexões:
data_message_queue_size = 3000
20 www.maxtrack.com.br
Nota: No campo, command_message_queue_size, o valor definido é alocado em
posições enviadas pelo módulo de rastreamento, isto foi definido dessa forma, pois
o tamanho de um pacote pode variar de acordo com a quantidade de informações
nele contidas assim, o valor informado será calculado por posições e não em espaço
alocado.
Usar fila de serviços, esta fila irá conter status do módulo, como módulo conectado e módulo
desconectado.
use_service_message_queue = 0
Atenção: Esta fila deve ter um tamanho grande, pois são muitos status ao mesmo
tempo, se não for consumir este status desabilite esta fila devido seu valor para zero.
Mantendo este campo com valor um, o gateway vai imprimir um tag a mais no XML de posição
informando a coordenada GPS em UTM.
utm_coordinate = 1
Mantendo este campo com valor um, o gateway vai fazer cálculos de conversão das coordenas do
padrão WGS-84, fornecido pelo GPS do módulo de rastreamento para este padrão, e imprimir no
pacote de posição XML uma tag LATITUDE_SAD69 e LONGITUDE_SAD69 com os respectivos valores.
sad69_datum = 1
Define as pastas que os protocolos ID-780 e MTC-550 vão gravar as imagens vindas dos módulos.
mtc550_image_dir = images/mtc550
idp780_image_dir = images/idp780
idp780skywave_image_dir = images/idp780skywave
Importante: Os arquivos salvos nesta(as) pasta(as), serão salvos em formato binário e não
nos formatos conhecidos como JPEG, JPG, PNG, etc.
21 www.maxtrack.com.br
Editando o arquivo linux_data_processor.conf
Acesse a pasta de instalação. No decorrer do manual vamos trabalhar com o caminho padrão de
instalação do Maxtrack Gateway como sendo /usr/local/maxtrack_gateway.
# cd /usr/local/maxtrack_gateway
Edite o arquivo de instalação do módulo linux_data_processor.conf.
# nano linux_gateway.conf
Porta de espera por pedidos de status retorna informações do modulo maxtrack_gateway no padrão
XML. Exemplo de consulta, HTTP://HOSTNAME:PORTA
monitor_port = 9005
Atenção: Ao definir um valor para utilizar no campo porta de conexão, tenha certeza que
este não esteja sendo utilizado por outro aplicativo ou tenha alguma regra
encaminhando o trafego para um destino diferente. Caso haja duas instalações do
Maxtrack Gateway em um mesmo servidor, deve se atentar para definir valores distintos
nesta opção em cada instalação.
Diretório onde está localizado os arquivos de comunicação com outros aplicativos, como Accweb,
Arena Control Center, XML ou aplicativos de desenvolvimento pessoal. A opção XML cria arquivos no
formato XML para integração com outras aplicações.
library_directory = libs/data_handler
Nível de detalhamento das mensagens de log, estes podem ser never, info, error ou debug.
log_level = error
Caminho da pasta de log ou arquivo onde todo o log será gerado. Caso especifique uma pasta os
arquivos vão ser gerados dentro dela no padrão aaaa-mês-dd_gateway.log.
log_file = logs
Atenção: Se for especificada uma pasta o Gateway irá gerar arquivos por dia, se for
especificado um arquivo todo o log será gravado naquele arquivo.
Número de threads do pool de threads. Essas threads são utilizadas pelas bibliotecas de tratamento de
mensagens para realizar operações que demandem tempo ou acesso a I/O:
pool_num_threads = 10
Número máximo de operações pendentes no pool de threads. Caso esse número seja atingido, a
thread que realizou o agendamento da operação ficará bloqueada até que o número de operações
pendentes diminua:
pool_max_messages = 1000
Aqui você deve informar o nome de uma pasta existente onde você armazenou os arquivos de licença.
22 www.maxtrack.com.br
lock_dir = license
IP de conexão com o Qpid.
broker_ip = 127.0.0.1
Prota de conexão com o Qpid.
broker_port = 5672
Nome da fila em que o data_processor irá procurar por novas mensagens.
data_processing_message_queue = mxt_data_qpid
Tamanho da fila, este tamanho definirá a quantidade máxima de mensagens em espera, se este valor
for atingido o gateway irá interromper o servidor de conexões para que os módulos armazenem as
posições em memória até que esta fila fique abaixo de 80% quando o gateway irá reabrir o servidor de
conexões.
data_processing_message_queue_size = 3000
Pasta em que o usuário ou programa irá gravar os arquivos XML com os comandos a serem enviados
para o módulo de rastreamento veicular.
xml_command_directory = xml/commands
Pasta em que serão gravadas as respostas dos comandos enviados pelo usuário ou programa.
xml_command_response_directory = xml/commands_response
Pasta onde serão gravadas as posições enviadas pelo módulo de rastreamento veicular no formato
XML.
xml_output_directory = xml/data
Intervalo de tempo em que serão geradas as posições:
xml_generation_interval = 10
Número máximo de posições por arquivo XML, valores menores que 51 desabilitam esta função.
xml_max_messages = 50
23 www.maxtrack.com.br
Importante: Caso os únicos meios para troca de informações com os equipamentos sejam
os softwares Arena, MIT ou Accweb é recomendável não se utilizar a xml_data_handler.so
para evitar consumo de espaço em disco pelos arquivos XML´s gerados.
24 www.maxtrack.com.br
accweb_commands_refresh_interval=1
#Nome do banco de dados
accweb_db_name=accweb
#Usuário
accweb_db_user=root
#Senha
accweb_db_password=accweb
#Tipo do banco de dados
accweb_db_type=mysql
25 www.maxtrack.com.br
Descrição dos campos de configuração.
Campo Significado Valor padrão
26 www.maxtrack.com.br
Pasta raiz HTTP Pasta raiz onde serão armazenados os arquivos do servidor doc_root
HTTP.
Porta do serviço. Porta TCP do QPID Broker que aceitará conexões. 5672
IP do serviço. IP de conexões com o QPID Broker. 127.0.0.1
Tamanho da fila. Número máximo de mensagens a ser armazenadas na fila 5000
Nome da fila. Nome da fila a ser utilizada para encaminhar as mensagens fila_dados_ext
de posição, setup e resposta de comandos.
27 www.maxtrack.com.br
Detalhando a configuração satelital do Maxtrack Gateway
Os equipamentos MTC 500 com TD-50, IDP-780 e MTC 550 podem comunicar-se por satélite com a central
de rastreamento utilizando um modem Skywave. As configurações e condições para isso encontram-se
descritas no Manual do MTC Setup. A comunicação no modo satelital ocorrerá de forma que o módulo de
rastreamento veicular se conecte à constelação de satélites da Skywave que encaminhará esses dados para
o seu servidor. O serviço Maxtrack Gateway deverá se conectar à esse servidor para acessar os pacotes de
posição enviados pelo módulo e gravar na base de dados. Para a conexão do serviço Maxtrack Gateway ao
servidor Skywave, é necessário que sejam realizadas as seguintes configurações:
1º. Acessar a área de downloads do site da Maxtrack: No site da Maxtrack, baixar as bibliotecas para
acesso e manipulação de dados enviados por satélite que são:
skywave_http_satellite_communication.so: usada para td50skywave_protocol.so ou
mtc550skywave_protocol.so.
skywave_rest_satellite_communication.so: usada para idp780skywave_protocol.so comunicação
com IDP-780.
2º. Adicionando as bibliotecas: Acessar o diretório onde está instalado o Maxtrack Gateway e localize a
pasta libs/satellite adicione os arquivos skywave_http_satellite_communication.so e/ou
skywave_rest_satellite_communication.so.
3º. Configurar o Maxtrack Gateway: na configuração do Maxtrack Gateway, adicionar os parâmetros
para conexão ao servidor Skywave referente a cada biblioteca.
Skywave http:
# Caminho da biblioteca
satellite_communication_library_path=libs/satellite/skywave_http_satellite
_communication.so
# url
skywave_http_url=http://versa1.skywave.com:5101/xml/dapi-xml1
#Intervalo de polling
skywave_http_polling_interval=10
#Identificador do usuário 1
skywave_http_access_id1=12345678
#Senha do usuário 1
skywave_http_password1=asdfghjk
# Tipo de módulo 1
skywave_http_module_type1=2
#Identificador do usuário 2
skywave_http_access_id2=87456321
#Senha do usuário 2
skywave_http_password2=kjhgfdsa
#Tipo de módulo 2
skywave_http_module_type2=1
28 www.maxtrack.com.br
Skywave rest:
# Caminho da biblioteca
satellite_communication_library_path=libs/satellite/skywave_rest_satellite
_communication.so
# url
skywave_rest_base_url=http://isatdatapro.skywave.com/GLGW/GWServices_v1/Re
stMessages.svc/
#Intervalo de polling
skywave_rest_polling_interval=10
#Identificador do usuário 1
skywave_rest_access_id1=12345678
#Senha do usuário 1
skywave_rest_password1=asdfghjk
Abaixo, segue a descrição da configuração para acesso e manipulação das posições enviadas por satélite.
Caminho para acesso à pasta libs localizada dentro do diretório onde o Maxtrack Gateway está
instalado:
satellite_communication_library_path=libs/protocol/ skywave_http_satellite_communication.so
Endereço do site de comunicação com a Skywave. (Skywave http server url )
skywave_url = http://versa1.skywave.com:5101/xml/dapi-xml1
Id para acesso ao servidor Skywave:
skywave_user_id =
Senha para acesso ao Control Station da Skywave. (Skywave http server user password )
skywave_password =
Importante: O usuário e a senha utilizados para acesso ao Control Station da Skywave são
disponibilizados pela Skywave para o usuário.
Intervalo de tempo em minutos em que o Maxtrack Gateway irá verificar se existem novas posições
enviadas pelo módulo
skywave_polling_interval = 10
29 www.maxtrack.com.br
Atenção: Se as bibliotecas não estiverem dentro da pasta libs/protocol e as linhas acima
forem inseridas, o Gateway poderá apresentar instabilidade. Isto também ocorrerá no caso
das bibliotecas estarem contidas dentro da pasta libs e o arquivo “mxt_gateway.conf” não
possuir as linhas referentes à interação satelital.
Fluxo de Fluxo de
dados dados
Internet
Firewall
Serviço
Fluxo de
dados
Gateway
e
x od
Flu ados
d
Servidor
Skywave
Fl
u
Satélites d a xo
do de
s
Veículos rastreados
por satélite
30 www.maxtrack.com.br
Gerenciamento do Maxtrack Gateway
Durante o processo de instalação e após a inicialização do Maxtrack Gateway, este pode estar sujeito a
travamentos e não gravação dos dados caso configurado de forma incorreta ou não tenha os arquivos
necessários para o tratamento das informações recebidas.
Para identificar as características de seu comportamento ao longo do tempo, o serviço Maxtrack Gateway
gera arquivos de log do sistema para possibilitar a identificação e tratamento dos erros. Esses arquivos são
identificados como mxt_data_processor.log, arquivo com o log do data_processor e mxt_gateway.log,
arquivo com o log do módulo gateway.
Neste tópico serão abordadas várias práticas de gerenciamento do Maxtrack Gateway, começando pela
correta forma de se interromper, iniciar e reiniciar os processos que compõe o Maxtrack Gateway, que
estão descritos na página 11.
Este processo se faz necessário em qualquer alteração de arquivos na estrutura da instalação ou ao se
modificar parâmetros de configuração dos módulos.
31 www.maxtrack.com.br
Configuração do diretório de arquivos de log
Os arquivos de log do Maxtrack Gateway registram as ações executadas por cada módulo do Maxtrack
Gateway. Por esse motivo, os arquivos de log podem ficar muito grandes conforme o número de
equipamentos conectados ao serviço, número de comandos enviados etc., o que tende a dificultar sua
leitura. É recomendável configurar o Maxtrack Gateway para gravar os logs em um diretório separado e de
forma que se gere um novo arquivo para cada dia de funcionamento. Essa configuração pode ser realizada
do seguinte modo:
1. Parar o serviço Maxtrack Gateway (Ver página Erro! Indicador não definido.).
2. Localizar o diretório onde o Maxtrack Gateway está instalado e criar uma nova pasta chamada logs.
3. Verificar na etapa de configuração do Maxtrack Gateway (Ver página 15) a opção log_file que
define de que forma serão gerados os logs, se por arquivos em uma pasta ou todas as informações
em um único arquivo.
4. Nesta opção, ao se definir um valor, o Maxtrack Gateway vai analisar se este valor existe, caso
exista, ele vai analisar se é um diretório ou arquivo, então, para se ter as informações geradas por
dia dentro de um diretório, deve-se primeiro criá-lo dentro da pasta de instalação do Maxtrack
Gateway.
Importante: Caso não se defina o valor desta opção, o Maxtrack Gateway não irá iniciar, pois
se trata de uma configuração essencial.
5. Após a configuração do diretório, você deve iniciar o serviço novamente (Ver pagina Erro! Indicador
não definido.).
6. Agora você deve verificar, dentro do diretório de instalação do Maxtrack Gateway,na pasta que
você definiu para armazenar os logs, a correta criação dos arquivos.
Após configurar o Maxtrack Gateway para gravar os arquivos de log separados por dias de funcionamento,
os nomes dos arquivos terão o seguinte formato ao serem gerados e alterados:
Data do dia em que foi gerado no formato aaaa-mês-dd_nome do módulo.log:
Exemplos:
2012-Nov-12_data_precessor.log
2012-Nov-12_gateway.log
32 www.maxtrack.com.br
Problemas de instalação
Os problemas de instalação do Maxtrack Gateway geralmente estão relacionados à indicação incorreta dos
diretórios de dados, seja para gravação pelo serviço (logs, XML e banco de dados), seja para o devido
funcionamento do serviço ao não especificar as bibliotecas de referência para gravação de dados
(handlers). Ao realizar a instalação do Maxtrack Gateway, uma estrutura de diretórios é criada como a
pasta de licença, pasta para gravação de arquivos XML etc. O padrão é que os diretórios sejam gerados na
mesma pasta onde o Gateway está instalado.
Dica: Para facilitar a gestão dos arquivos gerados pelo Maxtrack Gateway, é
recomendável que os diretórios de gravação dos arquivos de configuração, dados ou log
sejam armazenados na mesma pasta onde o Gateway é instalado.
33 www.maxtrack.com.br
Satellite Função Obrigatoriedade
skywave_rest_satellite_communication.so Buscar os dados satelitais no servidor Ao monitorar equipamentos usando a
Skywave com tecnologia REST+JSON. comunicação satelital.
skywave_http_satellite_communication.so Buscar os dados satelitais no servidor Ao monitorar equipamentos usando a
Skywave com tecnologia HTTP+XML. comunicação satelital.
Os módulos Gateway e Data Processor geram logs que indicam informações sobre seu funcionamento.
Através desses arquivos, podem-se identificar itens como: hora em que o equipamento conectou, possíveis
causas de desconexão, erro na inserção de dados no banco etc.
34 www.maxtrack.com.br
5. Quantidade de mensagens processadas por segundo entre uma gravação e outra das estatísticas do
log.
6. Número de comandos criados na sessão atualmente analisada do Data Processor.
7. Modalidade de gravação das informações trocadas com os equipamentos.
accweb: Apenas gravação no banco de dados;
xml: Apenas gravação dos arquivos XML;
accweb xml: Gravação no banco de dados e gravação de arquivos XML simultaneamente.
1. Descrição do tipo de mensagem processada pelo Handler, identificador do protocolo dessa posição
e ID do módulo cuja posição foi recebida;
2. Indicação de que a posição foi gravada no banco de dados.
3. Indicação de que foi gerado o arquivo XML referente a essa posição.
Indicação de erros.
1. Erro ao tentar gravar uma posição com o mesmo índice, ou seja, a mesma posição duas vezes.
Nesse caso, não se exige uma intervenção, pois ele apenas está indicando que uma posição não foi
gravada por motivo de duplicidade de informação.
1. Valor recebido maior que limite do campo na tabela onde essa informação será armazenada.
A comunicação com os equipamentos não é efetivada, pois o Gateway passa a derrubar as conexões ao
identificar que não existe o license.dat, nenhuma posição ou comando são processados pelo Data
processor. Assim, os contadores de mensagens e comandos ficam sempre iguais à zero.
Se o license.dat tiver sido atualizado com sucesso, essas informações serão atualizadas normalmente. Caso
apenas alguns equipamentos configurados para conectar ao servidor não estiverem presentes no arquivo
de licenças, as informações por eles enviadas não serão contabilizadas e não serão exibidas as informações
correspondentes às suas posições.
35 www.maxtrack.com.br
Log do módulo Gateway.
As primeiras linhas que são geradas após esse módulo ser iniciado mostram que protocolos foram
carregados e foram lidos os arquivos presentes nas pastas onde os arquivos de bibliotecas de referências
(Way points, Firmware).
A mensagem padrão é gravada pelo serviço conforme intervalo para gravação de estatísticas configurada
para esse módulo:
36 www.maxtrack.com.br
Conexão com equipamento.
Após a conexão de um equipamento, no log do Gateway, ela é descrita do seguinte modo:
37 www.maxtrack.com.br
6. Indicação de leitura dos dados enviados pelo módulo, ID do equipamento que tentou a conexão e
pacote de dados enviado pelo módulo. Neste caso, não é exibido o ID correto do equipamento, mas
um código de identificação aleatório.
7. Código do protocolo.
8. Indicação de tentativa de inserção de dados e pacote de dados enviados pelo módulo.
9. Tipo de mensagem recebida.
10. Indicação de que o módulo não está presente no license.dat (a mesma mensagem é exibida caso o
lincense.dat não esteja presente na pasta lock).
11. Início do processo de encerramento da conexão.
12. Detalhes do processo de encerramento da conexão.
13. Detalhes do processo de encerramento da conexão.
14. Detalhes do processo de encerramento da conexão.
15. Detalhes do processo de encerramento da conexão.
16. Detalhes do processo de encerramento da conexão.
17. Fim do processo de encerramento da conexão.
18. Inicio da indicação de cancelamento do tráfego do pacote enviado.
19. Justificativa do cancelamento.
20. Confirmação do cancelamento.
21. Inicio do processo de encerramento da conexão.
22. Detalhes do processo de encerramento da conexão.
23. Detalhes do processo de encerramento da conexão.
24. Fim do processo de encerramento da conexão.
25. Fim do processo de gerenciamento da conexão.
Atualização
Ao ser notificado que há atualizações do Maxtrack Gateway, é recomendável que seja realizado o upgrade
do serviço para ter acesso às novas funcionalidades que foram implementadas. Antes de iniciar o processo,
é necessário realizar um backup dos dados para que se evite a perda de informações.
Backup
Para realizar o backup dos arquivos correspondentes ao Maxtrack Gateway, deve-se parar o serviço do
mesmo (Ver pagina Erro! Indicador não definido.) e copiar a pasta onde está instalado para um diretório
de backup ou renomear o diretório.
Atenção: Esse backup preserva apenas informações como arquivo de licenças e biblioteca
de handlers. O backup dos dados enviados pelos módulos contidos no banco deverá ser
realizado através de uma ferramenta para back do seu gerenciador do banco de dados ou
via script sql.
38 www.maxtrack.com.br
Processo de atualização
Ao iniciar a atualização, a primeira etapa a ser executada é parar o serviço Maxtrack Gateway (Ver página
25).
Em seguida pode se executar os seguintes comandos:
Acessar a pasta onde se encontra a pasta do Maxtrack Gateway.
# cd /usr/local
Renomear a pasta onde está instalado o Maxtrack Gateway.
# mv Maxtrack_Gateway Maxtrack_Gateway_bkp
Após renomear a pasta, execute o instalador novamente e refaça os passos de instalação. Ver página Erro!
Indicador não definido..
Atualização do License.dat
Este arquivo contém a licença de utilização dos módulos para o Maxtrack Gateway que efetua a validação
de conexão no mesmo. A validação se dá através de verificação no arquivo license.dat, arquivo
criptografado que contêm IDs dos módulos adquiridos pelo cliente até aquele momento que acumula todos
os IDs de módulos já faturados para o cliente.
Procedimento para atualização do license.dat:
1. Parar o serviço Maxtrack Gateway (Ver página Erro! Indicador não definido.).
2. Localizar o diretório onde o Gateway está instalado, dentro deste, acessar o diretório license e colar
o novo arquivo license.dat sobrescrevendo o antigo.
3. Iniciar novamente o serviço Maxtrack Gateway (Ver página Erro! Indicador não definido.).
39 www.maxtrack.com.br