Última alteração a 14/03/2025
Notas importantes
License Server
- O instalador de Platform liga-se ao License Server para a ativação do software. Se não estiver disponível uma ligação à Internet, consulte o capítulo Requisitos de conectividade do License Server.
Instalação
- Ao instalar o Platform numa máquina virtual, o processo de instalação pede o nome da máquina física que atua como âncora.
- Devido a restrições de licenças GPL, nem todos os drivers podem ser distribuídos com a plataforma. Em particular, o controlador MySQL JDBC foi descontinuado. Para poder trabalhar com MySQL, é necessário seguir as instruções da secção Instalação de controladores JDBC adicionais.
- Todos os servidores e PC no modo intra devem ter a mesma configuração regional para garantir que as datas e horas são corretamente armazenadas na SGBD.
- É necessária uma interface gráfica para a instalação. Se os servidores não tiverem uma interface gráfica, pode instalar no modo de consola e instalar os produtos a partir de outro PC com uma interface gráfica.Recomenda-se a utilização do protocolo de encriptação AES para encriptar as comunicações. Em novas instalações, é configurado por omissão. Em instalações existentes, o ficheiro de propriedades deve ser editado com_unit4_karat_comm.properties com:
- http_encrypt=AES/ECB/NoPadding
- http_bits=128
Requisitos
- O LibreOffice 5.1 é necessário para converter documentos ODT em PDF utilizando o Office Bridge.
- Para instalar o Eclipse é necessário utilizar o pacote ZIP ou TAR.GZ. A instalação do Eclipse com o instalador nativo não é suportada, porque a pasta dropins permanece nos diretórios do utilizador e não como uma subpasta do Eclipse.
Validações
O sistema valida os requisitos de hardware e software para Cegid e não permite continuar se estes não forem cumpridos, uma vez que a integridade da aplicação não pode ser garantida num ambiente não suportado.
SQL Server
No SQL Server, o idioma de ligação do utilizador que possui as tabelas de repositório e dados deve ser o inglês e não deve ser sysadmin.
Uso do JDK
É aconselhável usar o JDK para ter as ferramentas de tunning e evitar atualizações automáticas.
Servidor
- Para poder utilizar Tomcat ou WebSphere como um servidor de aplicações, durante a instalação deve selecionar a opção External Web Server e, em seguida, utilizando a consola do servidor de aplicações, deve instalar o pacote WAR a partir da subpasta Web da instalação do Platform.
- Em alguns servidores Windows:
- A pasta de trabalho não é partilhada como karatwork e é necessário realizar o processo manualmente.
- Se o servidor de aplicações aceder ao recurso karatwork de outro equipamento, o serviço tem de ser configurado com um utilizador com direitos de acesso.
Arquitetura
São criadas várias pastas durante a instalação do Platform:
- bin. Scripts de arranque.
- client. Ficheiros necessários no cliente.
- conf. Ficheiros de configuração.
- doc. Documentação.
- download. Transferências.
- eclipse. Plugin para o Eclipse.
- ext. Diretório em que estão localizados os JAR que são utilizados a partir dos scripts de cliente.
- images. Imagens.
- installer. O instalador, script para desinstalação, etc.
- lib. Ficheiros JAR utilizados pelo Platform.
- lib-obsolete. Contém bibliotecas de dependências removidas em Platform.
- logs. Ficheiros de rastreio ou LOG.
- products. Diretório para os JAR de produtos.
- request. Diretório para os ficheiros de ativação offline.
- temp. Ficheiros temporários.
- translator. Ficheiros de properties de tradutores.
- web. Pacote WAR para instalar em Tomcat.
- work. Pasta criada automaticamente para armazenar os ficheiros dos diretórios de utilizador e de configuração.
Requisitos
Esta secção descreve os requisitos mínimos necessários para que o técnico possa efetuar uma instalação correta e os requisitos de hardware e software , tanto para os postos de trabalho clientes, como para cada um dos diferentes servidores.
É também indicada a resolução de ecrã mínima funcional, a recomendada e a ideal.
Instalação
O processo de instalação deve ser efetuado por um técnico do Cegid (implementador) ou, se previamente estabelecido, por pessoal autorizado (distribuidor).
Este técnico deve ter um conhecimento sólido de todos os componentes tecnológicos envolvidos: cliente, base de dados, servidor de aplicações, etc...
Conetividade para o License Server
O instalador de Platform liga-se ao License Server para a ativação do software. Se não estiver disponível uma ligação à Internet, o instalador gera um ficheiro de pedido de ativação que deve ser enviado ao Cegid SMB, SAU por e-mail.
Receberá então uma mensagem de correio eletrónico com instruções para prosseguir com a instalação. Se tiver uma ligação restrita, é aconselhável autorizar o acesso ao endereço ekonlic.ekon.es, na porta 80 para o protocolo HTTP.
Hardware
Para saber mais sobre os requisitos de hardware , consulte o documento online no site de infraestruturas https://www.ekon.es/infraestructuras-ekon.
Resolução de ecrã
- Mínima funcional: 1024 x 768 píxeis e 24 bits.
- Ideal: 1152 x 864 píxeis e 32 bits.
Software
Cegid UI na área de trabalho
- Leitor de RTF, XLS, ODT e ODS (por exemplo, OpenOffice), se forem geradas listas para ficheiros neste formato. Versão mínima do OpenOffice 2.0 se pretender apresentar listas com textos em Unicode.
- Leitor de PDF (por exemplo, Acrobat Reader) se forem geradas listas para ficheiros neste formato. Versão mínima do Acrobat Reader 6.0.
- Sistema operativo
- Linux
- Fedora
- openSUSE
- Red Hat
- SUSE
- Open WebStart (OpenJDK 17 LTS ou OpenJDK 21 LTS com JavaFX)
- Mac OS
- Sierra 10.12
- High Sierra 10.13
- Mojave 10.14
- Catalina 10.15
- Big Sur 11
- Open WebStart (OpenJDK 17 LTS o OpenJDK 21 LTS con JavaFX)
- Windows
- Versão mínima do sistema: Windows 10 (as versões Windows Home não são suportadas)
- Open WebStart (OpenJDK 11 LTS ou OpenJDK 17 LTS com JavaFX)
- Java Advanced Imaging 1.1.2_01 For JRE, para poder gerar ficheiros TIFF de várias páginas com o scanner.
- O Windows Home não é suportado.
Cegid na Mobilidade
- iOS 12 ou suepriores
- Android 11.0 ou superiores
Ambiente de administração
Os ambientes do cliente do Platform.
Ambiente de programação
Para desenvolver e depurar classes de personalização em Java, o ambiente suportado é o seguinte:
- Os ambientes do cliente do Platform.
- Eclipse 2022-03 ou superior
Cegid Studio e Graphical Editing Framework
O Studio requer GEF ou Graphical Editing Framework; no entanto, as versões mais recentes do Eclipse IDE for Java Developers incluem uma versão desta framework que não é compatível com o Studio. Consequentemente, a perspetiva do Studio pode não estar disponível após uma nova instalaçã
Para restabelecer o GEF no nosso ambiente e resolver o problema, no caso de o IDE Eclipse 2023-12 estar disponível.
Que GEF é disponibilizado com o IDE Eclipse?
Aceder a Install New Software. Aceder ao menu Help e selecionar a opção Install New Software.
- Em Work with: https://download.eclipse.org/releases/2023-12/ e carrega os elementos disponíveis.
- Filtrar por GEF.
- No Modeling é disponibilizada a versão 3.18 do GEF Classic Zest SDK. Esta versão não é adequada, uma vez que é necessária a versão 3.15.
Para instalar o GEF Classic 3.15:
- Aceder a Install New Software. Aceder ao menu Help e selecionar a opção Install New Software.
- Adicionar o Repositório do GEF Classic.
- Na janela que aparece, clicar no botão Add para adicionar um novo repositório de software.
- Na caixa de diálogo Add Repository, fornecer as seguintes informações:
- Name: Inserir um nome descritivo para o repositório, como por exemplo GEFLegacy.
- Location: Introduzir o URL do repositório: https://download.eclipse.org/tools/gef/classic/release/3.15.0.
- Clicar no botão Add para adicionar o repositório à lista.
- Selecionar o software a ser instalado. Na lista de software disponível, procurar e selecionar a caixa GEF (Graphical Editing Framework) Classic.
- Concluir o processo de instalação.
- Clicar no botão Next para prosseguir com a instalação. O Eclipse calcula os requisitos e as dependências do software.
- Confirmar os detalhes da instalação e aceitar a licença.
- Aguardar a conclusão da instalação.
- Uma vez concluída, o Eclipse solicita a reinicialização do IDE para que as alterações entrem em vigor.
5. Servidor
Recomenda-se que todo o software do servidor esteja em inglês.
Servidor da base de dados
Os requisitos do software para o servidor de base de dados são os indicados pelo fabricante em cada caso. As bases de dados oficialmente suportadas são as seguintes:
- InterSystems Caché 2016.1
- Microsoft SQL Server 2014
- Microsoft SQL Server 2016
- Microsoft SQL Server 2017
- Microsoft SQL Server 2019
- Microsoft SQL Server 2022
- Oracle 11g R2
- Oracle 12c R1
- Oracle 18c
- Oracle 19c
- Oracle 21
- MySQL 8.0.36 com controlador JDBC mysql-connector-java-8.0.33-bin.jar
Servidor principal ou Servidor de Business Navigator
- Java de 32 bits não é permitido em sistemas operativos de 64 bits.
- Linux
- Red Hat 7.0 e SUSE 12
- Open JDK 17 LTS
- Oracle/Sun Java 1.8.0_201
- Windows
- Windows 2012 R2, Windows 2016 e Windows 2019
- Open JDK 17 LTS
Servidor de aplicações
Utiliza os mesmos sistemas operativos que os servidores do serviço principal.
Processo de instalação
Para iniciar a instalação, execute o seguinte ficheiro:
- java -jar karat-installer.jar
E para a instalação em modo de consola, execute o seguinte ficheiro:
- java -jar karat-installer.jar -console
Notas:
- É necessário efetuar a instalação como administrador.
- Pode instalar a plataforma em sistemas operativos sem consola gráfica, mas a instalação do produto deve ser efetuada num PC com uma interface gráfica.
Instalação de controladores JDBC adicionais
Devido a restrições de licenças GPL, nem todos os drivers podem ser distribuídos com o Platform.
Para poder adicionar estes drivers JDBC ao Platform, os passos a seguir são:
- Opção 1:
- Copiar JAR do driver JDBC necessário na pasta karat/lib.
- Reinstalar ou atualizar a instalação do Platform.
- Opção 2:
- Montar o ficheiro karat_jdbc-11.1.0.0.zip com o JAR ou JARS de driver JDBC necessários.
- Copiar ficheiro karat_jdbc-11.1.0.0.zip na mesma pasta em que se encontra a distribuição do Platform (ficheiros *.kiz).
- Efetuar a instalação ou a atualização do Platform.
Instalação do host físico para alojar uma máquina virtual
Descompactar karat_vm_host-11.1.0.0.zip e executar setup.exe. Este processo efetua a instalação de um serviço de host para alojar máquinas virtuais. Anote a porta utilizada pelo serviço host.
Em seguida, instale o Platform numa máquina virtual. Durante o processo de instalação, quando seleciona o tipo de servidor principal, o sistema pede-lhe o servidor e a porta do serviço do host previamente instalado (Physical host). Por exemplo myhost:5500. O resto da instalação é convencional.
Para ancorar manualmente um host de máquina virtual a um host físico, tem de adicionar a propriedade host_physical ao ficheiro servermain.properties do servidor principal. Exemplo: host_physical=tcp://host:puerto.
Comportamentos antes, durante e após a instalacção
Verifique o cumprimento dos requisitos de hardware e software.
Consultar os passos do assistente de instalação.
- Nova instalação: Se tiver instalado o servidor principal, tem de instalar as licenças e definir as definições necessárias a partir do Control panel.
- Atualização: Consulte as Release Notes para ver se é necessária alguma ação.
- Verificação: Verifique se tem acesso para começar a trabalhar.
- Licenças: Uma vez que as licenças do Platform funcionam através de um código de ativação, pode descarregar o seu código de ativação a partir da página Web do cliente. A primeira vez que executar o Instalador de produtos, é-lhe pedido o código de ativação. Para utilizar uma máquina virtual como servidor principal do Platform, a máquina virtual deve primeiro ser ancorada a uma máquina física. Uma vez ancorada, é possível utilizar o código de ativação. Implícito no código de ativação está o número máximo de máquinas no cluster. Um único código de ativação é suficiente para ativar todos os servidores principais do cluster. Só é necessário ativar o código uma vez, em qualquer nó do cluster. Se mais tarde adicionar nós ao cluster, estes serão ativados automaticamente. Também é possível ativar a licença a partir do Painel de controlo.
Iniciar uma sessão de trabalho
Iniciar uma sessão de trabalho com o XRP Enterprise UI
Usando um navegador, utiliza um URL do tipo https://servidor:puerto/site para se conectar via HTTPS ou, se nenhum certificado SSL estiver disponível, um URL do tipo http://servidor:puerto/site.
Para se ligar diretamente a uma configuração, adicione o nome da configuração no final do URL, por exemplo: https://servidor:puerto/site/configuration.
Iniciar uma sessão de trabalho com HTML UI
Usando um navegador, utilize um URL como <https://servidor:puerto/html> para se ligar via HTTPS ou, se não tiver um certificado SSL, utilize um URL como <http://servidor:puerto/html>.
Para ligar diretamente a uma configuração, pode adicionar o nome da configuração ao final do URL, por exemplo: <https://servidor:puerto/html/configuration>.
Iniciar uma sessão de trabalho com UI
Nas instalações cliente, utilize os atalhos no menu de início ou no diretório bin da instalação do Platform.
Se ligar através do Java Web Start, utilize um URL como <http://servidor:puerto/directorio_virtual/karat.jnlp> ou <http://servidor:puerto/directorio_virtual> para ligar através de HTTP.
Para ligar diretamente a uma configuração, pode adicionar o nome da configuração ao final do URL, por exemplo: <https://servidor:puerto/html/configuration>.
Iniciar uma sessão de trabalho na nova Mobilidade
Para aceder à aplicação, basta criar um atalho no ecrã inicial do dispositivo. Para tal, é necessário introduzir o URL fornecido no navegador Web do telemóvel. Ao fazê-lo, é reencaminhado para o ecrã de seleção da configuração inicial. Uma vez selecionada a configuração, é apresentado o ecrã de autenticação, onde é possível introduzir as credenciais para aceder a todas as funcionalidades da aplicação.
Utiliza-se o mesmo URL para telemóvel e computador; o sistema detecta o tipo de dispositivo e redireciona adequadamente, por exemplo, o URL deve ser do tipo https://servidor:puerto/site.
Iniciar uma sessão de trabalho em Mobilidade
Iniciar uma sessão de trabalho em Mobilidade em dispositivos iOS
Para iniciar uma sessão de trabalho no iPhone ou iPad, utilize o atalho da área de trabalho.
Para instalar em Mobilidade no seu iPhone ou iPad, deve descarregar a aplicação a partir do iTunes.
Para estabelecer a ligação ao servidor do Cegid, selecione Ekon em Ajustes e indique as seguintes informações:
- Credenciais
- Utilizador. Utilizador do Platform na configuração.
- Palavra-passe. Palavra-passe do Platform.
- Servidor Cegid
- Nome. Nome ou endereço do servidor do Platform.
- Porto. Normalmente, é a porta 5580.
- Diretório virtual. Normalmente, é karat.
- Configuração. Nome da configuração do Platform.
- Secure. Para a utilização de HTTPS.
Iniciar uma sessão de trabalho em Mobilidade em dispositivos Android
Para iniciar uma sessão de trabalho em Android, utilize o atalho da área de trabalho.
Para instalar em Mobilidade no Android, utilizando o navegador da Internet, aceda a e siga os passos de instalação.
Se a aplicação não estiver configurada, o formulário de configuração é apresentado no arranque. Para alterar a configuração, selecione as definições da aplicação.
- Credenciais
- Utilizador. Utilizador do Platform na configuração.
- Palavra-passe. Palavra-passe do Platform.
- Servidor Cegid
- Nome. Nome ou endereço do servidor do Platform.
- Porto. Normalmente, é a porta 5580.
- Diretório virtual. Normalmente, é karat.
- Configuração. Nome da configuração do Platform.
- Secure. Para a utilização de HTTPS.
Se tiver algum problema antes, durante ou depois da instalação, siga estes passos:
- Reveja o apêndice sobre as listas de verificação.
- Contacte o departamento de suporte do Cegid:
- Ligando para o número 902 227 000.
- Enviando uma mensagem de e-mail para o seguinte endereço [email protected].
- Na Web http://www.ekon.es/(opção Website de clientes na barra superior do ecrã).
Processo de desinstalação
O processo de desinstalação é baseado no instalador do Platform. Para iniciar a desinstalação, selecione a opção Uninstall do grupo de programa do Platform.
Também é possível desinstalar executando o comando script de início uninstall , na subpasta installer da instalação do Platform.
Durante a desinstalação
Os passos do assistente de desinstalação são os seguintes:
1. Boas-vindas
Mensagem de boas-vindas.
- Full uninstall. Se selecionar esta caixa, toda a árvore de pastas da instalação do Platform é completamente eliminada. Se não estiver selecionada, não elimina as seguintes subpastas: conf, ext, logs, translator, work.
2. Processo de desinstalação
Antes de proceder à eliminação dos diretórios do Platform, é pedida uma confirmação e, se esta for aceite, são apresentadas as ações realizadas durante a desinstalação. Caso contrário, a desinstalação é cancelada.
- Se ocorrerem erros ao tentar eliminar pastas e/ou ficheiros bloqueados, selecione a opção Ignorar e, após a desinstalação, efetue uma remoção manual dos mesmos.
3. Desinstalação concluída
Indica se o processo foi concluído com sucesso. Se, no passo anterior, tiverem ocorrido erros ao tentar eliminar pastas e/ou ficheiros, elimine-os manualmente.
Listas de verificação
Lista de verificação para o servidor de base de dados
Seguem-se as verificações a efetuar no caso da instalação do servidor de bases de dados:
- Para todos os tipos de bases de dados: O servidor de base de dados foi instalado de acordo com as instruções do fabricante
- Microsoft SQL Server
- Verificação da lista genérica.
- Verificação se o protocolo TCP/IP está ativado e se a porta está definida.
- MySQL: Verificação da lista genérica.
- Oracle: Verificação da lista genérica.
- InterSystems Caché: Verificação da lista genérica.
Lista de verificação para o cliente Platform
Seguem-se as verificações a efetuar nos clientes Platform:
- Para todos os sistemas operativos e plataformas: Verificação de que pode ser iniciada uma sessão de trabalho.
Lista de verificação do servidor de aplicações
Seguem-se as verificações a efetuar no caso de o servidor de aplicações estar instalado:
- Para todos os sistemas operativos e plataformas: Verificação de que pode ser iniciada uma sessão de trabalho.
Lista de verificação para o servidor principal
Seguem-se as verificações a efetuar no caso de o servidor principal estar instalado:
- Para todos os sistemas operativos e plataformas:
- Verificação de que as configurações podem ser definidas.
- Verificação de que pode ser iniciada uma sessão de trabalho.
Guardar ou partilhar este artigo
