Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

01. DADOS GERAIS:

Linha de ProdutoRMS
SegmentoVarejo
MóduloWeb
TipoAplicação Web

02. PRÉ-REQUISITOS:


VersãoRelease 12.1.27 ou superior
S.O.Windows Server 2008 ou superior (com as atualizações mais recentes)
.NET Framework.NET Framework 4.7.1 ou Superior
.Net Core.NET Core 3.1 
IISInstalação IIS
Arquitetura IIS (RMS)Arquitetura de diretórios RMS

*Sugerimos que após realizar todas as instalações acima, reinicie o servidor.


03. INSTALAÇÃO - Implantação das APIs:

Conforme listado nos pré-requisitos é necessário que a estrutura de diretórios esteja devidamente estruturada na pasta "...\inetpub\wwwroot";

Será necessário liberar permissão total do diretório "wwwroot" para os os usuários IIS (IIS_IUSRS); Esse processo é necessário para que os projetos possam manipular arquivos.

image2020-4-13_17-49-8.png

  1. Localize a pasta RMS (pacote baixado na central de downloads) ;
  2. Copie a pasta RMSServices para o diretório RMS, dentro da estrutura do IIS.
    1. Caso, já exista esta pasta, basta copiar apenas o conteúdo, para seu diretório RMSServices.
  3. Copie a API: APiZEUS para o diretório: RMSServices;
    1. Conteúdo baixado na central de downloads;
  4. Acesse a pasta que foi copiada;
  5. Encontre o arquivo "appsettings.json";
  6. Abra-o com o editor de texto de sua preferencia;
  7. Edite o valor da propriedade "PathFileConfig" para a pasta "_data" localizada dentro do diretório raiz do RMSServices;
  8.  
    1. O diretório "..\RMSServices\_data" será responsável por armazenar todos os arquivos de configurações e arquivos criptografados referentes a todas as nossas APis;
  9. Abra o IIS;
  10. Crie um pool de aplicação para a API.
    1. Clique em OK;
    2. Selecione o pool criado, clique com o botão direito do mouse e clique em "Advanced Settings" (Opções avançadas);
    3. Em "Identity" altere a opção para "LocalSystem";
      1. Este passo é necessário para que a API consiga manipular arquivos com permissões do sistema operacional.
  11. Localize na arvore da esquerda, o diretório RMS>RMSServices;
    1. Identifique a pasta APiZEUS;
  12. Converta-o para aplicação vinculando o pool de aplicação criado no passo 13;
    1. Clique com o botão direito em "APiZEUS" em seguida Clique em "Convert to Application" (Converter para aplicação);
  13. Para testar, selecione e clique com o botão direito do mouse em "APiZEUS" > Manage Application > Browse;
    1. Quando o navegador abrir, adicione uma "barra"( / ) no final da url.
      1. Feito para acessar a documentação da API.
  14. O resultado esperado é esta tela:
  15. Com isso finalizamos a implantação e configuração da API.

04. INSTALAÇÃO - Implantação Aplicação Web:

  1. Dentro da pasta recebida para implantação identifique o seguinte diretório: RMS Aplicações;
  2. Mova a pasta Aplicações para dentro do diretório do IIS;
    1. Caso já tenha o diretório criado na estrutura do IIS ("...\inetpub\wwwroot\RMS\Aplicacoes"), basta apenas copiar a pasta(API-Manager);
  3. Volte até o IIS;
  4. Dentro da árvore à esquerda, identifique o diretório que acabamos de criar;
    1. Caso não apareça, atualize a árvore. (F5 ou clique com o botão direito > Refresh);
  5. Da mesma forma como convertemos para aplicação as pastas do RMSServices, vamos repetir o processo para a aplicação web;
  6. Selecione a pasta RMS > Aplicacoes > API-Manager;
    1. Pode ser vinculado ao pool de aplicação criado para API.
  7. Clique com o botão direito do mouse > "Convert to Application";  
  8. Selecione o pool de aplicação que foi criado anteriormente;
  9. Clique em "OK" para finalizar a conversão.
  10. Pronto, finalizamos a conversão;
  11. Para acessar a aplicação, selecione o RMS > Aplicacoes > API-Manager;
    1. Clique com o botão direito do mouse > Manage Application > Browse;
  12. Como resultado, o navegador exibirá a nossa aplicação web:
  13. Com isso finalizamos a implantação de nossa aplicação web.

05. Encryptor- Criptografando informações para acesso ao banco de dados(Oracle):

  1. Para realizar a criptografia das informações de acesso ao banco clique em "Encryptor"
  2. Um modal irá abrir para informar os dados de acesso:
  3. Após informar todos os dados descritos acima, clique em "Criptografar".
  4. Será criado um arquivo dentro do diretório ".\RMSServices\_data".
    1. Arquivo chamado: dbConnInfo.tcrpt.
      1. Este arquivo contém as informações de banco de dados criptografadas.
      2. Todas as novas versões das APIs fará a leitura das informações de acesso ao banco neste arquivo, com isso não será mais necessário fazer a configuração individualmente em cada API/Web Service.
      3. Nas configurações das APIs e Web Services será necessário informar o diretório da pasta "_data", isso estará nas documentações de cada projeto.
  5. Para verificar o status da conexão com o banco de dados, basta clicar em "Conexão BD";
  6. Com isso finalizamos a configuração do arquivo de criptografia.