Ferramentas - Perguntas Comuns

→ Como funciona o Instalador do Uniplus Desktop?

Como instalar

Para instalar o sistema, solicite o instalador para o Suporte da Intelidata ou faça o download dele a partir da Central de Ajuda do portal de atendimento.

Instalação

1 - Execute o instalador e clique em [Avançar].

• Execute como administrador para evitar bloqueios na instalação.

2 - Leia os termos de uso e clique em [Avançar]:

3 - Selecione o produto e clique em [Avançar]:

• Vale notar que, posteriormente, somente será possível ativar o sistema com a licença correspondente ao produto.

4 - Escolha se deseja instalar apenas o Retaguarda, somente o PDV ou ambos e clique em [Avançar]:

• O Frente de Caixa deve ser selecionado de acordo com a regulamentação de cada Estado:

• Para o PDV funcionar, é vital que haja ao menos uma máquina com o Retaguarda instalado.

5 - Selecione o tipo de instalação e clique em [Avançar]:

• Instalar o servidor e a estação de trabalho: Nessa opção, será instalado o PgAdmin3 (utilizado para gerenciar as bases de dados), o serviço do postgrees (que realiza a comunicação da base com o sistema) e o Sistema. A partir dessa máquina, os dados serão replicados para as estações (caso existam). Se o sistema for instalado em apenas uma máquina, selecione essa opção;

• Instalar somente a estação de trabalho: Nessa opção, será instalado apenas o Sistema, portanto, a máquina dependerá de uma comunicação com o servidor (que possua a base de dados) para funcionar. Ao definir essa opção, deverá ser informado o endereço do servidor na próxima etapa da instalação. Se algum frente de caixa for instalado, será instalado o PGAdmin3 e o serviço do postgrees (para trabalhar localmente) comunicando-se também com o servidor.

  

6 - Selecione se deseja utilizar o YODA em Instalar servidor YODA:

• O servidor YODA é responsável por fazer a comunicação entre o retaguarda e os aplicativos.

7 - Defina a pasta onde será instalado o Sistema e clique em [Avançar]:

8 - Informe onde serão criados os atalhos do Sistema, clique em [Avançar]:

9 - Aguarde o fim da instalação e clique em [Terminar]:

→ Como configurar o Servidor Local? (Uniplus WEB)

A instalação do Uniplus WEB em servidor local é feita sobre a mesma base de dados do Uniplus versão desktop.

Entendendo melhor

Instância é um conceito do Uniplusweb. Ele pode se referir a um servidor (no caso do sistema estar instalado localmente no servidor do cliente), ou pode se referir a mais servidores (no caso do Uniplusweb estar em um datacenter, como a Amazon).

Conta refere-se a um cliente final, que tem uma base de dados e um contrato com a Intelidata.

Note que uma instância pode conter mais de uma conta. Claro que isto depende da capacidade de processamento e memória dos servidores onde a instância é executada.

Passos para instalação

1. Tenha certeza de que o Uniplus Desktop esteja corretamente instalado e em operação. Para a instalação, obtenha o link de download aqui;

2. Acesse o Portal do canal e acesse no menu lateral a opção UniplusWeb. Em seguida, clique no botão [Incluir Instância]:

3. Selecione o “Tipo” como sendo Local e preencha os demais dados:

4. Copie o TOKEN gerado pela criação da instância. Essa informação será necessária na instalação:

5. Após criar a nova Instância, clique no botão [Contas] e depois em [Nova conta]:

6. Em seguida, inclua os dados da nova conta:

Sobre os campos que aparecem na imagem acima:

• Identificador global da conta: também conhecido como “tenant”, este identificador será usado para acessar o sistema e normalmente é o CNPJ do cliente que é inserido neste campo.

• Descrição da conta: informe o nome da conta;

• URL da loja: URL de acesso ao Uniplus Shop (opcional). Este campo não tem efeito no caso de uma instância local;

• Demonstração: quando marcado indica que será uma conta de testes, possibilitando restaurar um backup demonstração sem contrato ativo (opcional);

• Contrato: selecione o contrato do cliente;

• Contador: será usado nos casos em que o contador terá acesso ao sistema do cliente através de um painel próprio (opcional).
  
  

7. Agora será necessário instalar o Uniplus WEB local. Baixe o instalador conforme a versão desejada aqui;
   

8. Siga os passos do instalador. Sugerimos instalar o Uniplusweb na pasta C:\UNIPLUS\web.
   

9. Quando solicitado, informe o token da instância e o identificador da conta incluídos na etapa anterior (dados do Token, passo 4. Dados da Conta, passo 6 deste manual):

Como resultado destes passos, o Uniplusweb será instalado como serviço do Windows (com o nome “UnipluswebServer”). O sistema poderá ser conectado usando um navegador de internet.
Exemplo de conexão: https://localhost:8443/?tenant=IDENTIFICADOR_GLOBAL_CONTA.

Alteração da porta 8443

Por padrão, o Uniplusweb será instalado na porta 8443. Para alterar esta porta, crie ou edite o arquivo “application-prod.properties” no diretório de instalação do UniplusWeb e inclua a seguinte linha:

Importante

A versão web não pode ser usada ao mesmo tempo que a versão desktop. Apesar das bases de dados serem 100% compatíveis, os sistema de cache não são integrados, gerando um comportamento imprevisível no caso das duas versões do sistema serem usados ao mesmo tempo.

A comunicação do Uniplusweb é criptografada (mesmo com o servidor local). Na web é obrigatório o uso de um certificado digital emitido por uma autoridade reconhecida.

No caso de um servidor local, a fim de evitar o custo com o certificado, o Uniplusweb usa um certificado interno, que é tão seguro quanto os certificados tradicionais, porém não reconhecido pelos navegadores web. Neste caso sugerimos o uso o cliente do Uniplus para evitar as mensagens de aviso do navegador.

Várias contas no mesmo servidor

Inicialmente, abra o arquivo c:/UNIPLUS/web/application.properties e adicione a seguinte linha:

Para realização de backup automático, adicione as seguintes linhas:

Observação: os locais informados aqui consideram que a instalação foi feita no diretório (pasta) padrão. Se o sistema estiver instalado em outra pasta, será necessário ajustar as informações acima para localizar o arquivo de configuração e o parâmetro informado. Observe que as barras duplas após o “c:” são necessárias.

Após o ajuste nos parâmetros, reinicie o serviço do Uniplusweb para que ele reconheça a alteração que foi feita.

Para incluir uma nova conta no mesmo servidor local, primeiro será necessário cadastrar a conta na instância (usando o portal), conforme os passos iniciais já descritos neste artigo.

Depois, no servidor local é necessário abrir o painel de controle de serviço do Windows e reiniciar o serviço UnipluswebServer. Independente da forma como o procedimento for realizado, a ideia é que o Portal Comercial seja acessado e base de dados com as contas se mantenha atualizado.

Segue disponível link para um banco de dados para ativação, caso seja necessário, aqui.

→ Como restaurar um backup no servidor web local? (Uniplus WEB)

Um detalhe importante antes de começar: se o cliente já utiliza o Uniplus Desktop em um servidor próprio e o Uniplus WEB foi instalado nesse mesmo servidor apenas para uso dele, não é necessário restaurar o backup, pois o Uniplus WEB irá utilizar a mesma base “unico” que o sistema desktop já utilizava.

O procedimento descrito neste artigo, portanto, é indicado apenas para migração de dados de um outro computador, principalmente em servidores que irão hospedar mais de um cliente.

Após criar a conta do cliente dentro da instância (no portal do canal), acesse o endereço https://localhost:8443/tenants/atualizar-tenants. Você receberá a mensagem “Tenants atualizados com sucesso”. Na sequência, acesse a conta do cliente pelo link https://localhost:8443/?tenant=identificadordaconta.

Dica: o identificador da conta foi informado no portal do canal no momento da criação da conta. Caso não lembre dele, você pode acessar a lista de contas da sua instância e pegar o valor na coluna “Identificador”:

Ao acessar, será exibida a tela abaixo para inicializar a conta:

Informe a senha técnica do dia, clique para selecionar o arquivo de backup e clique em Restaurar. 
Observação: o backup deve estar compactado com extensão .zip.

Ao concluir, você será redirecionado para a tela de login e uma notificação aparecerá confirmando a restauração.

→ Como atualizar a build (versão) no servidor web local? (Uniplus WEB)

Existem duas formas de realizar a atualização do sistema em um servidor com instalação local.

Primeira forma de atualização

A primeira é por dentro do próprio sistema. Para isso, é preciso fazer o login através do usuário técnico (usuário técnico = login e senha do Portal Comercial).

Acessando o sistema através desse usuário, vá em Ferramentas → Gerenciador de Versões e abrirá a seguinte tela:

No canto superior esquerdo, você pode ver qual é a versão (build) em que o sistema se encontra atualmente (em vermelho).

A coluna esquerda mostra as builds novas e antigas disponíveis para download. Sempre que uma nova build é liberada, automaticamente ela aparecerá nesse quadro (em azul). Para fazer o download basta clicar no link de “download”.

No canto superior direito, você pode ver qual foi a última build baixada (em laranja).

A coluna direita mostra a relação de builds baixadas (em verde). Para fazer a atualização de uma build baixada, basta clicar no ícone de “atualização”. Esse processo pode ser feito caso você deseje colocar o sistema em uma versão mais atual (upgrade de build), ou voltar para uma build mais antiga (downgrade de build).

Segunda forma de atualização

A segunda forma de fazer a atualização do sistema com servidor local, é através da extração do pacote de build dentro da pasta diretório de instalação do sistema.

O arquivo pode ser solicitado para a nossa equipe via chat ou ticket.

Com o arquivo zipado em mãos, extraia o mesmo dentro deste local:

→ O que é e como identificar o Tenant? (Uniplus WEB)

Podem ocorrer situações onde o Suporte da Intelidata vai precisar da identificação do tenant para solucionar incidentes. Mas, o que é “tenant“?

Falando em termos simples, tenant é um identificador específico do cliente final dentro do servidor web. Pode ser o nome, o cnpj, ou alguma outra expressão única que é definida para fazer essa identificação.

Para acessar a lista dos tenants, vá neste link e faça o login. Porém, atenção: o tenant e o portal de licença são para acesso da Revenda, não do cliente final.

Após acessar o link, escolha a opção UniplusWeb:

Esta ação vai mostrar a tela “Configurações Uniplus Web”, onde a primeira coluna, “Identificador”, é a que contém o tenant de cada cliente final instalado no servidor. Veja na imagem abaixo:

Neste exemplo, que mostra o servidor real de uma Revenda parceira, estamos destacando o tenant/identificador de um cliente que tem Status=”Ativo” e Demonstração=”Não”. É este conteúdo que deve ser passado ao Suporte quando for solicitado.

→ Como contratar hospedagem na GetTI? (Uniplus WEB)

A contratação da hospedagem pode ser feita pelo telefone (44) 99874-8843. O servidor é disponibilizado para a Intelidata fazer a configuração do protocolo HTTPS e logo é devolvido para a GetTI, que é então liberado para a Revenda. Por isso, toda a contratação é feita diretamente com a GetTi. Quando você receber o acesso ao seu servidor, ele já estará pronto para você criar as contas dos seus clientes no portal do canal.

→ Como criar uma conta e restaurar um backup na GetTI? (Uniplus WEB)

Requisito: para que esta etapa seja realizada você já deverá ter recebido a confirmação da criação do seu servidor da GetCard.

Criação de Conta

Acesse a guia do Uniplus Web → Instâncias no Portal de licenças e note que existirá uma instância da Getcard com o nome da revenda. Essa é a instância que nosso time de infraestrutura criou após a contratação do servidor junto à GetCard. Basta clicar em Contas → Nova conta para criar a conta do cliente:

Na criação da conta serão solicitados os seguintes dados:

• Identificador global: também conhecido como “tenant”, este identificador será usado para acessar o sistema e normalmente é o CNPJ do cliente que é inserido neste campo;

• Descrição da conta: informe o nome da conta;

• URL da loja: URL de acesso ao Uniplus Shop (opcional);

• Demonstração: deve ser utilizado se for uma instalação ainda sem contrato ativo. Com a nova comercialização é preciso marcar esta opção para conseguir licenciar o cliente diretamente no Uniplus Web. A base de demonstração (compactada) para inicializar o tenant pode ser baixada neste link;

• Observação: quando marcado, indica que será uma conta de testes. Após a restauração do backup de demonstração, o cliente pode ser licenciado normalmente dentro do sistema Web;

• Contrato: selecione o contrato do cliente;

• Contador: será usado nos casos em que o contador terá acesso ao sistema do cliente através de um painel próprio (opcional).

Após criar a conta o sistema já estará pronto para uso e o primeiro acesso deve sempre ser feito através do link https://canal.intelidata.inf.br/acesso/tenant. No exemplo da imagem acima (que usa uma conta fictícia), o link de acesso ficaria https://canal.intelidata.inf.br/acesso/90001900090001;

Restauração do backup

Após criar a conta do cliente dentro da instância (no portal do canal), acesse a conta do cliente pelo link https://canal.intelidata.inf.br/acesso/identificadordaconta ou pela integração em seu site;

Dica: o identificador da conta foi informado no portal do canal no momento da criação da conta. Caso não lembrar, você pode acessar a lista de contas da sua instância e pegar o valor na coluna “Identificador”.

Ao acessar, será exibida a tela abaixo para inicializar a conta:

Informe a senha técnica do dia, clique para selecionar o arquivo de backup e clique em Restaurar. 

Observação: o backup deve estar compactado com extensão .zip.

Ao concluir, você será redirecionado para a tela de login e uma notificação aparecerá confirmando a restauração.

→ Como atualizar o sistema (build) na GetTI? (Uniplus WEB)

A atualização é realizada dentro do próprio sistema. Portanto, é necessário fazer o login através do usuário técnico (usuário técnico = login e senha do Portal Comercial).

Ao acessar o sistema através desse usuário, vá em Painel de controle → Gerenciador de Versões:

A tela de Gerenciador de Versões é dividida em duas colunas: “Versão atual do sistema” e “Versão baixada mais recente do sistema”:

A coluna esquerda mostra as builds novas e antigas disponíveis para download. Sempre que uma nova build é liberada, ela aparecerá automaticamente neste lado. Para fazer o download basta clicar no link de “download”.
Acima da coluna esquerda, é possível ver qual foi a última build baixada.

A coluna direita mostra a relação de builds baixadas. Para fazer a instalação de uma build baixada, basta clicar no ícone de “atualização”. Esse processo pode ser feito caso você deseje colocar o sistema em uma versão mais atual (upgrade de build), ou caso queira voltar para uma build mais antiga (downgrade de build).

→ Como fazer a contratação da hospedagem AWS? (Uniplus WEB)

A AWS trabalha com um modelo de pagamento conforme o uso, sem a necessidade de contratos de longo prazo ou licenciamento. A definição de preço da AWS é semelhante à usada por serviços públicos, como água ou energia elétrica. Você paga apenas pelos serviços que utilizar e, quando parar de usá-los, não haverá custos adicionais nem taxas de cancelamento.

Com isso, nenhuma contratação é necessária. Criar uma conta na AWS e vincular um cartão de crédito são suficientes para começar a utilizar os serviços. Com a conta criada e o pagamento configurado, o próximo passo é configurar sua conta na AWS.

→ Como fazer a configuração da conta na AWS? (Uniplus WEB)

Esta seção da documentação irá auxiliar na configuração da sua conta AWS para que a Intelidata consiga utilizá-la nas operações do Uniplus WEB. Em vários momentos durante o cadastro será solicitado que anote (guarde) alguns valores para enviar à Intelidata posteriormente. Os valores que deverão ser anotados/guardados são:

• Nome da conta IAM criada para a Intelidata;

• Senha da conta IAM criada para a Intelidata;

• ID da chave de acesso;

• Chave de acesso;

• ID da conta AWS;

• Key Pair (arquivo .pem);

• ARN do certificado digital;

• Nome do domínio criado no Route 53.

Caso ainda não tenha uma conta AWS você pode criar clicando aqui. Observe que existem dois tipos de contas na AWS: raiz e IAM. Caso tenha feito o login utilizando o e-mail de cadastro, provavelmente você está utilizando uma conta raiz. A AWS recomenda que essa conta seja utilizada apenas quando for realmente necessário (por questões de segurança) e por isso vamos criar dois usuários IAM, um para você e outro para a Intelidata.

Criando um Usuário IAM para a Intelidata

Logado com a conta raiz, acesse o recurso IAM localizado menu Serviços no topo da página (você pode utilizar o campo de busca para maior conveniência):

Na barra lateral, clique em Usuários e em seguida clique no botão Adicionar usuário:

Digite “Intelidata” no campo “Nome do usuário”. Logo abaixo, marque a caixa “Fornecer acesso para os usuários ao Console de Gerenciamento da AWS” e em “Tipo de usuário” selecione “Quero criar um usuário do IAM“. Caso preferir, você pode gerar a senha automaticamente, apenas certifique-se de desmarcar a caixa “Os usuários devem criar uma nova senha na próxima sessão“:

Por fim, clique em Próximo → Definir Permissões.

Vamos criar um grupo de usuários administradores. Para isso clique sobre o botão [Criar grupo], informe o nome do grupo (sugestão: Administradores) e selecione a permissão “AdministratorAccess” logo abaixo.

Clique em “Criar um grupo” para finalizar:

De volta a criação do usuário selecione o grupo que acabou de criar e avance clicando em Próximo → Revisar e criar (canto inferior direito):

Caso queira adicionar alguma etiqueta informativa nos usuários adicione o nome da chave e o valor dela. Clique em “Criar usuário”.

Na tela “Recuperar senha”, anote o “Nome do usuário criado para a Intelidata” e a “Senha do usuário Intelidata”. Esses dados serão necessários no vínculo entre as contas AWS e portal do canal.

Para criar o seu usuário, repita o procedimento.

Agora é necessário dar acesso programático para o usuário Intelidata. Para isso, procure-o na listagem de usuários e clique em cima do nome “Intelidata”:

Na tela do usuário “Intelidata” selecione a aba “Credenciais de segurança“:

Desça até a opção “Chaves de acesso” e clique em “Criar chave de acesso”:

Nessa tela, selecione a opção “Command Line Interface (CLI)”. Depois confirme a caixa “Compreendo a recomendação acima e quero prosseguir para criar uma chave de acesso” e clique no botão “Próximo“:

No campo “Valor da etiqueta de descrição”, você pode inserir “Usuário criado para integração com o portal comercial da Intelidata” e depois clicar em “Criar chave de acesso“:

Na tela “Recuperar chaves de acesso”, anote a “chave de acesso” e a “chave de acesso secreta” (lembre-se de clicar em Mostrar), depois clique em “Concluído“. Esses dados serão necessários no vínculo entre as contas AWS e portal do canal:

Conseguindo o ID da Conta AWS

No canto superior direito da página, clique sobre o seu usuário e copie o campo “ID da conta” e anote para enviar posteriormente:

Criação do Key Pair

O Key pair (par de chaves) é utilizado para acessar as instâncias EC2 (servidores do Uniplus WEB). Na prática quem usará essa chave será o portal do canal sempre que for necessário fazer qualquer interação com os servidores. Para criá-la procure pelo recurso EC2 no menu de Serviços:

No Menu lateral esquerdo, acesse “Pares de chave” e em seguida clique em “Criar par de chaves“:

Digite um nome sem espaços para o Par de chaves (sugerimos colocar o nome de sua revenda). Em “Tipo de par de chaves” selecione “RSA” e “Formato de arquivo de chave privada” selecione .pem. Depois clique em “Criar par de chaves”. Nesse momento será feito o download do arquivo de chave (.pem). Guarde-o para nos enviar posteriormente:

Criação de um Novo Domínio

Para que você possa acessar o Uniplus WEB de forma rápida e fácil, é necessária a criação de um domínio dentro da estrutura da AWS. No futuro esse domínio será gerenciado automaticamente pelo portal do canal a cada nova versão do Uniplus WEB. No menu de serviços procure por Route 53:

Ao abrir, localize o campo para registrar um novo domínio. Informe o nome e clique em Verificar:

Verifique se o domínio escolhido está disponível para registro. Se sim, clique no botão [Selecionar] e [Prosseguir para check-out]:

O valor é pago para 1 ano de registro de domínio. Caso desejar renovar automaticamente, deixe marcado a caixa “Renovação automática”. Vá até o final da página e clique em “Continuar“. Nessa tela preencha os campos com suas informações de contato, clique no botão [Continuar] e efetue a compra. Dependendo do domínio escolhido você pode receber um e-mail para validar o registro. A aprovação do registro pode demorar desde poucos minutos até algumas horas. Você também receberá um e-mail quando o registro for aprovado.

Criando um Certificado Digital

O Certificado digital é utilizado para que o Uniplus WEB consiga ser acessado utilizando HTTPS (conexão segura) com o seu domínio. Para cria-lo, busque por “Certificate Manager” no menu de serviços:

Ao abrir, clique em “Solicitar um certificado”:

Selecione “Solicitar um certificado público” e clique em “Próximo”:

Informe o domínio registrado anteriormente no formato *.seudominio.com.br (começando com asterisco). Em “Método de validação”, recomendamos a “Validação por DNS” e em “Algoritmo da chave” selecione “RSA 2048″. Depois clique em [Solicitar]:

Você será direcionado para a lista de Certificados. Atualize a página e clique em cima do “ID do certificado“:

Na tela do certificado, clique em “Criar registros no Route 53″:

Selecione o domínio e clique em “Criar registros”:

Volte para a tela inicial que lista os certificados e monitore a coluna “Status”, até que mostre “Emitido“. Acesse o certificado novamente e anote o valor em ARN:

Depois de efetuados os cadastros, envie todos os dados solicitados para a Intelidata através do e-mail contaaws@intelidata.inf.br. Após retorno confirmando a criação do datacenter, prossiga para a criação do ambiente, instância e contas dos clientes através dos passos indicados na próxima seção.

→ Como fazer a criação do servidor AWS no Portal do Canal? (Uniplus WEB)

→ Como fazer a restauração do backup na AWS? (Uniplus WEB)

Para utilizar o Uniplus WEB na Amazon (AWS), é necessário que um vínculo entre contas seja realizado. Por esse motivo, esta seção tem como requisito a criação da sua conta AWS e de um usuário da Intelidata nessa mesma conta.

Vinculando conta AWS com o portal do canal

Essa etapa é realizada pela Intelidata. Para que seja possível criar o cadastro do datacenter e vincular com sua conta, nos envie os seguintes dados da conta AWS:

• Nome da conta IAM criada para a Intelidata;

• Senha da conta IAM criada para a Intelidata;

• ID da chave de acesso;

• Chave de acesso;

• Key Pair (arquivo .pem ou conteúdo do arquivo em texto);

• ARN do certificado digital;

• Nome do domínio criado no Route 53.

Após receber retorno da Intelidata confirmando a criação do datacenter siga os passos abaixo para criação de um novo ambiente.

Criação do Ambiente

No portal do canal, acesse UniplusWeb no menu lateral e clique em Ambientes AWS no topo da página:

No grupo com os ambientes, clique em [Novo ambiente]:

No cadastro de novo ambiente serão solicitados inicialmente dois campos para identificação do ambiente. Observe que tanto o número quanto o nome devem ser únicos. Na sequência há o campo para definir o tipo de instância do banco de dados (processamento e memória do servidor) e o espaço em disco:

Instâncias pequenas como a t2.micro ou t3.micro podem atender bem clientes pequenos, enquanto clientes maiores talvez exijam instâncias também maiores como a t3.small, t3.medium ou superior. O tamanho do banco de dados (espaço em disco disponível) pode ser informado dependendo da quantidade e porte dos clientes que utilizarão este ambiente.

Ao final, clique em [Gravar].

Nesse momento o ambiente foi gravado, mas ainda não foi criado na AWS. Para criar, volte para a guia Conta AWS e clique em Simular. Será exibida uma tela com todos os itens que serão criados e/ou modificados na AWS. Clique em [Fechar] para voltar à tela do datacenter.

Se não apareceu nenhum erro na simulação, o status ficará como Planejado e o botão Aplicar ficará disponível, clique nele e confirme para aplicar os comandos. Observe que o status ficará como Processando enquanto os comandos são aplicados na AWS.

Observação: Este processo pode demorar alguns minutos.

Quando estiver concluído, o status será alterado para Inicializado.

Criação da Instância

Na sequência, no topo da página clique na aba Instâncias e depois em Incluir Instância.

Em Tipo: selecione AWS, informe um nome para a instância, uma descrição, a versão desejada do UniplusWeb e o ambiente que irá acomodar essa instância.

Você pode utilizar balanceamento de carga para essa instância. Caso opte por essa opção, novas instâncias serão inicializadas para atender momentos de grande demanda e serão terminadas quando a demanda baixar, sem intervenção humana. Essa opção também permite que você configure instâncias JOB, que irão processar tarefas pesadas em paralelo, deixando o servidor principal livre para o uso normal. Tanto as instâncias API (principal) quando as instâncias JOB permitem configuração do número mínimo e máximo de servidores ligados.

Tenha cuidado ao trabalhar com balanceamento de carga, pois o custo pode se elevar bastante dependendo do uso

Dica: faça um acompanhamento constante pelo painel de gerenciamento de custos na AWS e crie Budgets (alertas) para lhe avisar quando o custo ultrapassar um valor configurado.

Caso opte por não utilizar o balanceamento de carga, selecione o tamanho da instância API e clique em Incluir. Você verá a sua nova instância criada, mas ainda é necessário simular e aplicar na sua conta AWS como foi feito na criação do ambiente. Volte na guia Conta AWS, clique em Simular e depois em Aplicar.

Criação de Contas

No Uniplus WEB cada cliente é uma conta e deve estar atrelado a um contrato. Para criação da conta, acesse a guia Instâncias e clique no botão Contas na instância que este cliente utilizará.

Na tela de Instância, clique em [Nova Conta].

Você precisa informar um identificador global da conta, uma descrição, o contrato deste cliente e o contador (caso possua). Selecione a opção Demonstração caso queira restaurar a base inicial com cadastros de demonstração. Ao final, clique em Incluir.

Neste momento a conta do cliente está sendo criada. Esse processo pode levar alguns minutos até que o acesso esteja disponível. O acesso pode ser realizado neste link ou digitando o identificador da conta na integração dentro do seu site.

→ Como fazer a restauração do backup AWS no Uniplus WEB local?

Sigas as etapas descritas abaixo:

1 - Para armazenar o backup do cliente, acesse os serviços da AWS e procure por S3 (Armazenamento escalável na nuvem) conforme imagem abaixo:

2 – Assim que abrir a tela para armazenamento, serão exibidos dois buckets (pastas). Um se chama default e o outro temp. Abra o bucket temp (ele que irá guardar os backups). Ainda dentro do bucket temp, abra a pasta backups onde serão exibidos todos os clientes e selecione o cliente em questão.

3 – No bucket (pasta) do cliente você irá se deparar com várias outras pastas, porém, a única que nos interessa é a pasta backups. O arquivo de backup vai depender da configuração que o cliente utiliza, podendo ter o nome da filial, do cliente, data etc. Esse é o arquivo que devemos baixar. Basta selecionar o arquivo e clicar em Fazer download conforme imagem abaixo:

Restaurando o backup no Postgres local

1 – Faça o download e a instalação do pgAdmin 4. Você pode encontrá-lo no seguinte link: https://www.pgadmin.org/download/pgadmin-4-windows/

2 – Execute o pgAdmin 4 e em servers, clique com o botão direito do mouse e selecione a opção Create. Serão exibidas duas outras opções, selecione Server conforme imagem abaixo:

Configure as guias abaixo da seguinte forma:

• Guia General / campo Name: dê um nome de seu interesse. Nesse exemplo foi usado servidor.

• Guia Connection / campo Hostname/address: digite localhost

• Guia Connection / campo Password: digite a senha do seu usuário postgres (por padrão postgres).

Por fim clique em Save para que a configuração do novo servidor local seja salva.

3 – Dê um clique no servidor que você acabou de criar e então clique com o botão direito sobre Databases e selecione Create. No campo Database digite unico. Esse deverá ser o nome do nosso banco de dados que se comunicará com o sistema Uniplus. Por fim clique em Save:

Observação: caso já exista uma base de dados “unico”, será necessário excluí-la para que possamos criar uma nova base zerada com o mesmo nome. Isso se faz necessário para que o processo de restauração consiga recriar a estrutura em um local limpo. 

ATENÇÃO: esse processo irá excluir permanentemente o banco de dados do sistema instalado atualmente no servidor. Tenha certeza de que não há dados de clientes nessa instalação!

4 – Com a base “unico” criada, clique com o botão direito do mouse e selecione a opção Restore:

5 – No campo Filename, clique no botão com 3 pontinhos “…” e selecione o diretório onde o arquivo de backup está. Após selecionar o diretório, clique no botão Restore:

Observação: durante o processo de restauração você perceberá que acontecerão vários erros de roles (usuários). Isso acontece porque no ambiente da AWS existem alguns usuários que não estão na instalação local do sistema, mas isso não irá impactar no uso do sistema e pode ser ignorado.

Abra o Uniplus e verifique se o sistema está funcionando conforme esperado.

→ Como fazer conexão remota RDS na AWS? (Uniplus WEB)

Para conseguir conectar remotamente à sua instância RDS é necessário adicionar uma regra de firewall (que no ambiente da AWS é conhecido por Security Group), além de configurar para permitir o acesso público.

1 - Primeiramente acesse o console AWS com a sua conta. Clique em Serviços e acesse RDS (você pode utilizar a barra de busca se for mais conveniente):

2 - Na tela que abrir, clique na lateral em Databases e, em seguida, clique sobre a sua instância de banco de dados:

3 - Nessa tela constam várias informações sobre sua instância de banco de dados. Na guia Connectivity & security procure por VPC security group e clique no item que estiver logo abaixo (o nome pode variar de acordo com seu ambiente):

4 - Acesse o único security group que apareceu e então clique em Edit inbound rules:

5 - Clique em Add rule e, na nova linha que apareceu, procure por PostgreSQL, My IP e digite uma breve descrição. Por fim, clique em Save rules.

Observação: essa regra irá liberar o acesso à instância RDS apenas do seu IP externo atual. Caso não tenha IP externo fixo, tenha ciência que você vai precisar atualizar a regra sempre que seu endereço IP mudar. 

Não é recomendado liberar para todos os endereços (0.0.0.0/0) sob risco de sofrer ataques, invasões e sequestros de dados de qualquer lugar do mundo.

6 - Agora vamos habilitar o acesso público. Para isso, precisamos voltar à tela onde apareceram os dados da Instância RDS e clicar em Modify:

7 - Um pouco mais para baixo em Network & Security → Public Accessibility, selecione Yes:

8- Na tela de revisão, selecione Apply Immediately para aplicar imediatamente a configuração e clique em Modify DB Instance:

9 - O endereço e a porta para conexão você encontrará nas informações da sua instância RDS conforme imagem abaixo:

Pronto! Agora você já consegue conectar remotamente em seu banco de dados na AWS.

→ Como fazer a atualização de build (versão) na AWS? (Uniplus WEB)

Se você já está habituado com o funcionamento da atualização de build do sistema desktop ou mesmo no UniplusWeb hospedado na GetTI ou Local, irá perceber que o procedimento é diferente. Isso ocorre por conta da arquitetura do nosso sistema dentro da AWS, que é diferente dos outros dois cenários.

Na AWS as instâncias de aplicação não armazenam nenhum dado de cliente. Com isso, podemos dizer que ela é “descartável”, ou seja, é possível trocar de instância a qualquer momento, com praticamente zero impacto para o usuário. Isso é possível graças a arquitetura, que separa a aplicação, banco de dados e arquivos em três locais diferentes dentro da AWS. Quando excluímos/trocamos a instância de aplicação, o banco de dados e os arquivos do usuário (backups, imagens, relatórios etc) continuam inalterados em outros locais (Amazon RDS e Amazon S3).

Por isso, podemos dizer que não existe atualização de build dentro da AWS, ao menos não da forma que conhecemos. O que ocorre é uma troca: de uma instância com o sistema na versão mais antiga, partimos por substituição para uma instância com o sistema na versão mais nova.

Processo

O primeiro passo é o de criar uma nova instância. Para isso acesse a guia Instancias → Incluir Instância:

Selecione o tipo AWS e preencha todos os campos selecionando a versão do sistema que você deseja.

Atenção: instâncias micro não são suficientes para rodar a aplicação. Selecione uma instância small ou superior (ex.: t3.small, t3a.medium etc).

Ao final, clique em [Incluir]. Você estará de volta na listagem das instâncias. Nesse momento é necessário voltar na guia Conta AWS e aplicar as alterações para que a nova instância seja de fato criada dentro da AWS. Para isso, clique em [Simular] e depois em [Aplicar]:

Quando o Status ficar como Inicializado, ainda será preciso aguardar alguns minutos para que a aplicação inicie dentro da nova instância. Recomendamos aguardar de 5 à 10 minutos nessa etapa. Passado o tempo, volte na guia Instâncias e clique em [Migrar] na sua instância antiga. Na pequena janela que abrir selecione a sua instância nova e, por fim, clique em [Migrar]:

Concluído! Na próxima vez que o cliente for acessar o sistema, ele já irá utilizar o novo servidor com o sistema atualizado. Observe que os clientes continuam conectados na instância antiga. Eles só serão redirecionados para a nova instância no próximo acesso ao sistema.

Depois que todos os clientes já estiverem trabalhando no novo servidor, você pode excluir a instância antiga para não gerar cobranças desnecessárias. Lembre-se de também Simular e Aplicar depois desse procedimento, para que a instância seja desativada no seu ambiente da AWS.

→ Como solicitar acesso ao banco de dados na GetTI ou AWS? (Uniplus WEB)

Quando ocorrer a necessidade de acessar o banco de dados do Uniplus WEB hospedados na GetTi ou AWS, é necessário realizar a solicitação do acesso junto a Intelidata.

Nesse caso, a Revenda deve abrir um ticket com a solicitação do acesso, através de ticket direcionado ao Suporte Uniplus WEB → Infraestrutura/Servidor.

O ticket deve conter o IP público da revenda e uma sugestão de usuário e senha (opcional).

A liberação será realizada por parte da Intelidata, onde ocorrerá a criação do usuário para acesso ao banco de dados.

→ Como usar as ferramentas de Limpeza de Cache e de Migração no Uniplus WEB?

O cache é um armazenamento temporário onde ficam dados que são acessados com frequência, como arquivos ou informações de navegação. Ele agiliza o acesso a esses dados, melhorando a performance do sistema. Porém, quando o cache está cheio ou desatualizado, pode causar problemas como lentidão, falhas ou recuperação de dados desatualizados. A Limpeza de Cache, ou clearCache, será útil nesses casos.

A Migração é um processo que tem uma função semelhante à do atualizador de base presente na versão Desktop do sistema. Ele é responsável por ajustar a estrutura do banco de dados quando há uma atualização de versão significativa, com grandes mudanças na estrutura entre uma versão e outra. Também é utilizado quando é detectada a ausência de tabelas ou colunas, o que pode causar problemas durante o uso do sistema, afetando diversas operações.

Como usar a ferramenta Limpeza de Cache

Para realizar a limpeza do cache do tenant que está apresentando problemas, comece acessando a tela de login do cliente em questão:

Na tela de login, substitua a parte “/login” da URL por “/clearCache/[tenant_do_cliente]“, conforme o exemplo abaixo:

Após alterar a URL, copie e cole na aba anônima do seu navegador e pressione [Enter] para executar o comando de limpeza do cache.

Após o processo, será exibida uma mensagem informando que o processo foi concluído:

Se a mensagem não for exibida, revise a estrutura da URL para garantir que esteja conforme o exemplo mostrado nas imagens e tente novamente. Caso a mensagem de sucesso seja exibida, retorne à página principal, pressione [F5] para atualizar a página e acesse o sistema normalmente para realizar os testes.

Como usar a ferramenta Migração

O processo segue a mesma lógica da limpeza de cache. Você precisará acessar a tela de login do sistema e alterar a parte “/login” da URL por “/migracao/tenant_do_cliente“, conforme o exemplo abaixo:

Após alterar a URL, copie e cole na aba anônima do seu navegador e pressione [Enter] para executar o comando de migração:

Será mostrada uma mensagem informando o fim do processo:

Se a mensagem acima não for exibida, revise a estrutura da URL para garantir que esteja conforme o exemplo mostrado nas imagens e tente novamente. Caso a mensagem de sucesso ao atualizar base de dados seja exibida, retorne à página principal, pressione [F5] para atualizar a página e acesse o sistema normalmente para realizar os testes.