Histórico da Página
A partir de 05/07/2021 o nome do Consinco Web Setup será Publica Web.
CONTEÚDO
- Visão Geral
- Exemplo de utilização
...
Validar o ambiente, instalar e atualizar os produtos web TOTVS Varejo Supermercados - Linha Consinco.
02. EXEMPLO DE UTILIZAÇÃO
Caminho
Publica Web – ALM00002GLO00053
Pré-Requisitos e Restrições
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 6.0.22 (a partir da versão 24.01).
- É 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 é feita por meio do pacote de atualização de versão, disponibilizada pela ferramenta Sync, da mesma forma como era feito até então com o Consinco Web Update.
- 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 pacotes.
Passo a Passo
Verificação de Pré-requisitos de Ambiente
- Agente de Atualização ou Central de Downloads, conforme a Linha de Produto.
Passo a Passo
Verificação de Pré-requisitos de Ambiente
Ao iniciar a aplicação, será realizada a checagem dos pré-requisitos mínimos necessários para instalação ou atualização das publicações web no servidor. Somente será possível avançar para as próximas etapas, se não houver nenhum item com status de Não atende.
...
Publicação: Lista os produtos já publicados no ambiente para consultá-los.
Nova publicação: Publicar um novo produto.
Registrar aplicações e relatórios: Refaz o registro de aplicações e relatórios para a publicação selecionada.*¹
Excluir publicação: Remove a publicação selecionada.
Abrir site: Abre o navegador com o endereço do site.
Editar conexão: Edita a conexão do site selecionado.
- Habilitar HTTPS: Cria/altera o endereço com o protocolo HTTPS. Usado para criar/alterar o endereço no IIS com o protocolo HTTPS de acesso ao site. Atenção: O servidor deve ter um certificado válido instalado para que a utilização do protocolo Https ocorra sem problemas.
Limpar: Limpa todos os campos da tela.
Avançar: Instala ou atualiza a publicação conforme dados informados.
- Recarregar pacotes: Recarrega a lista de pacotes instalados e os pacotes disponíveis para instalação/atualização.
Nova Publicação
Ao clicar em Nova, será exibido a tela abaixo com os produtos disponíveis para publicação.
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.consinco.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.
A aplicação permite criar várias publicações do tipo de ambiente Produção para cada produto no mesmo ambiente, porém uma mensagem de aviso será exibida caso já exista uma publicação do produto em produção. Não há limites para criação de publicações para o tipo de ambiente Homologação. As portas informadas para a nova publicação não podem estar em uso por outra publicação, caso contrário a aplicação não permitirá a continuar.
Após clicar em OK na tela de Nova Publicação, confirme as aplicações e versões a serem publicadas, e informe os dados de conexão com o banco de dados, conforme exemplo acima.
Servidor: Alias do servidor de banco de dados (o mesmo do tnsnames.ora)
Usuário: Usuário do ERP no banco de dados (ex: CONSINCO)
Senha: Senha do usuário do ERP
Testar Conexão: Realiza um teste de conexão com a base de dados informada.
- Recarregar pacotes: Recarrega a lista de pacotes instalados e os pacotes disponíveis para instalar ou atualizar.
Ao clicar em avançar, se as configurações estiverem OK, o processo de instalação será iniciado exibindo as etapas do processo, conforme o exemplo abaixo.
Se ocorrer algum erro durante as etapas de execução, a linha referente a etapa que falhou ficará em vermelho e na mensagem de finalização será solicitado que os erros sejam verificados, conforme o exemplo abaixo.
Caso a instalação ou atualização ocorra sem nenhum problema, a tela abaixo será exibida. Clique em Concluir para voltar a tela principal.
Exportar: Permite exportar o log gerado em tela para arquivo texto.
A aplicação também armazena em seu diretório corrente, os logs em arquivo texto de todas as execuções, caso seja necessário encaminhar para análise de suporte. Após a finalização da instalação, uma página de teste será aberta para validar a instalação.
Atualizar uma Publicação
Para atualizar um produto, basta selecionar a publicação no campo Publicação conforme o exemplo abaixo e clicar em Avançar.
IMPORTANTE: A atualização do ERP atualmente exige que as publicações dos produtos ALW (RF WMS) e RF (Comercial) também sejam atualizados.
Os módulo obrigatórios serão sempre atualizados, não sendo possível desmarcá-los.
É recomendado que os módulos opcionais instalados sejam atualizados constantemente junto aos módulos obrigatórios.
*¹ É 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
Ao clicar em Nova Publicação, será exibido a tela abaixo com os produtos disponíveis para publicação.
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.totvs.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.
A aplicação permite criar várias publicações do tipo de ambiente Produção para cada produto no mesmo ambiente, porém uma mensagem de aviso será exibida caso já exista uma publicação do produto em produção. Não há limites para criação de publicações para o tipo de ambiente Homologação. As portas informadas para a nova publicação não podem estar em uso por outra publicação, caso contrário a aplicação não permitirá a continuar.
Após clicar em OK na tela de Nova Publicação, confirme as aplicações e versões a serem publicadas, e informe os dados de conexão com o banco de dados, conforme exemplo acima.
Servidor: Alias do servidor de banco de dados (o mesmo do tnsnames.ora)
Usuário: Usuário do ERP no banco de dados (ex: CONSINCO)
Senha: Senha do usuário do ERP
Testar Conexão: Realiza um teste de conexão com a base de dados informada.
- Recarregar pacotes: Recarrega a lista de pacotes instalados e os pacotes disponíveis para instalar ou atualizar.
Ao clicar em avançar, se as configurações estiverem OK, o processo de instalação será iniciado exibindo as etapas do processo, conforme o exemplo abaixo.
Se ocorrer algum erro durante as etapas de execução, a linha referente a etapa que falhou ficará em vermelho e na mensagem de finalização será solicitado que os erros sejam verificados, conforme o exemplo abaixo.
Caso a instalação ou atualização ocorra sem nenhum problema, a tela abaixo será exibida. Clique em Concluir para voltar a tela principal.
Exportar: Permite exportar o log gerado em tela para arquivo texto.
A aplicação também armazena em seu diretório corrente, os logs em arquivo texto de todas as execuções, caso seja necessário encaminhar para análise de suporte. Após a finalização da instalação, uma página de teste será aberta para validar a instalação.
Atualizar uma Publicação
Para atualizar um produto, basta selecionar a publicação no campo Publicação conforme o exemplo abaixo e clicar em Avançar.
IMPORTANTE: A atualização do ERP atualmente exige que as publicações dos produtos ALW (RF WMS) e RF (Comercial) também sejam atualizados.
Os módulo obrigatórios serão sempre atualizados, não sendo possível desmarcá-los.
É recomendado que os módulos opcionais instalados sejam atualizados constantemente junto aos módulos obrigatórios.
Ao Ao clicar em avançar, se as configurações estiverem OK e a versão do pacote for superior a versão atual do produto, o processo de atualização será iniciado, exibindo as etapas do processo, conforme o exemplo abaixo.
...
Ao avançar, será exibido o progresso e o log de alteração.
Gerenciamento de site e pools de aplicação
Foram incluídos os recursos listados abaixo para facilitar o gerenciamento de sites e pools de aplicação:
- Visualização do status do pool da aplicação. Exibindo os status: Iniciado, Parado ou Desconhecido.
- Gerenciamento do pool de aplicação.
Para realizar esse procedimento, clique com o botão direito sob o produto.
Abrirá o menu com as opções para gerenciamento: Parar Poll/Reciclar Pool.
- Gerenciamento do site.
Para realizar esse procedimento, clique no botão direito no combo de "Publicação".
Serão exibidas as opções para o gerenciamento do site: Parar Site/Reciclar Site/Iniciar Site.
- Opção "Marcar Todos" e "Desmarcar Todos".
Clique com o botão direito em qualquer área da lista de produtos, será exibida as opções para Marcar Todos e Desmarcar Todos.
Execução em modo silencioso
A aplicação pode ser inicializada com passagem de parâmetros conforme descrito abaixo:
Registrar aplicações de pacotes
É possível realizar o registro de aplicações dos pacotes selecionados. Para isso, basta selecioná-los na lista e clicar com o botão direito em um deles, e selecionar a opção Registrar aplicações, conforme imagem abaixo.
Para selecionar vários pacotes, basta segurar a tecla CTRL, para ir selecionando individualmente, ou a tecla SHIFT, para selecionar todos os itens entre os cliques.
OBS: A opção de Registrar aplicações só será visível caso o Status do serviços seja Iniciado em ao menos um dos itens selecionados e a tarefa só será executada para esses itens com esse status.
Remover pacotes individuais
Para remover pacotes individuais, basta selecioná-los na lista e clicar com o botão direito para que seja exibida a opção Remover pacote e serão adicionados a lista de exclusão. Os itens marcados, ficarão em vermelho e serão removidos ao clicar no botão Avançar.
OBS: Somente os pacotes do grupo Opcionais poderão ser removidos separadamente e desde que o Status esteja como Iniciado.
Gerenciamento de site, pools de aplicação e serviços
Foram incluídos os recursos listados abaixo para facilitar o gerenciamento de sites e pools de aplicação:
- Visualização do status do pool ou serviços: Iniciado, Parado ou Desconhecido.
- Gerenciamento do pool de aplicação.
Para realizar esse procedimento, clique com o botão direito sob o produto.
Abrirá o menu com as opções para gerenciamento: Parar Pool/Reciclar Pool.
- Gerenciamento do site.
Para realizar esse procedimento, clique no botão direito no combo de "Publicação".
Serão exibidas as opções para o gerenciamento do site: Parar Site/Reciclar Site/Iniciar Site.
- Opção "Marcar Todos" e "Desmarcar Todos".
Clique com o botão direito em qualquer área da lista de produtos, será exibida as opções para Marcar Todos e Desmarcar Todos.
Execução em modo silencioso
A aplicação pode ser inicializada com passagem de parâmetros conforme descrito abaixo:
- autoexec
Usado para que a execução se inicie sem interação humana, ou seja, execução silenciosa. - salvalog
Usado para informar a geração de log da aplicação. Serão criados arquivos na pasta Logs, no mesmo diretório da aplicação, tendo como padrão o nome como “log_ddMMyyyyHHmmss.json”. - -c <servidor> <usuário> <senha> <tipoAmbiente>
Para informar a conexão com a base de dados, deve-se utilizar o marcador -c seguido do servidor, usuário, senha e tipo do ambiente P ou H (Produção ou Homologação), nessa ordem e sempre com essas informações. A aplicação irá buscar no TNSNAMES os dados de conexão, então é preciso que o arquivo esteja configurado corretamente. nomepacote=<pacote>
Utilizado somente na ferramenta de setup web para informar qual o pacote principal será instalado. Estão disponíveis os seguintes pacotes:Nome Pacote
Descrição Pacote (Nome Interface) LOCWEB_RFWEB Consinco ALW HOST Consinco Corp OMSMOBILE Consinco OMS Mobile SMWEB_RFWEB Consinco RF INTEGRASIMPLUS Consinco Simplus HOSTWEB Consinco Web
- 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 - autoexec
Usado para que a execução se inicie sem interação humana, ou seja, execução silenciosa. - salvalog
Usado para informar a geração de log da aplicação. Serão criados arquivos na pasta Logs, no mesmo diretório da aplicação, tendo como padrão o nome como “log_ddMMyyyyHHmmss.json”. - -c <servidor> <usuário> <senha> <tipoAmbiente>
Para informar a conexão com a base de dados, deve-se utilizar o marcador -c seguido do servidor, usuário, senha e tipo do ambiente P ou H (Produção ou Homologação), nessa ordem e sempre com essas informações. A aplicação irá buscar no TNSNAMES os dados de conexão, então é preciso que o arquivo esteja configurado corretamente. - 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. - 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/thumbail) 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.
nomepacote=<pacote>
Utilizado somente na ferramenta de setup web para informar qual o pacote principal será instalado. Estão disponíveis os seguintes pacotes:
Nome Pacote
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
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas