1. Download dos arquivos necessários
Primeiro, será necessário baixar o instalador da API Metadados e, caso necessário, os requisitos da aplicação.
Observação importante: Caso os requisitos já tenham sido instalados anteriormente, não é necessário baixá-los ou instalá-los novamente.
Acesse o portal do cliente Metadados:
https://cliente.metadados.com.br/login?returnUrl=%2Fdashboard
Após acessar o portal, será exibida a tela abaixo. Clique em Atualização de Produtos.
Em seguida, clique em Arquivos Públicos.
Por fim, baixe o instalador da API Metadados e os requisitos, caso ainda não estejam instalados no ambiente.
Importante: Se os requisitos já estiverem instalados no servidor, basta baixar apenas o instalador da API Metadados.
2. Abertura do IIS
Com o instalador salvo na máquina, será iniciado o processo de atualização da API Metadados.
Abra o IIS pressionando as teclas abaixo:
Será aberta a seguinte janela:
No campo exibido, digite:
inetmgr
Em seguida, clique em OK.
A console do IIS será aberta.
3. Localização do site da API Metadados
Na lateral esquerda do IIS, clique na pequena seta ao lado do nome do servidor, conforme demonstrado abaixo.
Ao expandir os itens, clique na seta ao lado da pasta Sites.
Serão exibidos os sites configurados no IIS.
Selecione o site da API Metadados.
No canto direito do IIS, clique em Parar.
Após parar o site, o IIS pode ser minimizado.
4. Execução do instalador da API Metadados
Localize o instalador da API Metadados e clique duas vezes sobre ele.
Após executar o instalador, será exibida uma janela de confirmação solicitando permissão de administrador para prosseguir com a instalação.
Clique em Sim.
Após confirmar, será aberta a janela do instalador da API Metadados.
Clique na seta localizada no canto direito e selecione o site já existente da API Metadados:
ApiMetadados
Depois clique em Próximo.
Após clicar em Próximo, será exibida a tela abaixo.
Nesta tela, clique em Próximo.
5. Validação da conexão com o banco de dados
Em seguida, será exibida a tela de configuração do banco de dados.
Caso os dados de conexão com o banco de dados não tenham sido alterados, não é necessário modificar nenhuma informação.
Clique em Próximo para continuar.
6. Validação da URL da API Metadados
Será exibida a tela de configuração da URL da API Metadados.
Caso a URL da API não tenha sido alterada, mantenha a configuração atual e clique em Próximo.
7. Conclusão da atualização
Na última tela do instalador, clique em Concluir.
8. Inicialização do site no IIS
Após concluir a atualização, abra novamente o IIS.
Selecione o site da API Metadados e clique em Iniciar, caso ele não tenha iniciado automaticamente.
9. Instalação dos requisitos, se necessário
Caso os requisitos ainda não estejam instalados no servidor, será necessário instalá-los.
Clique duas vezes no instalador:
dotnet-hosting
Clique em Instalar.
Caso seja solicitada permissão de administrador, autorize a instalação.
Aguarde a conclusão da instalação.
Após a instalação ser concluída, clique em Fechar.
O outro requisito deve ser instalado seguindo o mesmo procedimento.
Observação: Se os requisitos já estiverem instalados, esta etapa pode ser ignorada.
10. Validação final da atualização
Após concluir todas as etapas, abra o navegador e acesse a URL configurada no IIS.
Exemplo utilizado neste manual:
https://apimetadados.teste.com.br
Se a atualização tiver sido realizada corretamente, será exibida a tela da API Metadados.
Observação sobre certificado SSL
Importante: Durante a demonstração deste manual, o navegador poderá exibir um aviso informando que a conexão não é segura ou que o certificado não é confiável. Esse comportamento é esperado, pois foi utilizado um certificado SSL autoassinado apenas para fins de demonstração.
Em um ambiente de produção, recomenda-se utilizar um certificado SSL emitido por uma Autoridade Certificadora (CA) reconhecida, como DigiCert, Sectigo, GlobalSign, Entrust, Let's Encrypt ou outra certificadora de confiança. Dessa forma, o navegador reconhecerá automaticamente a autenticidade do certificado, eliminando os avisos de segurança apresentados durante o acesso à API.