IHX Sistemas - Orientações Técnicas para Instalações Locais

Considerações Iniciais
O objetivo deste documento é fornecer orientações à equipe técnica, de nossos canais
de comercialização, sobre as principais características técnicas das soluções IHX
Sistemas.
Através desse documento será possível obter informações sobre os processos de
instalação, backup e restauração de soluções IHX Sistemas implantadas.
Necessário prévio conhecimento de informática para melhor aproveitamento das
informações e orientações contidas neste material.

Pacotes de Instalação
As soluções IHX Sistemas, por padrão, são fornecidas com PACOTES de instalação
disponibilizadas para download e instalação em ambiente Windows.
São dois pacotes
IHX FrameWork
IHX Aplicação (Solução adquirida).

Esses pacotes estão vinculados ao número do Pedido realizado à IHX Sistemas.

Não insista em instalação de pacotes novos com versões de
banco de dados antigos, as atualizações dos pacotes são
constantes e automáticas.

Sugerimos e orientamos a nossos canais que mantenham cópia dos referidos pacotes
disponibilizados, bem como do número do Pedido e serial da licença.
Essas informações são imprescindíveis para a correta
realização de possível restauração de instalação e registro.

Após estas orientações sua equipe técnica será capaz de realizar os seguintes
processos:
 Processos de instalação completa.
 Processo de backups
 Processos de restauração.

Para instalações em ambiente Linux são necessários estudos de viabilidade e

compatibilidade e este procedimento deverá ser obrigatoriamente executado por
integrantes da Equipe IHX Sistemas.

P ágina |1
1. Arquitetura - Soluções IHX Sistemas
Antes de iniciarmos os procedimentos de instalação é necessário ressaltar as
características das soluções IHX Sistemas.
As soluções IHX Sistemas possuem sua estrutura baseada em arquitetura projetos.
Esta arquitetura foi projetada para atender diversos segmentos de negócio, nesse
sentido o sistema foi divido em camadas independentes que interagem o que
possibilita o funcionamento robusto e seguro de suas regras.

A IHX Sistemas fornece soluções WEB projetadas para que possam ser acessíveis a
partir de uma ampla variedade de plataformas, tais como tablets, smartphones, PCs e
Tvs.
As Soluções IHX Sistemas são executadas na maioria dos aplicativos browser
(navegadores) dos principais sistemas operacionais do mercado, tais como Windows,
Mac OS X, Android, Linux, eliminando assim necessidade de instalações locais.
Iremos abordar cada uma destas camadas posteriormente.
Iniciaremos, agora, com o processo de instalação das soluções IHX Sistemas.

P ágina |2
 2. Instalação das Soluções IHX Sistemas
Antes de iniciar o processo de instalação, por favor, leia o documento:
IHX Sistemas – Requisitos Técnicos.

Check-List (Certifique-se que) :

 Li e conheço os requisitos do documento IHX Sistemas – Requisitos Técnicos;

Para o computador escolhido (servidor):
 Possui os requisitos de Sistema Operacional (versão é compatível, a versão
Windows XP não é homologada);
 Possui os requisitos de Hardware (equipamento é compatível);
 É uma máquina real física (Ex: VirtualBox, VMWare não são homologados);
 Está configurado com um IP fixo na Rede;
 O usuário do sistema operacional do Windows é o Administrador do Sistema ou
possui privilégios de Administrador de Sistema;
 Existe conexão com a Internet para realizar o registro de seu Projeto online.
Para cada equipamento de Controle de Acesso do Projeto
 Está configurado com um IP fixo na Rede;
 Está configurado na PORTA de comunicação de Rede correta;
 Comunica com a aplicação do fabricante de configuração e testes do Equipamento;
Utilizando aplicação do fabricante de configuração garanta para cada equipamento
 Validadores de acesso (teclado, leitor de proximidade, biometria) estão habilitados
e testados;
 Sentido de giro está correto
 Configurações extras e necessárias foram feitas.
Para o servidor e gerenciamento de REDE
 Todos os IPs e Portas previamente definidas estão nas exceções de aplicações
Firewall, Antivírus, etc;
Organização
 Preencha uma planilha de Mapeamento da Planta de Equipamentos
 Identifique fisicamente o equipamento com esta informação.

Segue modelo de planilha para Mapeamento da Planta de Equipamentos.

SETOR ACESSO FABRICANTE NUMERO IP PORTA IP SERVIDOR IP SERVIDOR

EQUIPAMENTO EQUIPAMENTO EQUIPAMENTO EQUIPAMENTO EQUIPAMENTO COMUNICAÇÃO BANCO DE DADOS
Portaria IHX 01 192.168.10.101 1011 192.168.10.10 192.168.10.11
Portaria IHX 02 192.168.10.102 1012 192.168.10.10 192.168.10.11
1o Andar IHX 03 192.168.10.103 1013 192.168.10.10 192.168.10.11
Refeitório IHX 04 192.168.10.104 1014 192.168.10.10 192.168.10.11

P ágina |3
 Cada equipamento obrigatoriamente terá que estar configurado com:

 Setor de Acesso
o Consulte o tópico Referencias Sobre Setores de Acesso
 IP fixo e único
o O IP não poderá ser repetido.
 Porta única
o A porta não poderá ser repetida para o mesmo Servidor
 Servidor de Comunicação.
 Número do equipamento
o Consulte o tópico Referencias sobre Equipamento e Fabricantes para
identificar a necessidade alteração do número do equipamento.
o Alguns fabricantes não usam esta terminologia.

Sugerimos fortemente a adoção desse check-list para nortear, organizar e otimizar o

tempo de implantação de seu Projeto .
Seguindo estas orientações, sua equipe estará mitigando em 99% riscos de questões
envolvendo o processo de instalação das soluções IHX Sistemas e reduzindo o tempo
de implantação.

2.1. Iniciando a instalação de seu Projeto

Orientações contidas neste processo são para instalações em ambiente Windows
homologado.

Check-List (Certifique-se que) :

 O usuário do sistema operacional do Windows seja o Administrador do Sistema ou
possua privilégios de Administrador de Sistema.
 O servidor NÃO contenha serviços da IHX Sistemas em execução ou algum serviço
do MySQL em execução.
Essa verificação deverá ser realizada através do Gerenciador de Serviços do
Windows.

P ágina |4
 Caso exista algum serviço IHX Sistemas em execução, utilize as orientações do
tópico Desinstalando a Solução IHX Sistemas, antes de prosseguir.

Caso exista algum serviço do MySQL solicite informações sobre o usuário ROOT
ao Administrador de Sistema.

De posse dos pacotes de instalação e do número do pedido faça:

1. Realize a cópia dos pacotes de instalação
Essas informações são imprescindíveis para a correta realização de possível
restauração de instalação e registro.

2. IHX FrameWork
Execute o pacote de instalação.
Este processo é automatizado e irá instalar os seguintes recursos.
Serviço de banco de dados MySQL.
Serviço do Framework IHX Sistemas
Variáveis de ambientes

Em alguns casos será necessário reiniciar o computador, visto a necessidade de

atualização de alguns pacotes .Net Framework da Microsoft.

3. IHX Aplicação (Solução adquirida).

Execute o pacote de instalação.
Este processo é automatizado e irá instalar a solução adquirida.

Após a instalação os seguintes ícones serão criados em sua área de trabalho.

2.2. Registrando seu Projeto

P ágina |5
 A primeira execução do IHX Comunicador irá processar o registro ONLINE de seu
Projeto
É necessário conexão com a Internet para realizar o
registro.

Informe o Número do Pedido e o Número Serial informado.

Sugerimos e orientamos a nossos canais a armazenar estas informações junto com

os pacotes de instalação.

Estando tudo corretamente configurado o seu registro será efetuado com sucesso
e seu projeto está pronto para ser configurado e executado.

Próximas etapas serão:

 Configurando Setores de Acesso
 Configurando Equipamentos

2.3. Configurando seu Projeto

Nesta etapa é fundamental estarmos de posse da planilha para Mapeamento da Planta
de Equipamentos.
Esta planilha irá nortear, organizar e otimizar o tempo de implantação de seu Projeto .

SETOR INSTALAÇÃO FABRICANTE NUMERO IP PORTA IP SERVIDOR IP SERVIDOR

EQUIPAMENTO EQUIPAMENTO EQUIPAMENTO EQUIPAMENTO EQUIPAMENTO COMUNICAÇÃO BANCO DE DADOS

1o Andar IHX 01 192.168.10.100 9999 192.168.10.10 192.168.10.10

2.3.1. Acessando a Camada de Aplicação (site da solução IHX Sistemas)

Seremos um pouco objetivos nesta etapa, não é objetivo deste documento evoluir
sobre a usabilidade da solução e sim sobre questões técnicas, para obter mais

P ágina |6
 detalhes sobre regras, por favor, utilize o Manual do Usuário e ou acesse os Vídeos
postados em nossos canais.

Para iniciar basta clicar no atalho IHX Acesso, localizado em sua Área
de trabalho.
O usuário padrão de acesso:
Usuário ihx
Senha acesso

2.3.2. Configurando Setores de Acesso

Acesse o módulo de Setores dentro do Grupo Empresa.
Crie TODOS os setores definidos na planilha para
Mapeamento da Planta de Equipamentos.

Dica: Clique no para cadastrar rapidamente.

Aproveite e defina as regras de cada setor de acordo com
as características de seu projeto.

2.3.3. Configurando Equipamentos

Acesse o módulo de Equipamentos dentro do Grupo
Equipamentos.
Crie TODOS os equipamentos definidos na planilha para
Mapeamento da Planta de Equipamentos.

O uso do Mapeamento da Planta de Equipamentos torna este processo simples, visto

que todas as informações necessárias para cadastrar os equipamentos já estão
previamente definidas.

P ágina |7
Dica: Utilize a opção Salvar e adicionar outro para inclusão de muitos equipamentos.

P ágina |8
3. Camada de aplicação
Responsável pelo site IHX e suas regras de gestão de acesso focado em processo
tomada de decisões ágeis e eficazes das soluções IHX.
Essa camada foi desenvolvida em plataforma web e integra funcionalidades de gestão
de acesso, controle de equipamentos, rastreamento, gestão e autenticação de
identidade, reduzindo o esforço e assegurando o gerenciamento ágil e eficaz para
tomada de decisões.
São executadas na maioria dos aplicativos browser (navegadores) dos principais
sistemas operacionais do mercado.
Sugerimos, preferencialmente, a utilização dos navegadores o Chrome e ou FireFox.

3.1. Entendendo o funcionamento

Como acesso um SITE sem ter serviços IIS ou Apache instalados?
A IHX desenvolveu um serviço que permite publicar sua aplicação em máquinas locais,
sobre este serviço iremos explicar abaixo.
3.1.1. IHX Services
O IHX Service é o serviço responsável por publicar a solução IHX para que esta
seja acessível através de outros dispositivos que executem aplicativos browser
(navegadores).

Acesse o Gerenciador de Serviços do Windows

Procure por: Serviços, Gerenciador de Serviços ou Services.msc

P ágina |9
 No Gerenciador de Serviços do Windows procure pelos seguintes
serviços
 IHX Service

O IHX Service obrigatoriamente deve estar em execução para que a solução IHX
seja acessível através de browser.

3.2. Como acessar a aplicação do servidor

Para acessa a aplicação do servidor basta colocar no endereço do browser o IP e porta
da aplicação.

Para acessar a aplicação de qualquer outro computador, tablet ou smartphone de

sua rede basta informar o IP do Servidor e porta .

3.3. Dúvidas frequentes ao acessar a aplicação IHX

P á g i n a | 10
 3.3.1. Não consigo acessar aplicação IHX no Servidor
Na maioria dos casos as razões relacionadas à exibição da aplicação IHX no
servidor estão relacionadas as seguintes causas:
1. Bloqueio de Firewall
2. O Serviço responsável pelo IHX Service foi interrompido ou não foi
corretamente inicializado.
Para as questões de Firewall é necessário rever os requisitos do sistema.
Para a questão relacionada ao IHX Service, por favor, realize os seguintes
procedimentos, sempre com testes antes de passar para o próximo:
 Verificar se o serviço do IHX Service está em execução.
 Reinicializar o serviço IHX Service

Em alguns casos pode ocorrer de o serviço responsável pelo banco de dados

do MySQL não inicializar de forma "rápida" e o IHX Service sim.

Caso este evento ocorra com frequência iremos executar o seguinte comando
de dependência entre os serviços instalados pela IHX.

a. Acesse o prompt de comando como Administrador do Sistema

Windows CMD + botão direito do mouse – Opção Administrador
b. Execute
sc config srvIHXService depend= mysql_ihx

c. Verifique se a mensagem foi de sucesso

3.4. Aplicação - Procedimento de BACKUP

O objetivo de explicações desta etapa será somente para os casos de cópia de
segurança (backup) de projetos customizados e das imagens das pessoas capturadas
nos cadastros.

3.4.1. – Imagens da Aplicação

As soluções IHX Sistemas armazenam as imagens capturadas, de seus cadastros, em
arquivos físicos em uma pasta do servidor onde foi instalado.
Essas imagens são vinculadas aos respectivos registros do banco de dados e exibidas
nas interfaces da aplicação.
Para realizar o backup destas imagens é necessário realizar a cópia COMPLETA da
seguinte pasta de arquivos.

Caminho
C:\IHX_Sistemas\<IHX_SOLUÇÃO ADQUIRIDA>\app\media

3.4.2. Aplicações Customizadas

P á g i n a | 11
Algumas soluções IHX Sistemas podem ser fornecidas de forma customizada e
neste caso será necessário realizar cópia completa dos arquivos HTMLs ou Scripts
que são utilizados para nesses projetos.
Será necessário realizar cópia de backup das seguintes pastas de sistema
Caminho
C:\IHX_Sistemas\<IHX_SOLUÇÃO ADQUIRIDA>\

C:\ Python27\

C:\IHX_Sistemas\<IHX_SOLUÇÃO ADQUIRIDA>\app\media"

P á g i n a | 12
4. Camada de banco de dados
As soluções IHX Sistemas, por padrão, utilizam o seguinte banco de dados.
MYSQL
Versão 5.6
Nossas orientações serão sobre esta base de dados, caso seu projeto utilize
outra base, por favor, nos comunique para maiores esclarecimento.

A instalação e configuração do banco de dados é realizada através da ferramenta de

Instalação IHX FrameWork.
O acesso à base de dados da solução IHX Sistemas poderá ser realizado através de uma
ferramenta de administração de banco de dados.
É importante ressaltar as seguintes clausulas que permeiam acessos a base de dados
de nossas soluções

É VEDADO AO LICENCIADO:

Cláusula 2ª: Copiar, modificar e transmitir o SOFTWARE por qualquer meio de

telecomunicações existentes ou que venha a ser criado, bem como deixá-lo
disponível em qualquer tipo de serviço "on-line", sem devida autorização
da LICENCIANTE;

Parágrafo Único: Todo o conteúdo do SOFTWARE (Site, Sistema, Estrutura

de Banco de Dados) é de propriedade da LICENCIANTE e dotado de direitos
autorais, ficando claro que qualquer cópia com finalidade comercial ou
não, será punida pelas leis de direitos autorais em vigor;

Cláusula 3ª: Desmontar, descompilar, traduzir, tentar de qualquer modo

descobrir código-fonte, criar trabalhos derivados ou realizar qualquer
forma de engenharia reversa neste SOFTWARE;

Cláusula 4ª: Alterar, manipular, inserir, ao qualquer outra ação derivada que
interfira na estrutura e informações contidas no Banco de Dados;

4.1. Ferramenta de Administração do MySQL

A IHX disponibiliza a instalação da ferramenta SQLYog em sua pasta de
instalação: Instalações Complementares

Caminho
C:\IHX_Sistemas\Instalacoes Complementares\SQLyog"

Executar como adminstrador

SQLyog-11.1.2-0.x86Community.exe

P á g i n a | 13
4.2. Conectar com o Banco de Dados
Acesse a ferramenta SQLYog e crie uma conexão com a base dados informando
Servidor, usuário e senha.

Padrão de instalação da IHX

Servidor: localhost
Usuário: root
Senha: 9TOn67p0mwk5ANzG

4.3. Banco de Dados - Procedimento de BACKUP

4.3.1. Realizando o backup do Banco de Dados

Acesse a ferramenta SQLYog e realize a conexão com o banco de dados.
Selecione o banco da solução IHX instalada.
Clique com botão direito do mouse ou utilize Menu Database
Escolha a opção Backup/Export – Backup Database as SQL Dump

A seguinte interface deverá aparecer

P á g i n a | 14
 Execute o Check-list abaixo.
Check-List (Certifique-se que) :

 A opção Struture And Data esteja selecionada

Garanta que esteja selecionado, do contrário seu backup será somente de
registros ou somente da estrutura.
 Em Export to file esteja configurado o arquivo e pasta de destino do corretos.
Utilizamos como conceito de nomenclatura de Backup o seguinte
critério:
AAAAMMDD_HHMM.SQL
Onde AAAA representa o ano, MM representa o mês, DD
representa o dia, HH representa a hora e MM os minutos.
Exemplo: 20161223_1230.SQL
Isto evita sobreposição de arquivos e ajuda a identificar
quando o registro foi realizado

 TODAS as opções da caixa Options to Written File estejam selecionadas

Garanta que estejam todos selecionados.
 Clique em EXPORT
 Aguarde o processo ser concluído.

Dicas
 Copie e mantenha uma cópia do arquivo gerado para um local seguro.
 Crie rotinas para que este processo seja realizado com frequência.
 Armazene a cópia em discos diferentes.
 Armazene a cópia em outro computador.

Riscos deste processo

Não seguir corretamente as orientações implicará em criação de arquivos que
podem não ser úteis para sua recuperação.

P á g i n a | 15
 4.3.2. Restaurar o Backup do Banco de Dados
O processo é semelhante ao anterior.
Acesse a ferramenta SQLYog e realize a conexão com o banco de dados.
Selecione o banco da solução IHX instalada.
Clique com botão direito do mouse ou utilize Menu Database
Escolha a opção Import – Execute SQL Script...

Riscos deste processo

Tenha certeza que o arquivo de backup é o correto.
Esta operação NÃO PODERÁ ser desfeita.

P á g i n a | 16
5. Desinstalar a Solução IHX Sistemas
Riscos deste processo
Perda de informação.

Sugerimos como processo de desinstalação a seguinte sequência de ações.

5.1. Utilize os pacotes de desinstalação.

Esses pacotes estão disponíveis no seguinte caminho.
Caminho
C:\IHX_Sistemas\

Execute na seguinte sequencia os seguintes pacotes:

unins000.exe
Responsável pelo pacote IHX FrameWork

unins001.exe
Responsável pelo pacote IHX Site

unins002.exe
Responsável pelo pacote IHX Finger Capture
Nos casos onde houve instalação

5.2. Remova os Serviços IHX Sistemas

Alguns serviços da IHX Sistemas, que estão em execução, deverão ser removidos da
seguinte forma.

5.2.1. Acesse o Gerenciador de Serviços do Windows

Procure por: Serviços, Gerenciador de Serviços ou Services.msc

No Gerenciador de Serviços do Windows procure pelos seguintes serviços

 IHX Service
 IHX Finger Capture
 Mysql_IHX

P á g i n a | 17
5.2.2. Remova o IHX Service
d. PARE o Serviço
e. Acesse o prompt de comando como Administrador do Sistema
Windows CMD + botão direito do mouse – Opção Administrador
f. Execute
sc delete srvIHXService

g. Verifique se a mensagem foi de remoção com sucesso

5.2.3. Remova o IHX Finger Capture

a. PARE o Serviço
b. Acesse o prompt de comando como Administrador do Sistema
Windows CMD + botão direito do mouse – Opção Administrador
c. Execute
sc delete srvIHXFingerCapture
d. Verifique se a mensagem foi de remoção com sucesso

5.2.4. Remova o Mysql_IHX

a. PARE o Serviço
b. Acesse o prompt de comando como Administrador do Sistema
Windows CMD + botão direito do mouse – Opção Administrador
c. Execute
sc delete mysql_ihx
d. Verifique se a mensagem foi de remoção com sucesso

P á g i n a | 18
6. Restauração da Solução IHX Sistemas
6.1. Solução IHX Sistemas
Conforme orientação inicial e de posse dos seguintes pacotes, o processo de
restauração poderá ser realizado.
Esteja preparado com
 IHX FrameWork
 IHX Aplicação
 Backup do Banco de Dados
 Número do Pedido realizado à IHX Sistemas
 Número Serial fornecido pela IHX Sistemas
 Conexão com Internet para o novo registro.
Possui customizações:
 Backup dos Arquivos de Imagens
 Backup de Customizações

6.2. Desinstalar a Solução IHX Sistema

O primeiro passo é garantir que todos os recursos foram corretamente desinstalados.
Para isto, utilize as orientações do tópico Desinstalando a Solução IHX Sistemas.

6.3. Instalando a Solução IHX Sistema

O próximo passo será realizar o processo de instalação.
Caso exista alguma dúvida sobre este processo, por favor, utilize as orientações do
tópico Iniciando a instalação.

P á g i n a | 19
7. Outras Informações
7.1. Referencias Sobre Setores de Acesso
Setores são áreas de acesso onde serão efetuadas as regras de acessos de seu projeto.
Um setor pode ser composto por um ou mais equipamentos de controle de acesso,
tais como catracas, totens, controladores de porta entre outros.

As soluções IHX Sistemas proporcionam definições de Setores de Acesso com

arquitetura de até três níveis em planta baixa: Empresa, Estrutura e Setor.

7.2. Conceito de Setor

O seu Projeto de acesso necessitará representar diversas áreas de acesso de uma
determinada Empresa, cada área de acesso será definida na solução IHX Sistemas
como sendo um SETOR DE ACESSO, conforme imagem abaixo.

Na arquitetura desta planta, na solução IHX Sistemas, o Projeto será composto de 1

Empresa, 1 Estrutura (Prédio) e aproximadamente 20 setores.

7.3. Conceito de Estrutura

O seu Projeto de acesso necessitará representar diversas áreas de acesso de uma
determinada Empresa, porém em 2 Prédios distintos, cada área de acesso será
definida na solução IHX Sistemas como sendo um setor de acesso, conforme imagem.

Bloco A Bloco B

P á g i n a | 20
 Entra aqui o conceito de ESTRUTURA, ou seja, os setores podem ter o MESMO NOME,
porém estarão em estruturas diferentes e, inclusive, com regras diferentes.
Na arquitetura desta planta, na solução IHX Sistemas, o Projeto será composto de 1
Empresa, 2 Estruturas (Blocos) e aproximadamente 40 setores.

7.4. Conceito de Empresa

O seu Projeto de acesso necessitará representar duas ou mais Empresas (Ex.: Rede de
Academia, Rede de Empresas ), em pontos distintos conforme o exemplo na imagem
abaixo, ou empresas distintas dentro da na mesma planta.

Na arquitetura desta planta, na solução IHX Sistemas, o Projeto será composto de 3

Empresa, Estruturas (Prédios) e Setores de acordo com os conceitos anteriores.

P á g i n a | 21