Para instalação no Windows

Após o download do instalador, basta iniciar sua instalação, que irá seguir sem intervenção do usuário.

O programa ficará disponível no menu, como neste exemplo utilizando o Windows 11.

O WebApp irá iniciar o WebAgent sempre que necessário a partir deste momento, mais detalhes consulte a seção Habilitar WebAgent na Tela de Parâmetros.

Apenas para testes, você pode iniciar a aplicação, será exibido o ícone na bandeja, como no exemplo abaixo.

Para instalação no Linux

Após baixar o arquivo para o seu respectivo Linux, sendo o arquivo .deb para Ubuntu e .rpm para o Red Hat.

Para Ubuntu 

No diretório onde o arquivo .deb foi copiado

Caso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima

Para Red hat 8.x 

Pré requisito: Necessário instalar a biblioteca libappindicator

No diretório onde o arquivo .rpm foi copiado

Caso tenha problema durante a instalação, o comando abaixo define o arquivo como um instalador, execute e na sequencia repita o comando acima

Registro do Certificado (SSL) para uso do WebAgent

---

Para utilizar o Websocket Secure (wss) é necessário registrar o TOTVS Certificate em seu sistema operacional.

 Para usuários Windows

O registro é automático para Windows 10/11, 32 ou 64 bits, e será efetivado na primeira execução do WebAgent.

🚨 Importante:
Na primeira execução do WebAgent, caso seja apresentada a tela de confirmação para o registro do certificado, selecione a opção Sim.

Para usuários Linux

     Ubuntu    

• Após a instalação do WebAgent
• Localize o arquivo totvs_certificate_CA.crt na pasta /opt/web-agent
• Acesse seu navegador e efetue o registro:
  • Para o Google Chrome
    • Na barra de navegação digite: chrome://settings/certificates
    • Acesse: Authorities (autoridades)
    • Na sequência: Import (importar)
    • Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent
    • Selecione todos os Trusts, e por fim, o botão OK
      
      
      

  • Para o Microsoft Edge

    • Na barra de navegação digite: edge://settings/privacy/manageCertificates

    • Acesse: Authorities (autoridades)

    • Na sequência: Import (importar)

    • Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent

    • Selecione todos os Trusts e Okay
      
      
      

  • Para o Firefox

    • Na barra de navegação digite: about:preferences#privacy

    • Acesse: View Certificates… (verificar certificados)

    • Acesse: Authorities (autoridades)

    • Na sequência: Import (importar)

    • Selecione o totvs_certificate_CA.crt na pasta /opt/web-agent

    • Selecione todos os Trusts e OK
      
      

    Red Hat 8.x

• • Para Google Chrome e o Firefox o registro do certificado segue os mesmos passos do Ubuntu.
    

  • Para o Microsoft Edge:

    • O Edge utiliza o certificado do Sistema Operacional, utilize os comandos abaixo para resgistrar:

      • Copie o certificado da pasta do web-agent para a pasta de certificados

        • sudo cp /opt/web-agent/totvs_certificate_CA.crt /etc/pki/ca-trust/source/anchors/

      • Registre o certificado

        • sudo update-ca-trust

      • Verifique se o certificado foi instalado
        • trust list | grep TO   
          label: TOTVS certificate CA
          
          
    • Acesse os links abaixo para mais informações:
      • https://docs.fedoraproject.org/en-US/quick-docs/using-shared-system-certificates/
      • https://www.redhat.com/sysadmin/ca-certificates-cli

 Para usuários macOS

Para mais detalhes acesse a documentação oficial da Apple aqui:

• Após a instalação do WebAgent
  
  
• Localize o arquivo totvs_certificate_CA.crt na pasta /Applications/web-agent.app/Contents/MacOS
• No app Acesso às Chaves (keychain access) , selecione as chaves de início de sessão ou de Sistema.
  
• Arraste o arquivo do certificado para o app Acesso às Chaves.
• Configure a confiança do certificado clicando com o botão direito sobre o mesmo e escolhendo a opção Get Info. Na interface aberta expanda a opção Trust e coloque Always Trust para todas as opções disponíveis, conforme as imagens abaixo. Se for solicitado que você forneça um usuário, utilize um usuário com acesso de administrador.
  
  

• 🚨 Repita o mesmo processo de registro do Certificado acima para o arquivo totvs_certificate.crt também na pasta /Applications/web-agent.app/Contents/MacOS
  

  
  

  Importante

  Atente-se à utilização dos certificados disponibilizados na pasta de instalação do WebAgent, não utilize os certificados da pasta de instalação do AppServer

Faça o download do arquivo compactado do Smartclient | Desktop. pelo endereço: https://arte.engpro.totvs.com.br/public/tec/smartclient_harpia/auto-update

Escolha a versão para o seu sistema operacional e clique em download

Após realizar o download da versão do seu sistema operacional, realize o download do arquivo smartclient.ini, conforme abaixo:

Descompacte o arquivo em um pasta (de sua preferencia) e copie o arquivo smartclient.ini para dentro desta pasta

Após copiado o arquivo smartclient.ini para dentro da pasta, basta alterar o cxxxxx para o código da sua topologia.

Após a conclusão da instalação, localize e execute o aplicativo Smartclient e de dois cliques sobre o aplicativo.