Resumo
Esse artigo contém os passos para instalar o Totall Middleware.
Dependendo do papel que o Middleware irá desempenhar, os passos de instalação podem variar.
Para entender os papéis do Middleware, leia o artigo Arquitetura do Totall Middleware.
Instalação do PostgreSQL
- Papéis: Middleware Filial e Matriz
1. Baixe a última versão estável do PostgreSQL disponibilizada pela EnterpriseDB. Escolha a versão de acordo com o processador do sistema operacional.
Testes foram realizados com:
- Versão mínima: 9.4
- Versão máxima: 9.5
Baixe o instalador somente de sites confiáveis:
- http://www.postgresql.org/download/windows/
- http://www.enterprisedb.com/products-services-training/pgdownload#windows
2. Execute o instalador sem alterar nada as configurações.
Apenas será necessário informar a senha do usuário postgres.
Utilize "ttq1w2e3".
3. No final do instalador, ele perguntará sobre abrir o StackBuilder. Não é necessário porque não será necessário fazer nenhuma configuração nesse PostgreSQL.
4. Garanta que o serviço do PostgreSQL esteja inicializado e marcado para inicializar automaticamente.
Criação do Banco do Middleware
- Papéis: Middleware Filial e Matriz
1. Abra o PGAdmin3 que foi instalado juntamente com o PostgreSQL.
2. Crie uma nova conexão para o usuário postgres no PostgreSQL local.
3. Acesse o database postgres.
4. Execute os seguintes comandos, um de cada vez.
CREATE USER "guarda" PASSWORD '112233' CREATEUSER CREATEDB; ALTER USER "guarda" SET SEARCH_PATH="guarda" ,PUBLIC, PG_CATALOG; CREATE DATABASE "guarda" WITH OWNER = "guarda" ENCODING = 'LATIN1' TABLESPACE = pg_default LC_COLLATE = 'C' LC_CTYPE = 'C' CONNECTION LIMIT = -1 TEMPLATE = template0;
5. Crie uma nova conexão para o usuário guarda no PostgreSQL local.
6. Conecte com o usuário guarda. Muito importante!
7. Aplique o script para criação da estrutura inicial.
criacao_estrutura_middleware.sql
8. Verifique se as tabelas foram criadas no database correto.
Criar Diretório do Middleware
- Papéis: Middleware Local, Filial e Matriz.
A instalação do Middleware segue o padrão de instalação do Totall Commerce. Criamos uma pasta TotallMiddleware na mesma unidade que existe a pasta TotallC. Não é recomendado instalar o Middleware na mesma pasta do Totall Commerce porque o Middleware possui muitas pastas e arquivos.
1. Criar pasta TotallMiddleware.
Padrão: C:\TotallMiddleware\
2. Descompactar o conteúdo da pasta arquivos que vem dentro do pacote Middleware_arquivos na pasta recém criada.
3. Descompactar o conteúdo do pacote TotallMiddlewareService nessa mesma pasta.
4. Descompactar o conteúdo do pacote WSMiddleware nessa mesma pasta.
5. Caso se tratar de Middleware Filial ou Matriz (emissão de NFC-e), criar os diretórios "certificado" e "xmls_retorno" na pasta recém criada.
Implantar Serviço para Middleware Local
- Papéis: Middleware Local.
1. Abra um CMD.exe com permissão de administrador.
2. Acesse o diretório de instalação do Middleware.
C:\Windows\system32>cd c:\TotallMiddleware
3. Instale o executável TotallMiddlewareService.exe como um serviço conforme exemplo abaixo.
c:\TotallMiddleware>TotallMiddlewareService.exe /install
4. Aguarda até que apareça a mensagem instalado com sucesso.
5. Acesse o gerenciador de serviços do Windows [services.msc] e configure para que o serviço "Totall Middleware Servidor Web" seja inicializado automaticamente ao reiniciar o Windows.
6. Inicialize o serviço.
Implantar Serviço para Middleware Filial e Matriz
- Papéis: Middleware Filial e Matriz.
1. Abra um CMD.exe com permissão de administrador.
2. Acesse o diretório de instalação do Middleware.
C:\Windows\system32>cd c:\TotallMiddleware
3. Instale o executável TotallMiddlewareService.exe como um serviço conforme exemplo abaixo.
c:\TotallMiddleware>TotallMiddlewareService.exe /install
4. Aguarda até que apareça a mensagem instalado com sucesso.
5. Atualize o banco local. Para isso, chamar o executável do serviço com o parâmetro UPGRADE.
C:\TotallMiddleware\TotallMiddlewareService.exe UPGRADE
6. Acesse o gerenciador de serviços do Windows [services.msc] e configure para que o serviço "Totall Middleware Servidor Web" seja inicializado automaticamente ao reiniciar o Windows.
Caso o Middleware utilize banco de dados local, utilize a opção Automático (Atraso na Inicialização) para que seja inicializado depois do PostgreSQL.
7. Inicialize o serviço.
Configurar Middleware
- Papéis: Middleware Filial e Matriz.
Abrir WSMiddleware e efetuar as configurações de acordo com as funcionalidades que serão utilizadas.
Leia mais em Configurações do Totall Middleware.
1. Informe a conexão com o banco de dados do Middleware.
2. Reinicie o serviço para fazer valer as modificações nas configurações.
Verificação
Pelo navegador, acesse o Totall Middleware para verificar se o serviço está funcionando.
- Middleware Local: http://localhost:8083
- Middleware Filial/Matriz: http://localhost:8080
Pronto, com esses passos a instalação terá sido realizada com sucesso!