MASTERSAF SMART

ROTEIRO DE INSTALAÇÃO
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

SUMÁRIO

INTRODUÇÃO ................................................................................................................................................... 3
DOWNLOAD DA APLICAÇÃO DO SITE ............................................................................................................ 3
DESCOMPACTE O PACOTE DA APLICAÇÃO .................................................................................................. 3
LEITURA DO MANUAL DE REQUISITOS TÉCNICOS ...................................................................................... 3
CRIANDO AMBIENTE DE BANCO DE DADOS ................................................................................................ 3
SERVIDOR DE APLICAÇÃO ..............................................................................................................................4
EXECUÇÃO DO INSTALADOR..........................................................................................................................4
PRIMEIRO ACESSO A APLICAÇÃO ................................................................................................................ 10
CONFIGURAÇÃO DO ARQUIVO DE CONEXÃO ............................................................................................ 13
PREPARAÇÃO DO AMBIENTE................................................................................................................... 13
CRIAR UM ARQUIVO DE CONEXÃO ......................................................................................................... 13
ENTENDENDO A TAG .................................................................................................................................17
PARA ABRIR/EXIBIR AS CONFIGURAÇÕES DE UM ARQUIVO DE CONEXÃO .CNX .............................17
MONITOR MASTERSAF SMART - REINF ..................................................................................................... 20
INSTALAÇÃO ............................................................................................................................................. 20
TEMPO DE VERIFICAÇÃO .......................................................................................................................... 21
DESINSTALAÇÃO ....................................................................................................................................... 21
INFORMAÇÕES EXTRAS ................................................................................................................................22
PARAMETRIZAÇÃO – CONEXÃO BANCO DE DADOS ............................................................................22
ALTERAÇÃO DE MEMÓRIA ALOCADA - JVM ...........................................................................................23
SUPORTE TÉCNICO ........................................................................................................................................23

Versão: 13
Atualizado em: 20/03/2018
2
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

INTRODUÇÃO

O objetivo deste manual e orientar sobre os passos necessários para realizar a instalação do sistema.

DOWNLOAD DA APLICAÇÃO DO SITE

Acesse o Contact Center e realize o download da aplicação através do link:

Atualização de Versão/Patches – Mastersaf Smart > Instalação > Smart.

DESCOMPACTE O PACOTE DA APLICAÇÃO

Após realizar o download do pacote da aplicação “INS_Smart_VX.XX.zip”, faça a descompactação do

pacote do MASTERSAF SMART.

LEITURA DO MANUAL DE REQUISITOS TÉCNICOS

Recomenda-se a leitura do manual de Requisitos Técnicos que traz orientações importantes sobre a
configuração necessária para a perfeita utilização da aplicação.

CRIANDO AMBIENTE DE BANCO DE DADOS

Crie o ambiente de Banco de Dados, no SGBD de preferência da empresa (Consulte a THOMSON

REUTERS - MASTERSAF para saber quais os SGBDs que o MASTERSAF SMART tem portabilidade).

Devem ser criados:

Database ou TNS (Ex.: DBSmart, MSAFSmart)

User Name

Versão: 13
Atualizado em: 20/03/2018 3
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Password
O usuário criado deverá ter acesso “full” ao Database;

Crie na Guia “Sistema”, através do “Painel de Controle” do Windows, uma conexão ODBC 32bits, onde
deverão ser informados:

Nome do DSN (Ex.: Smart SQL Cliente, Smart Oracle Cliente)

Descrição (Repetir o nome do DSN) Servidor (ex.: BRSP01\SQLEXPRESS)
User Name com acesso ao Banco de Dados criado no passo 1
Password do Usuário
Database Name ou TNS

IMPORTANTE: No Windows 64 bits, para a criação da conexão ODBC, utilize o programa

ODBCAD32.EXE da pasta SYSWOW64.

SERVIDOR DE APLICAÇÃO

Defina o Servidor de Aplicação no qual deverá ser instalado o MASTERSAF SMART.

EXECUÇÃO DO INSTALADOR

Localize o arquivo “instala_kit.bat”, na pasta onde foi descompactado o pacote de instalação;

Para executá-lo, dê um duplo click no arquivo;

Leia as instruções que serão apresentadas na janela “leiame.txt”, conforme exemplo da tela abaixo:

Versão: 13
Atualizado em: 20/03/2018 4
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Feche a janela “leiame.txt”:

Realize os passos indicados no Arquivo de Instruções. Responda “Sim”, para “Continuar a Atualização
do Sistema”. Caso contrário responda “Não”, para suspender o processo:

Informe o caminho e o nome da pasta que armazenará o sistema MASTERSAF SMART. Esta pasta não
deve existir (Será criada pelo Instalador). Nome sugerido: Smart (ex.: c:\smart).

Versão: 13
Atualizado em: 20/03/2018 5
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Obs.: Recomendamos a utilização do driver “C”, pois herdará a permissão de rede do usuário na
máquina/servidor.

Recomendamos manter Nome do Diretório Dados, como “dados” (Nome sugerido pelo Instalador. Só
troque este nome, caso esteja criando uma base de dados adicional, quando sugerimos utilizar:
“dados_nomedabasededados”).

Clique no botão “OK”:

Na tela a seguir, preencha os dados sobre o Banco de Dados, conforme segue:

Fonte de Dados ODBC: Nome do DSN criado no passo 2 (ex.: Smart SQL EmpresaX)
Usuário do Banco (SGBD): Nome do usuário criado no passo 1 (ex.: smartadmin)
Senha do Banco (SGBD): Senha do usuário criado no passo 1.
Redigite a senha: Repita a senha para evitar erros de preenchimento.
Database: Nome do Database ou TNS criado no passo 1 (ex.: DBSmart)

Versão: 13
Atualizado em: 20/03/2018 6
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Assinale a opção correspondente na tela para o Banco e o Tipo de Data utilizado pelo respectivo Banco
de Dados. Se estiver utilizando Banco de Dados Oracle, informe o Tipo de Data “Oracle”.

Obs.: Também é possível parametrizar os Dados de Conexão com o Banco de Dados no arquivo
‘smart.inf’ da pasta SISTEMA. Para mais informações leia o tópico “INFORMAÇÕES EXTRAS” no final
deste manual.

Clique no botão ”OK” para prosseguir com a instalação ou no botão “Cancelar”, se desejar abortar a
instalação:

Versão: 13
Atualizado em: 20/03/2018 7
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Localize e informe o arquivo de licenciamento recebido quando da efetivação do contrato. Caso não o
tenha recebido entrar em contato com o Departamento de Contratos da Thomson Reuters -
MASTERSAF.

CIique no botão “OK” da próxima tela apresentada (Não marque e nem preencha qualquer campo):

Fique atento às diversas etapas do processo de instalação.

Versão: 13
Atualizado em: 20/03/2018 8
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Este processo demora alguns minutos e pode ser acompanhado através das imagens que serão
apresentadas, no canto superior direito, conforme detalhes das telas abaixo:

Versão: 13
Atualizado em: 20/03/2018 9
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Ao final desta etapa, o produto estará instalado. Clique em “OK” para sair da Instalação.
As instruções para acesso ao sistema devem ser solicitadas à MASTERSAF.

PRIMEIRO ACESSO A APLICAÇÃO

Os passos para o Primeiro Acesso ao Sistema podem ser realizados pelo Consultor credenciado ou pelo
Usuário Administrador do cliente:

1. Crie um atalho no “Desktop” para o programa “Smart.exe”, localizado na subpasta ‘Sistema’ do

MASTERSAF SMART;

2. Altere o ícone do atalho clicando sobre o mesmo com o botão direito e escolha “Propriedades”,
“Alterar Ícone”. Procure na subpasta ‘Sistema’ do Smart, o arquivo “icone_smart.ico”;

3. Utilize o programa “regsvr32” para registrar no Windows, as “DLLs” “crystl32.ocx” e

“XMD5.dll”, que se encontram na subpasta ‘Sistema’ do Smart. Se necessário, copie as “DLLs”
da pasta “sistema“ para a pasta “SYSTEM32” do Windows. Para o registro desta “DLL” é
necessário que o usuário da rede seja Administrador (controle total) da Máquina;
Obs.: Executar o prompt de comando como administrador para executar a instrução
acima.

Versão: 13
Atualizado em: 20/03/2018 10
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

4. Se o sistema estiver sendo acessado através de uma estação de trabalho, deve-se criar, na
estação de trabalho, a mesma “ODBC” indicada no tópico “CRIANDO AMBIENTE DE BANCO DE
DADOS”.

5. Se o Banco de Dados utilizado for “Oracle”, deve-se criar uma Variável de Ambiente (de Sistema)
do Windows, com o nome “NLS_LANG”, com o conteúdo definido no Banco Oracle para os
Parâmetros: NLS_TERRITORY, NLS_LANGUAGE e NLS_CHARACTERSET.
(Ex.: AMERICAN_AMERICA.WE8MSWIN1252).

6. Através do atalho criado, acesse o sistema MASTERSAF SMART, utilizando o usuário

administrador:

Obs.: No processo de instalação são criados usuários, conforme descrito abaixo:

Diretório: DADOS
Usuário: USUADMIN
Senha: USUADMIN
Usuário: SYSADMIN
Senha: (solicitar à MASTERSAF)

7. Por padrão, o Código da Empresa no SMART tem tamanho de 3 posições. Para os clientes que
desejarem, por alguma necessidade, utilizar a funcionalidade de parametrizar este campo para
o tamanho de 6 posições, é necessário acrescentar o parâmetro #EMPRESACOM6# no arquivo
SMART\SISTEMA\smart.inf. Este parâmetro altera o tamanho do campo Código da Empresa no

Versão: 13
Atualizado em: 20/03/2018 11
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

banco de dados de tamanho 3 para 6 dígitos em todas as tabelas que utilizam o código da
empresa.

Exemplo:

1) Acesse o diretório de instalação, na pasta SISTEMA e edite o arquivo “smart.inf”.

2) Inclua o Parâmetro #EMPRESACOM6# no arquivo e salve.

3) Altere o tamanho do campo Código da Empresa no banco de dados de tamanho 3 para

6 dígitos em todas as tabelas que utilizam o código da empresa, pois, além de colocar o
parâmetro #EMPRESACOM6#, é necessário realizar este procedimento. O parâmetro é
responsável por indicar a possibilidade de gravar com tamanho 6 nas tabelas.

Obs.: Procedimento automático quando executado o processo “verifica estrutura” no

menu Ferramentas. Necessário auxílio do TI do cliente ou consultor para executar os
scripts gerados no banco de dados.

Versão: 13
Atualizado em: 20/03/2018 12
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

CONFIGURAÇÃO DO ARQUIVO DE CONEXÃO

Este programa tem por objetivo criar um arquivo criptografado com a string de conexão.

PREPARAÇÃO DO AMBIENTE

Abrir o executável conexao.exe que se encontra em \SMART\SISTEMA\

Através desta tela é possível configurar os parâmetros e gerar a String de Conexão.

CRIAR UM ARQUIVO DE CONEXÃO

Clique no botão indicado abaixo.

Versão: 13
Atualizado em: 20/03/2018 13
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

A mensagem abaixo será apresentada apenas como lembrete para instrução.

Neste passo, deve ser definido o nome do arquivo e o diretório onde será armazenado.

ATENÇÃO: É obrigatório que seja extensão .CNX

A senha é de responsabilidade do Administrador do Sistema.

Versão: 13
Atualizado em: 20/03/2018 14
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Preencha as informações de conexão e clique no botão “Gerar String”.

Após a geração da String de Conexão, clique no botão “Testar Conexão”.

Versão: 13
Atualizado em: 20/03/2018 15
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Se os parâmetros informados estiverem corretos, a conexão estará estabelecida e será possível

prosseguir com a gravação do arquivo.

Clique no botão ‘Gravar’ para gerar o arquivo de conexão no local definido no início da configuração.

É permitido inserir um parâmetro adicional direto na String, se o Administrador desejar. Pois o Smart.exe
utiliza apenas o campo da String gerada para conexão com Banco de Dados.

Local em que foi gerado:

Após a configuração e a geração do Arquivo de Conexão, acesse o arquivo smart.inf localizado em

\SMART\SISTEMA.

Versão: 13
Atualizado em: 20/03/2018 16
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Inserir a tag #ARQUIVOCONEXAO#

ENTENDENDO A TAG

PARA ABRIR/EXIBIR AS CONFIGURAÇÕES DE UM ARQUIVO

DE CONEXÃO .CNX

Abra o executável conexao.exe em \SMART\SISTEMA.

Versão: 13
Atualizado em: 20/03/2018 17
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Localizar o arquivo .CNX existente e configurado.

Informe a senha para liberar o arquivo.

Em caso de perda desta senha, um novo arquivo .CNX deverá ser criado e configurado, seguindo o tópico
‘Criar um Arquivo de Conexão’.

Versão: 13
Atualizado em: 20/03/2018 18
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Arquivo liberado para configuração.

Antes de gravar, é necessário clicar em Gerar String.

É permitido inserir um parâmetro adicional direto na String, se o Administrador desejar. Pois o Smart.exe
utiliza apenas o campo da String gerada para conexão com Banco de Dados.

Versão: 13
Atualizado em: 20/03/2018 19
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

MONITOR MASTERSAF SMART - REINF

Os procedimentos descritos neste tópico tratam da instalação do Monitor Mastersaf SMART necessário
para a geração dos arquivos ‘XML’ de Eventos para o REINF. Sem este procedimento, os arquivos ‘XML’
não serão gerados.

ATENÇÃO: Para a correta execução dos procedimentos a seguir, é necessário possuir no mínimo, a
versão do Java JRE orientada no Manual de Requisitos Técnicos.

INSTALAÇÃO

Acesse a aplicação MASTERSAF SMART

Através do menu Ferramentas > Conexão Monitor Java, realize os seguintes passos:

Preencha a tela abaixo com os dados de conexão do seu banco de dados:

Acesse a pasta ‘Monitor’ localizada no caminho <Instalação do MASTERSAF SMART>\Java.

Dentro da pasta, execute o arquivo “installService.bat”.

Versão: 13
Atualizado em: 20/03/2018 20
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

Após o término da execução, acesse o SERVICES do Windows e, no serviço “Monitor MASTERSAF

SMART”, clique com o botão direito em propriedades e entre na aba “LOGON” para selecionar a opção
“Esta Conta”. Coloque um usuário que tenha permissão de administrador do servidor.
Inicie o serviço “Monitor MASTERSAF SMART”. Pronto, o serviço está instalado.

Obs. 1: Em caso de algum erro ao iniciar o serviço do Monitor MASTERSAF SMART, verifique o
arquivo de log dentro da pasta Dados/log do MASTERSAF SMART.

Obs. 2: Para instalação do monitor em ambiente SQL Server, a porta deve estar configurada
corretamente e estar com o IP habilitado para acessos externos.

TEMPO DE VERIFICAÇÃO

Por padrão, o Monitor MASTERSAF SMART verifica, de tempos em tempos, a necessidade de iniciar um
processo a cada 90 segundos.

Caso queira alterar o tempo de verificação, abra o arquivo “gfa.properties” na pasta ‘Java’ da instalação
do MASTERSAF SMART e altere a propriedade “reinf.monitor.timer”, colocando o tempo em segundos.

ATENÇÃO: Não recomendamos a existência de mais de “um” monitor para a mesma base de
dados.

DESINSTALAÇÃO

Para desinstalar o Monitor Mastersaf SMART:

Acesse a pasta: <Instalação do MASTERSAF SMART>\Java\Monitor e execute o arquivo

“uninstallService.bat”.

Versão: 13
Atualizado em: 20/03/2018 21
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

INFORMAÇÕES EXTRAS

PARAMETRIZAÇÃO – CONEXÃO BANCO DE DADOS

É possível parametrizar os Dados de Conexão com o Banco de Dados no arquivo ‘smart.inf’ da pasta
SISTEMA da seguinte forma:

BANCO DE DADOS SQL

#STRINGCONEXAO#DADOS#DRIVER=SQL Server Native Client

11.0;SERVER=server;UID=user;PWD=pass;DATABASE=base;

DADOS: Nome da pasta raíz que contém as informações da ‘Dados’.

server: Nome ou IP do servidor do Banco de Dados.
user: Usuário de acesso ao Banco de Dados.
pass: Senha de acesso ao Banco de Dados.

BANCO DE DADOS ORACLE

#STRINGCONEXAO#DADOS#Driver={Oracle in
OraClient11g_home1};Dbq=tnsnames;Uid=user;Pwd=pass;

DADOS: Nome da pasta raíz que contém as informações da ‘Dados’.

OraClient11g_home1: Versão do Client Oracle instalado.
tnsnames: Nome parametrizado no arquivo TNSNAMES.ora.
user: Usuário de acesso ao Banco de Dados.
pass: Senha de acesso ao Banco de Dados.

Caso este parâmetro seja utilizado, o Sistema não irá considerar os Dados de Conexão informados nos
arquivos da ‘Dados’.

Versão: 13
Atualizado em: 20/03/2018 22
MASTERSAF SMART ROTEIRO DE INSTALAÇÃO

ALTERAÇÃO DE MEMÓRIA ALOCADA - JVM

É possível alterar o mínimo de memória alocada para a Máquina Virtual do Java (JVM) na inicialização do
serviço.

O valor padrão disponibilizado na instalação é de 256 Mb. Esse valor pode afetar o tempo de
inicialização e processamento da aplicação, tal como do sistema operacional onde está configurado.

Caso seja necessário realizar a alteração, favor editar o arquivo “wrapper.conf” localizado dentro do
diretório <JAVA> da aplicação, alterando a seguinte propriedade:

wrapper.java.initmemory=256

O valor “256” pode ser alterado, conforme a necessidade.

SUPORTE TÉCNICO

Para dúvidas ou problemas, abra um chamado no Contact Center ou entre em contato com nossa equipe
de Suporte Técnico pelo Telefone:

 (11) 2159-0600 opção 1 (Atendimento das Soluções Fiscais).

Nosso horário de atendimento é de segunda à sexta-feira de 9h as 18h.

Versão: 13
Atualizado em: 20/03/2018 23