A partir de 05/07/2021 o nome do Consinco Web Setup será Publica Web.

CONTEÚDO

1. Visão Geral
2. Exemplo de utilização

...

Validar o ambiente, instalar e atualizar os produtos web TOTVS Varejo Supermercados - Linha Consinco.

02. EXEMPLO DE UTILIZAÇÃO

...

• O Publica Web é compatível somente à partir do Windows Server 20122016, conforme sistema operacionais homologados.

• É recomendado que toda a publicação seja feita utilizando o protocolo https para maior segurança.
• É necessário ter o .Net Framework v4.8 ou superior instalado.
• É necessário instalar os bundles .Net Core 3.1.31 e , .Net Core 2.2.86.0.22 (a partir da versão 24.01) e .Net 8.0.11 (a partir da versão 25.07).
• É necessário ter o Oracle Client 32-bit com o arquivo tnsnames.ora configurado.
• É necessário que o usuário tenha permissão de administrador e leitura/escrita nos diretórios do servidor.
• Ao utilizar a funcionalidade de “Exclusão” de uma de uma publicação, alguns anti-vírus antivírus (ex: Trend Micro) podem interceptar o funcionamento da ferramenta da ferramenta com suspeita de ransomwarede ransomware, gerando um falso-positivo, já que a operação de exclusão de arquivos dentro da pasta “inetpub” por um software de terceiro pode caracterizar um caracterizar um possível ataque. A recomendação caso isso ocorra, é adicionar nas exceções do anti-vírus o nome do executável ou então a antivírus a assinatura digital da ConsincoTOTVS.
• O Publica Web deve ser executado apenas no executado apenas no servidor de aplicação web (IIS), no qual hospeda ou hospedará as publicações Consinco.
• O Publica Web  substitui e incorpora todas as funcionalidades das ferramentas anteriores: C5Setup, C5Update (Consinco Web Update) e Consinco Web Checker.
• TOTVS Varejo Supermercados.
• A distribuição do Publica Web será é feita por meio do pacote de atualização de versão, disponibilizada pela ferramenta Agente de Atualização .
• O Publica Web está disponível à partir da versão 19.06.015.
• À partir do uso do Publica Web , todos os módulos e sites listados serão atualizados pela ferramenta, não sendo mais necessário atualizar manualmente os pacotesou Central de Downloads, conforme a Linha de Produto.

Passo a Passo

Verificação de Pré-requisitos de Ambiente

...

*¹ É possível registrar apenas pacote selecionados os pacotes segurando a tecla SHIFT, para selecionar um grupo, ou CTRL, para selecionando itens individuais. Após selecionar os pacotes, clique com o botão direito e selecione a opção 'Registrar Aplicações'. Para que a opção esteja disponível, o pacote deve estar com o serviço no status 'Iniciado'.

Nova Publicação

Avisos

Se houverem avisos importantes nos pacotes da versão, será exibida a tela contendo as mensagens, conforme modelo abaixo.

Image Added

Nova Publicação

Ao clicar em Nova Publicação, será exibido a tela abaixo Ao clicar em Nova Publicação, será exibido a tela abaixo com os produtos disponíveis para publicação.

Image RemovedImage Added

Recomenda-se não alterar o Nome da publicação sugerido pela ferramenta para manter o padrão de instalação das publicações, o que facilitará o suporte e possíveis evoluções futuras do produto.

• Produto: Produto a ser publicado no servidor.

• Ambiente: Tipo de ambiente: Produção ou Homologação

• Nome: Nome da publicação que será criada no IIS.

• Porta: Porta de acesso ao site (ex: http://sistema.consincototvs.com.br:90).

• Porta da API: Para uso interno. Para publicações que não utilizam o site de API, basta informar a porta 0. Se informada a porta do site de APIs já publicado, o novo site passará a utilizá-lo também.

• Protocolo: Protocolo a ser utilizado na publicação.
• Certificado: Será possível selecionar o certificado digital já instalado no servidor caso a opção do protocolo seja https.
• Endereço: Será possível informar o endereço DNS caso a opção do protocolo seja https. (ex: totvs.meudominio.com.br).
• Diretório: Caminho ao qual os pacotes serão instalados. A recomendação é utilizar o diretório padrão do IIS, ao qual o campo já vem preenchido.

...

Clique com o botão direito em qualquer área da lista de produtos, será exibida as opções para Marcar Todos e Desmarcar Todos..

Image Added

Pesquisa de pacotes

Para facilitar encontrar um pacote, há o recurso "Pesquisar pacote" que pode ser acessado após carregar a lista de pacotes através das teclas de atalho CTRL + F. Acionando essas teclas, será exibido um formulário para ser preenchido com o texto desejado e, ao clicar em confirmar, será pesquisado na lista o termo inserido e, se encontrado, o item será destacado.

Image Added

Gerenciamento de sessões ativas na base de dados

A partir da versão 25.01.XXX a ferramenta apresenta o recurso para executar scripts da base de dados dos pacotes. Sendo assim, pacotes que possuem os scripts a serem executados poderão exigir o encerramento das sessões ativas na base de dados para que o processo seja executado sem erros.

Se houver pacotes nesse modelo, será exibida a mensagem informando a necessidade, conforme imagem abaixo.

Image Added

Se o pacote exigir a desconexão das sessões, após a exibição da mensagem será exibido um formulário com as sessões ativas, no qual será possível encerrá-las, desde que haja permissão na base de dados, conforme imagem abaixo.

Image Added

Nesse caso, não será possível dar andamento no processo enquanto houver sessões ativas.

No modo silencioso, as sessões serão encerradas automaticamente.

Histórico de atualização

É possível verificar o histórico de execução de scripts através do menu do contexto na lista de pacotes. Clicando no item com o botão direto, será exibido o menu com a opção "Histórico de atualização".

Image Added

Ao clicar na lupa, será possível ver os detalhes da atualização.

Image Added

Image Added

Ao clicar duas vezes no conteúdo da coluna Falha ou Preview Comando, será aberto o texto completo para visualização.

Image AddedImage Removed

Execução em modo silencioso

...

• tipoinstalacao=<tipo>
  Utilizado somente na ferramenta de setup web para informar o tipo de instalação, se é completa ou apenas os pacotes do produto padrão. Os valores possíveis são: P (Padrão) ou C (Completa)
• host=<endereço>
  Utilizado para informar um host para o site que será publicado. Se não for informado, será considerado o ip local da máquina.
• nomesite=<nome>
  Utilizado para nomear o site. Caso não seja informado, seja considerado o nome de exibição parametrizado no pacote. Ao remover uma publicação, o nome do site deve ser sempre informado.
• porta=<numero>
  Utilizado para informar uma porta específica a ser usada na publicação do site. Caso não seja informada, seja considerada a porta padrão parametrizado no pacote.
• portaapi=<numero>
  Utilizado para informar uma porta específica a ser usada na publicação do site de API. Caso não seja informada, seja considerada a porta padrão parametrizado no pacote.
• hashcertificado=<codigohash>
  Utilizado para fazer uma publicação usando HTTPS e SSL. Deve ser informado o código hash do certificado (impressão digital/thumbnail) que está instalado no servidor.
• alteraconexao
  Ao informar este parâmetro, serão atualizados os dados de conexão da publicação informada pelo parâmetro nomesite ou, caso não seja informado, pelo nomepacote. É obrigatório informar os dados de conexão.
• removerpublicacao
  Utilizado para fazer a remoção da publicação com base no nome do site informado. Sendo assim, é obrigatório informar o nome do site a ser removido.
• criarbackup
  Utilizado para informar se, ao remover uma publicação, deve ser criado um backup da publicação.
• diretorio=<caminho>
  Utilizado para informar outro diretório a ser instalado o site. Caso não seja informado, será considerado o diretório padrão do IIS.
• hotfix
  Utilizado para que seja possível aplicar os pacotes disponibilizados na pasta InstallationFiles no modo silencioso. É necessário informar o parâmetro nomesite para que seja possível aplicar os pacotes.
• ipservidoraplicacao=<ip>diretorio=<caminho>
  Utilizado para informar outro diretório a ser instalado o site. Caso não seja informado, será considerado o diretório padrão do IISo endereço de IP do servidor de aplicação para linha RMS.

Os parâmetros podem ser informados em qualquer ordem, exceto o parâmetro de conexão que, ao informar o marcador, deve seguir a ordem estabelecida na documentação.

...

A aplicação irá lançar um código de saída (exitCode) com o valor 0, caso tenha finalizado a execução com sucesso ou , o valor 1 caso tenha apresentado algum erro durante a execução e o valor 2 caso seja um aviso ou alerta. Para ambas as situações, se for passado o parâmetro parâmetro salvalog, a aplicação irá gerar sempre o arquivo de log referente ao momento de encerramento da aplicação, seja por sucesso ou erro.

Valores de saída:
0 - Sucesso
1 - Erro
2 - Alerta
3 - Informação